📝 docs: 安装示例改用 v2.0.2

.gitmessage

@@ -0,0 +1,10 @@
+# <emoji> <type>[(scope)][!]: <中文描述，一句话，不加句号>
+# 一条提交信息只有这一行，不写正文，也不写脚注。
+# 破坏性变更只用 ! 标记，例如：♻️ refactor!: 改掉了某某行为
+# 需要交代背景时，把说明写进 README.md、CONTRIBUTING.md 或代码注释。
+#
+# 类型与 emoji：feat ✨ / fix 🐛 / docs 📝 / refactor ♻️ / perf ⚡️ /
+#              test ✅ / build 📦️ / ci 💚 / chore 🔧 / revert ⏪️
+# 例：✨ feat(client): 会话行悬停区加删除按钮
+# 例：🐛 fix(host): 延迟删除台账只记录根会话
+# 例：📝 docs(ci): 安装说明只保留 Git 标签与本地 tgz

CONTRIBUTING.md

@@ -0,0 +1,94 @@
+# 提交信息规范
+
+本仓库的提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/) 的**首行**结构，并在行首加一个 emoji 做视觉标记。**描述用中文**，类型关键字、作用域保持英文。
+
+## 格式
+
+**一条提交信息只有一行**，没有正文，也没有脚注：
+
+```text
+<emoji> <type>[(scope)][!]: <中文描述>
+```
+
+- `<emoji>`：下面表格里该类型对应的 emoji，后面跟**一个空格**。emoji 是必需的，且必须与本行类型一致——`📝 docs:` 对，`✨ docs:` 不对。
+- `<type>`：小写英文关键字，见下表。
+- `(scope)`：可选，改动范围。用 `()` 包住一个简短英文标识，例如 `docs(ci)`、`fix(client)`、`feat(host)`。
+- `!`：可选，紧跟在 type 或 scope 之后、冒号之前，表示破坏性变更。
+- `<描述>`：中文，一句话，讲清这次改动做了什么；不换行、不用列表、不加句号。宽度不超过 72（中文字符按 2 个宽度算）。
+
+**不要写正文，也不要写脚注。** 连 `Refs:` / `Closes:` / `BREAKING CHANGE:` 这类尾注也不写——需要交代的"为什么""影响面""迁移注意事项"，写进 [README.md](README.md) 或本文件，或写进代码注释，让说明跟着代码走，而不是埋在 `git log` 里。
+
+**破坏性变更只靠 `!` 标记**（例如 `♻️ refactor!: …`）。这一条是对 Conventional Commits 的有意偏离：它要求破坏性变更必须有 `BREAKING CHANGE:` 脚注，本仓库不写脚注，所以判断破坏性变更以 `!` 为准。
+
+如果确实需要多行说明，说明这次改动不该只用一个提交标题交代——先补文档，再提交。
+
+## 类型与 emoji
+
+| 类型 | emoji | 码位 | 用途 |
+| --- | --- | --- | --- |
+| `feat` | ✨ | `U+2728` | 新增功能 |
+| `fix` | 🐛 | `U+1F41B` | 修复缺陷 |
+| `docs` | 📝 | `U+1F4DD` | 只改文档 |
+| `refactor` | ♻️ | `U+267B U+FE0F` | 重构，行为不变 |
+| `perf` | ⚡️ | `U+26A1 U+FE0F` | 性能优化 |
+| `test` | ✅ | `U+2705` | 变更测试 |
+| `build` | 📦️ | `U+1F4E6 U+FE0F` | 构建系统或依赖 |
+| `ci` | 💚 | `U+1F49A` | CI 配置 |
+| `chore` | 🔧 | `U+1F527` | 杂项，以上都不属于时用 |
+| `revert` | ⏪️ | `U+23EA U+FE0F` | 回滚某次提交，正文写 `Refs: <被回滚的提交>` |
+
+**复制上表里的 emoji，不要手敲。** 带 `U+FE0F` 的那五个是「基础字符 + 变体选择符」两个码位，手敲时很容易只打出前一个字符；对工具来说 `♻`（`U+267B`）和 `♻️`（`U+267B U+FE0F`）是两个不同的字符串，比对会失败。写规范或写脚本时，比较 emoji 前先做一次 NFC 归一化，或把两边都按 `\uFE0F?` 处理。
+
+## 示例
+
+每条都是一整条提交信息，就这一行：
+
+```text
+✨ feat(client): 会话行悬停区加删除按钮
+```
+
+```text
+🐛 fix(host): 延迟删除台账只记录根会话
+```
+
+带作用域与破坏性标记（破坏性变更**没有**脚注，只看 `!`）：
+
+```text
+♻️ refactor(client)!: 行内按钮改用自己的槽位 id
+```
+
+```text
+📝 docs: 安装说明改为只走 Git 标签与本地 tgz
+```
+
+## 工具链提示
+
+emoji 在行首是本仓库的有意选择，视觉上整齐。代价是：以类型前缀开头的解析工具（`commitlint`、`semantic-release`、`release-please` 等）会读不到类型。如果以后要接这类工具，有两条路：
+
+1. 把 emoji 挪到冒号之后（`feat: ✨ 描述`），类型回到行首，规范其余部分不变；
+2. 保留行首 emoji，给工具写一个剥掉开头 emoji 与空格的预处理。可用的正则（`\p{Extended_Pictographic}` 已覆盖带与不带变体选择符两种写法）：
+
+   ```text
+   ^(?:\p{Extended_Pictographic}\uFE0F?\s+)?(?<type>[a-z]+)(?:\((?<scope>[^)]*)\))?(?<breaking>!)?:\s(?<desc>.+)$
+   ```
+
+## 自查
+
+`scripts/check-commit-log.mjs` 会按本规范检查现有提交，只报告、不拦提交。除了首行格式，它还会报出**任何带正文或脚注的提交**：
+
+```bash
+node scripts/check-commit-log.mjs        # 最近 10 条
+node scripts/check-commit-log.mjs all    # 全部
+```
+
+它从本文件的类型表里读 emoji 对照表，所以改了表不用改脚本。规范之前的提交不符合是正常的。
+
+## 启用提交模板（可选）
+
+`.gitmessage` 是提交信息模板。启用后每次 `git commit` 会带上前缀提示：
+
+```bash
+git config commit.template .gitmessage
+```
+
+模板整份都是 `#` 开头的注释，git 会自动丢弃，所以直接 `git commit -m` 也不受影响。只对当前仓库生效；换机器要重新执行一次。

