@aiwayds/dsh-dcp 0.7.0 → 0.9.0

package/README.en.md

@@ -105,6 +105,28 @@ npx dsh-dcp-setup                   # safe: date-stamped backup → append-only
 > mount it. The web profile does not bundle the TUI, so it keeps the official
 > backend and is unaffected.
 
+## Uninstall
+
+**Bundle path** (`dsh plugin add`, or listed under `bundles`):
+
+```sh
+dsh plugin --profile <name> remove @aiwayds/dsh-dcp
+```
+
+The host reconciles automatically: the bundles entry is spliced, the patch layer drops with the package, and the stock LLM summarizer (`compaction-basic`) re-enables.
+
+**Setup-script path** (the patch block `npx dsh-dcp-setup` wrote):
+
+```bash
+npx dsh-dcp-setup --remove                        # default home patch
+npx dsh-dcp-setup --remove --profile tui          # a named profile
+npx dsh-dcp-setup --remove /path/to/cordis.patch.yml
+```
+
+`--remove` strips only the setup-written mount block (including any config you tuned), with the same date-stamped backup before modifying; hand-written mounts are left alone; the file is deleted when nothing else remains. Two WARN lines matter: a leftover `compaction-basic` disable entry keeps the stock summarizer off (remove it by hand if it was only for dsh-dcp), and another dsh-dcp mount in the same file is untouched.
+
+Removing the package without the reverse step leaves the mount pointing at the vanished absolute entry path, and the profile boot fails with module-not-found.
+
 ## /dcp command
 
 | Command | Effect |
@@ -154,6 +176,15 @@ All optional, defaults work out of the box:
 
 > **Upgrade note (0.5.0)**: the `roundInterval` counter switched from completed turns to assistant messages — the same value now triggers more often (a single turn usually contains several assistant messages).
 
+## Bundled skill
+
+The package registers a `dsh-dcp` skill (`skills/dsh-dcp/SKILL.md`, served via
+`ctx.skills.registerProvider`): ask the agent to tune compaction, configure dcp,
+or debug compaction behavior and the guide loads automatically — it carries an
+interactive `ask_user_question` tuning wizard (collect the expectation first,
+then map it to keys) and the persistent recipe for the `config:` section of the
+cordis.patch.yml mount block.
+
 ## Design reference
 
 - [Opencode-DCP/opencode-dynamic-context-pruning](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning)

package/README.md

@@ -84,6 +84,28 @@ npx dsh-dcp-setup                   # 安全脚本：带日期备份 → 只追
 
 > dsh-dcp 挂在 dsh 的压缩接口上，只对挂载了它的 profile 生效。web profile 没挂 tui，继续用官方压缩，不受影响。
 
+## 卸载
+
+**Bundle 方式**（`dsh plugin add` 或列在 `bundles`）：
+
+```sh
+dsh plugin --profile <name> remove @aiwayds/dsh-dcp
+```
+
+宿主自动收敛：bundles 条目移除、patch 层随包消失，官方 LLM 压缩后端 `compaction-basic` 自动恢复。
+
+**setup 脚本方式**（`npx dsh-dcp-setup` 写入的 patch 块）：
+
+```bash
+npx dsh-dcp-setup --remove                        # 默认 home patch
+npx dsh-dcp-setup --remove --profile tui          # 指定 profile
+npx dsh-dcp-setup --remove /path/to/cordis.patch.yml
+```
+
+`--remove` 只删除 setup 写入的挂载块（含你调过的 config），修改前同样带日期备份；手工写的挂载块不受影响；删完文件为空时自动删除文件。两条 WARN 要留意：文件里若还留有 `compaction-basic` 的 disable 条目，官方压缩后端会保持关闭 —— 不是给 dsh-dcp 用的就手动删掉；同一文件里另一处 dsh-dcp 挂载不会被碰。
+
+不执行反向步骤直接卸包，patch 里的绝对路径会指向已消失的安装目录，profile 启动将以 module-not-found 失败。
+
 ## /dcp 命令
 
 | 命令 | 作用 |
@@ -126,6 +148,10 @@ npx dsh-dcp-setup                   # 安全脚本：带日期备份 → 只追
 
 > **升级提示（0.5.0）**：`roundInterval` 的计数单位由 completed turn 改为 assistant message——同值下触发会更频繁（一个 turn 内往往有多条 assistant message）。
 
