agent-syncer 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# agent-syncer
+
+把一份 AI 资产分发到多个编码工具——**一处保存，处处可用**。
+
+部门里同时在用 Claude Code、Trae、Codex 的人越来越多，同一套规范要往三四个目录里各放一份，
+改一次就得同步好几次。`agent-syncer` 把这件事收敛成：内容只存在 `.agents/` 下**一份**，
+其余工具目录一律用链接指过来。
+
+```
+.agents/skills/code-style/SKILL.md   ← 唯一真源
+        ↑            ↑           ↑
+   .claude/skills  .trae/skills  .codex/skills
+```
+
+## 为什么不用 Claude Code 的插件机制
+
+试过，有硬伤（详见 `../HANDOFF.md`）：
+
+- 插件级 hook 的 `additionalContext` 有上游 bug（issue #16538），注入不了上下文
+- 插件没有 `rules` 组件
+- 跨工具完全无法复用
+- `claude plugin marketplace remove` 会顺手清空项目里的声明
+
+而**项目级的 `.claude/rules/*.md` 是有效的**（本仓库实测，含嵌套子目录）——这正是走 CLI 路线的底气。
+
+## 快速开始
+
+> ⚠️ **当前是 alpha 版，发布在 `next` tag 下。**
+> 必须带 `@next`，写成 `npx agent-syncer` 会取不到（npm 默认只认 `latest`）。
+> 等发稳定版后去掉 `@next` 即可。
+
+```bash
+# 1. 只读检查环境
+npx agent-syncer@next doctor
+
+# 2. 看当前状态
+npx agent-syncer@next status
+
+# 3. 预演一遍（不写盘）
+npx agent-syncer@next link --dry-run
+
+# 4. 真正建好
+npx agent-syncer@next link
+```
+
+> **这一步之前，项目里得先有 `.agents/`。** `link` 只建链接、不拉内容；
+> `.agents/` 不存在时会直接报错退出。内容从远端仓库拉取是第二阶段 `sync` 的事。
+
+**第一次跑 `link` 时会让你勾选。** 项目根没有 `agents.json` 的情况下，它不会自作主张，
+而是把每一条链接目标列出来让你选：
+
+```
+没有找到 agents.json，请勾选要建立链接的目录：
+  ❯ ◉ Claude Code · .claude/skills
+    ◉ Claude Code · .claude/rules
+    ◯ Claude Code · .claude/agents  （.agents/agents/ 暂无内容）
+    ◉ Trae · .trae/skills
+    ◉ Codex CLI · .codex/skills
+  ↑↓ 移动 · 空格 勾选 · a 全选 · 回车 确认 · Ctrl-C 取消
+```
+
+勾选结果会写进 `agents.json`，下次不再问：
+
+```json
+{
+  "links": [
+    "claude/skills",
+    "claude/rules",
+    "trae/skills",
+    "codex/skills"
+  ]
+}
+```
+
+想写成"这个工具的类型全要"也行，两种写法等价：
+
+```json
+{
+  "tools": ["claude", "trae", "codex"]
+}
+```
+
+**非交互环境（CI、管道、`postinstall`）不会弹提示**——`link` 会退回到按已有目录推断，
+并明确打印推断了什么。脚本里想跳过询问，用 `--yes`。
+
+## 命令
+
+| 命令 | 作用 | 写盘 |
+| --- | --- | --- |
+| `link` | 建好目录链接并维护 `.gitignore`；没有 `agents.json` 时先让你勾选 | 是（支持 `--dry-run`） |
+| `status` | 每个链接是否健康、`.agents/` 下各有多少内容 | 否 |
+| `doctor` | 运行环境、链接能力实测、`.gitignore`、各工具是否存在 | 否 |
+
+选项：`--dry-run`　`--force`　`--yes`　`--no-save`　`--cwd=<路径>`　`--help`
+
+## 目录约定
+
+```
+.agents/
+├── skills/<名字>/SKILL.md     # 技能（目录形态，可含 references/ scripts/ 等）
+├── rules/<名字>.md            # 规则
+├── commands/<名字>.md         # 斜杠命令
+└── agents/<名字>.md           # 子代理
+```
+
+内容只在上面保存一份，各工具的实际位置由内置映射表决定：
+
+| 内容 | Claude Code | Trae | Codex |
+| --- | --- | --- | --- |
+| skills | `.claude/skills` | `.trae/skills` | `.codex/skills` |
+| rules | `.claude/rules` | `.trae/rules` | 合并进 `AGENTS.md` |
+| commands | `.claude/commands` | `.trae/commands` | —— 未见项目级机制 |
+| agents | `.claude/agents` | —— | —— |
+
+> **关于 Codex 的规则**：它**有**规则机制，只是没有"规则目录"。
+> 规则写在 `AGENTS.md` 里，优先级是 `AGENTS.override.md` > `AGENTS.md`
+> > `project_doc_fallback_filenames` 里配置的名字；且按目录作用域生效——
+> 子目录里的 `AGENTS.md` 只管它自己那棵子树。它也不支持 `@import`，
+> 所以 rules 只能合并进 `AGENTS.md`，不能像 Claude / Trae 那样用目录链接分发。
+> 注意默认有 `project_doc_max_bytes = 32768` 的大小上限。
+>
+> **commands 存疑**：在 codex.exe（0.154.0）里没找到项目级自定义命令的机制
+> ——出现的 `prompts` 都是 MCP 协议自身的（`prompts/list`）。所以 `.codex/commands`
+> 很可能和 `.codex/rules` 一样是空转的。这条**没有实测过**，只是没有证据支持它有效。
+
+## 几条设计取舍
+
+**只链接目录，不链接文件。** Windows 上目录可以用 `junction`（不需要管理员权限），
+文件链接则必须管理员或开发者模式。为了所有人开箱即用，本工具干脆不支持文件链接——
+单文件的配置（如 `settings.json`）以后走「读-改-写合并」，不走链接。
+
+**绝不删除实体目录。** 路径上已经有用户自己的目录或文件时，`link` 一律拒绝并报错，
+退出码非零。指向别处的链接需要显式 `--force` 才接管，且 `--force` 也只删链接、不删实体目录。
+
+**`.gitignore` 托管段是必需的。** 链接记录的是**绝对路径**，提交上去在别人机器上全是错的；
+更危险的是 git 会**穿透链接**，把 `.agents/` 的内容原样再提交一份，仓库里出现两套内容。
+`link` 会自动写入这段（`.claude/settings.json`、`.claude/hooks/` **不在**忽略之列，那是要进版本库的真实配置）。
+
+**没有状态文件。** 状态全部从文件系统推出来。少存一份状态，就少一次不同步的机会。
+
+## 已知限制
+
+- **Trae 的路径约定未经实证**——本机没装 Trae，映射表沿用既有项目里在用的配置
+- **Codex 没有 rules / commands 目录概念**，它只有 `AGENTS.md` 和 `config.toml`。
+  这两类内容将来要合并进 `AGENTS.md`，目前直接跳过
+- **Windows 的 junction 不支持 UNC 网络路径**。工作目录在网络盘上时会明确报错
+- 目前只做**链接**。从远端仓库拉取内容、合并配置文件属于第二阶段
+
+## 开发
+
+```bash
+npm test        # node --test，零依赖
+```
+
+代码约定与 `iqcs_web/scripts/` 保持一致：ESM、`node:` 前缀、手写参数解析、中文 + emoji 输出。

