DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-zh-yayan

d

dsh-zh-yayan

Manifest valid

Thought and word, both in Chinese. DSH opens in Chinese, all the way down — Chinese reasoning and thinking for the main agent, subagents, teams and background tasks. What it claims, you can verify.

hasBundlePatch

dsh-zh-yayan · 雅言

子所雅言,《诗》《书》、执礼,皆雅言也。——《论语·述而》

所思所言,皆成中文。DSH 起笔即中文,一线到底。


为什么需要它?我们自己的实测(不是竞品文案)

证据数值它推翻的假设
v2 首句英文率(n=16 probe)25.0%,Wilson 95% CI [10.2%, 49.5%]与 v1 的 28.2% 区间重叠 → v2 的「黑名单 + 尾锚」没把首句压下去
已见英文起手(4 种)Let me start by…、The user asks…、The user wants…、The task: …后两种 不在 v2 默认黑名单 → 枚举永远不完备
首句中文 ≠ 整段中文63,443 字符 / 21 段:首句中文但整段 CJK 0.222;406 字符 / 1 段:整段 CJK 0.910「首句中文 = 整段中文」是错的 → 必须把首句与整段拆成两个指标
工具调用越多约束越淡长任务里约束被稀释静态锚 + 固定文本会因「整包去重」只 append 一次

所以 v3 只做四件事:

  1. 判据换轨(最重要):第一句必须包含中文字符(U+4E00–U+9FFF),不得以 ASCII 字母开头。两条都能用正则直接判真假。
  2. 中文 few-shot:2 个极短正确示范(总长 41 字符),给模型可模仿的形状,不用英文示例。
  3. step 级变体:context 文本在 3 个变体间轮换(基础 / 「包括这一句」/「工具结果之后」),按 assembly(通常每 step 一次)轮换;整包 sections 每次不同 → 每步都会重新 append,约束不被稀释。config.contextVariant = false 可回到固定文本。
  4. 指标拆开:lang-audit 把「首句语言」与「整段 CJK 占比」分别输出,并按长任务(>10000 字符或 >10 段)分组。

为什么盯「第一句」?首句定生死的全量审计

对 ~/.dsh/sessions 下全部 280 个会话目录(264 个含 reasoning)做了全量审计,结论:

锚阶段会话数英文主导率首句英文率
无任何锚1275.0%58.3%
仅头部锚7339.7%39.7%
头部锚 + 尾部锚(v1)17913.4%21.2%
  • 首句是唯一强预测因子:首句英文 → 整段英文主导 81.1%(60/74);首句中文 → 整段英文主导 1.1%(2/190)。
  • v1 的 head+tail 已经吃掉大半收益(39.7% → 13.4%),再加长尾锚文本边际收益极低。
  • 剩余 24 个英文会话全部首句英文,且头尾锚齐全、尾锚 100% 可见、距 system 末尾仅 75 字符。真正原因是 system 之后还插着 15,621–16,704 字符 user 文本(AgentTeams 英文分派模板 + 三条 system-reminder,中位 15,919):尾锚在 system「内部」最后,却不在请求「整体」最后。
  • 子会话是重灾区:首句英文率 32.5%(68/209),主会话仅 10.9%。

完整审计报告与复现脚本见仓库发布的 LANG-AUDIT.md(由 tools/lang-audit.mjs 生成 JSON)。


支持哪些 agent?五通道设计(order 与早期版本一致,未新增通道)

#通道order位置作用默认文本长度
1section zh-yayan-900harness 身份段(-1000)之后、部署 persona(0)之前长版铁律:定性「全程中文、不得用英文思考」≈165 字符
2section zh-yayan:subagent-880紧跟头锚显式点名 subagent / AgentTeams 成员 / workflow 子智能体 / 后台任务≈53 字符
3section zh-yayan:mid5100工具 schema(TOOLS_SDK=5000)之后、结构化输出(9900)之前工具文档后再重申一次可判定首句判据≈106 字符
4section zh-yayan:tail90050全部宿主 section 之后尾部首句锚:第一句必须含中文字符、不得以 ASCII 字母开头 + 正确示范≈51 字符
5context zh-yayan:request-tail500宿主 context 上界(WEB_SURFACE=210)之后;每个 step 由宿主把 runtime-context 快照 append 在 claimed 消息之后per-request 通道:每请求重新渲染;模型看到的是宿主生成的 user 角色 <system-reminder> 快照,位于本 step 最后。v3 起文本按 assembly(通常每 step 一次)在 3 个变体间轮换73–137 字符(随变体)