README.md

@@ -2,7 +2,7 @@
 
 DeepSeek Harness（DSH）插件：给会话加上**真正不可逆的删除**，并清理已删除会话遗留的临时文件。
 
-DSH 原本只能归档会话——归档只是把会话从列表里移开，日志仍然留在磁盘上（DSH 官方的 JSONL 会话存储后端明确写着「没有任何东西会删除会话文件，日志会一直堆在 root 下直到被外部移除」，会话存储契约里也没有删除 API）。这个插件补上的正是这一块：两处删除入口，以及设置页里的一次性孤儿文件清理。
+DSH 原本只能归档会话——归档只是把会话从列表里移开，日志仍然留在磁盘上（DSH 官方的 JSONL 会话存储后端明确写着「没有任何东西会删除会话文件，日志会一直堆在 root 下直到被外部移除」，会话存储契约里也没有删除 API）。这个插件补上的正是这一块：两处删除入口，以及插件页里的一次性孤儿文件清理。
 
 ## 功能
 
@@ -30,7 +30,7 @@ DSH 原本只能归档会话——归档只是把会话从列表里移开，日
 
 ### 2. 清理临时文件
 
-**设置 → 插件 → 会话彻底删除**（点会话彻底删除那一行右侧的配置按钮），清理 spill 后端留下的**孤儿**目录。判定偏保守：
+**设置 → 插件 → 会话彻底删除**（打开插件页就能看到，不必再点进「包含的组件」里那一行），清理 spill 后端留下的**孤儿**目录。判定偏保守：
 
 1. 目录名必须精确等于 `session-<sha256(会话 id) 前 12 位>`——这是 spill 后端唯一会生成的形状；
 2. 该名字不属于任何已知会话（`sessionQuery.listSessions()` 已经把存量会话与内存中正在运行的会话合并成同一份语料，所以「已知」只需要一个来源）；
@@ -39,7 +39,13 @@ DSH 原本只能归档会话——归档只是把会话从列表里移开，日
 
 结果直接显示在该页（清理了几个目录、几个文件、释放多少空间），可反复点击。
 
