SuperAPI AI 工具集

dify-docs-terminology-check

写作与研究

查看项目

更新于 10-15 23:48

技能介绍

用途:对 Dify 文档做只读术语一致性审计,核对文档用词是否与术语表(通用术语)和 Dify 代码库 i18n(UI 标签)一致,覆盖整个文件而非仅 diff,审计期间不修改任何文件。

主要能力:读取 writing-guides/glossary.md 的 General Terms 与 UI Labels 两节;定位 Dify 代码库并固定 ref;用 grep 提取加粗术语、章节标题与本地截图路径;将候选术语对照 web/i18n/en-US/ 等 i18n 值分类验证,并检查渲染位置;核对 zh/ja 对应本地化字符串;检查通用术语是否符合术语表各语言列;报告过时截图、术语表缺口与失效术语表行。

使用方式:需提供 Dify 仓库本地路径并确认分支(默认 main)。在 Dify 仓库执行 git fetch --tags origin 与 REF=$(git rev-parse origin/<branch>),禁止 git checkout 或 git pull。用 python3 tools/translate/check-glossary-keys.py --dify <path> --ref "$REF" 检查术语表键。提取用 grep -anoE '**[^]+**' <file>、grep -anE '^#{2,3} ' <file>、grep -anoE '/images/[^) "]+' <file>。查 i18n 用 git grep -nF '"<Term>"' "$REF" -- 'web/i18n/en-US/.json'。经用户批准后可编辑 glossary.md,并运行 python3 tools/translate/derive-termbase.py 及 --check 验证同步。

适用场景:Dify 文档术语审查、UI 标签核对、截图更新判断、术语表维护。

限制:只读,报告后停止,需用户批准才修改;排除 environments.mdx 三个文件;仅匹配本地 /images/ 路径,旧 CDN 图片不在范围;代码库 i18n 为 UI 标签唯一事实来源,代码库优先于术语表;aria-label、tooltip、placeholder 不算可见标签;术语表失效行不作为页面问题证据。