文本预算变更:请求尾从 v2 的 ≤80 字符放宽到 ≤150 字符(v3 变体 1 实测 137 字符,多出的是可判定判据句与 few-shot);selftest.mjs 对每个变体断言 ≤150。其余通道预算不变(头 ≤250 / 子 ≤60 / mid ≤150 / 尾 ≤80)。

作用域说明:五个通道都是全局 section / context 注册,对所有 agent(主 agent、subagent、AgentTeams 成员、workflow 子智能体、后台任务)可见。子智能体锚里的「点名」是提示词层面的强化(让模型知道这条对子角色同样强制),不是作用域过滤——不存在「只对子 agent 生效」的分支。

order 是怎么算出来的(非猜测)

读宿主 @deepseek-ai/dsh-system-prompt 源码(dsh 0.2.2-rc.3,src/index.ts):

const SECTION_ORDERS = { HARNESS_IDENTITY: -1000, … , DELIVERABLE_FILE_REFERENCES: 9000,
  STRUCTURED_OUTPUT: 9900, HARNESS_SOURCE: 10000, WEB_SURFACE: 10100, DEPLOYMENT_PERSONA_SUFFIX: 10200 }
const CONTEXT_ORDERS = { WORKING_DIRECTORY: 100, SANDBOX_POLICY: 110, APPROVAL_POLICY: 115,
  SUBAGENT_DELEGATION: 120, HARNESS_SOURCE: 200, WEB_SURFACE: 210 }
  • 宿主 section 上界 = DEPLOYMENT_PERSONA_SUFFIX = 10200 → 尾锚默认 max(90050, 上界 + 1000),恒在最后;
  • 宿主 context 上界 = WEB_SURFACE = 210 → per-request 通道默认 max(500, 上界 + 100);
  • 运行时用 registry.getSectionOrder('DEPLOYMENT_PERSONA_SUFFIX') / registry.getContextOrder('WEB_SURFACE') 探测这两个上界(服务方法不存在或抛错则回退到上面常量)。因此 order 可解释、可覆盖、随宿主演进自适应——宿主未来把上界提到 20000,尾锚会自动排到 ≥21000。

per-request 通道为什么是 systemPrompt.context() 而不是塞 user 消息

宿主 @deepseek-ai/dsh-agent-loop 的每步流程是:preStep() → systemPrompt.assemble() → 把 runtime-context 快照追加在 claimed 消息之后([...claimed, context]),再 buildRequest()。该快照:

  • 每请求重新渲染(是真正的 per-request 面);
  • 物化形态是宿主生成的 user 角色消息:createUserMessage({ source: { kind: 'runtime-context', form: 'snapshot' } }),内容用 <system-reminder> 包裹。它不修改、不拼接真实用户消息内容,而是宿主自己的上下文快照通道;
  • 文本固定 → 宿主 RuntimeContextProjection.project() 用 deepEqualJson(previous, sections) 判重(去重单位是整包 sections):整包不变才跳过 append。若宿主自身的 runtime section 某步变化(时间、cwd 等),整包会重新 append,我方尾注会随整包一起重复出现一次——这是「不重复」成立的前提,写在这里以免误读;
  • 变化时 append 新快照,旧快照保留在 surface(agent.ts 里是 session.append('user/message', context, { surfaceOp: 'append' }),没有 replace;deriveMessages() 全量派生)。固定文本只在首次 append,不会每步重复;
  • 注册为 required: true:宿主 assemble() 的 suppress 过滤是 filter(entry => !runtimeContextSuppressed || entry.required === true)(dsh-system-prompt/src/index.ts),refreshContext() 同样对 required 放行,因此部署关闭可选 runtime context 时该条仍保留。

这是宿主官方机制,不伪造用户输入、不改写用户消息内容。


token 成本(1.0.0)

