DSH 综合增强插件,提供中文界面补全、思考折叠展开、会话宽度调整、提示词注入、会话删除入回收站等界面与数据管理能力。
- 语言
- TypeScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add deepseek-harness-zh_pro在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 magian1127/deepseek-harness-zh_pro:先查看仓库 https://github.com/magian1127/deepseek-harness-zh_pro 确认安全性,然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。
一句话定位
为 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
查看使用指南 →
该插件的安装步骤、关键要点、FAQ 与兼容性说明(基于已收录字段派生)。
收录徽章
[](https://deepseek-plugin.org/plugins/magian1127/deepseek-harness-zh_pro)把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。