claude360 0.2.1 → 0.2.3

package/src/ui.js

@@ -0,0 +1,137 @@
+// 终端表格渲染：账户状态 / Key 列表 / 诊断报告等结构化输出的统一视觉组件。
+// 与 banner.js / menu.js 的手写渲染风格保持一致，不引入额外 UI 依赖。
+// 默认无色（color: false），保证测试与管道输出稳定；宽度不足时按列截断，
+// 单行宽表可降级为「字段/值」双列紧凑表，避免撑破终端。
+
+import { displayWidth } from "./banner.js";
+
+const ESC = "\u001b[";
+const RESET = `${ESC}0m`;
+const BOLD = `${ESC}1m`;
+const fg = (r, g, b) => `${ESC}38;2;${r};${g};${b}m`;
+const BORDER_COLOR = fg(71, 85, 105);
+const HEAD_COLOR = fg(125, 211, 252);
+
+// eslint-disable-next-line no-control-regex
+const ANSI_PATTERN = /\u001b\[[0-9;]*m/g;
+
+export function stripAnsi(text) {
+  return String(text ?? "").replace(ANSI_PATTERN, "");
+}
+
+export function cellWidth(text) {
+  return displayWidth(stripAnsi(text));
+}
+
+// 按显示宽度截断，超出部分以 … 结尾（… 计 1 列宽）
+export function truncateDisplay(text, maxWidth) {
+  const plain = String(text ?? "");
+  if (maxWidth <= 0 || cellWidth(plain) <= maxWidth) {
+    return plain;
+  }
+  let out = "";
+  let width = 0;
+  for (const ch of stripAnsi(plain)) {
+    const w = displayWidth(ch);
+    if (width + w > maxWidth - 1) {
+      break;
+    }
+    out += ch;
+    width += w;
+  }
+  return `${out}…`;
+}
+
+function padCell(text, width) {
+  const gap = Math.max(0, width - cellWidth(text));
+  return `${text}${" ".repeat(gap)}`;
+}
+
+function borderLine(widths, [left, mid, right], color) {
+  const line = `${left}${widths.map((w) => "─".repeat(w + 2)).join(mid)}${right}`;
+  return color ? `${BORDER_COLOR}${line}${RESET}` : line;
+}
+
+function contentLine(cells, widths, { color, bold = false } = {}) {
+  const bar = color ? `${BORDER_COLOR}│${RESET}` : "│";
+  const body = cells
+    .map((cell, i) => {
+      const padded = padCell(cell, widths[i]);
+      return bold && color ? ` ${BOLD}${HEAD_COLOR}${padded}${RESET} ` : ` ${padded} `;
+    })
+    .join(bar);
+  return `${bar}${body}${bar}`;
+}
+
+// 计算各列宽：先取内容最大宽，总宽超过可用宽度时从最宽列开始压缩
+function resolveWidths(head, rows, width) {
+  const columnCount = Math.max(head.length, ...rows.map((row) => row.length), 0);
+  const widths = Array.from({ length: columnCount }, (_, i) =>
+    Math.max(
+      cellWidth(head[i] ?? ""),
+      ...rows.map((row) => cellWidth(row[i] ?? "")),
+      1,
+    ));
+  if (!width || width <= 0) {
+    return widths;
+  }
+  const overhead = columnCount * 3 + 1; // 边框与内边距
+  const available = width - overhead;
+  let total = widths.reduce((sum, w) => sum + w, 0);
+  // 反复压缩当前最宽列，直到放得下或所有列都到达下限
+  const MIN_COL = 4;
+  while (total > available) {
+    const max = Math.max(...widths);
+    if (max <= MIN_COL) {
+      break;
+    }
+    const index = widths.indexOf(max);
+    widths[index] -= 1;
+    total -= 1;
+  }
+  return widths;
+}
+
+export function renderTable({ head = [], rows = [] } = {}, { color = false, width = 0 } = {}) {
+  const widths = resolveWidths(head, rows, width);
+  const fit = (row) => widths.map((w, i) => truncateDisplay(row[i] ?? "", w));
+  const lines = [borderLine(widths, ["┌", "┬", "┐"], color)];
+  if (head.length > 0) {
+    lines.push(contentLine(fit(head), widths, { color, bold: true }));
+    lines.push(borderLine(widths, ["├", "┼", "┤"], color));
+  }
+  for (const row of rows) {
+    lines.push(contentLine(fit(row), widths, { color }));
+  }
+  lines.push(borderLine(widths, ["└", "┴", "┘"], color));
+  return lines.join("\n");
+}
+
+// 双列紧凑表：窄终端下展示「字段 / 值」对，仍保留边框与分组感
+export function renderKeyValueTable(pairs = [], { color = false, width = 0 } = {}) {
+  return renderTable(
+    { head: [], rows: pairs.map(([key, value]) => [key, value]) },
+    { color, width },
+  );
+}
+
+// 单行横向表，放不下时自动降级为双列表（补充需求第 1 节）
+export function renderStatusTable({ head = [], row = [] } = {}, { color = false, width = 0 } = {}) {
+  const wide = renderTable({ head, rows: [row] }, { color });
+  const wideWidth = cellWidth(wide.split("\n")[0]);
+  if (!width || wideWidth <= width) {
+    return wide;
+  }
+  return renderKeyValueTable(head.map((key, i) => [key, row[i] ?? ""]), { color, width });
+}
+
+// 章节标题：与 menu.js 分区分隔线风格一致
+export function renderSectionTitle(title, { color = false, width = 46 } = {}) {
+  const lead = "───";
+  const label = ` ${title} `;
+  const tail = "─".repeat(Math.max(4, width - lead.length - displayWidth(label)));
+  if (!color) {
+    return `${lead}${label}${tail}`;
+  }
+  return `${BORDER_COLOR}${lead}${RESET}${BOLD}${HEAD_COLOR}${label}${RESET}${BORDER_COLOR}${tail}${RESET}`;
+}

package/src/workflows.js

@@ -0,0 +1,331 @@
+// 推荐工作流（PRD 6.5 / 8.4）：流程设计参考 NPX ZCF，内容为 Claude360 自研改编，
+// 文件头保留 attribution。Claude Code 写入 ~/.claude/commands/claude360/，
+// Codex 写入 ~/.codex/prompts/。安装前展示目录、备份同名文件、冲突二次确认，
+// 安装结果按 PRD 第 10 章样式展示。
+
+import { copyFile, cp, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+import { createBackup } from "./backup.js";
+import { ZCF_ATTRIBUTION_COMMENT } from "./zcf-notice.js";
+
+const defaultFs = { copyFile, cp, mkdir, readFile, stat, writeFile };
+
+function commandDoc(description, body) {
+  return [
+    ZCF_ATTRIBUTION_COMMENT,
+    "---",
+    `description: ${description}`,
+    "---",
+    "",
+    body.trim(),
+    "",
+  ].join("\n");
+}
+
+const SIX_STEP_BODY = `
+请按六步工作流推进本次任务：$ARGUMENTS
+
+1. **研究**：阅读相关代码与文档，弄清现状与约束，列出已知/未知。
+2. **构思**：给出至少 2 种可行方案，说明取舍，推荐其一。
+3. **计划**：拆解为可验证的最小步骤，列出涉及文件与风险。
+4. **执行**：按计划实现，保持最小改动面，遵循项目现有风格。
+5. **优化**：自查代码质量、边界条件与错误处理，运行测试。
+6. **评审**：总结改动点、影响范围与后续建议，输出中文报告。
+
+每步完成后简要汇报再进入下一步；计划阶段需等待用户确认。
+`;
+
+const FEAT_BODY = `
+请基于以下需求完成功能规划与 UX 设计：$ARGUMENTS
+
+输出包含：
+1. 需求澄清：目标用户、核心场景、价值假设、范围边界（做什么 / 不做什么）。
+2. 功能拆解：模块划分、用户故事（As a... I want... So that...）、优先级（P0/P1/P2）。
+3. 交互与 UX：关键页面 / 流程草图（文字或 ASCII）、状态与异常分支、文案建议。
+4. 技术落地：与现有代码的衔接点、接口草案、开发任务清单与依赖顺序。
+5. 风险与待确认问题清单。
+
+全部使用中文，结论先行，可直接用于评审。
+`;
+
+const GIT_COMMIT_BODY = `
+请阅读 git 暂存区改动（git diff --cached；为空时改读 git diff），
+生成符合 Conventional Commits 的中文提交信息：type(scope): 描述。
+
+要求：
+- type 从 feat/fix/docs/style/refactor/perf/test/chore 中选择。
+- 标题不超过 50 字，body 补充动机与影响范围。
+- 多个不相关改动时建议拆分提交并给出拆分方案。
+- 只输出提交信息本身，不要执行 git commit，除非用户明确要求。
+`;
+
+const GIT_ROLLBACK_BODY = `
+请协助安全回滚 git 改动：$ARGUMENTS
+
+步骤：
+1. 先运行 git status 与 git log --oneline -10，确认当前状态与目标提交。
+2. 区分场景给出方案：未暂存改动（git restore）、已暂存（git restore --staged）、
+   已提交未推送（git reset）、已推送（git revert，禁止 force push 共享分支）。
+3. 涉及丢弃用户数据的操作必须先列出将丢失的内容并等待用户确认。
+`;
+
+const GIT_CLEAN_BRANCHES_BODY = `
+请协助清理本地分支：
+
+1. 列出已合并到主分支的本地分支（git branch --merged）。
+2. 标出可安全删除的分支，排除当前分支、main/master/develop 等长期分支。
+3. 输出建议执行的删除命令清单，等待用户确认后再执行。
+4. 未合并分支默认不删除；如用户要求强删，逐个确认并提示风险。
+`;
+
+const GIT_WORKTREE_BODY = `
+请协助管理 git worktree：$ARGUMENTS
+
+支持的操作：
+- 新建：git worktree add ../<repo>-<branch> -b <branch>，并说明目录位置。
+- 列出：git worktree list，标注每个 worktree 的分支与状态。
+- 清理：git worktree remove <path>，删除前确认无未提交改动。
+
+操作前先展示将执行的命令，破坏性操作需用户确认。
+`;
+
+const INIT_PROJECT_BODY = `
+请初始化或更新本项目的 AI 协作配置：
+
+1. 分析项目结构、技术栈、构建与测试命令。
+2. 生成或更新项目根目录 CLAUDE.md：项目概述、目录结构、常用命令、
+   代码风格约定、注意事项。已有内容以标记区块方式增量更新，不覆盖用户自定义内容。
+3. 输出更新摘要。全部使用中文。
+`;
+
+const BMAD_BODY = `
+请协助安装 BMad-Method 敏捷开发扩展：
+
+1. 说明 BMad-Method 的用途（敏捷开发工作流：PO/架构师/开发/QA 等角色协作）。
+2. 检查 Node.js 环境后，提示用户确认执行：npx bmad-method install
+3. 安装过程出错时给出排查建议（网络、npm 镜像、Node 版本）。
+4. 安装完成后说明如何在对话中使用 BMad 工作流。
+
+注意：该命令会写入项目目录，执行前必须获得用户确认。
+`;
+
+// ──────────────────────────────────────────────
+// Claude Code 推荐工作流（PRD 6.5）
+// ──────────────────────────────────────────────
+
+export const CLAUDE_WORKFLOWS = [
+  {
+    id: "common-tools",
+    label: "通用工具工作流",
+    hint: "初始化、通用 agents、基础开发规范",
+    files: [
+      { name: "init-project.md", content: commandDoc("初始化 / 更新项目 CLAUDE.md 与协作规范", INIT_PROJECT_BODY) },
+    ],
+  },
+  {
+    id: "six-steps",
+    label: "六步工作流",
+    hint: "需求到实现的标准开发流程",
+    files: [
+      { name: "workflow.md", content: commandDoc("六步工作流：研究→构思→计划→执行→优化→评审", SIX_STEP_BODY) },
+    ],
+  },
+  {
+    id: "feat-ux",
+    label: "功能规划和 UX 设计",
+    hint: "面向产品功能设计、交互设计、PRD 拆解",
+    files: [
+      { name: "feat.md", content: commandDoc("功能规划与 UX 设计", FEAT_BODY) },
+    ],
+  },
+  {
+    id: "git",
+    label: "Git 指令工作流",
+    hint: "commit、rollback、cleanBranches、worktree",
+    files: [
+      { name: "git-commit.md", content: commandDoc("生成规范的中文提交信息", GIT_COMMIT_BODY) },
+      { name: "git-rollback.md", content: commandDoc("安全回滚 git 改动", GIT_ROLLBACK_BODY) },
+      { name: "git-clean-branches.md", content: commandDoc("清理已合并的本地分支", GIT_CLEAN_BRANCHES_BODY) },
+      { name: "git-worktree.md", content: commandDoc("管理 git worktree", GIT_WORKTREE_BODY) },
+    ],
+  },
+  {
+    id: "bmad",
+    label: "BMad-Method 扩展安装器",
+    hint: "支持敏捷开发相关工作流",
+    files: [
+      { name: "bmad-init.md", content: commandDoc("安装 BMad-Method 敏捷开发扩展", BMAD_BODY) },
+    ],
+  },
+];
+
+// ──────────────────────────────────────────────
+// Codex 推荐工作流（PRD 8.4）：写入 ~/.codex/prompts/
+// ──────────────────────────────────────────────
+
+export const CODEX_WORKFLOWS = [
+  {
+    id: "six-steps",
+    label: "六步工作流",
+    hint: "需求到实现的标准开发流程",
+    files: [
+      { name: "workflow.md", content: commandDoc("六步工作流：研究→构思→计划→执行→优化→评审", SIX_STEP_BODY) },
+    ],
+  },
+  {
+    id: "git",
+    label: "Git 指令工作流",
+    hint: "commit、rollback、cleanBranches、worktree",
+    files: [
+      { name: "git-commit.md", content: commandDoc("生成规范的中文提交信息", GIT_COMMIT_BODY) },
+      { name: "git-rollback.md", content: commandDoc("安全回滚 git 改动", GIT_ROLLBACK_BODY) },
+      { name: "git-clean-branches.md", content: commandDoc("清理已合并的本地分支", GIT_CLEAN_BRANCHES_BODY) },
+      { name: "git-worktree.md", content: commandDoc("管理 git worktree", GIT_WORKTREE_BODY) },
+    ],
+  },
+  {
+    id: "feat-ux",
+    label: "功能规划和 UX 设计",
+    hint: "面向产品功能设计、交互设计、PRD 拆解",
+    files: [
+      { name: "feat.md", content: commandDoc("功能规划与 UX 设计", FEAT_BODY) },
+    ],
+  },
+  {
+    id: "bmad",
+    label: "BMad-Method 扩展安装器",
+    hint: "支持敏捷开发相关工作流",
+    files: [
+      { name: "bmad-init.md", content: commandDoc("安装 BMad-Method 敏捷开发扩展", BMAD_BODY) },
+    ],
+  },
+];
+
+async function fileExists(fs, filePath) {
+  try {
+    await fs.stat(filePath);
+    return true;
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+// 通用安装流程：多选 → 展示写入目录 → 备份已有同名文件 → 冲突二次确认 → 写入 → 结果展示
+async function installWorkflowSet({
+  workflows,
+  targetDir,
+  backupBaseDir,
+  multiSelect,
+  confirm,
+  writeLine,
+  fs,
+  now,
+  usageHint,
+}) {
+  if (typeof multiSelect !== "function" || typeof confirm !== "function") {
+    throw new Error("缺少交互输入");
+  }
+  const selected = await multiSelect({
+    message: "请选择要安装的工作流：",
+    choices: workflows.map((workflow) => ({
+      label: workflow.label,
+      value: workflow.id,
+      hint: workflow.hint,
+    })),
+  });
+  if (selected.length === 0) {
+    writeLine("已跳过工作流安装。");
+    return { installed: [], skipped: true };
+  }
+
+  const picked = workflows.filter((workflow) => selected.includes(workflow.id));
+  writeLine(`安装将写入目录：${targetDir}`);
+
+  // 备份已存在的同名文件（一次性集中备份到时间戳目录）
+  const targets = picked.flatMap((workflow) => workflow.files.map((file) => path.join(targetDir, file.name)));
+  const { backupDir } = await createBackup({ baseDir: backupBaseDir, paths: targets, fs, now });
+  if (backupDir) {
+    writeLine(`✓ 已创建备份：${backupDir}`);
+  }
+
+  const installed = [];
+  for (const workflow of picked) {
+    writeLine(`正在安装工作流：${workflow.label}...`);
+    let wroteAny = false;
+    for (const file of workflow.files) {
+      const filePath = path.join(targetDir, file.name);
+      if (await fileExists(fs, filePath)) {
+        const existing = await fs.readFile(filePath, "utf8");
+        if (existing !== file.content) {
+          const approved = await confirm(`文件已存在：${filePath}\n是否覆盖？（原文件已备份）`);
+          if (!approved) {
+            writeLine(`已跳过：${file.name}`);
+            continue;
+          }
+        }
+      }
+      await fs.mkdir(targetDir, { recursive: true });
+      await fs.writeFile(filePath, file.content, "utf8");
+      writeLine(`✓ 已安装命令：${file.name}`);
+      wroteAny = true;
+    }
+    if (wroteAny) {
+      installed.push(workflow.id);
+      writeLine(`✓ ${workflow.label}安装成功`);
+    }
+  }
+  if (installed.length > 0 && usageHint) {
+    writeLine(usageHint);
+  }
+  return { installed, skipped: false };
+}
+
+export function resolveClaudeCommandsDir(claudeDir) {
+  return path.join(claudeDir, "commands", "claude360");
+}
+
+export async function installClaudeWorkflows({
+  claudeDir,
+  multiSelect,
+  confirm,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  return installWorkflowSet({
+    workflows: CLAUDE_WORKFLOWS,
+    targetDir: resolveClaudeCommandsDir(claudeDir),
+    backupBaseDir: claudeDir,
+    multiSelect,
+    confirm,
+    writeLine,
+    fs,
+    now,
+    usageHint: "在 Claude Code 中使用 /claude360:<命令名> 调用，例如 /claude360:workflow。",
+  });
+}
+
+export async function installCodexWorkflows({
+  codexDir,
+  multiSelect,
+  confirm,
+  writeLine = console.log,
+  fs = defaultFs,
+  now,
+} = {}) {
+  return installWorkflowSet({
+    workflows: CODEX_WORKFLOWS,
+    targetDir: path.join(codexDir, "prompts"),
+    backupBaseDir: codexDir,
+    multiSelect,
+    confirm,
+    writeLine,
+    fs,
+    now,
+    usageHint: "在 Codex 中使用 /prompts 或输入 /<命令名> 调用，例如 /workflow。",
+  });
+}

package/src/zcf-notice.js

@@ -0,0 +1,40 @@
+// 开源参考声明（PRD 第 2 章）：进入借鉴自 NPX ZCF 的初始化 / 工作流 /
+// MCP / Skill / AGENTS 配置流程前展示，用户选择「继续」才进入流程。
+// 普通余额查看、充值、打开控制台、创建 Key 不展示。
+
+export const ZCF_PROJECT_URL = "https://github.com/UfoMiao/zcf";
+
+export const OPEN_SOURCE_NOTICE = [
+  "开源参考声明",
+  "",
+  "本功能中的交互式初始化流程、工作流导入、MCP 推荐配置等设计，",
+  "借鉴并参考了开源项目 NPX ZCF 的部分功能体验。",
+  "",
+  "感谢 NPX ZCF 作者 UfoMiao 的开源贡献。",
+  `项目地址：${ZCF_PROJECT_URL}`,
+  "",
+  "Claude360 CLI 会在此基础上结合 Claude360 模型站能力，",
+  "提供授权登录、API Key、余额充值、Claude Code / Codex 配置注入等服务。",
+].join("\n");
+
+// 工作流 / AGENTS 等改编内容的文件头 attribution（PRD 2.3 / 6.5）
+export const ZCF_ATTRIBUTION_COMMENT = [
+  "<!--",
+  `  本工作流参考并改编自开源项目 NPX ZCF（${ZCF_PROJECT_URL}），`,
+  "  感谢作者 UfoMiao 的开源贡献。由 Claude360 CLI 安装与维护。",
+  "-->",
+].join("\n");
+
+// 展示声明并询问是否继续；返回 true 表示继续，false 表示返回上级菜单。
+export async function showOpenSourceNotice({ promptSelect, writeLine = console.log } = {}) {
+  if (typeof promptSelect !== "function") {
+    throw new Error("缺少选择输入");
+  }
+  writeLine(OPEN_SOURCE_NOTICE);
+  writeLine("");
+  const action = await promptSelect("是否继续？", [
+    { label: "继续", value: "continue" },
+    { label: "返回", value: "back" },
+  ]);
+  return action === "continue";
+}