SuperAPI AI 工具集

desktop-plugin-maker

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:为 Hermes 桌面应用构建插件,无需改动应用本身即可新增界面元素(面板、状态栏组件、仪表盘、命令、主题)。\n\n主要能力:插件为单个未编译的纯 JavaScript ESM 文件,应用在运行时加载;唯一可导入面为 @hermes/plugin-sdk 以及 react、react/jsx-runtime(须用 jsx() 调用而非 JSX 语法)。提供 host.state.* 只读响应式原子、host.request 网关 JSON-RPC、host.onEvent 事件订阅、host.notify、host.navigate、ctx.register 注册 UI、ctx.storage 持久化、ctx.i18n 多语言、useQuery/useMutation 等数据钩子,并可直接使用应用设计语言组件库。\n\n用法:把 $HERMES_HOME/desktop-plugins/<name>/plugin.js 从模板创建,文件名与插件 id 保持一致;应用会监视该目录并热重载,失败时显示错误提示,可用 ⌘K → Reload desktop plugins 重载。面板通过 area: 'panes' 加 placement 注册,也可用 dock: { pane, pos } 定位;整页用 ROUTES_AREA 并配合 SIDEBAR_NAV_AREA 或命令面板导航。如需 Python 后端,插件可携带 plugin_api.py,通过 ctx.rest/ctx.socket 访问自身命名空间。\n\n限制与注意:不得硬编码颜色,须用主题变量;画布面板须用 ResizeObserver 跟随容器尺寸;handlers 须以 .get() 命令式读状态;除指定模块外不可导入其它模块;ctx.socket 在 OAuth 远程下为空操作,须保留轮询回退;启用 Python 后端需修改 config.yaml 并重启桌面网关。发布前须做静态校验、隐私扫描与重命名同步检查。平台支持与定价资料暂未提供。