+## 内置技能 / Bundled skill
+
+插件随包注册了 `dsh-dcp` skill（`skills/dsh-dcp/SKILL.md`，经 `ctx.skills.registerProvider`）：在会话里让 agent 调压缩、配置 dcp 或排查压缩行为时，指南自动加载——内含 ask_user_question 交互式调参向导（先问期望再映射到具体键）与 cordis.patch.yml 挂载块 `config:` 段的持久化写法，无需翻文档。
+
 ## 设计参考
 
 - [Opencode-DCP/opencode-dynamic-context-pruning](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning)

package/cordis.patch.yml

@@ -7,6 +7,7 @@
 # cordis.patch.yml editing.
 
 - id: compaction-basic
+  name: '@deepseek-ai/dsh-compaction-basic'
   disabled: true
 - insert:
     - id: dsh-dcp

package/lib/index.js

@@ -35,6 +35,7 @@ import { ManualCompactionError } from '@deepseek-ai/dsh-compaction'
 import { splitConfig, resolveDcpConfig } from './config.js'
 import { summarizeDeterministically, noticeText } from './summarizer.js'
 import { registerDcpCommand } from './command.js'
+import { skillProvider } from './skill.js'
 
 const require = createRequire(import.meta.url)
 const { version: VERSION } = require('../package.json')
