minimal-agent 0.9.0 → 0.10.0

package/skills/ui-design/tests/e2e/runs/violet-meridian-iteration-1/prompt.md

@@ -0,0 +1,14 @@
+# 紫曜经线首轮测试题
+
+使用 `Violet Meridian / 紫曜经线` VI，为一个原创中文 AI 开发工具设计官网首页 HTML。
+
+要求：
+
+- 主题是“智轨工作台”：帮助研发团队把需求、代码、检查和交付串成可追踪路径。
+- 使用白底、紫色、蓝紫、清晰科技、智能路径和协作感。
+- 可以借鉴紫白蓝紫的智能科技气质，但不能出现 `Codex`、`OpenAI` 或任何真实品牌内容。
+- 所有用户可见文案使用简体中文，必要技术缩写除外。
+- 包含 `data-screen-label="01 中文标题"`。
+- 包含唯一合法的 `EDITMODE` JSON block。
+- Tweaks 使用 `{ edits: patch }` 持久化，可调主紫色、光轨强度和界面密度。
+- 运行静态检查、语言检查和浏览器截图检查。

package/skills/ui-design/tests/e2e/runs/violet-meridian-iteration-1/review.md

@@ -0,0 +1,60 @@
+# 紫曜经线首轮端到端评审
+
+## 测试目标
+
+本轮验证第五个 VI 模板 `Violet Meridian`，中文名“紫曜经线”。目标是把“紫色、白色、蓝紫、类似 `Codex` 配色图标灵感”转译成原创、可商用、中文可读的 AI 开发工具视觉系统，而不是复刻真实品牌或生成廉价紫色渐变页。
+
+## 执行结果
+
+- 已新增 `references/vi-template-workflow.md`，记录 VI 模板制作闭环。
+- 已新增 `references/vi-violet-meridian.md`。
+- 已更新 `SKILL.md` 的视觉模板库，加入紫曜经线模板和 VI 流程文档路由。
+- 已在 `evals/evals.json` 增加紫曜经线测试题。
+- 已生成样张：`outputs/index.html`。
+
+## 自动检查
+
+- `quick_validate.py`：通过。
+- `check_ui_artifact.py`：通过，无阻断问题。
+- `check_language_policy.py`：通过，文档、提示词、评审和 HTML 均符合默认简体中文规则。
+- 浏览器渲染：通过，控制台错误为 0。
+- 响应式检查：桌面 1440px 和移动端 390px 均无横向溢出。
+- 按钮命中区域：桌面与移动端主按钮高度均为 46px，满足 44px 底线。
+
+## 视觉评审
+
+| 维度 | 分数 | 说明 |
+| --- | ---: | --- |
+| 指令对齐 | 9 | 紫色、白色、蓝紫、AI 开发工具、智能路径和原创边界都明确体现。 |
+| 中文排版 | 9 | 桌面标题有力量，移动端断行自然，没有负字距或小灰字问题。 |
+| 配色控制 | 8 | 白底清晰，紫色克制，青蓝状态有区分；仍可继续减少底部大面积淡紫光。 |
+| 结构语言 | 9 | 经线、节点、建议卡和指标共同表达“交付路径”，不是普通卡片堆。 |
+| 商用品质 | 8 | 整体像成熟 AI 产品首页；右侧工作台面板可以在下一轮加入更真实的操作控件。 |
+| 移动端 | 9 | 无溢出，按钮可点，路径面板单列后仍清楚。 |
+
+综合评分：8.7 / 10。
+
+方向成立：
+
+- 白底与近黑文字保证了可读性，没有把页面做成大面积紫色。
+- 紫蓝经线、节点、智能建议卡和状态胶囊能表达“任务路径”和“智能工作台”。
+- 紫色主要用于行动、焦点和路径，没有覆盖所有卡片。
+- 青蓝状态作为在线/同步信号，与主紫形成区分。
+- 页面避免出现真实品牌内容，图标只是原创经线符号。
+
+## 已确认截图表现
+
+- 桌面首屏足够像成熟 AI 产品，右侧路径工作台提供了具体产品感。
+- 移动端标题自然断行，按钮和卡片没有挤压或横向溢出。
+- 紫蓝经线清晰但不喧宾夺主，能作为模板 DNA 保留。
+- 白底不空，指标、路径面板和功能卡形成了三段信息锚点。
+
+## 初步结论
+
+紫曜经线可以作为第五个 VI 模板进入模板库。它与 Aqua Glass 的区别在于：Aqua 强调浅蓝白玻璃和空气感，紫曜经线强调白底智能路径、紫蓝经线和开发工具秩序；与 Nebula Console 的区别在于：Nebula 是深色科技半透明，紫曜经线是浅色清晰科技。
+
+下一轮可继续优化：
+
+- 为右侧工作台增加更真实的输入区、检查状态或任务切换，让它更像可用产品而不只是示意面板。
+- 对 deck 场景再做一次样张，验证紫蓝经线是否适合发布演示。
+- 如果用于更严肃的企业开发工具，可降低背景淡紫光强度，提高主 surface 的朴素感。

