前两天，DeepSeek 正式发布了 DeepSeek Harness。

我印象最深的一点，是它对“一切皆插件”这套架构理念的坚持，而且落地得非常彻底。

Skills、MCP 和 UI 只是最容易被看到的表层能力。

继续往下看会发现，模型适配器、工具、文件系统、会话存储、沙箱，甚至 Agent Loop，都可以通过插件化方式自由组合。

运行中的 DeepSeek Harness，本质上就是一棵由配置动态组装出来的插件树。

插件挂载时，可以向共享上下文注册服务、事件和界面能力。

插件卸载后，对应的注册也会同步撤销。想替换某一部分能力，通常只需要在配置树中替换一项，或者插入一个新的插件模块。

这个思路相当激进，也确实非常强。

不过，DeepSeek Harness 目前的使用门槛仍然偏高。

首先是部署。官方启动方式其实已经很简化了，安装 Node.js 后，在终端执行一条命令就能跑起来。

但对于不写代码的普通用户来说，“打开终端”这一步本身就是门槛。

我以前给一些朋友推荐开发者工具时，往往就在这一步把他们劝退了。

另一个问题在于界面体验。原版 Web UI 的功能已经比较完整，但实际使用时，还是能明显感觉到它处于开发者预览阶段。

很多能力已经接进来了，不过交互细节还没来得及逐一打磨。

所以我做了 Pilot Harness。

https://github.com/op7418/pilot-harness

你可以先把它理解成：在 DeepSeek Harness 外面加上一层桌面客户端外壳，再配上一组客户端插件。

桌面端启动后，会在本机运行 DeepSeek Harness，然后再把 Web UI 加载到原生窗口中。

窗口管理、目录选择、数据目录和运行时重启交给桌面端负责，Agent 执行和工具调用则继续沿用 Harness 原本的实现。

如果你已经部署好了 DeepSeek Harness，也可以跳过桌面客户端，只单独安装自己需要的插件。

UI 和交互：从开发者预览走向日常可用工具

DeepSeek 原版 UI 的目标很明确：先把 Harness 的能力完整暴露出来。

工作区、会话、模型选择、权限模式、Trajectory 和插件设置等核心功能都已经具备。

对于一个刚发布的开发者预览版本来说，这个完成度其实已经不低。

但如果把它当作一个每天都要使用的 Agent 客户端，一些体验问题就会慢慢显现出来。

比如左侧栏。原版已经支持工作区和多级会话树，但工作区、会话和当前任务之间的视觉区分还不够明显。

当项目数量变多后，用户往往需要额外花点时间确认自己当前位于哪个目录、打开的是哪条会话。

另外，点击项目主要用于展开和收起，会话的新建入口则放在旁边，切换项目时容易多操作一步。

我把桌面端里的项目点击逻辑改得更直接了一些：

点击一个未激活的项目，会直接切换到该项目并进入新会话。

如果项目已经处于激活状态，则继续保留展开和收起的行为，旁边的加号入口也依然保留。

会话 Hover 卡片里也补充了更多信息。

现在可以直接看到会话所属工作区、项目路径、Agent 模式、模型以及定时任务等内容。

这里还预留了插件插槽，所以后续如果安装其他插件，也能继续向 Hover 卡片中扩展更多信息。

输入区的变化会更明显。

DeepSeek 原版在空会话状态下，会把工作区和 Agent 模式放在输入框外部；

进入会话后，统计信息和上下文信息又会出现在输入框下方。虽然功能都能找到，但它们在不同状态下的位置会不断变化。

我把空会话时需要选择的工作区、权限和 Agent 模式都收进了输入框内部。

开始对话后，低频使用的上下文信息会进入 Context 弹层，而常用的模型选择、附件、停止和发送按钮则继续保留在输入区中。

这样从空会话进入实际工作状态时，页面不会突然多出一整条信息栏，整体体验会更连贯。

输入框的 Focus 状态、禁用状态和发送状态，也分别补上了更清晰的反馈。

原版较大的圆形发送按钮被替换成更紧凑的方形按钮，附件、模型、Context 和权限控制的尺寸也做了统一。

信息量依然不少，但视觉上安静了很多。

这部分交互经验主要来自 CodePilot。CodePilot 是我之前做的一款 Agent 客户端，从产品、设计到开发都由我独立完成，开发过程中也大量使用了 AI。

做了几个月之后，我对 Agent 客户端里哪些信息需要常驻、哪些适合折叠，以及用户会频繁点击哪些区域，已经形成了一些自己的判断。这次基本都迁移到了 Pilot Harness 里。

设置页面、菜单、弹窗以及工具调用卡片，我也一起做了调整。

DeepSeek 原版里有不少通用配置表单，它们更接近底层框架配置的原始结构。

我重新梳理了页面导航和表单层级，让服务商、模型、插件和通用设置分别拥有固定入口。

样式层面的改动包括字号、间距、圆角、边框以及明暗主题；交互层面则补充了 Hover、Focus、选中、加载和错误状态。