-这个页面占的是 `plugins.row.config` 槽位——和官方插件「终端」的配置页是同一个位置。注册了这个槽位的 key（`<包名>#<行 id>`）之后，插件行就会长出配置入口，所以本插件不声明 `Config` 也能有自己的页面。
+这块清理占的是 `plugins.bundle.config` 槽位，key 就是本包的**包名**（`@dsh-plugin/session-delete`）。它渲染在插件页的**描述与「包含的组件」之间**，所以打开插件页即可看到，不用再点一次。
+
+没有用行级槽位 `plugins.row.config`（key 形如 `<包名>#<行 id>`）：它只会在「包含的组件」那一行上多长出一个「配置」入口，把本插件唯一的控件藏到二级页面里。本插件页顶部是 DSH 自己渲染的插件标题与描述，所以这块配置不再重复标题，直接讲清理这件事本身。
+
+### 关于「包含的组件」
+
+插件页下方的「包含的组件 / 组件」是 **DSH 插件页固定渲染**的：`ui-plugin-manager` 无条件列出这个 bundle 在 `cordis.patch.yml` 里声明的**每一行**（行 id、运行状态、单独开关），没有"跳过"的口子。任何 bundle 都至少要声明一行才能挂上宿主半，所以这一节必然出现——本插件就是这一行。它也不是纯冗余：它标出运行状态、允许单独关掉这个组件。插件侧没法隐藏它，但插件的功能不再挂在它下面——清理入口已经在页面本身上了。
 
 ## 行为与边界
 
@@ -61,21 +67,23 @@ DSH 的 **插件 → 添加插件** 里有两个输入，含义不同：
 在上面的输入框里填：
 
 ```text
-https://gitea.iwake.top/dsh-plugin/session-delete.git#v2.0.0
+https://gitea.iwake.top/dsh-plugin/session-delete.git#v2.0.2
 ```
 
 `#` 后面可以跟标签或提交，用来锁定版本；不写则取默认分支。仓库是公开的，不需要凭据，也不需要改安装源。
 
-想跟随 2.x 的最新版本，可以把后缀写成 `#semver:^2.0.0`——pnpm 会按仓库里的标签挑最高的 2.x，以后发了 v2.0.1，移除旧版本再装一次就能拿到。
+想跟随 2.x 的最新版本，可以把后缀写成 `#semver:^2.0.2`——pnpm 会按仓库里的标签挑最高的 2.x，以后发了新版本，移除旧版本再装一次就能拿到。
 
 ### 2. 本地 tgz
 
-把仓库打包成 tgz（例如在仓库目录执行 `npm pack`，得到 `dsh-plugin-session-delete-2.0.0.tgz`），把它在运行 DSH 那台机器上的绝对路径填进上面的输入框。
+把仓库打包成 tgz（例如在仓库目录执行 `npm pack`，得到 `dsh-plugin-session-delete-2.0.2.tgz`），把它在运行 DSH 那台机器上的绝对路径填进上面的输入框。
 
 ### 升级
 
 DSH 暂不支持插件自动更新，升级就是用新标签重装一次（建议先移除旧版本）。安装或升级后：**宿主半变更需要重启 DSH**（完全退出再打开，仅关闭窗口不一定退出进程）；只改浏览器半时刷新页面即可。
 
+如果你是在本地开发这个插件（profile 里装的是 `link:` 到工作目录），**光刷新页面看不到改动**：profile 的 `node_modules` 里可能是一份与源码同 inode 的硬链接副本，需要移除再重装一次插件，让 profile 重新取一份。
+
 ## 兼容性
 
 基于 **DeepSeek Harness 0.2.0-rc.2** 编写。DSH 仍在演进，其它版本与平台组合未逐一验证。
@@ -84,6 +92,14 @@ DSH 暂不支持插件自动更新，升级就是用新标签重装一次（建
 - **宿主半**只依赖稳定的服务契约：`sessionQuery`（`traceSession` 取血缘、`listSessions` 取语料）、`sessionPersistence`（含其 JSONL 后端的 `locate()` 诊断钩子，用于定位会话目录）、`workspaceRegistry`、`connection.fetch`（注册受认证的 exact 路由），以及 spill 后端的目录规则。
 - **跨半边通信**走 `connection.fetch` 注册的 `POST /api/plugin/session-delete/delete` 与 `.../orphans` 两条路由，浏览器半用文档相对路径请求（支持挂载前缀）。这是静态客户端包与宿主半通信的正规通道；`host.call` 属于动态客户端运行器，不适用于包形式的插件。
 
+## 贡献
+
+提交信息用「emoji + Conventional Commits + 中文描述」，规则、类型表和示例见 [CONTRIBUTING.md](CONTRIBUTING.md)。想省事可以让 git 带上模板：
+
+```bash
+git config commit.template .gitmessage
+```
+
 ## License
 
 [MIT](LICENSE)

client.js

@@ -8,11 +8,14 @@
  *
  * The temporary-file sweep is the plugin's other operation, and it lives on
  * this plugin's own page under Settings → Plugins: the entry registers into
