dsh-host-plugin-kit 0.1.1 → 0.2.0

package/README.md

@@ -1,57 +1,66 @@
 # dsh-host-plugin-kit
 
-一条命令生成 **DSH host 侧插件骨架**，自带三层验证（离线单测 / 真 cordis 冒烟 / 发布路径说明）与审批钩子模板。
+DSH（DeepSeek Harness）**host 侧插件脚手架**，0.2.0 起是 **CLI + 宿主插件双形态**：
+一条命令生成带三层验证的插件骨架；装进 DSH 后还能让 agent 直接用 `plugin_kit_new` 工具搭骨架，不用开 shell。
 
-面向 **Android 上的 DSH**（没有 Web Client 层，插件只能贡献 host 侧：工具、服务、事件、SKILL、MCP 桥）。
+## 为什么要插件形态
 
-> 名字里的 host 是刻意的：npm 上的 `dsh-host-plugin-kit` 是另一套（客户端 bundle 生成 + verify），
-> 与这套「host 侧工具插件骨架 + 三层测试」不是一回事。
+市场（awesome-dsh-plugin.com）的收录门槛是 `package.json` 里的 `dsh.bundle.patch`（2026-11-11 查 contributing 核实）。
+0.1.x 只有 `bin`，是脚手架 CLI、不是插件形态，市场收不了。0.2.0 把同一份生成逻辑包成 host 侧工具：
 
-## 用法
+- 没有 `dsh.client` —— 不依赖任何 UI slot（Android 引擎没有 Web Client 层，带 client 的装了不渲染）；
+- `inject` 只有 `['tools']` —— 不碰本机没有的 `webServer`（否则 cordis 会静默挂起插件）；
+- 数据源是本地 fs —— 生成的是源码文件，不靠 git / 端口 / 外部服务。
 
-```sh
-node new.mjs ~/work/my-plugin --name dsh-hello --desc "示例插件" [--prefix hello]
+## 工具（插件形态）
+
+| 工具 | 风险 | 作用 |
+|---|---|---|
+| `plugin_kit_new` | 写盘（走审批） | 在指定目录生成插件骨架（10 个文件），返回三层验证的跑法 |
+
+写类工具在 `tools/pre-execute` 里把 `allow` 升级成 `ask`，**不改写上游 `deny`**。
 
-cd ~/work/my-plugin
-node dev/test.mjs         # 6 项离线单测
-node host-test/rt.mjs     # 5 项真 cordis 冒烟（用引擎自带的那份 cordis）
+```yaml
+# 装好后写进 profile 的 cordis.patch.yml（name 用包名或绝对路径，不要写 !!js）
+- insert:
+    - id: plugin_kit
+      name: dsh-host-plugin-kit
+      config: {}
 ```
 
-生成物：
+## CLI 形态
 
-| 文件 | 作用 |
-|---|---|
-| `index.mjs` | 注册工具（`ctx.effect` 内）、挂 `tools/pre-execute` 审批钩子 |
-| `lib/core.mjs` | 业务逻辑，纯函数好测 |
-| `cordis.patch.yml` | profile 的 insert 片段 |
-| `package.json` | `dsh.bundle.patch` + 最小 `capabilities` |
-| `dev/test.mjs` | 假 ctx 单测：注册、execute、审批 allow→ask、deny 不改写 |
-| `host-test/rt.mjs` | 真 `@deepseek-ai/cordis`：inject、注册、execute、钩子、`dispose` 清理 |
-| `locale/`、`icon.svg`、`README.md` | 插件三件套 |
+```sh
+node new.mjs <目标目录> --name dsh-hello [--desc "一句话"] [--prefix hello]
+# 或装到干净目录后：node node_modules/dsh-host-plugin-kit/new.mjs <目标目录> --name dsh-hello
+```
 
-## 生成的骨架遵守的约定
+生成的 10 个文件：`package.json`（含 `dsh.bundle`）/ `index.mjs`（工具注册 + 审批钩子）/ `lib/core.mjs` /
+`cordis.patch.yml` / `icon.svg` / `locale/zh-CN.json` / `dev/test.mjs` / `host-test/rt.mjs` / `README.md` / `.gitignore`。
 
-1. `export const name / inject / apply`；
-2. 工具在 `ctx.effect` 里注册并返回 dispose（卸载要干净，有测试）；
-3. 写类工具把 `allow` 升级为 `ask`，**上游 `deny` 不许改写**（有测试）；
-4. 纯逻辑放 `lib/`，`index.mjs` 只做协议适配。
+生成内容只由 `{name, desc, prefix}` 决定 → **同参数必然同字节**，回归测试直接比文件。
 
-## 在这台手机上发布
+## 三层验证（本包自己也按这个跑）
 
-```sh
-# npm：新包首发先进 staged 状态，40–120 s 后才可见；发完务必下载 tarball 实际加载验证
-node $HOME/tools/npm/bin/npm-cli.js publish
+| 层 | 文件 | 验什么 |
+|---|---|---|
+| L1 离线单测 | `node dev/test.mjs` | 纯逻辑、落盘结果、工具面、审批钩子、dispose（14 项） |
+| L2 真 cordis | `node $HOME/work/host-test/rt-plugin-kit.mjs` | 用引擎那份 cordis 加载：注册 / 执行 / 钩子 / dispose（5 项） |
+| L3 部署检查 | `node dev/verify-patch.mjs [patch]` | 引擎同款解析器（js-yaml + `!!js` 标量）读 patch，断言 `name` 是普通字符串、引用文件都在（7 项） |
+| 脚手架自测 | `node dev/bin-selftest.mjs` | 生成一个临时插件，再跑它自己的 L1 / L2（4 项） |
 
