@buaa_smat/hometrans 0.1.13 → 0.1.15

package/dist/cli/init.js

@@ -12,9 +12,9 @@ import { fileURLToPath } from 'node:url';
 import chalk from 'chalk';
 import figlet from 'figlet';
 import inquirer from 'inquirer';
-import { parseTree, modify, applyEdits } from 'jsonc-parser';
 import { setupMcpForAllEditors } from './mcp-setup.js';
 import { deriveSdkPaths, expandHome, getConfigDir, getConfigPath, getToolsDir, loadHomeTransConfig, saveHomeTransConfig, } from './config-store.js';
+import { persistEnvVars } from './env-vars.js';
 function ensureChalkColor() {
     if (process.stdout.isTTY && chalk.level === 0) {
         chalk.level = 1;
@@ -70,7 +70,7 @@ function resolveToolsRoot() {
 }
 /**
  * Copy the bundled `tools/` folder into ~/.hometrans/tools and record the
- * destination in config.env.TOOL_PATH. Returns the destination path, or null if
+ * destination in config.env.HOMETRANS_TOOL_PATH. Returns the destination path, or null if
  * the package ships no tools/ folder.
  */
 async function installTools(toolsRoot, config) {
@@ -78,239 +78,187 @@ async function installTools(toolsRoot, config) {
         return null;
     const toolsDest = getToolsDir();
     await copyDirRecursive(toolsRoot, toolsDest);
-    config.env.TOOL_PATH = toolsDest;
+    config.env.HOMETRANS_TOOL_PATH = toolsDest;
     await saveHomeTransConfig(config);
     return toolsDest;
 }
-/**
- * The AutoTest tools live under the installed HomeTrans tools dir
- * (~/.hometrans/tools/test-tools/autotest) once `installTools` has run.
- * This is the same location the self-tester agent resolves via config.env.TOOL_PATH.
- */
-function resolveAutotestDir(toolPath) {
-    return path.join(toolPath, 'test-tools', 'autotest');
+/** Mask an api_key for display; placeholders/empty shown as-is. */
+function maskKey(key) {
+    if (!key || key === 'YOUR_API_KEY_HERE')
+        return key || '';
+    return key.length <= 8 ? '***' : `${key.slice(0, 4)}***${key.slice(-4)}`;
 }
-async function readFileIfExists(p) {
-    try {
-        return await fs.readFile(p, 'utf-8');
-    }
-    catch {
-        return null;
-    }
+/** Inline notes for each autotest field, shown in the table's Description column. */
+const AUTOTEST_FIELD_NOTES = {
+    name: '多模态(视觉)模型的名字',
+    base_url: '模型API服务的基础地址',
+    api_key: '用于模型API请求认证的令牌',
+    provider: '模型API服务的提供方标识，如openai',
+    temperature: '采样温度',
+    top_p: '核采样阈值',
+    frequency_penalty: '重复惩罚',
+    device_sn: '设备序列号；null 表示自动选用当前连接的设备',
+    ip: '设备连接 IP（hdc）',
+    port: '设备连接端口（hdc）',
+    device_log_level: '设备日志级别：debug/info/...',
+    max_steps: '单条用例最大执行步数',
+    verbose: '是否输出详细日志',
+    lang: '输出语言：zh/en',
+    enable_preprocess: '执行前是否先用 unified_model 把用例拆成步骤序列（多一次 LLM 调用，默认关）',
+    debug_mode: '调试会话：null 关闭 / memory 内存 / file 存盘并跑完后起调试服务(:5000)',
+};
+/** Visual width of a string in a monospace terminal (CJK / fullwidth glyphs = 2). */
+function displayWidth(s) {
+    let w = 0;
+    for (const ch of s) {
+        const cp = ch.codePointAt(0) ?? 0;
+        const wide = (cp >= 0x1100 && cp <= 0x115f) ||
+            (cp >= 0x2e80 && cp <= 0xa4cf) ||
+            (cp >= 0xac00 && cp <= 0xd7a3) ||
+            (cp >= 0xf900 && cp <= 0xfaff) ||
+            (cp >= 0xfe30 && cp <= 0xfe4f) ||
+            (cp >= 0xff00 && cp <= 0xff60) ||
+            (cp >= 0xffe0 && cp <= 0xffe6) ||
+            (cp >= 0x20000 && cp <= 0x3fffd);
+        w += wide ? 2 : 1;
+    }
+    return w;
 }
-/** Template drift check; line-ending differences alone don't count. */
-export function templatesDiffer(a, b) {
-    if (a === null || b === null)
-        return false;
-    const norm = (s) => s.replace(/\r\n/g, '\n');
-    return norm(a) !== norm(b);
+/** padEnd by visual width so columns with CJK content still line up. */
+function padEndDisplay(s, width) {
+    return s + ' '.repeat(Math.max(0, width - displayWidth(s)));
 }
-/** e.g. 20260610-153012 — used to name config backups. */
-function timestampSuffix() {
-    const d = new Date();
-    const p = (n) => String(n).padStart(2, '0');
-    return (`${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}` +
-        `-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`);
+/**
+ * Render the current/default autotest block as a table so the user sees every
+ * field, its current/default value, and a short description. Section label shows
+ * only on the first row of each group for readability.
+ */
+function printAutotestTable(at) {
+    const fmt = (v) => (v === null ? 'null' : String(v));
+    const um = at.unified_model;
+    const data = [
+        ['unified_model', 'name', um.name],
+        ['unified_model', 'base_url', um.base_url],
+        ['unified_model', 'provider', um.provider],
+        ['unified_model', 'api_key', maskKey(um.api_key)],
+        ['unified_model', 'temperature', fmt(um.temperature)],
+        ['unified_model', 'top_p', fmt(um.top_p)],
+        ['unified_model', 'frequency_penalty', fmt(um.frequency_penalty)],
+        ['device', 'device_sn', fmt(at.device.device_sn)],
+        ['device', 'ip', at.device.ip],
+        ['device', 'port', fmt(at.device.port)],
+        ['device', 'device_log_level', at.device.device_log_level],
+        ['agent', 'max_steps', fmt(at.agent.max_steps)],
+        ['agent', 'verbose', fmt(at.agent.verbose)],
+        ['agent', 'lang', at.agent.lang],
+        ['agent', 'enable_preprocess', fmt(at.agent.enable_preprocess)],
+        ['agent', 'debug_mode', fmt(at.agent.debug_mode)],
+    ];
+    const header = ['Section', 'Field', 'Current/Default', 'Description'];
+    // Section label only on the first row of each group.
+    const rows = [];
+    let prevSection = '';
+    for (const [s, f, v] of data) {
+        rows.push([s === prevSection ? '' : s, f, v, AUTOTEST_FIELD_NOTES[f] ?? '']);
+        prevSection = s;
+    }
+    const cols = header.map((h) => displayWidth(h));
+    for (const r of rows) {
+        for (let i = 0; i < cols.length; i++) {
+            cols[i] = Math.max(cols[i], displayWidth(r[i]));
+        }
+    }
+    const border = (l, m, r) => `    ${l}` + cols.map((w) => '─'.repeat(w + 2)).join(m) + r;
+    const row = (cells) => '    │ ' + cells.map((c, i) => padEndDisplay(c, cols[i])).join(' │ ') + ' │';
+    console.log(chalk.gray(border('┌', '┬', '┐')));
+    console.log(chalk.gray(row(header)));
+    console.log(chalk.gray(border('├', '┼', '┤')));
+    for (const r of rows)
+        console.log(chalk.gray(row(r)));
+    console.log(chalk.gray(border('└', '┴', '┘')));
 }
 /**
- * The bundled template changed since the local config was created — ask
- * whether to regenerate. Y = back up the current file with a timestamp and
- * recreate from the new template; N (default, and the non-interactive
- * fallback) = keep the current file and only refresh the keys in place.
- * Ctrl-C aborts init.
+ * Test Configuration step — configures the `autotest` block in
+ * ~/.hometrans/config.json (used by the on-device self-test agent). Shows the
+ * default content, then prompts for the model essentials. The api_key (formerly
+ * TEST_API_KEY) is stored here and NOT written to the system environment;
+ * self_test_runner.py reads it from config.json at run time.
+ *
+ * device / agent stay at their defaults (shown above) — edit config.json to tune.
  */
-async function confirmRegenerateFromTemplate(label) {
-    console.log(chalk.yellow(`  ! ${label}: the bundled template changed since this file was created.`));
+async function promptTestConfig(config) {
+    const at = config.autotest;
+    const um = at.unified_model;
+    console.log('');
+    console.log(chalk.blue('  Test Configuration'));
+    printAutotestTable(at);
+    console.log(chalk.gray('  This step configures only the parameters prompted below; configure all other'));
+    console.log(chalk.gray(`  parameters in config.json: ${getConfigPath()}`));
+    console.log('');
     try {
         const answers = await inquirer.prompt([
             {
-                type: 'confirm',
-                name: 'regenerate',
-                message: `Regenerate ${label} from the new template? (Y = back up current file with a timestamp, then recreate; N = keep current file, only refresh keys)`,
-                default: false,
+                type: 'input',
+                name: 'api_key',
+                message: 'autotest api_key (LLM key the self-test agent uses to run test cases):',
+                default: um.api_key && um.api_key !== 'YOUR_API_KEY_HERE' ? um.api_key : undefined,
+            },
+            { type: 'input', name: 'name', message: 'model name:', default: um.name },
+            { type: 'input', name: 'base_url', message: 'base_url:', default: um.base_url },
+            {
+                type: 'input',
+                name: 'provider',
+                message: 'provider (openai / azure / ...):',
+                default: um.provider,
             },
         ]);
-        return answers.regenerate;
+        if (answers.api_key.trim())
+            um.api_key = answers.api_key.trim();
+        if (answers.name.trim())
+            um.name = answers.name.trim();
+        if (answers.base_url.trim())
+            um.base_url = answers.base_url.trim();
+        if (answers.provider.trim())
+            um.provider = answers.provider.trim();
+        await saveHomeTransConfig(config);
+        const note = um.api_key && um.api_key !== 'YOUR_API_KEY_HERE'
+            ? `api_key ${maskKey(um.api_key)}`
+            : 'api_key left as placeholder — self-test will not run until it is set';
+        console.log(chalk.green(`  + autotest config saved (${note})`));
     }
     catch (err) {
         if (isPromptAbort(err))
             abortInit();
-        console.log(chalk.yellow('    Non-interactive: keeping current file (keys refreshed only).'));
-        return false;
+        console.log(chalk.yellow('  Test configuration skipped (non-interactive mode).'));
     }
 }
 /**
- * Initialize / refresh `agents/test-tools/autotest/config.yaml`:
- *   - If config.yaml does not exist, seed it from config.yaml.example.
- *   - Replace every `api_key: "..."` line with the supplied apiKey.
- *
- * Returns a status string for the result summary, or null if nothing was done
- * (e.g., the autotest folder isn't present in this package).
+ * UI Migration Configuration step — configures the GLM key used by the
+ * incremental UI-alignment skill's phone-agent. GLM_API_KEY is read from the OS
+ * environment at run time (app_feature_verify.py), so it stays in config.env and
+ * is persisted as a machine env var by maybePersistMachineEnv.
  */
-async function refreshAutotestConfig(autotestDir, apiKey, prevExampleContent = null) {
-    const examplePath = path.join(autotestDir, 'config.yaml.example');
-    const configPath = path.join(autotestDir, 'config.yaml');
-    const hasExample = await fs
-        .access(examplePath)
-        .then(() => true)
-        .catch(() => false);
-    if (!hasExample)
-        return null;
-    let seeded = false;
-    let backupName = null;
-    let templateBackupName = null;
-    const hasConfig = await fs
-        .access(configPath)
-        .then(() => true)
-        .catch(() => false);
-    if (!hasConfig) {
-        await fs.copyFile(examplePath, configPath);
-        seeded = true;
-    }
-    else {
-        // Template drift: the bundled example changed since the local config was
-        // created (prevExampleContent = local example snapshot taken before the
-        // tools copy). Y regenerates from the new template after a timestamped
-        // backup; N keeps the local file (key-only refresh below) — but saves the
-        // old template alongside, since the new one just overwrote it on disk
-        // and the local config is still based on the old one.
-        const newExample = await fs.readFile(examplePath, 'utf-8');
-        if (templatesDiffer(prevExampleContent, newExample)) {
-            if (await confirmRegenerateFromTemplate('autotest config.yaml')) {
-                backupName = `config.yaml.${timestampSuffix()}.bak`;
-                await fs.copyFile(configPath, path.join(autotestDir, backupName));
-                await fs.copyFile(examplePath, configPath);
-            }
-            else {
-                templateBackupName = `config.yaml.example.${timestampSuffix()}.bak`;
-                await fs.writeFile(path.join(autotestDir, templateBackupName), prevExampleContent, 'utf-8');
-            }
-        }
-    }
-    if (!apiKey) {
-        if (backupName) {
-            return `autotest config.yaml regenerated from new template (backup: ${backupName}; api_key left as placeholder)`;
-        }
-        if (templateBackupName) {
-            return `autotest config.yaml kept (old template backed up: ${templateBackupName})`;
-        }
-        return seeded
-            ? `autotest config.yaml seeded (api_key left as placeholder)`
-            : null;
-    }
-    const original = await fs.readFile(configPath, 'utf-8');
-    // Match `api_key: <value>` with optional quoting, preserve indent + key.
-    const updated = original.replace(/^(\s*api_key\s*:\s*)(?:"[^"]*"|'[^']*'|\S+)\s*$/gm, (_m, prefix) => `${prefix}"${apiKey}"`);
-    if (updated !== original) {
-        await fs.writeFile(configPath, updated, 'utf-8');
-    }
-    if (backupName) {
-        return `autotest config.yaml regenerated from new template + api_key filled (backup: ${backupName})`;
-    }
-    if (templateBackupName) {
-        return `autotest config.yaml api_key refreshed (kept local file; old template backed up: ${templateBackupName})`;
-    }
-    return seeded
-        ? `autotest config.yaml seeded + api_key filled`
-        : `autotest config.yaml api_key refreshed`;
-}
-const UI_ALIGN_SKILL = 'hmos-incremental-ui-align';
-/**
- * Initialize / refresh `<skillsDir>/hmos-incremental-ui-align/config.json`
- * in an editor's installed skills dir — same semantics as the autotest
- * config.yaml handling:
- *   - If config.json does not exist, seed it from config-example.json.
- *   - If it exists, surgically overwrite ONLY the `glm_api_key` and
- *     `hmos_sdk_dir` values (via jsonc edits), preserving every other
- *     field the user has set. `hmos_sdk_dir` = `<DEVECO_SDK_HOME>/default`.
- *
- * Returns a status string for the result summary, or null if nothing was
- * done (skill not installed there, or no values to write into an existing file).
- */
-export async function refreshUiAlignConfig(skillsDir, glmApiKey, hmosSdkDir, prevExampleContent = null) {
-    const skillDir = path.join(skillsDir, UI_ALIGN_SKILL);
-    const examplePath = path.join(skillDir, 'config-example.json');
-    const configPath = path.join(skillDir, 'config.json');
-    const hasExample = await fs
-        .access(examplePath)
-        .then(() => true)
-        .catch(() => false);
-    if (!hasExample)
-        return null;
-    let seeded = false;
-    let backupName = null;
-    let templateBackupName = null;
-    const hasConfig = await fs
-        .access(configPath)
-        .then(() => true)
-        .catch(() => false);
-    if (!hasConfig) {
-        await fs.copyFile(examplePath, configPath);
-        seeded = true;
-    }
-    else {
-        // Template drift: bundled config-example.json changed since the local
-        // config.json was created (prevExampleContent = snapshot taken before the
-        // skills copy). Y regenerates from the new template after a timestamped
-        // backup; N keeps the local file (key-only update below) — but saves the
-        // old template alongside, since the new one just overwrote it on disk
-        // and the local config is still based on the old one.
-        const newExample = await fs.readFile(examplePath, 'utf-8');
-        if (templatesDiffer(prevExampleContent, newExample)) {
-            if (await confirmRegenerateFromTemplate(`${UI_ALIGN_SKILL}/config.json`)) {
-                backupName = `config.json.${timestampSuffix()}.bak`;
-                await fs.copyFile(configPath, path.join(skillDir, backupName));
-                await fs.copyFile(examplePath, configPath);
-            }
-            else {
-                templateBackupName = `config-example.json.${timestampSuffix()}.bak`;
-                await fs.writeFile(path.join(skillDir, templateBackupName), prevExampleContent, 'utf-8');
-            }
-        }
-    }
-    const updates = [];
-    if (glmApiKey)
-        updates.push(['glm_api_key', glmApiKey]);
-    if (hmosSdkDir)
-        updates.push(['hmos_sdk_dir', hmosSdkDir]);
-    if (updates.length === 0) {
-        if (backupName) {
-            return `${UI_ALIGN_SKILL}/config.json regenerated from new template (backup: ${backupName}; glm_api_key / hmos_sdk_dir left empty)`;
-        }
-        if (templateBackupName) {
-            return `${UI_ALIGN_SKILL}/config.json kept (old template backed up: ${templateBackupName})`;
-        }
-        return seeded
-            ? `${UI_ALIGN_SKILL}/config.json seeded (glm_api_key / hmos_sdk_dir left empty)`
-            : null;
-    }
-    let raw = await fs.readFile(configPath, 'utf-8');
-    const parseErrors = [];
-    const tree = parseTree(raw, parseErrors);
-    if (!tree || tree.type !== 'object' || parseErrors.length > 0) {
-        // Corrupt config — never regenerate over user content; just report.
-        return `${UI_ALIGN_SKILL}/config.json NOT updated (file is not valid JSON — fix it manually)`;
-    }
-    const original = raw;
-    for (const [key, value] of updates) {
-        const edits = modify(raw, [key], value, {
-            formattingOptions: { tabSize: 2, insertSpaces: true },
-        });
-        raw = applyEdits(raw, edits);
-    }
-    if (raw !== original) {
-        await fs.writeFile(configPath, raw, 'utf-8');
-    }
-    const what = updates.map(([k]) => k).join(' + ');
-    if (backupName) {
-        return `${UI_ALIGN_SKILL}/config.json regenerated from new template + ${what} filled (backup: ${backupName})`;
+async function promptUiAlignConfig(config) {
+    console.log('');
+    console.log(chalk.blue('  UI Migration Configuration'));
+    console.log(chalk.gray('  GLM_API_KEY: Zhipu GLM key for the UI-alignment phone-agent (read from the OS env at run time).'));
+    try {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'GLM_API_KEY',
+                message: 'GLM_API_KEY (LLM API key for the GLM phone-agent used in UI alignment):',
+                default: config.env.GLM_API_KEY || undefined,
+            },
+        ]);
+        config.env.GLM_API_KEY = answers.GLM_API_KEY.trim();
+        await saveHomeTransConfig(config);
     }
-    if (templateBackupName) {
-        return `${UI_ALIGN_SKILL}/config.json ${what} refreshed (kept local file; old template backed up: ${templateBackupName})`;
+    catch (err) {
+        if (isPromptAbort(err))
+            abortInit();
+        console.log(chalk.yellow('  UI migration configuration skipped (non-interactive mode).'));
     }
-    return seeded
-        ? `${UI_ALIGN_SKILL}/config.json seeded + ${what} filled`
-        : `${UI_ALIGN_SKILL}/config.json ${what} refreshed`;
 }
 async function installSkillsTo(skillsRoot, targetDir, skipNames = new Set()) {
     let entries;
@@ -339,7 +287,46 @@ async function installSkillsTo(skillsRoot, targetDir, skipNames = new Set()) {
     }
     return installed;
 }
-async function installAgentsTo(agentsRoot, targetDir, skipNames = new Set()) {
+/**
+ * Strip the `color:` line from a markdown agent's YAML frontmatter. DevEco Code's
+ * config schema rejects named colors (only hex `#RRGGBB` or a theme token is
+ * allowed) and aborts startup, so for that editor we drop the field entirely —
+ * agents work fine without it. Only the leading frontmatter block is touched.
+ */
+export function stripAgentMarkdownColor(content) {
+    const fm = content.match(/^---\r?\n[\s\S]*?\r?\n---/);
+    if (!fm)
+        return content;
+    const block = fm[0];
+    const stripped = block.replace(/^color:[ \t]*\S.*\r?\n/m, '');
+    return stripped === block ? content : content.replace(block, stripped);
+}
+/** Copy one agent file, stripping the frontmatter color from `.md` when requested. */
+async function copyAgentFile(src, dest, stripColor) {
+    if (stripColor && src.endsWith('.md')) {
+        const raw = await fs.readFile(src, 'utf-8');
+        await fs.writeFile(dest, stripAgentMarkdownColor(raw), 'utf-8');
+    }
+    else {
+        await fs.copyFile(src, dest);
+    }
+}
+/** Recursively copy an agent subdirectory, stripping colors from `.md` files. */
+async function copyAgentDirRecursive(src, dest, stripColor) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyAgentDirRecursive(srcPath, destPath, stripColor);
+        }
+        else {
+            await copyAgentFile(srcPath, destPath, stripColor);
+        }
+    }
+}
+async function installAgentsTo(agentsRoot, targetDir, skipNames = new Set(), stripColor = false) {
     let entries;
     try {
         entries = await fs.readdir(agentsRoot, { withFileTypes: true });
@@ -355,10 +342,10 @@ async function installAgentsTo(agentsRoot, targetDir, skipNames = new Set()) {
         const srcPath = path.join(agentsRoot, entry.name);
         const destPath = path.join(targetDir, entry.name);
         if (entry.isDirectory()) {
-            await copyDirRecursive(srcPath, destPath);
+            await copyAgentDirRecursive(srcPath, destPath, stripColor);
         }
         else if (entry.isFile()) {
-            await fs.copyFile(srcPath, destPath);
+            await copyAgentFile(srcPath, destPath, stripColor);
             if (entry.name.endsWith('.md')) {
                 installed.push(entry.name.slice(0, -3));
             }
@@ -438,7 +425,7 @@ async function confirmOverwrite(editorName, skillConflicts, agentConflicts) {
         return true;
     }
 }
-async function installForEditor(editor, skillsRoot, agentsRoot, glmApiKey, hmosSdkDir, result) {
+async function installForEditor(editor, skillsRoot, agentsRoot, result) {
     const marker = expandHome(editor.markerDir);
     if (marker && !(await dirExists(marker))) {
         result.skipped.push(`${editor.name} (not installed)`);
@@ -461,9 +448,6 @@ async function installForEditor(editor, skillsRoot, agentsRoot, glmApiKey, hmosS
     if (skillConflicts.length > 0 || agentConflicts.length > 0) {
         overwrite = await confirmOverwrite(editor.name, skillConflicts, agentConflicts);
     }
-    // Snapshot the installed ui-align template BEFORE the skills copy updates
-    // it — refreshUiAlignConfig uses it to detect template drift.
-    const prevUiAlignExample = await readFileIfExists(path.join(skillsDir, UI_ALIGN_SKILL, 'config-example.json'));
     // N = incremental install: keep the conflicting items untouched, still copy
     // everything that doesn't exist in the target dirs yet.
     const skipSkills = overwrite ? new Set() : new Set(skillConflicts);
@@ -478,22 +462,10 @@ async function installForEditor(editor, skillsRoot, agentsRoot, glmApiKey, hmosS
         result.errors.push(`${editor.name} skills: ${err.message}`);
     }
     if (!overwrite) {
-        result.skipped.push(`${editor.name} existing kept: ${skipSkills.size} skills, ${skipAgents.size} agents (new items installed, API-key configs refreshed)`);
-    }
-    // Seed / refresh the incremental-ui-align per-skill config.json with the
-    // GLM key + SDK dir from ~/.hometrans/config.json (existing files: key-only
-    // update). Runs regardless of the overwrite decision above.
-    try {
-        const status = await refreshUiAlignConfig(skillsDir, glmApiKey, hmosSdkDir, prevUiAlignExample);
-        if (status) {
-            result.configured.push(`${editor.name} ${status}`);
-        }
-    }
-    catch (err) {
-        result.errors.push(`${editor.name} ${UI_ALIGN_SKILL}/config.json: ${err.message}`);
+        result.skipped.push(`${editor.name} existing kept: ${skipSkills.size} skills, ${skipAgents.size} agents (new items installed)`);
     }
     try {
-        const agents = await installAgentsTo(agentsRoot, agentsDir, skipAgents);
+        const agents = await installAgentsTo(agentsRoot, agentsDir, skipAgents, editor.stripAgentColors ?? false);
         if (agents.length > 0) {
             result.configured.push(`${editor.name} agents (${agents.length} -> ${prettyHome(agentsDir)})`);
         }
@@ -654,8 +626,8 @@ async function detectEnvironment(spec, env) {
     const isWin = process.platform === 'win32';
     const baseDir = (key) => key === 'DEVECO_SDK_HOME'
         ? env.DEVECO_SDK_HOME
-        : key === 'DEVECO_PATH'
-            ? env.DEVECO_PATH
+        : key === 'DEVECO_HOME'
+            ? env.DEVECO_HOME
             : '';
     for (const [id, tool] of Object.entries(spec.tools)) {
         if (tool.source === 'env-dir') {
@@ -815,6 +787,82 @@ async function detectInstalledEditors(editors) {
     }
     return status;
 }
+/**
+ * Config env keys that are useful as real OS environment variables (the SDK
+ * paths + tool dir + GLM key). PATH entries for node/java/hdc are not included
+ * here — those are documented as manual PATH setup.
+ *
+ * TEST_API_KEY is intentionally absent: the self-test api_key now lives in the
+ * `autotest` block of config.json (configured by the Test Configuration step)
+ * and is read from there by self_test_runner.py — never from the system env.
+ * GLM_API_KEY stays, because the UI-alignment phone-agent reads it from the OS
+ * environment at run time.
+ */
+export const MACHINE_ENV_KEYS = [
+    'DEVECO_SDK_HOME',
+    'DEVECO_HOME',
+    'OHOS_SDK_PATH',
+    'HMS_SDK_PATH',
+    'HOMETRANS_TOOL_PATH',
+    'GLM_API_KEY',
+];
+/** Mask API-key values for display; show paths in full. */
+function maskEnvValue(name, value) {
+    if (/_API_KEY$/.test(name) && value.length > 0) {
+        return value.length <= 8 ? '***' : `${value.slice(0, 4)}***${value.slice(-4)}`;
+    }
+    return value;
+}
+/**
+ * Show the resolved config values that would become machine environment
+ * variables, then ask Y/N before writing them (Windows: setx; macOS/Linux:
+ * shell rc block). Non-interactive shells skip without changing anything.
+ * Re-throws ExitPromptError so the caller can abort init on Ctrl-C.
+ */
+async function maybePersistMachineEnv(env) {
+    const vars = MACHINE_ENV_KEYS.map((k) => [k, (env[k] ?? '').trim()]).filter(([, value]) => value.length > 0);
+    if (vars.length === 0)
+        return;
+    console.log('');
+    console.log(chalk.blue('  Add these to your machine environment variables?'));
+    console.log(chalk.gray(process.platform === 'win32'
+        ? '  (Windows: persisted via setx to your user environment)'
+        : '  (macOS/Linux: written as an export block to your shell profile)'));
+    for (const [name, value] of vars) {
+        console.log(`    ${chalk.cyan(name)} = ${maskEnvValue(name, value)}`);
+    }
+    console.log('');
+    console.log(chalk.yellow('  Recommended: skills and MCP tools read these from the OS environment at runtime.'));
+    console.log(chalk.gray('  If you choose No, they are NOT set as system variables — skills/tools that rely on\n' +
+        '  them (self-test, UI alignment, commit-context analysis) may fail until you set them\n' +
+        '  yourself or re-run `ht init`.'));
+    let confirmed;
+    try {
+        const answers = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'persist',
+                message: 'Write these environment variables to this machine?',
+                default: true,
+            },
+        ]);
+        confirmed = answers.persist;
+    }
+    catch (err) {
+        if (isPromptAbort(err))
+            throw err;
+        console.log(chalk.yellow('    Non-interactive: skipped (set them manually if needed).'));
+        return;
+    }
+    if (!confirmed) {
+        console.log(chalk.yellow('    Skipped — no system environment variables were set.'));
+        console.log(chalk.gray('    Skills/MCP tools that need these (e.g. SDK paths, API keys) will not find them\n' +
+            '    automatically. Set them manually or re-run `ht init` to enable those features.'));
+        return;
+    }
+    const note = await persistEnvVars(vars);
+    console.log(chalk.green(`  + Environment variables ${note}`));
+}
 export async function initCommand(options = {}) {
     ensureChalkColor();
     const banner = figlet.textSync('HomeTrans', { font: 'Standard' });
@@ -833,7 +881,16 @@ export async function initCommand(options = {}) {
         process.exitCode = 1;
         return;
     }
+    // Generate an initial ~/.hometrans/config.json up front (first-use scenario):
+    // loadHomeTransConfig writes a complete default file (editors + env + autotest)
+    // when none exists, and saveHomeTransConfig flushes it again to be certain it is
+    // on disk before any later step (e.g. Test Configuration) points the user at it.
+    const configPath = getConfigPath();
+    const configExisted = await pathExists(configPath);
     const config = await loadHomeTransConfig();
+    await saveHomeTransConfig(config);
+    console.log(chalk.green(`  ${configExisted ? 'Using' : 'Initialized'} config: ${configPath}`));
+    console.log('');
     const { editors } = config;
     const installedStatus = await detectInstalledEditors(editors);
     let selectedEditors;
@@ -889,7 +946,7 @@ export async function initCommand(options = {}) {
         console.log(chalk.yellow('\n  No editors selected. Nothing to do.\n'));
         return;
     }
-    // --- User parameters (SDK paths, test API key) ---
+    // --- User parameters (SDK paths) ---
     console.log('');
     console.log(chalk.blue('  Parameter Configuration'));
     console.log(chalk.gray('  (press Enter to keep current value or leave empty)\n'));
@@ -901,33 +958,19 @@ export async function initCommand(options = {}) {
                 message: 'DEVECO_SDK_HOME (DevEco Studio SDK dir):',
                 default: config.env.DEVECO_SDK_HOME || undefined,
             },
-            {
-                type: 'input',
-                name: 'TEST_API_KEY',
-                message: 'TEST_API_KEY (LLM API key used by the integration-test agent to run test cases):',
-                default: config.env.TEST_API_KEY || undefined,
-            },
-            {
-                type: 'input',
-                name: 'GLM_API_KEY',
-                message: 'GLM_API_KEY (LLM API key for the GLM phone-agent used in UI alignment):',
-                default: config.env.GLM_API_KEY || undefined,
-            },
         ]);
         const sdk = deriveSdkPaths(answers.DEVECO_SDK_HOME);
         config.env.DEVECO_SDK_HOME = sdk.DEVECO_SDK_HOME;
-        config.env.DEVECO_PATH = sdk.DEVECO_PATH;
+        config.env.DEVECO_HOME = sdk.DEVECO_HOME;
         config.env.OHOS_SDK_PATH = sdk.OHOS_SDK_PATH;
         config.env.HMS_SDK_PATH = sdk.HMS_SDK_PATH;
-        config.env.TEST_API_KEY = answers.TEST_API_KEY.trim();
-        config.env.GLM_API_KEY = answers.GLM_API_KEY.trim();
         await saveHomeTransConfig(config);
         // Echo the derived paths and validate each exists on disk; missing ones are
         // a strong signal of a typo'd DEVECO_SDK_HOME or a broken DevEco install.
         if (sdk.DEVECO_SDK_HOME) {
             const checks = [
                 ['DEVECO_SDK_HOME', sdk.DEVECO_SDK_HOME],
-                ['DEVECO_PATH', sdk.DEVECO_PATH],
+                ['DEVECO_HOME', sdk.DEVECO_HOME],
                 ['OHOS_SDK_PATH', sdk.OHOS_SDK_PATH],
                 ['HMS_SDK_PATH', sdk.HMS_SDK_PATH],
             ];
@@ -955,6 +998,13 @@ export async function initCommand(options = {}) {
             abortInit();
         console.log(chalk.yellow('  Parameter prompts skipped (non-interactive mode).'));
     }
+    // UI Migration Configuration — configure the GLM key for the UI-alignment
+    // phone-agent. Stays in config.env (read from the OS env at run time).
+    await promptUiAlignConfig(config);
+    // Test Configuration — configure the autotest block (self-test api_key etc.)
+    // in config.json. Replaces the old TEST_API_KEY env prompt; never written to
+    // the system environment.
+    await promptTestConfig(config);
     // Detect external tools (adb / hdc / python / uv / java / gitnexus + DevEco)
     // and report which skills/agents are impacted by anything missing.
     try {
@@ -963,19 +1013,15 @@ export async function initCommand(options = {}) {
     catch (err) {
         console.log(chalk.yellow(`  ! environment check skipped: ${err.message}`));
     }
-    // Snapshot the currently installed autotest template BEFORE the tools copy
-    // overwrites it — refreshAutotestConfig compares it with the new template
-    // to detect drift and offer a config.yaml regeneration.
-    const prevAutotestExample = await readFileIfExists(path.join(resolveAutotestDir(config.env.TOOL_PATH || getToolsDir()), 'config.yaml.example'));
-    // Copy bundled tools/ into ~/.hometrans/tools and record env.TOOL_PATH.
-    // Must run before the autotest config step below, which seeds config.yaml
-    // into the installed tools dir (the location agents read via env.TOOL_PATH).
+    // Copy bundled tools/ into ~/.hometrans/tools and record env.HOMETRANS_TOOL_PATH.
+    // self_test_runner.py (under the installed tools dir) reads the autotest
+    // config from ~/.hometrans/config.json at run time — see promptTestConfig.
     let installedToolPath = null;
     try {
         installedToolPath = await installTools(toolsRoot, config);
         if (installedToolPath) {
             console.log(chalk.green(`  + tools copied -> ${prettyHome(installedToolPath)}`));
-            console.log(chalk.gray(`    TOOL_PATH set in ${prettyHome(getConfigPath())}`));
+            console.log(chalk.gray(`    HOMETRANS_TOOL_PATH set in ${prettyHome(getConfigPath())}`));
         }
     }
     catch (err) {
@@ -992,32 +1038,25 @@ export async function initCommand(options = {}) {
     catch (err) {
         console.log(chalk.red(`  ! env-requirements.json copy: ${err.message}`));
     }
-    // Initialize / refresh autotest config.yaml from the example template,
-    // inside the installed tools dir (<TOOL_PATH>/test-tools/autotest).
+    // (The autotest block in config.json was already configured by the Test
+    // Configuration step above; self_test_runner.py reads it at run time.)
+    // Offer to persist the resolved config values as real OS environment
+    // variables (Windows: setx; macOS/Linux: shell rc block). Shows what will be
+    // written and asks Y/N first; runs after HOMETRANS_TOOL_PATH is finalized above.
     try {
-        const toolPath = installedToolPath ?? config.env.TOOL_PATH;
-        if (toolPath) {
-            const autotestDir = resolveAutotestDir(toolPath);
-            const status = await refreshAutotestConfig(autotestDir, config.env.TEST_API_KEY, prevAutotestExample);
-            if (status) {
-                console.log(chalk.green(`  + ${status}`));
-                console.log(chalk.gray(`    ${path.join(autotestDir, 'config.yaml')}`));
-            }
-        }
+        await maybePersistMachineEnv(config.env);
     }
     catch (err) {
-        console.log(chalk.red(`  ! autotest config.yaml: ${err.message}`));
+        if (isPromptAbort(err))
+            abortInit();
+        console.log(chalk.red(`  ! environment variables: ${err.message}`));
     }
     console.log('');
     const editorsToSetup = editors.filter((e) => selectedEditors.includes(e.name));
     const result = { configured: [], skipped: [], errors: [] };
-    // hmos_sdk_dir consumed by incremental-ui-align = <DEVECO_SDK_HOME>/default.
-    const hmosSdkDir = config.env.DEVECO_SDK_HOME
-        ? path.join(config.env.DEVECO_SDK_HOME, 'default')
-        : '';
     for (const editor of editorsToSetup) {
         console.log(chalk.blue(`  Configuring ${editor.name}...`));
-        await installForEditor(editor, skillsRoot, agentsRoot, config.env.GLM_API_KEY, hmosSdkDir, result);
+        await installForEditor(editor, skillsRoot, agentsRoot, result);
     }
     await setupMcpForAllEditors(editorsToSetup, result);
     console.log('');