- * `plugins.row.config` under the `<package name>#<row id>` key the manager
- * dispatches, which also gives the row its configure control. That is the same
- * seat a bundled plugin's configuration form occupies, so the plugin's only
- * control sits beside everything else the manager says about it instead of
- * taking a row in General settings.
+ * `plugins.bundle.config` under this package's name, the page-level seat the
+ * manager renders on a bundle's page between its description and its rows.
+ *
+ * That page-level seat is deliberate, not the row-level `plugins.row.config`
+ * one. The row seat grows a configure control on the row listed under
+ * 「包含的组件」 and nothing else, so it parks this plugin's one and only control
+ * one click deeper than the page the user just opened; the page seat puts it
+ * where the page is read.
  *
  * Two client-authoring rules shape this file:
  *
@@ -44,15 +47,13 @@ window.__ModuleLoader__.load({
     /** Between the shipped `archive` (100) and `pin` (200) hover buttons. */
     const ROW_ACTION_ORDER = 150
     /**
-     * The key `plugins.row.config` is dispatched under: the manager composes it
-     * as `<package name>#<row id>`, with the row id read from this bundle's own
-     * patch. Both halves are literals from `package.json` and
-     * `cordis.patch.yml`; a typo costs the configure control silently, so they
-     * are the only two places renaming has to reach.
+     * The key `plugins.bundle.config` is dispatched under: the manager keys a
+     * bundle's own configuration by its npm package name and renders the entry
+     * on that bundle's page, between the description and the rows. The value is
+     * the literal from `package.json` — a typo costs the section silently, so
+     * it is the only place renaming has to reach.
      */
     const PACKAGE = '@dsh-plugin/session-delete'
-    const ROW_ID = 'session-delete'
-    const CONFIG_KEY = `${PACKAGE}#${ROW_ID}`
     const TOOLTIP_DELAY_MS = 500
     const TOOLTIP_GAP = 8
     /** Document base captured at bundle registration, before any routing. */
@@ -331,12 +332,12 @@ window.__ModuleLoader__.load({
      * This plugin's page under Settings → Plugins: sweep spilled tool output
      * whose conversation no longer exists.
      *
-     * The owner asks every `plugins.row.config` entry for two views. `summary`
-     * is the one-liner on the row, and this plugin's manifest description
-     * already fills that seat, so `summary` renders nothing and the page keeps
-     * the text the manager read from `locale/*.json`. `page` is the section the
-     * manager renders with its own heading, breadcrumb, and title; copy,
-     * control, and result belong to this entry.
+     * The owner dispatches the `page` view only: a bundle's configuration has
+     * no one-line form, because the page header already prints this package's
+     * title and description from the manifest. So the section opens with the
+     * operation's own name and the rule it applies — what the header cannot say
+     * — and the guard below keeps rendering nothing if a `summary` view ever
+     * arrives.
      */
     function TempCleanupPanel(props) {
       const t = translate(props.t)
@@ -650,12 +651,13 @@ window.__ModuleLoader__.load({
           }),
         }, DeleteSessionDialog))
 
-        // The cleanup control belongs on this plugin's own page: registering
-        // this cell key is what makes the row grow a configure control, and the
-        // manager renders the entry for both its summary and page views.
-        ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
-          name: 'plugins.row.config',
-          key: CONFIG_KEY,
+        // The cleanup control belongs on this plugin's own page itself, not
+        // behind the component row listed under 「包含的组件」:
+        // `plugins.bundle.config` keyed by this package's name is the seat the
+        // manager renders between the page's description and its rows.
+        ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register({
+          name: 'plugins.bundle.config',
+          key: PACKAGE,
           locale: NS,
           inject: () => ({ cleanOrphans }),
         }, TempCleanupPanel))

package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dsh-plugin/session-delete",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "private": true,
   "type": "module",
-  "description": "Permanently delete a conversation: stop it, remove its session log, subagent logs, and spilled tool output, and drop every registry reference. Settings → General can sweep orphaned temporary files left by conversations that are gone.",
+  "description": "Permanently delete a conversation: stop it, remove its session log, subagent logs, and spilled tool output, and drop every registry reference. The plugin's own page under Settings → Plugins can sweep orphaned temporary files.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -28,6 +28,9 @@
     "icon.svg",
     "locale/*.json",
     "README.md",
+    "CONTRIBUTING.md",
+    ".gitmessage",
+    "scripts/**/*.mjs",
     "LICENSE"
   ],
   "engines": {

scripts/check-commit-log.mjs

@@ -0,0 +1,88 @@
+// Checks existing commits against the CONTRIBUTING.md spec. The spec allows one
+// line only, so a subject must both parse (emoji + type + Chinese description)
+// and be the whole message: any body or footer is reported too.
+//
+// This is a reporting tool, not a hook: it never blocks a commit.
+//
+// Usage:
+//   node scripts/check-commit-log.mjs          # newest 10 commits
+//   node scripts/check-commit-log.mjs 50       # newest 50 commits
+//   node scripts/check-commit-log.mjs all      # every commit
+//   DSD_SPEC=path/to/CONTRIBUTING.md node scripts/check-commit-log.mjs
+import { execFileSync } from 'node:child_process'
+import { readFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const specPath = process.env.DSD_SPEC ?? resolve(repoRoot, 'CONTRIBUTING.md')
+const doc = readFileSync(specPath, 'utf8')
+const count = process.argv[2] ?? '10'
+
+/** The regex the spec documents for a subject line. */
+const SUBJECT = new RegExp(
+  '^(?:\\p{Extended_Pictographic}\\uFE0F?\\s+)?' +
+  '(?<type>[a-z]+)' +
+  '(?:\\((?<scope>[^)]*)\\))?' +
+  '(?<breaking>!)?' +
+  ':\\s(?<desc>.+)$',
+  'u',
+)
+
+// The spec's table is the single source of truth for the type → emoji mapping,
+// so a table edit cannot drift from what this script checks.
+const emojiOfType = new Map()
+for (const row of doc.split('\n').filter((line) => /^\| `[a-z]+` \| /.test(line))) {
+  const cells = row.split('|').map((cell) => cell.trim())
+  emojiOfType.set(cells[1].replaceAll('`', ''), cells[2])
+}
+if (emojiOfType.size === 0) throw new Error(`${specPath} has no type table to read`)
+
+/** Strip the variation selector, so '♻' and '♻️' compare equal. */
+const base = (text) => text.replace(/\uFE0F/g, '')
+/** Display width, counting anything above U+2000 as double. */
+const widthOf = (text) => [...text].reduce((n, c) => n + (c.codePointAt(0) > 0x2000 ? 2 : 1), 0)
+
+// %B is the raw message body, so a record can hold several lines: a record ends
+// at the next hash that starts a line, which is what this splits on.
+const range = count === 'all' ? [] : [`-${Number(count)}`]
+const raw = execFileSync('git', ['log', ...range, '--format=%h%x09%B%x00'], {
+  encoding: 'utf8',
+  cwd: repoRoot,
+})
+
+const commits = raw.split('\0').map((chunk) => chunk.replace(/^\n+/, '')).filter((chunk) => chunk.trim() !== '')
+
+let problems = 0
+for (const chunk of commits) {
+  const tab = chunk.indexOf('\t')
+  const hash = chunk.slice(0, tab)
+  const message = chunk.slice(tab + 1).replace(/\n+$/, '')
+  const lines = message.split('\n')
+  const subject = lines[0]
+  const extra = lines.slice(1).filter((line) => line.trim() !== '')
+  const notes = []
+
+  const match = SUBJECT.exec(subject)
+  if (match === null) {
+    notes.push('首行缺少类型前缀，或整体格式不是 <emoji> <type>[(scope)][!]: <描述>')
+  } else {
+    const expected = emojiOfType.get(match.groups.type)
+    const lead = [...subject][0]
+    if (expected === undefined) notes.push(`类型不在规范表里：${match.groups.type}`)
+    else if (base(lead) !== base(expected)) notes.push(`类型 ${match.groups.type} 的 emoji 应为 ${expected}，实际是 ${lead}`)
+    const width = widthOf(subject)
+    if (width > 72) notes.push(`首行宽度 ${width}，超过 72`)
+    if (/[。.]$/.test(subject)) notes.push('首行结尾不应有句号')
+  }
+  if (extra.length > 0) notes.push(`带了 ${extra.length} 行正文或脚注，规范要求只有一行`)
+
+  if (notes.length > 0) problems += 1
+  const mark = notes.length === 0 ? 'ok  ' : 'FAIL'
+  console.log(`  ${mark} ${hash} ${notes.length === 0 ? '' : notes.join('；') + ' — '}${subject}`)
+}
+
+console.log(problems === 0
+  ? `\n检查了 ${commits.length} 条提交，全部符合规范`
+  : `\n检查了 ${commits.length} 条提交，其中 ${problems} 条不符合规范（规范文件：${specPath}）`)
+process.exit(problems === 0 ? 0 : 1)