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

快速上手

pilot-harness（dsh-base bundle）

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @deepseek-ai/dsh-base

复制以上命令在 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)

常见问题

这个 bundle 和普通插件有什么区别？

它没有运行时 API（src/index.ts 是空导出），也没有提供 Service；它的全部「内容」是仓库里的 cordis.patch.yml，由 profile composer 通过 dsh.bundle.patch manifest 字段读取并插入空的 profile 根，作为所有 profile 的首层 patch。

安装后会自动启用哪些能力？

会一次性挂载 LLM 适配器、agent 默认模型选择、文件系统 / 沙箱 / 子进程 / 工具（bash 或 pwsh、fs、web search、todo、subagent 等）、会话持久化、设置与凭证、遥测等 100+ 个插件行；Codex 与 Claude Code provider 不会自动挂载，需要单独 profile 选择。

我可以单独覆盖这一层里的某个插件配置吗？

可以，但要用「整行替换」的方式：profile 后续层（其他 bundle 层或用户的 cordis.patch.yml）按行 id 整体重写该行的 config，patch 不做字段级深度合并，因此覆盖时必须重述要保留的所有字段。

在 Windows 上还能用 bash 工具吗？

默认不行。base bundle 按平台门控两个 shell 栈：bash-sandbox/tool-bash 在非 win32 启用、pwsh-sandbox/tool-pwsh 仅在 win32 启用。如果 Windows 用户想恢复 bash 工具，必须在 profile 或 home cordis.patch.yml 里同时禁用 pwsh 两行并重新启用 bash 两行，只改一边会在加载时直接报错。

它的遥测默认是开还是关？

默认关闭。base bundle 挂载 dsh-session-telemetry-otel 但 mode 默认读为 DISABLED，仅当显式设置环境变量 DSH_TELEMETRY_MODE 为 FULL 或 FEEDBACK_ONLY 时才会真正上报。

我的会话内容会被持久化到哪里？

由 base bundle 挂载的 session-persistence-jsonl 决定，root 解析为 $DSH_HOME 下的 sessions 目录；图像附件等大块二进制走 attachment-local。会话全文本搜索默认关闭，需要时由后续 profile 层开启 session-query-sqlite。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（与 workspace 同步发布 @deepseek-ai/dsh-* 0.1.0-rc.7 同代）
• Node: >=22.19.0（仓库根 engines.node: ^22.19.0 || >=24.0.0）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则