PerryLink/dsh-translate

🔁 dsh-translate
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-translate（计入 deepseek1024.com 安装排名）。
Gitee

面向 DeepSeek Harness 的厂商参数翻译与确定性 JSON 修复。

同一请求，适配所有厂商。损坏的 JSON，无需编造数据即可修复。

官方仓库。 这是 dsh-translate 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库均无关联。

License
DSH plugin
dsh-doctor
Node
CI
Version
npm version
npm downloads

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

兼容性

| 层面 | 状态 |
|---|---|
| Harness | 主版本 dsh-v0.1.6-alpha.2（2026-09-18 验证：双类型检查标尺 + node --test 80/80 + 自包含/产物门禁）。npm dev/test 现已固定为 0.1.6-alpha.2；peer 为 >=0.1.2-rc.1 =0.1.5-alpha.1 =0.1.6-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 时（字符串为根或 json 为根的输出 schema，或按名称选择加入的工具），该层会确定性地修复它：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)

快速开始

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

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'

然后让 agent 检查映射或修复 payload：

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

安装与卸载

- git 渠道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-translate#main"——纯 JS，无需构建步骤。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-translate。
- tarball 渠道：在本仓库中执行 pnpm pack，然后 dsh plugin --profile web add ./dsh-translate-.tgz。
- 卸载：dsh plugin --profile web remove dsh-translate（或从 profile patch 中移除该行）。

配置

所有可调项都是 Schemastery Config 字段（可从 cordis.yml 更改）。针对 id 的覆盖会替换整行——请重新声明你需要的每个键。cordis.patch.yml 内联记录了每个键。

| 键 | 默认值 | 含义 |
|---|---|---|
| enabled | true | 总开关；false 则不注册任何内容 |
| repair.enabled | true | post-execute 修复层开关 |
| 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 结构相同）；覆盖内置映射表 |

在你的 profile patch 中覆盖的示例：

- 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，或   [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.0-rc.6–0.1.1-rc.2、0.1.2-rc.1）不获得审计追加——工具结果仍是模型可见的日志。
0.1.2-rc.1（适配于 2026-09-04）：会话信封保留其 ignorable 字段仅用于存储日志的读取兼容性——Session.append 仍无法为其加盖标记，因此审计门控行为保持不变。

安全边界

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

已知限制

- 受支持的 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.0-rc.6–0.1.1-rc.2 系列以及 0.1.2-rc.1，后者在读取时对未知事件类型会失败关闭——自适应门控会跳过审计追加，因此会话日志绝不会被污染；在这些主机上，日志内审计镜像会丢失，直到该事件类型被注册。

开发

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-plugin, deepseek-harness, deepseek, cordis, json-repair, schema-validation, parameter-mapping, llm-api, tooling

贡献者

- @PerryLink — 创建者与维护者：转换表和修复流水线移植、插件接口、测试以及五语言文档。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败关闭 | |
| dsh-background-agents | 持久化后台子代理，带 Web UI 侧边栏、消息传递和中断 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排和延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 相当于 Claude Code /rewind：快照、会话分叉、一次性恢复 | |
| dsh-claude-move | 将 Claude Code 会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——优先支持 Windows。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核对（此处使用的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置选项卡，显示状态、工具和错误 | |
| dsh-memento | 需审批的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 相当于 Claude Code outputStyles 的运行时样式切换 | |
| dsh-permission-rules | Claude Code 风格的声明式允许/拒绝/询问权限规则，带审计功能 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） |
| dsh-plugin-guide | 作为按需智能体技能提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与密封版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 |
| dsh-autotier | 自动进行强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，公开认证注册表：等级、快照和五维证据 | |
| dsh-kit | 一条命令安装核心系列的入门包 | |
| dsh-plugin-certification | 社区认证注册表，带可复现检查的等级和徽章 | |
| dsh-plugin-kit | PerryLink DSH 插件共享的零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为单个页面 | |
| dsh-plugin-upgrade-015 | 合并了 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加一个零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍需通过 Market 的 npm 身份验证及你的确认。

许可证

Apache License 2.0 © 2026 dsh-translate contributors