前言¶
在 DSH 里和模型长期协作时，「你说的 X 指什么」往往要在每个新会话里重新解释一遍。模型不会持久记住你们之间的称谓约定，仅靠对话记忆或每轮重复说明，成本高也容易不一致。
下面介绍社区插件 dsh-term-dict（维护者 taoziliyouchong）：把约定写成文本文件，某个词在会话里第一次出现时，把口径自动注入模型上下文；并提供查、写、体检工具与设置面板。在 DSH 社区目录中归类为「记忆」。
这是什么¶
dsh-term-dict 是 DeepSeek Harness 上的术语字典插件。核心思路是：不靠模型记忆，不靠每轮复述——词条写一次，存于 $DSH_HOME/evolve/dict/，会话中首次命中词条名或别称时，以 runtime-context 注入定义与默认指代等字段。
除人工维护词条外，插件可选「词条检测」：模型在对话中发现字典未收录的新称谓时，按模板写入本会话账本；同一候选在足够多个不同会话重复出现且已有定义或默认指代时，可自动转正进通用层（状态 待观察）。装了进化模式插件 plugin-evolution 时，整套检测会失效。
当前仓库版本为 0.2.0，许可证 MIT。
数据分层与词条格式¶
词条分两层，各对应一个 Markdown 文件：
| 层 | 文件 | 收什么 |
|---|---|---|
| 通用 | $DSH_HOME/evolve/dict/general.md |
跨任务类型都成立的称谓 |
| 任务 | $DSH_HOME/evolve/dict/domains/<任务slug>.md |
只在本类任务里成立的称谓；表头可写 > 任务类型：中文任务名、> 工作空间：<路径片段> 以绑定工作区 |
单条词条建议采用如下结构（除「定义」外字段均可选）：
## 词条名（别名：另一个叫法）
- 定义：一句话说清它是什么
- 默认指代：单独出现时默认优先指哪件事／哪份文件／哪条命令
- 边界：它不是什么
- 状态：已确认 / 部分确认 / 待观察 / 已废
- 备注：可选；撞名认哪条也写这里
类型由主字段推断：有定义＝称谓型；只写默认指代＝落点型；状态为已废＝留档型。手改文件时二级标题须为 ## 词条名；插件写操作前会留 .bak。卸载插件不会删除 evolve/dict/ 目录，需自行清理。
核心功能¶
四条工具¶
| 工具 | 用途 |
|---|---|
dict |
统一入口：lookup 查（不传 term 则列索引）／write 写／lint 体检／mute、unmute 管理当前会话是否灌注 |
dict-lookup |
只查：索引或词条全文，别名等同词条名 |
dict-write |
只写：增改词条；连续改同一词到第 3 次会拒写，需先问用户 |
dict-lint |
只体检：空定义、缺状态、同层重名、别称冲突等；查不到时给疑似同词候选，不当作错误 |
自动激活¶
同一会话内，词条名或别称第一次出现时注入该条口径；同一词条只注入一次，状态记在 $DSH_HOME/evolve/dict/.activation.json。用户消息里的词在本次模型调用前生效；模型输出中的词需到下一步或下一轮才生效。
灌注范围、单会话条数上限（默认 64）、总字数上限（默认 12000）等可在设置面板「高级设置」调整。未勾选「灌注的模式」时，新建模式默认不灌且可能看不到字典工具；可按工作空间路径子串、会话 id 配置不灌注名单。
词条检测（可选）¶
默认在面板「高级设置」开启。会话开始时注入判别机制与账本路径；模板见 $DSH_HOME/evolve/dict/auto/template.md。候选块须含 EVID: 与「结论：」（去空白后大于 10 字）。跨会话权重记在 auto/weights.json；到 3 个不同会话且已有定义或默认指代时转正进通用层。
设置面板¶
DSH 设置 →「术语字典」：左栏管理通用层与任务层；右栏「词条」「原文」视图编辑；设置页含自动激活、注入上限、检测开关、灌注模式、跳过工作空间等。「结构」页管理模块与类型组合。
面板后端在本机注册 25 条路由，前缀 /dsh-term-dict，仅接受回环地址；远程非本机访问面板可能 403。
安装与启用¶
要求 DSH >= 0.2.1-alpha.1（README 写明实测 0.2.1-alpha.3、0.2.2-rc.1）。使用非 desktop 的 profile 时，将命令中的 profile 名替换为你的配置名。
dsh plugin --profile desktop add github:taoziliyouchong/dsh-term-dict
装完后重启 DSH。插件以当前 DSH 进程权限运行，安装前建议在 GitHub 查看源码与 MIT 许可。
典型用法¶
1、查已有词条或列索引
通过 dict 或 dict-lookup，action=lookup；不传 term 即列索引。未收录时返回疑似同词，便于决定是否新建。
2、写入或修订词条
dict-write 或 dict 的 write 增改一条；面板「词条」视图也可就地改字段。任务层需在面板新建并可选绑定工作空间路径片段。
3、入库前体检
对某层文件跑 dict-lint，处理同层重名、别称冲突、跨层同名等问题。
4、本会话临时不灌注
工具 mute／unmute，或输入栏「词条·注／禁」按钮；状态纳入会话层配置。
5、首次运行
通用层不存在时会预置「词条」「词典」两条默认称谓型词条，已有字典不会被覆盖。
适用场景与注意¶
适合需要稳定称谓口径的智能体或桌面 DSH 用户：多仓库别名、项目内部黑话、默认落点（某路径／某命令）等。任务层适合按工作区或任务类型拆分词典。
使用时需注意 README 列出的限制：自动激活只做精确命中，不做形近联想；任务层未绑定工作空间时对所有工作空间生效；检测质量由模型按模板填写，插件只校验格式与路径；候选转正只进通用层且为 待观察，需人工确认；面板路由限制本机回环。
问题反馈可开 GitHub Issues，或按 README 说明通过 QQ 联系（请注明所装插件）。反馈时建议带上 DSH 版本、插件版本与报错原文。
结尾¶
dsh-term-dict 把「我们之间约定俗成的称谓」落到纯文本字典里，用自动灌注减少重复解释，用检测与权重辅助发现新词。社区目录与仓库相互印证，DSH 插件生态由社区维护，与 DeepSeek／幻方无官方从属关系。
- 目录页：https://www.skillhub.cn/plugins/taoziliyouchong/dsh-term-dict
- GitHub：https://github.com/taoziliyouchong/dsh-term-dict
