Pilot Harness：DeepSeek Harness 多平台插件化客户端

最近推出的DeepSeek Harness凭借“一切皆插件”的激进设计思路引发关注，其将模型适配器、工具、会话系统乃至Agent运行循环都通过插件组合实现，插件挂载时可向共享上下文注册服务、界面与事件，卸载时自动撤销注册，调整功能仅需替换配置树中的对应项。运行中的DeepSeek Harness，本质上就是一棵由配置组装而成的插件树。

不过这款工具目前仍有较高使用门槛：官方部署需要安装Node.js并通过终端启动，对非技术用户不够友好，很多人在这一步就放弃了；同时其Web UI还处于开发者预览阶段，虽然功能基本齐全，但交互细节还有不少打磨空间。

为了降低使用门槛，作者开发了Pilot Harness，可以看作是DeepSeek Harness加上一层桌面外壳和客户端插件。桌面端启动后会在本地运行Harness并将Web UI加载到原生窗口，将窗口管理、目录选择、数据目录和运行时重启交给桌面端处理，同时保留Harness原有的Agent和工具执行逻辑。对于已经部署好Harness的用户，也可以跳过桌面客户端，单独安装所需的插件。

交互与界面优化：从开发者预览到日常工具

DeepSeek原版UI的核心目标是先完整展示Harness的所有能力，工作区、会话、模型选择、权限模式、执行轨迹和插件设置都已具备，对于开发者预览版本来说完成度已经不错，但作为日常使用的客户端，还是存在不少体验问题。

比如左侧栏的工作区和会话视觉区分度不高，项目多了之后用户需要花时间确认当前所在目录和会话；点击项目默认仅用于展开收起，新建会话的入口放在侧边，切换项目时容易多走一步。

作者基于此前开发CodePilot的经验，对UI做了全面优化：未激活的项目点击后会直接切换到该项目并新建会话，激活的项目则保留展开收起功能，侧边的新建会话按钮也保留原位。会话的悬浮卡片新增了工作区、项目路径、Agent模式、模型和定时任务等信息，还预留了插件扩展插槽，后续可以通过其他插件继续丰富卡片内容。

输入区的改动更为明显：原版在空会话时会将工作区和Agent模式放在输入框外，进入会话后统计和上下文信息又出现在输入框下方，不同状态下的元素位置变化让界面显得零散。作者将空会话需要选择的工作区、权限和Agent模式整合到输入框内，对话后低频的上下文信息移入Context弹层，常用的模型选择、附件、停止和发送按钮则保持在输入区，避免从空会话进入工作状态时页面突然多出信息栏。同时优化了输入框的聚焦、禁用和发送状态的视觉反馈，将原版较大的圆形发送按钮替换为更紧凑的方形样式，统一了附件、模型、Context和权限控制按钮的尺寸，让界面视觉上更整洁统一。

此外作者还重新整理了设置页面的导航和表单层级，将服务商、模型、插件和通用设置分开为独立入口，优化了样式细节和交互状态，包括调整字号、间距、圆角和主题样式，补充了悬浮、聚焦、选中、加载和错误等交互状态。保留了原版的执行轨迹功能并重新设计了时间轴、工具栏和表格，现在可以搜索执行记录、查看每个阶段的耗时分布，也可以导出日志，方便排查Agent运行不符合预期的问题，查看其接收的上下文和调用的工具。

所有的UI改动都被封装为独立的主题和UI插件，关闭插件后即可恢复原版界面，后续同步上游更新时也能清晰区分原生功能和自定义交互。

侧边栏与文件树插件

日常使用Agent时，用户经常需要查看当前项目目录：比如确认Agent修改的文件、新建的目录结构，或是直接将文件路径传入输入框让Agent处理，来回切换Finder或编辑器会打断操作流程。

Pilot Harness的左侧栏支持管理多个工作区并按工作区展示对应会话，点击底部的Files即可打开当前项目的文件树，支持展开目录、新建文件/文件夹、重命名，以及调用系统应用打开文件，还可以直接将文件路径添加到输入框供Agent处理。

为了保障安全，文件操作被严格限制在当前工作区内，工作区根目录不允许重命名，同时会额外检查符号链接，防止文件树越权访问项目外的内容。

服务商配置插件

原版的模型服务商配置需要用户先理解服务商、模型、API密钥和配置文件的关系，大量概念同时摆在用户面前，很容易让新手需要停下来查阅文档。

Pilot Harness重新设计了配置流程，在设置中拆分了Providers和Models页面：在Providers页面可以搜索并添加DeepSeek、Anthropic、Google、Amazon Bedrock、Azure OpenAI、Groq、Cerebras、Fireworks、Cloudflare、Kimi Coding、Hugging Face等主流服务商，也支持通过自定义地址接入兼容对应API协议的其他服务商；服务商连接成功后，Models页面会列出可用模型，每个模型会标注图片输入、推理能力等标签，支持按能力筛选和设置默认模型。

API密钥仍由Harness的凭据插件保存，服务商配置和模型路由则由对应插件处理，保留了原有插件的边界，不会破坏原有系统的扩展性。

多平台支持

Pilot Harness支持macOS、Windows和Linux三大平台，其中macOS提供DMG和ZIP安装包，Windows使用常规安装程序，Linux提供AppImage、DEB和RPM包。桌面版使用系统原生的目录选择窗口，用户首次使用时选择项目即可直接开始会话，客户端还会定期同步DeepSeek Harness的更新。

当然适配仍存在一定成本，当上游调整UI插槽或页面结构时，主题插件需要重新进行视觉回归；配置协议变更时对应插件也需要更新，但由于所有改动都封装为独立插件，不会将整套客户端拖入长期分叉的维护状态。

开发后的一些思考

开发Pilot Harness的核心原因是认同DeepSeek Harness“一切皆插件”的理念，因此在开发过程中尽可能将功能拆分为独立插件，方便更新和单独安装。

当前AI产品的迭代速度极快，模型接口和Agent工作方式不断变化，将所有能力绑定在一起会带来大量迁移工作，而DeepSeek Harness选择将系统拆分为可组合的插件，允许用户灵活调整功能，这一思路走在了行业前沿。类似的思路也出现在Pi等项目中，但Harness更进一步开放了自身的组成部分，为未来Agent自主调整配置打下了基础。虽然目前距离Agent自主进化产品还有很远，但这种尝试值得肯定，Harness没有成熟C端产品的沉重包袱，可以承受频繁改动和高风险的架构尝试。

Pilot Harness目前新增了顺手的界面、项目文件树、服务商配置和多平台桌面安装包，后续会持续跟进DeepSeek Harness的更新。如果觉得有需要，可以到GitHub仓库尝试：https://github.com/op7418/pilot-harness，也可以分享给有需要的朋友。