前言¶
DeepSeek Harness(DSH)采用「一切皆插件」的架构,Web GUI 默认 profile 为 web。原生界面以英文为主,统计信息易被截断、思考块默认折叠、会话列表缺少归档与删除入口;若要在中文环境下长期日常使用,往往还要自己改样式、补文案,或额外写脚本注入提示词。
下面介绍社区维护的客户端插件 deepseek-harness-zh_pro(维护者 magian1127,当前版本 0.7.0,MIT 许可证)。它在不替换 DSH 核心的前提下,集中处理界面优化、布局调整、可选提示词注入与会话生命周期管理;中文补全仅在中文界面生效,其余增强在中文与英文界面均可使用。
这是什么¶
deepseek-harness-zh_pro 是面向 DSH Web 客户端的综合性增强插件,分类为「客户端」。项目在 GitHub 上开源(约 18 stars),也可在 SkillHub 社区目录检索:https://www.skillhub.cn/plugins/magian1127/deepseek-harness-zh_pro。SkillHub 为独立社区站点,与 DeepSeek / 幻方无官方从属关系。
插件不注册模型工具、不上传数据。除用户显式开启的提示词注入、代理角色提示中文化与工具说明中文化外,其余功能不会修改模型请求。
核心功能¶
所有开关与参数位于 DSH 设置 → 增强设置。完整默认值与边界见仓库 行为契约。
中文界面补全¶
默认开启,仅中文界面生效:修正残留英文,统一词元、接口密钥、模型标识、时长和数量格式。DOM 硬编码文本只覆盖已确认的内置清单;未收录文本保持原样,避免误改正文或第三方插件内容。
思考块与统计展示¶
- 统计全显示(默认开):聊天统计保持单行完整显示,自动缩小字号,极端超长时横向滚动。
- 自动展开最新思考(默认开):流式思考出现时展开最新一条,新思考出现时收起上一条。
- 默认展开行数(默认 20 行):超出部分折叠,按钮带剩余行数提示;点过「再展开」后保持展开进度。设为
0表示不限制。 - 展开模式(默认按钮模式):按钮模式逐批展开;滚动模式为折叠正文提供独立滚动条,支持流式跟随。
布局与会话管理¶
- 对话宽度(默认开,90%):大屏下按 50%–100% 调整聊天列宽,两侧留白均分。
- 自动归档旧会话(默认 7 天):新建会话界面打开时,自动归档超过指定天数未活动的会话(仅从列表隐藏,日志保留;设为
0关闭)。 - 查看已归档(默认开):工作区行新增「归档」按钮,归档会话按最近活动时间降序展示,默认每批 5 个。
- 删除会话(回收站)(默认开):三点菜单新增「删除会话」,日志目录移入系统回收站(Windows 回收站 / macOS 废纸篓 / Linux XDG Trash),并移除工作区账本槽位。
可选提示词与代理中文化¶
以下功能默认关闭,需手动开启:
| 功能 | 说明 |
|---|---|
| 提示词注入 | 向后续模型请求注入可编辑提示词,可选初始系统提示或首用户提示词 |
| 代理角色提示中文化 | 四个默认代理(标准/编码/极简/创作)的系统提示词换成中文版本,仅新会话生效 |
| 工具说明中文化 | 注入模型请求的工具说明翻译为中文(工具名与参数不变),仅新会话生效 |
编辑提示词文本并不等于开启注入;提示词注入由独立开关控制,默认关闭。
环境要求¶
- DeepSeek Harness Web GUI,默认 profile 为
web - Node.js
^22.19.0 || >=24.0.0
安装与启用¶
官方通道安装后需重启一次 DSH;热安装可在 DSH 运行中立即生效。
# 官方通道:安装后重启一次 DSH
dsh plugin --profile web add deepseek-harness-zh_pro
# 热安装:DSH 正在运行时可立即生效
npx -y deepseek-harness-zh_pro install --profile web
安装后可检查状态:
npx -y deepseek-harness-zh_pro status --profile web
更新时重新执行安装命令即可;浏览器端内容更新后刷新页面。
卸载:
dsh plugin --profile web remove deepseek-harness-zh_pro
# 或
npx -y deepseek-harness-zh_pro remove --profile web
卸载会清理临时热行和运行中条目,不会删除 DSH 会话数据。localStorage 与 settings 中的已有设置值可能保留,重新安装后可继续使用。
典型用法¶
日常界面增强¶
安装并重启(或热安装后刷新页面)后,打开 DSH 设置 → 增强设置,按需调整对话宽度、思考展开行数与归档天数。中文界面用户可保持「中文补全」开启;若界面语言为英文,统计、思考展开、对话宽度等功能同样可用。
按需开启提示词注入¶
- 在增强设置中打开「提示词注入」开关。
- 编辑提示词文本,选择注入目标(初始系统提示或首用户提示词)。
- 新建会话后生效;已有会话不会自动重新注入。
查看与恢复归档会话¶
在工作区行点击「归档」按钮,该分组正常会话隐藏,归档会话出现在官方列表对应分组内。点击归档行可恢复并打开;行尾三点菜单支持重命名、分叉、取消归档与删除。
设置与数据存储¶
| 数据 | 存储位置 |
|---|---|
| 中文补全、统计、思考展开、默认展开行数、对话宽度、查看已归档 | 浏览器 localStorage:deepseek-harness-zh_pro:enhancements |
| 提示词开关、文本、注入目标、自动归档天数 | DSH settings.yaml,命名空间 dsh-zh |
| 代理角色提示中文化、工具说明中文化 | DSH settings.yaml,命名空间 dsh-zh |
适用场景与注意¶
适合在 DSH Web 端长期使用的开发者:需要更完整的中文界面文案、更可控的思考块展示、更宽的对话区域,以及归档与删除会话能力。若要在新会话中统一注入系统提示或中文化默认代理,可按需开启对应开关。
安装前建议阅读 GitHub 源码与 MIT 许可证,确认功能范围。插件以当前 DSH 进程权限运行;删除会话会将日志移入系统回收站,操作前请确认不再需要该会话数据。
本地源码联调(首次使用先安装依赖):
pnpm install
node bin/dsh-zh.mjs install --profile web --link $PWD
更多开发与排障文档见仓库 docs/ 目录:行为契约、运行架构、开发指南、故障排查与发布流程。
链接¶
- SkillHub 目录页:https://www.skillhub.cn/plugins/magian1127/deepseek-harness-zh_pro
- GitHub 仓库:https://github.com/magian1127/deepseek-harness-zh_pro