Vai al contenuto principale
M

deepseek-harness-zh_pro

magian1127/deepseek-harness-zh_pro

Suite di miglioramenti UI per il client web DSH: completamento della locale cinese, statistiche in una riga, pensiero espanso automaticamente, larghezza della chat, archiviazione ed eliminazione delle sessioni, più un interruttore opzionale di prompt injection (disattivato per impostazione predefinita).

Installazione

dsh plugin --profile web add github:magian1127/deepseek-harness-zh_pro

README

deepseek-harness-zh_pro

DeepSeek Harness 综合性增强插件

语言 / Language: 中文 · English

版本 0.11.2 界面 中文 MIT License

综合性增强插件:补全中文界面,并提供思考显示、会话列表、服务监控和模型请求中文化 等增强。「中文补全」只在中文界面生效;其余界面与会话增强同时支持中文和英文界面。 所有会修改模型请求的功能都是独立的显式开关,默认关闭。

功能

下表按 DSH 设置 → 增强设置 的实际排列顺序,从上到下逐项列出,同一分组内的条目也保持界面顺序。 界面最下方是置底操作栏:改动先暂存,点「保存」一次性生效并写盘(主机字段原子提交,避免逐项写入的卡顿),「还原」丢弃未保存改动。

中文补全与模型请求中文化

功能默认值说明
中文补全开仅中文界面:修正已确认的残留英文,统一术语与数量、时长格式
代理角色提示中文化关把默认代理的系统提示词换成中文;仅新会话首次请求时锁定,不追溯旧会话
工具说明中文化关中文化官方工具说明;工具名、参数与第三方工具保持不变;仅新会话生效
上下文注入中文化关把 DSH 注入会话的官方上下文换成中文,GUI 与模型请求一致;仅新会话生效。覆盖运行时上下文快照(含头部行与正文)、时间读数、工作区指令帧、skill 目录帧、审批与计划模式切换通知等
提示词注入关按「注入文本」向模型请求注入一段提示词,生效于后续请求。默认文本为 “始终用中文进行推理,并用中文输出你的思考过程。”

对话样式相关(收缩分组)

功能默认值说明
自动展开最新思考开流式思考出现时展开最新一条,新思考出现时收起上一条
默认展开行数20 行,最新 N 行思考默认只显示 N 行,超出折叠以减轻卡顿;范围 0–200,0 为不限制,方向可选最早 N 行
展开模式按钮模式按钮模式逐批展开;滚动模式在固定高度正文内滚动

对话列表相关(收缩分组)

功能默认值说明
自动归档旧会话7 天打开新建会话界面时,归档超过 N 天未活动的会话(只隐藏,日志保留);范围 0–365,0 为关闭
查看已归档开工作区行提供归档入口:归档会话直接列在官方列表对应分组内,行菜单可重命名、分叉、取消归档或删除
会话删除按钮开会话菜单提供「删除会话」,普通会话与归档会话均可删;日志进系统回收站,不保留列表恢复位
会话多选开空闲会话可勾选批量删除或归档;运行中、待交互、完成未读不可选。批量项随选中内容变化,工作区行另有全选

网络搜索(收缩分组;搜索项在前,读取项接在后面)

功能默认值说明
智能搜索按钮开在输入框下方工具行显示「智能搜索」;关闭后按钮与相关代码都不加载。开启时按会话记忆,取消后该会话不再注入联网工具与说明段
启用多引擎搜索开按「搜索后端优先级」接管 web_search 后端;关闭则保持部署配置的后端
每查询返回条数0(不接管)0 保持官方行为(8 条 + 轮询合并);设为 N 后按查询分组保留 N 条,跨查询去重。实际条数还受官方「每次搜索结果数」限制
搜索后端优先级DeepSeek Search API → 智谱 → 免 Key 多引擎▲/▼ 调整。逐个尝试:未注册、不可用或失败即降级,全部失败才报错,用户取消不重试。免 Key 多引擎含 DuckDuckGo、Yandex、Bing、Wikipedia,配了 TAVILY_API_KEY 则 Tavily 优先
Tavily API Key空在此填/清除密钥,保存即生效,无需重启

读取部分(同一卡片内,接在搜索项之后):

功能默认值说明
启用免 Key 网页读取开按「读取后端优先级」接管 web_fetch 后端;关闭则保持部署配置的后端
读取后端优先级DeepSeek 云端读取 → 智谱 webReader → 免 Key 环 → 本地抓取▲/▼ 调整,降级规则同搜索。免 Key 环依次尝试 Exa → Parallel → Keenable 公共端点;抓取会把 URL 发给对应厂商的云服务,正文包「外部网页内容(不可信)」边界标记。安全闸门:仅公开 http(s),拒绝内嵌凭据与本机/私网地址

插件同步(收缩分组)

功能默认值说明
插件同步方向随当前环境以另一侧 profile 为参考同步已装插件:网页端跑为「桌面 → 网页」,桌面版跑则相反。同名包只取最高版本,绝不降级;升级走「先卸载再安装」,新版本装不上会自动回滚到旧版本。走官方插件管理器,自带 peer 检查与失败回滚

