alanbox 0.1.3 → 0.1.4

package/cli.js

@@ -10,8 +10,9 @@ const path = require('path');
 const { spawn } = require('child_process');
 
 const BOXER_COMMANDS = new Set(['install', 'init', 'update']);
-const SWARMER_COMMANDS = new Set(['swarm', 'doctor']);
+const SWARMER_COMMANDS = new Set(['swarm', 'doctor', 'review-file']);
 const DESIGNER_COMMANDS = new Set(['designer']);
+const REPORTER_COMMANDS = new Set(['reporter']);
 
 async function main(argv = process.argv.slice(2)) {
   const command = argv[0] && !argv[0].startsWith('-') ? argv[0] : '';
@@ -51,11 +52,16 @@ async function main(argv = process.argv.slice(2)) {
     return;
   }
 
+  if (REPORTER_COMMANDS.has(command)) {
+    await runReporter(argv.slice(1));
+    return;
+  }
+
   throw new Error(`unknown alanbox command: ${command}`);
 }
 
 async function runSwarmer(argv = process.argv.slice(2)) {
-  if (argv[0] === 'info' || argv[0] === 'doctor') {
+  if (argv[0] === 'info' || argv[0] === 'doctor' || argv[0] === 'review-file') {
     await runSwarmerFlow(argv);
     return;
   }
@@ -83,10 +89,21 @@ async function runDesigner(argv = process.argv.slice(2)) {
     );
   }
 
-  await runNodeCli(cliPath, argv);
+  await runNodeCli('designer', cliPath, argv);
+}
+
+async function runReporter(argv = process.argv.slice(2)) {
+  const cliPath = path.join(__dirname, '4reporter', 'dist', 'cli.js');
+  if (!existsSync(cliPath)) {
+    throw new Error(
+      'reporter dist/cli.js not found. Build it from 4reporter before running this command.',
+    );
+  }
+
+  await runNodeCli('reporter', cliPath, argv);
 }
 
