claude360 0.2.2 → 0.2.4

package/README.md

@@ -21,6 +21,7 @@
 - [项目结构](#项目结构)
 - [安全模型](#安全模型)
 - [已知风险与路线图](#已知风险与路线图)
+- [致谢](#致谢)
 - [许可证](#许可证)
 
 ## 功能特性
@@ -35,7 +36,12 @@
 | 启动 Claude Code | 自动注入 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN`，以子进程启动 |
 | 启动 Codex | 写入隔离的 `[model_providers.claude360]` / `[profiles.claude360]` 配置，并以 `codex --profile claude360` 启动 |
 | 工具更新 | 菜单内更新 `claude360` 自身、Claude Code、Codex，全部需要二次确认 |
-| 诊断报告 | OS/Node/npm/全局 npm 权限/工具版本/连通性/授权状态/余额/Key/支付端点一站式检查 |
+| 一键完整初始化 | Claude Code / Codex 完整初始化向导：登录、Key、安装/更新、API 注入、输出语言、提示词风格、工作流、MCP、模型、权限配置、连接测试、启动 |
+| 推荐工作流 / Skill | 六步工作流、Git 指令、功能规划 UX、BMad 安装器等，写入 `~/.claude/commands/claude360/` 与 `~/.codex/prompts/`，写前备份、冲突二次确认 |
+| 推荐 MCP | Context7 / Open Web Search / Spec 工作流 / DeepWiki / Playwright / Exa / Serena，多选安装、重依赖单独确认、同名去重 |
+| AI 输出语言 / 提示词风格 | 写入 `~/.claude/CLAUDE.md` 或 `~/.codex/AGENTS.md` 的 Claude360 标记区块，不覆盖用户内容 |
+| 配置备份 | 所有写入用户工具配置的操作先备份到 `~/.claude/backup/` 或 `~/.codex/backup/` 时间戳目录 |
+| 诊断报告 | OS/Node/npm/全局 npm 权限/工具版本/连通性/授权状态/余额/Key/支付端点一站式检查，按模块分组表格展示 |
 
 ## 系统要求
 
@@ -353,6 +359,15 @@ web/src/pages/CliAuthorize/    # 浏览器授权页
 
 完整需求边界见 `prd/claude360-cli-prd.md`。
 
+## 致谢
+
+本 CLI 的交互式初始化流程、工作流导入、MCP 推荐配置等设计，借鉴并参考了开源项目
+[NPX ZCF](https://github.com/UfoMiao/zcf) 的部分功能体验，感谢作者 UfoMiao 的开源贡献。
+
+- 相关功能入口（完整初始化、推荐工作流 / MCP / Skill / AGENTS）会在终端展示开源参考声明。
+- 随 CLI 安装的推荐工作流文件均为 Claude360 自研改编内容，文件头保留对 NPX ZCF 的 attribution 注释。
+- 如后续直接引入 ZCF 的源码、配置文件或文档片段，需先核查其开源许可证并在此处补充对应声明。
+
 ## 许可证
 
 随仓库根目录 `LICENSE` 发布，未单独声明。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude360",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Interactive Claude360 CLI for browser auth, API key setup, balance checks, top-up, Claude Code and Codex launch.",
   "type": "module",
   "bin": {

package/src/account-status.js

@@ -1,20 +1,30 @@
-// 账户状态区：日常菜单顶部显著展示账号 / 余额 / 今日用量 / 当前 Key /
-// Claude Code / Codex 配置状态。业务口径（余额、低余额阈值、今日用量格式）
-// 全部以后端 /api/cli/me 返回为准，CLI 仅做兜底格式化。
+// 账户状态区（补充需求第 1 节）：日常菜单顶部用横向表格展示
+// 账号 / 余额 / 已用额度 / 当前 Key / 分组 / 倍率 / 状态，
+// 今日用量与工具配置状态以紧凑状态行展示。业务口径（余额、已用额度、
+// 低余额阈值、今日用量格式、分组倍率）全部以后端返回为准，CLI 仅做兜底格式化；
+// 终端过窄时自动降级为双列紧凑表。
 
+import { loadGroups } from "./group-manager.js";
 import { sanitizeError } from "./sanitize.js";
+import { renderStatusTable } from "./ui.js";
 
 export async function loadAccountStatus({ api, config = {} } = {}) {
   let me = null;
   let error = null;
+  let groups = [];
   if (api && config.cliToken) {
     try {
       me = await api.get("/api/cli/me");
     } catch (err) {
       error = err;
     }
+    try {
+      groups = await loadGroups(api);
+    } catch {
+      groups = []; // 倍率获取失败不影响状态区其余信息
+    }
   }
-  return { me, error, config };
+  return { me, error, config, groups };
 }
 
 // 兜底格式化：今日 token 用量，million 口径，如 128.6k/m、1.25m/m
@@ -50,48 +60,55 @@ export function maskAccount(account) {
   return `${text.slice(0, 2)}***${text.slice(-2)}`;
 }
 
-export function formatAccountStatus({ me, error, config = {} } = {}) {
-  const lines = ["Claude360 账户状态", ""];
+// 分组倍率：以后端 /api/cli/groups 返回为准；auto 等 ratio 为 null 的分组不展示倍率
+export function formatGroupRatio(groups, groupName) {
+  if (!groupName) {
+    return "-";
+  }
+  const group = (groups || []).find((item) => item?.name === groupName);
+  const ratio = group?.ratio == null ? NaN : Number(group.ratio);
+  if (!Number.isFinite(ratio)) {
+    return "-";
+  }
+  return `${Number.isInteger(ratio) ? ratio.toFixed(1) : String(ratio)}x`;
+}
+
+const STATUS_HEAD = ["账号", "余额", "已用额度", "当前 Key", "分组", "倍率", "状态"];
+
+export function formatAccountStatus({ me, error, config = {}, groups = [], width = 0 } = {}) {
   const configured = config.configuredTools || {};
-  const claudeCodeState = configured.claudeCode ? "已配置" : "未配置";
-  const codexState = configured.codex ? "已配置" : "未配置";
+  const toolLine = `Claude Code：${configured.claudeCode ? "已配置" : "未配置"}    Codex：${configured.codex ? "已配置" : "未配置"}`;
+  const tokenName = config.tokenName || "-";
+  const group = config.group || me?.group || "-";
 
-  if (!config.cliToken) {
-    lines.push(
-      "账号：未登录",
-      "余额：-",
-      "今日用量：-",
-      "当前 Key：-",
-      `Claude Code：${claudeCodeState}`,
-      `Codex：${codexState}`,
-    );
-    return lines.join("\n");
-  }
+  let row;
+  let extraLines = [toolLine];
 
-  if (!me) {
-    lines.push(
-      `账号：${maskAccount(config.account)}（状态获取失败${sanitizeError(error) ? `：${sanitizeError(error)}` : ""}）`,
-      "余额：-",
-      "今日用量：-",
-      `当前 Key：${config.tokenName || "-"}`,
-      `Claude Code：${claudeCodeState}`,
-      `Codex：${codexState}`,
-    );
-    return lines.join("\n");
+  if (!config.cliToken) {
+    row = ["未登录", "-", "-", tokenName, "-", "-", "未登录"];
+  } else if (!me) {
+    const reason = sanitizeError(error);
+    row = [maskAccount(config.account), "-", "-", tokenName, group, formatGroupRatio(groups, group), "获取失败"];
+    extraLines = [`! 状态获取失败${reason ? `：${reason}` : ""}`, toolLine];
+  } else {
+    const account = me.email || me.display_name || me.username;
+    const balance = me.balance_display ?? String(me.quota ?? "-");
+    const usage = me.today_usage_display || formatTokensPerMillion(me.today_tokens);
+    row = [
+      maskAccount(account),
+      balance,
+      me.used_display ?? "-",
+      tokenName,
+      group,
+      formatGroupRatio(groups, group),
+      me.low_balance ? "余额较低" : "正常",
+    ];
+    extraLines = [`今日用量：${usage}${me.low_balance ? "    ! 余额较低，建议充值" : ""}`, toolLine];
   }
 
-  const account = me.email || me.display_name || me.username;
-  const balance = me.balance_display ?? String(me.quota ?? "-");
-  const lowBalanceTag = me.low_balance ? "  ! 余额较低" : "";
-  const usage = me.today_usage_display || formatTokensPerMillion(me.today_tokens);
-
-  lines.push(
-    `账号：${maskAccount(account)}`,
-    `余额：${balance}${lowBalanceTag}`,
-    `今日用量：${usage}`,
-    `当前 Key：${config.tokenName || "-"}`,
-    `Claude Code：${claudeCodeState}`,
-    `Codex：${codexState}`,
-  );
-  return lines.join("\n");
+  return [
+    "Claude360 账户状态",
+    renderStatusTable({ head: STATUS_HEAD, row }, { width }),
+    ...extraLines,
+  ].join("\n");
 }

package/src/backup.js

@@ -0,0 +1,54 @@
+// 配置备份（PRD 第 11 章）：所有写入用户工具配置的操作先备份到
+// <工具目录>/backup/backup_YYYY-MM-DD_HH-mm-ss/，支持文件与目录（递归）。
+// 不存在的路径自动跳过，全部不存在时不创建备份目录。
+
+import { cp, mkdir, stat } from "node:fs/promises";
+import path from "node:path";
+
+export function formatBackupStamp(date = new Date()) {
+  const pad = (value) => String(value).padStart(2, "0");
+  return [
+    `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,
+    `${pad(date.getHours())}-${pad(date.getMinutes())}-${pad(date.getSeconds())}`,
+  ].join("_");
+}
+
+export function resolveBackupDir(baseDir, date = new Date()) {
+  return path.join(baseDir, "backup", `backup_${formatBackupStamp(date)}`);
+}
+
+// 备份 paths（绝对路径，文件或目录）到 baseDir/backup/backup_<时间戳>/，
+// 返回 { backupDir, copied }；copied 为成功备份的源路径列表。
+export async function createBackup({
+  baseDir,
+  paths = [],
+  now = () => new Date(),
+  fs = { cp, mkdir, stat },
+} = {}) {
+  if (!baseDir) {
+    throw new Error("缺少备份基础目录");
+  }
+  const existing = [];
+  for (const source of paths) {
+    try {
+      const info = await fs.stat(source);
+      existing.push({ source, isDirectory: info.isDirectory() });
+    } catch (error) {
+      if (error?.code !== "ENOENT") {
+        throw error;
+      }
+    }
+  }
+  if (existing.length === 0) {
+    return { backupDir: null, copied: [] };
+  }
+  const backupDir = resolveBackupDir(baseDir, now());
+  await fs.mkdir(backupDir, { recursive: true });
+  const copied = [];
+  for (const { source, isDirectory } of existing) {
+    const target = path.join(backupDir, path.basename(source));
+    await fs.cp(source, target, { recursive: isDirectory });
+    copied.push(source);
+  }
+  return { backupDir, copied };
+}

package/src/diagnostics.js

@@ -5,6 +5,7 @@ import os from "node:os";
 
 import { resolveCodexConfigPath } from "./tool-launcher.js";
 import { sanitizeError, sanitizeText } from "./sanitize.js";
+import { renderSectionTitle, renderTable } from "./ui.js";
 
 export async function runDiagnostics({
   config = {},
@@ -135,47 +136,74 @@ function buildCodexCompatStatus({ codexCompat }) {
   return { ok: true, detail: `已支持（wire_api=${codexCompat.data?.wire_api || "responses"}）` };
 }
 
-export function formatDiagnosticsSummary(report) {
-  const lines = [];
-  lines.push("系统环境");
-  lines.push(check({ ok: true, detail: `${report.platform.os} ${report.platform.arch}` }, "OS"));
-  lines.push(checkFix(report.runtime.node, "Node.js", "安装 Node.js 18+ 后重新运行 claude360", "version"));
-  lines.push(checkFix(report.runtime.npm, "npm", "安装 npm 或修复 Node.js 安装", "version"));
-  lines.push(checkFix(report.runtime.globalNpmPermission, "全局 npm 权限", "修复 npm 全局目录权限，或切换到用户级 npm prefix"));
-  lines.push(checkFix(report.platform.terminalQr, "终端二维码", "终端不支持时可复制支付链接完成支付"));
-  lines.push("");
-  lines.push("Claude360");
-  lines.push(checkFix(report.api.connectivity, "服务连接", "检查网络连接和 Claude360 站点可用性"));
-  lines.push(checkFix(report.auth, "登录状态", "在菜单中选择“重新登录”完成浏览器授权"));
-  lines.push(checkFix(report.balance, "当前余额", "通过“余额与充值”菜单充值"));
-  lines.push(checkFix(report.usage, "今日用量", "登录后可查看今日 Token 用量"));
-  lines.push(checkFix(report.token, "当前 Key", "在菜单中切换或创建 API Key"));
-  lines.push(checkFix(report.topUp, "微信充值", "检查后端微信支付配置或使用网页充值"));
-  lines.push("");
-  lines.push("Claude Code");
-  lines.push(checkFix(report.tools.claudeCode, "安装状态", "通过菜单安装或更新 Claude Code", "version"));
-  lines.push(checkFix(report.claudeCodeConfig, "Claude360 配置", "在“Claude Code 配置”菜单中修复"));
-  lines.push("");
-  lines.push("Codex");
-  lines.push(checkFix(report.tools.codex, "安装状态", "通过菜单安装或更新 Codex", "version"));
-  lines.push(checkFix(report.codexConfig, "claude360 provider", "在“Codex 配置”菜单中写入/修复"));
-  lines.push(checkFix(report.codexCompat, "协议兼容性", "Codex 暂不可用时可先使用 Claude Code"));
+// 诊断报告（补充需求第 5 节）：按模块分组的小表格展示，
+// 状态用文字标签（通过/警告/失败）明确区分，失败项附修复建议，
+// 输出适合直接复制给客服或开发排查（出口统一脱敏）。
+export function formatDiagnosticsSummary(report, { width = 0 } = {}) {
+  const groups = [
+    {
+      title: "系统环境",
+      items: [
+        { label: "OS", item: { ok: true, detail: `${report.platform.os} ${report.platform.arch}` } },
+        { label: "Node.js", item: report.runtime.node, fix: "安装 Node.js 18+ 后重新运行 claude360", valueKey: "version" },
+        { label: "npm", item: report.runtime.npm, fix: "安装 npm 或修复 Node.js 安装", valueKey: "version" },
+        { label: "全局 npm 权限", item: report.runtime.globalNpmPermission, fix: "修复 npm 全局目录权限，或切换到用户级 npm prefix" },
+        { label: "终端二维码", item: report.platform.terminalQr, fix: "终端不支持时可复制支付链接完成支付" },
+      ],
+    },
+    {
+      title: "Claude360",
+      items: [
+        { label: "服务连接", item: report.api.connectivity, fix: "检查网络连接和 Claude360 站点可用性" },
+        { label: "登录状态", item: report.auth, fix: "在菜单中选择“重新登录”完成浏览器授权" },
+        { label: "当前余额", item: report.balance, fix: "通过“余额与充值”菜单充值" },
+        { label: "今日用量", item: report.usage, fix: "登录后可查看今日 Token 用量" },
+        { label: "当前 Key", item: report.token, fix: "在菜单中切换或创建 API Key" },
+        { label: "微信充值", item: report.topUp, fix: "检查后端微信支付配置或使用网页充值" },
+      ],
+    },
+    {
+      title: "Claude Code",
+      items: [
+        { label: "安装状态", item: report.tools.claudeCode, fix: "通过菜单安装或更新 Claude Code", valueKey: "version" },
+        { label: "Claude360 配置", item: report.claudeCodeConfig, fix: "在“Claude Code 配置”菜单中修复" },
+      ],
+    },
+    {
+      title: "Codex",
+      items: [
+        { label: "安装状态", item: report.tools.codex, fix: "通过菜单安装或更新 Codex", valueKey: "version" },
+        { label: "claude360 provider", item: report.codexConfig, fix: "在“Codex 配置”菜单中写入/修复" },
+        { label: "协议兼容性", item: report.codexCompat, fix: "Codex 暂不可用时可先使用 Claude Code" },
+      ],
+    },
+  ];
+
+  const lines = ["诊断报告"];
+  for (const group of groups) {
+    lines.push("", renderSectionTitle(group.title));
+    lines.push(renderTable({
+      head: ["检查项", "结果", "状态"],
+      rows: group.items.map(({ label, item, valueKey = "detail" }) => [
+        label,
+        String(item[valueKey] || item.detail || "-"),
+        statusLabel(item),
+      ]),
+    }, { width }));
+    const fixes = group.items.filter(({ item, fix }) => !item.ok && fix);
+    for (const { label, item, fix } of fixes) {
+      lines.push(`${item.warn ? "!" : "×"} ${label} 建议：${fix}`);
+    }
+  }
   // 出口兜底：report 由调用方注入，逐项 detail 可能未经脱敏
   return sanitizeText(lines.join("\n"));
 }
 
-function check(item, label, valueKey = "detail") {
-  const symbol = item.ok ? "✓" : item.warn ? "!" : "×";
-  const value = item[valueKey] || item.detail || "";
-  return `${symbol} ${label}${value ? `：${value}` : ""}`;
-}
-
-function checkFix(item, label, fix, valueKey = "detail") {
-  const line = check(item, label, valueKey);
+function statusLabel(item) {
   if (item.ok) {
-    return line;
+    return "✓ 通过";
   }
-  return `${line}\n  建议：${fix}`;
+  return item.warn ? "! 警告" : "× 失败";
 }
 
 function defaultPlatform() {