@givolt/i3-composer-agent 2.1.1 → 2.2.1

package/bin/i3-composer-agent.cjs

@@ -13,9 +13,9 @@ const identity = `i3 Composer Agent v${pkg.version}`;
 const help = `${identity}
 ${pkg.name}
 
-Install engineering skills with a multi-tool installation wizard.
+通过多工具安装向导安装软件工程技能，默认中文回复。
 
-Usage:
+用法：
   npx ${pkg.name}
   npx ${pkg.name} --codebuddy
   npx ${pkg.name} --workbuddy --scope global
@@ -24,28 +24,32 @@ Usage:
   npx ${pkg.name} --prepare --claude --dir <directory>
   npx ${pkg.name} --extract --dir <directory>
 
-Options:
-  --agents <ids>      Comma-separated tool IDs; multiple tools are supported
-  --codebuddy        Preselect CodeBuddy desktop IDE / CodeBuddy Code
-  --workbuddy        Preselect WorkBuddy (global scope recommended)
-  --codex            Preselect Codex
-  --claude           Preselect Claude Code
-  --scope <scope>    project or global (or use --global / --local)
-  --project-dir <dir> Project installation root (default: current directory)
-  --yes              Confirm explicit noninteractive installation
-  --list-agents      List all supported tool directories
-  --prepare          Prepare a complete plugin for native plugin registration
-  --dir <directory>  Plugin output directory; implies --prepare
-  --dry-run          Show the installation or bundle plan without writing files
-  --force            Replace existing assets; remove old files after success
-  --version          Print the package version
-  --help             Show this help
+选项：
+  --agents <ids>      工具 ID，逗号分隔，可同时选择多个
+  --codebuddy        预选 CodeBuddy 桌面 IDE / CodeBuddy Code
+  --workbuddy        预选 WorkBuddy（桌面版建议全局安装）
+  --codex            预选 Codex
+  --claude           预选 Claude Code
+  --scope <scope>    project 项目 / global 全局（也可 --global / --local）
+  --project-dir <dir> 项目安装根目录，默认当前目录
+  --yes              确认明确指定的非交互安装
+  --list-agents      列出全部支持的工具目录
+  --prepare          另行导出插件目录并显示宿主注册步骤
+  --extract          导出完整插件内容
+  --dir <directory>  插件输出目录；隐含 --prepare
+  --dry-run          显示安装/导出计划，不写入文件
+  --force            确认替换已有内容，成功后清理旧文件
+  --version          输出包版本
+  --help             显示帮助
 
-The terminal wizard selects tools and scope, then installs native skill files.
-CodeBuddy, WorkBuddy and Claude Code also receive short commands and Agent roles.
-WorkBuddy desktop: use global scope for Skills list and input completion.
-Other tools receive skills and references; command availability is host-specific.
-Use --prepare for complete plugins, including hooks and host registration.
+终端向导先显示常用工具，WorkBuddy 在第 2 项；选择“更多”可分页/搜索全部工具。
+上下键移动/跨页，空格勾选/取消，回车确认；列表下实时显示已选，q/Esc 退出。
+CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
+其他工具通过 Skills 调用，短命令支持取决于宿主。
+所有工具默认安装完整配套目录 i3-composer-agent/，含 evals、hooks、scripts 及所需资料。
+WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
+评测需主动运行；Hook 文件已提供，需按宿主事件协议单独启用。
+--prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
 function quote(value) { return "'" + value.replaceAll("'", "'\\''") + "'"; }
@@ -55,7 +59,7 @@ function realDestination(target) {
   while (!fs.existsSync(existing)) {
     suffix.unshift(path.basename(existing));
     const parent = path.dirname(existing);
-    if (parent === existing) throw new Error(`Cannot resolve destination: ${target}`);
+    if (parent === existing) throw new Error(`无法解析输出目录： ${target}`);
     existing = parent;
   }
   return path.join(fs.realpathSync(existing), ...suffix);
@@ -68,29 +72,29 @@ function prepare() {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === '--prepare') continue;
-    if (arg === '--workbuddy') throw new Error('For native WorkBuddy installation, use --workbuddy --scope project|global --yes without --prepare or --dir.');
+    if (arg === '--workbuddy') throw new Error('安装 WorkBuddy 原生技能请使用 --workbuddy --scope project|global --yes，移除 --prepare 和 --dir。');
     if (['--codebuddy', '--codex', '--claude', '--extract'].includes(arg)) {
-      if (host) throw new Error('Choose exactly one host flag or --extract.');
+      if (host) throw new Error('请选择一个宿主参数或 --extract。');
       host = arg.slice(2);
     } else if (arg === '--dir') {
-      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error('--dir requires a directory.');
+      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error('--dir 需要指定目录。');
       directory = path.resolve(args[++i]);
     } else if (arg === '--dry-run') dryRun = true;
     else if (arg === '--force') force = true;
-    else throw new Error(`Unknown option: ${arg}`);
+    else throw new Error(`未知选项： ${arg}`);
   }
-  if (!host) throw new Error('Choose --codebuddy, --codex, --claude, or --extract.');
+  if (!host) throw new Error('请选择 --codebuddy、--codex、--claude 或 --extract。');
   directory = realDestination(directory);
   const sourceRoot = fs.realpathSync(root);
   if (directory === sourceRoot || directory.startsWith(sourceRoot + path.sep) || sourceRoot.startsWith(directory + path.sep)) {
-    throw new Error('The output directory must be outside this package directory.');
+    throw new Error('输出目录必须位于包目录之外。');
   }
   let exists = false;
   try { fs.lstatSync(directory); exists = true; } catch (error) { if (error.code !== 'ENOENT') throw error; }
   if (exists) {
-    if (!force) throw new Error(`Output already exists: ${directory}. Choose a new directory or use --force for an i3 bundle.`);
+    if (!force) throw new Error(`输出目录已存在： ${directory}. 请选择新目录，或对已有 i3 插件使用 --force。`);
     const manifest = JSON.parse(fs.readFileSync(path.join(directory, 'plugin.json'), 'utf8'));
-    if (manifest.name !== name) throw new Error('Refusing to replace a directory belonging to another plugin.');
+    if (manifest.name !== name) throw new Error('不能替换属于其他插件的目录。');
   }
   if (dryRun) {
     console.log(JSON.stringify({ name, version: pkg.version, directory, host, files: pkg.i3ComposerAgent.pluginFiles, replacesExisting: exists }, null, 2));
@@ -109,7 +113,7 @@ function prepare() {
         recursive: true,
         filter: file => {
           if (path.basename(file) === '.DS_Store') return false;
-          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`Bundle contains a symlink: ${file}`);
+          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`插件内容中包含符号链接： ${file}`);
           return !/(?:^|[\\/])(?:results|node_modules|\.git)(?:[\\/]|$)/.test(path.relative(root, file));
         },
       });
@@ -131,18 +135,19 @@ function prepare() {
     });
   }
   console.log(identity);
-  console.log(`Prepared ${name} at ${directory}`);
+  console.log(`已在 ${directory} 准备好 ${name}`);
+  console.log('包含 evals、hooks、scripts 及依赖资料；评测需主动运行，Hook 需按宿主事件协议启用。');
   if (host === 'extract') return;
-  console.log('\nRegister and enable the plugin with these native commands:');
+  console.log('\n请在目标宿主中执行以下原生命令注册并启用插件：');
   const selector = `${name}@${name}`;
   if (host === 'codex') {
     console.log(`codex plugin marketplace add ${quote(directory)}`);
     console.log(`codex plugin add ${selector}`);
-    console.log('Start a new Codex session and invoke the existing skill names. Lifecycle slash-command adaptation is separate.');
+    console.log('请新建 Codex 会话，通过 $i3- 开头的技能名称调用；生命周期短命令由宿主适配决定。');
   } else {
     console.log(`/plugin marketplace add ${quote(directory)}`);
     console.log(`/plugin install ${selector}`);
-    console.log(`Use /${name}:i3-spec, /${name}:i3-plan, /${name}:i3-build, and /${name}:i3-ship in ${host === 'claude' ? 'Claude Code' : 'CodeBuddy'}.`);
+    console.log(`在目标宿主使用 /${name}:i3-spec、/${name}:i3-plan、/${name}:i3-build 和 /${name}:i3-ship： ${host === 'claude' ? 'Claude Code' : 'CodeBuddy'}.`);
   }
 }
 async function main() {
@@ -151,7 +156,7 @@ async function main() {
   if (args.some(arg => ['--extract', '--prepare', '--dir'].includes(arg))) { prepare(); return; }
   const installer = require('./install.cjs');
   if (args.length === 1 && args[0] === '--list-agents') {
-    for (const agent of installer.registry.agents) console.log(`${agent.id.padEnd(20)} ${agent.label}${agent.globalSkillsDir ? '' : ' (project only)'}`);
+    for (const agent of require('./tool-menu.cjs').orderedAgents) console.log(`${agent.id.padEnd(20)} ${agent.label}${agent.globalSkillsDir ? '' : '（仅项目安装）'}`);
     return;
   }
   const options = { agents: [], projectDir: process.cwd() };
@@ -159,27 +164,27 @@ async function main() {
     const arg = args[i];
     if (['--codebuddy', '--workbuddy', '--codex', '--claude'].includes(arg)) options.agents.push(arg.slice(2));
     else if (['--agents', '--scope', '--project-dir'].includes(arg)) {
-      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error(`${arg} requires a value.`);
+      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error(`${arg} 需要指定值。`);
       const value = args[++i];
       if (arg === '--agents') options.agents.push(value);
-      else if (arg === '--scope') { if (options.scope && options.scope !== value) throw new Error('Choose one installation scope.'); options.scope = value; }
+      else if (arg === '--scope') { if (options.scope && options.scope !== value) throw new Error('请选择一个安装范围。'); options.scope = value; }
       else options.projectDir = path.resolve(value);
     } else if (arg === '--global' || arg === '--local') {
       const scope = arg === '--global' ? 'global' : 'project';
-      if (options.scope && options.scope !== scope) throw new Error('Choose one installation scope.');
+      if (options.scope && options.scope !== scope) throw new Error('请选择一个安装范围。');
       options.scope = scope;
     } else if (arg === '--yes') options.yes = true;
     else if (arg === '--force') options.force = true;
     else if (arg === '--dry-run') options.dryRun = true;
-    else throw new Error(`Unknown option: ${arg}`);
+    else throw new Error(`未知选项： ${arg}`);
   }
   options.agents = installer.selectAgents(options.agents);
   if (process.stdin.isTTY && process.stdout.isTTY && !options.yes && !options.dryRun) {
     const selection = await require('./wizard.cjs').choose(options, identity);
-    if (!selection) { console.log('Installation cancelled. No files changed.'); return; }
+    if (!selection) { console.log('安装已取消，未修改文件。'); return; }
     Object.assign(options, selection);
   } else if (!options.agents.length || !options.scope || (!options.yes && !options.dryRun)) {
-    throw new Error('Use an interactive terminal, or specify --agents <ids> --scope project|global --yes.');
+    throw new Error('请在交互终端使用向导，或明确指定 --agents <ids> --scope project|global --yes。');
   }
   const plan = installer.planInstallation(options);
   if (options.dryRun) {
@@ -188,19 +193,20 @@ async function main() {
   }
   if (!options.yes) {
     const confirmed = await require('./wizard.cjs').confirm(plan);
-    if (!confirmed) { console.log('Installation cancelled. No files changed.'); return; }
+    if (!confirmed) { console.log('安装已取消，未修改文件。'); return; }
     options.force = plan.conflicts.length > 0;
   }
   installer.executeInstallation(plan, { force: options.force });
   console.log(identity);
-  if (plan.reused.length) console.log(`Reused ${plan.reused.length} unchanged assets from the same package version.`);
+  if (plan.reused.length) console.log(`已复用同版本的 ${plan.reused.length} 个未修改内容。`);
   for (const target of plan.targets) {
-    console.log(`Installed ${target.agents.join(', ')} skills at ${target.skillsDirectory}`);
-    if (target.commandsDirectory) console.log(`Commands: /i3-spec, /i3-plan, /i3-build, /i3-ship (all ${fs.readdirSync(target.commandsDirectory).filter(file => file.endsWith('.md')).length} workflows) at ${target.commandsDirectory}`);
+    console.log(`已为 ${target.agents.join(', ')} 安装技能：${target.skillsDirectory}`);
+    if (target.commandsDirectory) console.log(`命令：/i3-spec、/i3-plan、/i3-build、/i3-ship（共 ${fs.readdirSync(target.commandsDirectory).filter(file => file.endsWith('.md')).length} 个工作流）：${target.commandsDirectory}`);
+    console.log(`配套目录（含 evals、hooks、scripts）：${target.supportDirectory}`);
+    console.log(`中文评测：node "${path.join(target.supportDirectory, 'scripts/run-evals.js')}" --locale zh-CN --min-rank1 95`);
   }
-  console.log('Reload the IDE window or start a new host session to discover installed files.');
-  if (plan.agents.some(id => !['codebuddy', 'workbuddy', 'claude-code'].includes(id))) console.log('These tools use the existing skill IDs; lifecycle slash-command support depends on the host.');
-  console.log('Native skill installation does not enable plugin hooks.');
-  if (plan.agents.some(id => ['codebuddy', 'codex', 'claude-code'].includes(id))) console.log('For CodeBuddy, Codex or Claude Code plugin registration, use --prepare with the matching host flag.');
+  console.log('请重新加载 IDE 窗口或新建宿主会话以发现安装内容。');
+  if (plan.agents.some(id => !['codebuddy', 'workbuddy', 'claude-code'].includes(id))) console.log('这些工具通过技能 ID 调用；生命周期短命令支持取决于宿主。');
+  console.log('安装完成。评测运行方式见配套目录 evals/README.md；Hook 文件已安装，尚未启用。');
 }
 main().catch(error => { console.error(`${name}: ${error.message}`); process.exitCode = 1; });

package/bin/install.cjs

@@ -11,19 +11,20 @@ const { fingerprint } = require('./asset-fingerprint.cjs');
 const root = path.resolve(__dirname, '..');
 const name = 'i3-composer-agent';
 const version = require('../package.json').version;
+const pluginFiles = require('../package.json').i3ComposerAgent.pluginFiles;
 const aliases = { claude: 'claude-code', gemini: 'gemini-cli', copilot: 'github-copilot' };
 function exists(file) {
   try { fs.lstatSync(file); return true; }
   catch (error) { if (error.code === 'ENOENT') return false; throw error; }
 }
 function selectAgents(values) {
-  const ids = [...new Set(values.flatMap(value => value.split(',')).map(id => aliases[id.trim()] || id.trim()).filter(Boolean))];
-  for (const id of ids) if (!registry.agents.some(agent => agent.id === id)) throw new Error(`Unknown tool: ${id}. Use --list-agents.`);
+  const ids = [...new Set(values.flatMap(value => value.split(/[,，]/)).map(id => aliases[id.trim()] || id.trim()).filter(Boolean))];
+  for (const id of ids) if (!registry.agents.some(agent => agent.id === id)) throw new Error(`未知工具：${id}。请使用 --list-agents 查看支持列表。`);
   return ids;
 }
 function globalSkillsDir(agent, home, env) {
   const config = agent.globalSkillsDir;
-  if (!config) throw new Error(`${agent.label} supports project installation only. Choose project scope or remove this tool.`);
+  if (!config) throw new Error(`${agent.label} 仅支持项目安装（project installation only），请选择项目范围或移除此工具。`);
   let base = home;
   if (config.base === 'config') base = env.XDG_CONFIG_HOME && path.isAbsolute(env.XDG_CONFIG_HOME) ? env.XDG_CONFIG_HOME : path.join(home, '.config');
   if (config.base === 'env') base = env[config.env]?.trim() || path.join(home, config.fallback);
@@ -43,23 +44,24 @@ function destination(file) {
 function checkDestination(file) {
   const source = fs.realpathSync(root);
   if (file === source || file.startsWith(source + path.sep) || source.startsWith(file + path.sep)) {
-    throw new Error('Installation destinations must be outside this package directory.');
+    throw new Error('安装目标必须位于包目录之外。');
   }
 }
+function assetPath(base, file) { return path.relative(base, file).split(path.sep).join('/'); }
 function manifestContent(plan, asset) {
   return JSON.stringify({ name, version, entryPrefix: 'i3-', scope: plan.scope, agents: asset.target.agents,
-    assets: plan.assets.filter(item => item.base === asset.base && item.kind !== 'legacy').map(item => path.relative(asset.base, item.destination)) }, null, 2) + '\n';
+    assets: plan.assets.filter(item => item.base === asset.base && item.kind !== 'legacy').map(item => assetPath(asset.base, item.destination)) }, null, 2) + '\n';
 }
 function planInstallation({ agents, scope, projectDir = process.cwd(), home = os.homedir(), env = process.env }) {
   agents = selectAgents(agents);
-  if (!agents.length) throw new Error('Choose at least one tool.');
-  if (!['project', 'global'].includes(scope)) throw new Error('Choose --scope project or --scope global.');
+  if (!agents.length) throw new Error('请至少选择一个工具。');
+  if (!['project', 'global'].includes(scope)) throw new Error('请选择 --scope project 或 --scope global。');
   const targets = new Map();
   for (const id of agents) {
     const agent = registry.agents.find(item => item.id === id);
     const skillsDirectory = destination(scope === 'project' ? path.resolve(projectDir, agent.projectSkillsDir) : globalSkillsDir(agent, home, env));
     const base = path.dirname(skillsDirectory);
-    if (!targets.has(skillsDirectory)) targets.set(skillsDirectory, { agents: [], skillsDirectory, referencesDirectory: path.join(base, 'references'), base });
+    if (!targets.has(skillsDirectory)) targets.set(skillsDirectory, { agents: [], skillsDirectory, referencesDirectory: path.join(base, 'references'), supportDirectory: path.join(base, name), base });
     const target = targets.get(skillsDirectory);
     target.agents.push(id);
     if (['codebuddy', 'workbuddy', 'claude-code'].includes(id)) {
@@ -70,7 +72,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
   const assets = [];
   function addDirectory(sourceDirectory, destinationDirectory, kind) {
     if (exists(destinationDirectory) && fs.lstatSync(destinationDirectory).isSymbolicLink()) {
-      throw new Error(`Installation directory is a symlink: ${destinationDirectory}. Choose its canonical location instead.`);
+      throw new Error(`安装目录是符号链接（symlink）： ${destinationDirectory}. 请选择其真实目录。`);
     }
     for (const entry of fs.readdirSync(path.join(root, sourceDirectory)).sort()) {
       if (entry === '.DS_Store') continue;
@@ -82,6 +84,9 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
     const previous = exists(manifestFile) && !fs.lstatSync(manifestFile).isSymbolicLink()
       ? JSON.parse(fs.readFileSync(manifestFile, 'utf8')) : undefined;
     const owned = previous?.name === name && Array.isArray(previous.assets);
+    // Earlier Windows installs persisted backslashes. Normalize before lookup
+    // and containment checks so owned upgrades work across both manifest forms.
+    if (owned) previous.assets = previous.assets.map(relative => typeof relative === 'string' ? relative.replaceAll('\\', '/') : relative);
     const sameVersion = owned && previous.version === version && previous.scope === scope && previous.entryPrefix === 'i3-';
     if (owned && previous.scope === scope && Array.isArray(previous.agents)) {
       const applicable = previous.agents.filter(id => {
@@ -99,17 +104,34 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
       addDirectory('.claude/commands', target.commandsDirectory, 'command');
       addDirectory('agents', target.personasDirectory, 'persona');
       const docs = path.join(target.base, 'docs');
-      if (exists(docs) && fs.lstatSync(docs).isSymbolicLink()) throw new Error(`Installation directory is a symlink: ${docs}.`);
+      if (exists(docs) && fs.lstatSync(docs).isSymbolicLink()) throw new Error(`安装目录是符号链接（symlink）： ${docs}.`);
       assets.push({ source: path.join(root, 'docs/agents.md'), destination: destination(path.join(target.base, 'docs/agents.md')), kind: 'documentation' });
     }
     const licenseDirectory = path.join(target.referencesDirectory, name);
-    if (exists(licenseDirectory) && fs.lstatSync(licenseDirectory).isSymbolicLink()) throw new Error(`Installation directory is a symlink: ${licenseDirectory}.`);
+    if (exists(licenseDirectory) && fs.lstatSync(licenseDirectory).isSymbolicLink()) throw new Error(`安装目录是符号链接（symlink）： ${licenseDirectory}.`);
     assets.push({ source: path.join(root, 'LICENSE'), destination: destination(path.join(licenseDirectory, 'LICENSE')), kind: 'attribution' });
+    // Keep the canonical plugin layout for eval fixtures, validators and Hook
+    // relative paths. Native entry points above remain host-adapted copies.
+    for (const relative of pluginFiles) {
+      const file = path.join(target.supportDirectory, relative);
+      if (destination(file) !== file) throw new Error(`配套目录包含符号链接（symlink）： ${file}`);
+      assets.push({ source: path.join(root, relative), destination: file, kind: 'support' });
+    }
     if (owned) {
       const legacy = fs.readdirSync(path.join(root, 'skills')).filter(id => id.startsWith('i3-')).map(id => `skills/${id.slice(3)}`);
       if (target.commandsDirectory) legacy.push(...fs.readdirSync(path.join(root, '.claude/commands')).filter(file => file.startsWith('i3-') && file.endsWith('.md')).map(file => `commands/${file.slice(3)}`));
       legacy.push(`${name}-LICENSE`, `${name}-NOTICE.md`);
-      for (const relative of legacy) {
+      const current = new Set(assets.slice(start).map(asset => assetPath(target.base, asset.destination)));
+      for (const relative of previous.assets) {
+        // Retire only owned native entries or entries inside this package's
+        // companion directory. Never let a manifest extend the deletion scope.
+        if (typeof relative !== 'string' || relative.includes('\0') || relative.includes(':')
+          || relative.split('/').some(part => ['', '.', '..'].includes(part))) continue;
+        if (!/^(skills|commands|agents|references)\/[^/]+$/.test(relative) && !relative.startsWith(`${name}/`)) continue;
+        if (relative.startsWith(`${name}/`) && destination(path.join(target.base, relative)) !== path.join(target.base, relative)) continue;
+        if (!current.has(relative)) legacy.push(relative);
+      }
+      for (const relative of new Set(legacy)) {
         const file = destination(path.join(target.base, relative));
         if (previous.assets.includes(relative) && exists(file)) assets.push({ destination: file, kind: 'legacy' });
       }
@@ -120,7 +142,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
       asset.buddyCommand = asset.kind === 'command' && target.agents.some(id => ['codebuddy', 'workbuddy'].includes(id));
       asset.scope = scope;
       asset.personasDirectory = target.personasDirectory;
-      if (sameVersion && previous.assets.includes(path.relative(target.base, asset.destination)) && asset.source && exists(asset.destination)) {
+      if (sameVersion && previous.assets.includes(assetPath(target.base, asset.destination)) && asset.source && exists(asset.destination)) {
         asset.expectedFingerprint = fingerprint(asset.source, asset);
         asset.reusable = fingerprint(asset.destination) === asset.expectedFingerprint;
       }
@@ -138,7 +160,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
   return plan;
 }
 function executeInstallation(plan, { force = false } = {}) {
-  if (plan.conflicts.length && !force) throw new Error('Existing installation assets require confirmation or --force before replacement.');
+  if (plan.conflicts.length && !force) throw new Error('已有安装内容需要确认或使用 --force 才能替换。');
   const contexts = new Map();
   const createdDirectories = [];
   const committed = [];
@@ -171,8 +193,9 @@ function executeInstallation(plan, { force = false } = {}) {
         fs.writeFileSync(asset.staged, manifestContent(plan, asset));
       } else {
         fs.cpSync(asset.source, asset.staged, { recursive: true, filter: file => {
-          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`Package contains a symlink: ${file}`);
-          return path.basename(file) !== '.DS_Store';
+          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`包内容中包含符号链接（symlink）： ${file}`);
+          return path.basename(file) !== '.DS_Store' && (asset.kind !== 'support'
+            || !/(?:^|[\\/])(?:results|node_modules|\.git)(?:[\\/]|$)/.test(path.relative(root, file)));
         } });
         portable(asset.staged, asset, asset.source.endsWith('.md'));
       }
@@ -184,12 +207,12 @@ function executeInstallation(plan, { force = false } = {}) {
         const unchanged = fingerprint(asset.destination) === asset.expectedFingerprint
           && fingerprint(asset.staged) === asset.expectedFingerprint;
         if (unchanged) continue;
-        if (!force) throw new Error(`Destination changed during installation: ${asset.destination}. Retry with confirmed replacement.`);
+        if (!force) throw new Error(`安装期间目标已改变： ${asset.destination}. 请重新检查并确认替换后重试。`);
       } else if (asset.mergeable) {
-        if (fingerprint(asset.destination) !== asset.observedFingerprint && !force) throw new Error(`Manifest changed during installation: ${asset.destination}. Retry with confirmed replacement.`);
+        if (fingerprint(asset.destination) !== asset.observedFingerprint && !force) throw new Error(`安装期间清单已改变： ${asset.destination}. 请重新检查并确认替换后重试。`);
       }
       // A destination may have appeared since planning; never replace it implicitly.
-      if (exists(asset.destination) && !force && !asset.mergeable) throw new Error(`Destination appeared during installation: ${asset.destination}. Retry with confirmed replacement.`);
+      if (exists(asset.destination) && !force && !asset.mergeable) throw new Error(`安装期间出现了新的目标： ${asset.destination}. 请重新检查并确认替换后重试。`);
       const change = { destination: asset.destination, written: false };
       if (exists(asset.destination)) {
         change.backup = path.join(context.backup, path.relative(asset.base, asset.destination));

package/bin/native-content.cjs

@@ -1,29 +1,39 @@
 'use strict';
-
-// Project commands are identical for both Buddy clients, including when the
-// other client is added later. Global commands use the selected profile path.
+function replaceBlock(content, name, replacement) {
+  const start = `<!-- i3:${name}:start -->`, end = `<!-- i3:${name}:end -->`;
+  if (content.split(start).length !== 2 || content.split(end).length !== 2 || content.indexOf(start) >= content.indexOf(end)) {
+    throw new Error(`i3-ship 宿主适配标记 ${name} 缺失、重复或顺序错误，请重新安装完整发行包。`);
+  }
+  const from = content.indexOf(start), to = content.indexOf(end) + end.length;
+  return content.slice(0, from) + `${start}\n${replacement}\n${end}` + content.slice(to);
+}
+// Adapt stable blocks, never their prose. Shared project commands work for
+// either Buddy client; global paths belong to the selected profile.
 function nativeContent(content, asset) {
+  if (asset.kind === 'support') return content;
   content = content.replaceAll('i3-composer-agent:', '').replaceAll('agent-skills:', '');
   if (!asset.buddyCommand) return content;
   const projectPersonas = '.codebuddy/agents/';
-  const userPersonas = asset.scope === 'project'
-    ? "the current host's user-level agents directory"
+  const userPersonas = asset.scope === 'project' ? '当前宿主的用户级 agents 目录'
     : `\`${asset.personasDirectory.replaceAll('\\', '/')}/\``;
   content = content.replaceAll('CLAUDE.md', 'CODEBUDDY.md')
     .replaceAll('`~/.claude/agents/`', userPersonas)
     .replaceAll('.claude/agents/', projectPersonas);
   if (!asset.source.endsWith('i3-ship.md')) return content;
