前言¶
用 DeepSeek Harness（dsh）在网页里跑长任务时，最常见的麻烦不是任务本身跑不完，而是过程看不清。思考、上下文、命令输出和工具调用会顺着对话一条条往下刷，当前做到哪一步、已经跑了多久，往往要在一长串技术消息里自己找。任务结束后，这些过程记录还占着主视线，真正要读的答案反而被挤到后面。
DeepSeek Harness 是 DeepSeek AI 开源的 agent harness，目前处于开发者预览阶段，核心理念是「一切皆插件」：模型、工具、会话、沙箱和界面都可以替换或组合。社区围绕会话界面做了不少扩展。本文介绍的 deepseek-harness-ux 针对的就是网页里的长任务观感：关键进度先看得见，完成后过程自动收起，细节需要时再展开。
需要先说明两件事。第一，社区插件目录是独立站点，和 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。第二，这个仓库自己也写得很清楚：它不是 DeepSeek 官方发行版，也不享有上游官方支持。
这是什么¶
deepseek-harness-ux 由 ayuanwong 维护，主要语言是 TypeScript，许可证为 BSD-3-Clause。社区目录把它归在「会话与消息」分类，GitHub 仓库当前 13 星（2026-08-17 核实；目录页当时显示 10 星）。仓库简介是：长任务不刷屏，关键进度清晰可见，完成后自动折叠，详情随时展开。
定位上，它是基于上游 DeepSeek Harness 源码快照维护的社区网页版。README 写明：它没有重写 Agent 的工作方式，而是重点改进网页里的任务过程、长回答、会话查找和文件入口。根目录 package.json 里的包名仍是 @deepseek-ai/dsh-root，版本号为 0.0.1-rc.2，这是上游快照留下的工作区元数据；仓库同时声明，自己不会向 @deepseek-ai scope 发布 npm 包。
这里有一处需要交叉看的信息。社区目录页给出的安装命令是 dsh plugin add github:ayuanwong/deepseek-harness-ux，也就是按普通插件收录的。仓库 README 则明确写道：本仓库交付的是完整源码版本，不是能直接安装到干净上游仓库的补丁，也没有单独发布为 npm 插件。社区站点 DSH Find 的介绍同样把它写成「不是插件，需要从源码运行」。安装方式以仓库一手说明为准，目录里的 dsh plugin add 只代表该站点的收录写法，不代表可以把它当补丁打进官方 dsh。
核心功能¶
仓库 README 把用户能直接感受到的差异写成了七项。对照官方源码时，维护者给出的依据是：UX 功能源码基于提交 35c6172，说明文档以 2026-08-17 的官方提交 47f9438 为对照，只记录用户能感知的差异，不把测试、包元数据和机械性源码差异包装成产品能力。
1、会话进行时，思考和工具步骤不会一直刷屏。任务运行时，思考、上下文、命令和工具调用会被收进一个稳定的「过程」区域。可以直接看到当前做到哪一步、已经运行多久，不必在大量技术消息里寻找进度。如果启用展示辅助，界面还会用一次很小的模型请求，把 Todo、思考和工具证据整理成更容易理解的阶段名称。这个请求只负责显示，不会改变 Agent 的回答。
2、任务完成后，过程自动折叠，答案回到主视线。正常完成的任务会自动收起思考过程；遇到失败或中断时，过程会继续展开，方便检查问题。需要核对细节时，点一下就能重新展开「运行详情」。
3、长日志可以单独滚动。展开运行详情后，长命令输出和工具日志会在自己的区域里滚动。滚到边缘时不会突然把整个对话带走，底部输入框也不会把页面顶出一大片空白。
4、长回答更适合阅读。回答的段落、标题和不同轮次之间更紧凑。任务结束后，可选的展示辅助还能优化答案标题；复制内容、会话历史和模型看到的原始答案都不会被改写。任务刚结束时，网页会在后台补齐最后一段历史，避免晚到的结束事件让界面看起来还在运行，也不会闪出新的加载页。
5、以前的会话更容易找。会话默认按最近更新时间排列，也可以切回手动排序。侧边栏可以搜索标题、工作区名称和当前进程中的对话内容；「未分组」区域也能直接新建不属于任何工作区的会话。
6、生成的文件更容易找到。除了工具明确写出的文件，UX 版还会识别答案里清楚列出的文档、表格、数据集、图片、音视频、压缩包、数据库和 3D/CAD 文件路径，把它们显示成可打开的产物入口。普通文字、网址、命令和示例代码不会被误当成文件。
7、模型配置集中在设置页。首次使用时会直接进入「设置 → 模型」的完整配置卡，不再维护另一套简化的密钥弹窗。提供方、模型、API Key 和错误恢复都在同一个地方完成。
它没有改动的部分同样写在 README 里：Agent Loop、模型路由、工具、权限、沙箱和 Session Log 仍沿用 DeepSeek Harness 的执行方式；原始思考、上下文、命令和工具证据没有被删除，只是收进「运行详情」；展示辅助不会修改 System Prompt、用户消息、工具、原始回答或会话历史；Session Log 默认仍保存在本地。
安装与启用¶
社区目录页上的安装命令原文如下，在 DeepSeek Harness 终端中复制运行即可。如需可复现安装，目录页提供了固定 commit 哈希的写法：
dsh plugin add github:ayuanwong/deepseek-harness-ux
dsh plugin add github:ayuanwong/deepseek-harness-ux#commit
上面第二条里的 commit 需要替换成实际提交哈希。目录页同时提醒：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。
就这个仓库而言，更接近一手的用法是从源码运行整份工作区，而不是把它当成打进官方安装的补丁。环境要求是 Node.js ^22.19 或 >=24、pnpm 11，以及兼容 DeepSeek 的 API Key。仓库 package.json 里写明的包管理器是 pnpm@11.7.0。
git clone https://github.com/ayuanwong/deepseek-harness-ux.git
cd deepseek-harness-ux
pnpm install
pnpm run build
pnpm run dsh -- web --port 3081
启动后打开 http://127.0.0.1:3081，在「设置 → 模型」中添加模型提供方，然后新建会话。如果 3081 已被占用，可以换成其他端口。官方上游默认网页端口是 3080，这个社区版 README 示例用的是 3081。
典型用法¶
1、在网页里新建会话，发起一个会走多步工具调用的任务。运行过程中看「过程」区域：当前阶段和已运行时间会留在这块稳定区域里，思考和工具调用不再把整页刷下去。
2、任务正常结束后，过程会自动收起，最终答案留在最显眼的位置。如果要核对某次命令或工具证据，展开「运行详情」即可；长日志在自己的区域里滚动，不会拖着整段对话一起走。
3、需要找以前的会话时，侧边栏默认按最近更新时间排列，也可以搜索标题、工作区名称和当前进程中的对话内容。不属于任何工作区的会话，可以从「未分组」区域直接新建。
4、如果回答里清楚列出了文档、表格、数据集、图片等文件路径，界面会把它们显示成可打开的产物入口。普通叙述、网址和示例代码按仓库说明不会被当成文件。
5、展示辅助是可选能力。启用后，网页展示服务会用当前会话配置的模型提供方，发起有界、仅用于显示的请求：进行中整理阶段名称，结束后可以优化答案标题。主 Agent 看不到额外指令，原始回答和会话历史也不会被改写。辅助路径不可用时，任务继续跑，界面回退到本地标题。需要注意：启用阶段或标题整理时，会把受限的运行证据发送给该提供方。
适用场景与注意事项¶
如果你主要在网页里运行长任务，希望过程更清楚、回答更好读、会话和文件更容易找到，可以选择 DeepSeek Harness UX。如果你更在意最新官方更新、npm 安装、Headless 或 CLI 工作流，应优先选择官方 DeepSeek Harness。
和官方版本相比，README 还列了这些边界，安装前值得看完：
- 这是基于上游源码快照维护的社区版本，不会自动获得官方后续的修复、兼容性更新和安全更新。
- 这个快照还没有官方后来加入的部分能力，例如更严格的冷会话校验、隐藏当前无法登录的 OAuth-only 提供方，以及新的全局界面扩展位。
- 当前没有内建的 Codex OAuth 登录和 Token 自动刷新；选择
openai-codex路由时需要手动提供 Token。 - 基础 Bundle 会安装休眠状态的 Codex 和 Claude Code 子代理提供方，但不会因此自动启动对应产品进程。
- 官方版提供 npm 包，默认可用
npx @deepseek-ai/dsh web启动；这个仓库只提供源码运行。 - 当前官方源码使用 MIT 许可证；这个分支保留其上游快照当时采用的 BSD 3-Clause 许可证和相关声明。LICENSE 文件中的版权声明仍为 Copyright (c) 2026, DeepSeek。
另外，不要提交 .env、.npmrc、API Key、本地 Session、构建产物或 profile 数据。启用任何非默认遥测模式前，请先阅读上游遥测设置。无论是按目录页的 dsh plugin add 尝试安装，还是按 README 从源码启动，代码都会以当前进程权限运行，安装或克隆前应检查源码与许可证。
小结¶
deepseek-harness-ux 要解决的是网页长任务「过程刷屏、答案被挤走」这件事。它把思考和工具调用收进可折叠的过程区，完成后把视线还给答案，同时补了会话查找和产物入口，但并不改 Agent 循环、工具和权限。它是社区源码版，不是官方发行，也不宜按普通插件补丁来理解。目录页和 GitHub 地址如下：
- 目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-ux/
- GitHub：https://github.com/ayuanwong/deepseek-harness-ux
- 官方上游：https://github.com/deepseek-ai/deepseek-harness