package/bin/agent-sync.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+// @ts-check
+import path from 'node:path';
+import process from 'node:process';
+import { bold, dim, fail, plain, title } from '../lib/log.js';
+import { TOOL_NAMES } from '../lib/target.js';
+
+const USAGE = `${bold('agent-syncer')} — 把 .agents/ 下的 AI 资产分发到各编码工具的配置目录
+
+${bold('用法')}
+  agent-syncer <命令> [选项]
+
+${bold('命令')}
+  link      建好目录链接并维护 .gitignore；没有 agents.json 时会先让你勾选
+  status    只读报告：每个链接当前是否健康，.agents/ 下各有多少内容
+  doctor    只读自检：运行环境、链接能力、.gitignore、各工具是否存在
+
+${bold('选项')}
+  --dry-run       只打印计划，不写盘（link 支持）
+  --force         覆盖指向别处的链接（绝不删除实体目录）
+  --yes           不询问，直接按已有目录推断（CI / postinstall 用）
+  --no-save       交互式勾选后不写入 agents.json
+  --cwd=<路径>    指定项目根，默认当前目录
+  --help          显示本帮助
+
+${bold('内容约定')}
+  所有内容只在 ${bold('.agents/')} 下保存一份：
+    .agents/skills/<名字>/SKILL.md
+    .agents/rules/<名字>.md
+    .agents/commands/<名字>.md
+    .agents/agents/<名字>.md
+  再由本工具在各工具目录建链接指过来，因此永远只有一份真源。
+
+${bold('可用工具')}
+  ${TOOL_NAMES.join('、')}
+
+${bold('示例')}
+  agent-syncer status
+  agent-syncer link                  # 没有配置时会让你勾选要建立哪些链接
+  agent-syncer link --dry-run
+  agent-syncer link --force
+  agent-syncer link --yes            # 不询问，适合脚本
+`;
+
+/** 手写参数解析，与 iqcs_web/scripts 下的既有风格一致（不引第三方依赖） */
+function parseArgs(argv) {
+  /** @type {Record<string, string|boolean> & {_: string[]}} */
+  const flags = { _: [] };
+  for (const a of argv) {
+    if (a.startsWith('--')) {
+      const body = a.slice(2);
+      const eq = body.indexOf('=');
+      if (eq === -1) flags[body] = true;
+      else flags[body.slice(0, eq)] = body.slice(eq + 1);
+    } else {
+      flags._.push(a);
+    }
+  }
+  return flags;
+}
+
+const COMMANDS = /** @type {const} */ ({
+  link: '../lib/commands/link.js',
+  status: '../lib/commands/status.js',
+  doctor: '../lib/commands/doctor.js',
+});
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.version === true) {
+    const { createRequire } = await import('node:module');
+    const require = createRequire(import.meta.url);
+    plain(require('../package.json').version);
+    return 0;
+  }
+
+  const cmd = args._[0];
+
+  if (!cmd || args.help === true || cmd === 'help') {
+    plain(USAGE);
+    return 0;
+  }
+
+  const loader = /** @type {Record<string, string>} */ (COMMANDS)[cmd];
+  if (!loader) {
+    fail(`未知命令：${cmd}`);
+    plain(`\n可用命令：${Object.keys(COMMANDS).join('、')}。用 --help 查看全部用法。`);
+    return 1;
+  }
+
+  const cwd = typeof args.cwd === 'string' ? path.resolve(args.cwd) : process.cwd();
+  const mod = await import(loader);
+  return (await mod.run({ cwd, flags: args })) ?? 0;
+}
+
+main()
+  .then((code) => process.exit(code))
+  .catch((err) => {
+    fail(err?.message ?? String(err));
+    if (process.env.AGENT_SYNC_DEBUG) console.error(err);
+    else plain(dim('（加 AGENT_SYNC_DEBUG=1 可看到完整堆栈）'));
+    process.exit(1);
+  });