-  return content
-    .replace('Spawn three subagents concurrently using the Agent tool. **Issue all three Agent tool calls in a single assistant turn so they execute in parallel** — sequential calls defeat the purpose of this command.',
-      'Use the host\'s native subagent capability to run three specialist personas concurrently. Issue all three calls together when the host supports parallel execution.')
-    .replace("In Claude Code, each call passes `subagent_type` matching the persona's `name` field:",
-      'Select the following persona names using the host\'s native subagent mechanism:')
-    .replace('In other harnesses without an Agent tool, invoke each persona\'s system prompt sequentially and treat their outputs as if returned in parallel — the merge phase still works.',
-      'If native subagents are unavailable, read each persona prompt from the installed agents directory, perform the three reviews sequentially, and retain the same merge phase.')
-    .replace(/Constraints \(from Claude Code's subagent model\):\n[\s\S]*?\n\n\*\*Persona resolution\.\*\*[^\n]*/,
-      `Constraints:\n- Each specialist reviews independently and returns a report to this session.\n- Specialists do not delegate to one another.\n- Follow the host's execution and permission limits.\n\n**Persona resolution.** Read installed persona prompts from \`${asset.scope === 'project' ? projectPersonas : asset.personasDirectory.replaceAll('\\', '/') + '/'}\`. For project installations, check ${userPersonas} for the current host's user-defined personas, and follow its native precedence rules.`)
-    .replace('The three Phase A personas run in parallel — never sequentially.',
-      'Run the three Phase A personas in parallel when native subagents are available; otherwise use the sequential fallback above.');
-}
+  const personas = asset.scope === 'project' ? projectPersonas : asset.personasDirectory.replaceAll('\\', '/') + '/';
+  content = replaceBlock(content, 'ship-dispatch', `使用宿主的原生子代理能力同时启动三个专业角色；支持并行调用时，在同一轮发出三个调用。
 
+1. **\`code-reviewer\`**：对待发布改动进行正确性、可读性、架构、安全、性能五维审查，返回标准评审报告。
+2. **\`security-auditor\`**：审查漏洞、威胁模型、OWASP Top 10、密钥、认证授权及依赖 CVE，返回标准安全报告。
+3. **\`test-engineer\`**：检查正常、边界、错误和并发路径及测试覆盖，返回标准覆盖分析。
+
+如果宿主的原生子代理不可用，读取安装后的角色提示，依次完成三个独立审查，保留各自报告；之后仍由主会话汇总。
+
+约束：
+- 角色独立审查，只返回报告，不互相委派。
+- 遵守当前宿主的执行、上下文和权限限制。
+- 角色解析：读取 \`${personas}\`。项目安装另按宿主优先级检查${userPersonas}的自定义角色。
+- 后续主会话合并重复发现，按原门槛输出 GO/NO-GO；必须提供回滚计划。严重（Critical）问题默认 NO-GO，除非用户明确接受风险。`);
+  return replaceBlock(content, 'ship-parallel-rule', '宿主支持原生子代理时，阶段 A 的三个角色并行运行；不支持时采用上文的顺序降级。');
+}
 module.exports = { nativeContent };

