用了一圈 VS Code 里的 AI 编程插件,说句心里话,大部分要么是套个聊天框了事,要么界面花里胡哨看着累。直到我试了 DeepSeek Harness 的 VS Code 客户端,才觉得:原来国产 Agent 插件的 UI 也能做得这么干净。

它干的事很明确——把 DeepSeek Harness 那套 Web 版智能体体验,以紧凑的形式塞进 VS Code 的 Activity Bar。不说虚的,这篇聊聊它好在哪、以及背后的架构为什么让它能这么稳。

第一眼印象:美观、简洁,参考了 Codex

布局上它明显吃透了 Codex 的逻辑。交互手感和 Codex 对齐,页面排版则综合参考了 Codex、CodeBuddy 和 Cursor 三家——该留白的地方留白,该分组的地方分组,没有多余装饰。

重点在"紧凑"二字。它没有硬挤一个 Webview 占满编辑器,而是老老实实待在 Activity Bar 侧边栏里,不抢你写代码的地盘。打开就是 Chat 视图,关掉 IDE 该干嘛干嘛。

Chat 视图:流式对话、思考过程与工具调用展示

看上面这张图就明白了:流式输出、思考过程和工具调用结果都在同一片区域实时铺开,排版节奏和 Codex 几乎一个味儿。

功能一点没缩水

别看它小,Harness 的核心能力基本全搬过来了:

  • 流式对话:assistant 内容实时渲染,推理过程和工具调用/结果同步展示,不是等半天才吐一坨。
  • 会话管理:新建、恢复历史会话都行,还有 Fork 会话——带分支标记,某个思路走歪了可以随时开叉重新试。
  • 斜杠命令菜单:运行时提供的可搜索命令,结果还能直接渲染出来。
  • Goal 控制:目标展示和编辑,让你看清当前 agent 在奔着什么干。
  • 文件审查:模型改了哪些文件,你逐个 keep / revert。
  • 高危操作审批:破坏性动作弹审批卡片,支持"允许一次 / 拒绝"。

最贴心的是编辑器上下文自动携带:当前文件路径、光标、选区、打开的标签页、诊断信息、Git diff,外加你显式拖进来的附件,全都不用你手动粘贴。对着报错按一下提问,它已经知道你卡在哪行了。

Trajectory 视图:执行轨迹可回放、可导出

这是很多插件没有的视角。它能按回合和步骤完整回放 agent 的执行轨迹,方便你事后复盘它到底干了什么、哪一步走偏了,还支持导出。

Trajectory 视图:按回合与步骤回放完整执行轨迹

调试 prompt、排查 agent 乱改文件,这个视图比翻聊天记录高效太多。

设置与 API Key:干净,且安全

设置视图把 provider / model / endpoint / 权限策略 / API Key 收在一处,和 Chat、Trajectory 一样是独立的 tab,不堆在聊天框里。

Settings 视图:配置 provider / model / API endpoint / 权限策略 / API Key

凭据隔离是它最让我放心的一点:API Key 只进 Python 运行时的凭据存储(~/.dsh/.credentials.yaml,权限 0700/0600),Webview 和扩展设置里永远只有 configuredwritablesource 这种非密元数据,key 不进任何状态 API、不进会话、不进日志。而且这目录和 Web 版 Harness 共享,配过一次两边都能用。

关键设计:扩展只做壳,重活交给 dsh-py

这是我觉得它最稳的地方。很多插件图省事,把 agent 循环、工具调用、沙箱全写进扩展的 TypeScript 里,结果权限和安全一团糟。这个项目偏偏把脏活全扔给一个 Python 运行时 dsh-py

Developer ──> VS Code Webview ──> Extension Host ──> DeepSeek Harness Runtime (dsh-py)
  • Webview(React):纯展示 + 收用户意图,没有 Node.js 能力,读不了文件、跑不了 shell。
  • Extension Host(TypeScript):只调 VS Code API、只读采集上下文、管 Python 子进程的生命周期。不执行模型生成的命令
  • dsh-py(Python):智能体循环、工具调用、文件系统变更、shell 执行、沙箱、审批、凭据、会话持久化、模型访问——全在这。

划重点:智能体循环、工具调用、沙箱、模型访问与凭据持久化,全部由 dsh-py 独立承载。扩展层只负责上下文采集和展示,这层边界写死在架构里。

顺带提一句审批策略:破坏性操作未应答就默认不执行(fail-closed),宁可卡住也不闯祸。上下文还有硬限额(附件每项 ≤ 96 KiB、Git diff ≤ 64 KiB、诊断 ≤ 100 条),防止长 diff 撑爆模型上下文。

写在最后

如果你想要一个界面干净、交互跟手、又不牺牲安全边界的 VS Code AI 编程插件,DeepSeek Harness 这个客户端值得一试。参考 Codex/CodeBuddy/Cursor 做出来的排版确实舒服,而把重逻辑下沉到 dsh-py 的架构,让你用起来心里有底。

装上就能跑:去 Releases 页按系统下对应 .vsix(macOS / Windows / Linux 都有),VS Code 里 … → Install from VSIX 装完,点 Activity Bar 的 DeepSeek 图标、配置个 key 就开聊。想深究架构的,强烈建议翻它的 docs/SECURITY_MODEL.mddocs/ARCHITECTURE.md,写得相当清楚。

有用过的小伙伴,评论区聊聊体感?

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