返回目录

pilot-harness

编辑精选维护状态: 活跃

op7418/pilot-harness

受 CodePilot 启发的 DeepSeek Harness 桌面客户端与插件套件,支持 macOS、Windows 与 Linux。

前往 GitHub
$ dsh plugin --profile web add <release tgz URL>

271

星标

19

Fork

TypeScript

语言

MIT

许可证

2026-08-17

创建于

2026-08-20

最近推送

MIT 许可、CodePilot 风格的 DeepSeek Harness 桌面客户端与插件套件——Electron 应用内置 Harness 运行时,其 UI 插件也可通过 dsh CLI 安装到任意本地 Web profile。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

MIT

01它能帮你完成什么?

  • Run the DeepSeek Harness runtime as a focused native desktop app with visual provider and model management

    Desktop client on macOS, Windows and Linux with a CodePilot-inspired interface, provider/model management, workspace-aware conversation rows, and a Files right sidebar — no separate DeepSeek Harness installation required

    DeepSeek Harness users who prefer a desktop web UI over the CLI-launched Web UI

  • Add the CodePilot theme, Files sidebar, reminder summary, or session-log export to a local DeepSeek Harness Web profile

    Each feature installed with a single `dsh plugin --profile web add` command from a prebuilt dsh.bundle release asset — no repository clone, YAML patch, or local build required

    Users of the stock DeepSeek Harness Web profile who want individual desktop-grade UI plugins

  • Export DeepSeek Harness sessions as ZIP archives

    Per-Session ZIP export from the Trajectory toolbar and the `/export` command via the session-log export plugin

    Teams that need archivable copies of agent sessions and trajectories

02如何接入 DeepSeek Harness?

前置条件

  • macOS (Apple Silicon), Windows (x64), or Linux (x64) for the desktop app
  • A local DeepSeek Harness Web profile with the dsh CLI only if installing the standalone plugins via `dsh plugin --profile web add`

安装步骤

  1. 01

    Download the installer for your system from GitHub Releases: DMG/ZIP for macOS Apple Silicon, EXE for Windows x64, AppImage/DEB/RPM for Linux x64

  2. 02

    macOS: open the DMG, drag pilot-harness.app into Applications, and launch it normally; if Gatekeeper blocks the first launch, use System Settings → Privacy & Security → Open Anyway

  3. 03

    Windows: run the EXE; if SmartScreen warns, confirm the file came from the Release, then choose More info → Run anyway

  4. 04

    Linux: `sudo apt install ./Pilot-Harness-Linux-amd64.deb`, `sudo dnf install ./Pilot-Harness-Linux-x86_64.rpm`, or `chmod +x` then run the AppImage

  5. 05

    Open Pilot Harness, select a Workspace, then go to Settings → Providers to connect a provider and choose one of its available models

  6. 06

    Standalone plugins: run `dsh plugin --profile web add <release tgz URL>` for the CodePilot theme, Files sidebar, reminder summary, or session-log export, then restart the Web profile

    $ dsh plugin --profile web add <release tgz URL>

验证接入成功

  • Restart the Web profile after plugin installation and use `dsh --profile web --dump-config` to confirm the added row

回滚

  • Remove a plugin with its package name, e.g. `dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree`; removing the CodePilot theme plugin restores the stock Harness presentation

03DSH 适配与能力边界

DSH 适配原生运行时

