厂商参数转换与修复 PerryLink/dsh-translate

🔁 dsh-translate

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-translate（计入 deepseek1024.com 安装排行）。

dshfind

为 DeepSeek Harness 做服务商参数翻译，并提供确定性 JSON 修复。

同一份请求，适配每家服务商。JSON 坏了就修好，绝不凭空编造数据。

这是服务商参数映射表，不是机器翻译。

官方仓库。 这里是 dsh-translate 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库与本项目无关。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

dsh plugin --profile <name> add dsh-translate

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

- git 渠道（最新 main）：dsh plugin --profile web add github:PerryLink/dsh-translate —— 纯 JS，无需构建步骤。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-translate。
- tarball 渠道：在本仓库执行 pnpm pack，再执行 dsh plugin --profile web add ./dsh-translate-<version>.tgz。
- 卸载：dsh plugin --profile web remove dsh-translate（或从配置档补丁里删掉这一行）。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-translate 是什么？

为 DeepSeek Harness 做服务商参数翻译，并对 JSON 做确定性修复。

同一份请求，每家服务商都能用。坏掉的 JSON 就地修好，绝不凭空编造数据。

dsh-translate 的工作流示意图：安装 → 打开面板 → 执行操作。

工作流概览：安装 → 打开面板 → 执行操作。下面的示例用的都是真实命令。

兼容性

| 层面 | 状态 |
| Harness | 主版本 dsh-v0.2.1-alpha.1（2026-09-25 验证：双 typecheck 标尺 + node --test 80/80 + 自包含/产物门禁）。npm dev/test 现在锁定 0.1.7-rc.2；peers 为 >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0。 |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 形态 | 纯宿主 JS 插件（没有浏览器端） |
| 模型 | 任意模型 —— 修复是确定性的，不额外调用模型 |

你能得到什么

一个包，两个独立层面：

- /translate —— 服务商参数翻译表：temperature、top_p、max_tokens、stop、system 等 8 个标准参数，映射到 11 家服务商（OpenAI、ERNIE、Qwen、Anthropic、Google、DeepSeek、Mistral、Cohere、xAI、Groq、Azure）。你可以查两两之间的映射、列出服务商/参数，或转换整份标准请求（lib/rosetta.mjs 里的 transformRequest）。
- 修复层 —— 一个 tools/post-execute 监听器，加上 fix_json 工具。当成功的工具结果里带着坏掉的 JSON 字符串（输出 schema 以字符串为根或以 json 为根，或按名字显式启用的工具），这一层会确定性地修复它：提取 markdown 围栏、修复转义、去掉尾逗号、补全截断、用显式 null 占位补上必填字段。绝不编造任何值 —— 修完仍然违反 schema 的结果会按失败处理，失败的工具结果也永远不会被翻成成功。

tool result (success, JSON text) ──▶ extract fence ──▶ parse
│ ok? ──▶ schema-validate ──▶ accept { kind: 'accept', value } (registry re-validates + re-renders)
│ broken ──▶ escape / trailing-comma / close / fill-null ──▶ validate
│ unrepairable ──▶ next() (original value preserved) + translate/fix audit (counts only)

快速开始

dsh plugin --profile web add github:PerryLink/dsh-translate

1. install the bundle into your profile
dsh plugin --profile web add github:PerryLink/dsh-translate

or from npm (published releases)
dsh plugin --profile web add dsh-translate

2. restart and verify the row
dsh --profile web --dump-config | grep -A2 'id: dsh-translate'
然后让智能体检查映射，或者修复 payload：

/translate openai ernie max_tokens
Use fix_json to repair: {"a": 1,} against {"type":"object","properties":{"a":{"type":"integer"}},"required":["a"]}

示例

下面是插件的真实入口；安装一次，之后调用其中一个即可。

详细示例

命令

~~~sh
/translate openai ernie max_tokens

输出

~~~text
openai (OpenAI) → ernie (Baidu ERNIE (Wenxin)):
max_tokens: max_tokens → max_output_tokens

来源：README.md:107-110; index.mjs:372-385; test/index.test.mjs:100-105

失败分支

输入

~~~text
{"text":"{}","schema":{"pattern":"x"}}

输出

~~~text
fix_json failed (INVALID_SCHEMA): #.pattern is not a supported keyword (subset: type/oneOf/properties/required/additionalProperties/items/enum/const)

来源：plugins/dsh-translate/index.mjs:486-488; plugins/dsh-translate/lib/fix.mjs:241; plugins/dsh-translate/test/index.test.mjs:347-352

简要示例

- fix_json

配置

所有可调项都是 Schemastery 的 Config 字段，可以在 cordis.yml 里改。按 id 定向覆盖会替换整行，所以你需要用到的键都要重新写一遍。cordis.patch.yml 里逐键写了说明。

| 键 | 默认值 | 含义 |
| enabled | true | 总开关；设为 false 就什么都不注册 |
| repair.enabled | true | 执行后修复层的开关 |
| repair.toolNames | [] | 额外要修复 JSON 文本结果的工具名（在字符串根 / json 根的 schema 之外再加） |
| repair.strategies.escapeRepair | true | 转义字符串里的原始控制字符 |
| repair.strategies.trailingComma | true | 删掉右括号前多余的逗号 |
| repair.strategies.truncationClosure | true | 补全因截断而没闭合的字符串或容器 |
| repair.strategies.fieldCompletion | true | 用显式 null 占位补上缺失的必填字段 |
| repair.maxSteps | 8 | 策略执行预算（修复循环的轮数，1..64） |
| diffMaxChars | 200 | 单条 diff 日志片段的字符上限 |
| diffMaxEntries | 50 | diff 日志条目的上限 |
| registerCommand | true | 注册 /translate 命令 |
| registerTool | true | 注册 fix_json 工具 |
| rosettaDataPath | （无） | 可选的外部 rosetta 数据文件（结构与内置的 lib/rosetta-data.json 相同）；会覆盖内置映射表 |

