claude360 0.2.7 → 0.2.9

package/src/init-config.js

@@ -9,8 +9,13 @@ import path from "node:path";
 
 import { createBackup } from "./backup.js";
 import { upsertMarkedBlock } from "./mcp-skill.js";
-import { upsertProfileKey, validateBasicToml } from "./tool-launcher.js";
+import { upsertTopLevelKey, validateBasicToml } from "./tool-launcher.js";
 import { renderModelTable } from "./ui.js";
+import { colorLevel } from "./colors.js";
+import { createMessenger } from "./messages.js";
+
+// 语义消息器工厂：真实终端着色，测试/管道（writeLine 被替换）下无色。
+const mk = (writeLine) => createMessenger({ writeLine, color: writeLine === console.log ? colorLevel() : 0 });
 
 const defaultFs = { copyFile, cp, mkdir, readFile, stat, writeFile };
 
@@ -36,10 +41,11 @@ async function readFileIfExists(fs, filePath) {
 // 写入 Markdown 标记区块：先备份目标文件到 baseDir/backup/backup_<时间戳>/，
 // 再以 claude360 标记区块幂等更新，不触碰用户已有内容。
 async function writeMarkedBlock({ baseDir, filePath, blockId, content, writeLine, fs, now }) {
+  const msg = mk(writeLine);
   const current = await readFileIfExists(fs, filePath);
   const { backupDir } = await createBackup({ baseDir, paths: [filePath], fs, now });
   if (backupDir) {
-    writeLine(`✓ 已创建备份：${backupDir}`);
+    msg.success(`已创建备份：${backupDir}`);
   }
   await fs.mkdir(path.dirname(filePath), { recursive: true });
   await fs.writeFile(filePath, upsertMarkedBlock(current, blockId, content), "utf8");
@@ -85,12 +91,13 @@ export async function configureOutputLanguage({
   if (typeof promptSelect !== "function") {
     throw new Error("缺少选择输入");
   }
+  const msg = mk(writeLine);
   const selected = await promptSelect("请选择 AI 输出语言：", [
     ...OUTPUT_LANGUAGES.map((language) => ({ label: language.label, value: language.id })),
     { label: "跳过", value: "skip" },
   ]);
   if (selected === "skip") {
-    writeLine("已跳过 AI 输出语言配置。");
+    msg.info("已跳过 AI 输出语言配置。");
     return { skipped: true };
   }
   const language = OUTPUT_LANGUAGES.find((item) => item.id === selected);
@@ -103,7 +110,7 @@ export async function configureOutputLanguage({
     fs,
     now,
   });
-  writeLine(`✓ AI 输出语言已写入：${filePath}`);
+  msg.success(`AI 输出语言已写入：${filePath}`);
   return { skipped: false, language: language.id };
 }
 
@@ -164,8 +171,9 @@ export async function configurePromptStyle({
   if (typeof promptSelect !== "function") {
     throw new Error("缺少选择输入");
   }
+  const msg = mk(writeLine);
   for (const style of PROMPT_STYLES) {
-    writeLine(`${style.label.trim()}：${style.desc}`);
+    msg.info(`${style.label.trim()}：${style.desc}`);
   }
   writeLine("");
   const selected = await promptSelect("请选择系统提示词风格：", [
@@ -173,7 +181,7 @@ export async function configurePromptStyle({
     { label: "跳过", value: "skip" },
   ]);
   if (selected === "skip") {
-    writeLine("已跳过系统提示词风格配置。");
+    msg.info("已跳过系统提示词风格配置。");
     return { skipped: true };
   }
   const style = PROMPT_STYLES.find((item) => item.id === selected);
@@ -186,7 +194,7 @@ export async function configurePromptStyle({
     fs,
     now,
   });
-  writeLine(`✓ 系统提示词风格已写入：${filePath}`);
+  msg.success(`系统提示词风格已写入：${filePath}`);
   return { skipped: false, style: style.id };
 }
 
@@ -252,9 +260,10 @@ async function readJsonIfExists(fs, filePath) {
 }
 
 async function writeJsonWithBackup({ baseDir, filePath, json, writeLine, fs, now }) {
+  const msg = mk(writeLine);
   const { backupDir } = await createBackup({ baseDir, paths: [filePath], fs, now });
   if (backupDir) {
-    writeLine(`✓ 已创建备份：${backupDir}`);
+    msg.success(`已创建备份：${backupDir}`);
   }
   await fs.mkdir(path.dirname(filePath), { recursive: true });
   await fs.writeFile(filePath, `${JSON.stringify(json, null, 2)}\n`, "utf8");
@@ -271,22 +280,23 @@ export async function configureClaudeDefaultModel({
   if (typeof promptSelect !== "function") {
     throw new Error("缺少选择输入");
   }
+  const msg = mk(writeLine);
   const { models, source } = await loadAvailableModels(api, "claude_code");
   let list = models;
   if (source !== "backend") {
-    writeLine("Claude360 后端暂未提供模型列表，以下为 Claude Code 官方模型别名：");
+    msg.info("Claude360 后端暂未提供模型列表，以下为 Claude Code 官方模型别名：");
     list = FALLBACK_CLAUDE_ALIASES;
   }
   const selected = await selectModelFromList({ models: list, promptSelect, writeLine });
   if (selected === "skip") {
-    writeLine("已跳过默认模型配置。");
+    msg.info("已跳过默认模型配置。");
     return { skipped: true };
   }
   const settingsPath = path.join(claudeDir, "settings.json");
   const settings = await readJsonIfExists(fs, settingsPath);
   settings.model = selected;
   await writeJsonWithBackup({ baseDir: claudeDir, filePath: settingsPath, json: settings, writeLine, fs, now });
-  writeLine(`✓ 默认模型已设置为 ${selected}（${settingsPath}）`);
+  msg.success(`默认模型已设置为 ${selected}（${settingsPath}）`);
   return { skipped: false, model: selected };
 }
 
@@ -328,8 +338,9 @@ export async function importClaudeEnvPermissions({
   if (typeof confirm !== "function") {
     throw new Error("缺少确认输入");
   }
+  const msg = mk(writeLine);
   const settingsPath = path.join(claudeDir, "settings.json");
-  writeLine([
+  msg.info([
     "导入推荐环境变量和权限配置",
     "",
     "该操作将为 Claude Code 写入推荐配置：",
@@ -341,7 +352,7 @@ export async function importClaudeEnvPermissions({
   ].join("\n"));
   const approved = await confirm("是否继续？");
   if (!approved) {
-    writeLine("已跳过推荐环境变量和权限配置。");
+    msg.info("已跳过推荐环境变量和权限配置。");
     return { skipped: true };
   }
   const settings = await readJsonIfExists(fs, settingsPath);
@@ -350,7 +361,7 @@ export async function importClaudeEnvPermissions({
   const allow = new Set([...(settings.permissions?.allow || []), ...recommended.permissions.allow]);
   settings.permissions = { ...(settings.permissions || {}), allow: [...allow] };
   await writeJsonWithBackup({ baseDir: claudeDir, filePath: settingsPath, json: settings, writeLine, fs, now });
-  writeLine(`✓ 推荐环境变量与权限配置已写入：${settingsPath}`);
+  msg.success(`推荐环境变量与权限配置已写入：${settingsPath}`);
   return { skipped: false, path: settingsPath };
 }
 
@@ -371,31 +382,34 @@ export async function configureCodexDefaultModel({
   if (typeof promptSelect !== "function") {
     throw new Error("缺少选择输入");
   }
+  const msg = mk(writeLine);
   const { models, source } = await loadAvailableModels(api, "codex");
   if (source !== "backend") {
-    writeLine("Claude360 后端暂未提供 Codex 模型列表，已跳过默认模型写入。");
-    writeLine("可在启动 Codex 后使用 /model 命令选择模型。");
+    msg.info("Claude360 后端暂未提供 Codex 模型列表，已跳过默认模型写入。");
+    msg.hint("可在启动 Codex 后使用 /model 命令选择模型。");
     return { skipped: true };
   }
   const selected = await selectModelFromList({ models, promptSelect, writeLine });
   if (selected === "skip") {
-    writeLine("已跳过默认模型配置。");
+    msg.info("已跳过默认模型配置。");
     return { skipped: true };
   }
-  const configPath = path.join(codexDir, "config.toml");
-  const current = await readFileIfExists(fs, configPath);
-  const next = `${upsertProfileKey(current, "claude360", "model", selected).trimEnd()}\n`;
+  // Codex profile v2：模型写入 profile 覆盖层 claude360.config.toml 的顶层 model 键，
+  // 不再写主 config.toml 的 [profiles.claude360] 表（新版 Codex 拒绝其与 --profile 共存）。
+  const profileConfigPath = path.join(codexDir, "claude360.config.toml");
+  const current = await readFileIfExists(fs, profileConfigPath);
+  const next = `${upsertTopLevelKey(current, "model", selected).trimEnd()}\n`;
   const tomlError = validateBasicToml(next);
   if (tomlError) {
-    writeLine(`× 生成的 Codex 配置 TOML 校验失败：${tomlError}\n已放弃写入，原配置保持不变。`);
+    msg.error(`生成的 Codex 配置 TOML 校验失败：${tomlError}\n已放弃写入，原配置保持不变。`);
     return { skipped: true };
   }
-  const { backupDir } = await createBackup({ baseDir: codexDir, paths: [configPath], fs, now });
+  const { backupDir } = await createBackup({ baseDir: codexDir, paths: [profileConfigPath], fs, now });
   if (backupDir) {
-    writeLine(`✓ 已创建备份：${backupDir}`);
+    msg.success(`已创建备份：${backupDir}`);
   }
   await fs.mkdir(codexDir, { recursive: true });
-  await fs.writeFile(configPath, next, "utf8");
-  writeLine(`✓ Codex 默认模型已设置为 ${selected}（${configPath}）`);
+  await fs.writeFile(profileConfigPath, next, "utf8");
+  msg.success(`Codex 默认模型已设置为 ${selected}（${profileConfigPath}）`);
   return { skipped: false, model: selected };
 }

package/src/init-flow.js

@@ -3,26 +3,33 @@
 // 不阻塞主流程（AC-05）。各步骤动作由 index.js 注入，本模块只负责编排与输出。
 
 import { safeErrorMessage } from "./sanitize.js";
+import { colorLevel } from "./colors.js";
+import { createMessenger } from "./messages.js";
+
+// 语义消息器工厂：真实终端着色，测试/管道（writeLine 被替换）下无色。
+const mk = (writeLine) => createMessenger({ writeLine, color: writeLine === console.log ? colorLevel() : 0 });
 
 export async function runFullInit({ title, steps, writeLine = console.log } = {}) {
-  writeLine(`${title}\n`);
+  const msg = mk(writeLine);
+  msg.title(title);
+  writeLine("");
   let index = 0;
   for (const step of steps) {
     index += 1;
-    writeLine(`第 ${index} 步：${step.title}`);
+    msg.step(`第 ${index} 步：${step.title}`);
     try {
       const result = await step.run();
       if (step.required && result === false) {
-        writeLine(`已在「${step.title}」中止初始化。`);
+        msg.warn(`已在「${step.title}」中止初始化。`);
         return { completed: false, abortedAt: step.title };
       }
     } catch (error) {
       if (step.required) {
-        writeLine(`× ${step.title}失败：${safeErrorMessage(error)}`);
-        writeLine("初始化已中止，可稍后在菜单中重试。");
+        msg.error(`${step.title}失败：${safeErrorMessage(error)}`);
+        msg.hint("初始化已中止，可稍后在菜单中重试。");
         return { completed: false, abortedAt: step.title };
       }
-      writeLine(`! ${step.title}失败（已跳过，不影响后续步骤）：${safeErrorMessage(error)}`);
+      msg.warn(`${step.title}失败（已跳过，不影响后续步骤）：${safeErrorMessage(error)}`);
     }
     writeLine("");
   }

package/src/mcp-skill.js

@@ -9,6 +9,11 @@ import path from "node:path";
 
 import { createBackup } from "./backup.js";
 import { upsertTomlTable, validateBasicToml } from "./tool-launcher.js";
+import { colorLevel } from "./colors.js";
+import { createMessenger } from "./messages.js";
+
+// 语义消息器工厂：真实终端着色，测试/管道（writeLine 被替换）下无色。
+const mk = (writeLine) => createMessenger({ writeLine, color: writeLine === console.log ? colorLevel() : 0 });
 
 // ──────────────────────────────────────────────
 // 推荐 MCP（PRD 6.6）：Claude Code 通过官方 `claude mcp add --scope user`
@@ -138,6 +143,7 @@ export async function readInstalledClaudeMcps({
 // 多选推荐 MCP；展示推荐标识 ★、说明与平台兼容性，
 // 已安装项展示为「已安装」且不可重复安装（PRD 6.6 / 优化需求第 4 节）
 async function selectMcps({ mcps, multiSelect, installedIds, writeLine }) {
+  const msg = mk(writeLine);
   const choices = mcps.map((mcp) => ({
     label: `${mcp.recommended ? "★ " : ""}${mcp.label}${installedIds.includes(mcp.id) ? "（已安装）" : ""}`,
     value: mcp.id,
@@ -154,7 +160,7 @@ async function selectMcps({ mcps, multiSelect, installedIds, writeLine }) {
   const fresh = [];
   for (const id of selected) {
     if (installedIds.includes(id)) {
-      writeLine(`已安装，跳过：${id}`);
+      msg.info(`已安装，跳过：${id}`);
       continue;
     }
     fresh.push(mcps.find((mcp) => mcp.id === id));
@@ -164,6 +170,7 @@ async function selectMcps({ mcps, multiSelect, installedIds, writeLine }) {
 
 // 重依赖（Playwright / Serena 等）逐项单独确认
 async function confirmHeavyMcps(mcps, confirm, writeLine) {
+  const msg = mk(writeLine);
   const approved = [];
   for (const mcp of mcps) {
     if (!mcp.heavy) {
@@ -174,7 +181,7 @@ async function confirmHeavyMcps(mcps, confirm, writeLine) {
     if (ok) {
       approved.push(mcp);
     } else {
-      writeLine(`已跳过 ${mcp.id}。`);
+      msg.info(`已跳过 ${mcp.id}。`);
     }
   }
   return approved;
@@ -193,37 +200,38 @@ export async function installRecommendedMcps({
     throw new Error("缺少交互输入");
   }
   const { mcps } = await loadRecommendedMcps(api);
+  const msg = mk(writeLine);
   const installedIds = await readInstalledClaudeMcps({ claudeJsonPath, fs });
   const fresh = await selectMcps({ mcps, multiSelect, installedIds, writeLine });
   if (fresh.length === 0) {
-    writeLine("已跳过 MCP 安装。");
+    msg.info("已跳过 MCP 安装。");
     return [];
   }
   const approved = await confirmHeavyMcps(fresh, confirm, writeLine);
   if (approved.length === 0) {
-    writeLine("已跳过 MCP 安装。");
+    msg.info("已跳过 MCP 安装。");
     return [];
   }
 
-  writeLine([
+  msg.info([
     "即将通过 Claude Code 官方命令安装以下 MCP（修改 ~/.claude.json 用户级配置）：",
     ...approved.map((mcp) => `  claude ${mcp.claudeArgs.join(" ")}`),
   ].join("\n"));
   if (!(await confirm("是否继续？"))) {
-    writeLine("已取消 MCP 安装。");
+    msg.info("已取消 MCP 安装。");
     return [];
   }
 
   const installed = [];
   for (const mcp of approved) {
-    writeLine(`正在安装 MCP：${mcp.label}...`);
+    msg.step(`正在安装 MCP：${mcp.label}...`);
     const result = await execCommand("claude", mcp.claudeArgs);
     if (result.ok) {
       installed.push(mcp.id);
-      writeLine(`✓ 已安装 MCP：${mcp.id}`);
+      msg.success(`已安装 MCP：${mcp.id}`);
     } else {
-      writeLine([
-        `× 安装 ${mcp.id} 失败`,
+      msg.error([
+        `安装 ${mcp.id} 失败`,
         "",
         `原因：${sanitizeText(result.stderr || result.error || "未知错误")}`,
         "",
@@ -279,21 +287,22 @@ export async function installCodexMcps({
   if (typeof multiSelect !== "function" || typeof confirm !== "function") {
     throw new Error("缺少交互输入");
   }
+  const msg = mk(writeLine);
   const configPath = path.join(codexDir, "config.toml");
   const { mcps } = await loadRecommendedMcps(api);
   const installedIds = await readInstalledCodexMcps({ codexDir, fs });
   const fresh = await selectMcps({ mcps, multiSelect, installedIds, writeLine });
   if (fresh.length === 0) {
-    writeLine("已跳过 MCP 安装。");
+    msg.info("已跳过 MCP 安装。");
     return [];
   }
   const approved = await confirmHeavyMcps(fresh, confirm, writeLine);
   if (approved.length === 0) {
-    writeLine("已跳过 MCP 安装。");
+    msg.info("已跳过 MCP 安装。");
     return [];
   }
   if (!(await confirm(`即将在 ${configPath} 中写入 ${approved.map((mcp) => mcp.id).join("、")} 的 MCP 配置（写入前备份）。\n是否继续？`))) {
-    writeLine("已取消 MCP 安装。");
+    msg.info("已取消 MCP 安装。");
     return [];
   }
 
@@ -304,17 +313,17 @@ export async function installCodexMcps({
   content = `${content.trimEnd()}\n`;
   const tomlError = validateBasicToml(content);
   if (tomlError) {
-    writeLine(`× 生成的 Codex 配置 TOML 校验失败：${tomlError}\n已放弃写入，原配置保持不变。`);
+    msg.error(`生成的 Codex 配置 TOML 校验失败：${tomlError}\n已放弃写入，原配置保持不变。`);
     return [];
   }
   const { backupDir } = await createBackup({ baseDir: codexDir, paths: [configPath], fs, now });
   if (backupDir) {
-    writeLine(`✓ 已创建备份：${backupDir}`);
+    msg.success(`已创建备份：${backupDir}`);
   }
   await fs.mkdir(codexDir, { recursive: true });
   await fs.writeFile(configPath, content, "utf8");
   for (const mcp of approved) {
-    writeLine(`✓ 已安装 MCP：${mcp.id}`);
+    msg.success(`已安装 MCP：${mcp.id}`);
   }
   return approved.map((mcp) => mcp.id);
 }
@@ -407,6 +416,7 @@ export async function installRecommendedSkills({
   claudeDir = resolveClaudeUserDir(),
   fs = { readFile, writeFile, mkdir, copyFile },
 } = {}) {
+  const msg = mk(writeLine);
   if (typeof promptSelect !== "function" || typeof confirm !== "function") {
     throw new Error("缺少交互输入");
   }
@@ -434,7 +444,7 @@ export async function installRecommendedSkills({
         `即将更新 ${memoryPath}（以标记区块追加/替换“${skill.label}”，不影响文件其他内容，写入前备份）。\n是否继续？`,
       );
       if (!approved) {
-        writeLine(`已跳过 ${skill.label}。`);
+        msg.info(`已跳过 ${skill.label}。`);
         continue;
       }
       const current = await readFileIfExists(fs.readFile, memoryPath);
@@ -444,7 +454,7 @@ export async function installRecommendedSkills({
       }
       await fs.writeFile(memoryPath, upsertMarkedBlock(current, skill.id, skill.content), "utf8");
       installed.push(skill.id);
-      writeLine(`✓ 已安装：${skill.label}`);
+      msg.success(`已安装：${skill.label}`);
       continue;
     }
 
@@ -460,7 +470,7 @@ export async function installRecommendedSkills({
     await fs.mkdir(commandsDir, { recursive: true });
     await fs.writeFile(filePath, `${skill.content}\n`, "utf8");
     installed.push(skill.id);
-    writeLine(`✓ 已安装：${skill.label}（使用 /claude360:${skill.file.replace(/\.md$/, "")} 调用）`);
+    msg.success(`已安装：${skill.label}（使用 /claude360:${skill.file.replace(/\.md$/, "")} 调用）`);
   }
   return installed;
 }
@@ -489,6 +499,7 @@ export async function installCodexAgents({
   codexDir = resolveCodexUserDir(),
   fs = { readFile, writeFile, mkdir, copyFile },
 } = {}) {
+  const msg = mk(writeLine);
   if (typeof confirm !== "function") {
     throw new Error("缺少确认输入");
   }
@@ -497,7 +508,7 @@ export async function installCodexAgents({
     `即将更新 ${agentsPath}（以标记区块追加/替换 Claude360 协作规范，不影响文件其他内容，写入前备份）。\n是否继续？`,
   );
   if (!approved) {
-    writeLine("已跳过 Codex AGENTS 配置。");
+    msg.info("已跳过 Codex AGENTS 配置。");
     return { installed: false };
   }
   const current = await readFileIfExists(fs.readFile, agentsPath);
@@ -506,7 +517,7 @@ export async function installCodexAgents({
     await fs.copyFile(agentsPath, `${agentsPath}.claude360.bak`);
   }
   await fs.writeFile(agentsPath, upsertMarkedBlock(current, CODEX_AGENTS_BLOCK_ID, CODEX_AGENTS_CONTENT), "utf8");
-  writeLine(`✓ 已更新：${agentsPath}`);
+  msg.success(`已更新：${agentsPath}`);
   return { installed: true, path: agentsPath };
 }
 

package/src/menu.js

@@ -5,16 +5,17 @@
 // 真实终端下由 promptMenu 自动开启彩色分区样式。
 
 import { displayWidth } from "./banner.js";
-import { BOLD, RESET, colorLevel, fg, toLevel } from "./colors.js";
+import { BOLD, RESET, colorLevel, theme, toLevel } from "./colors.js";
 
-// 分区/选择键配色：按色彩深度 level 现算（真彩色保留 RGB，256 色量化到调色板）。
+// 分区/选择键配色：从统一语义主题取色（见 colors.js theme），不再各自硬编码 RGB。
 function palette(level) {
+  const t = theme(level);
   return {
-    rule: fg(71, 85, 105, level),     // 分隔线：青灰
-    section: fg(34, 211, 238, level), // 分区标题：亮青
-    key: fg(125, 211, 252, level),    // 选择键：天蓝
-    exit: fg(248, 113, 113, level),   // 退出键：红
-    desc: fg(100, 116, 139, level),   // 功能说明：暗灰
+    rule: t.border, // 分隔线：青灰
+    section: t.heading, // 分区标题：亮青
+    key: t.info, // 选择键：天蓝
+    exit: t.error, // 退出键：红
+    desc: t.hint, // 功能说明：暗灰
   };
 }
 const MENU_RULE_WIDTH = 46;

package/src/messages.js

@@ -0,0 +1,78 @@
+// 语义消息层：把行内交互文字（成功 / 失败 / 警告 / info / 步骤 / 键值回显 /
+// 路径 / 次要说明 / 标题）统一为「符号前缀 + 专属颜色」，让终端输出有清晰层级，
+// 不再千篇一律。颜色全部取自 colors.js 的统一语义主题 theme()。
+//
+// 设计要点（与既有约定对齐）：
+//  - 符号沿用全 CLI 既有标准：成功 ✓ / 失败 × / 警告 !（与 banner.formatCheckLine、
+//    ui.renderBox、diagnostics 一致），不依赖颜色表达唯一信息（无色档仍有符号）。
+//  - info / path / hint 为中性或次要文本：不加符号，仅靠颜色区分；无色档与原始
+//    未加前缀的行字节一致，保证管道 / 测试零回归。
+//  - formatMessage 为纯函数（镜像 banner.formatCheckLine 的 (text,{color}) 签名），
+//    便于单测；createMessenger 在其上包一层 writeLine，供各页面直接调用。
+
+import { BOLD, RESET, theme, toLevel } from "./colors.js";
+
+// 角色定义：符号前缀 + 主题色名（见 colors.js PALETTE/theme）+ 是否加粗。
+// mark 为空串表示该角色不加符号（中性 / 次要文本，仅靠颜色与文字表达）。
+const ROLES = {
+  success: { mark: "✓", color: "success", bold: false }, // 操作成功
+  error: { mark: "×", color: "error", bold: false }, // 失败 / 异常
+  warn: { mark: "!", color: "warn", bold: false }, // 警告 / 降级
+  step: { mark: "→", color: "step", bold: false }, // 进行中 / 步骤
+  info: { mark: "", color: "info", bold: false }, // 中性信息 / 说明
+  hint: { mark: "", color: "hint", bold: false }, // 次要建议 / 帮助
+  path: { mark: "", color: "path", bold: false }, // 路径 / 命令 / URL 回显
+  title: { mark: "", color: "title", bold: true }, // 页面 / 品牌标题
+  heading: { mark: "", color: "heading", bold: true }, // 章节标题
+  prompt: { mark: "?", color: "info", bold: true }, // 提问标题
+};
+
+// 单行语义消息。未知 kind 回退为 info。无色档（level=0）仅返回「符号 + 文字」，
+// 与改造前的纯文本前缀字节一致。
+export function formatMessage(kind, text, { color = false } = {}) {
+  const role = ROLES[kind] || ROLES.info;
+  const body = String(text ?? "");
+  const prefixed = role.mark ? `${role.mark} ${body}` : body;
+  const level = toLevel(color);
+  if (!level) {
+    return prefixed;
+  }
+  const t = theme(level);
+  return `${role.bold ? BOLD : ""}${t[role.color]}${prefixed}${RESET}`;
+}
+
+// 键值回显：标签弱化（灰蓝）、值强调（白色加粗），形成「次要 → 主要」的视觉落差，
+// 取代过去用 ✓ 表示中性回显的混用。无色档退化为 `标签：值`（与原始回显行一致）。
+export function formatResult(label, value, { color = false } = {}) {
+  const lbl = String(label ?? "");
+  const val = String(value ?? "");
+  const level = toLevel(color);
+  if (!level) {
+    return `${lbl}：${val}`;
+  }
+  const t = theme(level);
+  return `${t.path}${lbl}：${RESET}${BOLD}${t.title}${val}${RESET}`;
+}
+
+// 工厂：绑定 writeLine 与色深，返回各语义方法。
+// color 通常来自 index.js 的 fancyOutput（真实终端为 colorLevel()，测试/管道为 0），
+// 因此测试替换 writeLine 后输出无 ANSI，断言可直接匹配纯文本前缀。
+export function createMessenger({ writeLine = console.log, color = false } = {}) {
+  const emit = (kind) => (text) => writeLine(formatMessage(kind, text, { color }));
+  return {
+    success: emit("success"),
+    error: emit("error"),
+    warn: emit("warn"),
+    info: emit("info"),
+    step: emit("step"),
+    hint: emit("hint"),
+    path: emit("path"),
+    title: emit("title"),
+    heading: emit("heading"),
+    prompt: emit("prompt"),
+    // 键值回显：messenger.result("当前 Key", name)
+    result: (label, value) => writeLine(formatResult(label, value, { color })),
+    // 原样输出：空行、或已自带格式的多行块（renderTable / renderBox / renderHeader 结果）
+    raw: (text = "") => writeLine(text),
+  };
+}

package/src/onboarding.js

@@ -1,5 +1,10 @@
 import { commandVersion, defaultCheckPathWritable, defaultExecCommand } from "./diagnostics.js";
 import { installOrUpdateTools as defaultInstallOrUpdateTools } from "./tool-installer.js";
+import { colorLevel } from "./colors.js";
+import { createMessenger } from "./messages.js";
+
+// 语义消息器工厂：真实终端着色，测试/管道（writeLine 被替换）下无色。
+const mk = (writeLine) => createMessenger({ writeLine, color: writeLine === console.log ? colorLevel() : 0 });
 
 const MIN_NODE_MAJOR = 18;
 
@@ -8,6 +13,7 @@ export async function ensureEnvironment({
   checkPathWritable = defaultCheckPathWritable,
   writeLine = console.log,
 } = {}) {
+  const msg = mk(writeLine);
   const node = await commandVersion(execCommand, "node", ["--version"]);
   if (!node.ok) {
     throw new Error("未检测到 Node.js。Claude360 CLI 需要 Node.js 18+，请先安装 Node.js LTS 后重新运行。");
@@ -26,10 +32,10 @@ export async function ensureEnvironment({
   const globalDir = prefix.ok ? prefix.stdout.trim() : "";
   const globalNpmWritable = globalDir ? await checkPathWritable(globalDir) : false;
   if (!globalNpmWritable) {
-    writeLine("警告：npm 全局目录可能不可写，安装工具时可能需要修复目录权限或切换到用户级 npm prefix。");
+    msg.warn("npm 全局目录可能不可写，安装工具时可能需要修复目录权限或切换到用户级 npm prefix。");
   }
 
-  writeLine(`环境检查通过：Node ${node.version}，npm ${npm.version}。`);
+  msg.success(`环境检查通过：Node ${node.version}，npm ${npm.version}。`);
   return { node: node.version, npm: npm.version, globalNpmWritable };
 }
 
@@ -44,6 +50,7 @@ export async function guideToolInstall({
     throw new Error("缺少工具选择输入");
   }
 
+  const msg = mk(writeLine);
   const claudeInstalled = (await commandVersion(execCommand, "claude", ["--version"])).ok;
   const codexInstalled = (await commandVersion(execCommand, "codex", ["--version"])).ok;
 
@@ -55,7 +62,7 @@ export async function guideToolInstall({
   ]);
 
   if (selected === "skip") {
-    writeLine("已跳过工具安装，可稍后在主菜单选择“安装或更新工具”。");
+    msg.info("已跳过工具安装，可稍后在主菜单选择“安装或更新工具”。");
     return { skipped: true, targets: [] };
   }
 
@@ -63,11 +70,11 @@ export async function guideToolInstall({
   const results = await installOrUpdateTools({ targets, confirm });
   for (const result of results || []) {
     if (result?.skipped) {
-      writeLine(`已跳过 ${result.target} 安装。`);
+      msg.info(`已跳过 ${result.target} 安装。`);
       continue;
     }
     if (result?.ok === false) {
-      writeLine(`安装 ${result.target} 失败：${result.error || ""}${result.remediation ? `\n建议：${result.remediation}` : ""}`);
+      msg.error(`安装 ${result.target} 失败：${result.error || ""}${result.remediation ? `\n建议：${result.remediation}` : ""}`);
     }
   }
   return { skipped: false, targets, results };

package/src/prompts.js

@@ -20,15 +20,16 @@ import {
 
 import { promptMultiSelect } from "./menu.js";
 
-import { BOLD, RESET, colorLevel, fg, toLevel } from "./colors.js";
+import { BOLD, RESET, colorLevel, theme, toLevel } from "./colors.js";
 
-// 交互配色：按色彩深度 level 现算（真彩色保留 RGB，256 色量化到调色板）。
+// 交互配色：从统一语义主题取色（见 colors.js theme），不再各自硬编码 RGB。
 function palette(level) {
+  const t = theme(level);
   return {
-    cyan: fg(34, 211, 238, level),  // 品牌高亮：选中项
-    red: fg(248, 113, 113, level),  // 危险操作：NO 高亮
-    gray: fg(100, 116, 139, level), // 次要说明 / 未选中项
-    green: fg(74, 222, 128, level), // 完成态答案
+    cyan: t.heading, // 品牌高亮：选中项
+    red: t.error, // 危险操作：NO 高亮
+    gray: t.hint, // 次要说明 / 未选中项
+    green: t.success, // 完成态答案
   };
 }