Electron desktop app packaging the DeepSeek Harness plugin runtime as a native app, plus standalone UI plugins installed into local dsh Web profiles via `dsh plugin --profile web add`

  • Desktop shell around the Harness runtime

    installer for macOS / Windows / Linuxnative window wrapping the local DeepSeek Harness runtime, with directory dialog, startup recovery screen, and platform icons

  • CodePilot-inspired visual theme

    CodePilot theme plugin (@deepseek-ai/dsh-client-ui-codepilot-theme)consistent tokens, radii, menus, hover states, settings cards, Markdown rendering, and platform-aware title bars

    applies the Pilot Harness product mark and visual overrides; disabling the theme row restores the stock Harness presentation
  • Workspace Files sidebar

    Files plugin (@deepseek-ai/dsh-ui-worktree)Workspace-confined right file sidebar with file count, branch summary, row actions, and @path insertion; project-aware conversation rows show branch, state, reminder summary, mode, and model details

  • Session-log export

    session-log export plugin (@deepseek-ai/dsh-session-log-export)per-Session ZIP export from the Trajectory toolbar and the /export command

    writes ZIP export files to disk

04适合谁?何时不该用?

适合

  • DeepSeek Harness users who prefer a desktop web UI over the CLI-launched Web UI
  • Users of the stock DeepSeek Harness Web profile who want individual desktop-grade UI plugins
  • Teams that need archivable copies of agent sessions and trajectories

不适合

  • macOS notarization is not enabled yet, so Gatekeeper may block the first launch (Open Anyway is the expected extra step); Windows and Linux preview installers remain unsigned — never disable platform security globally.
  • The Files sidebar and Reminder summary plugins require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0; older upstream Harness builds can install their bundles but cannot render those two UI contributions.

05兼容性、维护与安全提示

  • macOS notarization is not enabled yet, so Gatekeeper may block the first launch (Open Anyway is the expected extra step); Windows and Linux preview installers remain unsigned — never disable platform security globally.
  • The Files sidebar and Reminder summary plugins require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0; older upstream Harness builds can install their bundles but cannot render those two UI contributions.
  • Pilot Harness is an independent community project derived from the MIT-licensed DeepSeek Harness; it is not an official DeepSeek product and is not endorsed by or affiliated with DeepSeek.
2026-08-172026-08-18v0.1.0-rc.7-pilot.2

MIT · actively maintained (latest release v0.1.0-rc.7-pilot.2, 2026-08-20)

06常见问题

Pilot Harness 如何接入 DeepSeek Harness?

两种方式。桌面应用用 Electron 封装 DeepSeek Harness 插件运行时,agent 循环、Session 日志、工具管线、Provider 契约和 RPC 实现均保持原样;或者把各个 UI 插件(主题、文件侧栏、提醒摘要、会话日志导出)通过 `dsh plugin --profile web add` 安装到本地 Harness Web profile。

需要单独安装 DeepSeek Harness 吗?

桌面应用不需要——本地 Harness 运行时已内置。打开 Pilot Harness,选择一个 Workspace,再到 Settings → Providers 连接 Provider 并选择模型即可。只有当你使用本地 DeepSeek Harness Web profile 时,才需要单独安装那些插件。

为什么 macOS 或 Windows 首次启动会有安全警告?

macOS 公证(notarization)尚未启用,Gatekeeper 可能拦截首次启动——在系统设置 → 隐私与安全性中点击「仍要打开」即可。Windows 和 Linux 预览安装包未签名。README 建议仅对来自官方 GitHub Release 的文件放行警告,切勿全局关闭 SmartScreen 或 Gatekeeper。

独立安装的 UI 插件有版本要求吗?

文件侧栏和提醒摘要插件依赖 Pilot Harness v0.1.0 中包含的 UI 插槽契约。旧版本的上游 Harness 可以安装这两个 bundle,但无法渲染对应的 UI。

如何卸载插件或恢复默认界面?

运行 `dsh plugin --profile web remove <包名>`,例如 `dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree`。移除 CodePilot 主题插件后,界面会恢复为 Harness 默认外观。

08数据与来源

  • 作者声明github.comd1fa9c15fc00…

    Run the DeepSeek Harness plugin runtime as a focused native app, manage providers and multimodal models visually, and ke…

  • 作者声明github.comd1fa9c15fc00…

    Pilot Harness does not replace the DeepSeek Harness agent loop, Session log, tool pipeline, provider contracts, or RPC i…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。