本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

pilot-harness

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:op7418/pilot-harness#path:packages/workspace/ui-worktree

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 真正的桌面客户端——Electron 将本地 Harness 运行时打包到 macOS、Windows 与 Linux，负责原生窗口行为，并在启动异常时提供恢复页面。
• 更安静的 CodePilot 风格界面——统一 Token、圆角、菜单、Hover、设置卡片、Markdown、对话/轨迹切换与平台化标题栏。
• 服务商与模型管理——连接受支持的服务商，声明 OpenAI 兼容接口，将凭证和普通设置分开管理，浏览实时模型目录，并识别支持图片输入的模型。
• 不杂乱的工作区上下文——对话列表可展示分支、状态、提醒摘要、模式与模型，Files 则作为真正的右侧栏打开。
• 插件优先的扩展方式——主题、Worktree 侧栏、Schedule 摘要与 Session 日志导出仍是 Cordis/DeepSeek Harness 配置行，而不是写死在桌面端的业务逻辑。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件依赖 Electron 或桌面客户端吗？

不依赖。它是一个纯 Web profile 插件，通过 loopback 授权的 RPC 与宿主通信，浏览器和宿主代码完全分离。

安装后看不到 Files 按钮怎么办？

上游 Harness 版本必须公开 conversation.session.header.utilities、shell.right-sidebar、sidebar.workspaces.session.detail 三个呈现槽位，缺失任意一个 UI 都不会渲染；可在浏览器控制台检查加载状态确认。

能删除文件吗？

不能。删除属于不可逆操作，插件有意只提供新建文件、新建目录和重命名；需要删除时请使用系统文件管理器或命令行工具。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（peerDependencies 引用同 workspace 包，宿主需 Pilot Harness v0.1.0+ 含三个呈现槽位契约）
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则