成本结构分两层,别混在一起算:

  1. system prompt 的四个 section(head / subagent / mid / tail)每次请求都要发,但文本固定 → 命中 prompt cache 后边际成本接近 0;只有首次或缓存失效时全价。
  2. per-request context(zh-yayan:request-tail)每次 append 在请求末尾,不在可复用前缀里 → 每次全价。这一层是真正需要控的。

估算口径:中文按 1 token/字(保守上界)、非中文按 4 字符≈1 token;区间给「中文 0.6–1 token/字」两端。estimateTokens() 导出同一口径,selftest 用它断言预算。

常量字符token 估算(区间)
HEAD_TEXT(full)15794–157(点估 115)
HEAD_TEXT_COMPACT(standard)5634–56(点估 47)
SUBAGENT_TEXT5533–55(点估 36)
MID_TEXT(full)10664–106(点估 61)
MID_TEXT_COMPACT(standard)3219–32(点估 25)
TAIL_TEXT5131–51(点估 39)
REQUEST_TEXT(full 变体 1)13782–137(点估 86)
REQUEST_TEXT_COMPACT(standard 变体 1)4628–46(点估 34)
FIRST_STEP_VARIANT(v1.1.0,仅 step0)11044–110(点估 65)

三档 preset

档注册通道每次请求字符(section + context)token 估算(区间)预算
minimaltail + context51 + 137 = 18877–112(点估 125)≤130
standardhead + subagent + mid + tail + context(紧凑文本,无 few-shot)56+55+32+51 + 46 = 240114–175(点估 181)≤300
full(默认)五通道(完整文本 + few-shot)157+55+106+51 + 137 = 506232–352(点估 337)≤400

minimal 仍保留可判定首句判据与 per-request 注入(不是靠删功能省 token);standard 的五通道与判据同样完整,只是把示例句与枚举提示压缩掉了。

v1.1.0 first-step:step 0 的 request-tail 会替换为 FIRST_STEP_VARIANT(110 字符 / 点估 65 token),只发生一次;三档预算按「最坏情况」(step0 用完整变体)计算,因此 first-step 不会突破 125/181/337。firstStepVariant: false 时完全回到 1.0.0。

与 off 的组合:contextVariant: off + first-step(默认)会在 step0 用 first-step、step1 起固定 base → 共 2 次 append(仍远低于 lazy 的约 7 次/20 step)。要严格「只 append 一次」的 v2 行为,需同时设 firstStepVariant: false。

变体策略与 20 step 成本

宿主对 runtime-context 快照的去重单位是整包 sections:文本不变 → 不重复 append;文本变 → 整包重发。所以「多久变一次」直接决定长任务成本:

contextVariant行为20 step 的 context append 次数20 step 增量(full,点估 86/次)append/step
off(= v2 行为)固定文本,只 append 一次1≈86 token0.05
lazy(默认)每 3 个 step 切换(第 1/4/7/10… 步)+ 工具结果后的下一个 step 整段用「工具结果之后」7(+每次工具结果 1 步)≈602 token实测 0.479(开发期 3.1.2 多步会话基线;部署后需复跑 measure-appends);20 step 模拟 0.35;开发期 3.1.0 实测 0.783(按调用计数被放大)
step每 step 切换 + 工具结果后的下一个 step 整段用变体 320≈1720 token1.00