package/bin/tool-menu.cjs

@@ -0,0 +1,9 @@
+'use strict';
+const registry = require('./agent-targets.json');
+const commonIds = ['codebuddy', 'workbuddy', 'codex', 'claude-code', 'cursor', 'gemini-cli'];
+const orderedAgents = [...commonIds.map(id => registry.agents.find(agent => agent.id === id)),
+  ...registry.agents.filter(agent => !commonIds.includes(agent.id))];
+if (orderedAgents.some(agent => !agent) || new Set(orderedAgents.map(agent => agent.id)).size !== registry.agents.length) {
+  throw new Error('安装目录排序与工具登记不一致。');
+}
+module.exports = { orderedAgents, commonIds };

package/bin/tool-selector.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+const readline = require('node:readline');
+const { orderedAgents, commonIds } = require('./tool-menu.cjs');
+
+// Terminal columns are not JavaScript string lengths: Chinese characters use
+// two cells. Keep every rendered line within the viewport before repainting.
+function cellWidth(character) {
+  const code = character.codePointAt(0);
+  if (/\p{Mark}/u.test(character) || code === 0x200d) return 0;
+  return code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a
+    || (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f)
+    || (code >= 0xac00 && code <= 0xd7a3) || (code >= 0xf900 && code <= 0xfaff)
+    || (code >= 0xfe10 && code <= 0xfe19) || (code >= 0xfe30 && code <= 0xfe6f)
+    || (code >= 0xff00 && code <= 0xff60) || (code >= 0xffe0 && code <= 0xffe6)
+    || (code >= 0x1f300 && code <= 0x1faff) || (code >= 0x20000 && code <= 0x3fffd)) ? 2 : 1;
+}
+function width(text) { return [...text].reduce((size, character) => size + cellWidth(character), 0); }
+function clip(text, columns) {
+  if (width(text) <= columns) return text;
+  const suffix = columns >= 3 ? '...' : '';
+  let result = '', size = 0;
+  for (const character of text) {
+    size += cellWidth(character);
+    if (size > columns - suffix.length) break;
+    result += character;
+  }
+  return result + suffix;
+}
+function wrap(text, columns) {
+  const lines = [];
+  let line = '', size = 0;
+  for (const character of text) {
+    const cells = cellWidth(character);
+    if (line && size + cells > columns) { lines.push(line); line = ''; size = 0; }
+    line += character; size += cells;
+  }
+  lines.push(line);
+  return lines;
+}
+
+function selectTools(initialSelection, input = process.stdin, output = process.stdout) {
+  const selected = new Set(initialSelection);
+  let view = 'common', cursor = 0, commonCursor = 0, query = '', searching = false, message = '';
+  let frame = [], pageSize = 10, finished = false;
+  const wasRaw = Boolean(input.isRaw), wasFlowing = input.readableFlowing;
+  const choices = () => view === 'common' ? [...orderedAgents.slice(0, commonIds.length), null]
+    : view === 'more' ? orderedAgents.slice(commonIds.length)
+      : orderedAgents.filter(agent => `${agent.label} ${agent.id}`.toLowerCase().includes(query.toLowerCase()));
+  const selectedLabels = () => [...selected].map(id => orderedAgents.find(agent => agent.id === id).label).join('、');
+
+  function clearFrame() {
+    if (!frame.length) return;
+    const columns = output.columns || 80;
+    const rows = frame.reduce((count, line) => count + Math.max(1, Math.ceil(width(line) / columns)), 0);
+    readline.moveCursor(output, 0, -rows);
+    readline.cursorTo(output, 0);
+    readline.clearScreenDown(output);
+    frame = [];
+  }
+  function render() {
+    if (finished) return;
+    const columns = Math.max(1, (output.columns || 80) - 1), rows = output.rows || 24;
+    const entries = choices();
+    cursor = Math.max(0, Math.min(cursor, entries.length - 1));
+    const summary = wrap(`已选（${selected.size}）：${selectedLabels() || '无'}`, columns);
+    const summaryLimit = rows < 16 ? 1 : 3;
+    if (summary.length > summaryLimit) {
+      summary.length = summaryLimit;
+      summary[summaryLimit - 1] = clip(summary[summaryLimit - 1], Math.max(0, columns - 3)) + '...';
+    }
+    const hints = searching
+      ? ['输入关键词实时搜索', 'Enter/↓ 浏览结果 · Esc返回 · Ctrl-C取消']
+      : ['↑↓ 移动/跨页 · 空格勾选 · Enter确认', 'm 更多 · / 搜索 · b/← 返回 · q/Esc取消'];
+    const footer = ['', ...summary, ...hints.flatMap(line => wrap(line, columns)), message];
+    const searchLine = view === 'search' ? [`搜索：${query}${searching ? '|' : ''}`] : [];
+    pageSize = Math.max(1, Math.min(10, rows - footer.length - searchLine.length - 2));
+    const page = Math.floor(cursor / pageSize), pages = Math.max(1, Math.ceil(entries.length / pageSize));
+    const title = view === 'common' ? '选择常用工具（支持多选）：'
+      : `${view === 'more' ? '更多工具' : '搜索结果'}：第 ${page + 1}/${pages} 页，共 ${entries.length} 项`;
+    const lines = [title, ...searchLine];
+    for (let index = page * pageSize; index < Math.min(entries.length, (page + 1) * pageSize); index++) {
+      const agent = entries[index], pointer = index === cursor ? '>' : ' ';
+      lines.push(agent ? `${pointer} [${selected.has(agent.id) ? 'x' : ' '}] ${orderedAgents.indexOf(agent) + 1}. ${agent.label} [${agent.id}]${agent.globalSkillsDir ? '' : '（仅项目）'}`
+        : `${pointer}     更多工具（空格展开）`);
+    }
+    if (!entries.length) lines.push('没有匹配工具；按 / 重新搜索，或 Esc 返回。');
+    clearFrame();
+    frame = [...lines, ...footer].map(line => clip(line, columns));
+    output.write(frame.join('\n') + '\n');
+  }
+
+  return new Promise((resolve, reject) => {
+    function finish(value, error) {
+      if (finished) return;
+      finished = true;
+      input.off('keypress', keypress);
+      input.off('end', cancel);
+      input.off('error', fail);
+      output.off('resize', redraw);
+      process.off('SIGINT', cancel);
+      input.setRawMode(wasRaw);
+      if (!wasFlowing) input.pause();
+      try {
+        clearFrame();
+        output.write('\x1b[?25h');
+        if (value) output.write(`已选择工具：${selectedLabels()}\n`);
+      } catch (outputError) { error ||= outputError; }
+      if (error) reject(error); else resolve(value);
+    }
+    function cancel() { finish(null); }
+    function fail(error) { finish(null, error); }
+    function redraw() { try { render(); } catch (error) { fail(error); } }
+    function openMore() {
+      if (view === 'common') commonCursor = cursor;
+      view = 'more'; cursor = 0; searching = false;
+    }
+    function back() { view = 'common'; cursor = commonCursor; searching = false; query = ''; }
+    function keypress(text, key = {}) {
+      if (finished) return;
+      try {
+        message = '';
+        if (key.ctrl && ['c', 'd'].includes(key.name)) { cancel(); return; }
+        if (searching) {
+          if (key.name === 'escape') back();
+          else if (['return', 'enter', 'down'].includes(key.name)) searching = false;
+          else if (key.name === 'backspace') { query = [...query].slice(0, -1).join(''); cursor = 0; }
+          else if (text && !key.ctrl && !key.meta && !/[\x00-\x1f\x7f]/.test(text)) { query += text; cursor = 0; }
+        } else if (key.name === 'escape') {
+          if (view === 'search') back(); else { cancel(); return; }
+        } else if (text === 'q') { cancel(); return; }
+        else if (['return', 'enter'].includes(key.name)) {
+          if (selected.size) { finish([...selected]); return; }
+          message = '请至少用空格选择一个工具。';
+        } else if (key.name === 'space' || text === ' ') {
+          const entry = choices()[cursor];
+          if (entry) { if (selected.has(entry.id)) selected.delete(entry.id); else selected.add(entry.id); }
+          else if (view === 'common') openMore();
+        } else if (['up', 'down', 'pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text)) {
+          const direction = ['up', 'pageup'].includes(key.name) || text === 'p' ? -1 : 1;
+          const step = ['pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text) ? pageSize : 1;
+          cursor = Math.max(0, Math.min(choices().length - 1, cursor + direction * step));
+        } else if (text === 'm' || (key.name === 'right' && view === 'common')) openMore();
+        else if (text === 'b' || key.name === 'left') back();
+        else if (text === '/') { if (view === 'common') commonCursor = cursor; view = 'search'; query = ''; cursor = 0; searching = true; }
+        render();
+      } catch (error) { fail(error); }
+    }
+    try {
+      readline.emitKeypressEvents(input);
+      input.setRawMode(true);
+      input.on('keypress', keypress);
+      input.once('end', cancel);
+      input.once('error', fail);
+      output.on('resize', redraw);
+      process.once('SIGINT', cancel);
+      output.write('\x1b[?25l');
+      render();
+      input.resume();
+    } catch (error) { fail(error); }
+  });
+}
+
+module.exports = { selectTools };