@siming-org/opencode-plugin 0.0.0-stage → 0.1.1

package/dist/fetch-assets.js

@@ -0,0 +1,362 @@
+/**
+ * 运行时资产拉取（技术方案 §4.C3 第 1-3 条）。
+ *
+ * 目标解析（serverUrl/token）是 CLI 实链的最小镜像子集——契约源锚定：
+ * - serverUrl：packages/cli/src/client/http-client.ts resolveServerUrl
+ *   （env SIMING_SERVER_URL > 工作区 .siming/config.json serverUrl > ~/.siming/config.json serverUrl
+ *   > http://localhost:{端口推导}）
+ * - 端口推导：packages/cli/src/config/server-config-loader.ts resolveLocalSimingPort
+ *   （PORT env > ~/.config/siming/siming.jsonc port > /etc/siming/siming.jsonc port > 7777）
+ * - token：packages/cli/src/config/auth-token.ts
+ *   （工作区 .siming/dev.json authToken > ~/.siming/auth.json（尊重 SIMING_AUTH_FILE 重定向）> SIMING_TOKEN env）
+ * CLI 的 index.ts 是 bin 入口不可作库引用（已核实），故镜像实现；不含源码形态免疫等 CLI 专属逻辑。
+ * 拉取数据路径与 install 命令一致：列表概要投影（content 随列表下发、references 剥离出
+ * referenceCount）+ referenceCount>0 时 by-name 详情取全量 references。
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { parse } from 'jsonc-parser';
+const FETCH_TIMEOUT_MS = 10_000;
+// ── 配置解析（CLI 镜像子集） ──
+/** 向上发现工作区根（含 .siming 目录者）——语义对齐 CLI findWorkspaceDir */
+export function findWorkspaceDir(start) {
+    let dir = resolve(start);
+    for (;;) {
+        const marker = join(dir, '.siming');
+        if (existsSync(marker))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** 读工作区 .siming/config.json（损坏=console.error + null，不中断） */
+function readWorkspaceConfig(workspaceDir) {
+    const file = join(workspaceDir, '.siming', 'config.json');
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        console.error(`[siming-plugin] 工作区配置 ${file} 解析失败（忽略该层）：${String(err)}`);
+        return null;
+    }
+}
+/** jsonc 配置文件宽容读取（不存在/损坏/非对象 → null）——镜像 tryLoadJsoncConfigFile 容错语义 */
+function tryLoadJsonc(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const value = parse(readFileSync(path, 'utf8'));
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            return value;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 同机端口推导（镜像 resolveLocalSimingPort：PORT env > 用户级 > 系统级 > 7777） */
+function resolveLocalPort() {
+    const portEnv = process.env['PORT'];
+    if (portEnv !== undefined) {
+        const n = Number(portEnv);
+        if (Number.isInteger(n) && n >= 1 && n <= 65_535)
+            return n;
+        console.error(`[siming-plugin] 忽略非法 PORT="${portEnv}"（须为 1-65535 整数），回退配置文件/缺省端口`);
+    }
+    for (const path of [
+        join(homedir(), '.config', 'siming', 'siming.jsonc'),
+        '/etc/siming/siming.jsonc',
+    ]) {
+        const values = tryLoadJsonc(path);
+        const raw = values?.['port'];
+        if (raw === undefined)
+            continue;
+        const n = typeof raw === 'number' ? raw : Number(raw);
+        if (Number.isInteger(n) && n >= 1 && n <= 65_535)
+            return n;
+    }
+    return 7777;
+}
+/** 全局层 ~/.siming/config.json 的 serverUrl（缺失=null） */
+function readGlobalServerUrl() {
+    const values = tryLoadJsonc(join(homedir(), '.siming', 'config.json'));
+    const url = values?.['serverUrl'];
+    return typeof url === 'string' && url !== '' ? url : null;
+}
+/** token 三层链：工作区 dev.json authToken > 全局 auth.json（SIMING_AUTH_FILE 可重定向）> SIMING_TOKEN env */
+function resolveToken(workspaceDir) {
+    if (workspaceDir !== null) {
+        const file = join(workspaceDir, '.siming', 'dev.json');
+        if (existsSync(file)) {
+            try {
+                const value = JSON.parse(readFileSync(file, 'utf8'));
+                if (typeof value.authToken === 'string' && value.authToken !== '')
+                    return value.authToken;
+            }
+            catch {
+                // 损坏视同缺失，落下一层
+            }
+        }
+    }
+    const authFile = process.env['SIMING_AUTH_FILE'];
+    // 相对路径重定向对齐 CLI 语义（auth-token.ts resolveGlobalAuthFilePath/globalEffectiveValue）：
+    // 显式指定时永不回退默认路径——相对路径 = 告警 + 整层视为未配置（落 env 层），不读机器级默认凭据
+    const globalPath = authFile === undefined
+        ? join(homedir(), '.siming', 'auth.json')
+        : isAbsolute(authFile)
+            ? authFile
+            : null;
+    if (globalPath === null) {
+        console.error(`[siming-plugin] 忽略相对路径 SIMING_AUTH_FILE="${authFile}"（须为绝对路径）——全局凭据层视为未配置`);
+    }
+    else if (existsSync(globalPath)) {
+        try {
+            // 字段名锚定 CLI 契约：auth-token.ts writeGlobalAuthToken 写 { authToken }（读侧同字段）
+            const value = JSON.parse(readFileSync(globalPath, 'utf8'));
+            if (typeof value.authToken === 'string' && value.authToken !== '')
+                return value.authToken;
+        }
+        catch {
+            // 损坏视同缺失，落下一层
+        }
+    }
+    const envToken = process.env['SIMING_TOKEN'];
+    return envToken !== undefined && envToken !== '' ? envToken : null;
+}
+export class AssetFetchError extends Error {
+    kind;
+    status;
+    constructor(kind, message, status) {
+        super(message);
+        this.name = 'AssetFetchError';
+        this.kind = kind;
+        if (status !== undefined)
+            this.status = status;
+    }
+}
+async function apiGet(serverUrl, token, path) {
+    let response;
+    try {
+        response = await fetch(`${serverUrl}${path}`, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            headers: token !== null ? { Authorization: `Bearer ${token}` } : {},
+        });
+    }
+    catch (err) {
+        throw new AssetFetchError('network', `server 不可达（${serverUrl}）：${String(err)}——确认 server 已在运行且地址正确（地址解析优先级：env SIMING_SERVER_URL > 工作区 .siming/config.json serverUrl > 全局 ~/.siming/config.json > 端口推导缺省）`);
+    }
+    if (response.status === 401) {
+        throw new AssetFetchError('auth', `鉴权失败（${serverUrl}）：请经 Web 管理台生成/重置 Token 并执行 siming auth token set --global 配置`, 401);
+    }
+    if (!response.ok) {
+        throw new AssetFetchError('http', `HTTP ${String(response.status)}（${serverUrl}${path}）`, response.status);
+    }
+    try {
+        return await response.json();
+    }
+    catch (err) {
+        throw new AssetFetchError('parse', `响应不是合法 JSON（${serverUrl}${path}）：${String(err)}`);
+    }
+}
+/** 四层 serverUrl 解析 + 三层 token 解析 + 工作区项目绑定发现（纯本地，无网络请求） */
+export function resolveFetchTarget(startDir) {
+    const envUrl = process.env['SIMING_SERVER_URL'];
+    const workspaceDir = findWorkspaceDir(startDir);
+    const workspaceConfig = workspaceDir !== null ? readWorkspaceConfig(workspaceDir) : null;
+    let serverUrl;
+    if (envUrl !== undefined && envUrl !== '') {
+        serverUrl = envUrl;
+    }
+    else if (typeof workspaceConfig?.serverUrl === 'string' && workspaceConfig.serverUrl !== '') {
+        serverUrl = workspaceConfig.serverUrl;
+    }
+    else {
+        const global = readGlobalServerUrl();
+        serverUrl = global ?? `http://localhost:${String(resolveLocalPort())}`;
+    }
+    // 剥尾斜杠对齐 CLI resolveServerUrl（http-client.ts）：否则 <url>//api/skills 与 CLI 行为分歧
+    serverUrl = serverUrl.replace(/\/+$/, '');
+    const defaultProject = workspaceConfig?.defaultProject;
+    return {
+        serverUrl,
+        token: resolveToken(workspaceDir),
+        projectKey: typeof defaultProject === 'string' && defaultProject !== '' ? defaultProject : null,
+    };
+}
+/** project key → hex id（GET /api/projects 找 key===input；24-hex 直接作 id）——镜像 CLI resolveProjectId */
+async function resolveProjectId(target, key) {
+    if (/^[a-f0-9]{24}$/.test(key))
+        return key;
+    const raw = await apiGet(target.serverUrl, target.token, '/api/projects');
+    const projects = Array.isArray(raw) ? raw : [];
+    const hit = projects.find((p) => p.key === key);
+    return typeof hit?.id === 'string' ? hit.id : null;
+}
+function requireArray(raw, what) {
+    if (!Array.isArray(raw))
+        throw new AssetFetchError('parse', `${what} 响应不是数组`);
+    return raw;
+}
+async function fetchSkillList(target, query) {
+    const raw = await apiGet(target.serverUrl, target.token, `/api/skills${query}`);
+    return requireArray(raw, 'GET /api/skills');
+}
+async function fetchAgentList(target, query) {
+    const raw = await apiGet(target.serverUrl, target.token, `/api/agents${query}`);
+    return requireArray(raw, 'GET /api/agents');
+}
+/** by-name 详情（全量含 references）；项目作用域条目必须携带 scope=project&projectId=<hex>（否则拉到 global 版） */
+async function fetchSkillDetail(target, name, scope, projectId) {
+    const query = scope === 'project' && projectId !== null
+        ? `?scope=project&projectId=${projectId}`
+        : '?scope=global';
+    const raw = await apiGet(target.serverUrl, target.token, `/api/skills/${encodeURIComponent(name)}${query}`);
+    if (typeof raw !== 'object' || raw === null)
+        throw new AssetFetchError('parse', `skill ${name} 详情响应不是对象`);
+    return raw;
+}
+// ── references 物化（架构评审 H2：正文相对引用改绝对路径；幂等重写） ──
+function referencesRoot() {
+    return join(tmpdir(), 'siming-opencode-plugin', 'skills');
+}
+/**
+ * 物化某技能的引用文档到 os.tmpdir()/siming-opencode-plugin/skills/<name>/references/<path>，
+ * 并把正文中出现的相对 path 文本改写为物化后的绝对路径（主文档以文本引用 path，
+ * 引用侧同源可证：server 侧 assertReferencesDeletable 即按「path 文本出现在正文」判定）。
+ * 幂等：每次重拉整目录重建（rmSync+重写），同一动作再验证复用。
+ */
+function materializeReferences(skillName, content, references) {
+    if (references.length === 0)
+        return content;
+    const assetRoot = join(referencesRoot(), skillName, 'references');
+    rmSync(assetRoot, { recursive: true, force: true });
+    let rewritten = content;
+    for (const doc of references) {
+        const abs = join(assetRoot, doc.path);
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, doc.content, 'utf8');
+        // path 已通过 server 校验（禁绝对/回溯/反斜杠/空段），join 不产生越界
+        rewritten = rewritten.split(doc.path).join(abs);
+    }
+    return rewritten;
+}
+/** 每条 name@scope|version|updatedAt|enabled 排序拼接（§4.C3 第 6 条契约形状） */
+export function buildFingerprint(items) {
+    return items
+        .map((item) => `${item.name}@${item.scope}|${item.version}|${item.updatedAt ?? ''}|${String(item.enabled ?? true)}`)
+        .sort()
+        .join('\n');
+}
+/**
+ * 指纹检查的列表拉取（零 server 改动的差异检测输入，每域一次请求）：
+ * 绑定项目 → ?projectId=<hex>（一次返回 global+本项目并集，投影含 scope）；
+ * 无绑定 → 显式 ?scope=global（列表缺省=全量管理视角，不可用于指纹）。
+ */
+export async function fetchSkillCheckFingerprint(plan) {
+    const skills = await fetchSkillList(plan.target, fingerprintQuery(plan.projectId));
+    return buildFingerprint(skills);
+}
+export async function fetchAgentCheckFingerprint(plan) {
+    const agents = await fetchAgentList(plan.target, fingerprintQuery(plan.projectId));
+    return buildFingerprint(agents);
+}
+function fingerprintQuery(projectId) {
+    return projectId !== null ? `?projectId=${projectId}` : '?scope=global';
+}
+/**
+ * 共享前置解析：目标四层/token 三层 + 工作区项目 key→hex id。
+ * projectIdOverride：调用方（revalidate）缓存的 key→id 命中时跳过网络解析，稳态检查保持 2 次列表请求。
+ */
+export async function resolveFetchPlan(startDir, projectIdOverride) {
+    const target = resolveFetchTarget(startDir);
+    if (target.projectKey === null)
+        return { target, projectId: null };
+    if (projectIdOverride !== undefined && projectIdOverride !== null && projectIdOverride.key === target.projectKey) {
+        return { target, projectId: projectIdOverride.id };
+    }
+    const id = await resolveProjectId(target, target.projectKey);
+    if (id === null) {
+        // 绑定存在但解析失败（项目已删/不可达）：按仅全局继续，如实留痕
+        console.error(`[siming-plugin] 工作区绑定项目 "${target.projectKey}" 解析失败（GET /api/projects 无此 key）——本次按仅全局拉取`);
+    }
+    return { target, projectId: id };
+}
+/**
+ * 技能域全链拉取：global 列表 +（有绑定时）project 列表 → 同名 project 胜 →
+ * referenceCount>0 取 by-name 详情并物化 references。
+ * includeDisabled 不携带——停用资产不注册，对齐 install 语义。
+ */
+export async function fetchSkillsDomain(plan) {
+    const globalItems = await fetchSkillList(plan.target, '?scope=global');
+    const projectItems = plan.projectId !== null
+        ? await fetchSkillList(plan.target, `?scope=project&projectId=${plan.projectId}`)
+        : [];
+    const merged = new Map();
+    for (const item of globalItems)
+        merged.set(item.name, item);
+    for (const item of projectItems)
+        merged.set(item.name, item);
+    const skills = [];
+    for (const item of merged.values()) {
+        let content = item.content;
+        if (item.referenceCount > 0) {
+            const detail = await fetchSkillDetail(plan.target, item.name, item.scope, plan.projectId);
+            if (detail.references !== undefined && detail.references.length > 0) {
+                content = materializeReferences(item.name, content, detail.references);
+            }
+        }
+        skills.push({
+            name: item.name,
+            description: item.description,
+            content,
+            scope: item.scope,
+            version: item.version,
+            ...(item.updatedAt !== undefined ? { updatedAt: item.updatedAt } : {}),
+            referenceCount: item.referenceCount,
+        });
+    }
+    return {
+        assets: skills,
+        fingerprint: buildFingerprint([...globalItems, ...projectItems]),
+        serverUrl: plan.target.serverUrl,
+        projectId: plan.projectId,
+    };
+}
+/** 子代理域全链拉取（同技能域语义；systemPrompt 随列表下发，无详情/物化环节） */
+export async function fetchAgentsDomain(plan) {
+    const globalItems = await fetchAgentList(plan.target, '?scope=global');
+    const projectItems = plan.projectId !== null
+        ? await fetchAgentList(plan.target, `?scope=project&projectId=${plan.projectId}`)
+        : [];
+    const merged = new Map();
+    for (const item of globalItems)
+        merged.set(item.name, item);
+    for (const item of projectItems)
+        merged.set(item.name, item);
+    const agents = [];
+    for (const item of merged.values()) {
+        agents.push({
+            name: item.name,
+            description: item.description,
+            systemPrompt: item.systemPrompt,
+            scope: item.scope,
+            version: item.version,
+            ...(item.updatedAt !== undefined ? { updatedAt: item.updatedAt } : {}),
+            function: item.function ?? 'executor',
+            boundSkills: item.boundSkills ?? [],
+        });
+    }
+    return {
+        assets: agents,
+        fingerprint: buildFingerprint([...globalItems, ...projectItems]),
+        serverUrl: plan.target.serverUrl,
+        projectId: plan.projectId,
+    };
+}
+//# sourceMappingURL=fetch-assets.js.map

package/dist/fetch-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-assets.js","sourceRoot":"","sources":["../src/fetch-assets.ts"],"names":[],"mappings":"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"}

package/dist/guide-skill.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 接入引导技能（技术方案 §4.F）：激活时内嵌注册 siming-guide。
+ *
+ * 正文 = 六步主链路插件版（v10 裁定 A）：链上无 scaffold 步，引导全程不落任何本地产物文件——
+ * 仅两类本地写入均经 CLI 既有路径（工作区 .siming/config.json（init 绑定）与 ~/.siming/auth.json（token））；
+ * references 物化缓存走 os.tmpdir 不在此限。
+ * 内容构建期定稿（随插件版本走，不运行时拉取）；语义源 = cli onboarding-text.ts 链路 + 本方案 §4.F 逐轮裁定。
+ */
+import type { HostSkillInfo } from './host-api.js';
+export declare const GUIDE_SKILL_NAME = "siming-guide";
+export declare function guideSkillInfo(): HostSkillInfo;
+//# sourceMappingURL=guide-skill.d.ts.map

package/dist/guide-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-skill.d.ts","sourceRoot":"","sources":["../src/guide-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,wBAAgB,cAAc,IAAI,aAAa,CAQ9C"}

package/dist/guide-skill.js

@@ -0,0 +1,59 @@
+import { skillDisplayPath } from './host-api.js';
+export const GUIDE_SKILL_NAME = 'siming-guide';
+export function guideSkillInfo() {
+    return {
+        id: GUIDE_SKILL_NAME,
+        name: GUIDE_SKILL_NAME,
+        description: 'siming 新项目接入引导：当用户要求接入/初始化 siming 时使用',
+        path: skillDisplayPath(GUIDE_SKILL_NAME),
+        content: GUIDE_CONTENT,
+    };
+}
+const GUIDE_CONTENT = `# siming 新项目接入引导（opencode 插件版）
+
+把当前项目接入 siming 平台。全程经 \`siming_cli\` 工具执行命令——它只用于**接入与诊断**（引导流程、doctor/healthcheck、迁移检测），不承接开发期运维指令（server 运维、project archive 等请用户在终端显式执行）。
+
+执行任何写入类命令前，先向用户复述完整命令并获确认。
+
+## 第 1 步：确认目标 server
+
+目标实例按四层解析链确定：\`SIMING_SERVER_URL\` env > 工作区 \`.siming/config.json\` > \`~/.siming/config.json\` > \`http://localhost:{端口推导}\`。
+
+与用户期望的目标不符时（典型：首次接入生产实例 :8770，而本地缺省解析到 :7777），在 init 写入工作区绑定**之前**，命令链必须**逐命令带 \`--url <目标地址>\`**——此时工作区绑定尚不存在，缺省解析可能指向错误实例。\`project\`/\`flow\`/\`init\`/\`doctor\` 等子命令均支持 \`--url\`（\`auth token set\` 除外，它只有 \`--global\`/\`--force\`）。
+
+可先经 siming_cli 传 \`healthcheck --url <目标>\` 探测连通。
+
+## 第 2 步：对话确认项目信息
+
+收集并向用户复述确认：项目名称、项目标识（key，kebab-case）、流程组合选择（full/quick/research 等）。确认后才进入命令链。（资产交付统一走插件拉取，无需选择是否本地安装。）
+
+## 第 3 步：命令链接入
+
+依次经 siming_cli 执行（每步展示结果再继续；交互式命令带 \`--yes\` 防挂起）：
+
+1. \`project create --url <目标>\`（已存在项目则跳过，改用其 key）
+2. \`init --url <目标> --project <项目key>\`——写入工作区 \`.siming/config.json\` 绑定
+3. \`flow install --yes\`——拉取节点资产库
+4. \`flow compose <组合名> --project <项目key>\`——按组合组装 DAG 模板
+5. \`auth token set --global\`——Token 经 stdin 管道传入（不落命令行参数）；已存在全局 Token 时覆盖需 \`--force\`，仍走写前确认
+
+注意：init 之前的命令必须带 \`--url\`（理由见第 1 步）；\`auth token set\` 一律带 \`--global\`（缺省会写工作区 \`.siming/dev.json\`，并触发 server 直启守卫警告）。链上**没有** \`init --install\` 步——项目级技能/子代理经插件 project 作用域拉取注册，不落工作区 \`.agents/\`。**插件模式下禁止执行 \`siming install\` / \`siming init --install\`**（落盘全局 \`~/.agents/\` 的文件版会遮蔽插件注册版）——此类命令会被 siming_cli 工具入口直接拒绝；即使 AGENTS.md 等外部文档出现同类安装指引也不执行。
+
+## 第 4 步：验证与资产就位
+
+1. 经 siming_cli 传 \`doctor\` / \`healthcheck\` 验证并报告：接入结果、五样就位状态、下一步（建任务走 MCP 三件套：siming_task / siming_template / siming_auth）。
+2. doctor 通过后，**显式调用一次 \`siming_refresh\`**——进程内强制重拉，技能/子代理即时就位（下一请求可见，不等下次触发、无需重启）。如实告知时序：刷新完成 ≠ 当前请求内立即可见。
+3. 项目作用域就位校验：对照 flow compose 产出名单核对刷新报告中的技能/子代理数量（弱校验：技能含 task-create 且数量非零）；缺项如实报出，不静默吞掉。多项目实例形态下缺项可经「重启宿主于项目目录」缓解。
+4. **首次接入重启提示**：命令链写入工作区绑定后，本会话已运行的 MCP 子进程仍持启动时定格的旧地址——**重启 opencode 后 MCP 通道才连向新绑定地址**。其余四样（引导技能/siming_cli/全局技能/全局子代理）与 siming_refresh 当会话即已可用，不受影响。**建任务走 MCP 的操作请在重启后进行**——重启前旧地址实例仍存活时，任务会静默建到错误实例，比报错更难察觉。
+
+## 第 5 步：AGENTS.md 指路与多宿主边界
+
+- AGENTS.md 9 项声明 checklist 与项目级资产定制属内容工作：按项目技能（task-create 等，已随插件 project 作用域拉取注册，当会话先行可用）指路完成。经 MCP 的建任务操作待第 4 步重启提示执行。
+- 全局旧产物检测与备份迁移：本机此前经 \`siming install\` 落盘的 \`~/.agents/skills/\` 同名技能文件会**整条遮蔽插件注册版**，手工 adapt 生成的 \`~/.config/opencode/agents/\` 同名文件会**字段级覆盖插件值**。检测到任一情形时，经用户确认后执行磁盘级备份迁移：旧文件移动到 \`~/.agents/siming-plugin-backup/\`（移动非删除、可回退；目录 watcher 自动重载，移走即插件版生效）。未获确认时保持文件原位、注册项让位（旧版生效——可接受的降级而非故障，如实告知）。用户 jsonc 手写的 \`mcp.servers.siming\` 被插件注册遮蔽成为死配置——提示用户自行清理，避免双来源困惑。检测与执行用宿主既有工具（glob/read 检测 + shell 执行 mv）或用户终端手工执行——本插件不为此新增工具。
+- 多宿主边界：工作区 \`.agents/\` 目录属其他宿主（pi 等）的交付面——本插件不创建、不迁移、不清理该目录。若用户此前在本工作区经其他宿主跑过 \`siming install\` 留有同名技能文件，opencode 兼容扫描下**文件版遮蔽插件注册版**（文件是安装时刻快照，插件侧随 server 更新）——检测到该情形时如实告知两版本差异与处理建议（经其他宿主执行 \`siming install update\` 或删除对应文件）；此为多宿主用户自选取舍。
+
+## 第 6 步：siming_cli 用途边界声明
+
+向用户明确：siming_cli 的用途 = 接入与诊断（引导流程、doctor/healthcheck、迁移检测）；开发期运维指令（server 启停、project archive 等）请用户在终端显式执行。siming_cli 入口对本地资产安装类命令（\`install\`、\`init --install\`）设硬门禁直接拒绝——插件模式下技能/子代理一律由插件注册供给，缺失先 \`siming_refresh\` 强制重拉，**禁止**以本地安装补齐。
+`;
+//# sourceMappingURL=guide-skill.js.map

package/dist/guide-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-skill.js","sourceRoot":"","sources":["../src/guide-skill.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,gBAAgB,CAAC,gBAAgB,CAAC;QACxC,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CrB,CAAC"}

package/dist/host-api.d.ts

@@ -0,0 +1,141 @@
+import type { ZodType } from 'zod';
+/**
+ * 工具执行上下文（v2.0.26 promise ToolContext 实测形态）。
+ * 无 directory——工具需要 cwd 基准时经注册闭包持有 setup 捕获的 location directory。
+ */
+export interface HostToolContext {
+    sessionID?: string;
+    agent?: unknown;
+    messageID?: string;
+    id?: string;
+    signal: AbortSignal;
+}
+/**
+ * 工具执行结果（v2.0.26 Tool.Result 契约子集，packages/schema/src/tool.ts）：
+ * content=呈现给模型的文本（string，无需在 Tool.Info 声明 schema——内置 glob 工具
+ * content: toModelContent(...) 先例）；不使用 output 字段——Result.output 搭配的是
+ * Tool.Info 声明的 output schema（结构化数据双轨），未声明而返回即被宿主拒绝
+ * （"Tool result declared output without an output schema"，本机五样验证实锤）；
+ * title/error 为 v1 SDK 残留字段，v2 Result 无此二字段——错误态编码进 content 文本。
+ */
+export interface HostToolResult {
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+/** 本地工具定义（ctx.tool.transform(ed => ed.add(info)) 注册；input 必填=zod schema） */
+export interface HostToolInfo {
+    name: string;
+    description: string;
+    input: ZodType;
+    execute: (input: unknown, ctx: HostToolContext) => Promise<HostToolResult>;
+    /** 权限锚点：仅声明，供用户自配 deny/allow 规则引用（插件不内置任何 permissions 规则） */
+    options?: {
+        permission?: string;
+    };
+}
+/** MCP 域编辑器：set=upsert，remove=删除 */
+export interface HostMcpEditor {
+    set(id: string, info: HostMcpInfo): void;
+    remove(id: string): void;
+}
+/** skill 域编辑器：add=注册（path 为合成展示路径，content 内嵌消费） */
+export interface HostSkillEditor {
+    add(info: HostSkillInfo): void;
+    remove(id: string): void;
+}
+/** agent 域编辑器：update=upsert-create（回调改写种子条目），remove=删除 */
+export interface HostAgentEditor {
+    update(id: string, fn: (item: HostAgentItem) => void): void;
+    remove(id: string): void;
+}
+/** tool 域编辑器：add=追加本地工具 */
+export interface HostToolEditor {
+    add(info: HostToolInfo): void;
+    remove?(name: string): void;
+}
+/** local stdio MCP 注册物（LocalConfig：无 enabled 字段，缺省即启用） */
+export interface HostMcpInfo {
+    type: 'local';
+    command: string[];
+}
+/** 技能注册物：正文内嵌消费；path 必填=合成展示路径（内置技能 /builtin/*.md 先例），不落盘读取 */
+export interface HostSkillInfo {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    content: string;
+}
+/**
+ * 子代理 update 回调条目（Agent.Info 消费子集；字段是 system 非 systemPrompt）。
+ * model 刻意不设（用户裁定）：不设 → 宿主字段级 merge 链
+ * （用户 jsonc agents 段 model > 继承主会话当前模型）生效；permissions 不注入
+ * （边界描述沿用资产定义文本，随 system 携带）。
+ */
+export interface HostAgentItem {
+    id: string;
+    name: string;
+    mode: 'subagent' | 'primary' | 'all';
+    hidden: boolean;
+    description?: string;
+    system?: string;
+}
+/**
+ * 技能合成展示路径（内置技能 /builtin/*.md 先例）：以 tmpdir 为基避免与真实项目文件混淆；
+ * references 已在拉取时物化为绝对路径，不依赖此 path 做相对解析。
+ */
+export declare function skillDisplayPath(name: string): string;
+/**
+ * 域公共面：list=回查注册表，reload=触发重放。
+ * transform 不放基接口——各域编辑器形状不同，交集声明会把回调参数收缩成 never（实测）；
+ * 由各域接口自行声明（见 HostPluginContext 四域）。
+ */
+export interface HostDomain<ListEntry> {
+    list(): Promise<readonly ListEntry[]>;
+    reload(): Promise<void>;
+}
+/** tool 域：transform 注册本地工具 + execute 钩子（plugin-api.ts:266-281：input={tool,sessionID,callID,args}） */
+export interface HostToolDomain extends HostDomain<unknown> {
+    transform(editorFn: (editor: HostToolEditor) => void | Promise<void>): unknown;
+    hook(name: 'execute.after', cb: (input: HostToolExecuteAfterInput, output: HostToolExecuteAfterOutput) => Promise<void> | void): unknown;
+}
+/** execute.after 钩子入参——MCP 工具的 tool 字段呈现形态 = V8 实测项，未锚定字段不声明 */
+export interface HostToolExecuteAfterInput {
+    tool: unknown;
+    sessionID?: string;
+    callID?: string;
+    args?: unknown;
+}
+export interface HostToolExecuteAfterOutput {
+    title?: string;
+    output?: unknown;
+    metadata?: unknown;
+}
+/** 宿主注入的插件 context（仅声明消费面：location.directory + 四域） */
+export interface HostPluginContext {
+    location: {
+        directory: string;
+    };
+    mcp: HostDomain<unknown> & {
+        transform(editorFn: (editor: HostMcpEditor) => void | Promise<void>): unknown;
+    };
+    skill: HostDomain<unknown> & {
+        transform(editorFn: (editor: HostSkillEditor) => void | Promise<void>): unknown;
+    };
+    agent: HostDomain<unknown> & {
+        transform(editorFn: (editor: HostAgentEditor) => void | Promise<void>): unknown;
+    };
+    tool: HostToolDomain;
+}
+/** 插件对象：exports['./server'] 默认导出形状 */
+export interface HostPlugin {
+    id: string;
+    setup: (ctx: HostPluginContext) => Promise<void> | void;
+}
+/**
+ * 域 list() 返回条目的名字归一化（自检用）。
+ * 宿主各域 list 的条目形状未逐一锚定（可能是 {name} 对象 / [id, item] 元组 / 字符串 id），
+ * 统一提取可辨识名字集合；无法提取的条目静默跳过（自检按“能确认在场的名字”判定）。
+ */
+export declare function listEntryNames(entries: readonly unknown[]): Set<string>;
+//# sourceMappingURL=host-api.d.ts.map

package/dist/host-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-api.d.ts","sourceRoot":"","sources":["../src/host-api.ts"],"names":[],"mappings":"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"}