-# GitHub：本机没有 git，走 REST API 一次成 commit
-node $HOME/work/gitpub/publish-github.mjs --dir . --owner <you> --repo dsh-hello --token-file $HOME/.gh_token
-```
+## 已知检查器偏差（别为绿灯改声明）
 
-装插件时**带版本号**（`dsh-hello@0.1.0`），否则会遇到「裸名字 spec 永远没有更新徽标」的坑。
+`dsh-standards` 的 `C-11.5` 只认 `ctx.fs` 触发的 capability 声明，本包写盘走 `node:fs`（在 `lib/scaffold.mjs`），
+所以 `fs:write` / `fs:read` **必然报 WARN**。实测：`--scope entry --entry-claim runtime` 下 10 项 PASS、
+2 项 WARN（C-11.5 上述盲点 + C-8.2 的 cordis 版本错位，本机 cordis 4.0.5 没有 `_revision` 字段）、0 项 FAIL。
+真实声明保留，不为了让检查器变绿而删。
 
-## 自测
+## 契约
 
-```sh
-node dev/bin-selftest.mjs   # 生成一个临时插件并跑它的两套测试
-```
+- `inject: ['tools']`，工具在 `ctx.effect` 里注册并返回 dispose（写成 `() => off()` 会当场卸载）；
+- 写类工具只把 `allow` 升级成 `ask`，不改写 `deny`；
+- `dsh.capabilities` 按实际用到的最小集合声明；
+- `name` 必须是普通字符串，`!!js` 只能用在 entry 的 `config` 里求值。
 
 MIT

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# 把本插件插进 profile 的层栈。App 里安装后重启引擎生效。
+# name 用包名（装好后由 Loader 解析），不要写 !!js —— 表达式只在 entry 的 config 里求值。
+- insert:
+    - id: plugin_kit
+      name: dsh-host-plugin-kit
+      config: {}

package/dev/test.mjs

@@ -0,0 +1,152 @@
+// L1 离线单测：不联网、不碰真引擎。验纯逻辑 + 落盘结果 + 插件工具面。
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { buildFiles, scaffold, NAME_RE } from '../lib/scaffold.mjs';
+import * as plugin from '../index.mjs';
+
+let pass = 0;
+const fails = [];
+const t = async (label, fn) => {
+  try { await fn(); pass++; console.log('  ok   ' + label); }
+  catch (e) { fails.push(label); console.log('  FAIL ' + label + ' — ' + e.message); }
+};
+
+/** 找一个真能写的临时目录：先看环境变量，再退 home（手机上 /tmp 不可写）。 */
+function mkTmp(tag) {
+  const cands = [process.env.KIT_TEST_TMP, process.env.TMPDIR, os.tmpdir(), path.join(os.homedir(), 'work', 'tmpdir')].filter(Boolean);
+  for (const c of cands) {
+    try { fs.mkdirSync(c, { recursive: true }); return fs.mkdtempSync(path.join(c, tag)); } catch {}
+  }
+  throw new Error('没有可写的临时目录');
+}
+
+const ARGS = { name: 'dsh-probe', desc: '探针插件', prefix: 'probe' };
+
+await t('buildFiles 是纯函数：同参数两次逐字节相同', () => {
+  const a = buildFiles(ARGS), b = buildFiles(ARGS);
+  assert.deepEqual(Object.keys(a).sort(), Object.keys(b).sort());
+  for (const k of Object.keys(a)) assert.equal(a[k], b[k], k + ' 不一致');
+});
+
+await t('生成 10 个文件，关键文件齐全', () => {
+  const f = buildFiles(ARGS);
+  assert.equal(Object.keys(f).length, 10);
+  for (const k of ['package.json', 'index.mjs', 'lib/core.mjs', 'cordis.patch.yml', 'dev/test.mjs', 'host-test/rt.mjs', 'README.md', 'icon.svg', 'locale/zh-CN.json', '.gitignore']) {
+    assert.ok(k in f, '缺 ' + k);
+  }
+});
+
+await t('生成的 package.json 带 dsh.bundle.patch，且没有 dsh.client（手机渲染不了）', () => {
+  const pkg = JSON.parse(buildFiles(ARGS)['package.json']);
+  assert.equal(pkg.dsh.bundle.patch, './cordis.patch.yml');
+  assert.ok(Array.isArray(pkg.dsh.capabilities) && pkg.dsh.capabilities.length > 0);
+  assert.equal(pkg.dsh.client, undefined);
+});
+
+await t('scaffold 真落盘，并返回写出的文件清单', () => {
+  const dir = path.join(mkTmp('kit-l1-'), 'probe');
+  const r = scaffold({ target: dir, ...ARGS });
+  assert.equal(r.files.length, 10);
+  for (const rel of r.files) assert.ok(fs.existsSync(path.join(dir, rel)), rel + ' 没写出来');
+  assert.equal(JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')).name, 'dsh-probe');
+});
+
+await t('scaffold 拒绝覆盖已存在的插件目录', () => {
+  const dir = path.join(mkTmp('kit-l1-'), 'dup');
+  scaffold({ target: dir, ...ARGS });
+  assert.throws(() => scaffold({ target: dir, ...ARGS }), /已经有 package.json/);
+});
+
+await t('默认 desc / prefix：dsh-hello → 工具前缀 hello', () => {
+  const dir = path.join(mkTmp('kit-l1-'), 'dsh-hello');
+  scaffold({ target: dir, name: 'dsh-hello' });
+  const idx = fs.readFileSync(path.join(dir, 'index.mjs'), 'utf8');
+  assert.match(idx, /hello_hello/);
+  assert.match(idx, /hello_write/);
+  assert.match(fs.readFileSync(path.join(dir, 'README.md'), 'utf8'), /dsh-hello：一个 DSH 插件/);
+});
+
+await t('包名校验拒绝大写与空格', () => {
+  assert.equal(NAME_RE.test('dsh-good_1.2'), true);
+  assert.equal(NAME_RE.test('Bad Name'), false);
+  assert.throws(() => scaffold({ target: path.join(mkTmp('kit-l1-'), 'x'), name: 'Bad Name' }), /包名只能/);
+});
+
+await t('插件导出面：name / inject / apply', () => {
+  assert.equal(plugin.name, 'plugin_kit');
+  assert.deepEqual(plugin.inject, ['tools']);
+  assert.equal(typeof plugin.apply, 'function');
+  assert.equal(plugin.Config, undefined, '不能导出 Config');
+});
+
+const makeCtx = () => {
+  const registered = new Map();
+  const disposers = [];
+  const hooks = [];
+  const ctx = {
+    logger: () => ({ info() {}, warn() {} }),
+    effect: (fn) => { const d = fn(); if (typeof d === 'function') disposers.push(d); return d || (() => {}); },
+    on: (ev, fn) => { hooks.push([ev, fn]); },
+    tools: { register: (d) => { registered.set(d.name, d); return () => registered.delete(d.name); }, get: (n) => registered.get(n) },
+  };
+  plugin.apply(ctx, {});
+  return { ctx, registered, hooks, disposers };
+};
+
+await t('注册 1 个工具 plugin_kit_new，且带 risk 政策行', () => {
+  const { registered } = makeCtx();
+  assert.deepEqual([...registered.keys()], ['plugin_kit_new']);
+  assert.match(registered.get('plugin_kit_new').description, /\[risk: write/);
+});
+
+await t('工具真能执行：写到临时目录', async () => {
+  const { registered } = makeCtx();
+  const dir = path.join(mkTmp('kit-l1-'), 'dsh-from-tool');
+  const res = await registered.get('plugin_kit_new').execute({ dir, desc: '工具生成' });
+  const out = res.content[0].text;
+  assert.match(out, /已生成 10 个文件/);
+  assert.match(out, /dev\/test\.mjs/);
+  assert.ok(fs.existsSync(path.join(dir, 'cordis.patch.yml')));
+});
+
+await t('工具错误路径都变成可读文本，不抛', async () => {
+  const { registered } = makeCtx();
+  const tool = registered.get('plugin_kit_new');
+  assert.match((await tool.execute({})).content[0].text, /dir 不能为空/);
+  assert.match((await tool.execute({ dir: 'relative/path' })).content[0].text, /必须是绝对路径/);
+  const dir = path.join(mkTmp('kit-l1-'), 'again');
+  await tool.execute({ dir, desc: 'x' });
+  assert.match((await tool.execute({ dir, desc: 'x' })).content[0].text, /已经有 package.json/);
+});
+
+await t('~ 展开到 home', async () => {
+  const { registered } = makeCtx();
+  const rel = 'kit-l1-home-' + Date.now();
+  const res = await registered.get('plugin_kit_new').execute({ dir: '~/' + rel, desc: 'x' });
+  const dir = path.join(os.homedir(), rel);
+  assert.match(res.content[0].text, /已生成 10 个文件/);
+  assert.ok(fs.existsSync(path.join(dir, 'package.json')));
+  fs.rmSync(dir, { recursive: true, force: true });
+});
+
+await t('审批钩子：allow→ask（只对本工具），deny 不被动', async () => {
+  const { hooks } = makeCtx();
+  const [, fn] = hooks.find(([ev]) => ev === 'tools/pre-execute');
+  assert.ok(fn, '没有挂 pre-execute');
+  const allow = async () => ({ kind: 'allow' });
+  assert.equal((await fn({ name: 'plugin_kit_new', arguments: { dir: '/x' } }, allow)).kind, 'ask');
+  assert.equal((await fn({ name: 'plugin_kit_new', arguments: { dir: '/x' } }, async () => ({ kind: 'deny' }))).kind, 'deny');
+  assert.equal((await fn({ name: 'other_tool', arguments: {} }, allow)).kind, 'allow');
+});
+
+await t('dispose 后工具被摘掉', () => {
+  const { registered, disposers } = makeCtx();
+  assert.equal(registered.size, 1);
+  for (const d of disposers) d();
+  assert.equal(registered.size, 0);
+});
+
+console.log(`\n通过 ${pass} 项${fails.length ? `，失败 ${fails.length} 项：${fails.join(' / ')}` : ''}`);
+process.exit(fails.length ? 1 : 0);

package/dev/verify-patch.mjs

@@ -0,0 +1,95 @@
+// L3 部署检查：用引擎同款解析器（js-yaml + !!js 标量）读本包的 cordis.patch.yml，
+// 断言行里的 name 是普通字符串（写成 !!js 表达式会让引擎起不来）、引用的文件都在。
+// 只读，不改任何文件。退出码：0 全过 / 1 有 FAIL / 2 环境不对（找不到引擎 js-yaml）。
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+
+const PKG = import.meta.dirname ? path.join(import.meta.dirname, '..') : process.cwd();
+const HOME = process.env.HOME;
+const DSH_HOME = process.env.DSH_HOME || (HOME ? path.join(HOME, '..', 'dsh-home') : null);
+const patchPath = process.argv.slice(2).find((a) => !a.startsWith('--')) || path.join(PKG, 'cordis.patch.yml');
+
+function engineModules() {
+  if (process.env.DSH_ENGINE_NODE_MODULES) return process.env.DSH_ENGINE_NODE_MODULES;
+  if (!DSH_HOME) return null;
+  const root = path.join(DSH_HOME, '..', 'engine');
+  let dirs = [];
+  try { dirs = fs.readdirSync(root); } catch { return null; }
+  for (const d of dirs) {
+    const cand = path.join(root, d, 'node_modules');
+    if (fs.existsSync(path.join(cand, 'js-yaml'))) return cand;
+  }
+  return null;
+}
+
+const ENGINE = engineModules();
+if (!ENGINE) {
+  console.error('verify-patch: 找不到引擎 node_modules（设 DSH_ENGINE_NODE_MODULES，或保证 DSH_HOME 旁边有 engine/<hash>/node_modules）');
+  process.exit(2);
+}
+const require = createRequire(path.join(ENGINE, 'js-yaml/package.json'));
+const yaml = require(path.join(ENGINE, 'js-yaml'));
+
+const JsExpr = new yaml.Type('tag:yaml.org,2002:js', {
+  kind: 'scalar',
+  resolve: (d) => typeof d === 'string',
+  construct: (d) => ({ __jsExpr: d }),
+});
+
+const R = [];
+const ok = (name, detail = '') => R.push({ level: 'ok', name, detail });
+const fail = (name, detail = '') => R.push({ level: 'fail', name, detail });
+
+let doc = null;
+try {
+  doc = yaml.load(fs.readFileSync(patchPath, 'utf8'), { schema: yaml.JSON_SCHEMA.extend(JsExpr) });
+  ok('patch 能被引擎同款解析器解析', path.basename(patchPath));
+} catch (error) {
+  fail('patch 解析失败', String(error?.message ?? error));
+}
+
+const pkgPath = path.join(PKG, 'package.json');
+let pkg = null;
+try { pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')); ok('package.json 可解析'); }
+catch (error) { fail('package.json 解析失败', String(error?.message ?? error)); }
+
+if (doc) {
+  if (!Array.isArray(doc)) fail('顶层必须是数组');
+  const rows = (Array.isArray(doc) ? doc : []).flatMap((e) => e?.insert ?? []);
+  if (!rows.length) fail('没有任何 insert 行');
+  for (const row of rows) {
+    const name = row?.name;
+    if (typeof name !== 'string') fail(`行 ${row?.id ?? '?'} 的 name 不是字符串`, JSON.stringify(name)?.slice(0, 40));
+    else ok(`行 ${row.id ?? '?'} 的 name 是字符串`, name);
+    if (row?.config && typeof row.config !== 'object') fail(`行 ${row?.id ?? '?'} 的 config 不是对象`);
+  }
+}
+
+if (pkg) {
+  const bundle = pkg.dsh?.bundle?.patch;
+  if (!bundle) fail('package.json 缺 dsh.bundle.patch（市场收录门槛）');
+  else if (!fs.existsSync(path.join(PKG, bundle))) fail('dsh.bundle.patch 指向的文件不存在', bundle);
+  else ok('dsh.bundle.patch 指向的文件存在', bundle);
+  if (pkg.dsh?.client) fail('dsh.client 存在：Android 引擎没有 Web Client 层，装了不渲染', JSON.stringify(pkg.dsh.client));
+  else ok('没有 dsh.client（手机侧纯 host）');
+  const entry = pkg.exports?.['.'] ?? pkg.main;
+  if (!entry) fail('没有 main / exports["."]');
+  else if (!fs.existsSync(path.join(PKG, entry))) fail('入口文件不存在', entry);
+  else ok('入口文件存在', entry);
+  for (const [k, v] of Object.entries(pkg.exports ?? {})) {
+    if (typeof v !== 'string' || k === '.' || v.startsWith('./package.json')) continue;
+    if (!fs.existsSync(path.join(PKG, v))) fail(`exports["${k}"] 指向的文件不存在`, v);
+  }
+  if (Array.isArray(pkg.dsh?.capabilities) && pkg.dsh.capabilities.includes('fs:write')) {
+    const src = fs.readFileSync(path.join(PKG, entry || 'index.mjs'), 'utf8');
+    if (!/writeFileSync|writeFile/.test(src) && !/writeFileSync/.test(fs.readFileSync(path.join(PKG, 'lib/scaffold.mjs'), 'utf8'))) {
+      fail('声明了 fs:write 但入口没看到写盘调用');
+    } else ok('fs:write 声明与实现一致');
+  }
+}
+
+for (const r of R) console.log(`${r.level === 'ok' ? 'ok  ' : 'FAIL'}  ${r.name}${r.detail ? ' · ' + r.detail : ''}`);
+const bad = R.filter((r) => r.level === 'fail').length;
+console.log(`\n${bad ? '❌' : '✅'} ${R.length - bad} 过 / ${bad} 挂`);
+process.exit(bad ? 1 : 0);

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#1f3b57"/>
+  <rect x="14" y="18" width="36" height="10" rx="3" fill="#fff" opacity="0.92"/>
+  <rect x="14" y="34" width="22" height="10" rx="3" fill="#7fd1a8"/>
+  <rect x="40" y="34" width="10" height="10" rx="3" fill="#f2c14e"/>
+</svg>

package/index.mjs

@@ -0,0 +1,98 @@
+// dsh-host-plugin-kit —— 宿主插件形态（0.2.0 起）。
+//
+// 为什么要有这一层：市场收录的门槛是 package.json 里的 dsh.bundle.patch
+// （2026-11-11 查 awesome-dsh-plugin 的 contributing 核实）。只有 bin CLI 的包不是插件形态，
+// 市场收不了；插件化之后同一个能力在 agent 侧变成工具——不开 shell 也能"搭个插件骨架"。
+//
+// 为什么手机上能跑（Android 引擎没有 Web Client 层）：
+//   · 没有 dsh.client —— 不依赖任何 UI slot，装了不会"看不见"；
+//   · inject 只有 ['tools'] —— 不碰本机没有的 webServer（否则 cordis 会静默挂起）；
+//   · 数据源是本地 fs —— 生成的是源码文件，不靠 git / 端口 / 外部服务。
+import os from 'node:os'
+import path from 'node:path'
+import { scaffold } from './lib/scaffold.mjs'
+
+export const name = 'plugin_kit'
+export const inject = ['tools']
+
+const WRITE = 'risk: write (creates files on the phone)'
+const text = (t) => [{ type: 'text', text: t }]
+const renderer = (_args, value) => (Array.isArray(value?.content) ? value.content : text(JSON.stringify(value, null, 2)))
+
+/** 允许 ~ 展开；其余要求绝对路径（相对路径在引擎进程里落到哪儿不可预测）。 */
+export function resolveDir(input) {
+  const raw = String(input ?? '').trim()
+  if (!raw) throw new Error('dir 不能为空（给绝对路径，或 ~/work/plugins/dsh-hello）')
+  if (raw === '~') return os.homedir()
+  if (raw.startsWith('~/')) return path.join(os.homedir(), raw.slice(2))
+  if (!path.isAbsolute(raw)) throw new Error(`dir 必须是绝对路径或以 ~/ 开头（收到：${raw}）`)
+  return raw
+}
+
+export function apply(ctx, config = {}) {
+  const logger = typeof ctx.logger === 'function' ? ctx.logger('plugin_kit') : { info() {}, warn() {} }
+  // 不导出 Config / Schema：大写的会被 cordis 当配置 schema，注册会被静默拦下
+
+  const tool = {
+    name: 'plugin_kit_new',
+    description: `生成一个 DSH host 侧插件骨架：index.mjs（工具注册 + tools/pre-execute 审批钩子）、lib/core.mjs、cordis.patch.yml、package.json（含 dsh.bundle）、icon.svg、locale、dev/test.mjs、host-test/rt.mjs，并把三层验证的跑法打出来。\n[${WRITE}]`,
+    parameters: {
+      type: 'object',
+      properties: {
+        dir: { type: 'string', description: '目标目录：绝对路径或 ~/ 开头；目录里不能已有 package.json' },
+        packageName: { type: 'string', description: 'npm 包名（小写字母/数字/._-），默认取目录名' },
+        desc: { type: 'string', description: '一句话描述，写进 package.json 与 README' },
+        prefix: { type: 'string', description: '工具名前缀（生成 <prefix>_hello / <prefix>_write），默认从包名推' },
+      },
+      required: ['dir'],
+    },
+    timeoutMs: 60_000,
+    isConcurrencySafe: () => false,
+    output: { schema: {}, render: renderer },
+    async execute(args) {
+      try {
+        const dir = resolveDir(args?.dir)
+        const packageName = String(args?.packageName ?? '').trim() || path.basename(dir)
+        const r = scaffold({
+          target: dir,
+          name: packageName,
+          desc: args?.desc || undefined,
+          prefix: args?.prefix || undefined,
+        })
+        return {
+          content: text([
+            `已生成 ${r.files.length} 个文件 → ${r.dir}`,
+            `包名 ${r.packageName} · 工具前缀 ${r.prefix}`,
+            '',
+            '下一步（三层验证，缺一层就会在真机上炸）：',
+            `  node ${r.dir}/dev/test.mjs        # L1 离线单测`,
+            `  node ${r.dir}/host-test/rt.mjs    # L2 真 cordis 冒烟`,
+            '  L3 改 profile patch 前跑一遍部署检查（parser 要引擎同款 js-yaml）',
+          ].join('\n')),
+        }
+      } catch (error) {
+        return { content: text(`生成失败：${error?.message ?? error}`) }
+      }
+    },
+  }
+
+  ctx.effect(() => {
+    if (ctx.tools.get?.(tool.name) !== undefined) {
+      logger.warn?.(`${tool.name} 已存在，跳过`)
+      return () => {}
+    }
+    const off = ctx.tools.register(tool)
+    logger.info?.(`plugin_kit: 注册 1 个工具（${tool.name}）`)
+    return () => { try { off?.() } catch {} }
+  }, 'plugin_kit.tools')
+
+  // 写类工具一律走审批：只把 allow 升级成 ask，上游 deny 不许改写。
+  ctx.on('tools/pre-execute', async (exec, next) => {
+    const decision = await next()
+    if (exec?.name !== tool.name || decision?.kind !== 'allow') return decision
+    let argsText = ''
+    try { argsText = JSON.stringify(exec.arguments ?? {}) } catch {}
+    if (argsText.length > 200) argsText = argsText.slice(0, 200) + '…'
+    return { kind: 'ask', reason: `plugin_kit 要在手机上生成插件骨架：${argsText}` }
+  })
+}

