前言¶
在 DSH 里做插件或开源小项目，代码能跑往往不等于对外能看：README 缺安装路径、demo 随手截、发布前没人核对链接和锚点。换仓库就要重做首屏、徽章和检查清单，风格还不好复用。DeepSeek Harness 社区把工作流拆成可安装插件；下面介绍维护者 sakikoTGW 的 dsh-plugin-tailor（分类：工作流），用一条可重复的流水线做成熟度审计、选 README 风格、生成品牌 SVG、双语草稿和发布前校验。
这是什么¶
dsh-plugin-tailor 是 DSH 工作流插件，定位是「审计 → 选风格 → 品牌素材 → 双语 README → 发布前校验」。它把仓库成熟度拆成 8 维 34 项检查，把 README 表达拆成 7 个风格预设，品牌图用确定性 SVG（不依赖图片模型），CLI bin/tailor.mjs 与六个 repo_* 工具共用同一套 logic/。
- 版本：0.3.0（资料 badge）
- 许可证：MIT
- 运行要求：Node >= 20，DSH >= 0.2.0-rc.2 且 < 0.3.0
- 源码与说明：GitHub sakikoTGW/dsh-plugin-tailor
- 社区目录：SkillHub 插件页
npm 尚未发布；v0.3.0 已提供 GitHub Release 含 .tgz。
核心功能¶
流水线¶
repo_audit：读package.json、README、assets、CI、git 状态，按 8 维打分，输出按影响排序的缺口。repo_plan：缺口转为 P0/P1/P2 任务，带验收标准与repo_verify命令。repo_brand：按风格调色板与 12 个几何概念生成 8 个 SVG 文件；默认不覆盖已有文件。repo_readme：按风格组装 zh/en 草稿，缺事实处标TODO(tailor)；默认 dry-run，需apply才落盘。repo_verify：复跑审计并检查相对链接、图片、锚点、徽章、必需章节、剩余 TODO，给出 PASS/FAIL 与分数差。
另有只读工具 repo_styles，返回 7 种风格的 id、语言、首屏、demo 等元数据。
八种维度与写保护¶
审计维度涵盖身份、首屏、安装、文档、证据、发布、社区、品牌。写操作默认 dry-run；手写 README、已有素材、脏 worktree 在未显式 force 时会被拒绝或跳过。
七种 README 风格（id）¶
| id | 简要定位 |
|---|---|
evidence |
证据优先，双语，适合有基准/测试的工程仓库 |
terminal |
终端工具，双语，适合 CLI |
mobile |
移动端·社群，中文优先 |
playful |
GIF 开场·教程，英文优先 |
product |
品牌产品页，英文优先 |
platform |
面板平台，双语 |
minimal |
极简排版，英文优先 |
章节顺序与选型说明见仓库内 docs/STYLES.md。
品牌素材¶
repo_brand 从 12 个概念（如 needle、prompt、arcs 等）中选型，一次可生成 icon.svg、logo.svg / logo-dark.svg、banner.svg / banner-light.svg、social-preview.svg、brand-sheet.svg 及 assets/README.md。同一仓库重复生成字节一致。
安装与启用¶
README 给出两种方式（二选一）；装完后需重启一次 DSH 引擎，六个 repo_* 工具才会上线。改 logic/ 下次调用即生效；改 host/register.js 或 index.js 需再重启。
# 源码目录
dsh plugin --profile <profile> add /path/to/dsh-plugin-tailor
# 或 Release 里的 tarball
dsh plugin --profile <profile> add /path/to/dsh-plugin-tailor-0.3.0.tgz
不装插件也可直接用 CLI（与工具同源）：
node bin/tailor.mjs styles
典型用法¶
终端 CLI¶
node bin/tailor.mjs styles # 列出 7 种风格
node bin/tailor.mjs audit . --style=terminal # 打分 + 缺口
node bin/tailor.mjs plan . --style=terminal # 任务清单
node bin/tailor.mjs brand . --style=playful --apply
node bin/tailor.mjs readme . --style=evidence --lang=both
node bin/tailor.mjs verify . --style=evidence
生成品牌并落盘示例（需覆盖已有文件时加 --force）：
node bin/tailor.mjs brand . --style=evidence --concept=needle \
--tagline="From it runs to ship it." --apply --force
DSH 工具调用¶
repo_audit { path: ".", style: "terminal" }
repo_plan { path: ".", style: "terminal" }
repo_readme { path: ".", style: "terminal", lang: "both" }
repo_brand { path: ".", style: "terminal", apply: true }
repo_verify { path: ".", style: "terminal" }
repo_readme / repo_brand 主要参数还包括 apply、force；repo_plan 可选 limit。
适用场景与注意¶
适合：需要系统化补 README、统一品牌 SVG、在发布前用一条命令做链接/章节/TODO 校验的 DSH 用户或插件作者。仓库 README 自述用本插件自举时审计分从 37 提到 100；对 dsh-plugin-resolver 审计示例为 84/100（B），repo_verify 可 PASS——均为仓库文档中的自举与示例，非第三方案例。
注意：
- 插件在当前 DSH 进程权限下读写的目标路径由你传入的
path决定；安装前请自行审阅源码与 MIT 许可证。 - README 草稿只使用仓库已采集事实，未知项会变成
TODO(tailor)，仍需人工核对后再发布。 - 已知限制与反馈渠道见仓库 README 的「已知限制」「反馈与安全」及 Issues。
SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件是其中一条工作流扩展。
结尾¶
经过上面的步骤，你可以把「能跑」的仓库按同一套 rubric 推到「敢发布」：先 repo_audit / repo_plan 看清缺口，再选七种风格之一生成 README 与品牌，最后用 repo_verify 收口。详情与 CI（11/11 测试、Node 20/22/24）见 GitHub 仓库，入口也可从 SkillHub 目录页 进入。
