claude360 0.2.8 → 0.3.0

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 };
 }
 
@@ -204,6 +212,25 @@ export const FALLBACK_CLAUDE_ALIASES = [
   { id: "haiku", display_name: "Haiku（官方别名）", tags: ["经济"], description: "适合日常轻量任务" },
 ];
 
+// 模型按工具归属过滤：Claude Code 仅展示 Claude 系模型，Codex 仅展示非 Claude
+// （gpt 等）模型。后端 /api/cli/models?tool= 暂未按 tool 过滤，故在客户端按模型
+// id 兜底过滤，避免切换 Claude 模型时混入 gpt、切换 Codex 模型时混入 claude。
+export function isClaudeModel(id) {
+  const s = String(id || "").toLowerCase();
+  return s.startsWith("claude") || s === "sonnet" || s === "opus" || s === "haiku";
+}
+
+export function filterModelsForTool(models, tool) {
+  const list = Array.isArray(models) ? models : [];
+  if (tool === "claude_code") {
+    return list.filter((model) => isClaudeModel(model.id));
+  }
+  if (tool === "codex") {
+    return list.filter((model) => !isClaudeModel(model.id));
+  }
+  return list;
+}
+
 // 后端接口 GET /api/cli/models?tool=<claude_code|codex>：
 // { models: [{ id, display_name, description, tags, recommended }] }
 // （后端暂无上下文长度数据源，契约中不含 context_length）
@@ -214,8 +241,9 @@ export async function loadAvailableModels(api, tool = "") {
       const data = await api.get(`/api/cli/models${query}`);
       const models = (Array.isArray(data?.models) ? data.models : [])
         .filter((model) => model && typeof model.id === "string" && model.id !== "");
-      if (models.length > 0) {
-        return { models, source: "backend" };
+      const scoped = filterModelsForTool(models, tool);
+      if (scoped.length > 0) {
+        return { models: scoped, source: "backend" };
       }
     } catch {
       // 后端暂未提供模型列表接口或网络失败，由调用方决定回退策略
@@ -252,9 +280,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 +300,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 +358,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 +372,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 +381,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 +402,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,29 +3,48 @@
 // 不阻塞主流程（AC-05）。各步骤动作由 index.js 注入，本模块只负责编排与输出。
 
 import { safeErrorMessage } from "./sanitize.js";
+import { colorLevel } from "./colors.js";
+import { createMessenger } from "./messages.js";
+import { renderDivider, renderStructuredError, renderTaskEnd, renderTaskStart, renderTaskStep } from "./ui.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);
+  writeLine(renderTaskStart(title, {
+    intro: steps.map((step) => step.title),
+  }));
+  writeLine("");
   let index = 0;
+  const total = steps.length;
   for (const step of steps) {
     index += 1;
-    writeLine(`第 ${index} 步：${step.title}`);
+    if (index > 1) {
+      writeLine(renderDivider("section"));
+      writeLine("");
+    }
+    writeLine(renderTaskStep(index, total, 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("初始化已中止，可稍后在菜单中重试。");
+        writeLine(renderStructuredError(`${step.title}失败`, {
+          reason: safeErrorMessage(error),
+          suggestions: ["初始化已中止，可稍后在菜单中重试。"],
+          detailCommand: "claude360 doctor --verbose",
+        }));
         return { completed: false, abortedAt: step.title };
       }
-      writeLine(`! ${step.title}失败（已跳过，不影响后续步骤）：${safeErrorMessage(error)}`);
+      msg.warn(`${step.title}失败（已跳过，不影响后续步骤）：${safeErrorMessage(error)}`);
     }
     writeLine("");
   }
+  writeLine(renderTaskEnd(`${title}完成`));
   return { completed: true };
 }
 

package/src/mcp-skill.js

@@ -9,6 +9,12 @@ 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";
+import { renderChoiceTable } from "./ui.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 +144,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,16 +161,32 @@ 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));
   }
+  if (fresh.length > 0 && typeof writeLine === "function") {
+    writeLine(`✅ 已选择 ${fresh.length} 个 MCP 服务`);
+    writeLine(renderChoiceTable({
+      columns: [
+        ["index", "序号"],
+        ["service", "服务"],
+        ["description", "说明"],
+      ],
+      rows: fresh.map((mcp, index) => ({
+        index: String(index + 1),
+        service: mcp.id,
+        description: mcp.desc || "-",
+      })),
+    }, { width: process.stdout.columns || 0 }));
+  }
   return fresh;
 }
 
 // 重依赖（Playwright / Serena 等）逐项单独确认
 async function confirmHeavyMcps(mcps, confirm, writeLine) {
+  const msg = mk(writeLine);
   const approved = [];
   for (const mcp of mcps) {
     if (!mcp.heavy) {
@@ -174,7 +197,7 @@ async function confirmHeavyMcps(mcps, confirm, writeLine) {
     if (ok) {
       approved.push(mcp);
     } else {
-      writeLine(`已跳过 ${mcp.id}。`);
+      msg.info(`已跳过 ${mcp.id}。`);
     }
   }
   return approved;
@@ -193,37 +216,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 +303,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 +329,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 +432,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 +460,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 +470,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 +486,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 +515,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 +524,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 +533,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,19 +5,21 @@
 // 真实终端下由 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;
+const SECTION_DIVIDER = "----------------------------------------";
 
 export function buildFirstRunMenu() {
   return {
@@ -176,13 +178,18 @@ export async function promptMenu({ menu, promptInput, select, writeLine = consol
 // 多选交互（补充需求 6.5 / 6.6 / 8.4）：数字切换勾选，A 全选，I 反选，
 // 回车确认。返回选中的 value 数组；用户清空全部选项后回车即视为跳过。
 export function renderMultiSelect({ message, choices, selected }) {
-  const lines = [message, ""];
-  choices.forEach((choice, index) => {
-    const mark = selected.has(choice.value) ? "[x]" : "[ ]";
-    const hint = choice.hint ? `   ${choice.hint}` : "";
-    lines.push(`  ${index + 1}. ${mark} ${choice.label}${hint}`);
+  const count = choices.filter((choice) => selected.has(choice.value)).length;
+  const lines = [`⚙️ ${message}`, "", `已选择：${count} 个`, ""];
+  // hint 列按 label 最大显示宽度对齐（需求示例 4），不再用固定空格
+  const labelWidth = choices.reduce((max, choice) => Math.max(max, displayWidth(choice.label)), 0);
+  choices.forEach((choice) => {
+    const mark = selected.has(choice.value) ? "●" : "○";
+    const hint = choice.hint
+      ? `${" ".repeat(Math.max(2, labelWidth - displayWidth(choice.label) + 2))}${choice.hint}`
+      : "";
+    lines.push(`${mark} ${choice.label}${hint}`);
   });
-  lines.push("", "  A. 全选   I. 反选   Enter. 确认");
+  lines.push("", SECTION_DIVIDER, "", "操作：", "输入编号切换   A 全选   I 反选   Enter 确认");
   return lines.join("\n");
 }
 

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),
+  };
+}