@@ -68,7 +69,8 @@ const kAppendNotice = Symbol('dsh-dcp.appendNotice')
 
 /**
  * Deterministic compaction engine: `summarize()` overridden, everything else
- * inherited. Registers the `/dcp` command beside the inherited `/compact`.
+ * inherited. Registers the `/dcp` command beside the inherited `/compact`,
+ * and serves the bundled usage/config guide through the host skill registry.
  */
 /** Element schema mirroring compaction-basic's model-policy override shape. */
 const modelPolicy = z.object({
@@ -85,7 +87,7 @@ const modelPolicy = z.object({
 })
 
 export class DcpEngine extends BasicCompactionEngine {
-  static inject = ['llm', 'tokenMeter', 'sessions', 'commands']
+  static inject = ['llm', 'tokenMeter', 'sessions', 'commands', 'skills']
 
   static Config = z.object({
     // compaction-basic policy keys (forwarded verbatim)
@@ -140,6 +142,15 @@ export class DcpEngine extends BasicCompactionEngine {
     this.dcpStats = { compactions: 0, shadowedTokens: 0, lastAt: null }
     this.pluginPath = fileURLToPath(import.meta.url)
     const engine = this
+    // Bundled usage/config guide. Soft-guarded: engines constructed in exotic
+    // hosts without the skill registry must still boot; losing the bundled
+    // guide is non-fatal. On the real host, `skills` in `static inject`
+    // guarantees the service is present (verified by scripts/smoke-boot.mjs).
+    try {
+      ctx?.skills?.registerProvider?.(() => skillProvider)
+    } catch {
+      // non-fatal — see comment above
+    }
     ctx.effect(function* () {
       yield registerDcpCommand(ctx, engine, VERSION)
     }, 'dsh-dcp /dcp command lifecycle')

package/lib/setup.js

@@ -11,8 +11,12 @@
  */
 import { readdirSync, readFileSync } from 'node:fs'
 
-/** The patch entry that disables the default LLM summarizer. */
+/** The patch entry that disables the default LLM summarizer. The `name` is
+ *  a guard, not an override: if a future host renames or drops the row, the
+ *  entry is skipped with a loader warning instead of silently disabling an
+ *  unrelated component (the same pattern dsh-tui-pi's patch uses). */
 const DISABLE_ENTRY = `- id: compaction-basic
+  name: '@deepseek-ai/dsh-compaction-basic'
   disabled: true`
 
 /** The dsh-dcp mount block, one YAML list item, appended to the file. */
@@ -93,3 +97,65 @@ export function backupStamp(date = new Date()) {
   const p = (n) => String(n).padStart(2, '0')
   return `${date.getFullYear()}${p(date.getMonth() + 1)}${p(date.getDate())}-${p(date.getHours())}${p(date.getMinutes())}`
 }
+
+/** The marker comment every setup-written mount block starts with. */
+const MOUNT_MARKER = 'added by @aiwayds/dsh-dcp setup'
+
+/**
+ * Reverse of planPatch/mountBlock: remove the setup-appended dsh-dcp mount
+ * block — the marker comment, the disable entry it added, and the insert
+ * item including any config the user tuned inside it — from one patch
+ * file's text. Hand-written mounts without the marker are NOT touched (the
+ * human wrote it; the human removes it); user entries after the block are
+ * preserved byte-for-byte.
+ *
+ * Uninstalling the package without this reverse step leaves the mount
+ * pointing at the vanished absolute entry path, which fails the profile's
+ * whole boot with a module-not-found error.
+ *
+ * @param {string|undefined} text - the patch file content.
+ * @returns {{ removed: boolean, text: string, note?: string }} `text` with
+ *   the block gone ('' when nothing else remains — the caller may delete the
+ *   file); `removed: false` leaves `text` untouched and sets `note`.
+ */
+export function planRemoval(text) {
+  if (!text) return { removed: false, text: text ?? '' }
+  const lines = text.split('\n')
+  const marker = lines.findIndex((line) => line.includes(MOUNT_MARKER))
+  if (marker === -1) {
+    return { removed: false, text, note: 'no setup-written dsh-dcp mount block found (hand-written mounts are left alone)' }
+  }
+  let i = marker + 1
+  let end = lines.length
+  let sawInsert = false
+  while (i < lines.length) {
+    const line = lines[i]
+    if (line === '') { i++; continue }
+    if (line.startsWith('- ')) {
+      // One top-level list item: the entry line plus its indented body (and
+      // any blank lines inside it the user added while tuning config). The
+      // split artifact after a final newline is EOF, not a blank to consume.
+      let j = i + 1
+      while (j < lines.length && (lines[j] === '' ? j < lines.length - 1 : lines[j].startsWith(' ') || lines[j].startsWith('\t'))) j++
+      if (line.startsWith('- insert')) {
+        sawInsert = true
+        end = j
+        break
+      }
+      i = j
+      continue
+    }
+    // Anything else at column 0 (a user comment or entry) ends our block.
+    end = i
+    break
+  }
+  if (!sawInsert) {
+    return { removed: false, text, note: 'the setup marker was found but the dsh-dcp insert item is missing — leaving the file untouched' }
+  }
+  let start = marker
+  // The block was appended with one leading blank line; take it so repeated
+  // mount/unmount cycles do not accumulate blank runs.
+  if (start > 0 && lines[start - 1].trim() === '') start -= 1
+  const remaining = [...lines.slice(0, start), ...lines.slice(end)].join('\n')
+  return { removed: true, text: remaining.trim() === '' ? '' : remaining }
+}

package/lib/skill.js

@@ -0,0 +1,98 @@
+/**
+ * Bundled usage/configuration skill for dsh-dcp.
+ *
+ * Ships `skills/dsh-dcp/SKILL.md` through `ctx.skills.registerProvider`
+ * (same mechanism as dsh-llm-proxy and dsh-vault): an agent asked to tune
+ * compaction, run `/dcp`, or persist a config change loads the guide
+ * automatically instead of guessing at key names and mount shapes.
+ *
+ * @module dsh-dcp/skill
+ */
+
+import { readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+
+// The runtime import of '@deepseek-ai/dsh-skill' is deliberately avoided:
+// the registry-published dsh-skill lib imports host-closure siblings
+// (@deepseek-ai/dsh-scope, dsh-llm — peers of it, but absent from a plugin
+// repo's own dependency graph), which dies under pnpm's isolated layout.
+// The host injects the real service at runtime; this module only hands it a
+// plain provider object.
+
+/** Mirrors dsh-skill's bundled-skill rank (a non-load-bearing ordering hint;
+ *  the constant is hardcoded there too). Local copy — see the note above
+ *  for why dsh-skill is not loaded at runtime here. */
+const BUNDLED_SKILL_RANK = 600
+
+/** Provider name under `ctx.skills`; doubles as the skill name. */
+export const SKILL_PROVIDER_NAME = 'dsh-dcp'
+
+/** Packaged skill body; `../skills/` resolves to the package root from lib/. */
+const SKILL_BODY_URL = new URL('../skills/dsh-dcp/SKILL.md', import.meta.url)
+
+/** Resource base served with the skill so its relative links resolve. */
+const SKILL_RESOURCE_BASE = {
+  kind: 'directory',
+  path: fileURLToPath(new URL('../skills/dsh-dcp/', import.meta.url)),
+}
+
+const SKILL_INVOCATION = { modelInvocable: true, userInvocable: true }
+
+/** Routing description; must stay identical to the SKILL.md frontmatter (asserted in tests). */
+export const SKILL_DESCRIPTION = 'dsh 压缩引擎插件（@aiwayds/dsh-dcp）使用与配置指南。凡涉及上下文压缩、/dcp 命令、压缩调参（阈值/密度/语言/轮数触发），或要配置 dcp 时先读本指南：/dcp 状态与 /dcp set 十个可调键、持久化到 cordis.patch.yml 挂载块 config: 段（dsh-dcp-setup 管理）、ask_user_question 调参向导、四类触发（压力/溢出/轮数/手动）、subagent 会话独立计数生效。触发词：dcp、压缩、compaction、上下文超限、摘要、thresholdRatio、roundInterval。'
+
+const SKILL_CANDIDATE = {
+  name: SKILL_PROVIDER_NAME,
+  description: SKILL_DESCRIPTION,
+  invocation: SKILL_INVOCATION,
+  provider: SKILL_PROVIDER_NAME,
+  source: 'bundled',
+  resourceBase: SKILL_RESOURCE_BASE,
+  rank: BUNDLED_SKILL_RANK,
+  locator: SKILL_BODY_URL,
+}
+
+/** The bundled-skill catalog entry, served through the host skill registry. */
+export const skillProvider = {
+  name: SKILL_PROVIDER_NAME,
+  list(_options) {
+    return Promise.resolve([SKILL_CANDIDATE])
+  },
+  async get(_candidate, _options) {
+    return {
+      name: SKILL_CANDIDATE.name,
+      description: SKILL_CANDIDATE.description,
+      invocation: SKILL_CANDIDATE.invocation,
+      provider: SKILL_CANDIDATE.provider,
+      source: SKILL_CANDIDATE.source,
+      resourceBase: SKILL_RESOURCE_BASE,
+      content: stripFrontmatter(await readFile(SKILL_BODY_URL, 'utf8')),
+    }
+  },
+}
+
+/**
+ * Strip a leading YAML frontmatter block (`---` / body / `---`) from a skill
+ * markdown file. `SkillDefinition.content` must be the instruction body after
+ * metadata removal — the same shape the filesystem provider serves — so the
+ * bundled SKILL.md, which keeps its frontmatter for the GitHub/manual install
+ * paths, has the block removed when served through `skillProvider.get`.
+ * Tolerant by design: input that does not open with a `---` line, or whose
+ * frontmatter block is never closed, is returned unchanged. Mirrors the
+ * delimiter semantics of the upstream skill-filesystem provider.
+ */
+export function stripFrontmatter(raw) {
+  const firstLineEnd = raw.indexOf('\n')
+  if (firstLineEnd < 0 || raw.slice(0, firstLineEnd).replace(/\r$/, '') !== '---') return raw
+  let lineStart = firstLineEnd + 1
+  while (lineStart <= raw.length) {
+    const nextNewline = raw.indexOf('\n', lineStart)
+    const lineEnd = nextNewline < 0 ? raw.length : nextNewline
+    if (raw.slice(lineStart, lineEnd).replace(/\r$/, '') === '---') {
+      return raw.slice(nextNewline < 0 ? raw.length : nextNewline + 1).trim()
+    }
+    if (nextNewline < 0) return raw
+    lineStart = nextNewline + 1
+  }
+  return raw
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-dcp",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Deterministic context-pruning compaction backend for dsh (DeepSeek Harness) — zero-LLM summaries, /dcp command, works out of the box. Design references Opencode-DCP/opencode-dynamic-context-pruning.",
   "type": "module",
   "main": "lib/index.js",
@@ -17,6 +17,7 @@
   "files": [
     "lib",
     "scripts",
+    "skills",
     "README.md",
     "README.en.md",
     "LICENSE",
@@ -61,6 +62,7 @@
     "@deepseek-ai/dsh-invariants": ">=0.1.2-rc.1",
     "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1",
     "@deepseek-ai/dsh-session": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.2-rc.1",
     "@deepseek-ai/dsh-token-meter": ">=0.1.2-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
@@ -95,6 +97,9 @@
     "@deepseek-ai/dsh-session": {
       "optional": true
     },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-token-meter": {
       "optional": true
     },

package/scripts/setup.mjs

@@ -20,11 +20,13 @@
  *   node scripts/setup.mjs                 # home patch
  *   node scripts/setup.mjs --profile tui   # tui profile's patch
  *   node scripts/setup.mjs /path/to/cordis.patch.yml
+ *   node scripts/setup.mjs --remove [...]  # reverse: remove the setup-written
+ *                                          # mount block (same target forms)
  */
 import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { planPatch, backupStamp, findBundledProfiles } from '../lib/setup.js'
+import { planPatch, planRemoval, hasEntry, isMounted, backupStamp, findBundledProfiles } from '../lib/setup.js'
 
 const PKG = '@aiwayds/dsh-dcp'
 const pkgRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)))
@@ -36,18 +38,53 @@ function home() {
 
 function parseArgs(argv) {
   const force = argv.includes('--force')
+  const remove = argv.includes('--remove')
   if (argv.includes('--profile')) {
     const index = argv.indexOf('--profile')
     const name = argv[index + 1]
     if (!name) throw new Error('setup: --profile requires a profile name')
-    return { target: path.join(home(), 'profiles', name, 'cordis.patch.yml'), kind: 'profile', profileName: name, force }
+    return { target: path.join(home(), 'profiles', name, 'cordis.patch.yml'), kind: 'profile', profileName: name, force, remove }
   }
   const explicit = argv.find((a) => !a.startsWith('-'))
-  if (explicit) return { target: path.resolve(explicit), kind: 'explicit', force }
-  return { target: path.join(home(), 'cordis.patch.yml'), kind: 'home', force }
+  if (explicit) return { target: path.resolve(explicit), kind: 'explicit', force, remove }
+  return { target: path.join(home(), 'cordis.patch.yml'), kind: 'home', force, remove }
+}
+
+const { target, kind, profileName, force, remove } = parseArgs(process.argv.slice(2))
+
+if (remove) {
+  const existed = fs.existsSync(target)
+  const text = existed ? fs.readFileSync(target, 'utf8') : undefined
+  if (!existed) {
+    console.log(`no ${target} — nothing to remove.`)
+    process.exit(0)
+  }
+  const plan = planRemoval(text)
+  if (!plan.removed) {
+    console.log(`dsh-dcp mount not removed from ${target}.`)
+    if (plan.note) console.log(`note: ${plan.note}`)
+    process.exit(0)
+  }
+  const backup = `${target}.bak.${backupStamp()}`
+  fs.copyFileSync(target, backup)
+  console.log(`backup: ${backup}`)
+  if (plan.text === '') {
+    fs.rmSync(target)
+    console.log(`removed ${target} (the file held nothing else)`)
+  } else {
+    fs.writeFileSync(target, plan.text)
+    console.log(`removed the dsh-dcp mount block from ${target}`)
+  }
+  if (plan.text !== '' && hasEntry(plan.text, 'compaction-basic')) {
+    console.warn('WARN: a compaction-basic entry remains in this patch file — the stock LLM summarizer stays disabled; remove that entry by hand if it was only for dsh-dcp.')
+  }
+  if (plan.text !== '' && isMounted(plan.text)) {
+    console.warn('WARN: another dsh-dcp mount remains in this patch file — leaving it alone.')
+  }
+  console.log('restart dsh to apply.')
+  process.exit(0)
 }
 
-const { target, kind, profileName, force } = parseArgs(process.argv.slice(2))
 const existed = fs.existsSync(target)
 const text = existed ? fs.readFileSync(target, 'utf8') : undefined
 if (!existed) console.log(`no ${target} — will generate a fresh patch file`)

package/scripts/smoke-boot.mjs

@@ -12,11 +12,16 @@
 //      as a file: dependency, and a cordis.patch.yml carrying the
 //      disable-compaction-basic + insert-dsh-dcp mount block
 //   3. pnpm install in the profile
-//   4. `dsh --profile smoke --dump-config` must compose dsh-dcp into the tree
-//      (mount/patch-layer proof)
-//   5. a real boot under a timeout must load the plugin tree without a loader
-//      error (a healthy boot is silent and survives to the kill signal; a
-//      broken plugin dies within ~1s with the loader error)
+//   4. Phase A: setup.mjs mounts the profile patch (marker block), the
+//      composed tree carries dsh-dcp with compaction-basic disabled, then
+//      `setup.mjs --remove` strips it and the recomposed tree is back to
+//      stock (this is what breaks a profile when the package is removed
+//      without the reverse step)
+//   5. Phase B: a hand-written mount pointing into the installed tarball —
+//      the true user shape — composes, and a real boot under a timeout must
+//      load the plugin tree without a loader error (a healthy boot is silent
+//      and survives to the kill signal; a broken plugin dies within ~1s with
+//      the loader error)
 //
 // The dsh CLI comes from $DSH_BIN if set (e.g. a scratch alpha closure:
 // DSH_BIN=~/tmp/dsh-alpha-closure/node_modules/@deepseek-ai/dsh/lib/bin.js),
@@ -57,18 +62,9 @@ if (pack.status !== 0 || pack.error) fail('npm pack failed', `${pack.stdout}\n${
 const tarball = path.join(work, pack.stdout.trim().split('\n').at(-1) ?? '')
 
 writeFileSync(path.join(profile, 'cordis.yml'), '# dsh profile root — empty; the tree is composed from the bundle patches\n[]\n')
-// The mount layer under test — isomorphic with scripts/setup.mjs's output:
-// compaction-basic disabled, dsh-dcp inserted by absolute entry path.
-writeFileSync(path.join(profile, 'cordis.patch.yml'), `# scratch smoke profile: dsh-dcp mounted the setup.mjs way
-- id: compaction-basic
-  disabled: true
-- insert:
-    - id: ${entryId}
-      name: ${path.join(profile, 'node_modules', '@aiwayds', 'dsh-dcp', 'lib', 'index.js')}
-      config:
-        thresholdRatio: 0.7
-        language: zh
-`)
+// The patch file starts EMPTY: Phase A below drives the full setup.mjs
+// mount → remove lifecycle against it, then Phase B hand-writes the mount
+// (isomorphic with setup.mjs's output) for the real-boot proof.
 writeFileSync(path.join(profile, 'pnpm-workspace.yaml'), 'packages:\n  - .\n\nnodeLinker: hoisted\nautoInstallPeers: false\n')
 writeFileSync(path.join(profile, 'package.json'), JSON.stringify({
   name: 'dsh-profile-smoke',
@@ -90,8 +86,47 @@ writeFileSync(path.join(profile, 'package.json'), JSON.stringify({
 const install = spawnSync('pnpm', ['install'], { cwd: profile, encoding: 'utf8' })
 if (install.status !== 0 || install.error) fail('pnpm install in the scratch profile failed', `${install.stdout}\n${install.stderr}`)
 
-// Phase 1 — mount proof: the composed tree must carry the dsh-dcp entry, with
-// compaction-basic disabled rather than removed-by-default.
+// Phase A — the setup.mjs lifecycle: mount → compose → remove → stock tree.
+// This is the exact pair of commands a standalone user runs (`npx dsh-dcp-setup`
+// and its `--remove`), against the profile patch file they target.
+const patchFile = path.join(profile, 'cordis.patch.yml')
+const setup = spawnSync(process.execPath, [path.join(repoRoot, 'scripts', 'setup.mjs'), patchFile], { encoding: 'utf8' })
+if (setup.status !== 0 || setup.error) fail('setup.mjs mount failed', `${setup.stdout}\n${setup.stderr}`)
+const dumpMounted = dsh(['--profile', 'smoke', '--dump-config'])
+if (dumpMounted.status !== 0 || dumpMounted.error) fail('dsh --dump-config failed on the setup-mounted profile', `${dumpMounted.stdout}\n${dumpMounted.stderr}`)
+if (!dumpMounted.stdout.includes(entryId) || !/compaction-basic\n(  name: .*\n)?  disabled: true/.test(dumpMounted.stdout)) {
+  fail('the setup-mounted tree does not carry dsh-dcp with compaction-basic disabled', dumpMounted.stdout)
+}
+const remove = spawnSync(process.execPath, [path.join(repoRoot, 'scripts', 'setup.mjs'), '--remove', patchFile], { encoding: 'utf8' })
+if (remove.status !== 0 || remove.error) fail('setup.mjs --remove failed', `${remove.stdout}\n${remove.stderr}`)
+const dumpAfter = dsh(['--profile', 'smoke', '--dump-config'])
+if (dumpAfter.status !== 0 || dumpAfter.error) fail('dsh --dump-config failed after removal', `${dumpAfter.stdout}\n${dumpAfter.stderr}`)
+if (dumpAfter.stdout.includes(entryId)) {
+  fail(`the composed tree still contains the "${entryId}" entry after removal`, dumpAfter.stdout)
+}
+if (/compaction-basic\n(  name: .*\n)?  disabled: true/.test(dumpAfter.stdout)) {
+  fail('compaction-basic is still disabled after removal — the stock backend did not come back', dumpAfter.stdout)
+}
+if (!dumpAfter.stdout.includes('compaction-basic')) {
+  fail('compaction-basic vanished from the composed tree after removal', dumpAfter.stdout)
+}
+console.log('smoke-boot: setup.mjs mount → remove lifecycle restored the stock tree')
+
+// Phase B — mount proof: the composed tree must carry the dsh-dcp entry, with
+// compaction-basic disabled rather than removed-by-default. The hand-written
+// mount points INTO the installed tarball (the true user shape), so the boot
+// below exercises the packed artifact.
+writeFileSync(path.join(profile, 'cordis.patch.yml'), `# scratch smoke profile: dsh-dcp mounted the setup.mjs way
+- id: compaction-basic
+  name: '@deepseek-ai/dsh-compaction-basic'
+  disabled: true
+- insert:
+    - id: ${entryId}
+      name: ${path.join(profile, 'node_modules', '@aiwayds', 'dsh-dcp', 'lib', 'index.js')}
+      config:
+        thresholdRatio: 0.7
+        language: zh
+`)
 const dump = dsh(['--profile', 'smoke', '--dump-config'])
 if (dump.status !== 0 || dump.error) fail('dsh --dump-config failed on the scratch profile', `${dump.stdout}\n${dump.stderr}`)
 if (!dump.stdout.includes(entryId)) {
@@ -118,5 +153,5 @@ if (boot.signal !== 'SIGKILL' && boot.status !== 0) {
   fail(`dsh exited early with code ${boot.status} and no loader error — unexpected`, output)
 }
 
-console.log(`smoke-boot: PASS — ${ownName} mounted via cordis.patch.yml (compaction-basic disabled), composed into the scratch profile tree, and booted clean in real dsh (${boot.signal === 'SIGKILL' ? `survived ${bootSeconds}s boot window` : `exited ${boot.status}`})`)
+console.log(`smoke-boot: PASS — ${ownName} mounted via cordis.patch.yml (compaction-basic disabled), composed into the scratch profile tree, booted clean in real dsh (${boot.signal === 'SIGKILL' ? `survived ${bootSeconds}s boot window` : `exited ${boot.status}`}); setup mount → remove lifecycle restored the stock tree`)
 rmSync(work, { recursive: true, force: true })

package/skills/dsh-dcp/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: dsh-dcp
+description: "dsh 压缩引擎插件（@aiwayds/dsh-dcp）使用与配置指南。凡涉及上下文压缩、/dcp 命令、压缩调参（阈值/密度/语言/轮数触发），或要配置 dcp 时先读本指南：/dcp 状态与 /dcp set 十个可调键、持久化到 cordis.patch.yml 挂载块 config: 段（dsh-dcp-setup 管理）、ask_user_question 调参向导、四类触发（压力/溢出/轮数/手动）、subagent 会话独立计数生效。触发词：dcp、压缩、compaction、上下文超限、摘要、thresholdRatio、roundInterval。"
+---
+
+# dsh-dcp 使用指南（确定性上下文压缩）
+
+> dsh 插件：替换官方 `compaction-basic` 的确定性压缩引擎——**零 LLM 调用**
+> （去重 / 折错 / 密度控制），中文场景优先（CJK 计价、中文报错与"待办："识别），
+> 附轮数触发。压力触发、保留尾巴、溢出恢复、tool-pairing 安全机制全部继承官方，只替换"摘要"这一环。
+
+## 配置入口（两条路）
+
+1. **会话内临时调参**：`/dcp set <键> <值>`，只影响当前会话，重启失效。十个可调键：
+   `dedup` `purgeErrors` `maxItems` `maxItemChars` `maxSummaryTokens` `language`
+   `tokenEstimate` `thresholdRatio` `roundInterval` `notice`。
+2. **持久化**：cordis.patch.yml 里 dsh-dcp 挂载块的 `config:` 段。用
+   `npx dsh-dcp-setup` 写入并维护（带 marker 注释、改动前日期备份、幂等）；
+   `--remove` 只删 setup 写的块，手工写的块不受影响。bundle 方式
+   （`dsh plugin add @aiwayds/dsh-dcp` 或列在 profile `bundles`）自动挂载，无需手写 patch。
+
+挂载块形状（`~/.dsh/cordis.patch.yml` 或某个 profile 的 cordis.patch.yml）：
+
+```yaml
+- id: compaction-basic
+  name: '@deepseek-ai/dsh-compaction-basic'
+  disabled: true
+- insert:
+    - id: dsh-dcp
+      name: '@aiwayds/dsh-dcp'
+      config:
+        thresholdRatio: 0.7   # 每个键都可选
+        language: zh
+```
+
+## 配置键
+
+dsh-dcp 自有键（除 `thresholdRatio` 外全部可用 `/dcp set` 调）：
+
+| 键 | 默认 | 说明 |
+|---|---|---|
+| `dedup` | `true` | 重复工具调用折叠成一条标注 |
+| `purgeErrors` | `true` | 旧报错折叠成一条提示 |
+| `maxItems` / `maxItemChars` | 10 / 200 | 摘要密度（条数 / 单条字符上限） |
+| `maxSummaryTokens` | 2048 | 摘要 token 预算 |
+| `language` | `en`（代码默认；bundle 挂载默认 `zh`） | 摘要语言；`zh` 额外识别中文报错和"待办：" |
+| `tokenEstimate` | `cjk` | CJK（中/日/韩/全角）按 ~2 字符/token 计价；`ascii` 与宿主一致 |
+| `protectedTools` | `['write', 'edit', 'apply_patch']` | 写侧工具（子串匹配）的重复调用不折叠进 dedup 标注 |
+| `roundInterval` | 50 | 每 N 条 assistant message（一次 LLM 往返）触发一次压缩；`0` 关闭 |
+| `notice` | `true` | 压缩后在会话追加一行通知 |
+
+转发上游 compaction-basic 的策略键：`thresholdRatio`（上游默认 0.8；**本插件 bundle 挂载默认 0.7**，中文场景建议 0.7）、`retainRatio`、`retainTokens`、`maxTokens`、`summarizationProvider`、`summarizationModel`、`compactionRetries`、`maxOverflowRetries`、`modelPolicies`、`auto`。
+
+## 交互式调参向导（ask_user_question）
+
+用户抱怨压缩行为时，不要甩配置表让对方自己读——先用 `ask_user_question`
+问清期望，再映射到键：
+
+1. **触发时机**：更晚触发 → `thresholdRatio` 调高，或 `roundInterval` 调大
+   （完全不想要轮数触发 → `roundInterval: 0`）；更早/更频繁 → 反向。
+2. **摘要密度**：更细 → `maxItems` / `maxItemChars` 调大（预算不够再加
+   `maxSummaryTokens`）；更省 → 调小。
+3. **摘要语言** → `language: en|zh`。
+4. **token 计价** → `tokenEstimate: cjk|ascii`。
+5. **通知行** → `notice: on|off`。
+
+流程：先用 `/dcp set <键> <值>` 在会话内试效果，满意后再代写持久 config——
+直接改 cordis.patch.yml 里 dsh-dcp 挂载块的 `config:` 段（setup 写的块可原位改，marker 保留）。
+
+## 触发条件（四类）
+
+| 触发 | 时机 | 说明 |
+|---|---|---|
+| 压力 | 每步请求前 | token ≥ `thresholdRatio` × 上下文窗口 |
+| 溢出 | 模型报 context 超限 | 继承官方恢复流程 |
+| 轮数 | 每累计 `roundInterval` 条 assistant message | 任何一次压缩（含压力/手动）都重置时钟；`0` 关闭；需保持 `auto: true`（默认开） |
+| 手动 | `/dcp compact`、`/compact` | 随时可用 |
+
+- **subagent 同样生效**：进程内子代理（含 continuable 与 one-shot）走同一套事件分发，
+  压力/溢出/轮数对每个会话独立计数、独立触发。
+- `notice` 通知行本身也是上下文（每次压缩约 15–25 tokens）；`notice: false` 可关。
+
+## 排障
+
+1. `/dcp`（无参数）看状态：当前配置、压缩次数、省下的 LLM 调用，以及
+   per-session 概览（含子代理；已销毁的会话自动消失，列表最多前 10 个，超出显示 `+N more`）。
+2. 会话压不动 → 先确认 `auto` 是否为 `true`（自动触发总开关，默认开），再看
+   `thresholdRatio` 是否设得过高、`roundInterval` 是否为 `0`。
+3. `npx dsh-dcp-setup --remove` 后出现 `WARN: a compaction-basic entry remains...` →
+   patch 文件里还留着 disable 行，官方 LLM 压缩后端会保持关闭；不是给 dsh-dcp 用的
+   就手动删掉那一行。