服务监控(独立卡片,默认关闭)

功能默认值说明
服务监控关显示对话期间新启动的本地监听服务,悬停按需解析进程、点击定位目录;左栏面板一屏最多 10 行,超出可滚动翻页
工作区常驻监控开在左侧会话列表与设置之间常驻显示监控面板
侧边栏监控卡片开右侧边栏新增「服务监控」tab(入口在引导页),条目时间后有三个操作:排除监控、永久监控、终止进程
刷新间隔10 秒范围 2–300 秒;页面不可见时暂停轮询
自定义监控项空可增删改,常驻显示在线/离线,悬停查进程;最多 100 项

「对话样式相关」「对话列表相关」「网络搜索」和「插件同步」是可收缩分组,默认收起、各自记忆展开状态; 服务监控卡片也可折叠。完整交互、数据与安全边界见 行为契约。

环境要求

  • DeepSeek Harness >=0.2.0-rc.2 <0.3.0(清单 engines.dsh 声明,覆盖 0.2.x 全家族; 0.1.x 及更早会被 DSH 的插件兼容检查拒绝加载);完整 UI 使用 web
  • Node.js ^22.19.0 || >=24.0.0

DSH 0.2.1 移除了内置 {{cwd}} 提示词变量(工作目录改由 working-directory 服务提供)。 它对解析不了的 {{…}} 引用是直接拒绝请求,本插件已适配:自定义部署若在 personaSuffix / preset 的 suffix 里保留 Your working directory is {{cwd}}., 本插件会清空该句而不是把它写回请求;提示词注入文本框里写了 {{cwd}} 等解析不了的 占位符时,该段改为原样保留(不插值)而不是让请求失败。详见行为契约。

安装

# Web GUI
dsh plugin --profile web add deepseek-harness-zh_pro

# 无头模式(headless)
dsh plugin --profile headless add deepseek-harness-zh_pro

# 仅用于正在运行的 Web GUI 热安装
npx -y deepseek-harness-zh_pro install --profile web

bundle 按 profile 隔离。headless 只运行 Host 半边,没有浏览器增强。

桌面版 DSH(Electron 应用):本插件兼容桌面版(同一套 Web 应用与插件机制,桌面 Host 端口 19387)。桌面 profile(~/.dsh/profiles/desktop)由桌面应用独占,dsh plugin CLI 按名拒绝,本插件自带的 dsh-zh CLI 同样拒绝 --profile desktop。link 开发安装(在桌面应用未运行时执行)——编辑 ~/.dsh/profiles/desktop/package.json:

"dependencies": { "deepseek-harness-zh_pro": "link:<本仓库绝对路径>" },
"dsh": { "profile": { "bundles": [ /* 官方 bundle 保持原样,末尾追加 */ "deepseek-harness-zh_pro" ] } }

在 profile 目录内执行 pnpm install 物化链接,启动桌面应用即挂载;改源码后 npm run build 并重启桌面应用载入新构建;卸载则移除上述两处条目后重新 pnpm install。

在桌面版与 Web 之间同步插件:两个 profile 各自装过的插件不必逐个重装——在要补齐的那一侧 打开 设置 → 增强设置 → 插件同步,点「检查差异」看清单、再点「一键同步」即可。方向随当前环境 自动确定:在网页端运行就是「桌面版 → 网页端」,在桌面版运行就是「网页端 → 桌面版」;同名包只取 版本号更高的一侧,当前版本已经不低于参考时保持不动(绝不降级),只增不减。该功能复用 DSH 官方插件 管理器,因此与在桌面应用侧栏「插件」页手动安装等效,并且自带 peer 兼容检查与失败回滚。

本地源码联调:

pnpm install
node bin/dsh-zh.mjs install --profile web --link $PWD
dsh plugin --profile headless add "link:<项目绝对路径>"

TypeScript 源码构建与检查:

pnpm install
npm run typecheck
npm test
npm pack --dry-run --json

src/ 是唯一手写源码;lib/、bin/、scripts/ 和根目录验证脚本都是被 Git 忽略的构建产物, 由 prepare、npm run build 或 prepack 动态生成。发布前会重新编译并生成客户端经典脚本。

安装后按 profile 分别检查:

npx -y deepseek-harness-zh_pro status --profile web
dsh plugin --profile headless list

更新

重新执行安装命令即可更新依赖和持久 bundle。浏览器端内容(界面、设置页、卡片)由 client-hmr 每 500 ms 轮询自动换血,构建后无需刷新页面。