原版已经提供了轨迹功能，我保留了它原有的数据和事件逻辑，并重新处理了时间轴、工具栏和表格展示。

现在可以搜索执行记录、查看每个阶段的时间分布，还可以导出日志。

当 Agent 行为不符合预期时，也可以直接在这里排查它接收了哪些上下文、调用了哪些工具。

这些改动都被放进了独立主题和 UI 插件中。关闭插件后，界面会恢复为 Harness 原来的样子。后续继续同步上游更新时，也能更清楚地区分哪些是 DeepSeek 原生功能，哪些是我新增的交互优化。

侧边栏和文件树插件

我平时使用 Agent 时，经常需要随手查看当前目录结构。

比如 Agent 说它修改了某个文件，我会想立刻点开确认；它新建了目录，我也想顺手检查一下整体结构。

有时候我只是想把一个文件路径直接放进输入框，让 Agent 接着处理。

如果每次都切回 Finder 或编辑器，整个操作流程就会被打得很碎。

现在左侧栏可以管理多个工作区，并按工作区展示对应的会话。

点击底部的 Files，右侧就会打开当前项目的文件树视图。

在文件树中，可以展开目录、新建文件或文件夹、重命名，也可以调用系统应用直接打开文件。

如果需要让 Agent 处理某个文件，还可以把路径直接添加到输入框中。

文件操作被严格限制在当前工作区内。

工作区根目录不能被重命名，符号链接也会额外进行校验，避免文件树越过当前项目边界。

服务商配置插件

模型服务商的配置流程，我也重新做了一遍。

原来的配置方式对开发者来说问题不大，但对于第一次接触的人来说，需要先理解服务商、模型、API Key 和配置文件之间的关系。这些概念如果一次性全部摆在用户面前，很容易让人停下来翻文档。

现在设置里提供了独立的 Providers 和 Models 页面。

在Providers页面中，可以搜索并接入 DeepSeek、Anthropic、Google、Amazon Bedrock、Azure OpenAI、Groq、Cerebras、Fireworks、Cloudflare、Kimi Coding、Hugging Face 等多个主流模型服务商。

如果列表里没有需要的服务商，也可以通过自定义地址接入，只要它兼容相应的 API 协议即可。

服务商连接完成后，Models 页面会列出当前可用模型。

每个模型旁边都会显示图片输入、Reasoning 等能力标签，也支持按这些能力进行筛选，并可指定默认模型。

这些页面的作用，是把模型配置流程整理得更清晰。

API Key 仍然交给 Harness 的凭据插件保存，服务商配置交给设置插件管理，运行时的模型路由则由 LLM 插件处理。

原有的插件边界和职责划分都被保留了下来。

Mac、Windows 和 Linux

Pilot Harness 支持 macOS、Windows 和 Linux。

macOS 提供 DMG 和 ZIP，Windows 使用常规安装包，Linux 则提供 AppImage、DEB 和 RPM。

桌面版使用系统原生的目录选择窗口，第一次使用时只要选定一个项目，就可以直接开始会话。

客户端也会定期同步 DeepSeek Harness 的更新。

当然，适配成本依然存在。上游如果调整 UI 插槽或页面结构，主题插件就需要重新做视觉回归；

如果配置协议发生变化，对应插件也要同步修改。好处在于，维护范围是清晰可控的，不会把整套客户端拖入长期分叉。

做完这个客户端之后的一些感受

我做这个项目，根本原因还是认同 DeepSeek Harness“一切皆插件”的设计理念。

所以在实现时，我尽量把所有功能都拆开，变成一个个独立插件，这样既方便后续更新，也方便其他人按需单独安装。

现在做 AI 产品，变化速度实在太快。模型接口会变，Agent 的工作方式也会变，今天看起来稳定的交互，几个月后可能就需要重新设计。

如果把所有能力都紧紧绑在一起，每次调整都会牵出一连串迁移工作。DeepSeek Harness 的选择，是先把系统拆开，再允许使用者自行重组。

模型和 Agent 的自我训练、自我迭代，现在也已经有不少项目在探索，像 Pi 一类项目中就能看到类似思路。

而 DeepSeek Harness 又往前走了一步，它把自身的组成部分也一起开放出来了。

以后如果 Agent 需要参与调整自己的配置，至少已经有了一套可以被识别、替换和组合的组件结构。

这离 Agent 自己进化产品当然还很远，目前更多还是在做接口层面的准备。

但我愿意看到这样的尝试。Harness 暂时没有成熟 C 端产品那种沉重包袱，因此能承受更频繁的改动，也更适合尝试风险更高的新架构。

Pilot Harness 目前加入的，主要是几项我自己最需要的能力：

更顺手的界面体验、项目文件树、模型服务商配置，以及覆盖三个平台的桌面安装包。

后面 DeepSeek Harness 持续更新，我也会继续跟进。

如果你觉得有需要，或者想亲自体验一下，可以到这里试试：

https://github.com/op7418/pilot-harness