在配置档补丁里覆盖的示例： yaml
- insert:
- id: dsh-translate
name: dsh-translate
config:
enabled: true
repair:
enabled: true
toolNames: ['emit-json']
strategies:
escapeRepair: true
trailingComma: true
truncationClosure: true
fieldCompletion: true
maxSteps: 8
diffMaxChars: 200
diffMaxEntries: 50
registerCommand: true
registerTool: true

工具与界面

| 界面 | 类型 | 说明 |
| /translate | 命令 | vendors、params，或 <from> <to> [param] 成对映射 |
| fix_json | 工具 | { text, schema?, strategies? } → { ok, repaired?, diff?, strategies, truncated, validated, error? }；diff 片段有长度上限并做过净化 |
| 执行后修复 | 监听器 | 对字符串根 / json 根 schema（外加 repair.toolNames）的成功字符串结果自动生效；除非它接管了这次调用，否则总会调用 next() |

权限与数据

- 权限：不联网、不启动子进程、不读取凭据 —— 插件只消费官方 commands 和 tools 服务，并向会话日志追加记录。
- 数据：修复过程从不编造值；模型能看到的额外内容只有修复后的规范值和 fix_json 的 diff。会话审计事件（translate/fix）只携带工具名、调用 id、策略名、编辑次数和截断标记 —— 从不包含载荷。审计写入受宿主会话事件词表控制：认识 translate/fix 的宿主走普通的两参数追加，带 ignorable 追加信封的宿主走带标记的追加。在 0.1.6+ 和 0.2.x 上，私有的 translate/fix 类型不在宿主词表中，因此不会写入审计事件；工具结果仍是模型可见的日志。这是可观测性上的限制，不是数据面的改动。

安全边界

- 只做确定性处理。 修复是有边界的文本手术；JSON-Schema-Enforcer-Proxy 上游那条 LLM 重试分支被有意没有移植 —— 执行后监听器从不调用模型。
- 失败即关闭。 无法修复的语法错误和 schema 违规会保持原结果不动（或由 fix_json 返回结构化错误）；null 占位符只在 schema 接受 null 时才写入。
- 恶意输入有边界。 不支持的 schema 关键字和循环 schema 会被拒绝；oneOf 校验受深度上限（MAX_ONE_OF_DEPTH）和分支预算（MAX_ONE_OF_BUDGET）约束，因此指数级 schema 无法耗尽进程。
- 不泄漏载荷。 日志和审计事件从不包含修复后的载荷；diff 在展示或存储前会截断并设上限。

已知限制

- 支持的 JSON Schema 子集与 harness 工具注册表一致（type/oneOf/properties/required/additionalProperties/items/enum/const）；其他关键字按不支持拒绝，不会静默忽略。
- 修复只作用于成功结果，且其规范值必须是 JSON 文本字符串；已经未通过 schema 校验的值会以失败结果到达，永远不会被翻转。
- 翻译表覆盖 11 个服务商 × 13 个规范参数；extended 行依据公开 API 参考（不是上游那三家），并在 lib/rosetta.mjs 中做了标记。
在既不懂 translate/fix、也不暴露 ignorable 追加信封的主机上——包括 0.1.6+ 和 0.2.x，它们的私有类型词表里没有这个类型——自适应门控会跳过审计追加，因此会话日志永远不会被污染；在事件类型注册之前，工具结果始终是持久证据。

开发 sh
pnpm install # node ^22.19 || >=24
pnpm test # node --test: 79 tests (pure lib suites + real-service assembly suite)
pnpm run check # tsc checkJs against types.d.ts
pnpm run verify:self-contained # dependency specs resolve from the registry
pnpm run verify:artifacts # ESM face imports under plain Node + lib exports present
node scripts/check-readme-sync.mjs # five-language README sync gate (also in CI)
pnpm pack # the published tarball

与其他 DSH 插件的互操作性

已针对 DSH 0.2.0-rc.2（本 README 所面向的运行时）以及 2026-10-05 调研的高星插件集做过验证。

本插件不会干扰其他插件，包括广泛安装的高星插件：

- 无工具名冲突。 每个工具都带命名空间；不会注册已发布工具或其他插件占用的裸名。
- 无服务键冲突。 它根本不提供服务键，因此不可能在服务键上冲突。
- 无槽位冲突。 它不注册客户端槽位键，因此不会争抢 shadows-shipped-ui 的席位。
- 无 HTTP 路由冲突。 它不注册 webServer 前缀。
- 无补丁层冲突。 打包补丁只 insert 自己那一行；从不覆盖内置行的 config。
- 无全局改动。 它不改原型、不改写 process.env、不替换全局 fetch 调度器。

共享事件监听器在构造上互不干扰。 它用 ctx.on() 观察对顺序敏感的事件 tools/post-execute——这是 Cordis 的广播注册方式，每个监听器都会执行，谁也无法饿死别人。这里每个监听器都通过 next() 委托，因此调用链永远不会被短路；改动施加在 next() 产出的值上，而不是取而代之返回：
- tools/post-execute —— cc-safety-net（1576★）也在用。

静态证据：dsh-plugin-doctor 的 K10–K13 对本仓库的每项检查都报告 pass。

主题

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, json-repair, schema-validation, parameter-mapping, llm-api, tooling

贡献者

- @PerryLink —— 创建者与维护者：翻译表与修复管线移植、插件接口、测试，以及五语言文档。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下方名册默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件
| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | 🧊 已冻结 — 见仓库 README |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | 🧊 已冻结 — 见仓库 README |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache License 2.0 © 2026 dsh-translate contributors