Chinese enhancement plugin for DeepSeek Harness (DSH) - DSH 中文增强插件
- Language
- TypeScript
- License
- MIT
- Branch
- main
Install
$ dsh plugin --profile web add deepseek-harness-zh_proRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin magian1127/deepseek-harness-zh_pro for me: review the repository at https://github.com/magian1127/deepseek-harness-zh_pro first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
一句话定位
为 DeepSeek Harness Web GUI 提供一整套界面与工作流增强，包括中文界面补全、思考折叠展开、会话宽度调节、可编辑的提示词注入、以及把会话移入系统回收站的删除能力。
核心能力
- 中文化界面：仅在中文界面生效，统一术语（token→词元、API Key→接口密钥、TTFT→首词元时间）、把时长与数量按中文格式（万、亿）显示
- 思考过程优化：默认折叠思考内容、限制展开行数，支持按钮逐批展开和滚动模式；新思考出现时自动收起上一条并展开最新
- 对话布局调节：大屏下按 50%–100% 比例调整聊天列宽，两侧留白均分
- 统计信息展示：聊天统计保持单行完整显示，自动缩小字号
- 提示词注入：默认关闭，可选「写入初始系统提示」或「作为首条用户消息」注入可编辑提示词
- 会话自动归档：超过设定天数未活动的会话自动从列表隐藏（仅隐藏，日志保留）
- 查看已归档：在官方列表内嵌归档会话视图，点击即恢复并打开
- 删除会话（回收站）：把会话日志目录移入系统回收站（Windows 回收站 / macOS 废纸篓 / Linux XDG Trash），工作区账本同时移除
技术实现
- 语言: TypeScript（同时面向 Node.js 主机端和浏览器端）
- 关键依赖: 官方 DSH 服务面（loader、settings、systemPrompt、sessionPersistence、workspaceRegistry）；运行时仅使用 Node 内置模块（fs、child_process、crypto）
- 架构模式: 三 id 双通道挂载——持久行
dsh-zh由 cordis.patch.yml 注入；临时热行dsh-zh-hot由 CLI 热安装写入；运行时条目dsh-zh-live由主机监督器接管。客户端通过 DSH 官方 settingsScope 读写命名空间dsh-zh，主机的scope.watch消费同一份数据 - 入口文件:
src/lib/index.ts（主机聚合入口）、src/lib/client/entry.ts（浏览器入口，经典脚本 bundle 由scripts/build-client.mjs生成）、src/bin/dsh-zh.mts（CLI 入口 install/remove/status）
适用场景
日常使用 DeepSeek Harness Web GUI 的中文用户希望界面更顺眼、统计与思考区更易读；需要批量管理历史会话（自动归档 + 回收站删除）；希望在不重启 DSH 的情况下热加载插件；想给模型请求附加一段稳定提示词（默认关闭）。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH | 未声明具体版本 | 仅支持 web profile（默认 profile） |
| Node.js | ^22.19.0 或 >=24.0.0 | 运行时版本要求 |
| 平台 | macOS / Windows / Linux | 回收站分别走 macOS 废纸篓、Windows 回收站、Linux XDG Trash |
| 原生模块 | 无 | 仅使用 Node 内置 API（fs、child_process、crypto、path） |
安装方式
dsh plugin --profile web add github:magian1127/deepseek-harness-zh_pro
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| zhComplete（中文补全） | 开关 | 仅中文界面生效：术语替换、整句模板、数字/时长中文格式 | 开 |
| statsFull（统计全显示） | 开关 | 聊天统计单行完整显示，自动缩小字号 | 开 |
| thinkingAuto（自动展开最新思考） | 开关 | 流式思考出现时展开最新一条，新思考出现时收起上一条 | 开 |
| thinkMaxLines（默认展开行数） | 数字 0–200 | 思考折叠后默认显示的行数；0 表示不限制 | 20 |
| thinkMode（展开模式） | 按钮模式 / 滚动模式 | 按钮模式：点「再展开 N 行」逐批展开；滚动模式：折叠正文自带滚动条 | 按钮模式 |
| chatWidthEnabled（对话宽度） | 开关 | 大屏下启用自定义聊天列宽（视口 ≥1200px） | 开 |
| chatWidth（宽度比例） | 数字 50–100 | 聊天列宽占屏百分比 | 90 |
| deleteSessionEnabled（会话删除按钮） | 开关 | 三点菜单是否显示「删除会话」项 | 开 |
| archiveViewEnabled（查看已归档） | 开关 | 工作区分组是否新增「归档」按钮 | 开 |
| zhPrompt（提示词注入） | 开关 | 是否向模型请求注入提示词 | 关 |
| zhPromptText（注入文本） | 字符串 | 注入到 system prompt 或首条 user message 的文本 | 思考过程和回复始终使用中文输出 |
| zhPromptTarget（注入目标） | system / user | system 写入初始系统提示的 sections；user 作为首条上下文消息插入聊天记录 | system |
| zhAutoArchiveDays（自动归档天数） | 数字 0–365 | 超过该天数未活动的会话自动从列表隐藏；0 关闭 | 7 |
常见问题
Q: 这个插件能完全把 DSH 翻译成中文吗？
A: 不能做整页任意翻译，只能做「中文补全」级别的修正。词典化的术语（token→词元、API Key→接口密钥、LLM→大模型）会统一；时长（1.2K → 1.22万）和数量会按中文写法重写；少数模板整句替换。未在收录清单里的硬编码英文和第三方插件内容保持原样，避免误改正文。
Q: 提示词注入会自动打开吗？会不会偷偷影响模型回答？
A: 不会，默认关闭。编辑提示词文本不等于开启注入。关闭或文本为空时对模型请求零影响；只在设置页显式打开后才会向 system prompt 或首条 user message 注入文本。注入目标切换或关闭时会自动清理已写入的 section，不会留下双份残留。
Q: 删除的会话去了哪里？还能找回来吗？
A: 会话日志目录会被移动到操作系统回收站（Windows 回收站 / macOS 废纸篓 / Linux XDG Trash），工作区账本同时移除该会话槽位。插件内的回收站面板提供「恢复」入口，可一键移回原路径并自动取消归档、会话重新出现在列表。如果操作系统回收站也清空了，则无法恢复。
Q: 运行中的会话能删除吗？
A: 不能。运行中的会话拒绝删除，提示先停止或等待结束；已打开但空闲的会话会自动取消待处理消息后再删除。所有删除行为随 Fiber 可逆清理，进程重启后插件内的回收站清单会清空（属预期，回收站内容仍由操作系统管理）。
Q: 安装后要重启 DSH 吗？官方安装和热安装有什么区别？
A: 官方安装命令（dsh plugin add）需要重启一次 DSH；热安装命令（npx deepseek-harness-zh_pro install）可在 DSH 运行时立即生效，主机监督器会把临时热行迁移为运行时单实例，下次启动仍由持久 bundle 行挂载。
Q: 自动归档会真的删除会话吗？日志还在吗？
A: 不会删除。自动归档只是把超过设定天数未活动的会话从官方列表隐藏，日志文件原地保留。点击工作区「归档」按钮可看到已归档会话，点击即恢复并打开。
Q: 浏览器端如何更新？
A: 客户端脚本在 DSH Node.js 进程里加载，更新包后必须刷新页面才能加载新版客户端脚本；主机文件在 DSH HMR 服务可用时自动热重载，否则按日志提示重启。
上手难度
入门 — 安装一行命令即可使用，所有功能都集中在 DSH 设置 → 增强设置中按开关管理，默认值已按中文用户的常用习惯预设，无需阅读文档即可上手。
已知问题与限制
- 运行中的会话拒绝删除，必须先停止或等待结束；已打开但空闲的会话会自动 cancel 后再删除（src/lib/session-delete.ts:23 / docs/behavior.md:242）
- SQLite 等不提供日志路径定位的后端只能逻辑删除，回收站面板会提示「无法回收」（docs/behavior.md:242）
- 中文补全的硬编码英文只覆盖内置清单，未收录文本和第三方插件内容保持原样，避免误改用户正文；后续方向是补充确认过的硬编码文本并允许用户配置部分术语叫法（docs/behavior.md:253）
- 设置页未开启提示词注入时仍可在 Models 设置页看到一个无害的「提示词注入（deepseek-harness-zh_pro）」目录条目（src/lib/chinese-prompt.ts:181）
- 插件内的回收站清单保存在进程内存，进程重启后清单清空属预期（src/lib/session-delete.ts:32）
DeepSeek Harness 综合性增强插件
综合性增强插件：界面优化、布局调整与提示词注入等更多功能。其中「中文补全」只在中文 界面生效，让中文界面更完整、更易读；统计全显示、自动展开思考、默认展开行数、对话 宽度、自动归档、会话删除按钮在中文和英文界面都生效。提示词注入是独立的显式开关， 默认关闭。
功能
| 功能 | 默认值 | 说明 |
|---|---|---|
| 中文补全 | 开 | 仅中文界面：修正残留英文，统一词元、接口密钥、模型标识、时长和数量格式 |
| 统计全显示 | 开 | 聊天统计保持单行完整显示，自动缩小字号，极端超长时横向滚动 |
| 自动展开最新思考 | 开 | 流式思考出现时展开最新一条，新思考出现时收起上一条自动展开内容 |
| 默认展开行数 | 20 行 | 思考展开后默认只显示最后 N 行（最新内容），超出部分折叠为「展开全部」，避免超长思考卡顿；0 表示不限制 |
| 对话宽度 | 开，90% | 大屏下按 50%–100% 调整聊天列宽，两侧留白均分 |
| 提示词注入 | 关 | 向后续模型请求注入可编辑提示词，可选初始系统提示或首用户提示词 |
| 自动归档旧会话 | 7 天 | 新建会话界面打开时自动归档超过指定天数未活动的会话（仅从列表隐藏，日志保留；设为 0 关闭） |
| 查看已归档 | 开 | 每个工作区行新增「归档」按钮：点击后该分组正常会话隐藏，归档会话行直接出现在官方列表该分组内（随列表整体滚动、按最近活动时间降序、默认 5 个、每批再展开 5 个），行尾三点菜单含重命名 / 分叉 / 取消归档 / 删除，点击归档行即恢复并打开 |
| 删除会话（回收站） | 开 | 会话列表三点菜单新增「删除会话」：日志目录整体移入系统回收站（Windows 回收站 / macOS 废纸篓 / Linux XDG Trash），并移除工作区账本槽位（不保留恢复位） |
| 其他功能 · 会话删除按钮 | 开 | 设置页最下方的「其他功能」分区（分区标题 + 扁平行）：「会话删除按钮」开关控制三点菜单是否显示「删除会话」项 |
中文补全只在中文界面生效；其余界面增强（统计全显示、自动展开思考、对话宽度、 自动归档、会话删除按钮等）在中文和英文界面都生效，文案随界面语言切换。 所有功能都在 DSH 设置 → 增强设置 中配置。完整默认值和边界见 行为契约。
环境要求
- DeepSeek Harness Web GUI，默认 profile 为
web - Node.js
^22.19.0 || >=24.0.0
安装
# 官方通道：安装后重启一次 DSH
dsh plugin --profile web add deepseek-harness-zh_pro
# 热安装：DSH 正在运行时可立即生效
npx -y deepseek-harness-zh_pro install --profile web
本地源码联调（首次使用先安装依赖，prepare 会生成运行产物）：
pnpm install
node bin/dsh-zh.mjs install --profile web --link $PWD
TypeScript 源码构建与检查：
pnpm install
npm run typecheck
npm test
npm pack --dry-run --json
src/ 是唯一手写源码；lib/、bin/、scripts/ 和根目录验证脚本都是被 Git 忽略的构建产物，
由 prepare、npm run build 或 prepack 动态生成。发布前会重新编译并生成客户端经典脚本。
安装后可检查状态：
npx -y deepseek-harness-zh_pro status --profile web
更新
重新执行安装命令即可更新依赖和持久 bundle。浏览器端内容更新后刷新页面；使用本地 link 开发时，主机文件在 DSH HMR 服务可用时自动热重载，否则按日志提示重启。
卸载
dsh plugin --profile web remove deepseek-harness-zh_pro
# 或
npx -y deepseek-harness-zh_pro remove --profile web
卸载会清理临时热行和运行中条目，不会删除 DSH 会话数据。localStorage 与 settings 中的 已有设置值可能保留，重新安装后可继续使用。
设置与数据
| 数据 | 存储位置 |
|---|---|
| 中文补全、统计、思考展开、默认展开行数、对话宽度、查看已归档 | 浏览器 localStorage：deepseek-harness-zh_pro:enhancements |
| 提示词开关、文本、注入目标、自动归档天数 | DSH settings.yaml，命名空间 dsh-zh |
插件不注册模型工具、不上传数据。除用户显式开启的提示词注入外，其余功能不会修改模型请求。 中文补全只在中文界面生效；其余界面增强在英文界面同样生效。提示词注入仍只由自身开关决定。
常见问题
提示词会自动开启吗？ 不会，默认关闭。编辑提示词文本并不等于开启注入。
为什么还有少量英文？ DOM 硬编码文本只覆盖已确认的内置清单；未收录文本保持原样， 避免误改正文或第三方插件内容。
开发文档
License
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/magian1127/deepseek-harness-zh_pro)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.