dsh-skill-zh
Manifest validTranslates every DSH skill description into Simplified Chinese and condenses it into one short line, so the skill menu reads the same after each new plugin is installed. Ships a pre-translated cache,
dsh-skill-zh · 技能说明中文化
把 DeepSeek Harness / 菜单里那些英文技能说明换成简体中文。现在装着的技能立刻变中文,以后新装的技能也会自动翻译。
它做了什么
- 包住宿主侧的
sessionSkillCatalog.list(也就是 Web 端/菜单背后的skills/list接口),把每条技能description换成中文译文。 - 译文来源:本地缓存
cache/zh.json命中就立刻返回;没命中先返回原文,同时后台用 Bing Edge 匿名翻译接口翻译并写缓存 —— 下次打开菜单就是中文,不需要重启、不需要 API Key。 - 只改「显示用」的这条链路:技能文件本身、以及模型看到的能力说明都不动。
自检接口
插件在宿主注册了 /skill-zh 前缀路由(仅 localhost):
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /skill-zh/api/status | 缓存条数、翻译队列、是否成功接管 |
| GET | /skill-zh/api/preview?sessionId=<id> | 走一遍被打包的 list,看每条实际中文效果 |
| POST | /skill-zh/api/warm {sessionId} | 预热:把该会话可见的说明一次翻完(等它返回再开菜单就是全中文) |
| POST | /skill-zh/api/retry | 清空失败标记,允许重试 |
示例(端口用当前 GUI 端口):
curl -s "http://127.0.0.1:59121/skill-zh/api/status"
curl -s "http://127.0.0.1:59121/skill-zh/api/warm" -X POST -H 'content-type: application/json' -d '{"sessionId":"session-xxxx"}'
安装
插件按插件市场认得的「三件套」打包(package.json 的 dependencies + dsh.profile.bundles + 本包自带的 cordis.patch.yml insert 行),所以既能手装,也能在市场里开关。
插件市场安装(推荐):打开 DSH 的「插件市场 → 设置 → 从 tarball 安装」,粘贴
https://github.com/tongqing1130-png/dsh-skill-zh/releases/download/v1.1.0/dsh-skill-zh-1.1.0.tgz
装完在市场里就能直接开/关。
tarball 是
npm pack布局(所有文件在package/下),文件名带版本号,指向具体 tag 而不是latest/download—— 这样以后发新版换资产时不会把旧条目指到别的文件上。
手动安装:
-
dsh-skill-zh/放到<DSH_HOME>/profiles/desktop/local-plugins/下; -
profile 的
package.json加依赖"dsh-skill-zh": "link:./local-plugins/dsh-skill-zh",并在dsh.profile.bundles末尾加"dsh-skill-zh"; -
profile 的
cordis.patch.yml加一行覆盖(可选,用于市场开关):- id: dsh-skill-zh disabled: false不要再写
- insert:行 —— insert 已由本包自己的cordis.patch.yml提供,写两份会重复挂载。 -
让宿主加载新代码:改 profile
package.json/cordis.patch.yml的内容(HMR 只在内容变化时触发,touch无效);改了lib/index.js需要重载对应条目或重启一次 DSH。
调参
lib/index.js 顶部常量:
BING_ENDPOINT:翻译端点;TARGET:目标语言(默认zh-Hans)。MAX_TEXT:单条送去翻译的最大字符(默认 1800)。CONCURRENCY:并发翻译数(默认 2,别调太高,公共接口有限流)。- 缓存文件:
cache/zh.json(插件目录下,随插件走,删掉即全量重译)。
兼容性
- 依赖宿主服务
sessionSkillCatalog与webServer;DSH 1.0 线上版本的skills/listRemote 即由前者提供。 - 若某天 DSH 改了方法名,
/api/status的patched会变false,此时插件只剩自检路由,不影响 DSH 本身。
License
MIT © 2026 Dizrt1001
生效与卸载
- 技能菜单的数据来自宿主服务
sessionSkillCatalog.list。本插件在类原型上包装这个方法, 因此宿主侧代码改动属于 ESM 模块变更,重启一次 DSH 才会生效(客户端无需额外操作)。 - 卸载/停用时把原型描述符原样还原;不要用
delete proto.list(会把原始方法一起抹掉, 导致/技能菜单报service.list is not a function,只能重启修复)。 - 自检:
GET /skill-zh/api/status(build/patched/cache)、GET /skill-zh/api/preview?sessionId=<真实会话 id>(看替换后的中文)。
一句话简化(v3-short)
菜单里一行放不下长描述,所以本地化分两步:
- 翻译:英文 → 简体中文(Bing 匿名接口,写
cache/zh.json)。 - 简化:压成一句话(≤ 30 字,可用环境变量
DSH_SKILL_ZH_SHORT_MAX调整)。- 优先级 1:
cache/shorts.json里按技能名手写的短描述(目前 52 条,人工润色)。 - 优先级 2:缓存条目里的
short字段(翻译时用规则算好并存下)。 - 优先级 3:规则实时计算 —— 先取第一句(
。!?;),超长再按,、逐个子句累加, 到上限就断并补…。
- 优先级 1:
原文不丢:命中简化时仍会带 descriptionFull(完整中文)供接口查看。
v4-auto 起不再需要热重载:cache/zh.json 与 cache/shorts.json 按 mtime 自动重读(refreshIfChanged()),
改完文件几百毫秒内就生效。另外插件每 60 秒扫一次技能目录(DSH_SKILL_ZH_SCAN_MS 可调),
装完新技能不用等第一次打开菜单也会被翻译。
更新日志
- 1.1.0 —— ① 新增技能目录自动扫描(启动后 1.5s + 每 60 秒,未缓存的英文描述直接入队翻译,新装技能不必等第一次打开菜单);②
cache/zh.json/cache/shorts.json按 mtime 自动重读,改文件立即生效,不再需要重载插件;③ 重写简化规则:先纠常见误译(硬化→加固、润饰→润色、剥除→剥离、塑造→规划…),再剥掉「当用户想要…时使用:」套话并保留动词短语,实测比旧版短且通顺;④ 打包改为npm pack布局(package/前缀),修掉 pnpm 压平导致lib/index.js变index.js的问题。 - 1.0.0 —— 首个版本:
sessionSkillCatalog.list本地化 + 一句话简化 +/skill-zh/api/{status,preview,warm,retry,shorts}自检接口。
Versions
| Latest version | Published | Size |
|---|---|---|
| 1.1.0 | — | — |
Comments
Loading…
Similar plugins
by gtbwpkwjnb-alt
让英语不好的用户也能看懂 DSH 插件:把插件的英文标题与说明精炼成中文(保留原包名),写入 locale 使内置插件页原生显示中文;同时一页审查已装插件与技能的版本、更新与冲突。Turn English DSH plugin titles/descriptions into clear Chinese, natively in the built-in Plugins page.
★ 0
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-audit-skillsby Gavin237
DSH plugin: inject a one-line hint naming skills that match the current turn, so installed-but-forgotten methodology skills actually get used. Deterministic matching, no LLM calls, fail-open.
★ 0
NOASSERTION
TypeScript
Sep 20, 2026
dsh plugin --profile web add dsh-capability-hint把 DSH 能读到的 skills 统一扫描、 归并、可视化,解决「skills 太多、不知道哪个命令属于哪个来源」的痛点。
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-skill-catalogby weilantianhai
/skills command for DSH — list skills with auto-translated descriptions (zh↔en)
★ 3
MIT
JavaScript
Sep 10, 2026
dsh plugin --profile web add dsh-command-skill-listby Daneel0001
Render installed DeepSeek Harness plugin titles and descriptions in Simplified Chinese, translated at startup by DSH's own LLM service and cached in a local JSON file.
★ 0
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-plugin-zh-cnby blacktaoK
Chinese summaries for the dsh-skill-mcp-panel skill cards: each expanded card gets a short Chinese overview, a category tag and a few bullet points, while the English description the panel already ren
★ 0
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add dsh-skill-zh-overlay