主机半边(lib/*.js)在本地 link 开发时构建完成即自动生效:

  • 本包监听自己的构建产物,检测到变化后自动完成换血——清掉本包在 ESM 与 CJS 两层的模块缓存,重新 import 入口,再重建 Fiber 接管原有行。不需要重启, 也不需要用插件清单的停用→启用往返。
  • 首次升级到含此能力的版本需要重启一次 dsh web:换血代码本身还在旧模块 里,鸡生蛋;重启之后的新构建即享免重启换血。
  • 安装态(npm 安装、非 link)同样有效,但通常用不到——升级走安装命令即可。

需要区分的一点:插件清单里「停用 → 启用」不会载入新构建。它只重建 Fiber 并 复用进程内的旧模块命名空间,不重新 import。别把它当作更新手段。

不要以反复试探代替诊断。

卸载

dsh plugin --profile web remove deepseek-harness-zh_pro
dsh plugin --profile headless remove deepseek-harness-zh_pro
# 正在运行的 Web GUI 也可使用:
npx -y deepseek-harness-zh_pro remove --profile web

卸载按 profile 独立清理;短进程 profile 从下一次调用起不再加载,且不删除会话数据。

设置与数据

数据存储位置
中文补全、思考显示、统计、归档视图、会话删除、会话多选、服务监控及三张卡片的展开状态浏览器 localStorage:deepseek-harness-zh_pro:enhancements
代理角色提示中文化、工具说明中文化、上下文注入中文化、网络搜索、搜索后端优先级、每查询返回条数、免 Key 网页读取、读取后端优先级、提示词开关/文本/目标、自动归档天数DSH settings.yaml,命名空间 dsh-zh
Tavily 官方 API 密钥(可选,启用后搜索优先走 Tavily)DSH 凭据:${DSH_HOME:-~/.dsh}/.credentials.yaml 的 refs: 段键 TAVILY_API_KEY,或同名环境变量(插件每次调用现查,不缓存);也可直接在设置页「网络搜索」卡片里填写/清除(写同一位置,界面只回脱敏提示)

插件不上传数据;模型工具注册仅限网络搜索的 web_search 工具壳(随开关装卸,见功能表)。除网络搜索与用户显式开启的提示词注入、代理角色提示中文化、工具说明中文化与上下文注入中文化外,其余功能不会修改模型请求;上下文注入中文化替换注入会话历史的官方英文文本,关闭后新注入恢复英文,已写入会话的部分按官方行为保留。 网络搜索开启时,搜索查询会发送到所选后端;接管后端选择时本插件还会把 web 行的 searchProvider 写成 dsh-zh-web(经官方 settings 通道,持久化在 profile patch 里),关闭开关或卸载时还原接管前的值。查询按优先级列表逐个尝试:未安装或不可用的后端直接跳过,失败的后端记降级诊断后继续下一个,因此一次查询最多触达列表里靠前的若干个后端。智谱插件在场且可用时发往智谱(由智谱插件处理),配了凭据 TAVILY_API_KEY 时发往 Tavily 官方 API(密钥只进 Authorization 请求头),否则发往公开的 DuckDuckGo/Yandex/Bing/Wikipedia 端点;本插件不存储查询与结果,也不把密钥写入配置、日志或诊断快照。 免 Key 网页读取开启时同理接管 web 行的 fetchProvider(写成 dsh-zh-web-fetch,关闭/卸载还原)。默认顺序里 DeepSeek 云端读取与智谱 webReader 未安装/未配 Key 时自动跳过,免 Key 环按 Exa → Parallel → Keenable 依次尝试(单端点超时 30 秒,限流端点 60 秒内跳过);抓取请求的 URL 会发给所选后端(免 Key 端点是公共云服务),正文前后包「外部网页内容(不可信)」边界标记,本插件不存储 URL 与正文。 中文补全只在中文界面生效;其余界面增强在英文界面同样生效。提示词注入仍只由自身开关决定。

无头模式(headless)没有浏览器设置页,但共用 ${DSH_HOME:-~/.dsh}/settings.yaml;可先在 Web GUI 保存四个 Host 开关,后续 headless 读取同一 dsh-zh 命名空间。

常见问题

提示词会自动开启吗? 不会,默认关闭。编辑提示词文本并不等于开启注入。

为什么还有少量英文? DOM 硬编码文本只覆盖已确认的内置清单;未收录文本保持原样, 避免误改正文或第三方插件内容。

怎么让搜索走 Tavily? 直接在设置页「网络搜索」卡片里填入 Key 并保存即可(保存即生效, 无需重启)。注意首次安装或更新本插件后要重启一次 dsh web:凭据接口是主机半边新增的, 不重启时卡片会提示「主机接口未就绪」(key 本身没有问题)。也可以手动在 ${DSH_HOME:-~/.dsh}/.credentials.yaml 的 refs: 段加一行 TAVILY_API_KEY: "tvly-…"(或设同名环境变量)。识别到即优先走 Tavily 官方 API (search_depth: basic,免费额度 1000 次/月,每次搜索消耗 1 点),用尽后自动退避 1 小时并 降级到免 Key 引擎,搜索不会整体失败。环境变量优先于凭据文件,此时卡片里的「清除」不可用。 想省额度、只在免 Key 引擎全部失败时才动用 Tavily,见 docs/behavior.md 的「Tavily 额度消耗」。

搜索报「DuckDuckGo 触发反爬限流 (HTTP 202)」? 这是本机 IP 上 DDG 的常态,插件会自动 降级到 Yandex/Bing/Wikipedia 并把各引擎归因聚合进错误消息。排查见 docs/troubleshooting.md。

开发文档

License

MIT

Plugin correlati