三个数字的来源与差异:

  • 0.783(开发期 3.1.0 实测,long 组):按 provider 调用次数计数,宿主一 step 多次调用把 lazy 放大。
  • 0.35(20 step × 2 次调用的机制模拟):理想节奏下的下界。
  • 0.479(开发期 3.1.2 实测,多步会话;t37 数据 work/lang-rule-tests/out/V3.1.2-VERIFY.json#append.appendPerStepMultiStep):真实宿主的调用节奏(一 step 内多次 assembly + 工具结果触发的额外切换)——这是当前应引用的实测值。
  • 0.479 是开发期 3.1.2 的基线,不是 1.0.0 的定值:1.0.0 把「工具结果之后」变体扩到整个下一个 step(命中率 1/3 → 3/3),理论上会让 lazy 成本略微抬高;部署 1.0.0 后需复跑 node tools/measure-appends.mjs 更新本表。
  • 总体(含 1 步短会话)为 0.606;单条 1 步会话(03d5a353)为 0.5,样本过小不作结论。

为什么 lazy 曾经没兑现(开发期修复)

t24 批量实测(work/lang-rule-tests/out/request-appends.json)long 组 append/step = 0.783(13.1 step / 10.3 次 append),而不是设计的 0.33。原因:

宿主在一个 step 内可能多次调用 context provider —— preStep() 里的 systemPrompt.assemble()、step 内的 refreshContext()、以及失败重试,都会触发 provider。开发期 3.1.x 按「provider 调用次数」计数,于是「每 3 次调用切换」实际变成「每 1–2 个 step 就切换」,成本节省没有兑现。

开发期修复(已并入 1.0.0):

  1. 按 step 计数:优先监听宿主 session/event 的 step/start 精确推进 step;事件不可用(ctx.on 缺失、签名不符、或全局收不到 agent 事件)时,退回「同一 signal + 距上次调用 <1500ms 视为同一 step」的时间窗启发式。
  2. 工具结果后立即切换:tool/result 之后的下一个 step 强制使用「工具结果之后」变体,不等 3 步轮换。这直接覆盖 mid 场景(只读 1–2 个文件、2–3 段,工具结果紧贴采样点)。

实测/复现:

node tools/measure-appends.mjs                 # 读最近会话:step 数、append 次数、append/step
node tools/measure-appends.mjs --session 03d5a353
node tools/measure-appends.mjs --dry-run       # 不读会话,只跑 20 step × 2 次调用的机制模拟
# 结果落盘 out/appends.json,含 observed / simulated / theory 三段

路径约定:本脚本默认输出 work/dsh-zh-yayan/out/appends.json;harness 侧的批量数据在 work/lang-rule-tests/out/request-appends.json(开发期 3.1.0 旧口径,由测试架构师产出)。两者可用 --out <path> 对齐,内容字段一致。

--dry-run 模拟(20 step × 2 次 provider 调用):off 1 次 / 0.05、lazy 7 次 / 0.35、step 20 次 / 1.00;修复前 t24 实测 long 组为 0.783。修复后 lazy 的理论值为 0.33–0.5(工具结果越密越高),显著低于修复前的 0.783。注意 0.35 是模拟值,真实值以部署后新会话的 measured 输出为准。

选型建议:

  • 只要「首句中文」的最低成本:preset: minimal(tail + context,点估 125 token/请求)。
  • 默认推荐:preset: standard + contextVariant: lazy(点估 181 token/请求,五通道齐全)。
  • 约束最强、不在乎成本:preset: full + contextVariant: step(点估 337 token/请求,每步重发)。
  • 完全对齐 v2 成本:contextVariant: off。

配置

全部为可选键,默认值即推荐值。v1 的 text / order / sectionName / tailText / tailOrder / tailSectionName / tailEnabled 继续有效。

键默认说明
enabledtruefalse 时不注册任何通道(基线对照)
preset'full'1.0.0:minimal(tail + context,点估 125 token)/ standard(五通道紧凑文本,点估 181)/ full(完整文本 + few-shot,点估 337)。见 token 成本
headEnabledtrue头锚开关
headText内置铁律头锚正文(别名 text,v1 兼容)
headOrder-900头锚 order(别名 order,v1 兼容)
sectionNamezh-yayan头锚 section 名
subagentEnabledtrue子智能体锚开关
subagentText内置子智能体锚正文
subagentOrder-880子智能体锚 order
subagentSectionNamezh-yayan:subagent子智能体锚 section 名
midEnabledtrue工具文档后重申开关
midText / midOrder / midSectionName内置 / 5100 / zh-yayan:midmid 锚
tailEnabledtrue尾部首句锚开关
tailText候选 A 版尾部锚正文(v1 兼容)
tailOrdermax(90050, 宿主上界+1000)尾部锚 order(v1 兼容)
tailSectionNamezh-yayan:tail尾部锚 section 名(v1 兼容)
requestTail'context'per-request 通道:'context' 启用;'off' 或 false 完全回到 v1 纯 section 行为(回归对比用)
requestEnabledtrue与 requestTail 等价的布尔开关
requestText内置per-request 约束正文(显式设置后覆盖变体,回到固定文本)
contextVariant'lazy'1.0.0:'off'(固定文本,只 append 一次,等同 v2 成本)/ 'lazy'(默认,每 3 个 step 切换,约 1/3 成本)/ 'step'(每 step 切换)。两者都接「工具结果后立即切换」。旧布尔兼容:false→off、true→step
firstStepVarianttruev1.1.0:step 0(首次 assembly)的 request-tail 改用 first-step 专用文本(要求第一句先写中文动作,禁 The user wants/Need/I should/Let me 起手);false 完全回到 1.0.0 行为(A/B 与回滚)。只在 step0 注入一次,不增加长任务 per-step 开销
firstStepText内置覆盖 first-step 文本(≤180 字符)
requestOrdermax(500, 宿主 context 上界+100)per-request context order
requestSectionNamezh-yayan:request-tailper-request context 名

示例(profile 的 cordis 配置):

- id: dsh-zh-yayan
  name: dsh-zh-yayan
  config:
    preset: standard          # minimal | standard | full(默认 full)
    requestTail: context      # off / false = 回到 v1 行为
    contextVariant: lazy      # off | lazy | step(默认 lazy)
    tailOrder: 90050

首句判据与锚文本(v3)

主判据(可判定):本步 reasoning 第一句必须包含中文字符(U+4E00–U+9FFF),不得以 ASCII 字母开头。

辅助提示(黑名单):Let me / Let's / I'll / We need to / The user wants / The task: 都不算中文首句。 标注为「枚举永远不完备」——实测 The user wants… 与 The task: … 就不在 v2 默认黑名单里,所以黑名单不得作为唯一判据。

few-shot(2 条,总长 41 字符):

正确示范:「先确认工作区结构,再改代码。」
正确示范:「这一步先读文件,再下判断。」

index.js 导出 TAIL_CANDIDATES(A/B/C)与 REQUEST_VARIANTS(3 版)。默认尾锚 = A 版:

【本步语言要求】第一句必须包含中文字符,不得以 ASCII 字母开头。正确示范:「先读文件,再判断。」

harness 判定口径(与 tools/lib/lang-metrics.mjs 同一实现):去掉行首 Markdown 定界符与空白 → 取首个句末标点前内容(中文标点后无需空格)→ CJK ≥ 1 且 CJK > 拉丁字母 × 0.5,且不以英文祈使句开头 → 判为中文首句。注意不要用「第一个字符」:reasoning 首字符经常是 **、反引号或空格,按字符判定会假阴性。

selftest.mjs 断言:默认 A 版、三版都存在且含可判定判据、few-shot 存在且总长 ≤60、三种变体轮换、contextVariant=false 回退、首句/整段两指标分别计算。


降级与抗升级

情况行为
ctx.systemPrompt 缺失 / section() 不是函数直接返回,不抛异常,不阻断 dsh 启动
某条 section() 抛错(同名被占用等)只跳过该条,继续注册其余通道;logger.debug 记录,不打扰用户
systemPrompt.context() 不存在(旧宿主)degraded:只保留 4 个 section,logger.debug 标注 context-api-unavailable
logger 缺失或 logger.info/debug 抛错吞掉,注册照常
部署调用 suppressRuntimeContext()per-request 通道注册为 required:true,仍生效
宿主 order 上界变化运行时探测 getSectionOrder / getContextOrder 自动适配

注册成功时 logger.info 打印形如:

[zh-yayan] v3 已注册语言约束 { channels: ['section:zh-yayan@-900', …, 'context:zh-yayan:request-tail@500'], requestTail: 'context', contextVariant: true, degraded: false }

degraded 模式(旧宿主无 context API)

先说实测结论:desktop 上 v2 的 per-request 通道是生效的,不是降级状态。 以 03d5a353 会话为样例(2026-11-19,桌面应用 + 开发期快照),宿主把本插件的 zh-yayan:request-tail 渲染进一条 user 角色的 <system-reminder> 快照,正文逐字为 【本步语言要求】第一句必须是简体中文;禁止以 Let me / Let's / I'll / We need to 开头;英文任务提示不豁免。,requestContextInUserMessage: true。事件形状是 event.type='user/message'、event.data.source.kind='runtime-context'、event.data.source.sections[] 里含 name='zh-yayan:request-tail'(event.data 的 key 是 content/source/role/id,没有 message 字段)。

之前「desktop 降级、无 request-tail」的记录是 verify-installed 检测脚本的假阴性:旧版只读 event.data.message.source.kind,把没有 message 包装的真实形态整个漏掉。现已修正为兼容两种形状,并接受「正文含判据词」作为兜底证据。

因此 degraded 只在下面两种情况下发生,且必须能被 verify-installed 复现:

按 captain 裁决,「agent 侧下一 step 注入」不作为 v2 交付项(全局作用域拿不到 agent 实例、导入内部模块违反抗升级、user 消息绕开会破坏消息序列与 transcript)。因此旧宿主上的降级上限就是「仅 section 锚」,判定标准写死如下:

  • 触发条件:typeof ctx.systemPrompt.context !== 'function'(宿主 @deepseek-ai/dsh-system-prompt 早于引入 context() 的版本),或部署显式设置 requestTail: 'off' | false / requestEnabled: false。
  • 表现:只剩 4 个 section(头锚 -900、子智能体锚 -880、mid 5100、尾部锚 90050),没有 per-request runtime-context 尾注;logger.debug 记录 [zh-yayan] 宿主无 systemPrompt.context(),per-request 通道降级 { name: 'zh-yayan:request-tail' } 与 skipped: [{ kind: 'context', reason: 'context-api-unavailable' }];不抛错、不阻断 dsh 启动。
  • 如何自查:node tools/verify-installed.mjs --strict(可加 --session=<会话 id 片段> 定向复算),看 per-request 约束出现在会话里 一项:
    • PASS = 已找到证据;详情会写 via=user-system-reminder channel=runtime-context 命中 section=zh-yayan:request-tail(或 marker=…), 说明注入形态是宿主生成的 user system-reminder 快照,不是普通用户输入;
    • WARN = 最近扫描窗口内还没有 v2 安装后的新会话(不误判);
    • FAIL = v2 已装进 profile,且安装后已产生新会话,但 0 条 context 证据 → 插件处于 degraded 或未生效,检查宿主版本与 requestTail 配置。
    • 若用 --plugin 指向未安装的工作副本,不做 FAIL 判定(避免误报),detail 会说明「当前检查的是未安装副本」。
    • 证据检测兼容两种事件形状:event.data.source(真实 runtime-context 快照)与 event.data.message.source(旧形状);命中 zh-yayan:request-tail section 名或正文判据词任一即计入。

工具

# 注册契约自检(假 ctx,53 项断言,退出码 0 = 全过;含工具结果跨 step 用例)
node tools/selftest.mjs

# node:test 最小单测:per-request 去重 + requestTail=off 回退 + v3 变体 provider
node --test tools/selftest.test.mjs

# 安装验证(只读):profile 注册 / 包完整 / system 锚 / runtime-context 证据
node tools/verify-installed.mjs            # --json / --strict / --profile web / --plugin <目录> / --session <会话id片段>
# 注:从仓库根执行;--plugin 支持相对或绝对路径(相对 cwd 找不到时会回退按插件根解析)

# 语料复测(只读):逐段首句语言、首个英文段、按锚阶段分层、首句/整段两指标、长任务分组
node tools/lang-audit.mjs --json
node tools/lang-audit.mjs --limit 200 --verbose

# 成本测量(只读):append/step 与三档模拟
node tools/measure-appends.mjs --dry-run
# 工具结果变体命中率:机制模拟 / 旧实现实测 / 真实 step 序列重放
node tools/measure-tool-variant.mjs --simulate
# ⚠️ 复现 2a6b3aee 必须指向隔离 DSH_HOME(默认 ~/.dsh/sessions 里没有该会话,会「未找到」)
node tools/measure-tool-variant.mjs --replay \
  --sessions-root work/lang-rule-tests/.runtime/dsh-home/sessions \
  --session 2a6b3aee
# 也可用 DSH_SESSIONS_ROOT 指定同一路径;--simulate 不需要会话,可在任意目录跑

测试钩子 settings.now:apply(ctx, { now: () => clock }) 可注入假时钟,selftest/harness 用它构造确定性的跨 step 序列(否则时间窗启发式只能依赖真实时钟,无法断言「同 step 多次调用不切换」)。 生产部署不要设置它(默认 Date.now())。若 harness 读不到该钩子,static 层只能把时间窗行为记为不可确定性验证(开发期快照的 1 WARN 即来自这里)——插件本身不受影响,仅测试可断言性下降。

lang-audit --json 的 summary 里 v3 新增两项:

  • firstSentenceVsBody:firstZhBodyEn(首句中文但整段英文主导)/ firstEnBodyZh —— 直接暴露「首句中文 ≠ 整段中文」;
  • longTasks:按 >10000 字符 或 >10 段 分 long / short 两组,各自给首句英文率、整段英文主导率、CJK 中位数。

verify-installed.mjs 输出 PASS / WARN / FAIL:FAIL 退出码 1;WARN 表示「已安装版本低于 v2,或还没有 v2+ 新会话可供取证」。


与 58fly/dsh-language-guard 的差异

竞品里综合评分最高的 58fly/dsh-language-guard(40/45)用的是「工具文档之后重申一段约 146 字符约束(order 5100)+ 周期性提醒」,其 README 自认 Subagents are skipped(子会话只继承系统提示、周期提醒不覆盖)。v3 与之的差异:

维度58flydsh-zh-yayan v3
约束口径「用中文」可判定首句:第一句必须含中文字符、不得以 ASCII 字母开头(黑名单只作辅助)
子会话覆盖跳过 subagent子智能体强化锚 + per-request context 对全部 agent 作用域生效
位置mid 段mid 段 + 尾部锚 + per-request context(每请求重新渲染,落在 claimed 之后)
长任务稀释静态重复step 级变体:context 文本轮换,整包去重不会跳过,每步重新 append
可量化无判据lang-audit --json 按锚阶段分层 + 首句/整段拆分 + 长任务分组

mid 段的 order 5100 借鉴了它的实测结论(工具 schema 5000 之后仍有约束力);我们没有照抄任何「英文 CoT + 中文输出」的实现。

安装

从 GitHub 安装(推荐):

dsh plugin --profile <your-profile> add github:ArthurZhu1992/dsh-zh-yayan

<your-profile> 换成你的 profile 名,例如 desktop(桌面端默认)或 web。安装后重启 DSH。

从本地副本安装(等价,便于调试):

git clone https://github.com/ArthurZhu1992/dsh-zh-yayan
dsh plugin --profile <your-profile> add file:/absolute/path/to/dsh-zh-yayan

或用插件管理器:plugin_manager { action: "install_bundle", target: "dsh-zh-yayan" }。

卸载:

dsh plugin --profile <your-profile> remove dsh-zh-yayan

从 dsh-lang-rule 迁移

运行时标识已一并改名(插件名与五个 section 名都从 lang-rule* 改为 zh-yayan*),旧包不能与新包同时加载——同时加载会出现两套锚(旧 lang-rule* 与新 zh-yayan* 各注册一遍,日志里能看到两组 section)。

三步迁移:

# 1) 卸载旧包
dsh plugin --profile <your-profile> remove dsh-lang-rule

# 2) 安装新包
dsh plugin --profile <your-profile> add github:ArthurZhu1992/dsh-zh-yayan

# 3) 重载 profile 或重启 DSH,然后确认只剩新名
#    持有仓库源码副本时(在仓库根执行):
node tools/verify-installed.mjs --strict   # 期望 PASS,详情出现 zh-yayan:request-tail
#    普通安装用户没有源码,改用插件管理器确认,或新开会话观察 system 提示只含 zh-yayan* 段:
dsh plugin --profile <your-profile> why dsh-zh-yayan

旧配置里若显式写过 sectionName / tailSectionName / subagentSectionName / midSectionName / requestSectionName 的旧值(lang-rule*),请改成 zh-yayan*,否则会按旧名注册。


已知限制

  • 黑名单永远不完备:Let me / Let's / I'll / We need to / The user wants / The task: 之外仍可能出现新的英文起手(v3 已把黑名单降级为辅助提示,主判据是「第一句必须含中文字符、不得以 ASCII 字母开头」)。新增起手形态应先进 ENGLISH_OPENER_HINTS 的候选观察,而不是当成唯一防线。
  • 首句中文 ≠ 整段中文:实测 63,443 字符 / 21 段的任务首句中文但整段 CJK 0.222;v3 用 step 级变体缓解稀释,但不保证整段中文占比达 90%+。
  • step 变体的成本:v3 请求尾文本 ≤150 字符(较 v2 的 ≤80 增加,多出的是可判定判据句与 few-shot)。lazy/step 都会按 step 重发短快照(73–137 字符);lazy 约每 3 step 一次(模拟 0.35 append/step),step 每步一次(1.00)。长任务多步时累计有 token 成本,需要省 token 可设 contextVariant: off 回到固定文本。
  • lazy 的 step 计数依赖事件或时间窗:优先用宿主 session/event 的 step/start;若事件不可用(ctx.on 缺失或全局收不到 agent 事件),退回「同一 signal + 间隔 <1500ms 视为同一 step」。若宿主某 step 内的多次 provider 调用间隔超过 1500ms 且事件不可用,step 会被多计、lazy 会偏密;用 tools/measure-appends.mjs 复测即可发现。
  • 成本表里的 0.35 是模拟值:来自 measure-appends --dry-run 的 20 step × 2 次调用模拟;真实样本当前仅 03d5a353 一条(append/step 0.5,v2 固定文本期)。1.0.0 部署后需用新会话批量复测(node tools/measure-appends.mjs,非 dry-run),复测后更新成本表。
  • per-request 通道依赖宿主把 runtime context 快照 append 在 claimed 消息之后(dsh 0.2.2-rc.3 行为)。宿主若改动该投影顺序,约束的「最靠后」性质会退化;用 tools/verify-installed.mjs、tools/lang-audit.mjs 复测 head+tail+request 层即可发现。
  • AgentTeams 英文分派模板本身不在本插件范围内(不能改 AgentTeams),插件只能在提示词侧抵消。
  • 插件不保证 100% 中文:它把「首句英文率」和「整段英文主导率」压到尽可能低,量化验收由外部 harness 用 lang-audit --json 的 summary.byAnchorLayer / summary.longTasks 完成。

证据文件

  • docs/DESIGN.md — 设计决策、order 推导、宿主源码定位、v3 判据换轨理由、审计数据来源
  • tools/*.mjs、tools/lib/*.mjs — 自检 / 单测 / 安装验证 / 语料复测 / 指标与证据检测纯函数

Keywords / 关键词

中文思考 · 中文推理 · 思维链中文 · 简体中文 · 汉语 · 中文输出 · 英文思考修复 · 语言策略 · 子智能体中文 · 多智能体中文 · 团队中文 · 提示词中文约束

reasoning in Chinese · thinking in Chinese · chain-of-thought in Chinese · Simplified Chinese · Mandarin · language policy · output language · system prompt · subagent · multi-agent · agent team · DeepSeek Harness · DSH plugin · Cordis

Comments

Loading…

Similar plugins

dsh-thinking-language

by ChendarCe

Make the agent think in Chinese, with a settings switch and a fully overriding custom prompt.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-thinking-language

by aymidasing

DSH plugin: set the agent's reasoning language (Settings → General)

Development & InfrastructureSessions & MessagesManifest valid

★ 1

MIT

TypeScript

Oct 8, 2026

dsh plugin --profile web add dsh-thinking-lang

by wodongx123

DSH plugin: force agent chain-of-thought to stay in Chinese — 让 Agent 的思考过程也自动使用中文

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Aug 28, 2026

dsh plugin --profile web add @deepseek-ai/dsh-language-control

by lance808

DeepSeek Harness plugin: make the agent reason (think) in Chinese by contributing a system-prompt section

Manifest valid

★ 0

MIT

JavaScript

Oct 9, 2026

dsh plugin --profile web add dsh-think-zh

by qingying012

DeepSeek Harness plugin: tell every agent to reason in Simplified Chinese.

Manifest valid

★ 0

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-chinese-thinking

by Max-Null

One-line fix: inject a fixed system-prompt section so the agent always thinks and replies in Chinese, whatever the user's language · 中文思考:注入固定提示词,让 agent 始终用中文思考与回复(无论用户语言)

Sessions & MessagesManifest valid

★ 14

↓ 704/wk

MIT

TypeScript

Oct 20, 2026

dsh plugin --profile web add @max-null/dsh-chinese-thinking