dsh-pr-description
DSH 原生工具：分析当前分支差异，生成符合 Conventional Commits 规范的 PR 标题，以及包含动机、方案、测试、风险说明和自我审查清单的描述，写入 PR_DESCRIPTION.md，并可选择通过 gh CLI 创建 PR。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-pr-description@0.1.1Pr Description 以 dsh-pr-description 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
[!IMPORTANT] 依赖前置：相邻
dsh-src检出（link:依赖） 本项目在开发形态下使用link:依赖指向相邻的 DeepSeek Harness 源码检出（dsh-src）， 与当前仓库保持同一父目录布局（<parent>/dsh-src）。克隆本仓库后：
- 先把官方
deepseek-ai/deepseek-harness检出到与本仓库同级的dsh-src/目录，并执行其pnpm install && pnpm run build；- 再按下方「安装」一节执行本仓库的
pnpm install --offline && pnpm build与测试。 发布到 npm 的版本会尽量把link:依赖替换为 registry 真实版本；无法替换的内部包保持link:，见各包 README 说明。
DSH 原生工具：分析当前分支 diff，自动生成符合 Conventional Commits 的 PR 标题、动机/方案/影响/测试/风险五段描述与自审清单，输出 Markdown 到工作区并在会话内渲染；可选 confirm 交互确认与 openPr 直接调用 gh CLI 提 PR。
项目定位（2026-08 调研）：DSH 社区已有大量「代码评审」，但「PR 描述自动生成」无人做。本插件只借鉴上游
anthropics/claude-plugins-official评审类插件的工作流顺序（范围 → diff → 聚焦），文案与实现全部自写，License 为 MIT。
pr_describe 工具，流程对齐评审工作流：
git diff --name-status <base>...HEAD；base 缺省自动探测（origin/HEAD → origin/main → origin/master → main → master → develop → HEAD~1），探测失败给出结构化错误提示显式指定；+/- 行数；按 docs / test / chore / feat / fix / refactor 确定性归类（规则见下）；feat(scope): 动词短句 标题 + 动机/方案（引用文件与符号）/影响范围/测试建议/风险与开放问题五段 + 自审清单（4 项）；confirm: true 走 ask-user 交互确认，取消则不落盘；openPr: true 且 gh 可用时直接 gh pr create --title --body-file（不自动 push）。PR_DESCRIPTION.md（默认，可经 output / 配置 outputFile 修改）+ 会话内 Markdown 渲染。code 的结构化错误。BREAKING CHANGE: 注解、package.json 主版本提升、删除公开导出且同文件无同名新增。说明：当前「动机/方案/影响/测试/风险」五段为确定性模板拼装（由 diff 统计、符号提取与破坏性信号直接填充文案），未调用 LLM；PROMPT §4.4 中「调用模型填充五段」尚未实现，如需语义润色请自行在生成后接入模型处理。
.md / docs/ / README*）→ docstests/ / *.test.* / *.spec.*）→ test.github/ / *.yml / .eslint* 等）→ chorefeatfixrefactor两种挂载方式。随包发布的 cordis.yml（package.json 的 dsh.bundle.patch）为生产模式行名，已按已安装包可解析的说明符（裸包名）书写：
行名解析：DSH loader 对 patch 内的行名按 profile 的 baseUrl 解析——相对路径锚定在
<DSH_HOME>/profiles/<name>/（root config 所在目录），裸包名则从该目录的 node_modules 解析。 因此相对源码路径./src/index.ts安装后会指向不存在的<profile>/src/index.ts，必须用裸包名或绝对路径。
pnpm build # tsc → lib/（含 lib/types 声明归一化，见下）
dsh plugin --profile demo add ./dsh-pr-description
dsh plugin add 把本包安装进 profile 的 node_modules，并因 package.json 声明了 dsh.bundle
将其 cordis.yml 作为 patch 层加入；行名 dsh-pr-description 为裸包名，loader 按 profile 的
baseUrl 从已安装 node_modules 解析（main → lib/index.js）。
不改随包发布的 cordis.yml，另写一个 overlay patch 并把行名指向源码绝对路径（同
dsh-src/scratch-plugin/cordis.yml 的写法）：
# cordis.dev.yml —— dev 热加载 overlay
- insert:
- id: pr-describe
name: '/abs/path/to/dsh-pr-description/src/index.ts' # 绝对路径，不能写 ./src/index.ts
config:
locale: 'zh'
defaultTitleStyle: 'conventional'
outputFile: 'PR_DESCRIPTION.md'
dsh --patch ./cordis.dev.yml
loader 对 patch 内相对行名按 profile 的 baseUrl（而非 overlay 文件所在目录）解析，dev 模式必须写绝对路径。
分析当前分支的改动，用 pr_describe 生成 PR 描述并确认后写入
工具参数：
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
workdir | string | 配置 workdir 或进程 cwd | git 仓库目录 |
base | string | 自动探测 | 对比基线 |
titleStyle | string | conventional | conventional / plain |
confirm | boolean | false | 生成前 ask-user 交互确认；取消不落盘 |
openPr | boolean | false | gh 可用时直接提 PR；不可用则跳过并说明 |
output | string | PR_DESCRIPTION.md | 输出文件（相对 workdir） |
locale | string | zh | 模板语言 zh / en |
插件配置（cordis.yml）：
- insert:
- id: pr-describe
name: 'dsh-pr-description'
config:
locale: 'zh'
defaultTitleStyle: 'conventional'
outputFile: 'PR_DESCRIPTION.md'
defaultBase: '' # 留空 = 自动探测
workdir: '' # 留空 = 进程 cwd
node tests/smoke.offline.mjs # 零依赖离线冒烟（Node>=22.18 原生 TS strip + 真实 git fixture）
pnpm test:e2e # vitest fixture 仓库 e2e（需已安装 DSH 依赖）
pnpm build # tsc → lib/ + lib/types 相对导入归一化为 .js
代码结构：
src/index.ts # 装配 + Config + 工具注册（Cordis 插件行）
src/tools/pr-describe.ts # defineTool 定义（五阶段主流程）
src/diff-analysis.ts # git diff 解析（纯函数）+ GitRunner seam + 编排
src/templates.ts # 标题/五段/自审清单模板（zh/en，纯函数）
src/gh.ts # gh CLI 探测与可选提 PR（runner seam）
tests/smoke.offline.mjs # 离线冒烟：真实 git fixture + 纯层断言
tests/smoke.e2e.ts # vitest e2e：假 ctx + 真实 git，覆盖 confirm/错误/gh
设计要点：
ctx.subprocess（GITRunner seam）执行，不拼接 shell 字符串，模型/用户输入永不进入命令行参数外的任何位置；ctx.get('userQuestions') 为可选依赖，缺失时给出 ASK_USER_UNAVAILABLE 结构化错误；ctx.tools.register 与所有 spawn 均随插件 Fiber 卸载自动清理（subprocess 服务持有进程树生命周期）。MIT。上游 pr-review-toolkit / commit-commands 为 Proprietary，本插件仅借鉴工作流顺序与模板结构，未复制其文案。