DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

dsh-plugins /

dsh-plugins/dsh-markdown-translation

Verified

保护 DeepSeek Harness 思考翻译的 Markdown 格式,支持流式翻译及 dsh-auxiliary 模型选择;通过 dsh plugin add @dsh-plugin/dsh-markdown-translation 安装。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@979c4cbf
思考翻译格式增强

DSH Markdown Translation

保护思考翻译的 Markdown 格式,按稳定短句增量显示译文。

本地版本 0.1.0 · DSH 0.2.2 · dsh-loader 2.0

@dsh-plugin/dsh-markdown-translation 增强官方思考翻译,保留行内代码、链接、公式及 Markdown 结构,并沿用官方语言设置和 dsh-auxiliary 的模型选择。

官方思考区中的增量译文

功能

功能 行为
格式保护 保留代码、公式、HTML、图片、链接地址、引用定义;翻译正文及链接文字。
结构重建 本地保留标题、列表、引用、表格、换行、转义及嵌套强调。
流式翻译 思考生成期间串行翻译稳定短句,合并可发送片段;尚未闭合的语法显示原文。
格式校验 校验标记身份、数量、配对、嵌套关系,以及片段拼接后的 Markdown 结构。
失败处理 格式失败默认自动重试一次,再次失败保留对应片段原文;界面提供手动重试。网络错误直接保留原文。
模型兼容 调用官方翻译回调,兼容 Bing、Google、官方模型及辅助模型路由。
生命周期 原文改写、语言或模型切换时取消旧任务;关闭插件恢复官方组件。

安装

本地安装包为 dsh-plugin-dsh-markdown-translation-0.1.0.tgz。在目标 DSH 0.2.2 安装环境的终端中,先启用官方思考翻译并安装 loader,再从安装包所在目录执行:

dsh plugin --profile web add "@dsh-plugin/dsh-loader@2.0.0-dev.43799314028"
dsh plugin --profile web add "@deepseek-ai/dsh-experimental-cot-translation-bundle@0.2.2-rc.3"
dsh plugin --profile web add "./dsh-plugin-dsh-markdown-translation-0.1.0.tgz"

上述官方包版本对应主要验收环境 0.2.2-rc.3;使用其他 0.2.2 预览版本时,官方包版本须与宿主一致。将 web 换成目标 profile。桌面启动器也可在对应环境的插件管理中选择本地 .tgz 文件。

打开对话中的思考区即可看到译文,点击“查看原文”切换。官方翻译未启用时,增强组件等待官方条目注册。

语言和翻译服务仍在官方翻译插件中设置。使用 dsh-auxiliary 时,在辅助插件中启用翻译模型选择,并将官方翻译服务设为 deepseek-official。辅助插件未启用时,官方模型照常工作。

本插件仅新增一个设置:格式校验失败自动重试一次,默认开启。重试可能增加一次翻译调用。

实现与行为边界

插件通过 dsh-loader 的公开插槽接口接入 conversation.chat.reasoning.body,复用官方注入的翻译回调、偏好与 UTF-16 长度限制。正文继续由官方 conversation.chat.reasoning.content 工厂渲染。增强组件覆盖官方组件期间,官方组件的翻译调度器不会挂载。

Markdown 解析使用 mdast-util-from-markdown、GFM 与数学扩展。源码区间及受保护内容保存在本地;发给翻译服务的句子带有唯一标记。允许同级完整单元调整顺序,改变祖先关系、遗漏或复制标记的结果会被拒绝。单片段恢复后还会校验其所在完整块,生成结束复核全文,避免相邻片段的代码符号连成新的结构。

“流式”表示原始思考生成期间按稳定短句增量提交和显示;每个短句在官方回调返回后显示。未闭合结构、完整代码块、HTML 范围和公式保持原文。超长句优先在词边界切分,必要时使用字素边界,保留跨片段格式上下文。无法在宿主上限内安全提交的片段保留原文。

官方会话缓存继续生效;本地仅缓存通过格式校验的译文。请求标记包含规则版本、原文及路由指纹、尝试序号,使格式重试避开失败结果。不同语言和辅助模型路由隔离缓存,取消后忽略迟到结果。

开发与验证

需要 Node.js 24.9 或更新版本。

npm ci
npm run typecheck
npm test
node scripts/verify-providers.mjs
node scripts/verify-runtime.mjs "<已安装 DSH 的 package.json 绝对路径>"
npm pack
node scripts/verify-package.mjs "<已安装 DSH 的 package.json 绝对路径>"

verify-providers.mjs 向 Bing 和 Google 发送固定示例文本。verify-runtime.mjs 在 .cache/ 创建独立 DSH_HOME,启动真实宿主和无头 Chrome/Edge,通过本机测试模型验证调用链、增量显示、辅助模型切换、折叠、刷新与插件启停。它读取相邻的 dsh-auxiliary 项目构建产物;可通过 DSH_TEST_BROWSER 指定 Chromium 可执行文件,通过 DSH_TEST_PLUGIN 指定已经安装的插件目录。

verify-package.mjs 使用真实 DSH CLI 将 loader 与本地安装包加入全新 profile,并验证安装登记和入口。setup-matrix.mjs 接收明确版本号,例如 node scripts/setup-matrix.mjs 0.2.2-rc.1 0.2.2-rc.2,为各版本建立相互独立的依赖目录;需要本机可用的 pnpm。

验证记录见 docs/verification.md。源码采用 MIT 许可证,客户端打包依赖的许可证见 THIRD_PARTY_NOTICES.txt。

真实宿主验收通过 0.2.2-alpha.3、rc.1、rc.2 和 rc.3。alpha.2 的原生会话创建错误阻断了验收,主要使用环境为 0.2.2-rc.3。

CI 与 npm 发布

npm-publish.yml 使用 Node.js 24,在 ubuntu-latest、windows-latest、macos-latest 上依次执行 npm ci、类型检查、宿主与客户端构建、解析及调度测试和 npm pack --dry-run。三个系统使用各自的依赖缓存,最终发布同一个 JavaScript npm 包。

质量检查通过后调用组织共享的 dsh-npm-publish 工作流。推送 main 发布 X.Y.Z-dev.<run-id> 到 next;推送与 package.json 版本严格一致的 vX.Y.Z 标签发布到 latest。正式版发布后,共享流程将 npm-latest.json 和下一补丁版本回写到 main,同时更新 npm 锁文件。PR 和手动运行只执行质量检查。

发布鉴权支持 npm 可信发布者(OIDC)及可选的 NPM_TOKEN 仓库 Secret。按照 npm 可信发布文档 配置时,调用方组织为 dsh-plugins,仓库为 dsh-markdown-translation,工作流文件名为 npm-publish.yml,并允许直接执行 npm publish。首次发布前需要准备可用的 npm 发布授权;工作流文件本身不会创建 npm 授权。

真实翻译服务和 DSH 浏览器验收继续使用前述独立脚本,需要本机服务、浏览器及相邻辅助插件源码;常规 CI 运行无需这些条件的解析和调度测试。

—/ 5

No ratings yet

Verified DSH bundle

Commit 979c4cbf700b

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout