@givolt/i3-composer-agent 2.3.3 → 2.3.5

package/.agents/plugins/marketplace.json

@@ -6,7 +6,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.3.3",
+      "version": "2.3.5",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "source": {
         "source": "local",

package/.claude/commands/i3-prototype.md

@@ -19,3 +19,5 @@ Use the i3-ui-prototype skill in the main session for the user's request below.
 $ARGUMENTS
 
 With no arguments use create; explicit analysis or read-only limits take precedence. Preserve the user's scope, manual edits, fixed inputs and approved baselines. Use supporting engineering, framework, design and browser skills as the working skill requires; keep its workflow and evidence requirements there.
+
+For a managed Buddy implementation, execute the Skill's printed absolute execution-begin command on its own and wait for status=bound before writing UI. Follow immediate recovery feedback and retry the blocked operation; an outer tool success does not override an inner stage failure.

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.3.3",
+      "version": "2.3.5",
       "source": "./",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "homepage": "https://github.com/49780522/i3-composer-agent",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.gemini/commands/i3-prototype.toml

@@ -18,4 +18,6 @@ Use the i3-ui-prototype skill in the main session for the user's request below.
 $ARGUMENTS
 
 With no arguments use create; explicit analysis or read-only limits take precedence. Preserve the user's scope, manual edits, fixed inputs and approved baselines. Use supporting engineering, framework, design and browser skills as the working skill requires; keep its workflow and evidence requirements there.
+
+For a managed Buddy implementation, execute the Skill's printed absolute execution-begin command on its own and wait for status=bound before writing UI. Follow immediate recovery feedback and retry the blocked operation; an outer tool success does not override an inner stage failure.
 """

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v2.3.3
+# i3 Composer Agent v2.3.5
 
 **Intelligence. Integration. Innovation.**
 
@@ -25,7 +25,7 @@ WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；
 搜索、翻页和命令参数预选均保留选择。搜索外 `q`、Esc 或 Ctrl-C 取消。
 确认工具后选择项目/全局范围并确认安装。
 
-可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。CodeBuddy 的安装范围、Hooks、启用组、IDE／CLI、路由、UIUX／antDv 及最终确认均支持数字选择。新范围推荐启用 Hooks，已有安装默认保留现状；升级时要启用 Hooks 请明确选“启用”。UIUX／antDv 可选择安装两项、单项或跳过，之后也可补装。
+可直接输入工具编号，例如 `1` 选择 CodeBuddy，或 `1,2` 多选，再按回车。安装范围、UIUX／antDv 及最终确认支持数字选择。CodeBuddy／WorkBuddy 默认注册原型审计 Hooks，保留明确禁用状态；无需选择 Hook 组或 IDE／CLI。其他原版 Hook 脚本随包交付，按需通过统一管理器另行启用。UIUX／antDv 可选择安装两项、单项或跳过，之后也可补装。
 
 全部目标均安装 26 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
 全部目标同时提供 10 个命令和 4 个 Agent 角色提示。

package/bin/i3-composer-agent.cjs

@@ -23,6 +23,7 @@ ${pkg.name}
   npx ${pkg.name} --agents codebuddy,codex --scope project --yes
   npx ${pkg.name} --codebuddy --scope project --yes --prototype-skills uiux,antdv
   npx ${pkg.name} prototype-deps check --host codex --scope project --project <project>
+  npx ${pkg.name} prototype-deps query --host codebuddy --scope project --project <project> --kind info --component Table
   npx ${pkg.name} prototype-deps install --host workbuddy --scope global --skills uiux,antdv
   npx ${pkg.name} hooks list --host codebuddy --scope project --project <project>
   npx ${pkg.name} --prepare --claude --dir <directory>
@@ -38,11 +39,11 @@ ${pkg.name}
   --project-dir <dir> 项目安装根目录，默认当前目录
   --prototype-skills <ids> 可选原型依赖：none、uiux、antdv、uiux,antdv；向导数字选择，--yes 未指定时跳过
   --migrate-tools     显式迁移有 i3 来源记录的旧独立 antDv 工具；仅项目范围且需选择 antdv
-  --hooks <action>    CodeBuddy 统一 Hooks：keep（非交互默认）/ enable / list / check / disable
+  --hooks <action>    默认注册原型 Hooks；keep 保留 / enable / list / check / disable
   --hook-groups <ids> session-start,sdd-cache,simplify-ignore,prototype 或 all；启停默认 prototype
   --codebuddy-skill-routing <mode> hook（明确需要会话注入）/ native（已有原生路由）
   --prototype-hooks <action> 旧参数保留，仅管理 prototype 组
-  --codebuddy-product <form> 启用时明确 ide 或 cli；CLI 注册后需在 /hooks 审核
+  --codebuddy-product <form> 旧版 ide / cli 参数兼容；新注册默认 auto 自动识别
   --codebuddy-transcript-root <dir|auto> 默认自动识别；可选手动原生日志限制，auto 切回自动
   --codebuddy-version <version> 实际宿主版本，便于核验记录
   --yes              确认明确指定的非交互安装
@@ -57,13 +58,13 @@ ${pkg.name}
 
 终端向导先显示常用工具，WorkBuddy 在第 2 项；选择“更多”可分页/搜索全部工具。
 输入工具编号（如 1,2）后回车，或上下键移动/跨页、空格勾选、回车确认；q/Esc 退出。
-范围、Hooks、IDE/CLI、可选原型依赖和最终确认使用数字选择，Hook 组支持逗号分隔数字多选。
+范围、可选原型依赖和最终确认使用数字选择；默认注册原型 Hooks，不再选择 IDE/CLI 或 Hook 组。
 CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
 其他工具通过 Skills 调用，短命令支持取决于宿主。
 所有工具默认安装单份 skills、commands、agents；配套资料集中在 i3-composer-agent/。
 评测、脚本和 Hook 读取同一份已安装技能。--prepare 用于另行导出标准插件并按宿主方式注册。
 WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
-评测需主动运行；向导可注册 CodeBuddy Hooks，实际生效仍需宿主审核/重载和回调验证。
+评测需主动运行；CodeBuddy/WorkBuddy 默认注册原型 Hooks，保留明确禁用状态。实际生效需宿主审核/重载和回调验证。
 --prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
@@ -170,7 +171,7 @@ async function main() {
   if (args.length === 1 && args[0] === '--version') { console.log(pkg.version); return; }
   if (args[0] === 'prototype-deps') {
     const dependencies = require('../skills/i3-ui-prototype/scripts/prototype-dependencies.cjs');
-    console.log(JSON.stringify(await dependencies.main(args.slice(1)), null, 2));
+    const result=await dependencies.main(args.slice(1));console.log(JSON.stringify(result, null, 2));if(result.status==='failed')process.exitCode=1;
     return;
   }
   if (['hooks','prototype-hooks'].includes(args[0])) {
@@ -200,7 +201,7 @@ async function main() {
       else if (arg === '--hooks') {if(!['keep','enable','disable','list','check'].includes(value))throw new Error('Hooks 请选择 keep / enable / disable / list / check');options.hooks=value;}
       else if (arg === '--hook-groups') {require('../hooks/manage.cjs').selection(value);options.hookGroups=value;}
       else if (arg === '--codebuddy-skill-routing') {if(!['native','hook'].includes(value))throw new Error('请选择 native 或 hook');options.codebuddySkillRouting=value;}
-      else if (arg === '--codebuddy-product') {if(!['ide','cli'].includes(value))throw new Error('CodeBuddy 形态请选择 ide 或 cli');options.codebuddyProduct=value;}
+      else if (arg === '--codebuddy-product') {if(!['auto','ide','cli'].includes(value))throw new Error('CodeBuddy 形态请选择 auto、ide 或 cli');options.codebuddyProduct=value;}
       else if (arg === '--codebuddy-transcript-root') options.codebuddyTranscriptRoot=value==='auto'?'auto':path.resolve(value);
       else if (arg === '--codebuddy-version') options.codebuddyVersion=value;
       else options.projectDir = path.resolve(value);
@@ -216,9 +217,9 @@ async function main() {
   }
   options.agents = installer.selectAgents(options.agents);
   if(options.prototypeHooks!==undefined&&(options.hooks!==undefined||options.hookGroups!==undefined))throw new Error('--prototype-hooks 旧参数不可与 --hooks / --hook-groups 混用');
-  const hookOptions=()=>({action:options.hooks||options.prototypeHooks||'keep',groups:options.hookGroups||(options.prototypeHooks!==undefined?'prototype':undefined),skillRouting:options.codebuddySkillRouting,host:'codebuddy',scope:options.scope,project:options.projectDir,product:options.codebuddyProduct,transcriptRoot:options.codebuddyTranscriptRoot,productVersion:options.codebuddyVersion,agents:options.agents});
+  const hookOptions=(host=options.agents.find(id=>['codebuddy','workbuddy'].includes(id))||'codebuddy')=>({action:options.hooks||options.prototypeHooks||'default',groups:options.hookGroups||(options.prototypeHooks!==undefined?'prototype':undefined),skillRouting:options.codebuddySkillRouting,host,scope:options.scope,project:options.projectDir,product:options.codebuddyProduct,transcriptRoot:options.codebuddyTranscriptRoot,productVersion:options.codebuddyVersion,agents:options.agents});
   if(['list','check','disable'].includes(hookOptions().action)) {
-    if(options.agents.length!==1||options.agents[0]!=='codebuddy'||!options.scope)throw new Error('Hooks check / disable 需明确 --codebuddy --scope project|global，不执行安装');
+    if(options.agents.length!==1||!['codebuddy','workbuddy'].includes(options.agents[0])||!options.scope)throw new Error('Hooks check / disable 需明确一个 Buddy 宿主和 --scope project|global，不执行安装');
     const manager=require('../hooks/manage.cjs');
     const result=['list','check'].includes(hookOptions().action)?manager.check(hookOptions()):manager.configure({...hookOptions(),preview:!!options.dryRun});
     console.log(JSON.stringify(result,null,2));if(result.status==='failed')process.exitCode=1;return;
@@ -231,22 +232,24 @@ async function main() {
     throw new Error('请在交互终端使用向导，或明确指定 --agents <ids> --scope project|global --yes。');
   }
   if (options.migrateTools && (options.scope !== 'project' || !options.prototypeSkills?.split(',').includes('antdv'))) throw new Error('--migrate-tools requires project scope and selected antdv');
-  if(hookOptions().action!=='keep'&&!options.agents.includes('codebuddy'))throw new Error('首期统一 Hooks 仅适配 CodeBuddy');
+  const buddyHosts=options.agents.filter(id=>['codebuddy','workbuddy'].includes(id));
+  if(!['keep','default'].includes(hookOptions().action)&&!buddyHosts.length)throw new Error('原型 Hooks 当前适配 CodeBuddy 和 WorkBuddy');
   const hookManager=require('../hooks/manage.cjs');
-  const hookChange=options.agents.includes('codebuddy')?hookManager.prepare(hookOptions()):null;
+  const hookChanges=(options.scope==='project'?buddyHosts.slice(0,1):buddyHosts).map(host=>hookManager.prepare(hookOptions(host)));
+  const hookSummary=hookChanges.length===1?hookChanges[0].summary:hookChanges.map(change=>change.summary);
   const plan = installer.planInstallation(options);
   if (options.dryRun) {
     console.log(JSON.stringify({ name, version: pkg.version, mode: plan.mode, scope: plan.scope, agents: plan.agents, targets: plan.targets, conflicts: plan.conflicts, reused: plan.reused,
-      ...(options.prototypeSkills !== undefined ? { optionalPrototypeSkills: options.prototypeSkills, migrateTools: !!options.migrateTools } : {}),...(hookChange?{hooks:hookChange.summary}:{}) }, null, 2));
+      ...(options.prototypeSkills !== undefined ? { optionalPrototypeSkills: options.prototypeSkills, migrateTools: !!options.migrateTools } : {}),...(hookChanges.length?{hooks:hookSummary}:{}) }, null, 2));
     return;
   }
   if (!options.yes) {
-    const confirmed = await require('./wizard.cjs').confirm(plan, { prototypeSkills: options.prototypeSkills, hooks: hookChange?.summary });
+    const confirmed = await require('./wizard.cjs').confirm(plan, { prototypeSkills: options.prototypeSkills, hooks: hookChanges.length?hookSummary:null });
     if (!confirmed) { console.log('安装已取消，未修改文件。'); return; }
     options.force = plan.conflicts.length > 0;
   }
   installer.executeInstallation(plan, { force: options.force });
-  if(hookChange?.summary.changed) {
+  for(const hookChange of hookChanges)if(hookChange.summary.changed) {
     try {console.log(JSON.stringify({hooks:hookManager.apply(hookChange)},null,2));}
     catch(error){throw new Error(`核心文件已安装，Hooks 注册未完成；请保留当前配置并重试或提供错误。${error.message}`);}
   }
@@ -259,13 +262,13 @@ async function main() {
     console.log(`评测资料：${target.evalsDirectory}`);
     console.log(`完整校验：进入 "${target.toolkitDirectory}" 后运行 npm test`);
     console.log(`中文评测：node "${path.join(target.scriptsDirectory, 'run-evals.js')}" --locale zh-CN --min-rank1 95`);
-    console.log(`Hooks：${target.hooksDirectory}${target.agents.includes('codebuddy')?'；统一检查：node "'+path.join(target.hooksDirectory,'manage.cjs')+'" check --host codebuddy --scope '+plan.scope+' --project "'+options.projectDir+'"':'；按宿主协议手动配置'}`);
+    console.log(`Hooks：${target.hooksDirectory}${target.agents.some(id=>['codebuddy','workbuddy'].includes(id))?'；统一检查：node "'+path.join(target.hooksDirectory,'manage.cjs')+'" check --host '+target.agents.find(id=>['codebuddy','workbuddy'].includes(id))+' --scope '+plan.scope+' --project "'+options.projectDir+'"':'；按宿主协议手动配置'}`);
   }
   for (const file of plan.preserved || []) console.log(`保留了用户文件：${file}`);
   console.log('请重新加载 IDE 窗口或新建宿主会话以发现安装内容。');
   if (plan.agents.some(id => !['codebuddy', 'workbuddy', 'claude-code'].includes(id))) console.log('这些工具通过技能 ID 调用；生命周期短命令支持取决于宿主。');
   console.log('核心安装完成。评测说明见 i3-composer-agent/evals/README.md。');
-  if (hookChange) console.log(hookChange.summary.action === 'enable' ? `Hooks 已注册：${hookChange.summary.enabledGroups.join('、')}。${hookChange.summary.product === 'cli' ? '请在 CodeBuddy Code /hooks 审核并开启新会话。' : '请重载 CodeBuddy 窗口。'}实际触发另行检查。` : 'Hooks 保留现状；文件已提供不代表启用，请使用 hooks check 检查当前状态。');
+  for(const hookChange of hookChanges)console.log(hookChange.summary.enabledGroups.length?`Hooks 已注册：${hookChange.summary.enabledGroups.join('、')}；${hookChange.summary.host}，IDE/CLI 自动识别。桌面端重载；CodeBuddy CLI 在 /hooks 审核。实际调用与补调另行验证。`:'Hooks 保留禁用或未启用状态；使用 hooks check 检查。');
   if (options.prototypeSkills !== undefined && options.prototypeSkills !== 'none') {
     try {
       // Shared project targets (for example CodeBuddy + WorkBuddy) prepare once.

package/bin/wizard.cjs

@@ -1,8 +1,6 @@
 'use strict';
 
 const readline = require('node:readline');
-const fs = require('node:fs');
-const path = require('node:path');
 const { selectAgents } = require('./install.cjs');
 const { selectTools } = require('./tool-selector.cjs');
 
@@ -33,12 +31,7 @@ async function menu(ask, prompt, values, fallback) {
     console.log(`请选择数字 ${Object.keys(values).join('、')}，或 0 取消。`);
   }
 }
-function existingInstallation(options, scope) {
-  const { base } = require('../hooks/manage.cjs').location({ scope, project: options.projectDir });
-  return ['.i3-composer-agent.json', 'settings.json', 'settings.local.json', 'state/i3-prototype/installation.json', 'state/i3-composer-agent/hooks.json']
-    .some(file => fs.existsSync(path.join(base, file)));
-}
-async function chooseSettings(options, agents, ask, services = {}) {
+async function chooseSettings(options, agents, ask) {
     let scope = options.scope;
     while (!scope) {
       const input = await ask('安装范围：1. 项目（当前项目），2. 全局（所有项目）[1]（0/q/取消退出）： ');
@@ -47,48 +40,13 @@ async function chooseSettings(options, agents, ask, services = {}) {
       else if (['2', 'global', '全局'].includes(input)) scope = 'global';
       else console.log('请选择 1（项目）或 2（全局）。');
     }
-    let hooks=options.hooks||options.prototypeHooks||'keep',hookGroups=options.hookGroups||(options.prototypeHooks!==undefined?'prototype':undefined),codebuddyProduct=options.codebuddyProduct,codebuddyTranscriptRoot=options.codebuddyTranscriptRoot,codebuddySkillRouting=options.codebuddySkillRouting;
-    if (agents.includes('codebuddy') && agents.includes('workbuddy') && options.hooks === undefined && options.prototypeHooks === undefined) {
-      console.log('CodeBuddy 与 WorkBuddy 本次共享目录，保留现有 Hooks；需要启用时请在 CodeBuddy 独立范围配置。');
-    } else if (agents.includes('codebuddy')) {
-      if (options.hooks === undefined && options.prototypeHooks === undefined) {
-        const existing = (services.existingInstallation || existingInstallation)(options, scope);
-        const unsupported = process.platform === 'win32';
-        if (unsupported) console.log('Windows Hooks 引用尚未完成宿主验证，默认保留；核心技能仍可安装。');
-        const fallback = existing || unsupported ? '2' : '1';
-        hooks = await menu(ask, `CodeBuddy 统一 Hooks：1. 选择启用${existing || unsupported ? '' : '（首次安装推荐）'}，2. 保留现状${existing ? '（已有配置，推荐）' : ''} [${fallback}]（0 取消）： `, { '1': 'enable', '2': 'keep' }, fallback);
-        if (hooks === null) return null;
-      }
-      if (hooks === 'enable' && !hookGroups) {
-        console.log('Hook 组：1. 原型执行审计；2. Skill 发现与路由；3. 官方文档请求缓存；4. 代码块简化保护；5. 全部。');
-        while (!hookGroups) {
-          const answer = await ask('启用组：输入数字，可多选（例如 1,3,4）[1]（0 取消）： ');
-          if (cancelled(answer)) return null;
-          const numbers = (answer || '1').split(/[,，]/).map(x => x.trim());
-          if (numbers.every(x => ['1', '2', '3', '4'].includes(x))) hookGroups = [...new Set(numbers)].map(x => ({ '1': 'prototype', '2': 'session-start', '3': 'sdd-cache', '4': 'simplify-ignore' })[x]).join(',');
-          else if (numbers.length === 1 && numbers[0] === '5') hookGroups = 'all';
-          else console.log('请选择 1、2、3、4（可逗号多选），或 5（全部）。');
-        }
-      }
-      const chosen=require('../hooks/manage.cjs').selection(hookGroups,hooks);
-      if (hooks === 'enable' && !codebuddyProduct) {
-        codebuddyProduct = await menu(ask, 'CodeBuddy 形态：1. 桌面 IDE，2. CodeBuddy Code CLI [1]（0 取消）： ', { '1': 'ide', '2': 'cli' }, '1');
-        if (codebuddyProduct === null) return null;
-      }
-      if (hooks === 'enable' && chosen.includes('session-start')) {
-        if (!codebuddySkillRouting) {
-          codebuddySkillRouting = await menu(ask, 'Skill 路由：1. 需要 Hook 会话提示，2. 已有原生路由（自动去除 Skill 发现组）[1]（0 取消）： ', { '1': 'hook', '2': 'native' }, '1');
-          if (codebuddySkillRouting === null) return null;
-        }
-        if (codebuddySkillRouting === 'native') {
-          const remaining = chosen.filter(id => id !== 'session-start');
-          hookGroups = remaining.length ? remaining.join(',') : undefined;
-          if (!remaining.length) hooks = 'keep';
-          console.log('已选择原生路由，本次不新增 session-start；其余所选组保留，已有配置不会被移除。');
-        }
-      }
-      if(hooks==='enable'&&chosen.includes('prototype')&&!codebuddyTranscriptRoot)console.log('新启用的原型审计默认从 Hook 自动识别会话日志；升级保留已有手动限制。特殊环境可使用 --codebuddy-transcript-root <目录|auto>。');
-    }
+    const supported=agents.some(host=>['codebuddy','workbuddy'].includes(host));
+    let hooks=options.hooks||options.prototypeHooks||(supported?'default':'keep');
+    const hookGroups=options.hookGroups||'prototype',codebuddyProduct=options.codebuddyProduct,
+      codebuddyTranscriptRoot=options.codebuddyTranscriptRoot,codebuddySkillRouting=options.codebuddySkillRouting;
+    if(process.platform==='win32'&&hooks==='default'){
+      hooks='keep';console.log('Windows 原型 Hooks 尚待实机验证，本次保留设置。');
+    }else if(supported&&hooks==='default')console.log('默认注册原型审计 Hooks；保留明确禁用状态。IDE/CLI 运行时自动识别，其他 Hook 组不新增注册。');
     let prototypeSkills = options.prototypeSkills;
     if (prototypeSkills === undefined) {
       console.log('可选原型依赖：所选项将联网下载官方固定版本，安装到本次宿主范围；已有可用内容复用。');
@@ -116,8 +74,10 @@ async function confirm(plan, selection = {}) {
   if (plan.conflicts.length) console.log(`将替换 ${plan.conflicts.length} 个已有内容；安装成功后清理旧文件，失败则恢复。`);
   if (plan.reused.length) console.log(`将复用同版本的 ${plan.reused.length} 个未修改内容。`);
   if (selection.hooks) {
-    console.log(`CodeBuddy Hooks：${selection.hooks.action === 'enable' ? '启用 ' + selection.hooks.groups.join('、') : '保留现状'}${selection.hooks.product ? '；' + (selection.hooks.product === 'ide' ? '桌面 IDE' : 'CLI') : ''}。`);
-    if (selection.hooks.action === 'enable') console.log(selection.hooks.product === 'cli' ? '注册后仍需在 CodeBuddy Code /hooks 审核并开启新会话。' : '注册后请重载 CodeBuddy 窗口验证实际回调。');
+    for(const hook of Array.isArray(selection.hooks)?selection.hooks:[selection.hooks]){
+      console.log(`${hook.host} Hooks：${hook.action==='enable'?'注册 '+hook.groups.join('、'):'保留现状'}；IDE/CLI 自动识别。`);
+      console.log('桌面端重载；CodeBuddy CLI 在 /hooks 审核。真实调用和补调须在宿主验证。');
+    }
   }
   if (selection.prototypeSkills !== undefined) console.log(`可选依赖：${selection.prototypeSkills === 'none' ? '跳过' : selection.prototypeSkills.split(',').map(id => id === 'uiux' ? 'UIUX Pro Max' : 'antDv 官方 Skill 与工具').join('、')}。`);
   console.log('包含技能、共享资料和完整评测/Hook/脚本配套。安装不执行评测。');

package/commands/i3-prototype.toml

@@ -18,4 +18,6 @@ Use the i3-ui-prototype skill in the main session for the user's request below.
 $ARGUMENTS
 
 With no arguments use create; explicit analysis or read-only limits take precedence. Preserve the user's scope, manual edits, fixed inputs and approved baselines. Use supporting engineering, framework, design and browser skills as the working skill requires; keep its workflow and evidence requirements there.
+
+For a managed Buddy implementation, execute the Skill's printed absolute execution-begin command on its own and wait for status=bound before writing UI. Follow immediate recovery feedback and retry the blocked operation; an outer tool success does not override an inner stage failure.
 """

package/docs/codebuddy-setup.md

@@ -48,7 +48,7 @@ CodeBuddy 与 WorkBuddy 项目共用 `.codebuddy/`；同版本追加客户端会
 npx @givolt/i3-composer-agent --codebuddy --scope project --yes --prototype-skills uiux,antdv
 ```
 
-值为 none、uiux、antdv 或 uiux,antdv；默认 none。可选工具跟随宿主和项目／全局范围，位于基址下 `tools/i3-prototype/`；旧项目 `.prototype-tools` 保持读取兼容。需要固定本次版本时使用 `npx @givolt/i3-composer-agent@2.3.3`。已安装后可随时单独检测／补装，无需重装 i3：
+值为 none、uiux、antdv 或 uiux,antdv；默认 none。可选工具跟随宿主和项目／全局范围，位于基址下 `tools/i3-prototype/`；旧项目 `.prototype-tools` 保持读取兼容。需要固定本次版本时使用 `npx @givolt/i3-composer-agent@2.3.5`。已安装后可随时单独检测／补装，无需重装 i3：
 
 ```bash
 node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --host codebuddy --scope project --project .
@@ -86,7 +86,7 @@ node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs instal
 
 工具前置使用依赖检测返回的实际 Node 入口，也兼容已有 `.prototype-tools/node_modules` 布局或宿主明确的绝对入口；缺失时只读分析报告未决项，不以 npm exec／npx 下载或补缓存。工具准备须有明确选择，写范围仅指定工具目录，不含业务内容或 SDK。analyze 只交覆盖、选型、验收计划和缺口，不套用创建阶段的 UIUX 采纳、构建或浏览器门禁。
 
-本轮新原生流程还要求执行者真实调用 `i3-browser-testing-with-devtools` Skill，并使用 Chrome DevTools MCP 对当前构建取得 DOM／计算样式、截图、console、network、可访问性和性能观测。只读取 Skill 文件或运行 Playwright 脚本都不等于调用该 Skill；Playwright 保留为原型专项补充。缺可调用 Skill 或 MCP 时整链不 complete，按已授权范围准备宿主工具后再验；analyze 不启动或安装浏览器。具体工具接入以实际宿主暴露为准，不能从其他会话或维护 smoke 推断当前执行环境可用。旧实例按固定合同保留，其他宿主等效结果单列。
+本轮新原生流程还要求执行者真实调用 `i3-browser-testing-with-devtools` Skill，并使用 Chrome DevTools MCP 对当前构建取得 DOM／计算样式、截图、console、network、可访问性和性能观测。只读取 Skill 文件或运行 Playwright 脚本都不等于调用该 Skill；Playwright 仅保留给历史设备列表固定合同作专项补充。缺可调用 Skill 或 MCP 时整链不 complete，按已授权范围准备宿主工具后再验；analyze 不启动或安装浏览器。具体工具接入以实际宿主暴露为准，不能从其他会话或维护 smoke 推断当前执行环境可用。旧实例按固定合同保留，其他宿主等效结果单列。
 
 新完整模板原生流程默认包含明亮、暗黑、清新、科技，首次默认明亮，菜单无编号；生成工程用原生框架主题，验证四预设、刷新记忆、实例隔离及业务状态保留。旧实例继续按原有固定合同，不隐式增加能力；步骤见首期指南。
 
@@ -106,7 +106,7 @@ node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs preview prototyp
 
 在业务项目运行 `node .codebuddy/i3-composer-agent/scripts/run-evals.js --min-rank1 95`，
 可检查中英文触发，不调用模型；进入 `.codebuddy/i3-composer-agent/` 可运行 `npm test` 和 `node scripts/run-evals.js --locale zh-CN --min-rank1 95`。全局安装使用脚本的全局绝对路径。五项校验、行为评测和样例用法见
-[评测说明](../evals/README.md)。Hooks 默认只分发，统一管理如下。
+[评测说明](../evals/README.md)。CodeBuddy／WorkBuddy 默认注册原型审计 Hooks，其他组按需管理。
 
 ## CodeBuddy 统一 Hooks 管理
 
@@ -121,13 +121,13 @@ node .codebuddy/i3-composer-agent/hooks/manage.cjs enable --host codebuddy --sco
 node .codebuddy/i3-composer-agent/hooks/manage.cjs disable --host codebuddy --scope project --project . --groups sdd-cache
 ```
 
-全局改用 `~/.codebuddy/i3-composer-agent/hooks/manage.cjs` 和 `--scope global`，继续指定测试项目来判断有效来源。发行 CLI 可用 `hooks list|check|enable|disable` 子命令；安装时使用 `--hooks enable --hook-groups <ids>`，默认 keep 保留既有开关。启停不指定组时兼容旧用法仅针对 prototype，list/check 默认全部。
+全局改用 `~/.codebuddy/i3-composer-agent/hooks/manage.cjs` 和 `--scope global`，继续指定测试项目来判断有效来源。发行 CLI 可用 `hooks list|check|enable|disable` 子命令；安装时使用 `--hooks enable --hook-groups <ids>`，默认注册 prototype 并保留明确禁用，显式 keep 保留全部既有开关。启停不指定组时兼容旧用法仅针对 prototype，list/check 默认全部。
 
-`session-start` 需要明确 `--skill-routing hook`，已有原生路由时不选该组；安装器对应 `--codebuddy-skill-routing hook`。上游三组需要 Bash、jq 和相应 SHA 工具，缓存另需 curl，缺依赖会在启用前拒绝；不自动安装。prototype 需要真实 `--product ide|cli`；项目／全局新启用默认从 Hook 自动识别当前会话日志，可选 `--transcript-root <实际目录|auto>`。已有手动限制保留，首次尚无原生事件显示 awaiting-native-event，不能当成已验收。全局跟随绝对 CODEBUDDY_CONFIG_DIR，默认 ~/.codebuddy；不移动原生日志。原型严格证据规则见 Skill 的 execution-evidence 参考资料。
+`session-start` 需要明确 `--skill-routing hook`，已有原生路由时不选该组；安装器对应 `--codebuddy-skill-routing hook`。上游三组需要 Bash、jq 和相应 SHA 工具，缓存另需 curl，缺依赖会在启用前拒绝；不自动安装。prototype 新注册默认 auto 自动识别；旧 `--product ide|cli` 兼容。项目／全局新启用默认从 Hook 自动识别当前会话日志，可选 `--transcript-root <实际目录|auto>`。已有手动限制保留，首次尚无原生事件显示 awaiting-native-event，不能当成已验收。全局跟随绝对 CODEBUDDY_CONFIG_DIR，默认 ~/.codebuddy；不移动原生日志。原型严格证据规则见 Skill 的 execution-evidence 参考资料。
 
 配置合并到所选范围 `settings.json`，通用归属在 `state/i3-composer-agent/hooks.json`，原型归属保持 `state/i3-prototype/installation.json`。上游适配缓存在 `<host-base>/cache/i3-composer-agent/hooks/<projectKey>/`；全局按项目隔离。已识别的手动原版注册只报告，不自动接管或重复注册。代码块保护运行时会临时替换文件内容，存在未恢复备份时拒绝移除该组，先结束会话恢复。
 
-IDE 项目设置覆盖全局；CLI 合并后按组选择有效来源避免同组重复执行。CLI 变更后在原生 `/hooks` 审核并新建会话，IDE 重载。文件存在、注册、回调观察与业务验收分别显示；原版 triggered 不表示已验证模型行为。首期仍待用户实际宿主验收，Windows Hooks 未验证，默认不启用的核心安装不受此限制。
+IDE 项目设置覆盖全局；CLI 合并后按组选择有效来源避免同组重复执行。CLI 变更后在原生 `/hooks` 审核并新建会话，IDE 重载。文件存在、注册、回调观察与业务验收分别显示；原版 triggered 不表示已验证模型行为。首期仍待用户实际宿主验收，Windows Hooks 未验证，Windows 默认保留设置并提示尚待实机验证。
 
 依据：[CodeBuddy IDE Hooks](https://www.codebuddy.cn/docs/ide/Features/Hooks)、[CodeBuddy CLI Hooks](https://www.codebuddy.cn/docs/cli/hooks)。
 
@@ -150,7 +150,7 @@ npx @givolt/i3-composer-agent --prepare --codebuddy
 按宿主选择范围并启用后新建会话。兼容清单声明 `.claude/commands/` 与 `commands/`。
 插件命令示例为 `/i3-composer-agent:i3-spec`、`/i3-composer-agent:i3-plan`、
 `/i3-composer-agent:i3-build auto` 和 `/i3-composer-agent:i3-ship`。
-默认安装和导出均包含完整评测、Hook 与脚本；Hook 不自动启用。
+默认原生安装和导出均包含完整评测、Hook 与脚本；原生安装默认注册 prototype，插件导出不自动启用 Hook。
 文件落盘、宿主发现和模型实际执行应分别验证。
 
 目录遵循 [配置目录参考](https://www.codebuddy.cn/docs/cli/codebuddy-dir)，可参照
@@ -158,3 +158,17 @@ npx @givolt/i3-composer-agent --prepare --codebuddy
 [自定义命令](https://www.codebuddy.cn/docs/ide/User-guide/Slash-Commands) 检查发现与调用。
 
 原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。
+
+
+## 默认原型 Hooks、自动识别与补调
+
+首次项目／全局安装默认注册 prototype，无需选择 IDE 或 CLI，其他上游 Hook 组不新增注册。已有明确禁用保留，显式 --hooks keep 可以跳过；升级保留用户设置与已有其他组。注册不代表已触发；桌面重载、CLI 在 /hooks 审核后按实际项目检查。
+
+```bash
+node .codebuddy/i3-composer-agent/hooks/manage.cjs check --host codebuddy --scope project --project .
+node .codebuddy/i3-composer-agent/hooks/manage.cjs enable --host codebuddy --scope project --project . --groups prototype
+node .codebuddy/i3-composer-agent/hooks/manage.cjs disable --host codebuddy --scope project --project . --groups prototype
+node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs query --host codebuddy --scope project --project . --kind info --component Table --version 1.5.2
+```
+
+query 使用已准备的本地 Node／CLI，不能代替 antDv Skill 加载；知识版本与目标组件版本分别核对。新实例使用 buddy-ab-v2，旧实例保留原合同。漏调 Skill 后受管写入被拒，反馈具体调用名，成功加载后重试；每缺项最多两次、任务最多六次自动纠正，持续失败如实阻塞。记录包含补调和成功重试的原生引用，不能用模型自述或文件读取代替。

package/docs/codex-setup.md

@@ -37,6 +37,6 @@ Codex 已有原生技能路由，勿把元技能全文预加载为常驻上下
 
 ## 可选原型工具
 
-原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。项目安装可使用 `npx @givolt/i3-composer-agent@2.3.3 --codex --scope project --yes --prototype-skills uiux,antdv`；全局安装将 scope 改为 global。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。项目安装可使用 `npx @givolt/i3-composer-agent@2.3.5 --codex --scope project --yes --prototype-skills uiux,antdv`；全局安装将 scope 改为 global。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
 
 原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。

package/docs/other-hosts.md

@@ -6,7 +6,7 @@
 
 ## 使用本地分发目录
 
-以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@2.3.3` 的对应入口。
+以下命令使用完整分发包解压目录里的 CLI，适用于本地测试和离线接入。`/absolute/path/to/package` 均替换为实际解压目录；已发布版本也可使用 `npx @givolt/i3-composer-agent@2.3.5` 的对应入口。
 
 ### fx
 

package/docs/workbuddy-setup.md

@@ -27,7 +27,7 @@ WorkBuddy 的目录选择使用自己的配置，不借用 `CODEBUDDY_CONFIG_DIR
 
 运行 `node ~/.workbuddy/i3-composer-agent/scripts/run-evals.js --min-rank1 95`，检查实际安装技能的中英文触发，
 不会调用模型。进入 `~/.workbuddy/i3-composer-agent/` 运行 `npm test` 可检查完整内容、两种语言及全部脚本回归；原 `.js` 入口保留。项目安装将 `~/.workbuddy/` 换成 `.codebuddy/`。五项校验、行为评测用例、样例和
-脚本用法见 [评测说明](../evals/README.md)。Hook 文件默认提供，启用需适配宿主事件协议。
+脚本用法见 [评测说明](../evals/README.md)。原型审计 Hooks 默认注册，其他原版 Hook 文件保留但不新增注册；实际回调和补调仍需本机验收。
 
 ## 发现和调用
 
@@ -85,6 +85,22 @@ npx @givolt/i3-composer-agent --workbuddy --scope global --yes --force
 
 ## 可选原型工具
 
-原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。推荐使用 `npx @givolt/i3-composer-agent@2.3.3 --workbuddy --scope global --yes --prototype-skills uiux,antdv`；项目安装将 scope 改为 project。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
+原型辅助工具位于本宿主基址的 `tools/i3-prototype/`，支持项目和全局范围；旧项目 `.prototype-tools` 继续读取兼容。推荐使用 `npx @givolt/i3-composer-agent@2.3.5 --workbuddy --scope global --yes --prototype-skills uiux,antdv`；项目安装将 scope 改为 project。可选依赖默认 none，后续也可使用已安装 Skill 的 prototype-dependencies.cjs 单独检测／补装。完整用法见原型 Skill 的 references/optional-skills.md。
 
 原型共享资料统一在项目 prototypes/：新索引 prototypes/index.json，准备范围 prototypes/.preparation/<id>/scope.json。新原生 scope.moduleIds 自动生成 appliesTo；旧索引、输入和实例保持兼容，安装升级不自动迁移。工具及运行缓存使用所选宿主基址；全局浏览器缓存按业务项目身份隔离。详细规则和只读查询／显式迁移命令见 i3-ui-prototype/references/project-layout.md。
+
+
+## 原型 Hooks 与本地 antDv
+
+项目安装注册到 .codebuddy/settings.json，全局注册到 WORKBUDDY_CONFIG_DIR 或 ~/.workbuddy/settings.json。与 CodeBuddy 共用项目目录时，每事件只有一个原型入口；各宿主允许范围、明确禁用和运行状态分别记录。重载 WorkBuddy 后验证，不因文件存在宣称生效。
+
+```bash
+node ~/.workbuddy/i3-composer-agent/hooks/manage.cjs check --host workbuddy --scope global --project "/业务项目"
+node ~/.workbuddy/i3-composer-agent/hooks/manage.cjs enable --host workbuddy --scope global --project "/业务项目" --groups prototype
+node ~/.workbuddy/i3-composer-agent/hooks/manage.cjs disable --host workbuddy --scope global --project "/业务项目" --groups prototype
+node ~/.workbuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs query --host workbuddy --scope global --project "/业务项目" --kind info --component Table --version 1.5.2
+```
+
+项目范围将入口改为 .codebuddy 并使用 --scope project。只读 query 解析本宿主 Node／CLI 入口，不要求全局 antdv 命令；它不代替实际 antDv Skill 调用。新实例使用 --host workbuddy --execution-policy buddy-ab-v2，按 Skill 合同先加载前端／适用专业技能，再实施。
+
+当前适配依据官方插件 Hooks 文档及 WorkBuddy 5.8.3 随包 CLI 源代码核对。六组宿主／范围的文件级集成测试使用合成日志，实际宿主执行状态仍 pending-user。手测须看到漏调拒绝、当前主会话真实成功加载和重试成功；持续失败到预算上限后如实报告阻塞，不能用只读文件或自述代替调用证据。

package/hooks/manage.cjs

@@ -8,7 +8,7 @@ const catalog=[
  {id:'session-start',name:'Skill 发现与路由',origin:'upstream',files:['session-start.sh'],events:['SessionStart'],dependencies:['bash','jq'],condition:'明确 skill-routing=hook；原生路由使用 native，避免重复注入'},
  {id:'sdd-cache',name:'官方文档请求缓存',origin:'upstream',files:['sdd-cache-pre.sh','sdd-cache-post.sh'],events:['PreToolUse','PostToolUse'],dependencies:['bash','jq','curl','sha256'],condition:'实际 WebFetch；仅源站 304 复用'},
  {id:'simplify-ignore',name:'代码块简化保护',origin:'upstream',files:['simplify-ignore.sh'],events:['PreToolUse','PostToolUse','Stop'],dependencies:['bash','jq','sha1'],condition:'使用 simplify-ignore 标记；会在运行期间替换标记块并在 Stop 恢复'},
- {id:'prototype',name:'原型执行审计',origin:'i3',events:['SessionStart','UserPromptSubmit','PreToolUse','PostToolUse','Stop'],dependencies:['node'],condition:'真实 CodeBuddy IDE/CLI；默认从原生 Hook 自动识别日志，支持手动目录限制'},
+ {id:'prototype',name:'原型执行审计',origin:'i3',events:['SessionStart','UserPromptSubmit','PreToolUse','PostToolUse','Stop'],dependencies:['node'],condition:'CodeBuddy IDE/CLI 与 WorkBuddy；原生回调识别身份和日志，有限补调；真实宿主验收另记'},
 ];
 const digest=value=>crypto.createHash('sha256').update(JSON.stringify(value)).digest('hex');
 const sha=bytes=>crypto.createHash('sha256').update(bytes).digest('hex');
@@ -82,7 +82,7 @@ function executable(name,env=process.env) {
 }
 function dependencies(){return Object.fromEntries(['bash','jq','curl','shasum','sha256sum','sha1sum'].map(name=>[name,executable(name)]));}
 function location(options) {
- assert.equal(options.host||'codebuddy','codebuddy','Unified Hooks currently support CodeBuddy only');assert.ok(['project','global'].includes(options.scope),'Specify project or global scope');
+ assert.ok(['codebuddy','workbuddy'].includes(options.host||'codebuddy'),'Unified prototype Hooks support CodeBuddy and WorkBuddy');assert.ok(['project','global'].includes(options.scope),'Specify project or global scope');
  const project=fs.realpathSync(path.resolve(options.project||'.'));assert.ok(fs.statSync(project).isDirectory(),'Project must be a directory');
  return {project,base:options.scope==='project'?path.join(project,'.codebuddy'):modules().P.globalBase(options)};
 }
@@ -102,30 +102,38 @@ function pendingSimplify(base) {
  });
 }
 function prepare(options,runtime={}) {
- const {P,R}=runtime.modules||modules(),{project,base}=runtime.location||location(options),io=R.fileIO,action=options.action||'keep',ids=selection(options.groups,action);
+ const {P,R}=runtime.modules||modules(),{project,base}=runtime.location||location(options),io=R.fileIO,requested=options.action||'keep',ids=selection(options.groups,requested),host=options.host||'codebuddy';
  const settingsPath=path.join(base,'settings.json'),recordPath=path.join(base,'state/i3-composer-agent/hooks.json'),prototypePath=path.join(base,'state/i3-prototype/installation.json');
  const before=io.read(settingsPath),recordText=io.read(recordPath),record=recordText?JSON.parse(recordText):null,prototypeText=io.read(prototypePath),prototype=prototypeText?JSON.parse(prototypeText):null;
- if(action!=='disable'&&(action!=='keep'||record||prototype))assert.ok(process.platform!=='win32','CodeBuddy Hook quoting on Windows has not been validated; default installation without Hooks remains available');
- const product=options.product||record?.product||prototype?.product,settings=config(before);
+ const requestedHosts=[...new Set(options.scope==='project'?(options.agents||[host]).filter(h=>['codebuddy','workbuddy'].includes(h)):[host])];
+ const disabled=new Set(record?.prototypeDisabledHosts||[]);
+ if(requested==='enable'&&ids.includes('prototype'))for(const h of requestedHosts)disabled.delete(h);
+ if(requested==='disable'&&ids.includes('prototype'))for(const h of requestedHosts)disabled.add(h);
+ const selectedHosts=requested==='default'?requestedHosts.filter(h=>!disabled.has(h)):requestedHosts;
+ const action=requested==='default'?(selectedHosts.length&&process.platform!=='win32'?'enable':'keep'):requested;
+ const activeHosts=prototype?.hosts||(prototype?['codebuddy']:[]);
+ const hosts=action==='disable'?activeHosts.filter(h=>!requestedHosts.includes(h)):[...new Set([...activeHosts,...selectedHosts])].sort();
+ if(action!=='disable'&&(action!=='keep'||record||prototype))assert.ok(process.platform!=='win32','Buddy Hook quoting on Windows has not been validated; explicit keep remains available');
+ const product='auto',settings=config(before);
  if(action!=='disable'&&(action!=='keep'||record||prototype)) {
   assert.ok(!settings.disableAllHooks&&!settings.allowManagedHooksOnly,'Host policy prevents automatic Hooks; preserve the policy');
-  const manifest=io.read(path.join(base,'.i3-composer-agent.json'));if(manifest)assert.ok(!JSON.parse(manifest).agents?.includes('workbuddy'),'Shared WorkBuddy scope cannot identify CodeBuddy safely');
-  assert.ok(!options.agents?.includes('workbuddy'),'Use an exclusive CodeBuddy scope for Hooks');
  }
+ if(host==='workbuddy')assert.ok(ids.every(id=>id==='prototype')||['check','list','keep'].includes(action),'WorkBuddy currently registers the prototype group only; upstream adapters remain CodeBuddy-specific');
  if(action==='enable')for(const id of ids)assert.ok(!unmanaged(settings).some(item=>item.id===id),`Unmanaged ${id} Hook already exists; preserve it and resolve the duplicate before enabling`);
  if(ids.includes('simplify-ignore')&&['enable','disable'].includes(action)) {
   for(const candidate of [...new Set([base,path.join(project,'.codebuddy'),P.globalBase?P.globalBase(options):path.join(options.home||os.homedir(),'.codebuddy')])])assert.equal((runtime.pendingSimplify||pendingSimplify)(candidate).length,0,'Simplify protection is still active; finish the session and restore blocks before changing Hooks');
  }
- const prototypeAction=ids.includes('prototype')?action:'keep';
- const prototypeChange=action==='disable'&&!ids.includes('prototype')?{unchanged:true}:P.prepare({...options,project,product,action:prototypeAction,entryPath:path.join(base,'i3-composer-agent/hooks/i3-prototype.cjs'),entrySource:path.join(__dirname,'i3-prototype.cjs')});
- const upstream=planUpstream({...options,base,product,action,record,settingsText:prototypeChange.unchanged?before:prototypeChange.afterText,nodePath:process.execPath,
+ const prototypeAction=ids.includes('prototype')?(action==='disable'&&hosts.length?'keep':action):'keep';
+ const prototypeChange=action==='disable'&&!ids.includes('prototype')?{unchanged:true}:P.prepare({...options,project,product,hosts,action:prototypeAction,entryPath:path.join(base,'i3-composer-agent/hooks/i3-prototype.cjs'),entrySource:path.join(__dirname,'i3-prototype.cjs')});
+ const upstream=planUpstream({...options,base,product:record?.product||options.product,action,record,settingsText:prototypeChange.unchanged?before:prototypeChange.afterText,nodePath:process.execPath,
   hookDirectory:path.join(base,'i3-composer-agent/hooks'),scriptDigest:runtime.scriptDigest||require('./codebuddy-upstream.cjs').bundle(),dependencies:runtime.dependencies||dependencies()});
+ if(disabled.size)upstream.recordAfter={...(upstream.recordAfter||{schemaVersion:1,owner:OWNER,base,scope:options.scope,product:record?.product||'auto',groups:{}}),prototypeDisabledHosts:[...disabled].sort()};
  const changes=[{file:settingsPath,before,after:upstream.afterText},{file:recordPath,before:recordText,after:upstream.recordAfter?json(upstream.recordAfter):null},
   {file:prototypePath,before:prototypeText,after:prototypeChange.unchanged?prototypeText:prototypeChange.recordAfter?json(prototypeChange.recordAfter):null}];
- return {changes,summary:{host:'codebuddy',scope:options.scope,base,product:product||null,action,groups:ids,changed:changes.some(item=>item.before!==item.after),
+ return {changes,summary:{host,scope:options.scope,base,product,action,requestedAction:requested,groups:ids,enabledHosts:prototypeChange.unchanged?activeHosts:prototypeChange.recordAfter?.hosts||[],disabledHosts:[...disabled].sort(),changed:changes.some(item=>item.before!==item.after),
   enabledGroups:[...Object.keys(upstream.recordAfter?.groups||{}),...((prototypeChange.unchanged?prototype:prototypeChange.recordAfter)?['prototype']:[])],
   ...(prototypeChange.summary?.transcript?{transcript:prototypeChange.summary.transcript}:{}),
-  next:product==='cli'?'Review /hooks in CodeBuddy Code and start a new session.':'Reload CodeBuddy and verify actual Hook events. Registration is not activation.'}};
+  next:'Desktop: reload; CodeBuddy CLI: review /hooks. Host identity, actual Skill invocation and recovery require native validation.'}};
 }
 function check(options) {
  const {P,R}=modules(),{project,base}=location(options),io=R.fileIO,ids=selection(options.groups,options.action||'check'),settingsText=io.read(path.join(base,'settings.json')),settings=config(settingsText),deps=dependencies(),items=[];
@@ -146,12 +154,12 @@ function check(options) {
   }catch(e){row.status='failed';row.reason=e.message;}
   items.push(row);
  }
- return {host:'codebuddy',scope:options.scope,base,readOnly:true,changed:false,status:items.some(item=>item.status==='failed')?'failed':'checked',hooks:items,unmanagedHooks:unmanaged(settings),
+ return {host:options.host||'codebuddy',scope:options.scope,base,readOnly:true,changed:false,status:items.some(item=>item.status==='failed')?'failed':'checked',hooks:items,unmanagedHooks:unmanaged(settings),
   next:'files-present is not enabled; registered is not triggered; triggered is not business acceptance. CLI: review /hooks; IDE: reload.'};
 }
 function configure(options){const change=prepare(options);return options.preview?change.summary:apply(change);}
 function main(argv=process.argv.slice(2)) {
- if(argv.includes('--help'))return {usage:'node manage.cjs list|check|enable|disable --host codebuddy --scope project|global --project <directory> [--groups <ids>|all] [--product ide|cli] [--skill-routing hook] [--transcript-root <native-directory>|auto]',hooks:catalog,default:'keep; enable/disable default prototype; list/check default all; transcripts auto for new registrations',nativeValidation:'pending-user'};
+ if(argv.includes('--help'))return {usage:'node manage.cjs list|check|enable|disable --host codebuddy|workbuddy --scope project|global --project <directory> [--groups <ids>|all] [--product auto|ide|cli] [--skill-routing hook] [--transcript-root <native-directory>|auto]',hooks:catalog,default:'Installer defaults prototype, preserving explicit disable; management enable/disable default prototype; list/check default all; identity/transcripts auto for new registrations',nativeValidation:'pending-user'};
  const options={action:argv.shift()||'list',host:'codebuddy',project:process.cwd()};
  assert.ok(['list','check','enable','disable','keep'].includes(options.action),'Choose list, check, enable or disable');
  while(argv.length){const arg=argv.shift();assert.ok(arg.startsWith('--')&&argv[0]&&!argv[0].startsWith('--'),'Hook option needs a value');const key=arg.slice(2).replace(/-([a-z])/g,(_,c)=>c.toUpperCase());assert.ok(['host','scope','project','product','productVersion','transcriptRoot','groups','skillRouting'].includes(key),'Unknown Hook option');options[key]=argv.shift();}

package/package.json

@@ -195,6 +195,8 @@
     "scripts/run-evals.js",
     "scripts/run-regressions.js",
     "scripts/template-adapter-test.js",
+    "scripts/ui-prototype-binding-recovery-test.js",
+    "scripts/ui-prototype-buddy-lifecycle-test.js",
     "scripts/ui-prototype-codebuddy-hook-test.js",
     "scripts/ui-prototype-content-test.js",
     "scripts/ui-prototype-dependencies-test.js",
@@ -205,6 +207,7 @@
     "scripts/ui-prototype-execution-runtime-test.js",
     "scripts/ui-prototype-ide-source-test.js",
     "scripts/ui-prototype-native-test.js",
+    "scripts/ui-prototype-recovery-test.js",
     "scripts/ui-prototype-registration-test.js",
     "scripts/ui-prototype-template-test.js",
     "scripts/ui-prototype-test.js",
@@ -413,6 +416,8 @@
       "scripts/run-evals.js",
       "scripts/run-regressions.js",
       "scripts/template-adapter-test.js",
+      "scripts/ui-prototype-binding-recovery-test.js",
+      "scripts/ui-prototype-buddy-lifecycle-test.js",
       "scripts/ui-prototype-codebuddy-hook-test.js",
       "scripts/ui-prototype-content-test.js",
       "scripts/ui-prototype-dependencies-test.js",
@@ -423,6 +428,7 @@
       "scripts/ui-prototype-execution-runtime-test.js",
       "scripts/ui-prototype-ide-source-test.js",
       "scripts/ui-prototype-native-test.js",
+      "scripts/ui-prototype-recovery-test.js",
       "scripts/ui-prototype-registration-test.js",
       "scripts/ui-prototype-template-test.js",
       "scripts/ui-prototype-test.js",
@@ -438,7 +444,7 @@
       "scripts/validate-versions.js"
     ]
   },
-  "version": "2.3.3",
+  "version": "2.3.5",
   "repository": {
     "type": "git",
     "url": "https://github.com/49780522/i3-composer-agent.git"

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "homepage": "https://github.com/49780522/i3-composer-agent",
   "repository": "https://github.com/49780522/i3-composer-agent"