概览

dsh-ambiguity-handling

Append ambiguity-handling rules to dsh system prompt

README / ZH

插件文档

dsh-ambiguity-handling

DeepSeek Harness（dsh）插件：当用户请求存在歧义、范围不清或可能有多种理解时，向 system prompt 追加「歧义处理规则」，引导模型先澄清用户意图，而不是臆测或假设。

功能

以独立 section 形式向 system prompt 注入歧义处理规则，不覆盖已有的 system prompt 内容。
注入的 section 名称为 ambiguity-handling，order 为 50，用于控制它与其他 system prompt section 的相对顺序。
规则要求模型：明确指认歧义、列出 2–4 种中文理解、提供「其他」补充选项，并请用户确认后再继续。

注入的规则内容

插件会在 system prompt 末尾追加以下文本：

# 歧义处理规则

当用户请求存在歧义、范围不清或可能有多重理解时，你必须：

1. 明确指出请求存在歧义，不要臆测、不要假设。
2. 列出 2-4 种最可能的中文理解。
3. 额外提供一个"其他"选项，让用户自行补充。
4. 请用户选择其中一项或补充说明。

输出格式示例：

"您的请求存在多种理解，请选择最符合您意图的一项：
A. ...
B. ...
C. ...
D. 其他（请补充说明）"

目录结构

dsh-ambiguity-handling/
├── index.ts           # 插件源码：导出 name / inject / apply，向 systemPrompt 注入 section
├── index.js           # 预构建 JS 入口（package.json 的 main 指向这里）
├── package.json       # 插件元信息 + dsh.bundle 组合包 manifest
├── cordis.patch.yml   # 组合包 patch 层（按包名引用本插件）
├── README.md          # 中文说明文档
├── README.en.md       # 英文说明文档
├── PUBLISHING.md      # 发布与上架指南
└── LICENSE            # MIT 许可

安装

方式一：组合包安装（发布到 npm / GitHub 后推荐）

dsh 读取本包的 dsh.bundle 声明后会自动激活 cordis.patch.yml 层，不需要手动编辑 profile 的 patch：

# npm 发布后
dsh plugin --profile web add dsh-ambiguity-handling

# GitHub 仓库
dsh plugin --profile web add github:changlianxiya-139/dsh-ambiguity-handling

# 本地 tarball
dsh plugin --profile web add ./dsh-ambiguity-handling-1.0.0.tgz

headless profile 需要时同样执行，并把 web 换成 headless。发布与上架步骤见 PUBLISHING.md。

方式二：本地 file: 部署（本机当前方式）

插件目录位于：

/home/aa/.dsh/plugins/dsh-ambiguity-handling

配置（本地 file: 部署）

dsh 会按 profile 加载 cordis.patch.yml。本地部署时，插件需要注册到实际使用的 profile 中。

web profile

~/.dsh/profiles/web/cordis.patch.yml 的 - insert: 列表中加入：

- id: dsh-ambiguity-handling
  name: 'file:/home/aa/.dsh/plugins/dsh-ambiguity-handling'

完整示例：

# Web profile 用户 patch 层
- insert:
    - id: tool-cordis
      name: '@deepseek-ai/dsh-tool-cordis'
    - id: dsh-ambiguity-handling
      name: 'file:/home/aa/.dsh/plugins/dsh-ambiguity-handling'

headless profile

~/.dsh/profiles/headless/cordis.patch.yml 内容为：

- insert:
    - id: dsh-ambiguity-handling
      name: 'file:/home/aa/.dsh/plugins/dsh-ambiguity-handling'

工作原理

插件通过 export const inject = ['systemPrompt'] 声明依赖 dsh 的 systemPrompt 注入点。
dsh 加载插件时调用 apply(ctx)。
ctx.systemPrompt.section({ ... }) 将规则注册为一个有序 section：

ctx.systemPrompt.section({
  name: 'ambiguity-handling',
  order: 50,
  text: ambiguityRule,
})

name：section 唯一标识，避免重复注入时产生冲突。
order：section 顺序，数值越小越靠前（具体表现以 dsh 最终拼接实现为准）。
text：追加到 system prompt 的实际文本。

生效与验证

修改 patch 配置或插件代码后，必须 重启 dsh（对应的 web / headless profile）才会重新加载插件。
重启后新建会话，确认 system prompt 中已包含「歧义处理规则」段落和 ambiguity-handling section。
验证方法：对模型发送一个有歧义的请求（如「帮我写一下」），观察模型是否按规则列出 A/B/C/D 选项请求澄清。

修改规则

源码在 index.ts 的 ambiguityRule 模板字符串中。
修改后请同步更新预构建入口 index.js（重新转译或手动同步），否则发布包仍使用旧规则。
重启 dsh 生效。

停用插件

组合包安装：dsh plugin --profile <name> remove dsh-ambiguity-handling
本地 file: 部署：从对应 profile 的 cordis.patch.yml 删除该插件的 - id: dsh-ambiguity-handling 条目

之后重启 dsh 即可。

发布与上架

发布到 npm、GitHub 或社区插件市场（dsh-market / DSH Hub / dsh.pub 等）的完整清单见 PUBLISHING.md。

许可

MIT，详见 LICENSE。

dsh-ambiguity-handling