-function runNodeCli(cliPath, argv) {
+function runNodeCli(label, cliPath, argv) {
   return new Promise((resolve, reject) => {
     const child = spawn(process.execPath, [cliPath, ...argv], {
       stdio: 'inherit',
@@ -96,12 +113,12 @@ function runNodeCli(cliPath, argv) {
     child.on('error', reject);
     child.on('exit', (code, signal) => {
       if (signal) {
-        reject(new Error(`designer exited with signal ${signal}`));
+        reject(new Error(`${label} exited with signal ${signal}`));
         return;
       }
 
       if (code && code !== 0) {
-        const error = new Error(`designer exited with code ${code}`);
+        const error = new Error(`${label} exited with code ${code}`);
         error.exitCode = code;
         reject(error);
         return;
@@ -121,24 +138,31 @@ Usage:
   alanbox install --target codex|claude|both
   swarmer info
   swarmer doctor
+  swarmer review-file C:\\path\\to\\file.ts
   alanbox swarmer [options] --worker "codex:<role>:<prompt>"
   alanbox swarm [options] --worker "codex:<role>:<prompt>"
+  alanbox review-file C:\\path\\to\\file.ts
   swarmer [options] --worker "codex:<role>:<prompt>"
   alanbox designer <command> [options]
   designer <command> [options]
+  alanbox reporter weekly --path C:\\repo --user "Your Git Name"
+  reporter weekly --path C:\\repo --user "Your Git Name"
 
 Command groups:
   install, init, update          0boxer package/resource commands
   swarmer, swarm, doctor         1swarmer worker orchestration and provider diagnostics
   swarmer info                   1swarmer worker execution config check
   designer                       2designer runtime UI measurement CLI
+  reporter                       4reporter Git weekly report CLI
 
 Examples:
   swarmer info
   swarmer doctor
+  swarmer review-file C:\\repo\\src\\index.ts
   swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
   alanbox designer measure --url http://localhost:3000 --selector ".dialog"
   alanbox designer screenshot --url http://localhost:3000 --output page.png
+  reporter weekly --path C:\\repo --user "Your Git Name" --output weekly.md
 `);
 }
 
@@ -150,4 +174,5 @@ module.exports = {
   runSwarmerFlow,
   runSwarmer,
   runDesigner,
+  runReporter,
 };

package/mcp/README.md

@@ -2,4 +2,10 @@
 
 This directory is reserved for optional alanbox MCP resources.
 
-The installer copies this directory to Codex and Claude resource homes when present. No MCP server is implemented here yet; keep this placeholder so packaged installs still create the target `mcp/alanbox` directory.
+The installer copies this directory to Codex and Claude resource homes when present. No alanbox-owned MCP server is implemented here yet; keep this placeholder so packaged installs still create the target `mcp/alanbox` directory.
+
+For Codex installs, `alanbox install/init/update --target codex` also ensures the user's Codex MCP config has the bundled `mcp_servers.playwright` entry from `config.toml`. Existing Playwright MCP entries are left untouched.
+
+### Important files
+
+- `config.toml` — source MCP config fragment copied into Codex config only when `[mcp_servers.playwright]` is missing.

package/mcp/config.toml

@@ -0,0 +1,4 @@
+[mcp_servers.playwright]
+args = ["-y", "@playwright/mcp@0.0.76"]
+command = "npx"
+startup_timeout_sec = 120

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "alanbox",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Run isolated child Codex or Claude workers with serial, parallel, and auto swarm orchestration.",
   "main": "cli.js",
   "bin": {
     "alanbox": "bin/alanbox.js",
     "swarmer": "bin/swarmer.js",
-    "designer": "bin/designer.js"
+    "designer": "bin/designer.js",
+    "reporter": "bin/reporter.js"
   },
   "files": [
     "cli.js",
@@ -16,6 +17,8 @@
     "1swarmer/**",
     "2designer/package.json",
     "2designer/dist/**",
+    "4reporter/package.json",
+    "4reporter/dist/**",
     "skills/**",
     "plugin/**",
     "hooks/**",
@@ -28,8 +31,9 @@
     "swarm": "node bin/swarmer.js",
     "doctor": "node bin/alanbox.js doctor",
     "designer": "node bin/designer.js",
-    "test": "node bin/alanbox.js --help && node bin/alanbox.js swarmer info && node bin/swarmer.js info && node bin/swarmer.js doctor --help && node bin/designer.js --help",
-    "validate": "node bin/swarmer.js info && node bin/designer.js --help"
+    "reporter": "node bin/reporter.js",
+    "test": "node bin/alanbox.js --help && node bin/alanbox.js swarmer info && node bin/swarmer.js info && node bin/swarmer.js doctor --help && node bin/designer.js --help && node bin/reporter.js --help",
+    "validate": "node bin/swarmer.js info && node bin/designer.js --help && node bin/reporter.js --help"
   },
   "keywords": [
     "codex",

package/skills/AGENTS.md

@@ -1,6 +1,6 @@
 ## aibox skills
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills，按 `0boxer` 的安装命令作为统一安装源。当前用 `swarmer` 承载 `1swarmer` 的 `swarmer`/`swarm`、`info` 用法，用 `aitool` 作为 alanbox 总入口说明，并保留用户明确要求接入的 `2designer` UI 高精度还原 workflow；不要在这里接入 `3apiflower` 的 getapi，除非用户重新明确要求。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills，按 `0boxer` 的安装命令作为统一安装源。当前用 `swarmer` 承载 `1swarmer` 的 `swarmer`/`swarm`、`info` 用法，用 `aitool` 作为 alanbox 总入口说明，并保留用户明确要求接入的 `2designer` UI 高精度还原 workflow；不要在这里接入 `3apiflower` 的 `alan-utils` / `st`，除非用户重新明确要求。
 
 **Important:** skills 只写调用 workflow，不实现业务逻辑。worker 执行示例优先使用裸 `swarmer ...`；初始化和资源更新使用 `alanbox init` / `alanbox update`；本地源码调试才使用 `node bin/alanbox.js ...`。
 
@@ -10,12 +10,12 @@
 
 - `aitool/SKILL.md` — `alanbox` 总入口 skill；用于在 `swarmer`、`designer` 和安装/更新命令之间选择正确入口。
 - `swarmer/SKILL.md` — 合并后的 worker 编排、配置检查与 provider 诊断 skill；同时覆盖 `codex:`、`claude:` worker、串行/并行/auto workflow、`info` 和 `doctor`。
-- `desginer/SKILL.md` — `2designer` 的 UI 高精度还原 workflow；目录名当前按现状保留，内容通过 `designer` 的 `measure` / `screenshot` / `overlay` 命令做设计稿网站与运行页的像素级对比。
+- `desginer/SKILL.md` — `2designer` 的 UI 高精度还原 workflow；目录名当前按现状保留，内容通过 `designer` 的 `measure` / `screenshot` / `overlay` / `changelist` 命令做设计稿网站与运行页的像素级对比，并要求用 `all/message.md` 固定截图坐标、用 `regions\word\<id>` 调用 `codex:` 或 `claude:` 子 agent 并发生成组件树 TODO。
 
 ### Implementation notes
 
 - 新增或修改 CLI 参数时，同步检查对应 `SKILL.md` 示例。
 - `install` 会把本目录中含 `SKILL.md` 的子目录安装到 Codex 的 `~/.codex/skills`，以及 Claude 的 `~/.claude/skill`。
-- `desginer` 调用的是 `designer` CLI；更新 `2designer` 的命令名、参数或产物路径约定时，同步更新本目录同名 skill。
+- `desginer` 调用的是 `designer` CLI；更新 `2designer` 的命令名、参数或产物路径约定时，同步更新本目录同名 skill。UI 对齐流程的长期产物约定包括 `all\message.md`、每轮 `changelist.json`、`regions\word|graphic\<id>` 和合并后的组件树 `todo.json`。
 - `aibox-swarmer`、`sub-codex-swarmer`、`sub-codex-doctor` 已合并进 `swarmer`；安装/更新逻辑会清理这些旧 skill 名，避免用户环境里出现重复入口。
 - 不要把一次性本机 runId、账号、token、私有服务地址写进 skill。

package/skills/aitool/SKILL.md

@@ -13,7 +13,7 @@ description: 当需要使用 alanbox 这个本地 AI 工具包，并需要在 sw
 - provider 健康检查：使用 `alanbox doctor` 或 `swarmer doctor`，该命令归 `1swarmer`。
 - UI 高精度还原、运行页测量、截图、overlay 对比：使用 `designer` CLI；如果任务是按设计稿精修页面，优先使用当前安装的 UI 还原 skill。
 - 安装或更新 Codex/Claude 资源：使用 `alanbox init`、`alanbox update` 或 `alanbox install --target codex|claude|both`。
-- `3apiflower` API flow 当前不作为 `alanbox` npm 包公开命令；除非用户明确要求，不要把它接进 skills 或默认入口。
+- `3apiflower` API flow 当前作为独立本地 `alan-utils` / `st` 工作区维护，不作为 `alanbox` npm 包公开命令；除非用户明确要求，不要把它接进 skills 或默认入口。
 
 ## 常用命令
 

package/skills/desginer/SKILL.md

@@ -1,29 +1,27 @@
 ---
-name: ui-pixel-restore
-description: "当需要按 Axure、原型站或线上设计稿网站对现有运行页面做 UI 高精度还原时使用。要求用户提供运行页 URL、设计稿 URL、两边对应的 JS/CSS selector 路径，并通过 Chrome CDP + designer 的 measure/screenshot/overlay 循环做组件级像素重叠、TODO 修复和 1px 级验收。适用于不要凭截图臆测、必须用精确节点重叠和 getBoundingClientRect/getComputedStyle 数据追差异的任务。"
+name: desginer
+description: "设计稿到运行页面做 UI 高精度。"
 ---
-
 # UI 高精度还原：运行页 ↔ 设计稿网站
 
-目标是把一个已存在的页面或组件精确还原到 Axure/原型/设计稿网站的对应节点。你是判断和修复者；`designer` 只负责采集数据和生成叠图。
+目标是把一个运行页面精确还原到设计稿。`designer` 是运行页面精确还原到设计稿的工作流
 
-## 输入契约
+## 工作流输入要求
 
 开始改代码前，必须拿到这些信息；缺失时先向用户要，不要用整页或随机节点替代：
 
-- 运行页 URL：要修改、要还原的页面。
-- 运行页 selector/JS 路径：要截图、叠图、测量的精确组件节点。
-- 设计稿 URL：Axure/原型站/设计稿网页。
-- 设计稿 selector/JS 路径：与运行页对应的精确设计节点；如果在 iframe 里，同时记录 frame selector，例如 `#mainFrame`。
-- CDP 地址：默认按用户提供值使用，例如 `127.0.0.1:8000`。
+- 运行页 URL：要还原的运行页面。
+- 运行页 selector/JS 路径
+- 设计稿 URL：设计稿网页。
+- 设计稿 selector/JS 路径
+- CDP 地址：默认 `127.0.0.1:8000`。
 - 产物根目录：固定使用 `C:\Users\lenovo\Desktop\all-project\.tmp\<当天日期>-<hash>\`，每轮放在递增的 `round<N>\` 子目录，例如 `round1\`、`round2\`、`round3\`。
 
 优先使用用户提供的精确 JS 路径。`body > div:nth-child(...)` 这类路径只适合当前会话验证，不能当长期稳定 selector 写进代码。
 
-## Chrome/CDP
-
-需要连接用户当前登录态时，用独立调试端口启动 Chrome；端口、用户目录和初始 URL 按任务替换：
+## 工作流初始化
 
+用下方命令启动 Chrome页面；注意要一个页面两个tab,防止页面状态的丢失：
 ```powershell
 & "C:\Program Files\Google\Chrome\Application\chrome.exe" `
   --remote-debugging-address=127.0.0.1 `
@@ -37,13 +35,18 @@ description: "当需要按 Axure、原型站或线上设计稿网站对现有运
 
 遇到登录、权限、证书、白屏、网络拦截或需要人工操作的问题时，不要给最终失败结论。明确告诉用户在这个 Chrome 窗口处理，等待用户完成后继续同一轮测量和叠图。
 
-## 主循环
+初始化阶段必须创建 `C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\all\message.md`，把本次要截图和测量的锚点写进去。这个文件是后续所有轮次、Codex/Claude 子 agent 和 TODO 合并的共享契约，避免因为设计稿和运行页截图坐标不一致浪费轮次。至少记录：URL、selector、CDP 地址、初始截图坐标等信息。
 
+
+## 主循环
 先建立本次任务产物目录。日期用当天日期，hash 用运行页 URL、设计稿 URL 和两边 selector 生成短 hash；无法稳定生成时用 6-8 位随机短 hash。示例：
 
 ```text
 C:\Users\lenovo\Desktop\all-project\.tmp\2026-06-17-a1b2c3d4\
+  all\
+    message.md
   round1\
+    \regions\
     design.png
     runtime.png
     overlay.png
@@ -64,52 +67,63 @@ C:\Users\lenovo\Desktop\all-project\.tmp\2026-06-17-a1b2c3d4\
 按这个顺序循环，直到验收通过：
 
 1. **建立锚点。** 明确运行页 selector 对应设计稿 selector。组件级任务必须拿组件根节点对组件根节点，不要乱拿整页叠图。
-2. **生成本轮三图。** 在同一个 `round<N>\` 目录内一次性完成设计稿截图、运行页截图和重叠图；`<N>` 是当前循环轮次，第一轮用 `round1\`，修改后第二轮用 `round2\`，不得覆盖旧轮次。三张图缺任意一张，本轮无效，先补齐再分析。
+2. **生成本轮三图。** 在同一个 `round<N>\` 目录内一次性完成设计稿截图、运行页截图和重叠图；`<N>` 是当前循环轮次，第一轮用 `round1\`，修改后第二轮用 `round2\`，不得覆盖旧轮次。三张图缺任意一张，本轮无效，先补齐再分析。截图前先读取 `all\message.md`，确认本轮仍使用同一组组件根节点和坐标；如果运行页因交互状态导致 rect 改变，先更新 `all\message.md` 并说明原因。
    ```bash
    designer screenshot --url "<designUrl>" --selector "<designSelector>" --output "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\design.png" --cdp 127.0.0.1:8000
    designer screenshot --url "<runtimeUrl>" --selector "<runtimeSelector>" --output "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\runtime.png" --cdp 127.0.0.1:8000
    designer overlay --design "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\design.png" --url "<runtimeUrl>" --selector "<runtimeSelector>" --output "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\overlay.png" --cdp 127.0.0.1:8000
    ```
    如果设计节点在 Axure iframe 里，而 `screenshot` 暂不支持 `--frame`，用 Playwright/CDP 在 iframe document 内定位并截图该节点；产物仍命名为 `design.png`，后续继续用同一轮 `overlay` 命令。始终传 `--selector` 和 `--output`，让 `overlay` 以 headless 方式生成组件级像素合成图。设计图会以品红色覆盖到运行截图上；品红色明显错位处就是布局、尺寸、颜色或层级问题。
-3. **视觉差异分析。** 同时看本轮的 `design.png`、`runtime.png`、`overlay.png`：判断布局、颜色、层级、字号、边框、圆角、间距和文案。不要只看单张截图。
-4. **TODO 清单。** 把差异拆成可测项目，例如“标题 x 偏 8px”“表单项高度少 4px”“关联·评分标准（1:N）宽度不对”“某独立 path 节点造成真实间距”。
-5. **measure 定量。** 对 TODO 涉及的运行页节点和设计稿节点分别测量：
+3. **视觉差异分区。** 同时看本轮的 `design.png`、`runtime.png`、`overlay.png`：判断布局、颜色、层级、字号、边框、圆角、间距和文案。不要只看单张截图。每轮必须生成 `changelist.json`、全量对比图和区域目录：
+   ```bash
+   designer changelist --design "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\design.png" --runtime "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\runtime.png" --output "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\changelist.json" --annotated "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\changes.png" --regions-dir "C:\Users\lenovo\Desktop\all-project\.tmp\<yyyy-mm-dd>-<hash>\round<N>\regions"
+   ```
+   `changelist` 只输出变更区域 JSON 和设计稿/运行图左右并排的差异高亮对比图，用来快速定位需要进一步 `measure` 的节点；默认双模式下还会生成 `changes-word-sentence.png` 与 `changes-graphic-large.png`，并在 `regions\word\<id>`、`regions\graphic\<id>` 下为每个区域导出裁剪后的 `design.png`、`runtime.png`、`compare.png` 和 `region.json`。不要把它当成 UI 是否通过的唯一判断。
+4. (如果主布局未基本完成的跳过)**暴力并发生成 TODO。** 优先按 `regions\word\<id>` 拆分差异；如果 word 区域有 25 个，就启动 25 个独立 Codex/Claude 子 agent 并行分析，cdoex 每个子 agent 只负责一个区域目录，如果
+
+   每个 Codex/Claude 子 agent 只产出 JSON 片段，不直接改代码。片段写到当前轮临时文件，例如 `round<N>\todo-parts\word-<id>.json`；主 agent 负责合并。单个区域 JSON 片段必须按组件层级组织，类似 React 组件树，不要写平铺句子；具体格式见后文“子 agent JSON 片段格式”。
+
+   合并所有片段为 `round<N>\todo.json`。合并时按业务组件层级归并同名组件和子组件，去掉重复区域，只保留有证据的修改项；相同问题出现在多个区域时合并为一个组件 TODO，并在 `evidenceRegions` 中列出所有区。
+5. **分析修改定量。** 对合并后的 `todo.json` 做分析，测。先去重 `measureNeeded`，再对 TODO 涉及的运行页节点和设计稿节点分别测量：
    ```bash
    designer measure --url "<runtimeUrl>" --selector "<runtimeSelector>" --depth 0 --cdp 127.0.0.1:8000
    designer measure --url "<designUrl>" --selector "<designSelector>" --depth 0 --cdp 127.0.0.1:8000
    designer measure --url "<designUrl>" --frame "#mainFrame" --selector "#u0" --depth 0 --cdp 127.0.0.1:8000
    ```
-   `measure` 返回 `bbox` 与 `computedStyle`。必须用完整数据：bbox、font、color、background-color、border、padding、margin、display、visibility 缺失时重新测，不要用半截数据做判断。
+   `measure` 返回 `bbox` 与 `computedStyle`。必须用完整数据：bbox、font、color、background-color、border、padding、margin、display、visibility 缺失时重新测，不要用半截数据做判断。测量结果写回 `todo.json` 对应组件节点，形成“证据区域 → 组件层级 → 定量字段 → 修改建议”的闭环。
+
 6. **修改实现。** 按项目 AGENTS.md、公共组件规范和现有代码风格改。先修影响最大的位移和尺寸，再修字体、颜色、边框、圆角和细节。
 7. **重复验证。** 每次修改后重新执行“生成本轮三图”、`measure` 和 TODO 更新。不要在“感觉差不多”时停止。
 
-## Axure/原型测量规则
-
-- Axure 里有些节点是独立 path 节点，没有布局容器。计算间距时必须测量相邻组件的 `rect`，用坐标差值反推这些节点的实际占位。
-- 设计稿 iframe 节点按这种逻辑测：
-  ```js
-  const iframe = document.getElementById("mainFrame");
-  const doc = iframe.contentDocument;
-  const win = iframe.contentWindow;
-  const node = doc.querySelector("#uNNN");
-  const cs = win.getComputedStyle(node);
-  return {
-    rect: node.getBoundingClientRect(),
-    font: cs.font,
-    color: cs.color,
-    bg: cs.backgroundColor,
-    border: cs.border,
-    padding: cs.padding,
-    margin: cs.margin,
-  };
-  ```
-- 对比标题、表单项、按钮、状态栏这类节点时，不只量外层；必要时继续量文本叶子节点、图标节点和相邻节点。
+## 子 agent JSON 片段格式
+
+每个 Codex/Claude 子 agent 只产出 JSON 片段，不直接改代码。片段写到当前轮临时文件，例如 `round<N>\todo-parts\word-<id>.json`；主 agent 负责合并。单个区域 JSON 片段必须按组件层级组织，类似 React 组件树，不要写平铺句子：
+
+```json
+{
+  "sourceRegion": "regions/word/1",
+  "components": {
+    "开发页面的xx1组件": {
+      "selectorGuess": "",
+      "evidence": ["region.json", "compare.png"],
+      "todo": ["要怎么修改","不需要修改,设计稿合理误差"],
+      "children": {
+        "xx1的子组件xx2": {
+          "selectorGuess": "",
+          "todo": ["要怎么修改"],
+          "measureNeeded": [
+            { "runtimeSelector": "", "designSelector": "", "reason": "需要定量确认 x/width/font" }
+          ]
+        }
+      }
+    }
+  }
+}
+```
 
-## 实践约束
+## 测量规则
 
-- **padding 放在卡片外层，不放在内容槽。** 卡片内同时有 `XTitle` + 内容时，padding 只加在内容 div 上，会让标题贴到卡片左边沿。标准形状：外层 `rounded bg-white px-* pb-*` → `XTitle` → 内容 div 只保留布局类（`min-h-0 flex-1`）。
-- **独立节点。** Axure 中部分节点是独立 path 节点，无布局容器。计算间距时必须测量相邻组件的 rect，用坐标差值反推这些节点的实际占位。
-- **组件自带 chrome。** 以“卡片”形态交付的组件已自带边框、圆角、标题槽、状态栏等装饰件。外层再套 `<div className="rounded bg-white">`、或手写 `{rows.length} 条`，都会重复 chrome 并与组件内部状态脱节。各组件可配置的槽位与开关：`XDataGrid`（`title`、`StatusBarExtra`、`noBorderRadius`、`noRecordCountInStatusBar`、`noSelectRowCountInStatusBar`、`hideStatusBar`、`hideHead`）；`XDraggableModal`（`title`、`titleIcon`、`hideDefaultTitleIcon`、`hiddenTitle`、`layoutMode`、`noFrame`）；`XSelector`（`statusBarExtra`）。在组件外层做组合前，先检查它暴露的槽；`.windsurf/skills/xinherc/` 与 `./Spec/组件库规范/api-docs/<Name>.md` 是真理来源。
+默认用 `measure` 测量节点的 `getBoundingClientRect()` 和 `getComputedStyle()`，并对比两边的 bbox、font、color、background-color、border、padding、margin、display、visibility。如果measure无法测量时用playwright MCP 兜底。
 
 ## 验收条件
 
@@ -117,6 +131,12 @@ C:\Users\lenovo\Desktop\all-project\.tmp\2026-06-17-a1b2c3d4\
 
 - 可控关键节点的 `bbox` 位置和尺寸与设计稿差异达到 1px 以内，并且 `overlay.png` 没有明显品红错位。
 - 剩余差异来自公共组件库不可修改的内部 chrome、渲染机制或浏览器字体差异，并且已经用 `measure` 证明差异来源。
-- 剩余差异符合项目 AGENTS.md、公共组件规范或上面的实践约束，且说明具体原因和影响范围。
+- 剩余差异符合项目 AGENTS.md、公共组件规范或上面的实践约束，设计稿的不完善和设计稿不可以避免的不对齐，且说明具体原因和影响范围。
 
 最终汇报要包含：使用的运行页/设计稿 selector、最后一轮 `design/runtime/overlay` 文件路径、已修 TODO、未修差异及其验收理由。
+
+## 实践约束
+
+- **padding 放在卡片外层，不放在内容槽。** 卡片内同时有 `XTitle` + 内容时，padding 只加在内容 div 上，会让标题贴到卡片左边沿。标准形状：外层 `rounded bg-white px-* pb-*` → `XTitle` → 内容 div 只保留布局类（`min-h-0 flex-1`）。
+- **独立节点。** Axure 中部分节点是独立 path 节点，无布局容器。计算间距时必须测量相邻组件的 rect，用坐标差值反推这些节点的实际占位。
+- **组件自带 chrome。** 以“卡片”形态交付的组件已自带边框、圆角、标题槽、状态栏等装饰件。

package/skills/swarmer/SKILL.md

@@ -13,6 +13,7 @@ description: 当 Codex 或 Claude 需要通过 alanbox 的 swarmer/swarm 调用
 swarmer info
 alanbox doctor
 swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+swarmer review-file "C:\path\to\file-or-dir"
 ```
 
 `swarmer` 是对外稳定入口，内部走 `swarm` 执行链路。包级命令也可以写成：
@@ -20,6 +21,7 @@ swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
 ```powershell
 alanbox swarmer info
 alanbox swarm --namespace run-name --worker "codex:reviewer:检查当前改动"
+alanbox review-file "C:\path\to\file-or-dir"
 ```
 
 ## Worker 规格
@@ -80,6 +82,40 @@ swarmer --auto "检查这个项目的主要风险" -a "codex:reviewer:检查代
 swarmer --resume <runId> --namespace <namespace> -y
 ```
 
+## 双 CLI 文件 review
+
+当需要 Codex CLI 和 Claude CLI 同时审查一个文件或目录，并把报告写到一个 Markdown 文件时，使用专用命令：
+
+```powershell
+swarmer review-file "C:\repo\src\index.ts"
+```
+
+默认行为：
+
+- 第一阶段并行调用 `codex` 和 `claude` 初审同一目标，并各自生成 `*.codex.initial.md` / `*.claude.initial.md` sidecar。
+- 第二阶段从 sidecar 初审 md 读取 `[codex√] 检查出的内容`、`[claude√] 检查出的内容`，再合并到主报告。
+- 后续复核直接追加链条标记：认同写成 `[codex√claude√]`，不认同写成 `[codex√claude❌]`，出现 `❌` 后继续让下一方复核，例如 `[codex√claude❌codex√]`。
+- 共识链最后必须为 `√`；超过最大轮次仍未达成时，会追加强制最终 `√` 并保留前面 `❌` 的原因供人工复查。
+- 报告文件默认为 `C:\Users\lenovo\Desktop\all-project\.tmp\swarm\<yyyy-mm-dd-HHmmss>-<hash>.md`。
+
+长任务或某个 provider 超时时，可以分阶段恢复：
+
+```powershell
+swarmer review-file "C:\repo\src" --phase initial --providers codex,claude
+swarmer review-file "C:\repo\src" --phase cross-check --report-file "C:\Users\lenovo\Desktop\all-project\.tmp\swarm\2026-06-18-161626-xxxxxxxx.md"
+```
+
+可用参数：
+
+- `--providers codex,claude` 指定参与执行的 provider。
+- `--review-kind defects|improvements` 指定审查类型；未传时会从 `--context` 中的“改进/优化/性能/可维护”等词自动推断。
+- `--report-file <path>` 复用或指定单个 Markdown 报告文件，常用于只补跑 cross-check。
+- `--report-dir <path>` 指定目录，CLI 会在里面生成一个新的时间哈希 Markdown 文件。
+- `--max-consensus-rounds <n>` 限制 `❌` 条目继续复核的最大轮数；默认 4，之后会按协议追加最终 `√`。
+- `--claude-permission-mode <mode>` 覆盖 Claude 权限模式；默认是 `bypassPermissions`，用于避免非交互读取文件时卡住。
+- `--no-claude-safe-mode` 关闭默认传给 Claude 的 `--safe-mode`；默认开启 safe mode，以减少本机 hooks/plugins 对自动化 review 的干扰。
+- `--claude-effort <level>` 覆盖 Claude effort；默认是 `low`，用于让自动化 review 可及时返回。
+
 ## 诊断
 
 修改配置、排查 provider、账户主目录、沙箱、命令路径或子 worker 健康状态前，先看已解析配置：
@@ -107,3 +143,4 @@ alanbox doctor --account codex-19b
 ```
 
 `%USERPROFILE%\.multirunagent` 是兼容存储路径，不要因为命令名改成 `swarmer` 就改写这个路径。
+`review-file` 是例外：它按用户要求把单个 Markdown review 报告写入 `C:\Users\lenovo\Desktop\all-project\.tmp\swarm` 或 `--report-root` / `--report-file` / `--report-dir` 指定位置。

package/2designer/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Zhiyu Fang
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/2designer/dist/chunk-SKEIVBOU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/overlay/tint.ts"],"sourcesContent":["import sharp from 'sharp'\r\n\r\nexport type TintMode = 'magenta' | 'ghost' | 'difference'\r\n\r\n/**\r\n * Process a design image for overlay compositing.\r\n *\r\n * Modes:\r\n * - 'magenta': Tint non-white pixels magenta (best for white/light backgrounds)\r\n * - 'ghost': Reduce opacity uniformly (works on any background color)\r\n * - 'difference': No preprocessing — caller should use 'difference' blend mode\r\n *\r\n * Returns a PNG buffer with alpha channel.\r\n */\r\nexport async function tintDesignImage(\r\n  imagePath: string,\r\n  mode: TintMode = 'auto' as any,\r\n): Promise<Buffer> {\r\n  const { data, info } = await sharp(imagePath)\r\n    .ensureAlpha()\r\n    .raw()\r\n    .toBuffer({ resolveWithObject: true })\r\n\r\n  const pixels = new Uint8Array(data.buffer)\r\n\r\n  // Auto-detect: check if background is white/light\r\n  const resolvedMode = mode === ('auto' as any) ? detectMode(pixels) : mode\r\n\r\n  if (resolvedMode === 'magenta') {\r\n    return tintMagenta(pixels, info)\r\n  }\r\n\r\n  if (resolvedMode === 'difference') {\r\n    // Return as-is for difference blend\r\n    return sharp(imagePath).ensureAlpha().png().toBuffer()\r\n  }\r\n\r\n  // ghost mode: uniform opacity reduction\r\n  return tintGhost(pixels, info, 0.4)\r\n}\r\n\r\nfunction detectMode(pixels: Uint8Array): TintMode {\r\n  // Sample corners + edges to detect background color\r\n  // If most sampled pixels are bright (>220), use magenta mode\r\n  // Otherwise use ghost mode\r\n  let brightCount = 0\r\n  const sampleSize = Math.min(pixels.length / 4, 1000)\r\n  const step = Math.floor(pixels.length / 4 / sampleSize)\r\n\r\n  for (let i = 0; i < sampleSize; i++) {\r\n    const idx = i * step * 4\r\n    const brightness = (pixels[idx] + pixels[idx + 1] + pixels[idx + 2]) / 3\r\n    if (brightness > 220) brightCount++\r\n  }\r\n\r\n  return (brightCount / sampleSize) > 0.5 ? 'magenta' : 'ghost'\r\n}\r\n\r\nconst LIGHT_THRESHOLD = 230\r\nconst MAGENTA: [number, number, number] = [220, 40, 160]\r\n\r\nfunction tintMagenta(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n): Promise<Buffer> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\r\n    const r = pixels[i], g = pixels[i + 1], b = pixels[i + 2]\r\n    const brightness = (r + g + b) / 3\r\n\r\n    if (brightness > LIGHT_THRESHOLD) {\r\n      pixels[i + 3] = 0\r\n    } else {\r\n      const darkness = 1 - brightness / 255\r\n      pixels[i] = MAGENTA[0]\r\n      pixels[i + 1] = MAGENTA[1]\r\n      pixels[i + 2] = MAGENTA[2]\r\n      pixels[i + 3] = Math.round(darkness * 200)\r\n    }\r\n  }\r\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n\r\nfunction tintGhost(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n  opacity: number,\r\n): Promise<Buffer> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\r\n    pixels[i + 3] = Math.round(pixels[i + 3] * opacity)\r\n  }\r\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n"],"mappings":";AAAA,OAAO,WAAW;AAclB,eAAsB,gBACpB,WACA,OAAiB,QACA;AACjB,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM,MAAM,SAAS,EACzC,YAAY,EACZ,IAAI,EACJ,SAAS,EAAE,mBAAmB,KAAK,CAAC;AAEvC,QAAM,SAAS,IAAI,WAAW,KAAK,MAAM;AAGzC,QAAM,eAAe,SAAU,SAAiB,WAAW,MAAM,IAAI;AAErE,MAAI,iBAAiB,WAAW;AAC9B,WAAO,YAAY,QAAQ,IAAI;AAAA,EACjC;AAEA,MAAI,iBAAiB,cAAc;AAEjC,WAAO,MAAM,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS;AAAA,EACvD;AAGA,SAAO,UAAU,QAAQ,MAAM,GAAG;AACpC;AAEA,SAAS,WAAW,QAA8B;AAIhD,MAAI,cAAc;AAClB,QAAM,aAAa,KAAK,IAAI,OAAO,SAAS,GAAG,GAAI;AACnD,QAAM,OAAO,KAAK,MAAM,OAAO,SAAS,IAAI,UAAU;AAEtD,WAAS,IAAI,GAAG,IAAI,YAAY,KAAK;AACnC,UAAM,MAAM,IAAI,OAAO;AACvB,UAAM,cAAc,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK;AACvE,QAAI,aAAa,IAAK;AAAA,EACxB;AAEA,SAAQ,cAAc,aAAc,MAAM,YAAY;AACxD;AAEA,IAAM,kBAAkB;AACxB,IAAM,UAAoC,CAAC,KAAK,IAAI,GAAG;AAEvD,SAAS,YACP,QACA,MACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC;AACxD,UAAM,cAAc,IAAI,IAAI,KAAK;AAEjC,QAAI,aAAa,iBAAiB;AAChC,aAAO,IAAI,CAAC,IAAI;AAAA,IAClB,OAAO;AACL,YAAM,WAAW,IAAI,aAAa;AAClC,aAAO,CAAC,IAAI,QAAQ,CAAC;AACrB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,KAAK,MAAM,WAAW,GAAG;AAAA,IAC3C;AAAA,EACF;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;AAEA,SAAS,UACP,QACA,MACA,SACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,WAAO,IAAI,CAAC,IAAI,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,OAAO;AAAA,EACpD;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;","names":[]}

package/2designer/dist/tint-I3FTT23O.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/overlay/tint.ts"],"sourcesContent":["import sharp from 'sharp'\r\n\r\nexport type TintMode = 'magenta' | 'ghost' | 'difference'\r\n\r\n/**\r\n * Process a design image for overlay compositing.\r\n *\r\n * Modes:\r\n * - 'magenta': Tint non-white pixels magenta (best for white/light backgrounds)\r\n * - 'ghost': Reduce opacity uniformly (works on any background color)\r\n * - 'difference': No preprocessing — caller should use 'difference' blend mode\r\n *\r\n * Returns a PNG buffer with alpha channel.\r\n */\r\nexport async function tintDesignImage(\r\n  imagePath: string,\r\n  mode: TintMode = 'auto' as any,\r\n): Promise<Buffer> {\r\n  const { data, info } = await sharp(imagePath)\r\n    .ensureAlpha()\r\n    .raw()\r\n    .toBuffer({ resolveWithObject: true })\r\n\r\n  const pixels = new Uint8Array(data.buffer)\r\n\r\n  // Auto-detect: check if background is white/light\r\n  const resolvedMode = mode === ('auto' as any) ? detectMode(pixels) : mode\r\n\r\n  if (resolvedMode === 'magenta') {\r\n    return tintMagenta(pixels, info)\r\n  }\r\n\r\n  if (resolvedMode === 'difference') {\r\n    // Return as-is for difference blend\r\n    return sharp(imagePath).ensureAlpha().png().toBuffer()\r\n  }\r\n\r\n  // ghost mode: uniform opacity reduction\r\n  return tintGhost(pixels, info, 0.4)\r\n}\r\n\r\nfunction detectMode(pixels: Uint8Array): TintMode {\r\n  // Sample corners + edges to detect background color\r\n  // If most sampled pixels are bright (>220), use magenta mode\r\n  // Otherwise use ghost mode\r\n  let brightCount = 0\r\n  const sampleSize = Math.min(pixels.length / 4, 1000)\r\n  const step = Math.floor(pixels.length / 4 / sampleSize)\r\n\r\n  for (let i = 0; i < sampleSize; i++) {\r\n    const idx = i * step * 4\r\n    const brightness = (pixels[idx] + pixels[idx + 1] + pixels[idx + 2]) / 3\r\n    if (brightness > 220) brightCount++\r\n  }\r\n\r\n  return (brightCount / sampleSize) > 0.5 ? 'magenta' : 'ghost'\r\n}\r\n\r\nconst LIGHT_THRESHOLD = 230\r\nconst MAGENTA: [number, number, number] = [220, 40, 160]\r\n\r\nfunction tintMagenta(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n): Promise<Buffer> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\r\n    const r = pixels[i], g = pixels[i + 1], b = pixels[i + 2]\r\n    const brightness = (r + g + b) / 3\r\n\r\n    if (brightness > LIGHT_THRESHOLD) {\r\n      pixels[i + 3] = 0\r\n    } else {\r\n      const darkness = 1 - brightness / 255\r\n      pixels[i] = MAGENTA[0]\r\n      pixels[i + 1] = MAGENTA[1]\r\n      pixels[i + 2] = MAGENTA[2]\r\n      pixels[i + 3] = Math.round(darkness * 200)\r\n    }\r\n  }\r\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n\r\nfunction tintGhost(\r\n  pixels: Uint8Array,\r\n  info: { width: number; height: number },\r\n  opacity: number,\r\n): Promise<Buffer> {\r\n  for (let i = 0; i < pixels.length; i += 4) {\r\n    pixels[i + 3] = Math.round(pixels[i + 3] * opacity)\r\n  }\r\n\r\n  return sharp(Buffer.from(pixels.buffer), {\r\n    raw: { width: info.width, height: info.height, channels: 4 },\r\n  })\r\n    .png()\r\n    .toBuffer()\r\n}\r\n"],"mappings":";;;;AAAA,OAAO,WAAW;AAclB,eAAsB,gBACpB,WACA,OAAiB,QACA;AACjB,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM,MAAM,SAAS,EACzC,YAAY,EACZ,IAAI,EACJ,SAAS,EAAE,mBAAmB,KAAK,CAAC;AAEvC,QAAM,SAAS,IAAI,WAAW,KAAK,MAAM;AAGzC,QAAM,eAAe,SAAU,SAAiB,WAAW,MAAM,IAAI;AAErE,MAAI,iBAAiB,WAAW;AAC9B,WAAO,YAAY,QAAQ,IAAI;AAAA,EACjC;AAEA,MAAI,iBAAiB,cAAc;AAEjC,WAAO,MAAM,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS;AAAA,EACvD;AAGA,SAAO,UAAU,QAAQ,MAAM,GAAG;AACpC;AAEA,SAAS,WAAW,QAA8B;AAIhD,MAAI,cAAc;AAClB,QAAM,aAAa,KAAK,IAAI,OAAO,SAAS,GAAG,GAAI;AACnD,QAAM,OAAO,KAAK,MAAM,OAAO,SAAS,IAAI,UAAU;AAEtD,WAAS,IAAI,GAAG,IAAI,YAAY,KAAK;AACnC,UAAM,MAAM,IAAI,OAAO;AACvB,UAAM,cAAc,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK;AACvE,QAAI,aAAa,IAAK;AAAA,EACxB;AAEA,SAAQ,cAAc,aAAc,MAAM,YAAY;AACxD;AAEA,IAAM,kBAAkB;AACxB,IAAM,UAAoC,CAAC,KAAK,IAAI,GAAG;AAEvD,SAAS,YACP,QACA,MACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,UAAM,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC;AACxD,UAAM,cAAc,IAAI,IAAI,KAAK;AAEjC,QAAI,aAAa,iBAAiB;AAChC,aAAO,IAAI,CAAC,IAAI;AAAA,IAClB,OAAO;AACL,YAAM,WAAW,IAAI,aAAa;AAClC,aAAO,CAAC,IAAI,QAAQ,CAAC;AACrB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,QAAQ,CAAC;AACzB,aAAO,IAAI,CAAC,IAAI,KAAK,MAAM,WAAW,GAAG;AAAA,IAC3C;AAAA,EACF;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;AAEA,SAAS,UACP,QACA,MACA,SACiB;AACjB,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,WAAO,IAAI,CAAC,IAAI,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,OAAO;AAAA,EACpD;AAEA,SAAO,MAAM,OAAO,KAAK,OAAO,MAAM,GAAG;AAAA,IACvC,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,UAAU,EAAE;AAAA,EAC7D,CAAC,EACE,IAAI,EACJ,SAAS;AACd;","names":[]}

package/2designer/dist/tint-RUSSUAWA.js

@@ -1,7 +0,0 @@
-import {
-  tintDesignImage
-} from "./chunk-SKEIVBOU.js";
-export {
-  tintDesignImage
-};
-//# sourceMappingURL=tint-RUSSUAWA.js.map