@harmonyos-arkts/d2h 0.1.28 → 0.1.29

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "android-to-hmos-migration",
   "description": "基于确定性 facts、迁移报告与端到端验证的 Android 到 HarmonyOS 迁移插件",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "license": "MIT",
   "keywords": [
     "android",

package/README.md

@@ -20,7 +20,15 @@
 
 ## 安装
 
-默认安装到 OpenCode：
+不传 `--agent` 时，在终端用上下键选择安装目标，回车确认，也可输入序号或名称；前两项固定为 OpenCode、VS Code，不显示命令名或路径。检测到工具命令或配置目录时显示“可配置”，否则显示“未检测到”；VS Code 以发现鸿蒙插件为准。检测结果不代替安装校验。未检测到的工具仍可手动选择。
+
+```bash
+npx --yes @harmonyos-arkts/d2h@latest install --force
+```
+
+CI、管道等非交互环境必须显式传入 `--agent`。`upgrade` 同样支持交互选择，`doctor` 保留默认检查 OpenCode 的行为。
+
+直接安装到 OpenCode：
 
 ```bash
 npx --yes @harmonyos-arkts/d2h@latest install --agent opencode --force

package/dist/bin/install-opencode.js

@@ -18,6 +18,7 @@ import { inspectVSCodeInstallation, installVSCode } from '../src/install-vscode.
 import { isSkillHost, skillHosts, skillHostConfigRoot, inspectSkillHostInstallation, installSkillHost } from '../src/install-skills.js';
 import { installTuiExtension, inspectTuiExtension } from '../src/install-tui-extension.js';
 import { runWorkflow } from '../src/workflow.js';
+import { selectAgent } from '../src/select-agent.js';
 const help = `Install this package's skills and agents into supported AI coding tools.
 
 Usage: d2h [options]
@@ -34,8 +35,9 @@ Usage: d2h [options]
                        Use d2h --check-env --help for check options
 
   --source-dir <path>  Source root (defaults to this package)
-  --agent <name>       opencode (default), deveco, vscode, codex, qoder, trae,
+  --agent <name>       opencode, vscode, deveco, codex, qoder, trae,
                        trae-cn, claude, dsh, zcode, codebuddy or workbuddy
+                       Omit for interactive selection with local detection hints
   --extension-dir <path>  VS Code HarmonyOS Dev Assistant extension root
   --config-dir <path>  Override the selected agent's config root
                        OPENCODE_CONFIG_DIR / DEVECO_CONFIG_DIR, or
@@ -120,7 +122,6 @@ try {
         let remote = false;
         const options = {
             sourceDir: packageRoot,
-            agent: 'opencode',
         };
         for (let index = 0; index < installArgs.length; index++) {
             const arg = installArgs[index];
@@ -153,6 +154,7 @@ try {
                 throw new Error(`unknown option: ${arg}`);
             }
         }
+        options.agent ??= await selectAgent(extensionDir);
         if (!options.agent || (!['opencode', 'deveco', 'vscode'].includes(options.agent) && !isSkillHost(options.agent))) {
             throw new Error(`unsupported agent: ${options.agent}; choose opencode, deveco, vscode or ${Object.keys(skillHosts).join(', ')}`);
         }

package/dist/src/select-agent.js

@@ -0,0 +1,207 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { emitKeypressEvents, moveCursor, cursorTo, clearScreenDown } from 'node:readline';
+import { skillHosts } from './install-skills.js';
+import { locateVSCodeExtension } from './install-vscode.js';
+function executable(name, env, platform) {
+    const extensions = platform === 'win32' ? (env.PATHEXT || '.EXE;.CMD;.BAT').split(';') : [''];
+    for (const directory of (env.PATH || '').split(platform === 'win32' ? ';' : ':').filter(Boolean)) {
+        for (const extension of extensions) {
+            const file = path.join(directory, name + extension);
+            try {
+                if (!fs.statSync(file).isFile())
+                    continue;
+                fs.accessSync(file, platform === 'win32' ? fs.constants.F_OK : fs.constants.X_OK);
+                return file;
+            }
+            catch { /* Missing or inaccessible commands are not detection evidence. */ }
+        }
+    }
+    return undefined;
+}
+export function detectAgents({ home = os.homedir(), env = process.env, platform = process.platform, extensionDir } = {}) {
+    const configHome = env.XDG_CONFIG_HOME || path.join(home, '.config');
+    const hosts = [
+        { agent: 'opencode', label: 'OpenCode', root: env.OPENCODE_CONFIG_DIR || path.join(configHome, 'opencode'), commands: ['opencode'] },
+        { agent: 'vscode', label: 'VS Code (HarmonyOS Dev Assistant)', root: path.join(home, '.vscode'), commands: ['code'] },
+        { agent: 'deveco', label: 'DevEco Code', root: env.DEVECO_CONFIG_DIR || path.join(configHome, 'deveco'), commands: ['deveco'] },
+        ...Object.entries(skillHosts).map(([agent, host]) => ({
+            agent, label: host.label,
+            root: ('environment' in host && env[host.environment]) || path.join(home, host.directory),
+            commands: agent === 'qoder' ? ['qodercli', 'qoder'] : agent === 'trae-cn' ? ['trae-cn'] : [agent]
+        }))
+    ];
+    return hosts.map(host => {
+        const detected = [];
+        for (const command of host.commands) {
+            const file = executable(command, env, platform);
+            if (file) {
+                detected.push(`命令 ${file}`);
+                break;
+            }
+        }
+        try {
+            if (fs.statSync(host.root).isDirectory())
+                detected.push(`配置目录 ${host.root}`);
+        }
+        catch { /* Not present. */ }
+        if (host.agent === 'vscode') {
+            try {
+                const extension = locateVSCodeExtension(extensionDir, home);
+                const metadata = JSON.parse(fs.readFileSync(path.join(extension, 'package.json'), 'utf8'));
+                if (String(metadata.name).toLowerCase() === 'harmonyosdevassistantforvscode' &&
+                    String(metadata.publisher).toLowerCase() === 'huaweideveloperserviceplatform') {
+                    detected.push(`鸿蒙插件 ${extension}`);
+                }
+            }
+            catch { /* VS Code without the required extension remains selectable. */ }
+        }
+        return { agent: host.agent, label: host.label, detected };
+    });
+}
+export function formatAgentChoice(choice) {
+    const detected = choice.agent === 'vscode'
+        ? choice.detected.some(item => item.startsWith('鸿蒙插件 '))
+        : choice.detected.length > 0;
+    const status = detected ? '可配置' : '未检测到';
+    const label = ['opencode', 'vscode'].includes(choice.agent) ? choice.label : `${choice.label} (${choice.agent})`;
+    return `${label} — ${status}`;
+}
+export async function chooseAgent(choices, ask, write) {
+    write('选择安装目标 / Select agent（检测结果仅供参考）：\n');
+    choices.forEach((choice, index) => write(`  ${index + 1}. ${formatAgentChoice(choice)}\n`));
+    for (;;) {
+        const answer = (await ask('输入序号或 agent 名称，q 取消：')).trim().toLowerCase();
+        if (['q', 'quit', 'exit'].includes(answer))
+            throw new Error('Installation cancelled before making changes');
+        const choice = /^\d+$/.test(answer) ? choices[Number(answer) - 1] : choices.find(item => item.agent === answer);
+        if (choice)
+            return choice.agent;
+        write('请选择列表中的序号或 agent 名称。\n');
+    }
+}
+export function chooseAgentWithKeys(choices, input = process.stdin, output = process.stderr) {
+    return new Promise((resolve, reject) => {
+        let selected = 0;
+        let renderedLines = 0;
+        let answer = '';
+        const colorDepth = process.env.NO_COLOR === undefined ? (output.getColorDepth?.() || 1) : 1;
+        const wasRaw = Boolean(input.isRaw);
+        const wasFlowing = input.readableFlowing === true;
+        const rows = Math.max(1, Math.min(choices.length, (output.rows || 24) - 4));
+        function render() {
+            if (renderedLines) {
+                moveCursor(output, 0, -renderedLines);
+                cursorTo(output, 0);
+                clearScreenDown(output);
+            }
+            const start = Math.max(0, Math.min(selected - rows + 1, choices.length - rows));
+            const lines = ['选择安装目标 / Select agent（检测结果仅供参考）'];
+            for (let i = start; i < start + rows; i++) {
+                lines.push(`${i === selected ? '>' : ' '} ${i + 1}. ${formatAgentChoice(choices[i])}`);
+            }
+            lines.push(`↑↓ 选择，回车确认；也可输入序号或名称，q 取消：${answer}`);
+            // Keep every row within the terminal width so cursor movement stays aligned.
+            const width = Math.max(1, (output.columns || 80) - 1);
+            const clipped = lines.map(line => {
+                let cells = 0;
+                let result = '';
+                for (const char of line) {
+                    const size = char.codePointAt(0) >= 0x1100 ? 2 : 1;
+                    if (cells + size > width)
+                        break;
+                    result += char;
+                    cells += size;
+                }
+                return result;
+            });
+            const highlighted = clipped.map((line, index) => {
+                if (index !== selected - start + 1 || colorDepth < 4)
+                    return line;
+                // HarmonyOS-style blue (#0A59F7), with an ANSI blue fallback.
+                const color = colorDepth >= 24 ? '\x1b[1;38;2;255;255;255;48;2;10;89;247m' : '\x1b[1;97;44m';
+                return color + line + '\x1b[0m';
+            });
+            output.write(highlighted.join('\n') + '\n');
+            renderedLines = clipped.length;
+        }
+        function finish(agent) {
+            input.removeListener('keypress', onKey);
+            input.removeListener('end', onEnd);
+            input.removeListener('error', onError);
+            input.setRawMode(wasRaw);
+            if (!wasFlowing)
+                input.pause();
+            if (agent) {
+                output.write(`已选择：${choices.find(item => item.agent === agent).label}\n`);
+                resolve(agent);
+            }
+            else
+                reject(new Error('Installation cancelled before making changes'));
+        }
+        function onEnd() { finish(); }
+        function onError(error) { finish(); }
+        function onKey(text, key = {}) {
+            if ((key.ctrl && ['c', 'd'].includes(key.name || '')) || key.name === 'escape') {
+                finish();
+                return;
+            }
+            if (key.name === 'up' || key.name === 'down') {
+                selected = (selected + (key.name === 'up' ? -1 : 1) + choices.length) % choices.length;
+                answer = '';
+            }
+            else if (key.name === 'return' || key.name === 'enter') {
+                const value = answer.trim().toLowerCase();
+                if (['q', 'quit', 'exit'].includes(value)) {
+                    finish();
+                    return;
+                }
+                const choice = !value ? choices[selected] : /^\d+$/.test(value) ? choices[Number(value) - 1] : choices.find(item => item.agent === value);
+                if (choice) {
+                    finish(choice.agent);
+                    return;
+                }
+                answer = '';
+            }
+            else if (key.name === 'backspace')
+                answer = answer.slice(0, -1);
+            else if (text && !key.ctrl && !key.meta && /^[a-zA-Z0-9-]+$/.test(text))
+                answer = (answer + text).slice(0, 30);
+            else
+                return;
+            render();
+        }
+        emitKeypressEvents(input);
+        input.setRawMode(true);
+        input.on('keypress', onKey);
+        input.once('end', onEnd);
+        input.once('error', onError);
+        input.resume();
+        render();
+    });
+}
+export async function selectAgent(extensionDir) {
+    if (!process.stdin.isTTY || !process.stderr.isTTY) {
+        throw new Error('Agent selection requires an interactive terminal; pass --agent <name> (for example --agent opencode)');
+    }
+    const choices = detectAgents({ extensionDir });
+    if (process.env.TERM !== 'dumb')
+        return chooseAgentWithKeys(choices);
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    const controller = new AbortController();
+    rl.once('SIGINT', () => controller.abort());
+    rl.once('close', () => controller.abort());
+    try {
+        return await chooseAgent(choices, prompt => rl.question(prompt, { signal: controller.signal }), text => process.stderr.write(text));
+    }
+    catch (error) {
+        if (controller.signal.aborted)
+            throw new Error('Installation cancelled before making changes');
+        throw error;
+    }
+    finally {
+        rl.close();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/d2h",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Install Android-to-HarmonyOS migration agents and skills into AI coding tools",
   "type": "module",
   "bin": {