package/skills/video-compose/SKILL.md

@@ -88,7 +88,14 @@ ffmpeg -y -f concat -safe 0 -i "$LIST" \
   -c:v libx264 -crf ${CRF} -pix_fmt yuv420p /tmp/video_only.mp4
 ```
 
-> ⚠️ Windows 路径里反斜杠 `\` 会被 ffmpeg subtitles 滤镜当转义字符吃掉。**字幕路径强制用正斜杠 `/`**，或者 `\\:` 转义盘符冒号。
+> ⚠️ Windows 路径里反斜杠 `\` 会被 ffmpeg subtitles 滤镜当转义字符吃掉。**字幕路径强制用正斜杠 `/`**，且盘符冒号要转义。完整示例（`D:\job\assets\subs.srt`）：
+>
+> ```bash
+> # 相对路径最稳（先 cd 到工作目录，避开盘符冒号问题）：
+> -vf "...,subtitles=./assets/subs.srt:force_style='Fontname=Microsoft YaHei,Fontsize=42'"
+> # 必须用绝对路径时：正斜杠 + 盘符冒号 \\: 转义
+> -vf "...,subtitles=D\\:/job/assets/subs.srt:force_style='Fontname=Microsoft YaHei,Fontsize=42'"
+> ```
 
 ### 6. 合入音轨（如果有）
 

package/skills/web-crawler/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: web-crawler
+description: Crawl and scrape websites — clean-extract a single page to Markdown (title + OpenGraph + JSON-LD), or crawl a whole site (follow links with depth/domain limits, dedup, robots.txt, sitemap, polite rate-limit). Static-first with automatic JS-render escalation via the built-in browser. Use when asked to 爬取/抓取网站、整站爬、批量抽正文、crawl a site, scrape pages, collect articles, or extract content from many pages.
+metadata:
+  type: prompt（展开为系统提示词，指导用 bun 通用爬虫脚本抓取网站）
+  requires:
+    bins:
+      - node
+    anyBins:
+      - bun
+      - node
+---
+
+# web-crawler —— 通用网页爬虫（bun 脚本 skill）
+
+一个自包含的爬虫引擎 `scripts/crawl.mjs`（**零 npm 依赖**，node + bun 都能跑），集合主流爬虫该有的能力：
+静态优先 + JS 渲染升级、内容净抽（Markdown + OpenGraph + JSON-LD + 主图）、整站 BFS 爬取（去重 / 深度·域名闸 /
+robots.txt / sitemap / 礼貌限速 / 重试），输出每页 Markdown + 一份 `crawl.json` 清单。
+
+## 何时用哪个（先选对工具）
+- **单页、简单读** → `WebFetch` 工具（最快，无需脚本运行时）。
+- **多页 / 整站 / 批量净抽** → **本 skill**（`crawl.mjs`，确定性管理爬取队列/去重/限速）。
+- **要交互（点击 / 填表 / 登录后才出内容）** → `WebBrowser` 工具。
+- **要下载图片/资产文件** → `Download` 工具。
+
+## 运行（dev 用 bun、npm 安装用 node）
+从系统提示「可用技能」里 **web-crawler** 的【技能目录】取脚本绝对路径，用 Bash 跑：
+
+```bash
+# 单页净抽（URL → 干净 Markdown + 元数据）
+node "<技能目录>/scripts/crawl.mjs" "https://example.com/article" --mode single --out ./build/crawl
+
+# 整站爬取（种子 URL → 沿链接爬，限同域、深度 2、最多 30 页）
+node "<技能目录>/scripts/crawl.mjs" "https://example.com" --mode site --same-origin --depth 2 --max-pages 30 --out ./build/crawl
+
+# 抓 JS 单页应用（强制用内置浏览器渲染后再抽）
+node "<技能目录>/scripts/crawl.mjs" "https://app.example.com" --render on --out ./build/crawl
+```
+> dev 环境可把 `node` 换成 `bun`。`--json` 时 stdout 输出一行 manifest（供程序消费），诊断走 stderr。
+
+### 选项
+| 选项 | 说明 |
+|---|---|
+| `--mode single\|site` | 单页净抽 / 整站爬（默认 single） |
+| `--out <dir>` | 产物目录（默认 `./build/crawl`） |
+| `--depth <n>` | site：跟链最大深度（默认 2） |
+| `--max-pages <n>` | site：最多抓多少页（默认 20，防失控） |
+| `--same-origin` / `--allow-domains a.com,b.com` | 限同源 / 限白名单域 |
+| `--render auto\|on\|off` | JS 渲染：auto=正文太空/疑似 SPA 时自动升级、on=强制、off=只静态（默认 auto） |
+| `--concurrency <n>` `--delay <ms>` | site 并发 + 每域礼貌间隔（robots 的 Crawl-delay 会取更大者） |
+| `--no-robots` | 不读 robots.txt（默认读并尊重 Disallow/Crawl-delay） |
+| `--timeout <ms>` | 单请求超时（默认 20000） |
+
+## 产物
+- `build/crawl/page_001.md`…（每页：front-matter `url/title/rendered/image` + 净抽 Markdown）
+- `build/crawl/crawl.json`（清单：`{seed, mode, generated_pages, pages:[{url,title,file,rendered,links,jsonld,og}]}`），下游/你按需读取。
+
+## 关键行为
+- **静态优先**：先 `fetch` 取 HTML；正文太空 / 疑似 SPA（`__NEXT_DATA__`、`#root`/`#app` 空壳）或 `--render on` 时，
+  自动 `spawn agent-browser`（内置浏览器，已在 PATH）取渲染后 DOM 再抽。agent-browser 不可用则用静态结果（best-effort）。
+- **净抽**：HTML→Markdown（有 turndown 用之、无则内置回落），附 title / OpenGraph / JSON-LD / 主图。
+- **整站礼貌**：尊重 robots.txt（Disallow + Crawl-delay）、per-domain 限速、深度+页数双闸、URL 规范化去重（去 hash/tracking 参数）。
+- **反爬只到基础层**：浏览器 UA/headers + 重试 + agent-browser 渲染升级。**硬反爬**（Cloudflare Turnstile 等）不在范围。
+
+## 运行时边界（重要）
+- `crawl.mjs` 需 **node 或 bun**。dev / npm 安装环境天然有；**绿色版（单文件 exe）目标机若没装 node/bun，本脚本跑不了**。
+- 此时**降级**：单页用 `WebFetch`（→Markdown）/ JS 页用 `WebBrowser` / 下资产用 `Download`，逐页手动处理；整站批量爬取需运行时。
+
+## 测试
+`bun test "<技能目录>/scripts/crawl.test.mjs"`（DI 假 fetch，不连真网，覆盖抽取/规范化/去重/前沿/robots/产物）。