claude360 0.2.2 → 0.2.4

package/src/init-config.js

@@ -0,0 +1,383 @@
+// 初始化配置项（PRD 6.3 / 6.4 / 6.7 / 6.8 / 8.2 / 8.3）：
+// AI 输出语言、系统提示词风格写入 ~/.claude/CLAUDE.md 或 ~/.codex/AGENTS.md
+// 的 Claude360 标记区块（写前备份、不覆盖用户内容、可跳过）；
+// 默认模型与推荐环境变量/权限写入 ~/.claude/settings.json（JSON 合并，不删用户配置）。
+
+import { copyFile, cp, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+import { createBackup } from "./backup.js";
+import { upsertMarkedBlock } from "./mcp-skill.js";
+import { upsertProfileKey, validateBasicToml } from "./tool-launcher.js";
+
+const defaultFs = { copyFile, cp, mkdir, readFile, stat, writeFile };
+
+export function resolveClaudeDir({ homedir = os.homedir } = {}) {
+  return path.join(homedir(), ".claude");
+}
+
+export function resolveCodexDir({ homedir = os.homedir } = {}) {
+  return path.join(homedir(), ".codex");
+}
+
+async function readFileIfExists(fs, filePath) {
+  try {
+    return await fs.readFile(filePath, "utf8");
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      return "";
+    }
+    throw error;
+  }
+}
+
+// 写入 Markdown 标记区块：先备份目标文件到 baseDir/backup/backup_<时间戳>/，
+// 再以 claude360 标记区块幂等更新，不触碰用户已有内容。
+async function writeMarkedBlock({ baseDir, filePath, blockId, content, writeLine, fs, now }) {
+  const current = await readFileIfExists(fs, filePath);
+  const { backupDir } = await createBackup({ baseDir, paths: [filePath], fs, now });
+  if (backupDir) {
+    writeLine(`✓ 已创建备份：${backupDir}`);
+  }
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, upsertMarkedBlock(current, blockId, content), "utf8");
+}
+
+// ──────────────────────────────────────────────
+// AI 输出语言（PRD 6.3 / 8.2）
+// ──────────────────────────────────────────────
+
+export const OUTPUT_LANGUAGES = [
+  {
+    id: "zh-CN",
+    label: "简体中文   推荐中文用户",
+    content: [
+      "# Claude360 用户偏好",
+      "",
+      "请默认使用简体中文回复用户。",
+      "除非用户明确要求其他语言，否则保持中文输出。",
+    ].join("\n"),
+  },
+  {
+    id: "en",
+    label: "English",
+    content: [
+      "# Claude360 User Preference",
+      "",
+      "Reply to the user in English by default.",
+      "Keep English output unless the user explicitly requests another language.",
+    ].join("\n"),
+  },
+];
+
+export const OUTPUT_LANGUAGE_BLOCK_ID = "output-language";
+
+export async function configureOutputLanguage({
+  baseDir,
+  filePath,
+  promptSelect,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  if (typeof promptSelect !== "function") {
+    throw new Error("缺少选择输入");
+  }
+  const selected = await promptSelect("请选择 AI 输出语言：", [
+    ...OUTPUT_LANGUAGES.map((language) => ({ label: language.label, value: language.id })),
+    { label: "跳过", value: "skip" },
+  ]);
+  if (selected === "skip") {
+    writeLine("已跳过 AI 输出语言配置。");
+    return { skipped: true };
+  }
+  const language = OUTPUT_LANGUAGES.find((item) => item.id === selected);
+  await writeMarkedBlock({
+    baseDir,
+    filePath,
+    blockId: OUTPUT_LANGUAGE_BLOCK_ID,
+    content: language.content,
+    writeLine,
+    fs,
+    now,
+  });
+  writeLine(`✓ AI 输出语言已写入：${filePath}`);
+  return { skipped: false, language: language.id };
+}
+
+// ──────────────────────────────────────────────
+// 系统提示词风格（PRD 6.4 / 8.3）：少而精，保持专业克制
+// ──────────────────────────────────────────────
+
+export const PROMPT_STYLES = [
+  {
+    id: "engineer",
+    label: "工程师专业版   推荐",
+    desc: "适合代码开发、重构、调试、架构分析，强调清晰、准确、可执行。",
+    content: [
+      "# Claude360 系统提示词风格：工程师专业版",
+      "",
+      "- 以高级软件工程师的标准回答：清晰、准确、可执行。",
+      "- 修改代码前先理解现有实现与约定，保持最小改动面。",
+      "- 给出方案时说明取舍与影响范围，重要结论给出依据。",
+      "- 不确定时明确说明假设，不编造 API 或行为。",
+    ].join("\n"),
+  },
+  {
+    id: "product",
+    label: "产品分析助手",
+    desc: "适合 PRD、需求拆解、用户故事、功能规划和产品设计。",
+    content: [
+      "# Claude360 系统提示词风格：产品分析助手",
+      "",
+      "- 以产品视角分析需求：目标用户、场景、价值与边界。",
+      "- 输出结构化结论：需求要点、功能拆解、优先级与风险。",
+      "- 区分「做什么」与「不做什么」，避免范围蔓延。",
+    ].join("\n"),
+  },
+  {
+    id: "concise",
+    label: "简洁高效模式",
+    desc: "减少解释，优先给出结论和操作步骤。",
+    content: [
+      "# Claude360 系统提示词风格：简洁高效模式",
+      "",
+      "- 优先给出结论和操作步骤，减少铺垫与解释。",
+      "- 能用列表与代码块表达的不用长段落。",
+      "- 仅在用户追问时展开背景与原理。",
+    ].join("\n"),
+  },
+];
+
+export const PROMPT_STYLE_BLOCK_ID = "prompt-style";
+
+export async function configurePromptStyle({
+  baseDir,
+  filePath,
+  promptSelect,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  if (typeof promptSelect !== "function") {
+    throw new Error("缺少选择输入");
+  }
+  for (const style of PROMPT_STYLES) {
+    writeLine(`${style.label.trim()}：${style.desc}`);
+  }
+  writeLine("");
+  const selected = await promptSelect("请选择系统提示词风格：", [
+    ...PROMPT_STYLES.map((style) => ({ label: style.label, value: style.id })),
+    { label: "跳过", value: "skip" },
+  ]);
+  if (selected === "skip") {
+    writeLine("已跳过系统提示词风格配置。");
+    return { skipped: true };
+  }
+  const style = PROMPT_STYLES.find((item) => item.id === selected);
+  await writeMarkedBlock({
+    baseDir,
+    filePath,
+    blockId: PROMPT_STYLE_BLOCK_ID,
+    content: style.content,
+    writeLine,
+    fs,
+    now,
+  });
+  writeLine(`✓ 系统提示词风格已写入：${filePath}`);
+  return { skipped: false, style: style.id };
+}
+
+// ──────────────────────────────────────────────
+// Claude Code 默认模型（PRD 6.7）：模型名以后端返回为准，
+// 后端未提供时回退到 Claude Code 官方别名（sonnet/opus/haiku），
+// CLI 不硬编码具体模型 ID、倍率与计费规则。
+// ──────────────────────────────────────────────
+
+export const DEFAULT_MODEL_TIERS = [
+  { id: "recommended", label: "推荐模型   适合大多数代码任务", model: "sonnet" },
+  { id: "performance", label: "高性能模型 适合复杂架构和长上下文任务", model: "opus" },
+  { id: "economy", label: "经济模型   适合日常轻量任务", model: "haiku" },
+];
+
+// 后端可选接口 GET /api/cli/models：{ tiers: [{ id, label, model }] }；
+// 不可用时回退内置映射。
+export async function loadModelTiers(api) {
+  if (api && typeof api.get === "function") {
+    try {
+      const data = await api.get("/api/cli/models");
+      const tiers = Array.isArray(data?.tiers) ? data.tiers : [];
+      if (tiers.length > 0 && tiers.every((tier) => tier.id && tier.label && tier.model)) {
+        return { tiers, source: "backend" };
+      }
+    } catch {
+      // 后端暂未提供模型列表接口，使用内置映射
+    }
+  }
+  return { tiers: DEFAULT_MODEL_TIERS, source: "builtin" };
+}
+
+async function readJsonIfExists(fs, filePath) {
+  const content = await readFileIfExists(fs, filePath);
+  if (content.trim() === "") {
+    return {};
+  }
+  try {
+    return JSON.parse(content);
+  } catch {
+    throw new Error(`${filePath} 不是合法 JSON，已停止写入以保护现有配置。`);
+  }
+}
+
+async function writeJsonWithBackup({ baseDir, filePath, json, writeLine, fs, now }) {
+  const { backupDir } = await createBackup({ baseDir, paths: [filePath], fs, now });
+  if (backupDir) {
+    writeLine(`✓ 已创建备份：${backupDir}`);
+  }
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, `${JSON.stringify(json, null, 2)}\n`, "utf8");
+}
+
+export async function configureClaudeDefaultModel({
+  api,
+  claudeDir = resolveClaudeDir(),
+  promptSelect,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  if (typeof promptSelect !== "function") {
+    throw new Error("缺少选择输入");
+  }
+  const { tiers } = await loadModelTiers(api);
+  const selected = await promptSelect("请选择默认模型：", [
+    ...tiers.map((tier) => ({ label: tier.label, value: tier.id })),
+    { label: "跳过", value: "skip" },
+  ]);
+  if (selected === "skip") {
+    writeLine("已跳过默认模型配置。");
+    return { skipped: true };
+  }
+  const tier = tiers.find((item) => item.id === selected);
+  const settingsPath = path.join(claudeDir, "settings.json");
+  const settings = await readJsonIfExists(fs, settingsPath);
+  settings.model = tier.model;
+  await writeJsonWithBackup({ baseDir: claudeDir, filePath: settingsPath, json: settings, writeLine, fs, now });
+  writeLine(`✓ 默认模型已设置为 ${tier.model}（${settingsPath}）`);
+  return { skipped: false, model: tier.model };
+}
+
+// ──────────────────────────────────────────────
+// 推荐环境变量与权限（PRD 6.8）：仅写 ~/.claude/settings.json，
+// 不修改 shell profile、不写系统全局环境变量；权限放宽需用户确认。
+// ──────────────────────────────────────────────
+
+export const RECOMMENDED_CLAUDE_SETTINGS = {
+  env: {
+    // 隐私保护：关闭非必要遥测与错误上报流量
+    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1",
+  },
+  permissions: {
+    allow: [
+      // 常用只读与构建类命令，避免高频确认打断
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(grep:*)",
+      "Bash(rg:*)",
+      "Bash(find:*)",
+      "Bash(git status)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(node --version)",
+      "Bash(npm --version)",
+    ],
+  },
+};
+
+export async function importClaudeEnvPermissions({
+  claudeDir = resolveClaudeDir(),
+  confirm,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+  recommended = RECOMMENDED_CLAUDE_SETTINGS,
+} = {}) {
+  if (typeof confirm !== "function") {
+    throw new Error("缺少确认输入");
+  }
+  const settingsPath = path.join(claudeDir, "settings.json");
+  writeLine([
+    "导入推荐环境变量和权限配置",
+    "",
+    "该操作将为 Claude Code 写入推荐配置：",
+    "- 隐私保护（关闭非必要遥测流量）",
+    "- 权限允许列表（常用只读 / git / 版本查询命令免确认）",
+    "",
+    `写入位置：${settingsPath}（不修改 shell profile，不写系统全局环境变量）`,
+    "注意：权限允许列表会放宽上述命令的执行确认。",
+  ].join("\n"));
+  const approved = await confirm("是否继续？");
+  if (!approved) {
+    writeLine("已跳过推荐环境变量和权限配置。");
+    return { skipped: true };
+  }
+  const settings = await readJsonIfExists(fs, settingsPath);
+  // 合并而非覆盖：用户已有的 env 值与权限条目全部保留
+  settings.env = { ...recommended.env, ...(settings.env || {}) };
+  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}`);
+  return { skipped: false, path: settingsPath };
+}
+
+// ──────────────────────────────────────────────
+// Codex 默认模型（PRD 7.1 第 5 项）：模型名必须来自后端；
+// 后端未提供模型列表时不写入，提示在 Codex 内用 /model 选择
+// （Claude Code 的内置别名不适用于 Codex）。
+// ──────────────────────────────────────────────
+
+export async function configureCodexDefaultModel({
+  api,
+  codexDir = resolveCodexDir(),
+  promptSelect,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  if (typeof promptSelect !== "function") {
+    throw new Error("缺少选择输入");
+  }
+  const { tiers, source } = await loadModelTiers(api);
+  if (source !== "backend") {
+    writeLine("Claude360 后端暂未提供 Codex 模型列表，已跳过默认模型写入。");
+    writeLine("可在启动 Codex 后使用 /model 命令选择模型。");
+    return { skipped: true };
+  }
+  const selected = await promptSelect("请选择默认模型：", [
+    ...tiers.map((tier) => ({ label: tier.label, value: tier.id })),
+    { label: "跳过", value: "skip" },
+  ]);
+  if (selected === "skip") {
+    writeLine("已跳过默认模型配置。");
+    return { skipped: true };
+  }
+  const tier = tiers.find((item) => item.id === selected);
+  const configPath = path.join(codexDir, "config.toml");
+  const current = await readFileIfExists(fs, configPath);
+  const next = `${upsertProfileKey(current, "claude360", "model", tier.model).trimEnd()}\n`;
+  const tomlError = validateBasicToml(next);
+  if (tomlError) {
+    writeLine(`× 生成的 Codex 配置 TOML 校验失败：${tomlError}\n已放弃写入，原配置保持不变。`);
+    return { skipped: true };
+  }
+  const { backupDir } = await createBackup({ baseDir: codexDir, paths: [configPath], fs, now });
+  if (backupDir) {
+    writeLine(`✓ 已创建备份：${backupDir}`);
+  }
+  await fs.mkdir(codexDir, { recursive: true });
+  await fs.writeFile(configPath, next, "utf8");
+  writeLine(`✓ Codex 默认模型已设置为 ${tier.model}（${configPath}）`);
+  return { skipped: false, model: tier.model };
+}

package/src/init-flow.js

@@ -0,0 +1,70 @@
+// 完整初始化编排（PRD 5.2 / 7.2）：按步骤推进，必需步骤（声明、登录、Key）
+// 失败或用户返回时中止；增强步骤（工作流、MCP、模型、权限等）失败或跳过
+// 不阻塞主流程（AC-05）。各步骤动作由 index.js 注入，本模块只负责编排与输出。
+
+import { safeErrorMessage } from "./sanitize.js";
+
+export async function runFullInit({ title, steps, writeLine = console.log } = {}) {
+  writeLine(`${title}\n`);
+  let index = 0;
+  for (const step of steps) {
+    index += 1;
+    writeLine(`第 ${index} 步：${step.title}`);
+    try {
+      const result = await step.run();
+      if (step.required && result === false) {
+        writeLine(`已在「${step.title}」中止初始化。`);
+        return { completed: false, abortedAt: step.title };
+      }
+    } catch (error) {
+      if (step.required) {
+        writeLine(`× ${step.title}失败：${safeErrorMessage(error)}`);
+        writeLine("初始化已中止，可稍后在菜单中重试。");
+        return { completed: false, abortedAt: step.title };
+      }
+      writeLine(`! ${step.title}失败（已跳过，不影响后续步骤）：${safeErrorMessage(error)}`);
+    }
+    writeLine("");
+  }
+  return { completed: true };
+}
+
+// Claude Code 完整初始化步骤（PRD 5.2）
+export function buildClaudeInitSteps(deps) {
+  return [
+    { title: "展示开源参考声明", required: true, run: deps.showNotice },
+    { title: "检查 Claude360 登录状态", required: true, run: deps.ensureLogin },
+    { title: "展示余额与今日用量", run: deps.showBalance },
+    { title: "选择或创建 Claude360 API Key", required: true, run: deps.ensureApiKey },
+    { title: "检查 / 安装 / 更新 Claude Code", run: deps.installTool },
+    { title: "配置 Claude360 API 注入", required: true, run: deps.configureApi },
+    { title: "选择 AI 输出语言", run: deps.configureLanguage },
+    { title: "选择系统提示词风格", run: deps.configureStyle },
+    { title: "导入推荐工作流", run: deps.installWorkflows },
+    { title: "配置推荐 MCP 服务", run: deps.installMcps },
+    { title: "配置默认模型", run: deps.configureModel },
+    { title: "导入推荐权限与环境变量配置", run: deps.importEnvPermissions },
+    { title: "测试连接", run: deps.testConnection },
+    { title: "询问是否立即启动 Claude Code", run: deps.askLaunch },
+  ];
+}
+
+// Codex 完整初始化步骤（PRD 7.2）
+export function buildCodexInitSteps(deps) {
+  return [
+    { title: "展示开源参考声明", required: true, run: deps.showNotice },
+    { title: "检查 Claude360 登录状态", required: true, run: deps.ensureLogin },
+    { title: "展示余额与今日用量", run: deps.showBalance },
+    { title: "选择或创建 Claude360 API Key", required: true, run: deps.ensureApiKey },
+    { title: "检查 / 安装 / 更新 Codex", run: deps.installTool },
+    { title: "选择 AI 输出语言", run: deps.configureLanguage },
+    { title: "选择系统提示词风格", run: deps.configureStyle },
+    { title: "导入推荐 AGENTS 配置", run: deps.installAgents },
+    { title: "导入推荐 prompts / workflow", run: deps.installWorkflows },
+    { title: "配置 Claude360 Provider", required: true, run: deps.configureProvider },
+    { title: "检测 Codex 协议兼容性", required: true, run: deps.checkCompat },
+    { title: "配置推荐 MCP 服务", run: deps.installMcps },
+    { title: "测试连接", run: deps.testConnection },
+    { title: "询问是否立即启动 Codex", run: deps.askLaunch },
+  ];
+}