package/lib/commands/doctor.js

@@ -0,0 +1,132 @@
+// @ts-check
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { CONFIG_FILENAME, loadConfig } from '../config.js';
+import { checkBlock } from '../gitignore.js';
+import { probeLinkCapability } from '../link.js';
+import { dim, fail, ok, plain, skip, title, warn } from '../log.js';
+import { CONTENT_ROOT, TOOLS, TOOL_NAMES } from '../target.js';
+
+/** @type {string[]} */
+const PACKAGE_TOOL_HINTS = {
+  claude: '.claude',
+  trae: '.trae',
+  codex: '.codex',
+};
+
+/**
+ * agent-syncer doctor —— 纯只读的环境自检。
+ * 目的：在出问题之前，把「环境支不支持」讲清楚。
+ *
+ * @param {{cwd: string, flags: Record<string, any>}} ctx
+ */
+export async function run({ cwd }) {
+  title('agent-syncer doctor');
+  plain(dim(`项目根：${cwd}`));
+  plain(dim(`平台：${process.platform}　Node：${process.version}`));
+
+  let fatal = 0;
+  let warned = 0;
+
+  // ---- 1. Node 版本 ----
+  title('运行环境');
+  const major = Number(process.versions.node.split('.')[0]);
+  const minor = Number(process.versions.node.split('.')[1]);
+  if (major > 20 || (major === 20 && minor >= 11)) {
+    ok(`Node ${process.version}`);
+  } else {
+    fail(`Node ${process.version} 过低，需要 >= 20.11.0`);
+    fatal += 1;
+  }
+
+  // ---- 2. 链接能力实测 ----
+  const probe = probeLinkCapability();
+  if (probe.ok) {
+    ok(`可创建目录链接（${probe.type}）`);
+    plain(dim(`    实测解析到：${probe.resolved}`));
+  } else {
+    fail(`无法创建目录链接：${probe.message ?? '未知原因'}`);
+    plain(dim('    Windows 上应为 junction，无需管理员权限；失败常见于目录在网络驱动器上'));
+    fatal += 1;
+  }
+
+  // ---- 3. 内容目录 ----
+  title('内容');
+  const contentRoot = path.resolve(cwd, CONTENT_ROOT);
+  if (fs.existsSync(contentRoot)) {
+    const kinds = fs
+      .readdirSync(contentRoot, { withFileTypes: true })
+      .filter((e) => e.isDirectory())
+      .map((e) => e.name);
+    ok(`${CONTENT_ROOT}/ 存在`);
+    if (kinds.length > 0) plain(dim(`    子目录：${kinds.join('、')}`));
+    else warn(`${CONTENT_ROOT}/ 是空的，还没有任何内容`);
+  } else {
+    warn(`${CONTENT_ROOT}/ 不存在——第二步的 sync 命令会创建并拉取内容`);
+    warned += 1;
+  }
+
+  // ---- 4. 项目配置 ----
+  title('项目配置');
+  const config = loadConfig(cwd);
+  if (config.exists) {
+    ok(`${CONFIG_FILENAME} 存在`);
+    if (config.links.length > 0) plain(dim(`    links：${config.links.join('、')}`));
+    else warn('links 为空');
+  } else {
+    skip(`${CONFIG_FILENAME} 不存在（link 会交互式询问，或按已有目录推断）`);
+    if (config.links.length > 0) plain(dim(`    推断结果：${config.links.join('、')}`));
+    else plain(dim('    没有可推断的项——需要交互式勾选'));
+  }
+  for (const w of config.warnings) warn(w);
+
+  // ---- 5. .gitignore ----
+  title('.gitignore');
+  const gi = checkBlock(cwd, config.links);
+  if (!gi.present) {
+    warn('未找到 agent-syncer 托管段，运行 link 会写入');
+    warned += 1;
+  } else if (gi.missing.length > 0) {
+    warn(`托管段缺少 ${gi.missing.length} 个条目，运行 link 会补齐`);
+    for (const m of gi.missing) plain(dim(`    · ${m}`));
+    warned += 1;
+  } else {
+    ok('托管段完整');
+  }
+  plain(
+    dim(
+      '    该段忽略各工具的链接目录：链接记录绝对路径，提交后对别人无效，' +
+        '且 git 会穿透链接重复提交内容',
+    ),
+  );
+
+  // ---- 6. 各工具是否存在 ----
+  title('工具');
+  for (const name of TOOL_NAMES) {
+    const dir = path.resolve(cwd, /** @type {Record<string,string>} */ (PACKAGE_TOOL_HINTS)[name]);
+    const onDisk = fs.existsSync(dir);
+    const declared = config.tools.includes(name);
+    const kinds = Object.keys(TOOLS[name].links).join('/');
+    if (onDisk && declared) ok(`${TOOLS[name].label.padEnd(12)} 目录存在，已声明　${dim(kinds)}`);
+    else if (onDisk && !declared) warn(`${TOOLS[name].label.padEnd(12)} 目录存在，但未在 tools 里声明`);
+    else if (!onDisk && declared) {
+      const how = config.inferred ? '默认使用' : '已声明';
+      warn(`${TOOLS[name].label.padEnd(12)} ${how}，但项目里没有 ${'.' + name} 目录`);
+    }
+    else skip(`${TOOLS[name].label.padEnd(12)} 未使用`);
+  }
+
+  // ---- 小结 ----
+  title('小结');
+  if (fatal > 0) {
+    fail(`发现 ${fatal} 个致命问题，agent-syncer link 无法正常工作`);
+    return 1;
+  }
+  if (warned > 0) {
+    warn(`环境可用，但有 ${warned} 项提示（多数会在运行 link / sync 后消失）`);
+    return 0;
+  }
+  ok('一切正常');
+  return 0;
+}

