前言¶
DeepSeek Harness (DSH) 的核心能力通过插件扩展。在管理和审查这些插件与技能时,开发者常面临描述杂乱、状态不清、多平台技能难以统一收敛的问题。dsh-audit-skills 是一款专用的审查插件,它将上游跨平台的审计技能收敛为 DSH 单平台能力,重点解决了技能库翻译精炼、插件页中文化落地以及状态维护等具体需求。
安装与启用¶
DSH 通过插件管理器托管 desktop / web profile。安装后需重启 DSH 才能生效。
# 官方 profile(web 等)
dsh plugin --profile web add github:gtbwpkwjnb-alt/dsh-audit-skills
安装完成后,侧边栏 Plugins 页会出现 dsh-audit-skills(插件审查) 卡片。卡片上的开关即为效果开关:启用即应用精炼与中文化,停用即还原。
核心能力¶
该插件提供以下六项核心功能:
- 技能库翻译精炼:对技能描述进行精炼翻译,提供中文候选与质量状态。
- 项目画像:生成技术栈、项目类型与扫描边界分析。
- 技能/插件推荐:基于已装工具进行优化建议,提供同类比较与带证据的下一步。
- 插件页中文化落地:将插件页说明精炼为中文并写入配置,解决 DSH 插件页语言问题。
- 市场按需检索:在 DSH 市场中按需求检索插件,对比兼容性与成本。
- 插件与技能状态维护:在统一视图内查看翻译、作用、来源、版本与更新状态。
关键约定:插件名保留原文¶
DSH 插件页标题依赖 locale/<lang>.json 的 meta.title。一旦写成中文将无法识别插件。本插件强制保留原包名(英文代码名)作为标题,并在括号内添加中文名。
脚本使用¶
插件提供了一系列脚本用于本地化与检索操作。
插件页中文化落地¶
通过 scripts/dsh_plugin_locale.mjs 管理 node_modules 内的本地化文件。该脚本会自动备份、迁移旧键并补全 exports。
node scripts/dsh_plugin_locale.mjs --check # 只读巡检
node scripts/dsh_plugin_locale.mjs --apply # 写入 locale 文件并补 exports
node scripts/dsh_plugin_locale.mjs --restore # 从备份还原
市场按需检索¶
用于查找符合特定需求的 DSH bundle。
node scripts/dsh_market_search.mjs --need 记忆 --need 搜索 --limit 8
node scripts/dsh_market_search.mjs --need 语音转写 --json
客户端与目录注入¶
用于生成和校验客户端显示的中文快照。
node scripts/render-smoke.mjs # 合成夹具
node scripts/render-smoke.mjs --live # 使用真实进程渲染
node scripts/build-client-catalog.mjs # 注入内置 catalog 中文快照
node scripts/build-client-catalog.mjs --check # 漂移校验
注意事项与已知边界¶
- 本地化持久性:插件页本地化文件写在
node_modules内,升级或重装插件后丢失,需重新执行dsh_plugin_locale.mjs --apply恢复。 - 版本事故:v1.2.1 曾因裸 ESM 问题导致 GUI 无法启动,现已修复。任何客户端改动必须通过
scripts/preflight-client.mjs预检。 - 插件形态:v1.1.0 起该插件为纯插件形态,不再注册 skill。
- 平台范围:配置默认仅扫描 DSH 相关路径,排除 Codex / ZCode / Claude Code,专注于 DSH 平台的健康度与评分。
- 技能发现规则:DSH 技能根发现仅扫描顶层
<name>/SKILL.md或<name>.md,嵌套文件不发现。
总结¶
dsh-audit-skills 是 DSH 生态中用于审查与维护技能/插件的实用工具。它通过精炼翻译、项目画像和状态维护,帮助开发者更好地管理 DSH 环境。所有脚本与配置均遵循 DSH 客户端的加载契约。
- GitHub 仓库:https://github.com/gtbwpkwjnb-alt/dsh-audit-skills
- 上游依赖:skills-summarize-audit v9.2.2