alanbox 0.1.1 → 0.1.3

package/skills/desginer/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: ui-pixel-restore
+description: "当需要按 Axure、原型站或线上设计稿网站对现有运行页面做 UI 高精度还原时使用。要求用户提供运行页 URL、设计稿 URL、两边对应的 JS/CSS selector 路径，并通过 Chrome CDP + designer 的 measure/screenshot/overlay 循环做组件级像素重叠、TODO 修复和 1px 级验收。适用于不要凭截图臆测、必须用精确节点重叠和 getBoundingClientRect/getComputedStyle 数据追差异的任务。"
+---
+
+# UI 高精度还原：运行页 ↔ 设计稿网站
+
+目标是把一个已存在的页面或组件精确还原到 Axure/原型/设计稿网站的对应节点。你是判断和修复者；`designer` 只负责采集数据和生成叠图。
+
+## 输入契约
+
+开始改代码前，必须拿到这些信息；缺失时先向用户要，不要用整页或随机节点替代：
+
+- 运行页 URL：要修改、要还原的页面。
+- 运行页 selector/JS 路径：要截图、叠图、测量的精确组件节点。
+- 设计稿 URL：Axure/原型站/设计稿网页。
+- 设计稿 selector/JS 路径：与运行页对应的精确设计节点；如果在 iframe 里，同时记录 frame selector，例如 `#mainFrame`。
+- 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 按任务替换：
+
+```powershell
+& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
+  --remote-debugging-address=127.0.0.1 `
+  --remote-debugging-port=8000 `
+  --user-data-dir="C:\Users\lenovo\AppData\Local\Temp\codex-chrome-debug-ui" `
+  --no-first-run `
+  --no-default-browser-check `
+  --ignore-certificate-errors `
+  "<INITIAL_LOGIN_OR_RUNTIME_URL>"
+```
+
+遇到登录、权限、证书、白屏、网络拦截或需要人工操作的问题时，不要给最终失败结论。明确告诉用户在这个 Chrome 窗口处理，等待用户完成后继续同一轮测量和叠图。
+
+## 主循环
+
+先建立本次任务产物目录。日期用当天日期，hash 用运行页 URL、设计稿 URL 和两边 selector 生成短 hash；无法稳定生成时用 6-8 位随机短 hash。示例：
+
+```text
+C:\Users\lenovo\Desktop\all-project\.tmp\2026-06-17-a1b2c3d4\
+  round1\
+    design.png
+    runtime.png
+    overlay.png
+  round2\
+    design.png
+    runtime.png
+    overlay.png
+```
+
+每一轮必须至少有 3 张图片：
+
+- `design.png`：设计稿节点截图。
+- `runtime.png`：运行页节点截图。
+- `overlay.png`：设计稿以品红色覆盖到运行页后的重叠图。
+
+测量 JSON 可以放在同一轮目录下，例如 `measure-design.json`、`measure-runtime.json`，但不能替代这 3 张图片。
+
+按这个顺序循环，直到验收通过：
+
+1. **建立锚点。** 明确运行页 selector 对应设计稿 selector。组件级任务必须拿组件根节点对组件根节点，不要乱拿整页叠图。
+2. **生成本轮三图。** 在同一个 `round<N>\` 目录内一次性完成设计稿截图、运行页截图和重叠图；`<N>` 是当前循环轮次，第一轮用 `round1\`，修改后第二轮用 `round2\`，不得覆盖旧轮次。三张图缺任意一张，本轮无效，先补齐再分析。
+   ```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 涉及的运行页节点和设计稿节点分别测量：
+   ```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 缺失时重新测，不要用半截数据做判断。
+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,
+  };
+  ```
+- 对比标题、表单项、按钮、状态栏这类节点时，不只量外层；必要时继续量文本叶子节点、图标节点和相邻节点。
+
+## 实践约束
+
+- **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` 是真理来源。
+
+## 验收条件
+
+满足任一条件才算完成：
+
+- 可控关键节点的 `bbox` 位置和尺寸与设计稿差异达到 1px 以内，并且 `overlay.png` 没有明显品红错位。
+- 剩余差异来自公共组件库不可修改的内部 chrome、渲染机制或浏览器字体差异，并且已经用 `measure` 证明差异来源。
+- 剩余差异符合项目 AGENTS.md、公共组件规范或上面的实践约束，且说明具体原因和影响范围。
+
+最终汇报要包含：使用的运行页/设计稿 selector、最后一轮 `design/runtime/overlay` 文件路径、已修 TODO、未修差异及其验收理由。

package/skills/swarmer/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: swarmer
+description: 当 Codex 或 Claude 需要通过 alanbox 的 swarmer/swarm 调用子 worker、串行/并行/自动规划工作流，或通过 swarmer info 检查 worker 配置时使用。
+---
+
+# swarmer
+
+本 skill 是 `alanbox` 的 worker 编排、配置检查和 provider 诊断入口。它只指导如何调用 CLI；真实执行、隔离账户、handoff、结果写入和 provider 调用都由 `swarmer` / `alanbox` 完成。
+
+## 快速入口
+
+```powershell
+swarmer info
+alanbox doctor
+swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+```
+
+`swarmer` 是对外稳定入口，内部走 `swarm` 执行链路。包级命令也可以写成：
+
+```powershell
+alanbox swarmer info
+alanbox swarm --namespace run-name --worker "codex:reviewer:检查当前改动"
+```
+
+## Worker 规格
+
+Worker 规格格式：
+
+```text
+<platform-or-worker>:<role>:<prompt>
+```
+
+常用示例：
+
+```powershell
+swarmer --namespace codex-check --worker "codex:reviewer:复核 src 目录的正确性问题"
+swarmer --namespace claude-check --worker "claude:reviewer:复核 src 目录的正确性问题"
+```
+
+## 串行、并行和混合阶段
+
+后一个 worker 必须读取前一个 worker 的结论时，重复传 `--worker`：
+
+```powershell
+swarmer --namespace staged-review --worker "codex:lead:先分析问题范围" --worker "claude:reviewer:基于上游结论复核"
+```
+
+全部 worker 都彼此独立时，使用 `--parallel-workers`：
+
+```powershell
+swarmer --namespace parallel-review --parallel-workers --worker "codex:a:检查前端" --worker "claude:b:检查脚本"
+```
+
+混合串行/并行阶段时，用方括号表示同一阶段并行：
+
+```powershell
+swarmer --namespace mixed-review --worker "codex:lead:先拆分任务" --worker "[codex:frontend:检查前端,claude:backend:检查后端]" --worker "codex:summary:汇总结论"
+```
+
+上例执行顺序是 `lead -> [frontend,backend] -> summary`。方括号内用英文逗号分隔；如果 prompt 里必须出现字面逗号，写成 `\,`。
+
+## 自动 workflow
+
+需要 CLI 先推荐 workflow，再确认执行时：
+
+```powershell
+swarmer --auto "检查这个项目的主要风险" -a "codex:reviewer:检查代码正确性" -a "claude:reviewer:检查可维护性" -p "优先按目录拆分"
+```
+
+自动 workflow 规则：
+
+- `-a` / `--agent` 是可重复的 agent 规格；如需隔离账户，使用 `--account`。
+- `-p` / `--plan-hint` 是规划指引；如需 Codex profile，使用 `--profile`。
+- auto workflow 会调用真实 provider；已无 dry-run 预览。
+- 不带 `-y` 时，CLI 会先推荐工作流并等待确认后才运行真实 worker。
+
+非交互恢复待执行 workflow：
+
+```powershell
+swarmer --resume <runId> --namespace <namespace> -y
+```
+
+## 诊断
+
+修改配置、排查 provider、账户主目录、沙箱、命令路径或子 worker 健康状态前，先看已解析配置：
+
+```powershell
+swarmer info
+swarmer info --worker worker-e7
+```
+
+需要运行 provider CLI 健康检查时：
+
+```powershell
+alanbox doctor
+alanbox doctor --account codex-19b
+```
+
+## 读取结果
+
+真实运行后读取输出：
+
+```text
+%USERPROFILE%\.multirunagent\<namespace>\results\
+%USERPROFILE%\.multirunagent\<namespace>\memory\index.json
+%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>\
+```
+
+`%USERPROFILE%\.multirunagent` 是兼容存储路径，不要因为命令名改成 `swarmer` 就改写这个路径。

package/bin/multirunagent.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * multirunagent 的包命令入口。
- * bin 层保持很薄，只把命令处理交给 0commondflowv1/src/cli.js。
- */
-
-require('../0commondflowv1/src/cli').main().catch((error) => {
-  console.error(error.message || error);
-  process.exitCode = 1;
-});
-
-
-
-

package/skills/aibox-swam/SKILL.md

@@ -1,77 +0,0 @@
----
-name: aibox-swam
-description: 当 Codex 或 Claude 需要通过 alanbox 调用 swam/swarm 执行 Codex 或 Claude 子 worker 时使用。
----
-
-# aibox swam workflow
-
-本 skill 只负责指导调用 alanbox 的 `swam`/`swarm` 命令。真实执行由 CLI 完成；不要在 skill 内复制实现逻辑。
-
-## 入口
-
-```powershell
-alanbox swam --namespace run-name --worker "codex:reviewer:检查当前改动"
-```
-
-`swam` 是 `swarm` 的兼容别名；两者走同一条执行链路。
-
-## 调用 Codex worker
-
-```powershell
-alanbox swam --namespace codex-check --worker "codex:reviewer:复核 src 目录的正确性问题"
-```
-
-## 调用 Claude worker
-
-```powershell
-alanbox swam --namespace claude-check --worker "claude:reviewer:复核 src 目录的正确性问题"
-```
-
-## 串行和并行
-
-后一个 worker 需要读取前一个 worker 的结论时，重复传 `--worker`：
-
-```powershell
-alanbox swam --namespace staged-review --worker "codex:lead:先分析问题范围" --worker "claude:reviewer:基于上游结论复核"
-```
-
-多个 worker 可以独立执行时，使用 `--parallel-workers`：
-
-```powershell
-alanbox swam --namespace parallel-review --parallel-workers --worker "codex:a:检查前端" --worker "claude:b:检查脚本"
-```
-
-混合串行/并行阶段时，用方括号表示同一阶段并行：
-
-```powershell
-alanbox swam --namespace mixed-review --worker "codex:lead:先拆分任务" --worker "[codex:frontend:检查前端,claude:backend:检查后端]" --worker "codex:summary:汇总结论"
-```
-
-## 自动 workflow
-
-需要 CLI 先推荐 workflow，再确认执行时：
-
-```powershell
-alanbox swam --auto "检查这个项目的主要风险" -a "codex:reviewer:检查代码正确性" -a "claude:reviewer:检查可维护性" -p "优先按目录拆分"
-```
-
-非交互恢复待执行 workflow：
-
-```powershell
-alanbox swam --resume <runId> --namespace <namespace> -y
-```
-
-## 读取结果
-
-```text
-%USERPROFILE%\.multirunagent\<namespace>\results\
-%USERPROFILE%\.multirunagent\<namespace>\memory\index.json
-%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>\
-```
-
-如果只是诊断配置，先用：
-
-```powershell
-alanbox info
-alanbox doctor
-```

package/skills/sub-codex-doctor/SKILL.md

@@ -1,27 +0,0 @@
----
-name: sub-codex-doctor
-description: 当 Codex 或 Claude 需要检查或诊断本地 alanbox 包、worker 配置、账户主目录、CLI 命令路径、沙箱或子 worker 健康状况时使用。
----
-
-# alanbox 诊断（Doctor）
-
-检查已解析的配置：
-
-```powershell
-alanbox info
-```
-
-通过 alanbox 运行 provider CLI 健康检查：
-
-```powershell
-alanbox doctor
-```
-
-指定某个账户或 worker：
-
-```powershell
-alanbox info --worker worker-e7
-alanbox doctor --account codex-19b
-```
-
-修改配置前优先运行 `info`。当子 Codex 命令、鉴权、网络、MCP 或状态存储可能出现故障时，使用 `doctor`。

package/skills/sub-codex-swarm/SKILL.md

@@ -1,56 +0,0 @@
----
-name: sub-codex-swarm
-description: 当 Codex 或 Claude 需要使用 alanbox 的 swam/swarm 串行、并行或自动 GOAP 工作流规划，并在真实子 worker 运行前进行确认时使用。
----
-
-# alanbox 集群（swam/swarm）
-
-当后续 worker 必须基于先前结果展开时，使用串行 swarm：
-
-```powershell
-alanbox swam --namespace run-name --worker "codex:lead:主分析任务" --worker "claude:reviewer:基于上游结果复核"
-```
-
-`swam` 是 `swarm` 的兼容别名，两者走同一条执行链路。
-
-需要混合串行和并行阶段时，在一个 `--worker` 参数中用方括号包住同一阶段的多个 worker：
-
-```powershell
-alanbox swam --namespace run-name --worker "codex:a:先分析 A" --worker "[codex:c:并行检查 C,claude:d:并行检查 D]" --worker "codex:e:基于 C 和 D 汇总"
-```
-
-上例执行顺序是 `a -> [c,d] -> e`。方括号内用英文逗号分隔；如果 prompt 里必须出现字面逗号，写成 `\,`。
-
-Worker 规格格式：
-
-```text
-<worker-or-platform>:<role>:<prompt>
-```
-
-当用户给出自然语言目标、并希望 CLI 先推荐一个工作流时，使用自动工作流：
-
-```powershell
-alanbox swam --auto "帮我检查我的项目有问题" -a "codex:reviewer:复核当前项目代码" -a "claude:reviewer:复核可维护性" -p "最好每个子文件夹一个子agent并行"
-```
-
-自动工作流规则：
-
-- `swam` 作为 `swarm` 的兼容别名被接受。
-- 在 `swarm --auto` 中，`-a` / `--agent` 是可重复的 agent 规格；如需隔离账户，使用 `--account`。
-- 在 `swarm --auto` 中，`-p` / `--plan-hint` 是规划指引；如需 Codex profile，使用 `--profile`。
-- auto workflow 会调用真实 provider（已无 dry-run 预览）；不带 `-y` 时，CLI 会先推荐工作流并等待确认后才运行真实 worker。
-- 在非交互模式下，可通过以下方式恢复一个待处理的运行：
-
-```powershell
-alanbox swam --resume <runId> --namespace <namespace> -y
-```
-
-真实运行后读取输出：
-
-```text
-%USERPROFILE%\.multirunagent\<namespace>\results\
-%USERPROFILE%\.multirunagent\<namespace>\memory\index.json
-%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>\
-```
-
-当 worker B 需要 worker A 的结论时，使用普通 `swam`/`swarm`；只有全部 worker 都彼此独立时才加 `--parallel-workers`。混合串行/并行阶段用方括号分组。Skill 仅指导 CLI 的用法；所有实际执行都由 CLI 完成。