@ninkch/dsh-artcraft 0.2.8 → 0.2.10

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; }
@@ -83,9 +83,12 @@ window.__ModuleLoader__.load({
           const u = await api('/update/check');
           if (!alive.current) return;
           setUpd(u);
-          setOut(u.updateAvailable
-            ? `有新版本：v${u.latest}（当前 v${u.current}），安装方式：${u.mode === 'git' ? 'git 仓库' : 'npm 安装'}`
-            : `已是最新${u.latest ? '（npm latest v' + u.latest + '）' : ''}${u.note ? ' · ' + u.note : ''}`);
+          // 待重启优先于"有新版本"：新包已在磁盘、运行中的还是旧代码，重启前不再误导
+          setOut(u.pendingRestart
+            ? `✅ 已更新到 v${u.pendingVersion ?? u.diskVersion ?? '?'}，请重启 Harness 完成更新（运行中的仍是 v${u.current}，页面刷新不够）`
+            : u.updateAvailable
+              ? `有新版本：v${u.latest}（当前 v${u.current}），安装方式：${u.mode === 'git' ? 'git 仓库' : 'npm 安装'}`
+              : `已是最新${u.latest ? '（npm latest v' + u.latest + '）' : ''}${u.note ? ' · ' + u.note : ''}`);
         } catch (e) { if (alive.current) setOut('检查失败：' + String(e.message || e)); }
         finally { if (alive.current) setBusy(''); }
       }, []);
@@ -99,7 +102,11 @@ window.__ModuleLoader__.load({
           // 不自动刷新/重启任何东西：本插件是 Host 半侧代码，生效 = 重启 Harness 进程
           if (r.needRestart) {
             setDone(true);
-            setOut((r.output || '') + '\n\n✅ 更新已写入磁盘。生效方式：重启 DeepSeek Harness（进程级重启，页面刷新不够）。何时重启由你决定。');
+            // 立即把"待重启"写进 upd（服务端事实），后续任何 checkUpdate/重挂载都会保持常驻横幅
+            setUpd((u) => (u
+              ? { ...u, pendingRestart: true, pendingVersion: r.latest ?? u.pendingVersion, diskVersion: r.latest ?? u.diskVersion, updateAvailable: false }
+              : u));
+            setOut((r.output || '') + '\n\n✅ 更新已写入磁盘（v' + (r.latest ?? '?') + '）。生效方式：重启 DeepSeek Harness（进程级重启，页面刷新不够）。何时重启由你决定。');
           }
         } catch (e) { if (alive.current) setOut('更新失败：' + String(e.message || e)); }
         finally { if (alive.current) setBusy(''); }
@@ -134,6 +141,7 @@ window.__ModuleLoader__.load({
         h('div', { className: 'dshac-row', style: { marginTop: '10px' } },
           h('span', { className: 'dshac-muted' },
             '当前 v' + (status?.version ?? upd?.current ?? '?') +
+            (upd?.pendingRestart ? '（磁盘已是 v' + (upd.pendingVersion ?? upd.diskVersion ?? '?') + '，待重启）' : '') +
             (upd ? ' · npm latest v' + (upd.latest ?? '—') : '') +
             (upd?.mode ? '（' + (upd.mode === 'git' ? 'git 仓库' + (upd.gitClean === false ? ' · 有本地改动' : '') : 'npm 安装') + '）' : '')),
           h('button', { className: 'dshac-btn primary', onClick: checkUpdate, disabled: busy !== '' },
@@ -141,11 +149,11 @@ window.__ModuleLoader__.load({
           h('button', {
             className: 'dshac-btn',
             onClick: applyUpdate,
-            disabled: busy !== '' || !upd?.updateAvailable,
-            title: upd?.updateAvailable ? '' : '有新版本时才可应用',
+            disabled: busy !== '' || !upd?.updateAvailable || upd?.pendingRestart,
+            title: upd?.pendingRestart ? '更新已写入磁盘，重启 Harness 后生效' : (upd?.updateAvailable ? '' : '有新版本时才可应用'),
           }, busy === 'apply' ? '更新中…' : '一键更新')),
-        done ? h('div', { className: 'dshac-note' },
-          '更新已写入磁盘。生效方式：重启 DeepSeek Harness（进程级重启，页面刷新不够）。何时重启由你决定 —— 更新不会打断正在运行的任务。') : null,
+        (upd?.pendingRestart || done) ? h('div', { className: 'dshac-note' },
+          '✅ 新版已写入磁盘，请重启 DeepSeek Harness 以完成更新（进程级重启，页面刷新不够）。重启后这里会显示新版本，何时重启由你决定 —— 更新不会打断正在运行的任务。') : null,
         out ? h('div', { className: 'dshac-out' }, out) : null,
       );
     }

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.8';
+const VERSION = '0.2.10';
 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,13 +73,20 @@ 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',
+  lightcraft: 'LightCraft', pdfcraft: 'PdfCraft', effectcraft: 'EffectCraft',
+  designcraft: 'DesignCraft', wordcraft: 'WordCraft', deckcraft: 'DeckCraft',
+  gridcraft: 'GridCraft', cadcraft: 'CADCraft', soundcraft: 'SoundCraft',
 };
 
 /* ============================ 配置 ============================ */
@@ -606,10 +620,22 @@ async function updateCheck() {
   const current = VERSION;
   const { latest, note } = await fetchLatestVersion();
   const info = await detectInstall();
+  // 磁盘版本 vs 运行版本：apply 已把新包写进磁盘（换目录 / git pull），但运行中的进程还是旧代码 ——
+  // 只对比 npm 版本号会让"一键更新后"看起来又回到有新版本。把"待重启"作为服务端事实返回，
+  // 前端据此常驻提示，卡片重挂载/页面刷新都不丢，真重启后（磁盘=运行）自动消失。
+  let diskVersion = null;
+  try {
+    const pj = JSON.parse(await fs.readFile(path.join(HERE, 'package.json'), 'utf8'));
+    diskVersion = typeof pj?.version === 'string' ? pj.version : null;
+  } catch { /* 非关键 */ }
+  const pendingRestart = !!(diskVersion && diskVersion !== current);
   return {
     current,
     latest,
+    diskVersion,
     updateAvailable: !!(latest && semverGt(latest, current)),
+    pendingRestart,
+    pendingVersion: pendingRestart ? diskVersion : null,
     mode: info.mode,
     repoDir: info.repoDir,
     gitClean: info.gitClean,
@@ -731,7 +757,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();
@@ -741,7 +767,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: {
@@ -765,24 +791,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 };
       },
     });
 
@@ -918,6 +945,35 @@ export function apply(ctx) {
       },
     });
 
+    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 */ } }
     };
@@ -1094,12 +1150,30 @@ export function apply(ctx) {
         });
       }),
 
+      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.8",
+  "version": "0.2.10",
   "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,7 @@
     "client.js",
     "cordis.patch.yml",
     "artcraft.config.json.example",
+    "apps",
     "recipes",
     "README.md",
     "README.zh-CN.md",