前言¶
在 DSH 里写技能说明、插件 README 或内部文档时，同一品牌或产品名经常出现中英文混写、简称与全称并存。人工通读成本高，也容易在发布前漏掉不一致。DeepSeek Harness 支持通过插件扩展工作流；@deepwhale-cn/dsh-terms-glossary（仓库 feely0208/dsh-terms-glossary）面向这类问题：扫描指定目录下的文本类文档，按文件统计你关心的多种写法各出现多少次，便于发现混用。插件只提示、不修改文件。
这是什么¶
深鲸术语统一 是 DSH 工作流类插件，npm 包名为 @deepwhale-cn/dsh-terms-glossary（当前资料中版本为 0.1.0，MIT 许可证）。维护者与源码托管在 GitHub 用户 feely0208；作者在 package 中标注为温州深鲸智能科技有限公司。社区目录页：skillhub.cn 插件页。该目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
一句话定位：给定一组术语别名（如 深鲸 与 DeepWhale），在 .md / .txt 中计数并汇总，帮助统一用语。
核心功能¶
根据 README 与 package 描述，已核实能力如下：
- 多写法扫描：通过
--terms传入逗号分隔的多种写法，在同一概念下对比出现次数。 - 按文件汇总：结果按文件列出各写法的出现次数，便于定位需要统一的文档。
- 格式范围：仅处理
.md与.txt，不覆盖其他后缀。 - 只读行为：扫描与提示，不自动改写磁盘上的文件。
- Web 侧栏：安装并启用 Web profile 后，可在侧栏使用「深鲸术语统一」面板（与 CLI 同属该插件能力）。
运行环境要求（来自 package.json）：Node.js >= 18；DSH 引擎 >=0.1.0-rc.6 且 <0.3.0。插件依赖 @deepwhale-cn/dsh-guard-core，并以 Web 客户端方式注入（platform: web）。
安装与启用¶
在已安装 DSH 且使用 web profile 的前提下，安装命令以 README 原文为准：
dsh plugin --profile web add @deepwhale-cn/dsh-terms-glossary
安装前建议自行查看 GitHub 源码与 LICENSE，并确认插件将以当前 dsh 进程权限访问你指定的输入路径。
典型用法¶
命令行入口为 dsh-terms-glossary（见 package bin 配置）。README 示例：
dsh-terms-glossary --input ./文档 --terms '深鲸,DeepWhale'
说明这一步在做什么：--input 指向待扫描目录（示例中为 ./文档），--terms 列出需要一并统计的写法。执行后得到按文件划分的次数信息，用于检查是否混用「深鲸」与「DeepWhale」等别名。
若已在 DSH Web 中安装该插件，可在侧栏打开「深鲸术语统一」，在面板中完成同类扫描（具体表单项以插件 UI 为准，行为原则与 README 一致：只扫 .md/.txt，只提示不改文件）。
适用场景与注意¶
适合：维护多份 Markdown/纯文本文档的团队；在发布前做术语一致性自查；与 DSH 文档、技能说明写作流程配合。
注意：
- 插件不替代人工定稿，只辅助发现混用。
- 扫描范围限于
.md/.txt；代码注释、JSON、HTML 等不在默认范围内。 - 社区目录显示的星标等信息可能变动；以 GitHub 仓库与 README 为准。
- 任何 DSH 插件均在本地以当前用户权限运行，请勿对不可信目录盲目执行扫描。
结尾¶
dsh-terms-glossary 把「同一概念多种写法」从主观通读变成可复现的按文件计数，适合写文档、改 README 前的快速自检。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
