dsh-semantic-drift
在终端中运行以下命令:
dsh plugin install Yubickari/dsh-semantic-drift
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install Yubickari/dsh-semantic-drift,或在设置 → 插件 → 从源码安装中填写 https://github.com/Yubickari/dsh-semantic-drift 后安装并刷新页面。
插件介绍
大型项目里,业务概念叫什么往往散落在类型名、注释和资源字符串里,时间一长就会出现两套写法并存、同名不同类型、枚举值对不上等问题。团队靠口头约定或记忆很难维持一致,Agent 写代码时更容易引入新的拼写变体。Semantic Drift Vocabulary 把「项目里东西叫什么」收成一份随仓库版本化的 YAML 词表:每个概念有 id、人类可读术语、规范符号和说明,改名就是可审查的 diff。
插件用只读扫描把代码树和词表对照,报告重复定义、结构分叉、参数化副本误合并、规范符号的拼写变体,以及术语出现在注释或资源里却未在代码中使用等情况。即使词表还是空的,结构类检测也能在「冷启动」阶段发现同类问题。它不会改你的源码,也不强制 Agent 遵守规则;有意保留的差异可以写入词表里的例外,带上理由和尽量窄的作用域,并看到当前会静音多少条发现。
每个 Agent 会话还可注入当前工作区的概念与命名规则,并提供列出、查询、注册、扫描与裁定等工具,形成「先查词表再命名、缺概念先登记、改完再扫、有意偏离要留痕」的工作流。面板侧则提供概念树、发现详情、原始 YAML 编辑和按工作区关闭提示注入等能力。
适合希望把业务语义当作独立制品来维护的团队,以及在 DSH 里让人与 Agent 共同对齐命名、用可版本化的例外代替脑内记忆的项目。需要跨仓库统一视图或自动重构代码的场景,则不在本插件设计范围内。
使用场景
- 新建词表后先扫描,在注册概念前就发现重复类型或结构分叉
- 改代码后再次扫描,确认是否引入符号变体或与词表不一致
- Agent 写业务代码前先查概念并按规范符号命名,有意例外写入词表
适合人员
- 希望业务概念有独立、可版本化词表的开发团队
- 在 DSH 中让人与 Agent 共用同一套命名约定的项目
- 维护 C#、TypeScript 或 Python 声明并关心标识符一致性的仓库