package/lib/commands/link.js

@@ -0,0 +1,215 @@
+// @ts-check
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { CONFIG_FILENAME, loadConfig, saveConfig } from '../config.js';
+import { writeBlock } from '../gitignore.js';
+import { STATUS, createLink, inspect, removeLink } from '../link.js';
+import { dim, fail, info, ok, plain, skip, title, warn } from '../log.js';
+import { checkbox, isInteractive } from '../prompt.js';
+import { CONTENT_ROOT, TOOLS, specOf, plannedLinks, kindsOf, TOOL_NAMES } from '../target.js';
+
+/**
+ * 构造勾选项。
+ *
+ * 列出的是**链接目标**（如 .claude/skills），因为用户要判断的正是
+ * 「哪些目录可以被这份内容接管」，而不是抽象的"用哪个工具"。
+ *
+ * 与「怎么问」分开，是为了这一层能单独测试——渲染和按键由 prompt.js 负责。
+ *
+ * @param {string} cwd @param {string[]} preselected
+ */
+export function buildLinkChoices(cwd, preselected) {
+  /** @type {{value: string, label: string, note: string, checked: boolean}[]} */
+  const choices = [];
+
+  for (const tool of TOOL_NAMES) {
+    const toolDirExists = fs.existsSync(path.resolve(cwd, `.${tool}`));
+    for (const kind of kindsOf(tool)) {
+      const spec = specOf(tool, kind);
+      const notes = [];
+      if (!fs.existsSync(path.resolve(cwd, CONTENT_ROOT, kind))) {
+        notes.push(`${CONTENT_ROOT}/${kind}/ 暂无内容`);
+      }
+      if (!toolDirExists) notes.push(`会新建 .${tool}/`);
+
+      choices.push({
+        value: spec,
+        label: `${TOOLS[tool].label} · ${TOOLS[tool].links[kind]}`,
+        note: notes.length > 0 ? `（${notes.join('，')}）` : '',
+        checked: preselected.includes(spec),
+      });
+    }
+  }
+  return choices;
+}
+
+/**
+ * agent-syncer link —— 建好所有目录链接，并维护 .gitignore 的托管段。
+ *
+ * 安全底线：**绝不删除实体目录或实体文件**。
+ * 路径上已有非链接的东西时一律拒绝并报错，交由用户自己处置。
+ *
+ * 输入输出流可注入，生产环境用默认值，测试时可传替身来跑完整交互链路。
+ *
+ * @param {{cwd: string, flags: Record<string, any>, input?: NodeJS.ReadStream, output?: NodeJS.WriteStream}} ctx
+ */
+export async function run({ cwd, flags, input = process.stdin, output = process.stdout }) {
+  const dryRun = Boolean(flags['dry-run']);
+  const force = Boolean(flags.force);
+  const assumeYes = Boolean(flags.yes);
+  const noSave = Boolean(flags['no-save']);
+
+  title(`agent-syncer link${dryRun ? dim('（--dry-run，不会写盘）') : ''}`);
+  plain(dim(`项目根：${cwd}`));
+
+  const contentRoot = path.resolve(cwd, CONTENT_ROOT);
+  if (!fs.existsSync(contentRoot)) {
+    fail(`内容目录不存在：${contentRoot}`);
+    plain('  请先建好 .agents/ 并放入内容（第二步的 sync 命令会自动拉取）。');
+    return 1;
+  }
+
+  let config = loadConfig(cwd);
+
+  // 没有配置：交互式问一次，并把答案记下来，下次不再问
+  if (!config.exists && !assumeYes) {
+    if (!isInteractive(input, output)) {
+      warn(`未找到 ${CONFIG_FILENAME}，且当前不是交互终端——按已有目录推断`);
+      warn(`  推断结果：${config.links.join('、') || '（空）'}`);
+      plain(dim('  想自己选，请在终端里直接运行；或先手写一个 agents.json。'));
+    } else {
+      plain('');
+      const picked = await checkbox({
+        message: `没有找到 ${CONFIG_FILENAME}，请勾选要建立链接的目录：`,
+        choices: buildLinkChoices(cwd, config.links),
+        input,
+        output,
+      });
+
+      if (picked === null) {
+        plain(dim('已取消，未做任何改动。'));
+        return 0;
+      }
+      if (picked.length === 0) {
+        warn('没有勾选任何目录，无事可做');
+        return 0;
+      }
+
+      if (dryRun || noSave) {
+        info(`将要建立 ${picked.length} 个链接（${dryRun ? '--dry-run' : '--no-save'}：不写入 ${CONFIG_FILENAME}）`);
+      } else {
+        const p = saveConfig(cwd, picked);
+        ok(`${CONFIG_FILENAME} 已写入 → ${path.relative(cwd, p)}`);
+      }
+      config = { ...config, links: picked, exists: true };
+    }
+  }
+
+  for (const w of config.warnings) warn(w);
+
+  if (config.links.length === 0) {
+    warn('没有任何要建立的链接，无事可做');
+    return 0;
+  }
+
+  const plan = plannedLinks(cwd, config.links);
+  let created = 0;
+  let alreadyOk = 0;
+  let skipped = 0;
+  /** @type {string[]} */
+  const problems = [];
+
+  for (const item of plan) {
+    const label = `${TOOLS[item.tool].label} ${dim('·')} ${item.rel}`;
+
+    if (!fs.existsSync(item.source)) {
+      skip(`${label}  ${dim(`内容目录 ${CONTENT_ROOT}/${item.kind}/ 不存在，跳过`)}`);
+      skipped += 1;
+      continue;
+    }
+
+    const before = inspect(item.target, item.source);
+
+    if (before.status === STATUS.HEALTHY) {
+      ok(`${label}  已是最新`);
+      alreadyOk += 1;
+      continue;
+    }
+
+    if (before.status === STATUS.REPLACED) {
+      fail(`${label}  已存在实体目录/文件，拒绝覆盖`);
+      problems.push(`${item.rel} 是实体目录，请自行处理后再运行`);
+      continue;
+    }
+
+    if (before.status === STATUS.ELSEWHERE && !force) {
+      fail(`${label}  已是指向别处的链接 → ${before.actual}`);
+      problems.push(`${item.rel} 指向别处，确认无误后加 --force 覆盖`);
+      continue;
+    }
+
+    // 走到这里只可能是 ABSENT / BROKEN / (ELSEWHERE + --force)，
+    // 三种情况都只涉及链接本身，删除是安全的
+    if (before.status === STATUS.BROKEN || before.status === STATUS.ELSEWHERE) {
+      if (dryRun) {
+        info(`${label}  将先移除现有链接（${before.status === STATUS.BROKEN ? '断链' : '指向别处'}）`);
+      } else {
+        const removed = removeLink(item.target);
+        if (!removed.ok) {
+          fail(`${label}  移除旧链接失败：${removed.message}`);
+          problems.push(`${item.rel}：${removed.message}`);
+          continue;
+        }
+      }
+    }
+
+    const res = createLink(item.source, item.target, { dryRun });
+    if (!res.ok) {
+      fail(`${label}  创建失败：${res.message}`);
+      problems.push(`${item.rel}：${res.message}`);
+      continue;
+    }
+
+    if (dryRun) {
+      info(`${label}  将创建 → ${CONTENT_ROOT}/${item.kind}`);
+    } else {
+      const after = inspect(item.target, item.source);
+      if (after.status === STATUS.HEALTHY) {
+        ok(`${label}  已创建`);
+        created += 1;
+      } else {
+        fail(`${label}  创建后校验失败（状态：${after.status}）`);
+        problems.push(`${item.rel}：创建后校验未通过`);
+      }
+    }
+  }
+
+  // .gitignore：junction 记录绝对路径，必须忽略；否则 git 会穿透链接重复提交内容
+  const gi = writeBlock(cwd, config.links, { dryRun });
+  if (gi.changed) {
+    if (dryRun) info(`${dim('.gitignore')}  将写入托管段`);
+    else ok(`${dim('.gitignore')}  托管段已更新`);
+  } else {
+    ok(`${dim('.gitignore')}  托管段已是最新`);
+  }
+
+  title('小结');
+  plain(
+    `  新创建 ${created}　已存在 ${alreadyOk}　跳过 ${skipped}` +
+      `${problems.length ? `　问题 ${problems.length}` : ''}`,
+  );
+
+  if (problems.length > 0) {
+    title('需要你处理');
+    for (const p of problems) plain(`  · ${p}`);
+    return 1;
+  }
+
+  if (dryRun) {
+    plain(dim('\n这是预演，未写盘。去掉 --dry-run 即可实际执行。'));
+  } else if (created > 0) {
+    plain(dim('\n提示：这些链接已加入 .gitignore，别把它们提交上去。'));
+  }
+  return 0;
+}