package/lib/scaffold.mjs

@@ -0,0 +1,330 @@
+// dsh-plugin-kit · 脚手架核心（纯逻辑，CLI 与宿主插件共用同一份）
+//
+// 生成内容只由 { name, desc, prefix } 决定 → 同参数必然同字节，回归测试直接比文件。
+// 这里只 import 两个 fs 函数，不读环境变量、不联网、不碰引擎，便于单测。
+
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const NAME_RE = /^[a-z0-9][a-z0-9._-]*$/;
+
+/** 只拼内容不落盘：返回 { 相对路径: 内容 }。 */
+export function buildFiles({ name, desc, prefix }) {
+const P = prefix;
+const files = {};
+
+files['package.json'] = JSON.stringify({
+  name, version: '0.1.0', description: desc, type: 'module', main: 'index.mjs',
+  exports: { '.': './index.mjs', './cordis.patch.yml': './cordis.patch.yml', './icon': './icon.svg', './package.json': './package.json' },
+  files: ['index.mjs', 'lib/', 'cordis.patch.yml', 'icon.svg', 'locale/', 'README.md'],
+  engines: { dsh: '>=0.2.0' },
+  license: 'MIT',
+  dsh: {
+    bundle: { patch: './cordis.patch.yml' },
+    capabilities: ['tools:register'],
+    labels: [],
+  },
+}, null, 2) + '\n';
+
+files['lib/core.mjs'] = `// 业务逻辑放这里，index.mjs 只做注册与协议适配（方便单测）。
+export function hello(who = 'world') {
+  return \`hello, \${who}!\`;
+}
+
+export function echo(text) {
+  if (!text) throw new Error('text 不能为空');
+  return { echoed: String(text), length: String(text).length };
+}
+`;
+
+files['index.mjs'] = `// ${name} —— 由 dsh-plugin-kit 生成。
+//
+// 约定（三层验证都靠它）：
+//   1. 导出 name / inject / apply；
+//   2. 工具在 ctx.effect 里注册，返回 dispose 才能卸载干净；
+//   3. 写类工具挂 tools/pre-execute 钩子，把 allow 升级成 ask（上游 deny 不许改写）。
+import { hello, echo } from './lib/core.mjs';
+
+export const name = '${P}';
+export const inject = ['tools'];
+
+const READ = 'risk: read (read-only)';
+const WRITE = 'risk: write (changes the phone)';
+
+const text = (t) => [{ type: 'text', text: t }];
+const renderer = (_args, value) => (Array.isArray(value?.content) ? value.content : text(JSON.stringify(value, null, 2)));
+
+export function apply(ctx, config = {}) {
+  const logger = typeof ctx.logger === 'function' ? ctx.logger('${P}') : { info() {}, warn() {} };
+  const who = config.who || 'world';
+
+  const tools = [
+    {
+      name: '${P}_hello',
+      description: \`打个招呼（只读）。\\n[\${READ}]\`,
+      parameters: {
+        type: 'object',
+        properties: { who: { type: 'string', description: '称呼，默认取配置 who' } },
+      },
+      timeoutMs: 10_000,
+      isConcurrencySafe: () => true,
+      output: { schema: {}, render: renderer },
+      async execute(args) {
+        return { content: text(hello(args?.who || who)) };
+      },
+    },
+    {
+      name: '${P}_write',
+      description: \`示例写类工具：回显输入（真实插件里这里才真的写盘）。\\n[\${WRITE}]\`,
+      parameters: {
+        type: 'object',
+        properties: { text: { type: 'string', description: '要写入的文本' } },
+        required: ['text'],
+      },
+      timeoutMs: 30_000,
+      isConcurrencySafe: () => false,
+      output: { schema: {}, render: renderer },
+      async execute(args) {
+        const r = echo(args?.text);
+        return { content: text(\`写入 \${r.length} 字符：\${r.echoed}\`) };
+      },
+    },
+  ];
+
+  const disposeFns = [];
+  ctx.effect(() => {
+    for (const def of tools) {
+      if (ctx.tools.get?.(def.name) !== undefined) { logger.warn?.(\`\${def.name} 已存在，跳过\`); continue; }
+      try { disposeFns.push(ctx.tools.register(def)); }
+      catch (error) { logger.warn?.(\`注册 \${def.name} 失败：\${error?.message ?? error}\`); }
+    }
+    logger.info?.(\`${P}: 注册 \${disposeFns.length} 个工具\`);
+    return () => { for (const dispose of disposeFns.splice(0)) { try { dispose(); } catch {} } };
+  }, '${P}.tools');
+
+  const WRITE_TOOLS = new Set(['${P}_write']);
+  ctx.on('tools/pre-execute', async (exec, next) => {
+    const decision = await next();
+    if (!WRITE_TOOLS.has(exec.name) || decision?.kind !== 'allow') return decision;
+    let argsText = '';
+    try { argsText = JSON.stringify(exec.arguments ?? {}); } catch {}
+    if (argsText.length > 200) argsText = argsText.slice(0, 200) + '…';
+    return { kind: 'ask', reason: \`${P} 的写类工具 \${exec.name} 要改东西：\${argsText}\` };
+  });
+}
+`;
+
+files['cordis.patch.yml'] = `# 把本插件插进 profile 的层栈。安装后重启引擎生效。
+- insert:
+    - id: ${P}
+      name: ${name}
+      config:
+        who: ''
+`;
+
+files['icon.svg'] = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#2f6f4f"/>
+  <circle cx="32" cy="32" r="13" fill="none" stroke="#fff" stroke-width="5"/>
+  <circle cx="32" cy="32" r="4" fill="#fff"/>
+</svg>
+`;
+
+files['locale/zh-CN.json'] = JSON.stringify({
+  [`${P}.name`]: desc,
+  [`${P}.hello`]: '打个招呼',
+  [`${P}.write`]: '示例写类工具',
+}, null, 2) + '\n';
+
+files['dev/test.mjs'] = `// 离线单测：不碰网络、不碰真引擎。\nimport assert from 'node:assert/strict';
+import * as plugin from '../index.mjs';
+import { hello, echo } from '../lib/core.mjs';
+
+let pass = 0; const fails = [];
+const t = async (label, fn) => {
+  try { await fn(); pass++; console.log('  ok   ' + label); }
+  catch (e) { fails.push(label); console.log('  FAIL ' + label + ' — ' + e.message); }
+};
+
+const makeCtx = () => {
+  const registered = new Map();
+  const hooks = [];
+  const ctx = {
+    logger: () => ({ info() {}, warn() {} }),
+    effect: (fn) => { const d = fn(); return d || (() => {}); },
+    on: (ev, fn) => { hooks.push([ev, fn]); },
+    tools: { register: (d) => { registered.set(d.name, d); return () => registered.delete(d.name); }, get: (n) => registered.get(n) },
+  };
+  plugin.apply(ctx, {});
+  return { ctx, registered, hooks };
+};
+
+await t('导出 name / inject / apply', () => {
+  assert.equal(plugin.name, '${P}');
+  assert.deepEqual(plugin.inject, ['tools']);
+  assert.equal(typeof plugin.apply, 'function');
+});
+
+await t('纯函数可测（hello / echo）', () => {
+  assert.equal(hello('kit'), 'hello, kit!');
+  assert.deepEqual(echo('ab'), { echoed: 'ab', length: 2 });
+  assert.throws(() => echo(''), /不能为空/);
+});
+
+await t('注册 2 个工具', () => {
+  const { registered } = makeCtx();
+  assert.deepEqual([...registered.keys()].sort(), ['${P}_hello', '${P}_write']);
+});
+
+await t('hello 工具真能执行', async () => {
+  const { registered } = makeCtx();
+  const res = await registered.get('${P}_hello').execute({ who: 'world' });
+  assert.match(res.content[0].text, /hello, world!/);
+});
+
+await t('write 工具真能执行（含校验）', async () => {
+  const { registered } = makeCtx();
+  const res = await registered.get('${P}_write').execute({ text: 'abc' });
+  assert.match(res.content[0].text, /写入 3 字符/);
+  await assert.rejects(() => registered.get('${P}_write').execute({}), /不能为空/);
+});
+
+await t('写类工具走审批：allow → ask，deny 不被动', async () => {
+  const { hooks } = makeCtx();
+  const [, fn] = hooks.find(([ev]) => ev === 'tools/pre-execute');
+  assert.ok(fn, '没有挂 pre-execute');
+  assert.equal((await fn({ name: '${P}_write', arguments: { text: 'x' } }, async () => ({ kind: 'allow' }))).kind, 'ask');
+  assert.equal((await fn({ name: '${P}_hello', arguments: {} }, async () => ({ kind: 'allow' }))).kind, 'allow');
+  assert.equal((await fn({ name: '${P}_write', arguments: {} }, async () => ({ kind: 'deny' }))).kind, 'deny');
+});
+
+console.log(\`\\n通过 \${pass} 项\${fails.length ? \`，失败 \${fails.length} 项：\${fails.join(' / ')}\` : ''}\`);
+process.exit(fails.length ? 1 : 0);
+`;
+
+files['host-test/rt.mjs'] = `// 真 cordis 冒烟：验证 inject 满足、注册、execute、审批钩子、dispose 清理。
+// cordis 从引擎自带的 host-test 目录解析（可用 DSH_HOST_TEST_DIR 覆盖）。
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import assert from 'node:assert/strict';
+import * as plugin from '../index.mjs';
+
+const base = process.env.DSH_HOST_TEST_DIR || \`\${process.env.HOME}/work/host-test\`;
+const require = createRequire(base + '/package.json');
+const { Context } = await import(pathToFileURL(require.resolve('@deepseek-ai/cordis')).href);
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+let pass = 0, fail = 0;
+const t = async (label, fn) => {
+  try { await fn(); pass++; console.log('PASS  ' + label); }
+  catch (e) { fail++; console.log('FAIL  ' + label + '\\n      ' + e.message); }
+};
+
+const ctx = new Context();
+const registered = new Map();
+ctx.provide('tools', {
+  register(def) { registered.set(def.name, def); return () => registered.delete(def.name); },
+  get(n) { return registered.get(n); },
+});
+const hooks = [];
+const origOn = ctx.on.bind(ctx);
+ctx.on = (ev, fn, prepend) => { hooks.push([ev, fn]); return origOn(ev, fn, prepend); };
+
+let fiber;
+await t('真 cordis 加载插件', async () => {
+  fiber = ctx.plugin(plugin, {});
+  await sleep(120);
+  assert.ok(fiber);
+  assert.equal(plugin.inject[0], 'tools');
+});
+
+await t('2 个工具注册进 ctx.tools', () => {
+  assert.deepEqual([...registered.keys()].sort(), ['${P}_hello', '${P}_write']);
+});
+
+await t('hello 经 cordis 调 execute', async () => {
+  const res = await registered.get('${P}_hello').execute({});
+  assert.match(res.content[0].text, /hello,/);
+});
+
+await t('审批钩子生效', async () => {
+  const [, fn] = hooks.find(([ev]) => ev === 'tools/pre-execute');
+  assert.equal((await fn({ name: '${P}_write', arguments: { text: 'y' } }, async () => ({ kind: 'allow' }))).kind, 'ask');
+});
+
+await t('dispose 后工具被摘掉', async () => {
+  await fiber.dispose();
+  await sleep(60);
+  assert.equal(registered.size, 0);
+});
+
+console.log(\`\\n\${fail ? '❌' : '✅'} 通过 \${pass} 项\${fail ? \`, 失败 \${fail} 项\` : ''}\`);
+process.exit(fail ? 1 : 0);
+`;
+
+files['README.md'] = `# ${name}
+
+${desc}
+
+## 工具
+
+| 工具 | 风险 | 作用 |
+|---|---|---|
+| \`${P}_hello\` | 只读 | 打个招呼 |
+| \`${P}_write\` | 写盘（走审批） | 示例写类工具 |
+
+## 开发流程（在手机上也能跑）
+
+\`\`\`sh
+node dev/test.mjs          # 离线单测（不碰网络）
+node host-test/rt.mjs      # 真 cordis 冒烟（用引擎自带的那份 cordis）
+\`\`\`
+
+发布：
+
+\`\`\`sh
+# npm（新包首发会先进 staged 状态，约 40–120 s 后可见；发完务必下载 tarball 实际加载验证）
+node \$HOME/tools/npm/bin/npm-cli.js publish
+# GitHub（本机没有 git，走 REST API）
+node \$HOME/work/gitpub/publish-github.mjs --dir . --owner <you> --repo ${name} --token-file \$HOME/.gh_token
+\`\`\`
+
+## 配置
+
+\`\`\`yaml
+- insert:
+    - id: ${P}
+      name: ${name}
+      config:
+        who: ''
+\`\`\`
+
+## 契约
+
+- \`inject: ['tools']\`；工具在 \`ctx.effect\` 里注册并返回 dispose；
+- 写类工具在 \`tools/pre-execute\` 里把 \`allow\` 升级成 \`ask\`，**不改写上游 deny**；
+- 包内 \`dsh.capabilities\` 按实际用到的最小集合声明。
+
+MIT
+`;
+
+files['.gitignore'] = `node_modules/\n*.tgz\n`;
+  return files;
+}
+
+/** 校验 + 落盘。抛 Error 而不是 process.exit，好让工具层包成可读结果。 */
+export function scaffold({ target, name, desc, prefix } = {}) {
+  if (!target || !name) throw new Error('用法: scaffold({ target, name, desc?, prefix? })');
+  if (!NAME_RE.test(name)) throw new Error('包名只能小写字母/数字/. _ -');
+  if (existsSync(join(target, 'package.json'))) throw new Error(`目标目录已经有 package.json：${target}`);
+  const P = prefix || name.replace(/^dsh[-/]?/, '').replace(/[-.]/g, '_') || 'demo';
+  const D = desc || `${name}：一个 DSH 插件`;
+  const files = buildFiles({ name, desc: D, prefix: P });
+  const written = [];
+  for (const [rel, content] of Object.entries(files)) {
+    const abs = join(target, rel);
+    mkdirSync(join(abs, '..'), { recursive: true });
+    writeFileSync(abs, content);
+    written.push(rel);
+  }
+  return { dir: target, packageName: name, prefix: P, files: written };
+}

package/new.mjs

@@ -1,329 +1,33 @@
 #!/usr/bin/env node
 // dsh-plugin-kit —— 一条命令生成 DSH 插件骨架（host 侧：工具 + 审批钩子 + 三层验证）。
 // 用法：node new.mjs <目标目录> --name dsh-hello [--desc "一句话"] [--prefix hello]
-import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
-import { join, basename } from 'node:path';
+//
+// 0.2.0 起生成逻辑在 lib/scaffold.mjs：CLI 与宿主插件（index.mjs 的 plugin_kit_new 工具）
+// 共用同一份实现，避免"命令行能生成、插件里行为不一样"。
+import { basename } from 'node:path';
+import { scaffold } from './lib/scaffold.mjs';
 
 const argv = process.argv.slice(2);
 const arg = (k, d = null) => { const i = argv.indexOf(k); return i >= 0 && argv[i + 1] ? argv[i + 1] : d; };
 const positional = argv.filter((a, i) => !a.startsWith('--') && !(argv[i - 1] || '').startsWith('--'));
 const target = positional[0];
 const name = arg('--name') || (target ? basename(target) : null);
+
 if (!target || !name) {
   console.error('用法: node new.mjs <目标目录> --name dsh-hello [--desc "一句话"] [--prefix hello]');
   process.exit(2);
 }
-if (!/^[a-z0-9][a-z0-9._-]*$/.test(name)) { console.error('包名只能小写字母/数字/. _ -'); process.exit(2); }
-if (existsSync(join(target, 'package.json'))) { console.error(`目标目录已经有 package.json：${target}`); process.exit(2); }
-
-const prefix = arg('--prefix') || name.replace(/^dsh[-/]?/, '').replace(/[-.]/g, '_') || 'demo';
-const desc = arg('--desc') || `${name}：一个 DSH 插件`;
-const P = prefix;
-const files = {};
-
-files['package.json'] = JSON.stringify({
-  name, version: '0.1.0', description: desc, type: 'module', main: 'index.mjs',
-  exports: { '.': './index.mjs', './cordis.patch.yml': './cordis.patch.yml', './icon': './icon.svg', './package.json': './package.json' },
-  files: ['index.mjs', 'lib/', 'cordis.patch.yml', 'icon.svg', 'locale/', 'README.md'],
-  engines: { dsh: '>=0.2.0' },
-  license: 'MIT',
-  dsh: {
-    bundle: { patch: './cordis.patch.yml' },
-    capabilities: ['tools:register'],
-    labels: [],
-  },
-}, null, 2) + '\n';
-
-files['lib/core.mjs'] = `// 业务逻辑放这里，index.mjs 只做注册与协议适配（方便单测）。
-export function hello(who = 'world') {
-  return \`hello, \${who}!\`;
-}
-
-export function echo(text) {
-  if (!text) throw new Error('text 不能为空');
-  return { echoed: String(text), length: String(text).length };
-}
-`;
-
-files['index.mjs'] = `// ${name} —— 由 dsh-plugin-kit 生成。
-//
-// 约定（三层验证都靠它）：
-//   1. 导出 name / inject / apply；
-//   2. 工具在 ctx.effect 里注册，返回 dispose 才能卸载干净；
-//   3. 写类工具挂 tools/pre-execute 钩子，把 allow 升级成 ask（上游 deny 不许改写）。
-import { hello, echo } from './lib/core.mjs';
-
-export const name = '${P}';
-export const inject = ['tools'];
-
-const READ = 'risk: read (read-only)';
-const WRITE = 'risk: write (changes the phone)';
-
-const text = (t) => [{ type: 'text', text: t }];
-const renderer = (_args, value) => (Array.isArray(value?.content) ? value.content : text(JSON.stringify(value, null, 2)));
-
-export function apply(ctx, config = {}) {
-  const logger = typeof ctx.logger === 'function' ? ctx.logger('${P}') : { info() {}, warn() {} };
-  const who = config.who || 'world';
 
-  const tools = [
-    {
-      name: '${P}_hello',
-      description: \`打个招呼（只读）。\\n[\${READ}]\`,
-      parameters: {
-        type: 'object',
-        properties: { who: { type: 'string', description: '称呼，默认取配置 who' } },
-      },
-      timeoutMs: 10_000,
-      isConcurrencySafe: () => true,
-      output: { schema: {}, render: renderer },
-      async execute(args) {
-        return { content: text(hello(args?.who || who)) };
-      },
-    },
-    {
-      name: '${P}_write',
-      description: \`示例写类工具：回显输入（真实插件里这里才真的写盘）。\\n[\${WRITE}]\`,
-      parameters: {
-        type: 'object',
-        properties: { text: { type: 'string', description: '要写入的文本' } },
-        required: ['text'],
-      },
-      timeoutMs: 30_000,
-      isConcurrencySafe: () => false,
-      output: { schema: {}, render: renderer },
-      async execute(args) {
-        const r = echo(args?.text);
-        return { content: text(\`写入 \${r.length} 字符：\${r.echoed}\`) };
-      },
-    },
-  ];
-
-  const disposeFns = [];
-  ctx.effect(() => {
-    for (const def of tools) {
-      if (ctx.tools.get?.(def.name) !== undefined) { logger.warn?.(\`\${def.name} 已存在，跳过\`); continue; }
-      try { disposeFns.push(ctx.tools.register(def)); }
-      catch (error) { logger.warn?.(\`注册 \${def.name} 失败：\${error?.message ?? error}\`); }
-    }
-    logger.info?.(\`${P}: 注册 \${disposeFns.length} 个工具\`);
-    return () => { for (const dispose of disposeFns.splice(0)) { try { dispose(); } catch {} } };
-  }, '${P}.tools');
-
-  const WRITE_TOOLS = new Set(['${P}_write']);
-  ctx.on('tools/pre-execute', async (exec, next) => {
-    const decision = await next();
-    if (!WRITE_TOOLS.has(exec.name) || decision?.kind !== 'allow') return decision;
-    let argsText = '';
-    try { argsText = JSON.stringify(exec.arguments ?? {}); } catch {}
-    if (argsText.length > 200) argsText = argsText.slice(0, 200) + '…';
-    return { kind: 'ask', reason: \`${P} 的写类工具 \${exec.name} 要改东西：\${argsText}\` };
-  });
+let out;
+try {
+  out = scaffold({ target, name, desc: arg('--desc'), prefix: arg('--prefix') });
+} catch (error) {
+  console.error(String(error?.message ?? error));
+  process.exit(2);
 }
-`;
-
-files['cordis.patch.yml'] = `# 把本插件插进 profile 的层栈。安装后重启引擎生效。
-- insert:
-    - id: ${P}
-      name: ${name}
-      config:
-        who: ''
-`;
-
-files['icon.svg'] = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
-  <rect width="64" height="64" rx="14" fill="#2f6f4f"/>
-  <circle cx="32" cy="32" r="13" fill="none" stroke="#fff" stroke-width="5"/>
-  <circle cx="32" cy="32" r="4" fill="#fff"/>
-</svg>
-`;
-
-files['locale/zh-CN.json'] = JSON.stringify({
-  [`${P}.name`]: desc,
-  [`${P}.hello`]: '打个招呼',
-  [`${P}.write`]: '示例写类工具',
-}, null, 2) + '\n';
-
-files['dev/test.mjs'] = `// 离线单测：不碰网络、不碰真引擎。\nimport assert from 'node:assert/strict';
-import * as plugin from '../index.mjs';
-import { hello, echo } from '../lib/core.mjs';
-
-let pass = 0; const fails = [];
-const t = async (label, fn) => {
-  try { await fn(); pass++; console.log('  ok   ' + label); }
-  catch (e) { fails.push(label); console.log('  FAIL ' + label + ' — ' + e.message); }
-};
-
-const makeCtx = () => {
-  const registered = new Map();
-  const hooks = [];
-  const ctx = {
-    logger: () => ({ info() {}, warn() {} }),
-    effect: (fn) => { const d = fn(); return d || (() => {}); },
-    on: (ev, fn) => { hooks.push([ev, fn]); },
-    tools: { register: (d) => { registered.set(d.name, d); return () => registered.delete(d.name); }, get: (n) => registered.get(n) },
-  };
-  plugin.apply(ctx, {});
-  return { ctx, registered, hooks };
-};
-
-await t('导出 name / inject / apply', () => {
-  assert.equal(plugin.name, '${P}');
-  assert.deepEqual(plugin.inject, ['tools']);
-  assert.equal(typeof plugin.apply, 'function');
-});
-
-await t('纯函数可测（hello / echo）', () => {
-  assert.equal(hello('kit'), 'hello, kit!');
-  assert.deepEqual(echo('ab'), { echoed: 'ab', length: 2 });
-  assert.throws(() => echo(''), /不能为空/);
-});
-
-await t('注册 2 个工具', () => {
-  const { registered } = makeCtx();
-  assert.deepEqual([...registered.keys()].sort(), ['${P}_hello', '${P}_write']);
-});
-
-await t('hello 工具真能执行', async () => {
-  const { registered } = makeCtx();
-  const res = await registered.get('${P}_hello').execute({ who: 'world' });
-  assert.match(res.content[0].text, /hello, world!/);
-});
-
-await t('write 工具真能执行（含校验）', async () => {
-  const { registered } = makeCtx();
-  const res = await registered.get('${P}_write').execute({ text: 'abc' });
-  assert.match(res.content[0].text, /写入 3 字符/);
-  await assert.rejects(() => registered.get('${P}_write').execute({}), /不能为空/);
-});
 
-await t('写类工具走审批：allow → ask，deny 不被动', async () => {
-  const { hooks } = makeCtx();
-  const [, fn] = hooks.find(([ev]) => ev === 'tools/pre-execute');
-  assert.ok(fn, '没有挂 pre-execute');
-  assert.equal((await fn({ name: '${P}_write', arguments: { text: 'x' } }, async () => ({ kind: 'allow' }))).kind, 'ask');
-  assert.equal((await fn({ name: '${P}_hello', arguments: {} }, async () => ({ kind: 'allow' }))).kind, 'allow');
-  assert.equal((await fn({ name: '${P}_write', arguments: {} }, async () => ({ kind: 'deny' }))).kind, 'deny');
-});
-
-console.log(\`\\n通过 \${pass} 项\${fails.length ? \`，失败 \${fails.length} 项：\${fails.join(' / ')}\` : ''}\`);
-process.exit(fails.length ? 1 : 0);
-`;
-
-files['host-test/rt.mjs'] = `// 真 cordis 冒烟：验证 inject 满足、注册、execute、审批钩子、dispose 清理。
-// cordis 从引擎自带的 host-test 目录解析（可用 DSH_HOST_TEST_DIR 覆盖）。
-import { createRequire } from 'node:module';
-import { pathToFileURL } from 'node:url';
-import assert from 'node:assert/strict';
-import * as plugin from '../index.mjs';
-
-const base = process.env.DSH_HOST_TEST_DIR || \`\${process.env.HOME}/work/host-test\`;
-const require = createRequire(base + '/package.json');
-const { Context } = await import(pathToFileURL(require.resolve('@deepseek-ai/cordis')).href);
-
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-let pass = 0, fail = 0;
-const t = async (label, fn) => {
-  try { await fn(); pass++; console.log('PASS  ' + label); }
-  catch (e) { fail++; console.log('FAIL  ' + label + '\\n      ' + e.message); }
-};
-
-const ctx = new Context();
-const registered = new Map();
-ctx.provide('tools', {
-  register(def) { registered.set(def.name, def); return () => registered.delete(def.name); },
-  get(n) { return registered.get(n); },
-});
-const hooks = [];
-const origOn = ctx.on.bind(ctx);
-ctx.on = (ev, fn, prepend) => { hooks.push([ev, fn]); return origOn(ev, fn, prepend); };
-
-let fiber;
-await t('真 cordis 加载插件', async () => {
-  fiber = ctx.plugin(plugin, {});
-  await sleep(120);
-  assert.ok(fiber);
-  assert.equal(plugin.inject[0], 'tools');
-});
-
-await t('2 个工具注册进 ctx.tools', () => {
-  assert.deepEqual([...registered.keys()].sort(), ['${P}_hello', '${P}_write']);
-});
-
-await t('hello 经 cordis 调 execute', async () => {
-  const res = await registered.get('${P}_hello').execute({});
-  assert.match(res.content[0].text, /hello,/);
-});
-
-await t('审批钩子生效', async () => {
-  const [, fn] = hooks.find(([ev]) => ev === 'tools/pre-execute');
-  assert.equal((await fn({ name: '${P}_write', arguments: { text: 'y' } }, async () => ({ kind: 'allow' }))).kind, 'ask');
-});
-
-await t('dispose 后工具被摘掉', async () => {
-  await fiber.dispose();
-  await sleep(60);
-  assert.equal(registered.size, 0);
-});
-
-console.log(\`\\n\${fail ? '❌' : '✅'} 通过 \${pass} 项\${fail ? \`, 失败 \${fail} 项\` : ''}\`);
-process.exit(fail ? 1 : 0);
-`;
-
-files['README.md'] = `# ${name}
-
-${desc}
-
-## 工具
-
-| 工具 | 风险 | 作用 |
-|---|---|---|
-| \`${P}_hello\` | 只读 | 打个招呼 |
-| \`${P}_write\` | 写盘（走审批） | 示例写类工具 |
-
-## 开发流程（在手机上也能跑）
-
-\`\`\`sh
-node dev/test.mjs          # 离线单测（不碰网络）
-node host-test/rt.mjs      # 真 cordis 冒烟（用引擎自带的那份 cordis）
-\`\`\`
-
-发布：
-
-\`\`\`sh
-# npm（新包首发会先进 staged 状态，约 40–120 s 后可见；发完务必下载 tarball 实际加载验证）
-node \$HOME/tools/npm/bin/npm-cli.js publish
-# GitHub（本机没有 git，走 REST API）
-node \$HOME/work/gitpub/publish-github.mjs --dir . --owner <you> --repo ${name} --token-file \$HOME/.gh_token
-\`\`\`
-
-## 配置
-
-\`\`\`yaml
-- insert:
-    - id: ${P}
-      name: ${name}
-      config:
-        who: ''
-\`\`\`
-
-## 契约
-
-- \`inject: ['tools']\`；工具在 \`ctx.effect\` 里注册并返回 dispose；
-- 写类工具在 \`tools/pre-execute\` 里把 \`allow\` 升级成 \`ask\`，**不改写上游 deny**；
-- 包内 \`dsh.capabilities\` 按实际用到的最小集合声明。
-
-MIT
-`;
-
-files['.gitignore'] = `node_modules/\n*.tgz\n`;
-
-for (const [rel, content] of Object.entries(files)) {
-  const abs = join(target, rel);
-  mkdirSync(join(abs, '..'), { recursive: true });
-  writeFileSync(abs, content);
-}
-console.log(`已生成 ${Object.keys(files).length} 个文件 → ${target}`);
+console.log(`已生成 ${out.files.length} 个文件 → ${out.dir}`);
 console.log(`\n下一步：`);
-console.log(`  cd ${target}`);
+console.log(`  cd ${out.dir}`);
 console.log(`  node dev/test.mjs        # 离线单测`);
 console.log(`  node host-test/rt.mjs    # 真 cordis 冒烟`);

package/package.json

@@ -1,21 +1,44 @@
 {
   "name": "dsh-host-plugin-kit",
-  "version": "0.1.1",
-  "description": "DSH host 侧插件脚手架：一条命令生成带三层验证（离线单测 / 真 cordis 冒烟 / 发布脚本）的插件骨架，含审批钩子与 dispose 清理模板",
+  "version": "0.2.0",
+  "description": "DSH host 侧插件脚手架（CLI + 宿主插件双形态）：一条命令生成带三层验证（离线单测 / 真 cordis 冒烟 / 部署检查）的插件骨架，并在 DSH 里提供 plugin_kit_new 工具，agent 不开 shell 也能搭骨架",
   "type": "module",
-  "main": "new.mjs",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs",
+    "./scaffold": "./lib/scaffold.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "dsh-plugin-kit": "new.mjs"
   },
   "files": [
+    "index.mjs",
     "new.mjs",
-    "dev/bin-selftest.mjs",
+    "lib/",
+    "dev/",
+    "cordis.patch.yml",
+    "icon.svg",
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "dsh": ">=0.2.0"
   },
   "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "capabilities": [
+      "tools:register",
+      "fs:write",
+      "fs:read"
+    ],
+    "labels": []
+  },
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -24,8 +47,8 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Verchiel666/dsh-plugin-kit.git"
+    "url": "git+https://github.com/Verchiel666/dsh-host-plugin-kit.git"
   },
-  "homepage": "https://github.com/Verchiel666/dsh-plugin-kit#readme",
+  "homepage": "https://github.com/Verchiel666/dsh-host-plugin-kit#readme",
   "author": "Verchiel666"
 }