@ninkch/dsh-artcraft 0.2.7 → 0.2.9

package/README.md

@@ -14,18 +14,22 @@
 
 ## Why this exists
 
-[ArtCraft](https://getartcraft.com/apps) is a family of free, fair-source reinventions of Adobe's
-studio tools, written from scratch in pure Rust: **PhotoCraft** (Photoshop), **FilmCraft**
-(Premiere Pro), **EffectCraft** (After Effects) and more. They share one superpower that most
-desktop apps don't have: **every menu item, slider and dialog is a command**, and the exact same
-commands can be driven from a headless CLI, a JSON control channel, or an MCP server. The apps
-were built for agents from day one.
+[ArtCraft](https://getartcraft.com/apps) is a family of **twelve** free, fair-source reinventions
+of Adobe's studio tools, written from scratch in pure Rust: **PhotoCraft** (Photoshop),
+**VectorCraft** (Illustrator), **FilmCraft** (Premiere Pro), **LightCraft** (Lightroom),
+**PdfCraft** (Acrobat), **EffectCraft** (After Effects), **DesignCraft** (InDesign),
+**WordCraft** (Word), **DeckCraft** (PowerPoint), **GridCraft** (Excel), **CADCraft** (AutoCAD)
+and **SoundCraft** (Pro Tools). They share one superpower that most desktop apps don't have:
+**every menu item, slider and dialog is a command**, and the exact same commands can be driven
+from a headless CLI, a JSON control channel, or an MCP server. The apps were built for agents
+from day one.
 
 This plugin brings that surface into DeepSeek Harness, so an AI agent can *operate* the apps —
 not just talk about them:
 
-- **In chat** — four agent tools let any Harness session check the toolchain, run CLI commands,
-  send control-channel commands to a running app, and do bridged file operations.
+- **In chat** — eight agent tools let any Harness session check the toolchain, run CLI commands,
+  send control-channel commands to a running app, do bridged file operations, and consult a
+  per-app capability catalog.
 - **In the browser** — a same-origin HTTP API (`/artcraft/api/*`) that any Harness web UI can call,
   no CORS, no keys. It was built for [无限画布 / infinite-canvas](../dsh-infinite_canvas/README.md),
   a node-based AI short-drama storyboard canvas, but any front end can use it.
@@ -140,10 +144,14 @@ artcraft_cli  { bin:"photocraft", args:["batch","--actions","demo/craft/grade.js
 
 | Tool | What it does |
 |---|---|
-| `artcraft_status` | Toolchain health check: which CLIs resolved, config location, control ports, running jobs |
-| `artcraft_cli` | Run any CLI subcommand synchronously (`photocraft-cli run/batch`, `filmcraft-cli commands`, …) |
-| `artcraft_control` | One command over the JSON control channel of a *running* FilmCraft / EffectCraft |
+| `artcraft_status` | Toolchain health check: which of the 12 CLIs resolved, config location, control ports, running jobs |
+| `artcraft_cli` | Run any CLI subcommand synchronously (`photocraft-cli run/batch`, `wordcraft-cli convert`, …) |
+| `artcraft_control` | One command over the JSON control channel of a *running* app (filmcraft 9876 / effectcraft 9877 / vectorcraft 7979 / lightcraft 7980, or pass `port`) |
 | `artcraft_fs` | Bridged file ops — list / stat / read / write / mkdir at caller-decided absolute paths |
+| `artcraft_discover` | Family install auto-discovery: fills missing paths, auto-corrects stale ones |
+| `artcraft_apps` | Capability catalog for all 12 apps: CLI subcommands, control ports, MCP, repo/docs links |
+| `artcraft_recipes` | Built-in expert recipes: 8 cross-app professional workflows |
+| `artcraft_update` | The plugin's own update (check / apply) |
 
 ## Driving it from the browser
 
@@ -175,7 +183,10 @@ Full route list:
 | `GET /artcraft/api/fs?op=list\|stat\|readtext&path=…` | Read directories, metadata, small text files |
 | `GET /artcraft/api/file?path=…` | Download a file — streamed, up to 2 GB |
 | `POST /artcraft/api/job` · `GET ?id=…` · `POST /artcraft/api/job/cancel` | Job lifecycle with output statting and tail logs |
-| `POST /artcraft/api/control` | Synchronous control-channel call |
+| `POST /artcraft/api/control` | Synchronous control-channel call (`app` or `port`) |
+| `GET /artcraft/api/apps[?id=…]` | Family capability catalog (12 apps) |
+| `POST /artcraft/api/discover` | Family install discovery + config self-repair |
+| `GET /artcraft/api/update/check` · `POST /artcraft/api/update/apply` | The plugin's own update |
 
 Uploads are capped at 320 MB per request (Blob direct, no base64 needed for the raw path);
 downloads stream up to 2 GB. All path arguments are **absolute** (or `base` absolute directory +
@@ -209,10 +220,14 @@ POST /artcraft/api/control
 Time accepts `seconds`, `frame` or `timecode` (internally FilmCraft counts ticks at
 254,016,000,000/s). `filmcraft-cli commands` lists the 650+ engine commands; the protocol is
 documented in [filmcraft/docs/control-protocol.md](https://github.com/storytold/filmcraft/blob/main/docs/control-protocol.md).
-EffectCraft listens the same way on its own port (default 9877).
+EffectCraft listens the same way on its own port (default 9877); VectorCraft defaults to 7979
+and LightCraft to 7980 (both built into `artcraft_control`'s `app`). The remaining apps pick
+dynamic ports: start them with `app --port PORT`, then pass `port` to `artcraft_control`. Each
+app's control surface is described in the `artcraft_apps` catalog.
 
-> PhotoCraft's control channel is an authenticated variant and is deliberately **not** proxied
-> here — for PhotoCraft the headless CLI covers everything this plugin needs.
+> PhotoCraft's control channel is an authenticated variant and PdfCraft's is file-based
+> (`--control FILE`); both are deliberately **not** proxied here — the headless CLI covers
+> everything this plugin needs.
 
 ## Working with 无限画布 (infinite-canvas)
 
@@ -268,7 +283,7 @@ a web UI.
 
 The HTTP surface has **no authentication** and rides on the Harness web server, which listens on
 loopback only — treat the port as trusted-local and don't expose it to a network; put a reverse
-proxy with auth in front if you must. Child processes are locked to the seven allow-listed
+proxy with auth in front if you must. Child processes are locked to the twelve allow-listed
 family CLIs; the control channel only ever dials `127.0.0.1`.
 
 ## Publishing

package/README.zh-CN.md

@@ -15,16 +15,18 @@
 ## 为什么做这个
 
 [ArtCraft](https://getartcraft.com/apps) 是一套用纯 Rust 从零重写的免费公平源代码（fair source）
-Adobe 对标工具：
-**PhotoCraft**（对标 Photoshop）、**FilmCraft**（对标 Premiere Pro）、**EffectCraft**（对标 After
-Effects）等。它们有一个大多数桌面软件都不具备的共同基因：**每个菜单项、滑块、对话框都是一条
+Adobe 对标工具，共 **12 个应用**：**PhotoCraft**（Photoshop）、**VectorCraft**（Illustrator）、
+**FilmCraft**（Premiere Pro）、**LightCraft**（Lightroom）、**PdfCraft**（Acrobat）、
+**EffectCraft**（After Effects）、**DesignCraft**（InDesign）、**WordCraft**（Word）、
+**DeckCraft**（PowerPoint）、**GridCraft**（Excel）、**CADCraft**（AutoCAD）、**SoundCraft**
+（Pro Tools）。它们有一个大多数桌面软件都不具备的共同基因：**每个菜单项、滑块、对话框都是一条
 命令**，而同一套命令既能从无头 CLI 调用，也能走 JSON 控制通道或 MCP——这些 App 从第一天起
 就是为 agent 设计的。
 
 本插件把这套自动化面接进 DeepSeek Harness，让 AI 不只是"谈论"这些软件，而是真的**操作**它们：
 
-- **对话里** —— 四个 Agent 工具，任何 Harness 会话都能检查工具链、执行 CLI 命令、向运行中的
-  App 发控制通道命令、做桥接文件操作。
+- **对话里** —— 八个 Agent 工具，任何 Harness 会话都能检查工具链、执行 CLI 命令、向运行中的
+  App 发控制通道命令、做桥接文件操作、查每个应用的能力目录。
 - **浏览器里** —— 同源 HTTP API（`/artcraft/api/*`），任何 Harness 前端都能直接调用：无 CORS、
   无密钥。它为 [无限画布 / infinite-canvas](../dsh-infinite_canvas/README.md)（节点式 AI 短剧
   分镜画布）而建，但任何前端都可用。
@@ -129,10 +131,14 @@ artcraft_cli  { bin:"photocraft", args:["batch","--actions","demo/craft/grade.js
 
 | 工具 | 用途 |
 |---|---|
-| `artcraft_status` | 工具体检：CLI 是否找到、配置目录、控制端口、进行中的任务 |
-| `artcraft_cli` | 同步执行任意 CLI 子命令（`photocraft-cli run/batch`、`filmcraft-cli commands` 等） |
-| `artcraft_control` | 向**运行中**的 FilmCraft / EffectCraft 控制通道发一条命令 |
+| `artcraft_status` | 工具体检：12 个 CLI 是否找到、配置目录、控制端口、进行中的任务 |
+| `artcraft_cli` | 同步执行任意 CLI 子命令（`photocraft-cli run/batch`、`wordcraft-cli convert` 等） |
+| `artcraft_control` | 向**运行中**的 App 控制通道发一条命令（filmcraft 9876 / effectcraft 9877 / vectorcraft 7979 / lightcraft 7980，或 port 直连） |
 | `artcraft_fs` | 桥接文件操作 —— list / stat / 读 / 写 / 建目录，路径由调用方绝对指定 |
+| `artcraft_discover` | 家族安装自动探测：填充缺失路径、自动纠正失效路径 |
+| `artcraft_apps` | 12 应用能力目录：每个应用的 CLI 子命令、控制端口、MCP、仓库/文档链接 |
+| `artcraft_recipes` | 内置专家处理方案：8 套跨应用专业工作流配方 |
+| `artcraft_update` | 插件自身更新（检查 / 应用） |
 
 ## 在浏览器里驱动
 
@@ -163,7 +169,10 @@ POST /artcraft/api/job/cancel  { "id":"7f2c…" }
 | `GET /artcraft/api/fs?op=list\|stat\|readtext&path=…` | 读目录、元数据、小文本 |
 | `GET /artcraft/api/file?path=…` | 下载文件 —— 流式，上限 2 GB |
 | `POST /artcraft/api/job` · `GET ?id=…` · `POST /artcraft/api/job/cancel` | 任务生命周期，含产物探测与日志尾部 |
-| `POST /artcraft/api/control` | 控制通道同步调用 |
+| `POST /artcraft/api/control` | 控制通道同步调用（`app` 或 `port`） |
+| `GET /artcraft/api/apps[?id=…]` | 家族能力目录（12 应用） |
+| `POST /artcraft/api/discover` | 家族安装探测 + 配置自动修复 |
+| `GET /artcraft/api/update/check` · `POST /artcraft/api/update/apply` | 插件自更新 |
 
 上传单次上限 320 MB（原始路径 Blob 直传，无需 base64）；下载流式上限 2 GB。
 所有路径参数为**绝对路径**（或 `base` 绝对目录 + 相对 `rel`）—— 位置由调用方决定：
@@ -195,9 +204,12 @@ POST /artcraft/api/control
 时间可传 `seconds` / `frame` / `timecode`（FilmCraft 内部以每秒 254,016,000,000 tick 计）。
 `filmcraft-cli commands` 列出全部 650+ 引擎命令；协议详见
 [filmcraft/docs/control-protocol.md](https://github.com/storytold/filmcraft/blob/main/docs/control-protocol.md)。
-EffectCraft 同族协议，端口默认 9877。
+EffectCraft 同族协议，端口默认 9877；VectorCraft 默认 7979、LightCraft 默认 7980（`artcraft_control`
+的 `app` 已内置）。其余应用端口动态：以 `app --port PORT` 启动后，`artcraft_control` 传 `port`
+直连即可（协议同族）。每个应用的控制面详见 `artcraft_apps` 能力目录。
 
-> PhotoCraft 的控制通道是带鉴权的变体，本插件**有意不代理** —— PhotoCraft 走无头 CLI 足够。
+> PhotoCraft 的控制通道是带鉴权的变体、PdfCraft 是文件式（`--control FILE`），本插件**有意不代理**
+> —— 两者走无头 CLI 足够。
 
 ## 与无限画布（infinite-canvas）协作
 
@@ -250,7 +262,7 @@ NVENC 硬编）、ProRes、DNxHR，附 EBU R128 响度归一与字幕烧录。
 ## 安全与信任模型
 
 HTTP 面无鉴权，挂在 Harness Web 服务之下（仅回环监听）—— 把端口当本机可信处理，**不要暴露
-到网络**；确需远程请加带鉴权的反向代理。子进程锁定 7 个白名单家族 CLI；控制通道只会拨
+到网络**；确需远程请加带鉴权的反向代理。子进程锁定 12 个白名单家族 CLI；控制通道只会拨
 `127.0.0.1`。
 
 ## 发布

package/apps/catalog.json

@@ -0,0 +1,293 @@
+{
+  "version": 1,
+  "note": "ArtCraft 家族 12 应用的自动化能力目录。来源：官方 getartcraft.com/apps、各应用 GitHub 仓库（storytold/*）、本机 12 个 <app>-cli --help 实测（0.2.9 时点）。要拿某应用的实时命令注册表，用 artcraft_cli 跑该应用的 commands 子命令。",
+  "controlProtocol": "家族共用 JSON-lines 控制协议（127.0.0.1:<port>，请求 {\"id\",\"method\",\"params\"}，方法如 engine.execute / engine.commands / ui.inspect / ui.screenshot）。App 需以 --control 启动。artcraft_control 已代理有固定默认端口的应用；其余应用端口动态（app --port 启动时指定），可用 artcraft_control 的 port 参数直连。",
+  "apps": [
+    {
+      "id": "photocraft",
+      "name": "PhotoCraft",
+      "tagline": "图像编辑",
+      "ref": "Adobe Photoshop",
+      "stage": "early alpha",
+      "repo": "https://github.com/storytold/photocraft",
+      "docs": "https://getartcraft.com/apps/photocraft",
+      "cli": "photocraft-cli",
+      "control": null,
+      "controlNote": "控制通道为令牌鉴权模式，artcraft_control 不代理；headless 用 serve/mcp",
+      "mcp": true,
+      "subcommands": [
+        { "name": "convert", "usage": "convert <in> <out> [--format ext] [--quality 1-100] [--tiff-layers]", "summary": "格式互转（.pcraft/.psd/.png/.jpg/.tif/.webp/.exr…）；TIFF 默认拼合，--tiff-layers 保留图层" },
+        { "name": "info", "usage": "info <file> [--compact]", "summary": "文档 JSON（尺寸/颜色模式/位深/图层树）" },
+        { "name": "run", "usage": "run (<file> | --new <json>) --cmd <id> [--params <json>]… [--out <file>] [--format] [--quality] [--tiff-layers]", "summary": "打开文件按序执行引擎命令后保存；每个 --params 归属前一个 --cmd" },
+        { "name": "batch", "usage": "batch --actions <actions.json> --in <dir> --out <dir> [--format] [--quality] [--in-place] [--tiff-layers]", "summary": "动作列表批处理整个目录（录制动作/droplet 格式）；--in-place 才允许覆盖原目录" },
+        { "name": "droplet", "usage": "droplet <file.pcdroplet> <file-or-dir>… [--out <dir>]", "summary": "运行 Photoshop 式 droplet" },
+        { "name": "commands", "usage": "commands [--json] [--filter <text>]", "summary": "列出引擎命令注册表" },
+        { "name": "serve", "usage": "serve [--port <port>] [--control-token …] [--automation-read-root <dir>] [--automation-write-root <dir>]", "summary": "常驻 headless 会话：stdio 或 TCP JSON lines（engine.execute、doc.open/new/save/inspect/render/select/close、session.list、batch、methods）" },
+        { "name": "mcp", "usage": "mcp [--bridge 127.0.0.1:port] [--control-token …] [--automation-read-root] [--automation-write-root]", "summary": "stdio MCP 服务器（headless 引擎，或 bridge 到运行中的 app）" }
+      ]
+    },
+    {
+      "id": "vectorcraft",
+      "name": "VectorCraft",
+      "tagline": "矢量插画",
+      "ref": "Adobe Illustrator",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/vectorcraft",
+      "docs": "https://getartcraft.com/apps/vectorcraft",
+      "cli": "vectorcraft-cli",
+      "control": 7979,
+      "mcp": true,
+      "subcommands": [
+        { "name": "run", "usage": "run [--in FILE] [--cmd ID [--params JSON]]… [--export FILE]… [--scale N]", "summary": "headless 批处理：打开或新建文档，按序执行命令，按扩展名导出" },
+        { "name": "commands", "usage": "commands", "summary": "命令目录 JSON" },
+        { "name": "convert", "usage": "convert IN OUT [--scale N] [--artboard I | --range R] [--outline-text] [--replace-lossy]", "summary": "转换/导出（SVG/PDF/PNG…）；PDF 出全部画板；--outline-text 文字转路径" },
+        { "name": "info", "usage": "info FILE", "summary": "JSON 摘要：导入警告、标题、颜色模式、单位、画板、对象统计、字体" },
+        { "name": "bench", "usage": "bench FILE [--size WxH] [--iters N]", "summary": "渲染基准（ms/帧，多线程与单线程）" },
+        { "name": "perf", "usage": "perf [--paths N]", "summary": "性能预算检查（渲染/平移/命中/存取/SVG/Pathfinder）" },
+        { "name": "mcp", "usage": "mcp [--connect ADDR | --headless] [--automation-read-root DIR] [--automation-write-root DIR]", "summary": "stdio MCP（默认连运行中的 app 127.0.0.1:7979，回退 headless）" }
+      ]
+    },
+    {
+      "id": "filmcraft",
+      "name": "FilmCraft",
+      "tagline": "视频剪辑、调色和声音处理",
+      "ref": "Adobe Premiere Pro",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/filmcraft",
+      "docs": "https://getartcraft.com/apps/filmcraft",
+      "cli": "filmcraft-cli",
+      "control": 9876,
+      "mcp": true,
+      "global": ["--project <p.fcproj>", "--demo", "--save", "--save-as <p.fcproj>"],
+      "subcommands": [
+        { "name": "exec", "usage": "exec <id> [key=value …] | exec <id> '<json params>'", "summary": "运行单条命令，结果 JSON" },
+        { "name": "run", "usage": "run <script.jsonl | ->", "summary": "脚本批处理：每行一个 {\"id\",\"params\"}（# 注释可用）" },
+        { "name": "commands", "usage": "commands [filter] [--json]", "summary": "命令清单（id/label/快捷键/参数）" },
+        { "name": "describe", "usage": "describe <id>", "summary": "单条命令 JSON（菜单/快捷键/参数/当前可用性）" },
+        { "name": "inspect", "usage": "inspect [project|sequence]", "summary": "项目树或活动序列 JSON（默认两者）" },
+        { "name": "import", "usage": "import <file>…", "summary": "导入媒体到项目" },
+        { "name": "export", "usage": "export <out> [--preset name] [--format f] [--range entire|inOut|workArea|秒] [--settings json] [--gpu-rendering auto|off] [--scale f] [--quality 0-100] [--no-audio] [--queue]", "summary": "导出活动序列（h264/hevc/prores/dnxhr/apv/mjpeg/mxf-op1a/mxf-opatom/png/tiff/bmp/gif/wav/aiff/aac）；--list-presets 列预设" },
+        { "name": "render", "usage": "render --seconds S --out f.png [--scale 0.5]", "summary": "渲染 Program 单帧 PNG" },
+        { "name": "probe", "usage": "probe <media> [--image-sequence]", "summary": "媒体信息 JSON（含 MXF/Ogg/BWF 细节；编号静帧序列取首帧）" },
+        { "name": "bench-decode", "usage": "bench-decode <media> [--frames N]", "summary": "解码基准" },
+        { "name": "mcp", "usage": "mcp", "summary": "stdio MCP（headless，或 --bridge 接运行中的 app）" }
+      ]
+    },
+    {
+      "id": "lightcraft",
+      "name": "LightCraft",
+      "tagline": "照片管理与 RAW 处理",
+      "ref": "Adobe Lightroom",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/lightcraft",
+      "docs": "https://getartcraft.com/apps/lightcraft",
+      "cli": "lightcraft-cli",
+      "control": 7980,
+      "mcp": true,
+      "subcommands": [
+        { "name": "run", "usage": "run [--demo | --library DIR | --import PATH… | --connect [ADDR] | --script FILE|- | --keep-going] COMMAND [k=v | '{json}']…", "summary": "命令批处理（每命令一行 JSON 结果）：develop.set/auto、app.export 等控制协议方法；--library 模式编辑落盘" },
+        { "name": "mcp", "usage": "mcp [--connect [ADDR] | --demo | --library DIR] [FILES/FOLDERS…]", "summary": "stdio MCP（headless 默认；--compact 只列辅助工具）" },
+        { "name": "render", "usage": "render <IN> -o <OUT> [--set CONTROL=VALUE…] [--settings FILE] [--preset ID] [--size N] [--quality Q] [--opt KEY=VALUE…]", "summary": "单文件 RAW 冲洗导出（.jpg/.png/.tif/.webp/.avif/.dng）；--opt 支持 colorSpace/bitDepth/percent/ppi/format=original" },
+        { "name": "snapshot", "usage": "snapshot [FILES/FOLDERS…] [OPTIONS]", "summary": "无窗口 CPU 光栅化跑完整 UI 并输出 PNG（界面截图自动化）" }
+      ]
+    },
+    {
+      "id": "pdfcraft",
+      "name": "PdfCraft",
+      "tagline": "PDF 阅读、整理和保护",
+      "ref": "Adobe Acrobat",
+      "stage": "early alpha",
+      "repo": "https://github.com/storytold/pdfcraft",
+      "docs": "https://getartcraft.com/apps/pdfcraft",
+      "cli": "pdfcraft-cli",
+      "control": null,
+      "controlNote": "控制通道为文件式（--control FILE），不走 TCP，artcraft_control 不代理",
+      "mcp": true,
+      "subcommands": [
+        { "name": "info", "usage": "info <file.pdf> [--password PW]", "summary": "文档摘要 JSON" },
+        { "name": "render", "usage": "render <file.pdf> --page N [--dpi 96] --out x.png", "summary": "页面渲染（.png/.jpg/.tif/.pam）" },
+        { "name": "text", "usage": "text <file.pdf> [--page N]", "summary": "提取文本（页间换页符分隔）" },
+        { "name": "edit", "usage": "edit <in.pdf> --out out.pdf [--rotate 1,3:90] [--delete 2,4] [--move 5:1] [--insert-blank 1] [--title T] [--author A] [--full]", "summary": "页级编辑：旋转/删除/移动/插空白页/元数据" },
+        { "name": "combine", "usage": "combine <a.pdf> <b.pdf> … --out combined.pdf", "summary": "合并多个 PDF" },
+        { "name": "extract", "usage": "extract <in.pdf> --pages 1,3,5 --out out.pdf", "summary": "抽取指定页" },
+        { "name": "split", "usage": "split <in.pdf> (--every N | --before 3,7) [--out-dir DIR]", "summary": "拆分（每 N 页一档 / 指定页前切）" },
+        { "name": "check", "usage": "check <files or dirs…> [--timeout 20] [--dpi 36] [--json out.json]", "summary": "批量打开校验（损坏/加密扫描）" },
+        { "name": "tools", "usage": "tools", "summary": "自动化工具与其 JSON Schema" },
+        { "name": "run", "usage": "run <tool> [key=value …] [--root DIR] [--out image.png] | run --script steps.json [--root DIR]", "summary": "运行自动化工具（或脚本数组 [{\"tool\",\"args\"}…]）" },
+        { "name": "mcp", "usage": "mcp [--root DIR] [--compact]", "summary": "stdio MCP（--compact 精简工具集 + tool_search/tool_call）" },
+        { "name": "ui", "usage": "ui --control FILE <method> [key=value …] [--out shot.png]", "summary": "驱动以 --control FILE 启动的运行中 app（engine.execute/ui.* 等）" }
+      ]
+    },
+    {
+      "id": "effectcraft",
+      "name": "EffectCraft",
+      "tagline": "动态图形与视觉特效",
+      "ref": "Adobe After Effects",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/effectcraft",
+      "docs": "https://getartcraft.com/apps/effectcraft",
+      "cli": "effectcraft-cli",
+      "control": 9877,
+      "mcp": true,
+      "global": ["--project F.ecproj | --demo | --empty", "--save | --save-as F", "--bridge PORT", "--json", "--gpu"],
+      "subcommands": [
+        { "name": "info", "usage": "info", "summary": "项目 + 引擎摘要" },
+        { "name": "commands", "usage": "commands [--filter TEXT] [--enabled]", "summary": "引擎命令清单" },
+        { "name": "exec", "usage": "exec <command-id> [--params JSON]", "summary": "运行单条引擎命令" },
+        { "name": "run", "usage": "run <id> <json> [<id> <json> …]", "summary": "按序运行多条命令" },
+        { "name": "props", "usage": "props <comp> <layer> [--flat] [--time S]", "summary": "图层属性树（含路径；<comp>/<layer> 可用 id/名称，'-' 为当前）" },
+        { "name": "get", "usage": "get <comp> <layer> <path> [--time S]", "summary": "读属性" },
+        { "name": "set", "usage": "set <comp> <layer> <path> <value> [--time S] [--expression E]", "summary": "写属性（可设表达式）" },
+        { "name": "render-frame", "usage": "render-frame [--comp C] [--time S | --frame N] [--max-side PX | --scale K] [--out F.png] [--transparent]", "summary": "单帧渲染（可透明底）" },
+        { "name": "render", "usage": "render [--comp C] --out FILE [--format h264|hevc|av1|prores|webm|png|jpeg|tiff|exr|gif|wav|aiff] [--start/--end/--work-area/--fps/--resolution/--quality/--channels/--bitrate/--prores PROFILE/--rate-control/--keyint/--webm-codec vp9|av1…] [--queue] | --template T.ectemplate --values V.json", "summary": "合成输出（编码参数齐全；模板渲染用 --template + --values）" },
+        { "name": "bench", "usage": "bench [--comp C] [--time S] [--scale K] [--n N] [--play N] [--gpu] | bench --ops", "summary": "渲染基准（CPU/GPU 对比；--ops 大项目日常操作基准）" },
+        { "name": "script", "usage": "script FILE.jsx [F.ecproj] | --eval CODE", "summary": "AE 风格 JS 对象模型（app.project/comps/layers/properties…），错误带 file:line:col" },
+        { "name": "mcp", "usage": "mcp [--autosave | --bridge PORT] [--automation-read-root DIR] [--automation-write-root DIR]", "summary": "stdio MCP（--autosave 保留未保存的 headless 成果；脚本可被 root 限制拒绝）" }
+      ]
+    },
+    {
+      "id": "designcraft",
+      "name": "DesignCraft",
+      "tagline": "页面排版与出版",
+      "ref": "Adobe InDesign",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/designcraft",
+      "docs": "https://getartcraft.com/apps/designcraft",
+      "cli": "designcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态：app --port PORT 启动后用 artcraft_control 的 port 参数直连",
+      "mcp": true,
+      "subcommands": [
+        { "name": "run", "usage": "run [--in FILE | --sample] [--cmd ID[=JSON]]… [--page N] [--scale S] [--pdf-options JSON] [--export OUT] [--all-pages DIR]", "summary": "headless 执行命令并导出（--page/--scale/--pdf-options 归属其后的导出）" },
+        { "name": "commands", "usage": "commands [FILTER]", "summary": "命令清单" },
+        { "name": "describe", "usage": "describe COMMAND", "summary": "单命令详情" },
+        { "name": "script", "usage": "script [FILE|-] [--in FILE | --sample] [--connect PORT] [--save OUT] [--export OUT] [--keep-going]", "summary": "脚本批处理" },
+        { "name": "app", "usage": "app [--port PORT] COMMAND [JSON] | --method METHOD [JSON]", "summary": "调用运行中 app 的控制通道（引擎命令或协议方法）" },
+        { "name": "mcp", "usage": "mcp [--connect PORT] [--sample]", "summary": "stdio MCP" },
+        { "name": "perf", "usage": "perf [--pages N] [--runs N] [--strict]", "summary": "性能预算" },
+        { "name": "bench", "usage": "bench FILE [--runs N]", "summary": "渲染基准" },
+        { "name": "links", "usage": "links", "summary": "社区/文档链接" }
+      ]
+    },
+    {
+      "id": "wordcraft",
+      "name": "WordCraft",
+      "tagline": "写作与文档设计",
+      "ref": "Microsoft Word",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/wordcraft",
+      "docs": "https://getartcraft.com/apps/wordcraft",
+      "cli": "wordcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态（mcp --connect HOST:PORT 桥接运行中的 app）",
+      "mcp": true,
+      "subcommands": [
+        { "name": "convert", "usage": "convert <in> <out>", "summary": "格式互转：docx/doc(读)/pdf/odt/rtf/html/md/tex/txt/json/png" },
+        { "name": "info", "usage": "info <file>", "summary": "页数/字数/段落/属性 JSON" },
+        { "name": "text", "usage": "text <file>", "summary": "纯文本提取" },
+        { "name": "inspect", "usage": "inspect <file>", "summary": "文档结构 JSON" },
+        { "name": "render", "usage": "render <file> <out.png> [--page N] [--scale S]", "summary": "页面渲染 PNG" },
+        { "name": "run", "usage": "run [--file F | --template T] --cmd 'id={json}' [--cmd …] [--save OUT] [--print] [--author NAME]", "summary": "headless 命令（--author 给修订/批注署名）" },
+        { "name": "commands", "usage": "commands [--json]", "summary": "全部命令清单" },
+        { "name": "parity", "usage": "parity [--markdown]", "summary": "特性目录对照报告" },
+        { "name": "zotero", "usage": "zotero <command> <file> [--cmd …] [--save OUT] [--trace] [--port P]", "summary": "Zotero 文献命令（需 Zotero 运行中）：addEditCitation/addEditBibliography/addNote/refresh/removeCodes/setDocPrefs" },
+        { "name": "mcp", "usage": "mcp [--connect HOST:PORT | --author NAME]", "summary": "stdio MCP（headless 或桥接运行中的 app）" }
+      ]
+    },
+    {
+      "id": "deckcraft",
+      "name": "DeckCraft",
+      "tagline": "演示文稿与幻灯片",
+      "ref": "Microsoft PowerPoint",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/deckcraft",
+      "docs": "https://getartcraft.com/apps/deckcraft",
+      "cli": "deckcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态：app --port PORT 启动后用 artcraft_control 的 port 参数直连",
+      "mcp": true,
+      "subcommands": [
+        { "name": "info", "usage": "info FILE", "summary": "演示文稿摘要" },
+        { "name": "render", "usage": "render (FILE | --sample) [--slide N | --all] [--scale S] [--edit] OUT", "summary": "幻灯片渲染 PNG（单页/全部）" },
+        { "name": "convert", "usage": "convert IN OUT", "summary": "格式转换" },
+        { "name": "run", "usage": "run [--in FILE | --sample] [--cmd ID[=JSON]]… [--save OUT] [--export OUT] [--print]", "summary": "headless 命令批处理" },
+        { "name": "commands", "usage": "commands [FILTER]", "summary": "命令清单" },
+        { "name": "describe", "usage": "describe COMMAND", "summary": "单命令详情" },
+        { "name": "app", "usage": "app [--port PORT] COMMAND [JSON] | --method METHOD [JSON]", "summary": "调用运行中 app 的控制通道" },
+        { "name": "mcp", "usage": "mcp [--connect PORT] [--sample]", "summary": "stdio MCP" }
+      ]
+    },
+    {
+      "id": "gridcraft",
+      "name": "GridCraft",
+      "tagline": "电子表格与数据处理",
+      "ref": "Microsoft Excel",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/gridcraft",
+      "docs": "https://getartcraft.com/apps/gridcraft",
+      "cli": "gridcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态（send <port> 直发）",
+      "mcp": true,
+      "subcommands": [
+        { "name": "info", "usage": "info <file> [--json]", "summary": "工作表/已用范围/表格/图表/名称" },
+        { "name": "convert", "usage": "convert <in> <out> [--sheet NAME]", "summary": "xlsx/csv/tsv/json/html 按扩展名互转" },
+        { "name": "eval", "usage": "eval <formula> [--in FILE] [--sheet S] [--cell A1] [--json]", "summary": "求值公式" },
+        { "name": "cat", "usage": "cat <file> [--range A1:D20] [--sheet S] [--formulas] [--csv]", "summary": "读单元格区域（可含公式）" },
+        { "name": "run", "usage": "run [--in FILE | --sample NAME] [--cmd 'id={json}']… [--script FILE.jsonl] [--out FILE] [--print RANGE] [--quiet]", "summary": "headless 命令批处理（可输出文件/打印区域）" },
+        { "name": "commands", "usage": "commands [--json] [--search X]", "summary": "命令清单" },
+        { "name": "functions", "usage": "functions [--json] [--search X] [--category C]", "summary": "函数库清单" },
+        { "name": "send", "usage": "send <port> <method> [json]", "summary": "向运行中 app 的控制通道直发一条方法" },
+        { "name": "mcp", "usage": "mcp [--connect PORT] [--in FILE | --sample NAME]", "summary": "stdio MCP" }
+      ]
+    },
+    {
+      "id": "cadcraft",
+      "name": "CADCraft",
+      "tagline": "计算机辅助设计与制图",
+      "ref": "Autodesk AutoCAD",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/cadcraft",
+      "docs": "https://getartcraft.com/apps/cadcraft",
+      "cli": "cadcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态（mcp --connect HOST:PORT 桥接运行中的 app）",
+      "mcp": true,
+      "subcommands": [
+        { "name": "info", "usage": "info FILE.dxf", "summary": "图纸摘要" },
+        { "name": "convert", "usage": "convert IN.dxf OUT.(dxf|dwg|svg|png|pdf) [FRAMING]", "summary": "格式转换/出图" },
+        { "name": "run", "usage": "run [FILE | --sample | --metric] [--script TEXT | --script-file F.scr] [--cmd 'id {json}']… [--save OUT.dxf] [--export OUT.(png|svg|pdf)] [FRAMING]", "summary": "headless 执行（支持 AutoCAD 风格 .scr 脚本）后存/出图" },
+        { "name": "commands", "usage": "commands [FILTER]", "summary": "命令清单" },
+        { "name": "sample", "usage": "sample (bracket|floorplan) OUT.(dxf|dwg|svg|png)", "summary": "生成示例图（支架/户型平面）" },
+        { "name": "perf", "usage": "perf [N]", "summary": "性能基准" },
+        { "name": "mcp", "usage": "mcp [--connect HOST:PORT]", "summary": "stdio MCP" },
+        { "name": "FRAMING", "usage": "--window x0,y0,x1,y1 | --view extents|current", "summary": "出图取景：指定矩形（图形单位）或范围/当前视图" }
+      ]
+    },
+    {
+      "id": "soundcraft",
+      "name": "SoundCraft",
+      "tagline": "音频录制、编辑与混音",
+      "ref": "Avid Pro Tools",
+      "stage": "in development",
+      "repo": "https://github.com/storytold/soundcraft",
+      "docs": "https://getartcraft.com/apps/soundcraft",
+      "cli": "soundcraft-cli",
+      "control": null,
+      "controlNote": "控制通道端口动态：app --port P 启动后用 artcraft_control 的 port 参数直连",
+      "mcp": true,
+      "subcommands": [
+        { "name": "info", "usage": "info FILE", "summary": "音频文件或 .scraft 工程摘要" },
+        { "name": "convert", "usage": "convert IN OUT [--bit-depth 16|24|32f] [--rate HZ] [--normalize]", "summary": "音频转换（位深/采样率/响度归一）" },
+        { "name": "run", "usage": "run [--in S.scraft | --demo] [--cmd ID[=JSON]]… [--bounce OUT] [--start T --end T] [--save S.scraft] [--inspect]", "summary": "headless 命令批处理并 bounce（区间可选）" },
+        { "name": "script", "usage": "script FILE [--in S | --demo] [--save S] [--bounce OUT]", "summary": "脚本批处理（每行 `ID JSON`）" },
+        { "name": "commands", "usage": "commands [FILTER]", "summary": "命令清单" },
+        { "name": "describe", "usage": "describe ID", "summary": "单命令详情" },
+        { "name": "app", "usage": "app [--port P] METHOD [JSON]", "summary": "调用运行中 app 的控制通道" },
+        { "name": "parity", "usage": "parity [--write PATH]", "summary": "特性对照报告（markdown）" },
+        { "name": "plugins", "usage": "plugins", "summary": "内置插件清单" },
+        { "name": "mcp", "usage": "mcp [--connect PORT] [--demo]", "summary": "stdio MCP" }
+      ]
+    }
+  ]
+}

package/artcraft.config.json.example

@@ -6,7 +6,12 @@
     "lightcraft": "C:/Program Files/LightCraft",
     "pdfcraft": "C:/Program Files/PdfCraft",
     "effectcraft": "C:/Program Files/EffectCraft",
-    "designcraft": "C:/Program Files/DesignCraft"
+    "designcraft": "C:/Program Files/DesignCraft",
+    "wordcraft": "C:/Program Files/WordCraft",
+    "deckcraft": "C:/Program Files/DeckCraft",
+    "gridcraft": "C:/Program Files/GridCraft",
+    "cadcraft": "C:/Program Files/CADCraft",
+    "soundcraft": "C:/Program Files/SoundCraft"
   },
   "control": {
     "filmcraft": 9876,

package/client.js

@@ -15,7 +15,7 @@ window.__ModuleLoader__.load({
 
     const NS = 'artcraft';
     const API = '/artcraft/api';
-    const LABELS = { photocraft: 'PhotoCraft', vectorcraft: 'VectorCraft', filmcraft: 'FilmCraft', lightcraft: 'LightCraft', pdfcraft: 'PdfCraft', effectcraft: 'EffectCraft', designcraft: 'DesignCraft' };
+    const LABELS = { photocraft: 'PhotoCraft', vectorcraft: 'VectorCraft', filmcraft: 'FilmCraft', lightcraft: 'LightCraft', pdfcraft: 'PdfCraft', effectcraft: 'EffectCraft', designcraft: 'DesignCraft', wordcraft: 'WordCraft', deckcraft: 'DeckCraft', gridcraft: 'GridCraft', cadcraft: 'CADCraft', soundcraft: 'SoundCraft' };
 
     const CSS = `
 .dshac-card { border: 1px solid var(--dsw-border-primary, rgba(128,128,128,.35)); border-radius: 10px; padding: 12px; font-size: 13px; line-height: 1.5; }
@@ -62,10 +62,19 @@ window.__ModuleLoader__.load({
       useEffect(() => () => { alive.current = false; }, []);
 
       const loadStatus = useCallback(async () => {
+        setBusy('refresh');
         try {
+          // 刷新 = 状态 + 顺带一次家族安装探测（后装软件/改安装目录后自动修正配置；
+          // 探测端点在旧版插件上不存在时静默跳过）
+          try {
+            await api('/discover', {
+              method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}',
+            });
+          } catch { /* 旧版无此路由 → 静默跳过 */ }
           const s = await api('/status');
           if (alive.current) { setStatus(s); setStatusErr(null); }
         } catch (e) { if (alive.current) setStatusErr(String(e.message || e)); }
+        finally { if (alive.current) setBusy(''); }
       }, []);
 
       const checkUpdate = useCallback(async () => {

package/index.js

@@ -8,11 +8,12 @@
  *
  * 两种形态：
  *   1) Agent Tools（对话内直接驱动）:
- *        artcraft_status  —— 检查 7 个家族 CLI 是否可用、配置目录、控制通道配置
- *        artcraft_cli     —— 运行 7 个家族 CLI 任意命令（cwd / 文件参数由调用方给绝对路径）
- *        artcraft_control —— 向运行中的 FilmCraft/EffectCraft JSON 控制通道发一条命令
+ *        artcraft_status  —— 检查 12 个家族 CLI 是否可用、配置目录、控制通道配置
+ *        artcraft_cli     —— 运行 12 个家族 CLI 任意命令（cwd / 文件参数由调用方给绝对路径）
+ *        artcraft_control —— 向运行中的 FilmCraft/EffectCraft/VectorCraft/LightCraft JSON 控制通道发一条命令
  *        artcraft_fs      —— 桥接文件操作（list/stat/readtext/write/mkdir，绝对路径）
  *        artcraft_update  —— 插件自身更新（检查/应用）
+ *        artcraft_apps    —— 12 个家族应用的自动化能力目录（子命令/控制端口/MCP/仓库）
  *   2) HTTP API（同源 /artcraft/api/*，供无限画布等前端调用，无 CORS 问题）:
  *        GET  /artcraft/api/status     环境自检
  *        GET  /artcraft/api/fs         list / stat / readtext
@@ -22,11 +23,14 @@
  *        POST /artcraft/api/job        启动长任务（渲染/导出/批处理）
  *        POST /artcraft/api/job/cancel 取消任务
  *        POST /artcraft/api/control    控制通道同步调用（engine.execute / ui.*）
+ *        GET  /artcraft/api/apps       家族能力目录（list / ?id= 单个）
  *
  * 安全约定：
- *   - 子进程只允许 7 个白名单键（家族 CLI），具体可执行文件由 artcraft.config.json 指定；
+ *   - 子进程只允许 12 个白名单键（家族 CLI），具体可执行文件由 artcraft.config.json 指定；
  *   - 控制通道只连 127.0.0.1，与 ArtCraft 官方协议一致（App 需以 --control 启动；
- *     PhotoCraft 的控制通道为鉴权模式，本插件不代理，故仅支持 filmcraft/effectcraft）；
+ *     已知默认端口：filmcraft 9876 / effectcraft 9877 / vectorcraft 7979 / lightcraft 7980；
+ *     PhotoCraft 控制通道为令牌鉴权模式、PdfCraft 为文件式（--control FILE），均不代理；
+ *     其余应用端口动态，用 port 参数直连）；
  *   - 本插件与 infinite-canvas 零代码耦合，仅通过 HTTP + 调用方给定路径协作。
  *
  * 信任模型：HTTP API 无鉴权，随 DSH Web GUI 仅监听回环；不要把 GUI 端口暴露到局域网。
@@ -42,12 +46,15 @@ import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 
 const NAME = 'artcraft';
-const VERSION = '0.2.7';
+const VERSION = '0.2.9';
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 
-const BINS = ['photocraft', 'vectorcraft', 'filmcraft', 'lightcraft', 'pdfcraft', 'effectcraft', 'designcraft'];
+const BINS = [
+  'photocraft', 'vectorcraft', 'filmcraft', 'lightcraft', 'pdfcraft', 'effectcraft',
+  'designcraft', 'wordcraft', 'deckcraft', 'gridcraft', 'cadcraft', 'soundcraft',
+];
 const PKG_NAME = '@ninkch/dsh-artcraft';
-const DEFAULT_PORTS = { filmcraft: 9876, effectcraft: 9877 };
+const DEFAULT_PORTS = { filmcraft: 9876, effectcraft: 9877, vectorcraft: 7979, lightcraft: 7980 };
 
 const BODY_CAP = 2 * 1024 * 1024;            // 普通 JSON 请求体上限
 const WRITE_CAP = 320 * 1024 * 1024;         // 上传（写盘）上限
@@ -66,10 +73,22 @@ const DEFAULT_CONFIG = {
     pdfcraft: 'pdfcraft-cli',
     effectcraft: 'effectcraft-cli',
     designcraft: 'designcraft-cli',
+    wordcraft: 'wordcraft-cli',
+    deckcraft: 'deckcraft-cli',
+    gridcraft: 'gridcraft-cli',
+    cadcraft: 'cadcraft-cli',
+    soundcraft: 'soundcraft-cli',
   },
   control: { ...DEFAULT_PORTS },
 };
 
+const APP_DISPLAY = {
+  photocraft: 'PhotoCraft', vectorcraft: 'VectorCraft', filmcraft: 'FilmCraft',
+  lightcraft: 'LightCraft', pdfcraft: 'PdfCraft', effectcraft: 'EffectCraft',
+  designcraft: 'DesignCraft', wordcraft: 'WordCraft', deckcraft: 'DeckCraft',
+  gridcraft: 'GridCraft', cadcraft: 'CADCraft', soundcraft: 'SoundCraft',
+};
+
 /* ============================ 配置 ============================ */
 
 async function loadConfig() {
@@ -77,6 +96,7 @@ async function loadConfig() {
     bins: { ...DEFAULT_CONFIG.bins },
     control: { ...DEFAULT_PORTS },
     configPath: null, // 实际生效的配置文件（供界面显示"配置目录"）
+    autoDiscovered: false, // 首次运行是否由自动探测生成了配置
   };
   // 配置查找顺序：~/.dsh（持久，推荐 —— 更新替换包目录也不丢）→ 包目录（旧版兼容）
   const candidates = [
@@ -101,9 +121,46 @@ async function loadConfig() {
       break; // 第一个可解析的配置生效
     } catch { /* 该候选不存在/非法 → 试下一个 */ }
   }
+  // 首次运行（没有任何配置文件）：自动探测本机家族软件安装位置并生成持久配置
+  if (!cfg.configPath) {
+    try {
+      const found = await discoverBinPaths();
+      const target = path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+      await fs.mkdir(path.dirname(target), { recursive: true });
+      await fs.writeFile(target, JSON.stringify({ bins: { ...cfg.bins, ...found }, control: { ...cfg.control } }, null, 2) + '\n');
+      for (const k of Object.keys(found)) cfg.bins[k] = found[k];
+      cfg.configPath = target;
+      cfg.autoDiscovered = Object.keys(found).length > 0;
+    } catch { /* 自动探测失败不影响默认行为 */ }
+  }
   return cfg;
 }
 
+/** 自动探测：扫描常见安装位置（Program Files 等）里的家族 CLI */
+async function discoverBinPaths() {
+  const isWin = process.platform === 'win32';
+  const pf = process.env['ProgramFiles'] || (isWin ? 'C:\\Program Files' : '/usr/local/bin');
+  const pf86 = process.env['ProgramFiles(x86)'] || '';
+  const lap = process.env['LOCALAPPDATA']
+    ? path.join(process.env['LOCALAPPDATA'], 'Programs')
+    : path.join(os.homedir(), '.local');
+  const roots = [pf, ...(pf86 ? [pf86] : []), lap];
+  const found = {};
+  for (const key of BINS) {
+    const cliName = cliNameFor(key);
+    const names = [APP_DISPLAY[key], key, key.toUpperCase(), key.toLowerCase()];
+    outer: for (const root of roots) {
+      for (const name of names) {
+        const exe = path.join(root, name, cliName);
+        try {
+          if ((await fs.stat(exe)).isFile()) { found[key] = path.join(root, name); break outer; }
+        } catch { /* 继续 */ }
+      }
+    }
+  }
+  return found;
+}
+
 /* ============================ 路径与进程 ============================ */
 
 /**
@@ -421,7 +478,7 @@ async function statusInfo(cfg, meta) {
     plugin: NAME,
     version: VERSION,
     platform: process.platform,
-    config: { path: configPath, found: !!configPath },
+    config: { path: configPath, found: !!configPath, autoDiscovered: !!cfg.autoDiscovered },
     bins,
     control: cfg.control,
     jobs: {
@@ -533,17 +590,30 @@ async function detectInstall() {
   return { mode: repoDir ? 'git' : 'npm', here, real, repoDir, profileDir, gitClean, branch };
 }
 
+const REGISTRIES = ['https://registry.npmjs.org', 'https://registry.npmmirror.com'];
+
 async function fetchLatestVersion() {
-  const url = `https://registry.npmjs.org/${PKG_NAME.replace('/', '%2f')}/latest`;
-  try {
-    const res = await fetch(url, { signal: AbortSignal.timeout(12000) });
-    if (res.status === 404) return { latest: null, note: 'npm 上还没有这个包' };
-    if (!res.ok) throw new Error('registry 返回 ' + res.status);
-    const j = await res.json();
-    return { latest: j.version ?? null, tarball: j.dist?.tarball ?? null, integrity: j.dist?.integrity ?? null };
-  } catch (e) {
-    return { latest: null, note: '查询 npm 失败: ' + String(e?.cause?.message || e?.message || e) };
+  const slug = PKG_NAME.replace('/', '%2f');
+  const errors = [];
+  // 回退链：官方源 → npmmirror 镜像（国内无代理机器也能完成检查与更新）
+  for (const reg of REGISTRIES) {
+    try {
+      const res = await fetch(`${reg}/${slug}/latest`, { signal: AbortSignal.timeout(12000) });
+      if (res.status === 404) { errors.push(`${reg}: 404`); continue; }
+      if (!res.ok) throw new Error('HTTP ' + res.status);
+      const j = await res.json();
+      if (!j.version) { errors.push(`${reg}: 无版本数据`); continue; }
+      return {
+        latest: j.version ?? null,
+        tarball: j.dist?.tarball ?? null,
+        integrity: j.dist?.integrity ?? null,
+        source: reg,
+      };
+    } catch (e) {
+      errors.push(`${reg}: ${String(e?.cause?.message || e?.message || e)}`);
+    }
   }
+  return { latest: null, note: '查询失败（官方源与 npmmirror 均不可达）—— ' + errors.join('；') };
 }
 
 async function updateCheck() {
@@ -585,8 +655,20 @@ async function updateApply() {
   await fs.mkdir(tmp, { recursive: true });
   try {
     const tgzPath = path.join(tmp, 'pkg.tgz');
-    const res = await fetch(meta.tarball, { signal: AbortSignal.timeout(180000) });
-    if (!res.ok) throw new Error('下载 tarball 失败: HTTP ' + res.status);
+    // 下载：优先元数据自带的官方地址；失败时回退 npmmirror 镜像（sha512 校验保证内容一致）
+    let res;
+    try {
+      res = await fetch(meta.tarball, { signal: AbortSignal.timeout(180000) });
+      if (!res.ok) throw new Error('HTTP ' + res.status);
+    } catch (e) {
+      const slug = PKG_NAME.replace('/', '%2f');
+      const mirrorUrl = `https://registry.npmmirror.com/${slug}/-/${PKG_NAME.split('/')[1]}-${meta.latest}.tgz`;
+      WriteMirrorRetry: {
+        res = await fetch(mirrorUrl, { signal: AbortSignal.timeout(180000) });
+        if (!res.ok) throw new Error('HTTP ' + res.status);
+        break WriteMirrorRetry;
+      }
+    }
     const buf = Buffer.from(await res.arrayBuffer());
     if (buf.length > 64 * 1024 * 1024) throw new Error('tarball 超过 64MB 上限，已终止');
     const digest = crypto.createHash('sha512').update(buf).digest('base64');
@@ -663,7 +745,7 @@ export function apply(ctx) {
 
     attempt({
       name: 'artcraft_status',
-      description: '检查 ArtCraft 家族 7 个 CLI 是否可用，报告配置目录、控制通道端口与任务状态。本插件只是桥接，产物路径由调用方决定。',
+      description: '检查 ArtCraft 家族 12 个 CLI 是否可用，报告配置目录、控制通道端口与任务状态。本插件只是桥接，产物路径由调用方决定。',
       schema: { type: 'object', properties: {}, additionalProperties: false },
       async execute() {
         const cfg = await loadConfig();
@@ -673,7 +755,7 @@ export function apply(ctx) {
 
     attempt({
       name: 'artcraft_cli',
-      description: '运行 ArtCraft 家族 CLI 的任意子命令（photocraft-cli / filmcraft-cli / effectcraft-cli）。长渲染请改用 HTTP POST /artcraft/api/job 后台执行。',
+      description: '运行 ArtCraft 家族 CLI 的任意子命令（photocraft-cli / wordcraft-cli / soundcraft-cli 等 12 个，bin 参数的 enum 即完整清单）。长渲染请改用 HTTP POST /artcraft/api/job 后台执行。',
       schema: {
         type: 'object',
         properties: {
@@ -697,24 +779,25 @@ export function apply(ctx) {
 
     attempt({
       name: 'artcraft_control',
-      description: '向运行中的 FilmCraft(--control 9876) / EffectCraft(--control 9877) JSON 控制通道发送一条命令，如 engine.execute / ui.screenshot。PhotoCraft 控制通道为鉴权模式，不在代理范围。',
+      description: '向运行中的 ArtCraft JSON 控制通道发送一条命令（同族 JSON-lines 协议：engine.execute / engine.commands / ui.inspect / ui.screenshot…）。已知默认端口：filmcraft(--control 9876) / effectcraft(9877) / vectorcraft(7979) / lightcraft(7980)；其余应用端口动态，可传 port 直连。PhotoCraft 控制通道为令牌鉴权模式、PdfCraft 为文件式，不在代理范围。',
       schema: {
         type: 'object',
         properties: {
-          app: { type: 'string', enum: ['filmcraft', 'effectcraft'], description: '目标应用（决定端口）' },
-          method: { type: 'string', description: '如 engine.execute / ui.inspect / ui.screenshot' },
+          app: { type: 'string', enum: ['filmcraft', 'effectcraft', 'vectorcraft', 'lightcraft'], description: '目标应用（决定默认端口）' },
+          port: { type: 'number', description: '可选：直接指定端口（覆盖 app 默认；用于端口动态的应用）' },
+          method: { type: 'string', description: '如 engine.execute / engine.commands / ui.inspect / ui.screenshot' },
           params: { type: 'object', description: '命令参数' },
           timeoutMs: { type: 'number' },
         },
-        required: ['app', 'method'],
+        required: ['method'],
         additionalProperties: false,
       },
       async execute(args) {
         const cfg = await loadConfig();
-        const port = cfg.control[String(args.app)];
-        if (!port) throw new Error(`未知 app: ${args.app}`);
+        const port = Number(args.port) > 0 ? Number(args.port) : cfg.control[String(args.app ?? '')];
+        if (!(Number(port) > 0)) throw new Error('需要 app (filmcraft|effectcraft|vectorcraft|lightcraft) 或 port');
         const result = await controlCall(port, String(args.method), args.params ?? {}, { timeoutMs: args.timeoutMs });
-        return { app: args.app, port, method: args.method, result };
+        return { app: args.app ?? null, port, method: args.method, result };
       },
     });
 
@@ -793,6 +876,92 @@ export function apply(ctx) {
       },
     });
 
+    attempt({
+      name: 'artcraft_discover',
+      description: '自动探测本机 ArtCraft 家族软件安装位置（Program Files / LocalAppData\\Programs 等），写入/修复配置：填充默认空缺项，并自动纠正已失效的路径（改安装目录、卸载重装到别处）；用户显式配置仍有效则不动。',
+      schema: { type: 'object', properties: {}, additionalProperties: false },
+      async execute() {
+        const cfg = await loadConfig();
+        const found = await discoverBinPaths();
+        const applied = {};
+        for (const k of BINS) {
+          if (!found[k]) continue;
+          let effective = null;
+          try { effective = await resolveBin(cfg, k); } catch { /* 未配置 */ }
+          const ok = effective ? await fileExists(effective) : false;
+          if (ok) continue; // 现有配置仍有效 → 不动
+          applied[k] = found[k];
+        }
+        if (!Object.keys(applied).length) {
+          return { applied: {}, configPath: cfg.configPath, note: '家族程序路径均已就绪，无需更新' };
+        }
+        const target = cfg.configPath || path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+        let obj = {};
+        try { obj = JSON.parse(await fs.readFile(target, 'utf8')); } catch { /* 新文件 */ }
+        obj.bins = { ...(obj.bins ?? {}), ...applied };
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.writeFile(target, JSON.stringify(obj, null, 2) + '\n');
+        return { applied, configPath: target, note: '已写入配置，立即生效' };
+      },
+    });
+
+    attempt({
+      name: 'artcraft_recipes',
+      description: '内置专家处理方案库：ArtCraft 家族的专业工作流配方（短剧海报、分镜批量调色、横转竖、响度标准化、SRT 字幕烧录、动态片头、多平台分发包、先探测后验证纪律）。action=list 列出全部；action=get + id 取单个配方的专业原则、执行步骤与验证清单。',
+      schema: {
+        type: 'object',
+        properties: {
+          action: { type: 'string', enum: ['list', 'get'] },
+          id: { type: 'string', description: 'action=get 时的配方 id' },
+        },
+        required: ['action'],
+        additionalProperties: false,
+      },
+      async execute(args) {
+        const recipesPath = path.join(HERE, 'recipes', 'recipes.json');
+        const catalog = JSON.parse(await fs.readFile(recipesPath, 'utf8'));
+        if (String(args.action) === 'get') {
+          const r = catalog.recipes.find((x) => x.id === String(args.id ?? ''));
+          if (!r) throw new Error('配方不存在: ' + args.id + '（可用: ' + catalog.recipes.map((x) => x.id).join(', ') + '）');
+          return r;
+        }
+        return {
+          version: catalog.version,
+          recipes: catalog.recipes.map((r) => ({ id: r.id, title: r.title, apps: r.apps, goal: r.goal })),
+          hint: 'action=get + id 取完整配方（专业原则 + 执行步骤 + 验证清单）',
+        };
+      },
+    });
+
+    attempt({
+      name: 'artcraft_apps',
+      description: 'ArtCraft 家族 12 应用的自动化能力目录：每个应用的定位、对标软件、CLI 子命令用法、控制通道端口、MCP 可用性与仓库/文档链接。action=list 列出全部；action=get + id 取单个应用的完整能力卡。要拿某应用的实时命令注册表，用 artcraft_cli 跑该应用的 commands 子命令。',
+      schema: {
+        type: 'object',
+        properties: {
+          action: { type: 'string', enum: ['list', 'get'] },
+          id: { type: 'string', description: 'action=get 时的应用 id（如 wordcraft）' },
+        },
+        required: ['action'],
+        additionalProperties: false,
+      },
+      async execute(args) {
+        const catalogPath = path.join(HERE, 'apps', 'catalog.json');
+        const catalog = JSON.parse(await fs.readFile(catalogPath, 'utf8'));
+        if (String(args.action) === 'get') {
+          const a = catalog.apps.find((x) => x.id === String(args.id ?? ''));
+          if (!a) throw new Error('应用不存在: ' + args.id + '（可用: ' + catalog.apps.map((x) => x.id).join(', ') + '）');
+          return a;
+        }
+        return {
+          version: catalog.version,
+          controlProtocol: catalog.controlProtocol,
+          apps: catalog.apps.map((a) => ({ id: a.id, name: a.name, tagline: a.tagline, ref: a.ref, cli: a.cli, control: a.control, mcp: a.mcp, stage: a.stage })),
+          hint: 'action=get + id 取完整能力卡（子命令用法 + 控制端口 + 仓库/文档链接）',
+        };
+      },
+    });
+
     return () => {
       for (const d of disposers) { try { d(); } catch { /* ignore */ } }
     };
@@ -939,12 +1108,60 @@ export function apply(ctx) {
         sendJson(res, 200, await updateApply());
       }),
 
+      makeRoute(`/${NAME}/api/discover`, async (req, res) => {
+        if (req.method !== 'POST') throw new Error('仅支持 POST');
+        const cfg = await loadConfig();
+        const found = await discoverBinPaths();
+        // 只填充默认空缺项；显式配置仅在已失效（改安装目录/卸载重装）时自动纠正，有效则不动
+        const applied = {};
+        for (const k of BINS) {
+          if (!found[k]) continue;
+          let effective = null;
+          try { effective = await resolveBin(cfg, k); } catch { /* 未配置 */ }
+          const ok = effective ? await fileExists(effective) : false;
+          if (ok) continue;
+          applied[k] = found[k];
+        }
+        if (Object.keys(applied).length) {
+          const target = cfg.configPath || path.join(os.homedir(), '.dsh', 'artcraft.config.json');
+          let obj = {};
+          try { obj = JSON.parse(await fs.readFile(target, 'utf8')); } catch { /* 新文件 */ }
+          obj.bins = { ...(obj.bins ?? {}), ...applied };
+          await fs.mkdir(path.dirname(target), { recursive: true });
+          await fs.writeFile(target, JSON.stringify(obj, null, 2) + '\n');
+        }
+        sendJson(res, 200, {
+          discovered: found,
+          applied,
+          configPath: cfg.configPath,
+          note: Object.keys(applied).length ? '已探测并写入配置，立即生效' : '没有需要更新的家族程序',
+        });
+      }),
+
+      makeRoute(`/${NAME}/api/apps`, async (req, res) => {
+        if (req.method !== 'GET') throw new Error('仅支持 GET');
+        const url = new URL(req.url, 'http://x');
+        const id = url.searchParams.get('id');
+        const catalog = JSON.parse(await fs.readFile(path.join(HERE, 'apps', 'catalog.json'), 'utf8'));
+        if (id) {
+          const a = catalog.apps.find((x) => x.id === id);
+          if (!a) throw new Error('应用不存在: ' + id + '（可用: ' + catalog.apps.map((x) => x.id).join(', ') + '）');
+          sendJson(res, 200, a);
+          return;
+        }
+        sendJson(res, 200, {
+          version: catalog.version,
+          controlProtocol: catalog.controlProtocol,
+          apps: catalog.apps.map((a) => ({ id: a.id, name: a.name, tagline: a.tagline, ref: a.ref, cli: a.cli, control: a.control, mcp: a.mcp, stage: a.stage })),
+        });
+      }),
+
       makeRoute(`/${NAME}/api/control`, async (req, res) => {
         if (req.method !== 'POST') throw new Error('仅支持 POST');
         const cfg = await loadConfig();
         const body = await readJson(req);
         const port = body.port ?? cfg.control[String(body.app ?? '')];
-        if (!(Number(port) > 0)) throw new Error('需要 app (filmcraft|effectcraft) 或 port');
+        if (!(Number(port) > 0)) throw new Error('需要 app (filmcraft|effectcraft|vectorcraft|lightcraft) 或 port');
         const result = await controlCall(
           Number(port),
           String(body.method),

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ninkch/dsh-artcraft",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
-  "description": "Drive the open-source ArtCraft studio apps (PhotoCraft / FilmCraft / EffectCraft) from DeepSeek Harness ? agent tools, a same-origin HTTP API, and plugins-page status with self-update.",
+  "description": "Drive the open-source ArtCraft studio suite (12 family apps: PhotoCraft, VectorCraft, FilmCraft, LightCraft, PdfCraft, EffectCraft, DesignCraft, WordCraft, DeckCraft, GridCraft, CADCraft, SoundCraft) from DeepSeek Harness: agent tools, a same-origin HTTP API, and plugins-page status with self-update.",
   "keywords": [
     "deepseek-harness",
     "dsh-plugin",
@@ -35,6 +35,8 @@
     "client.js",
     "cordis.patch.yml",
     "artcraft.config.json.example",
+    "apps",
+    "recipes",
     "README.md",
     "README.zh-CN.md",
     "NOTICE.md"

package/recipes/recipes.json

@@ -0,0 +1,143 @@
+{
+  "version": 1,
+  "updated": "2026-10-10",
+  "recipes": [
+    {
+      "id": "poster-short-drama",
+      "title": "短剧海报（竖版）",
+      "apps": ["photocraft"],
+      "goal": "生成竖版短剧海报：标题层级、装饰元素、无损输出",
+      "principles": [
+        "视觉层级：主标题 → 副标题 → 装饰元素，字号/字重至少差 2 级，同屏不超过 3 个信息层",
+        "对比度：文字与背景亮度差 ≥ 4.5:1，浅背景加深色字，深背景加浅色字，或加投影/描边兜底",
+        "安全边距：四周留 5% 不放关键内容（平台裁切友好）",
+        "中文字体显式指定（如 Noto Sans SC），不要依赖默认字体（缺 CJK 字形会变方框）",
+        "HTTP 传中文参数一律走 UTF-8 字节体，避免编码损坏"
+      ],
+      "steps": [
+        "photocraft-cli run --new '{\"width\":1080,\"height\":1440}' --cmd <背景填充/渐变命令> --out <工作空间>/poster.png",
+        "标题：Noto Sans SC，主标题字号 ≥ 120，副标题 ≤ 48；装饰条用像素层绘制",
+        "逐层 --cmd 叠加（每条 --params 作用于前一个 --cmd），最后 --out 输出 PNG 无损"
+      ],
+      "checks": ["取回产物做视觉检查：字形完整、层级清晰、四边安全区无关键内容"]
+    },
+    {
+      "id": "storyboard-color-grade",
+      "title": "分镜批量调色（一致性）",
+      "apps": ["photocraft"],
+      "goal": "整批分镜图统一色调，保持跨镜一致性",
+      "principles": [
+        "先定基调再微调：一条柔和 S 曲线 + 少量 vibrance，避免逐张各调各的",
+        "保护肤色：调整幅度宁小勿大，人脸偏色比不够风格化更伤观感",
+        "锐化放在调色之后（amount 60-80），避免锐化放大噪点",
+        "actions.json 一处定义、整批复用，保证批次内完全一致"
+      ],
+      "steps": [
+        "写 craft/grade.json：[{\"cmd\":\"layer.newAdjustmentLayer.curves\",\"params\":{\"points\":[[0,0],[64,48],[192,212],[255,255]]}},{\"cmd\":\"filter.sharpen.smartSharpen\",\"params\":{\"amount\":80}}]",
+        "photocraft-cli batch --actions <项目>/craft/grade.json --in <项目>/media --out <项目>/out/graded",
+        "抽 2-3 张对比原图检查，不满意只调曲线中段（64,48 / 192,212 两点）重跑"
+      ],
+      "checks": ["抽样对比：同场景相邻分镜色调一致；高光不过曝、暗部不死黑"]
+    },
+    {
+      "id": "vertical-reframe",
+      "title": "横转竖重构图",
+      "apps": ["filmcraft", "photocraft"],
+      "goal": "16:9 素材适配 9:16 竖屏，三种策略按画面主体选择",
+      "principles": [
+        "策略选择：主体居中 → 居中裁切；主体偏侧 → 位移裁切（保主体）；多主体/全景 → 模糊填充（上原图下补景，不裁掉信息）",
+        "人脸安全：裁切框上缘留在头顶上方 10%，下缘到胸口",
+        "分辨率对齐目标平台：抖音/快手/视频号 1080×1920@30fps"
+      ],
+      "steps": [
+        "filmcraft-cli probe <素材> 先量分辨率/时长/帧率（永远先探测再动手）",
+        "序列设 1080×1920@30，放置后按位移/缩放保留主体",
+        "导出 H.264：--quality 80 起步"
+      ],
+      "checks": ["导出后 probe 验证分辨率/时长；抽帧目检主体完整、不切脸"]
+    },
+    {
+      "id": "loudness-web",
+      "title": "网络平台响度标准化",
+      "apps": ["filmcraft"],
+      "goal": "成片响度对齐平台标准，避免用户手动调音量",
+      "principles": [
+        "主流短视频平台目标：integrated -14 LUFS，true peak ≤ -1 dBTP",
+        "导出时一次完成（file.exportMedia loudnessLufs 参数），不要二次压限",
+        "BGM 与人声分层：人声为主轨，BGM 侧链闪避 6-10 dB"
+      ],
+      "steps": [
+        "exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"loudnessLufs\":-14,\"wait\":true}",
+        "probe 产物核对时长/编码/音轨"
+      ],
+      "checks": ["probe 报告音轨存在且响度参数已应用；多平台分发时每平台独立导出"]
+    },
+    {
+      "id": "srt-burn",
+      "title": "字幕烧录（SRT）",
+      "apps": ["filmcraft"],
+      "goal": "SRT 字幕导入并烧录进成片",
+      "principles": [
+        "单行 ≤ 15 个中文字符，超长拆条；每条最短停留 1 秒",
+        "位置：底部安全区，避开平台 UI（进度条/互动栏约占底部 15%）",
+        "样式统一：描边 2-3px 或半透明底条，全片一种字体"
+      ],
+      "steps": [
+        "exec captions.import {\"path\":<srt 绝对路径>}",
+        "可选 exec captions.setStyle {\"font\":…,\"size\":…,\"outline\":…}",
+        "exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"burnCaptions\":true,\"wait\":true}"
+      ],
+      "checks": ["抽帧目检字幕：无溢出、无遮挡主体、时间轴同步"]
+    },
+    {
+      "id": "title-motion",
+      "title": "动态片头/花字（EffectCraft）",
+      "apps": ["effectcraft"],
+      "goal": "生成动态片头，叠加回剪辑或直接使用",
+      "principles": [
+        ".ecproj 是版本化 JSON —— 直接生成或模板替换文本，比逐帧描述高效",
+        "动画时长 1.5-3s：入场 0.3-0.5s 缓动（ease），停留 ≥ 1s，出场 0.3s",
+        "双出口：MP4 直用；或导出 Lottie 嵌网页预览；带 alpha 的 ProRes 4444 可叠进 FilmCraft 当图形层"
+      ],
+      "steps": [
+        "生成/填充 intro.ecproj（composition 尺寸对齐主序列）",
+        "effectcraft-cli render --comp Main --out <项目>/out/intro.mp4 <项目>/craft/intro.ecproj",
+        "或 exec file.exportLottie 导出 .json 给网页端播放"
+      ],
+      "checks": ["render 后 probe 时长/分辨率；视觉检查动画节奏（入场不突兀、停留可读完整标题）"]
+    },
+    {
+      "id": "delivery-pack",
+      "title": "多平台分发包",
+      "apps": ["filmcraft"],
+      "goal": "同一成片产出多平台版本（分辨率/帧率/响度/命名规范）",
+      "principles": [
+        "平台参数表：抖音/快手/视频号 1080×1920@30 -14LUFS；B 站/西瓜 1920×1080@30 -14LUFS",
+        "命名规范：<项目>_<平台>_v<序号>.mp4，一次导出成组不散落",
+        "每平台独立导出（各自过 loudness 与 probe），不要一份文件多处转发"
+      ],
+      "steps": [
+        "逐平台 exec file.exportMedia {\"path\":<out>,\"format\":\"h264\",\"width\":…,\"height\":…,\"loudnessLufs\":-14,\"wait\":true}",
+        "每个产物跑一次 probe 核对"
+      ],
+      "checks": ["probe 全部产物：分辨率/帧率/音轨符合平台表；文件命名一致"]
+    },
+    {
+      "id": "probe-verify",
+      "title": "通用纪律：先探测、后验证",
+      "apps": ["filmcraft", "photocraft", "effectcraft"],
+      "goal": "所有媒体操作的通用工作流纪律（来自专业剪辑技能的通用实践）",
+      "principles": [
+        "先探测再动手：永远先 probe 素材拿真实时长/分辨率/帧率/音轨，不从文件名猜",
+        "能无损不重编：剪切片段优先流复制，只在必须（精确剪切/滤镜/换格式）时重编码",
+        "做完必验证：产物 probe 一次 + 关键帧目检，报告里写明验证结果",
+        "诚实标注：成功是 Done、失败是 Failed，部分完成必须写出缺口"
+      ],
+      "steps": [
+        "任何处理前：filmcraft-cli probe <media>",
+        "处理后：filmcraft-cli probe <out> + 抽帧目检"
+      ],
+      "checks": ["probe 输出与预期一致；差异写入报告而不是含糊带过"]
+    }
+  ]
+}