前言¶
在 DeepSeek Harness(DSH)里跑智能体时,系统提示词、MCP 使用说明和运行时注入往往仍是英文。规则越长,阅读和排查成本越高;若把工具名、参数 schema 一并改成中文,又会破坏与宿主、插件之间的调用契约。下面介绍社区插件 dsh-prompt-zh(npm 包名 dsh-prompt-zh,展示名「系统提示词中文化」):在提示词组装与运行时注入环节,把已知英文规则译成简体中文,并按当前会话可见工具裁剪相关句子,同时保留英文工具 schema 与动态占位符。
这是什么¶
Prompt ZH 由 KouzakiUmi 维护,分类为工作流,在 SkillHub 插件目录 与 GitHub 仓库 发布。它不是聊天翻译器:不改宿主源码,不改工具名和参数结构;中文提示词是语言引导,文档说明其他模型不一定同样遵循,且本轮未做跨模型回复语言对照测试。
许可证为 MIT;当前 package 版本为 1.3.1(以 npm registry 与 GitHub Release 为准,安装后仍须在目标 Profile 验收)。
核心功能¶
规则中文化,契约不动¶
插件在宿主已知段落上工作,翻译可重复执行;未命中时保留原文。
| 内容 | 处理方式 |
|---|---|
| 系统行为指引 | 中文化已知提示词段落,按当前可见工具裁剪相关句子 |
| MCP 使用规则 | 译表含 Blender 等已知指导;运行时无可靠服务器精确版本证据时保留原文 |
| 运行时提醒 | 处理时间/时区、工作区指令包装、技能目录调用纪律、Hindsight 记忆规则等已知文本 |
| Git Bash 附加指导 | 中文化已知 MSYS 路径、shell 路由及 run_code 开启/关闭提示 |
| 工具调用契约 | 保留工具名、参数 schema、代码和动态值;通用 description 及未知附加内容保持原文 |
典型替换示例(取自 README 与翻译函数,并有离线断言):
You are an AI agent powered by DeepSeek Harness.
↓
你是由 DeepSeek Harness 驱动的 AI agent。
Browser time zone for this request: unavailable. Ask the user to clarify otherwise-unqualified dates and times.
↓
本次请求的浏览器时区:不可用。请用户澄清未明确限定时区的日期和时间。
已知才替换,工具集裁剪¶
未知内容不猜译。 工具相关句子按可见工具集裁剪,不向模型推荐不存在的工具。运行时翻译保留全局兜底,并在 agent 初始化完成后注册作用域监听器,覆盖随后由 preset 挂载的时间等注入;对已有 agent 回补,并随 agent、依赖或插件卸载清理。
第三方内容仅在当前解析包版本与条目已核验精确版本一致时翻译;未知或不符版本保留原文。Git Bash context 在组装时可以有译文,但文档注明当前 Core 的后续 refreshContext 仍可能恢复来源英文。
逐条编辑与组件开关¶
1.3.0 起提供宿主 Prompt ZH 设置页(或插件配置区域):每条内置译文有区块、匹配方式、已核验/当前解析版本和处理计数。编辑框默认是内置译文,保存覆盖值后由实际翻译函数读取;不能编辑原文匹配规则。动态 $1、$2 等占位符必须保留。
- 保存到当前 Profile:使用原生配置表单及修订号校验,不使用浏览器存储代替。
- 组件开关:关闭后对应文本保留原文;第三方版本门控不能由开关绕过。
- 刷新信号:读取当前保存配置的累计命中/输出改变;不保留会话正文或动态捕获值。
仍看到英文不一定是插件未生效:宿主在翻译之后重建的 runtime-context 快照、创建完成后新增的外层注入方,以及宿主之外追加的系统消息仍可能为英文;技能摘要/正文、未知 MCP 正文和工具 schema 也不做全面翻译。边界见仓库 兼容性与覆盖范围。
安装与启用¶
一般安装参考 dsh plugin;以下以 web 为示例 Profile(仅代表文档示例,请按你的实际 Profile 与 CLI 入口操作)。Desktop 使用目标桌面壳自带的 DSH Desktop CLI,不用独立公共/Core CLI 管理保留的 desktop Profile。
先做 npm 安装:
dsh plugin --profile web add dsh-prompt-zh
更新已安装版本:
dsh plugin --profile web update dsh-prompt-zh@latest
也可从 GitHub Releases 下载 dsh-prompt-zh.tgz,用 tarball 绝对路径安装(勿把源码 ZIP 当作验证过的发布包):
dsh plugin --profile web add "<tarball 的绝对路径>"
安装或更新后,按部署方式重新启动或重载 DSH,让 Host 插件重新加载。Node.js 要求 >=18;systemPrompt 为必需宿主服务,agents 动态接入,缺少时保留静态翻译与全局兜底。
典型用法与验收¶
经过上面的步骤,插件会在提示词管道中自动替换已知英文规则;无需额外 API 调用。建议在目标 Profile 打开设置页,按需关闭某组件或覆盖单条译文,保存后观察刷新信号中的命中/输出改变计数(保存成功不代表已经遇到原文或最终请求已生效)。
若需对照开发或离线测试方式,见仓库 开发与验证 与 更新记录。
适用场景与注意¶
适合谁: 长期在 DSH 中用简体中文阅读系统规则、MCP 说明和运行时提醒,又需要保持工具调用契约与 schema 英文不变的开发者。
权限与克制(README 明确声明): 不读取账户凭据,不改宿主安装包,不启动子进程,不向外部翻译服务发送提示词;翻译处理本身不写文件,保存操作由宿主写入当前 Profile。插件以当前 dsh 进程权限运行,安装前应自行查看源码与 MIT 许可证。
兼容性: package 声明与 Core 0.2.1-alpha.2 兼容;文档记载在 Desktop 壳 2.0.17-next 随包 Core 0.2.1-alpha.2 和 Cordis 4.0.5-alpha.1 上做过插件加载、实际时间注入及卸载清理的隔离测试,未在当前生产 Profile 安装验收。兼容声明不代表所有宿主、provider 和插件组合均完成现场验收。
DSH 生态理念是「一切皆插件」;SkillHub 为社区目录,与 DeepSeek/幻方无官方从属关系。
结尾¶
dsh-prompt-zh 把 DSH 已知系统提示与运行时注入本地化为简体中文,并按可见工具裁剪指引,同时保留工具 schema 与配置可编辑性。目录页:https://www.skillhub.cn/plugins/KouzakiUmi/dsh-prompt-zh;源码与文档:https://github.com/KouzakiUmi/dsh-prompt-zh。