Skip to main content
Harness 插件可扩展宿主运行时、贡献工具并添加 UI 集成。桌面端提供生命周期管理和受控原生桥接。

职责

内置插件与恢复

Harness 启动前,桌面自动检查活动 Profile,并从应用内置副本恢复缺失或指向旧路径的集成;失败会写入日志。 内置桥可自动恢复,但首次准备运行时、内核及选中的社区插件仍需要网络。 当前发布清单包含 13 个内置包: 移动端界面负责浏览器适配;远程访问插件负责 SSH 与入站共享。本机内核插件连接已有 Codex/Claude CLI,界面要求 Harness 0.2.1-alpha.2 或更新版本及实际桥接能力;内置分发不等于所有功能在推荐旧内核上可用。 预设和社区插件按需安装、升级或移除。running-changes 未随当前版本发布;dsh-win-terminal-inspector 已弃用,启动时会尝试自动移除,不再提供可选 Minimal 修复入口。

本地路径与热重载

除注册表来源外,插件也可以从本地目录挂载:spec 会被规范化为 link: 加绝对路径,档案中保存的是指向源码目录的链接声明,源码不会被复制。 桌面端为这类插件维护一条独立的 HMR 补丁层。启动 Harness 前,已挂载的本地源码目录被折算成 watch root,写入应用数据中的 cordis.hmr.patch.yml,再以 --patch 注入核心自带的 @deepseek-ai/dsh-hmr。该文件与用户手写的档案补丁相互独立;关闭开关或没有本地插件时会被移除。 补丁层只管监听范围:真正的热重载由核心 HMR 完成,卸载并重新导入该插件后重建它的 fiber,不重启 Harness 服务。忽略规则覆盖 node_modules、隐藏目录,以及 cache、data 目录。

通信路径

移动端插件仅适配客户端;Remote 与 Kernel 通过各自宿主 HTTP 路由通信,后者再启动本机 CLI 子进程。以下是需要原生桌面能力时的桥接路径:
  1. 嵌入式 Harness 客户端调用客户端插件暴露的集成。
  2. 插件通过桌面桥发送结构化请求。
  3. Tauri command 验证操作并调用对应 Rust service。
  4. 结果或生命周期事件返回客户端并更新面板状态。
安装插件就是安装代码。Profile 范围只能避免配置冲突,不能阻止恶意文件、进程、凭据或网络访问。 请审查第三方源码,并尽量固定可信版本。
用户操作请参阅插件。