@ninkch/dsh-artcraft 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,158 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+Format: `## [X.Y.Z] -- date`. Entries are rebuilt from git tags and commit
+history; where the record is incomplete the entry says so instead of guessing.
+
+Released versions are exactly the git tags listed below. Versions without a
+tag (planned but never published) are **not** given entries.
+
+## [0.3.1] -- 2026-10-17
+
+### Fixed
+- `fix(tools)`: pass the computed fallback `output` through to
+  `ctx.tools.register()` -- fixes issue #1, where every agent tool failed to
+  register on DSH 44.0.0 ("must declare output { schema, render,
+  presentationMeta? }") while the HTTP API kept working.
+
+## [0.3.0] -- 2026-10-16
+
+First minor bump, explicitly approved by the maintainer (recorded in
+RELEASING.md); includes everything accumulated since 0.2.10.
+
+### Added
+- `feat`: FigCraft as the 13th family member (bins whitelist, catalog card,
+  capability stats) + the first bundled craft skill pack (7 skills).
+- `feat(skills+chains)`: batch-pipeline and multicam skills, 3 more
+  task-to-command chains, English skill index, frontend contract docs.
+- `feat(qc-v2+refs)`: app-side QC checks and five deeper craft references.
+- `feat(live)`: control-channel liveness probe (`artcraft_live` +
+  `GET /artcraft/api/live`).
+- `feat(ui+recipes)`: plugins-page card shows the bundled skill pack; 3 more
+  orchestration chains.
+- `feat(api)`: capability stats and bundled skill pack over HTTP.
+- `feat(qc+skills)`: deterministic delivery QC tool (`artcraft_qc`) + 2 more
+  craft skills + deep reference files.
+- `chore(release)`: 0.3.0 release commit.
+
+## [0.2.10] -- 2026-10-12
+
+### Fixed
+- `fix(update UX)`: persistent "restart Harness to finish update" state --
+  `/update/check` reports disk-vs-running version mismatch
+  (`pendingRestart`/`pendingVersion`/`diskVersion`); the client keeps the note
+  across re-mounts and suppresses the misleading "update available" state
+  while a restart is pending.
+- `docs(RELEASING)`: GitHub-facing text must be English/ASCII-only --
+  `Invoke-RestMethod` string bodies mangled non-ASCII into `?` (Latin-1
+  fallback); always send UTF-8 bytes + charset and read the body back.
+
+## [0.2.9] -- 2026-10-12
+
+### Added
+- `feat`: family expanded to 12 apps -- WordCraft, DeckCraft, GridCraft,
+  CADCraft, SoundCraft (bins whitelist, CLI defaults, display labels, client
+  card, auto-discovery, example config, docs).
+- `feat`: capability catalog for all 12 family apps -- `apps/catalog.json`
+  (subcommands / control ports / MCP / repos from official docs and local
+  `--help`), `artcraft_apps` tool + `GET /artcraft/api/apps`, control channel
+  extended to vectorcraft (7979) and lightcraft (7980) + port passthrough.
+
+## [0.2.8] -- 2026-10-12
+
+Note: 0.2.7 was planned during this cycle but never published (no tag) -- the
+minor bump was reverted to patch-level increments; the number was reused for
+this release.
+
+### Added
+- `feat!`: bridge semantics -- no `dataRoot`; callers decide paths (chat =
+  conversation workspace, canvas = project dir); the plugins-page card shows
+  the config directory instead. (Breaking API change, shipped as a patch per
+  the versioning rule.)
+- `feat(update)`: registry fallback chain (npmjs -> npmmirror) for update
+  checks and tarball downloads -- unblocks machines without a proxy.
+- `feat`: first-run auto-discovery of family CLI installs (bootstrap config)
+  + `POST /artcraft/api/discover` + `artcraft_discover` tool.
+- `feat`: the refresh button doubles as family-install discovery (creates /
+  repairs the config); `/discover` auto-corrects stale paths.
+- `feat`: built-in expert recipes -- 8 professional workflows with
+  principles/steps/checks + the `artcraft_recipes` tool.
+
+### Changed
+- `ci`: publish via GitHub Release (OIDC) -- the maintainer pushes, no direct
+  pushes from automation.
+- `docs(RELEASING)`: forbid "Frankenstein patches" -- installed copies must
+  come from npm only.
+
+## [0.2.6] -- 2026-10-11
+
+### Added
+- `feat(update)`: deterministic tarball updater v2 (sha512 from
+  `dist.integrity` + atomic swap, bypasses the pnpm age-gate); config now
+  persists at `~/.dsh/artcraft.config.json`.
+
+### Fixed
+- `ci(guard)`: tolerate push-order races -- the main-ancestor check retries 3x
+  before failing.
+
+## [0.2.5] -- 2026-10-10
+
+### Added
+- `feat(update)`: npm-mode self-update pins the official registry; docs cover
+  the install-mode switch to npm.
+
+### Fixed
+- `fix(tools)`: `output` declaration `{ schema, render }` -- matches the host
+  requirement; verified through the poster/video integration session.
+
+### Changed
+- `ci`: new guard -- `package.json` version must match the release tag.
+- `docs(RELEASING)`: record version/tag mismatch and update-semantics lessons.
+- `fix(release)`: bump `package.json` 0.2.4 -> 0.2.5 (the version guard
+  correctly intercepted the missing bump).
+
+## [0.2.4] -- 2026-10-10
+
+### Added
+- `feat(ui)`: status card on the plugins page via the `plugins.bundle.config`
+  keyed slot; 7-family bins; EffectCraft path resolution.
+- `chore`: release governance -- dev/main branching, main-tag guard,
+  RELEASING.md rules.
+
+### Fixed
+- `fix(release)`: bump `package.json` 0.2.3 -> 0.2.4 (tag/version mismatch
+  had broken publishing).
+
+## [0.2.3] -- 2026-10-10
+
+### Fixed
+- `fix`: strip the UTF-8 BOM from `package.json` (the DSH loader's
+  `JSON.parse` rejects BOMs; the package loaded as broken).
+
+## [0.2.2] -- 2026-10-10
+
+### Fixed
+- `fix(tools)`: declare the `output` schema (the registry requires
+  `{ schema, render?, presentationMeta? }`).
+
+## [0.2.1] -- 2026-10-10
+
+### Changed
+- `feat(ui)`: move status/update into the Plugins page detail card; the
+  sidebar panel is dropped (the bridge does not belong in the main panel).
+
+## [0.2.0] -- 2026-10-10
+
+### Added
+- `feat`: self-update (check/apply) + a sidebar panel with toolchain status.
+- `ci`: npm Trusted Publishing workflow (OIDC, release-triggered).
+
+## [0.1.1] -- 2026-10-10
+
+### Added
+- `feat`: initial plugin -- PhotoCraft / FilmCraft / EffectCraft automation
+  via headless CLIs and JSON control channels (as `@local/artcraft 0.1.1`).
+- `docs`: bilingual product README (English-first + zh-CN), npm metadata.
+- `docs(license)`: Apache-2.0 for the plugin; ArtCraft apps are fair-source
+  (verbatim notice in NOTICE.md).
+- `chore!`: rename to `@ninkch/dsh-artcraft` for npm + profile registration.

package/README.md

@@ -27,7 +27,7 @@ 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** — nine agent tools let any Harness session check the toolchain, run CLI commands,
+- **In chat** — ten agent tools let any Harness session check the toolchain, run CLI commands,
   send control-channel commands to a running app, do bridged file operations, run delivery QC,
   and consult a per-app capability catalog.
 - **A bundled craft skill pack** — eleven skills (`artcraft-ops`, `artcraft-shot-language`,
@@ -43,9 +43,6 @@ not just talk about them:
 - **Paths belong to the caller** — this plugin is a bridge and owns no data directory. Files read
   or written go wherever the caller points: chat invocations default to the current conversation
   workspace (or any path named in the prompt); the canvas writes under its own project folder.
-- **Paths belong to the caller** — this plugin is a bridge and owns no data directory. Files read
-  or written go wherever the caller points: chat invocations default to the current conversation
-  workspace (or any path named in the prompt); the canvas writes under its own project folder.
 
 A typical AI short-drama loop looks like this: generate storyboard frames with a model →
 batch color-grade and sharpen them in PhotoCraft → render an animated title in EffectCraft →
@@ -81,7 +78,7 @@ Everything runs locally. No cloud round-trips, no accounts, no telemetry.
 - **ArtCraft apps** — grab what you need from [getartcraft.com](https://getartcraft.com/apps)
   or the [storytold GitHub releases](https://github.com/storytold). The portable/installer builds
   ship the CLI binaries on Windows and Linux (`photocraft-cli.exe` …); macOS ships them as a
-  separate notarized zip. Versions tested: PhotoCraft 0.6, FilmCraft 0.5, EffectCraft (early).
+  separate notarized zip. Versions tested: PhotoCraft 0.9, FilmCraft 0.8, EffectCraft (early).
 - Nothing else. No Python, no FFmpeg — the ArtCraft apps bring their own codecs.
 
 ## Setup
@@ -127,8 +124,8 @@ re-read on every request — no restart needed for path changes:
   "bins": {
     // three accepted forms: a directory (the <name>-cli binary is appended),
     // a full path to the executable, or a bare name looked up on PATH
-    "photocraft":  "C:/craft/photocraft-0.6.0-windows-x64-portable",
-    "filmcraft":   "C:/craft/filmcraft-0.5.0-windows-x64-portable",
+    "photocraft":  "C:/craft/<PhotoCraft portable folder>",
+    "filmcraft":   "C:/craft/<FilmCraft portable folder>",
     "effectcraft": "C:/Program Files/EffectCraft"
   },
   "control": { "filmcraft": 9876, "effectcraft": 9877 }
@@ -140,7 +137,7 @@ re-read on every request — no restart needed for path changes:
 
 ## Driving it from chat
 
-The plugin registers four tools. The agent composes them, so plain language works:
+The plugin registers ten tools. The agent composes them, so plain language works:
 
 > *"Color-grade every PNG in `demo/media` with a soft S-curve and smart sharpening at 80, put the
 > results in `demo/out/graded`."*
@@ -154,7 +151,7 @@ artcraft_cli  { bin:"photocraft", args:["batch","--actions","demo/craft/grade.js
 
 | Tool | What it does |
 |---|---|
-| `artcraft_status` | Toolchain health check: which of the 12 CLIs resolved, config location, control ports, running jobs |
+| `artcraft_status` | Toolchain health check: which of the 13 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 |
@@ -198,7 +195,7 @@ Full route list:
 | `POST /artcraft/api/control` | Synchronous control-channel call (`app` or `port`) |
 | `GET /artcraft/api/apps[?id=…]` | Family capability catalog (13 apps + command-family stats) |
 | `GET /artcraft/api/qc?path=…[&platform=…][&kind=…]` | Delivery QC: platform-spec checks with fix commands |
-| `GET /artcraft/api/skills` | Bundled skill pack listing (9 skills + their reference files) |
+| `GET /artcraft/api/skills` | Bundled skill pack listing (11 skills + their reference files) |
 | `GET /artcraft/api/live[?ports=app:port,…]` | Control-channel liveness (which apps are running) |
 | `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 |
@@ -332,22 +329,7 @@ explicit approval.
 
 ## License
 
-**This plugin (`@ninkch/dsh-artcraft`): Apache-2.0** — see [LICENSE](LICENSE). It ships none of the
-ArtCraft apps' code — it only drives their public automation surfaces (headless CLI + JSON
-control channel).
-
-**The ArtCraft apps themselves** are *not* OSI open source: they are distributed under the
-**ArtCraft License (WIP)**, a "fair source" license ([verbatim text](NOTICE.md)). The short
-version for anyone building on them:
-
-- ✅ free to use; back up, copy, modify and compile for private purposes
-- ✅ **every piece of media you create with the apps is yours** — your rendered episodes are
-  commercial assets, full stop
-- ❌ no selling the apps as your own software, no competing products built from their code
-- ❌ no stripping community/donation links from a fork; no using the ArtCraft name, logo or
-  mascots to promote a business without permission
-- 🤝 the team's public promise: if the business ever ends, the software transitions to an
-  OSI-approved open-source license
-
-Practical reading for an AI short-drama studio: run the apps locally, leave their community
-links alone, and sell your films — not the apps.
+This plugin (`@ninkch/dsh-artcraft`): **Apache-2.0** — see [LICENSE](LICENSE). It ships none of the
+ArtCraft apps' code; it only drives their public automation surfaces (headless CLI + JSON control
+channel). The ArtCraft apps themselves are separate projects by the ArtCraft team — the apps' own
+licenses apply to the apps.

package/README.zh-CN.md

@@ -25,7 +25,7 @@ Adobe 对标工具，共 **13 个应用**：**PhotoCraft**（Photoshop）、**Ve
 
 本插件把这套自动化面接进 DeepSeek Harness，让 AI 不只是"谈论"这些软件，而是真的**操作**它们：
 
-- **对话里** —— 九个 Agent 工具，任何 Harness 会话都能检查工具链、执行 CLI 命令、向运行中的
+- **对话里** —— 十个 Agent 工具，任何 Harness 会话都能检查工具链、执行 CLI 命令、向运行中的
   App 发控制通道命令、做桥接文件操作、跑交付质检、查每个应用的能力目录。
 - **随插件分发的技能包** —— 十一个技能（`artcraft-ops`、`artcraft-shot-language`、
   `artcraft-edit-rhythm`、`artcraft-color-light`、`artcraft-sound-design`、`artcraft-motion-vfx`、
@@ -70,7 +70,7 @@ FilmCraft 剪辑、调色、混音、烧字幕 → 导出 H.264。"生成"之后
 - **ArtCraft 应用** —— 从 [getartcraft.com](https://getartcraft.com/apps) 或
   [storytold GitHub Releases](https://github.com/storytold) 按需下载。Windows 与 Linux 的
   portable/安装包内置 CLI（`photocraft-cli.exe` 等）；macOS 的 CLI 是单独的公证 zip。
-  已验证版本：PhotoCraft 0.6、FilmCraft 0.5、EffectCraft（早期构建）。
+  已验证版本：PhotoCraft 0.9、FilmCraft 0.8、EffectCraft（早期构建）。
 - 其他什么都不需要：无 Python、无 FFmpeg —— ArtCraft 自带编解码器。
 
 ## 安装
@@ -112,8 +112,8 @@ pnpm install --dir C:/Users/<你>/.dsh/profiles/desktop
 {
   "bins": {
     // 三种写法：目录（自动拼接 <名>-cli 可执行文件）、完整 exe 路径、或走 PATH 的裸命令名
-    "photocraft":  "C:/craft/photocraft-0.6.0-windows-x64-portable",
-    "filmcraft":   "C:/craft/filmcraft-0.5.0-windows-x64-portable",
+    "photocraft":  "C:/craft/<PhotoCraft 便携目录>",
+    "filmcraft":   "C:/craft/<FilmCraft 便携目录>",
     "effectcraft": "C:/Program Files/EffectCraft"
   },
   "control": { "filmcraft": 9876, "effectcraft": 9877 }
@@ -124,7 +124,7 @@ pnpm install --dir C:/Users/<你>/.dsh/profiles/desktop
 
 ## 在对话里驱动
 
-插件注册四个工具，agent 自行编排，所以自然语言直接可用：
+插件注册十个工具，agent 自行编排，所以自然语言直接可用：
 
 > *"把 `demo/media` 里的 PNG 都用柔和 S 曲线调色、智能锐化 80，结果放进 `demo/out/graded`。"*
 
@@ -137,7 +137,7 @@ artcraft_cli  { bin:"photocraft", args:["batch","--actions","demo/craft/grade.js
 
 | 工具 | 用途 |
 |---|---|
-| `artcraft_status` | 工具体检：12 个 CLI 是否找到、配置目录、控制端口、进行中的任务 |
+| `artcraft_status` | 工具体检：13 个 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 / 读 / 写 / 建目录，路径由调用方绝对指定 |
@@ -306,16 +306,4 @@ GitHub 上传本仓库即可：`README.md` 英文优先，附
 
 ## 许可
 
-**本插件（`@ninkch/dsh-artcraft`）：Apache-2.0**（见 [LICENSE](LICENSE)）。不包含 ArtCraft 应用的任何代码 —— 只调用其公开自动化面
-（无头 CLI + JSON 控制通道）。
-
-**ArtCraft 各应用本身并非 OSI 开源**：它们采用 **ArtCraft License (WIP)** —— 一种 "fair source"
-（公平源代码）许可（[全文见 NOTICE.md](NOTICE.md)）。给构建在其上的使用者划重点：
-
-- ✅ 免费使用；可为私人目的备份、复制、修改、编译
-- ✅ **用这些应用创作的所有媒体完全归你** —— 渲染出的短剧成片就是你的商业资产，没有附加条件
-- ❌ 不得把应用当作自己的软件出售；不得用其代码开发竞品
-- ❌ 不得在 fork 中移除社区/捐赠链接；未经许可不得用 ArtCraft 名称、Logo 或吉祥物做商业宣传
-- 🤝 团队公开承诺：若业务终结，软件将转为 OSI 认可的开源许可
-
-对 AI 短剧工作室的务实解读：本地随便用，别动应用里的社区链接，卖你的片子——而不是卖应用。
+**本插件（`@ninkch/dsh-artcraft`）：Apache-2.0**（见 [LICENSE](LICENSE)）。不包含 ArtCraft 应用的任何代码——只调用其公开自动化面（无头 CLI + JSON 控制通道）。ArtCraft 各应用本身是 ArtCraft 团队的独立项目，应用自身的条款以其许可为准。

package/apps/catalog.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "note": "ArtCraft 家族 12 应用的自动化能力目录。来源：官方 getartcraft.com/apps、各应用 GitHub 仓库（storytold/*）、本机 12 个 <app>-cli --help 实测（0.2.9 时点）。要拿某应用的实时命令注册表，用 artcraft_cli 跑该应用的 commands 子命令。",
+  "note": "ArtCraft 家族 13 应用的自动化能力目录。来源：官方 getartcraft.com/apps、各应用 GitHub 仓库（storytold/*）、本机 13 个 <app>-cli --help 实测（2026-10 时点）。要拿某应用的实时命令注册表，用 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": [
     {
@@ -325,21 +325,21 @@
     }
   ],
   "capabilityStats": {
-    "note": "2026-10 实测：本机 13 个成员 CLI 的命令注册表规模与主要命令族。JSON 注册表入口（filmcraft / effectcraft / photocraft / gridcraft / wordcraft / figcraft 用 commands --json）为精确条目数，其余为 id 扫描值（近似）。用 artcraft_cli 跑 commands 可随时复核。",
+    "note": "2026-10-21 实测（家族全量更新后：photocraft 0.11.1 / vectorcraft 0.14.0 / filmcraft 0.10.0 / lightcraft 0.10.0 / pdfcraft 0.10.1 / effectcraft 0.13.0 / designcraft 0.10.0 / wordcraft 0.9.0 / deckcraft 0.9.0 / gridcraft 0.9.0 / cadcraft 0.10.0 / soundcraft 0.10.0 / figcraft 0.8.0）。JSON 注册表入口（filmcraft / effectcraft / photocraft / gridcraft / wordcraft / figcraft 用 commands --json）为精确条目数，其余为 id 扫描值（近似）。用 artcraft_cli 跑 commands 可随时复核。",
     "apps": {
-      "photocraft": { "commands": 364, "topFamilies": ["filter 62（gallery 47 / blur 11 / stylize 9 / distort 9 / render 9）", "edit 31", "layer 26", "select 19", "file.automate 18", "channel 18", "actions 14", "image.adjustments 9"] },
-      "vectorcraft": { "commands": 385, "topFamilies": ["object 71", "perspective 24", "select 18", "file 17", "swatch 15", "document 12", "layer 11", "path 11", "symbol 10", "dataset 10"] },
+      "photocraft": { "commands": 918, "topFamilies": ["filter 62（gallery 47 / blur 11 / stylize 9 / distort 9 / render 9）", "image.adjustments 9", "layer 26", "edit 31", "select 19", "paint 12", "brush 13", "gradient 12", "type 9", "shape 9", "path 9", "pattern 10", "file.automate 18", "channel 18", "actions 14", "swatches 9", "history 3", "slice 6", "jobs 2", "plugin 5"] },
+      "vectorcraft": { "commands": 401, "topFamilies": ["object 71", "perspective 24", "select 18", "text 10", "variable 9", "brush 9", "library 9", "print 9", "pdf.preset 5", "flattener 6", "swatch 15", "document 12", "layer 11", "path 11", "symbol 10", "dataset 10", "shaper 4"] },
       "filmcraft": { "commands": 701, "topFamilies": ["graphics 82", "clip 57", "file 57", "timeline 56", "sequence 45", "project 40", "edit 39", "multicam 35", "markers 32", "trim 24", "captions 22", "mixer 20", "export 19", "effects 16", "transcript 14", "masks 12", "essentialSound 9", "lumetri 7", "tts 7", "lut 4"] },
-      "lightcraft": { "commands": 192, "developControls": 122, "topFamilies": ["library 20", "faces 17", "denoise 16", "develop 16（122 个控制 / 14 分区）", "photo 14", "mask 12", "keyword 12", "preset 9", "crop 6", "stack 6"] },
-      "pdfcraft": { "commands": 71, "topFamilies": ["edit 13", "page 10", "measure 7", "a11y 5", "export 4", "ocr 3", "form 3", "comment 3", "protect 2", "sign 2"] },
-      "effectcraft": { "commands": 731, "effects": 307, "topFamilies": ["layer 121", "view 78", "file 61", "keys 36", "comp 31", "edit 27", "track 22", "essential 22", "renderQueue 20", "effect 19", "camera 19", "prop 18", "mask 17", "time 17", "roto 14", "text 13", "puppet 10"], "exportFormats": ["H264", "Hevc", "Av1", "ProRes", "Uncompressed", "WebM", "PngSequence", "JpegSequence", "TiffSequence", "ExrSequence", "Gif", "Wav", "Aiff"], "expressions": true, "scripting": true },
-      "designcraft": { "commands": 279, "topFamilies": ["object 22", "style 17", "file 15", "transform 10", "data 10", "type 10", "library 8", "layout 7", "book 7", "edit 7", "text 7", "layer 7", "table 7", "article 6"] },
-      "wordcraft": { "commands": 299, "topFamilies": ["para 28", "format 25", "file 18", "review 16", "equation 15", "insert 15", "table 14", "view 13", "select 12", "picture 11", "styles 11", "references 10", "mailings 9"] },
-      "deckcraft": { "commands": 165, "topFamilies": ["format 32", "shape 19", "slide 15", "file 13", "animation 10", "text 10", "edit 9", "media 7", "insert 7", "arrange 7", "design 5", "transition 4"] },
-      "gridcraft": { "commands": 115, "topFamilies": ["home 12", "pivot 11", "insert 10", "data 10", "view 9", "sheet 8", "edit 7", "file 7", "selection 6", "formulas 5", "chart 3", "slicer 3"] },
-      "cadcraft": { "commands": 139, "topFamilies": ["table 11", "arc 10", "zoom 9", "dimstyle 7", "blocks 6", "grip 6", "layout 6", "layerstate 5", "vports 5", "circle 5", "dimtedit 5"] },
-      "soundcraft": { "commands": 478, "topFamilies": ["view 96", "edit 93", "track 65", "event 35", "options 35", "clip 31", "mix 29", "setup 20", "file 17", "transport 13", "session 11（含 audio_health）", "automation 10"] },
-      "figcraft": { "commands": 552, "topFamilies": ["text 52", "view 48", "vector 40", "object 27", "tool 21", "select 21", "component 21", "collab 20", "file 20", "proto 20", "library 18", "variable 18", "edit 15", "comment 14", "plugin 11", "style 10"] }
+      "lightcraft": { "commands": 227, "developControls": 122, "topFamilies": ["print 17（打印版式模板：cell/layout/template）", "slideshow.export", "library 20", "faces 17", "denoise 16", "develop 16（122 个控制 / 14 分区）", "photo 14", "mask 12", "keyword 12", "preset 9", "crop 6", "stack 6"] },
+      "pdfcraft": { "commands": 77, "topFamilies": ["edit 13", "page 10", "measure 7", "a11y 5", "export 4", "ocr 3", "form 3", "comment 3", "protect 2", "sign 2", "create 1（新建 PDF）", "text_edit 1"] },
+      "effectcraft": { "commands": 731, "effects": 307, "topFamilies": ["layer 121", "view 78", "file 61", "keys 36", "comp 31", "edit 27", "track 22", "essential 22", "renderQueue 20", "effect 19", "camera 19", "prop 18（0.13.0 起属性读写统一走 prop.get/set，effect.setParam 已移除）", "mask 17", "time 17", "roto 14", "text 13", "puppet 10", "face 5（0.13 新增）", "learn 5（0.13 新增）"], "exportFormats": ["H264", "Hevc", "Av1", "ProRes", "Uncompressed", "WebM", "PngSequence", "JpegSequence", "TiffSequence", "ExrSequence", "Gif", "Wav", "Aiff"], "expressions": true, "scripting": true },
+      "designcraft": { "commands": 309, "topFamilies": ["object 22", "style 17", "file 15", "transform 10", "data 10", "type 10", "toc 3（目录）", "footnote 4（脚注）", "xref 3（交叉引用）", "index 3（索引）", "preflight.run（印前检查）", "condition 5（条件样式）", "flex 5", "layout 7", "book 7", "article 6"] },
+      "wordcraft": { "commands": 633, "topFamilies": ["para 28", "format 25", "file 18", "review 16", "caret 7", "edit 10", "outline 8", "layout 7", "fields 6", "arrange 9", "draw 9", "canvas 4", "chart 3", "shape 6", "equation 15", "insert 15", "table 14", "styles 11", "references 10"] },
+      "deckcraft": { "commands": 209, "topFamilies": ["format 32", "shape 19", "slide 15", "file 13", "animation 10", "text 10", "picture 9", "comment 7", "review 7", "table 5", "chart 3", "design 5", "transition 4", "handout 1", "master 2"] },
+      "gridcraft": { "commands": 341, "topFamilies": ["home 12", "pivot 11", "insert 10", "data 10", "cell 2", "range 1", "table 3", "object 2", "link 1", "draw 4", "arrange 3", "review 2", "formulas 5", "chart 3", "window 1"] },
+      "cadcraft": { "commands": 139, "topFamilies": ["table 11", "arc 10", "zoom 9", "dimstyle 7", "blocks 6", "grip 6", "layout 6", "layerstate 5", "vports 5", "circle 5", "dimtedit 5", "compare 2", "quickcalc 1"] },
+      "soundcraft": { "commands": 480, "topFamilies": ["view 96", "edit 93", "track 65", "event 35", "options 35", "clip 31", "mix 29", "setup 20", "file 17", "transport 13", "session 11（含 audio_health）", "automation 10", "midi 6（0.10 新增）", "video 3（0.10 新增）", "audiosuite 1"] },
+      "figcraft": { "commands": 569, "topFamilies": ["text 52", "view 48", "vector 40", "object 27", "tool 21", "select 21", "component 21", "collab 20", "file 20", "proto 20", "library 18", "variable 18", "edit 15", "comment 14", "plugin 11", "style 10"] }
     }
   }
 }

package/artcraft.config.json.example

@@ -1,8 +1,8 @@
 {
   "bins": {
-    "photocraft": "D:/craft/photocraft-0.6.0/photocraft-0.6.0-windows-x64-portable",
+    "photocraft": "C:/craft/<PhotoCraft portable folder>",
     "vectorcraft": "C:/Program Files/VectorCraft",
-    "filmcraft": "D:/craft/filmcraft-0.5.0/filmcraft-0.5.0-windows-x64-portable",
+    "filmcraft": "C:/craft/<FilmCraft portable folder>",
     "lightcraft": "C:/Program Files/LightCraft",
     "pdfcraft": "C:/Program Files/PdfCraft",
     "effectcraft": "C:/Program Files/EffectCraft",

package/client.js

@@ -118,6 +118,29 @@ window.__ModuleLoader__.load({
         finally { if (alive.current) setBusy(''); }
       }, []);
 
+      // 一键自动探测（AC-04）：POST /discover 做缺失项填空 + 失效路径纠正；
+      // 用户显式配置有效则原样不动（服务端保证），失败/无动作都有明确文案，不静默。
+      const runDiscover = useCallback(async () => {
+        setBusy('discover'); setOut(''); setDone(false);
+        try {
+          const r = await api('/discover', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' });
+          if (!alive.current) return;
+          const applied = r.applied ?? {};
+          const appliedNames = Object.keys(applied).map((k) => LABELS[k] || k);
+          setOut(
+            (r.note || '') + '\n' +
+            (appliedNames.length
+              ? '本次写入配置：' + appliedNames.join('、') + '\n'
+              : '没有需要更新的家族程序（已有配置均有效）\n') +
+            '已探测到本机安装：' + (Object.keys(r.discovered ?? {}).map((k) => LABELS[k] || k).join('、') || '（无）') + '\n' +
+            '配置文件：' + (r.configPath || '（未知）'),
+          );
+          loadStatus(); // 探测写盘后立即重读 bins 状态，灯色即变
+        } catch (e) {
+          if (alive.current) setOut('自动探测失败：' + String(e.message || e) + '（可检查插件是否注册、或手动编辑 artcraft.config.json）');
+        } finally { if (alive.current) setBusy(''); }
+      }, [loadStatus]);
+
       useEffect(() => { loadStatus(); checkUpdate(); }, [loadStatus, checkUpdate]);
 
       const bins = status?.bins ?? {};
@@ -153,6 +176,9 @@ window.__ModuleLoader__.load({
             (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', onClick: runDiscover, disabled: busy !== '',
+            title: '自动探测本机 ArtCraft 家族安装位置：缺失项填入配置，已失效的路径被纠正；你的显式有效配置不会被覆盖' },
+            busy === 'discover' ? '探测中…' : '自动探测'),
           h('button', { className: 'dshac-btn primary', onClick: checkUpdate, disabled: busy !== '' },
             busy === 'check' ? '检查中…' : '检查更新'),
           h('button', {

package/index.js

@@ -55,7 +55,7 @@ import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 
 const NAME = 'artcraft';
-const VERSION = '0.3.0';
+const VERSION = '0.3.2';
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 
 const BINS = [
@@ -183,11 +183,13 @@ function resolveCallerPath(p) {
   let s = String(p ?? '').trim();
   if (!s) throw new Error('缺少路径参数');
   if (s === '~' || s.startsWith('~/') || s.startsWith('~\\')) s = path.join(os.homedir(), s.slice(1));
-  const abs = path.resolve(s);
-  if (!path.isAbsolute(abs)) {
-    throw new Error('需要绝对路径 —— 对话调用传当前工作空间下的绝对路径，画布传项目目录下的绝对路径（或用 base + 相对路径组合）');
+  if (!path.isAbsolute(s)) {
+    throw new Error(
+      `需要绝对路径，收到相对路径 "${s}" —— 本插件不持有数据目录，不会按进程 cwd 解析；`
+      + '请改传绝对 path=<绝对路径>，或用 base=<绝对目录> + rel=<相对路径>。',
+    );
   }
-  return abs;
+  return path.normalize(s);
 }
 
 function resolveBaseRel(base, rel) {
@@ -364,7 +366,7 @@ async function statOutputs(outputs, cwd) {
     try {
       abs = base ? path.resolve(base, spec) : resolveCallerPath(spec);
     } catch {
-      out.push({ rel: spec, exists: false, dir: false, size: null, mtime: null });
+      out.push({ rel: spec, exists: false, dir: false, size: null, mtime: null, reason: 'relative-output-without-cwd' });
       continue;
     }
     try {
@@ -1038,6 +1040,9 @@ async function updateApply() {
 const toolNames = [];
 const toolErrors = [];
 
+/** 单测钩子：只暴露纯函数，不改运行时行为（scripts/test-fs-paths.mjs 使用） */
+export const __testables = { resolveCallerPath, resolveBaseRel, statOutputs };
+
 export const inject = ['tools', 'webServer'];
 
 export function apply(ctx) {
@@ -1045,13 +1050,15 @@ export function apply(ctx) {
   ctx.effect(() => {
     const disposers = [];
     const attempt = (def) => {
+      // 44.0.0 起注册器强制要求 output（缺了整工具拒注册，见 RELEASING.md 教训与 issue #1）：
+      // 兜底 output 必须随 shape 一起传入，两个命名约定都要带。
       const output = def.output ?? {
         schema: { type: 'object', additionalProperties: true },
         render: (_args, value) => [{ type: 'text', text: JSON.stringify(value, null, 2) }],
       };
       for (const shape of [
-        { name: def.name, description: def.description, parameters: def.schema, execute: def.execute },
-        { name: def.name, description: def.description, inputSchema: def.schema, handler: def.execute },
+        { name: def.name, description: def.description, parameters: def.schema, execute: def.execute, output },
+        { name: def.name, description: def.description, inputSchema: def.schema, handler: def.execute, output },
       ]) {
         try {
           const d = ctx.tools.register(shape);
@@ -1302,6 +1309,22 @@ export function apply(ctx) {
     attempt({
       name: 'artcraft_qc',
       description: '交付质检（确定性规则）：对产物跑家族探针并按平台规格核对，返回 PASS/WARN/FAIL/MANUAL 清单与修复命令。支持 video/audio/image/pdf/doc/sheet/deck/fig/cad。用法：path=产物绝对路径；platform 可选（bilibili|youtube|douyin|reels|shorts|wechat|broadcast|podcast）核对画幅/帧率/响度目标；kind 可选，强制指定类型；live 默认 true——若检测到运行中的 App，会额外取示波器读数（filmcraft scopes.read）、Essential Sound 体检、字幕长度与 EffectCraft 能力表（结果在 appChecks）。只报事实与实测值，判定留给调用方。',
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (_args, v) => {
+          if (!v || !Array.isArray(v.checks)) return [{ type: 'text', text: JSON.stringify(v, null, 2) }];
+          const lines = [`QC ${String(v.verdict || '').toUpperCase()}  ${v.path ?? ''}`,
+            `kind=${v.kind ?? '?'}  bin=${v.bin ?? '-'}  platform=${v.platform?.id ?? '-'}  计数=${JSON.stringify(v.counts ?? {})}`];
+          for (const c of v.checks) {
+            lines.push(`[${String(c.level).toUpperCase().padEnd(6)}] ${c.id}: ${c.detail}`);
+            if (c.fix) lines.push(`        fix: ${c.fix}`);
+          }
+          if (Array.isArray(v.appChecks) && v.appChecks.length) {
+            lines.push('appChecks: ' + JSON.stringify(v.appChecks));
+          }
+          return [{ type: 'text', text: lines.join('\n') }];
+        },
+      },
       schema: {
         type: 'object',
         properties: {
@@ -1322,6 +1345,19 @@ export function apply(ctx) {
     attempt({
       name: 'artcraft_live',
       description: '探测哪些 ArtCraft App 正在运行（控制通道活性）：对已知端口逐个调用 engine.commands 作为活性证据，返回 live 列表、耗时与当前可用命令数。用于"边看边调"前的准备——确认目标 App 已以 --control 启动。可用 ports 追加自定义端口（如 [{app:"designcraft",port:8000}]）。',
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (_args, v) => {
+          if (!v || !Array.isArray(v.apps)) return [{ type: 'text', text: JSON.stringify(v, null, 2) }];
+          const lines = [`LIVE ${v.live}/${v.total}  ${v.note ?? ''}`];
+          for (const a of v.apps) {
+            lines.push(a.live
+              ? `[LIVE ] ${String(a.app).padEnd(13)} :${a.port}  ${a.commands ?? '?'} cmds, ${a.ms}ms`
+              : `[—    ] ${String(a.app).padEnd(13)} :${a.port}  ${(a.error || '').slice(0, 90)}`);
+          }
+          return [{ type: 'text', text: lines.join('\n') }];
+        },
+      },
       schema: {
         type: 'object',
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninkch/dsh-artcraft",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "Drive the open-source ArtCraft studio suite (13 family apps: PhotoCraft, VectorCraft, FilmCraft, LightCraft, PdfCraft, EffectCraft, DesignCraft, WordCraft, DeckCraft, GridCraft, CADCraft, SoundCraft, FigCraft) from DeepSeek Harness: agent tools, a same-origin HTTP API, a bundled craft skill pack, and plugins-page status with self-update.",
   "keywords": [
@@ -26,6 +26,9 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "selftest": "node scripts/selftest.mjs"
+  },
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
@@ -41,6 +44,7 @@
     "artcraft.config.json.example",
     "apps",
     "recipes",
+    "CHANGELOG.md",
     "README.md",
     "README.zh-CN.md",
     "NOTICE.md"

package/skills/artcraft-color-light/SKILL.md

@@ -16,7 +16,7 @@ description: 影调与调色决策——一级（曝光/对比/白平衡/饱和
 | 3 | 白平衡（色温/色调） | 矢量示波器：肤色线附近 | 偏黄/偏青不察 |
 | 4 | 饱和 / 自然饱和度 | 矢量示波器不越界 | 过饱和→溢出结块 |
 
-**LightCraft 落点（122 控制 / 14 分区）**——标准冲洗顺序：
+**LightCraft 落点（122 控制 / 14 分区，0.10 未变）**——标准冲洗顺序：
 
 ```
 profile.amount → wb.temp / wb.tint → light.exposure / light.contrast /
@@ -32,6 +32,8 @@ geometry.*（透视/旋转/裁切）→ effects.texture/clarity/dehaze → grain
 
 **PhotoCraft 落点**：`image.adjustments.exposure/levels/curves/vibrance/desaturate`；RAW 走 `filter.cameraRaw`；批量一致性用 `actions.record → actions.save → file.automate.batch`。
 
+**打印版式（LightCraft 0.10 新增）**：`print.template.list/apply/save` + `print.cell.*` + `print.layout`——把冲洗结果按版式模板排进打印页；`slideshow.export` 直接出幻灯片。
+
 ## 二、二级校色与局部
 
 | 手法 | 何时用 | 落点 |

package/skills/artcraft-delivery-qc/references/platform-specs.md

@@ -44,13 +44,16 @@
 | 交付物 | 检查项 | 命令 |
 |---|---|---|
 | PDF（阅读） | 无障碍（标签/阅读顺序/替代文本） | `pdfcraft run a11y.check` · `a11y.report` · `a11y.alt_text` |
-| PDF（印刷） | 出血、裁切标记、CMYK、尺寸 | FigCraft `export --bleed 3mm --crop-marks --cmyk`；DesignCraft `layout/type` |
+| PDF（新建） | 0.10 新增 `create`：从零生成 PDF | `pdfcraft-cli run create …`（先 `pdfcraft-cli tools` 查参数） |
+| PDF（文本勘误） | 直接改文本层 | `pdfcraft run text_edit`（0.10 新增）/ `edit.edit_text` |
+| PDF（印刷） | 出血、裁切标记、CMYK、尺寸；**印前检查** | FigCraft `export --bleed 3mm --crop-marks --cmyk`；DesignCraft `layout/type` + **`preflight.run`**（0.10 新增） |
 | PDF（长期存档） | PDF/A 合规 | `pdfcraft run standards.pdfa` |
 | PDF（传输） | 体积 | `pdfcraft run optimize.reduce`（或 `optimize.advanced`） |
 | PDF（安全） | 口令/权限 | `pdfcraft protect.password` / `protect.remove` |
 | Word 文档 | 无障碍、批注、修订、文献 | `wordcraft run --cmd file.accessibility` · `review.changes` · `references.bibliography` |
 | 表格 | 数据校验、公式、图表 | `gridcraft data.validate` / `data.validation` · `formulas.evaluate` |
-| 演示 | 转场/动画时长、备注 | `deckcraft transition.set` · `animation.timing` |
+| 演示 | 转场/动画时长、备注；讲义/母版 | `deckcraft transition.set` · `animation.timing` · `handout`（0.9 新增）/ `master` |
+| 矢量印刷交付 | 打印预设与拼版 | VectorCraft `print.setup` · `print.tiling` · `pdf.preset.*`（0.14 新增） |
 
 ## 五、命名与目录约定
 

package/skills/artcraft-motion-vfx/SKILL.md

@@ -36,7 +36,7 @@ description: 动效与特效选择——何时在剪辑内做效果（FilmCraft
 | Time | 8 | 时间重映射、残影、像素运动模糊 | 变速优先在剪辑层做 |
 | 3D Channel / Expression Controls / Matte / Text / Utility / Obsolete | 8/9/6/2/9/9 | 深度合成、表达式控制、遮罩工具 | Obsolete 类避免新项目使用 |
 
-**查询**：`artcraft_cli { bin:"effectcraft", args:["commands","--json"] }` 取全部 id；`exec app.capabilities` 看效果总数与导出格式；`effect.apply {layer, effect}` 施加；`effect.setParam` 调参。
+**查询**：`artcraft_cli { bin:"effectcraft", args:["commands","--json"] }` 取全部 id；`exec app.capabilities` 看效果总数与导出格式；`effect.apply {layer, effect}` 施加；调参用 **`prop.set`**（0.13.0 起 `effect.setParam` 已移除，属性读写统一走 `prop.get/set/toggleAnimation/addKey`，参数路径形如 `effects/#1/<param>`）。
 
 ## 三、关键帧与缓动（动效"贵不贵"就看这里）
 

package/skills/artcraft-motion-vfx/references/scene-to-effect.md

@@ -2,7 +2,7 @@
 
 > 效果 id 来自官方注册表（`ec.<类别>.<名称>`），共 307 个；完整清单见同目录 `effect-catalogue.md`。
 > 用法：`artcraft_cli { bin:"effectcraft", args:["exec","effect.apply","--params","{\"layer\":N,\"effect\":\"<id>\"}"] }`
-> 参数走 `effect.setParam {clip|layer, effect, param, value}`；参数 id 形如 `effects/#1/<param>`。
+> 参数走 **`prop.set`**（0.13.0 起 `effect.setParam` 已移除）：`artcraft_cli { bin:"effectcraft", args:["exec","prop.set","--params","{\"layer\":N,\"property\":\"effects/#1/<param>\",\"value\":…}"] }`；读用 `prop.get`，打点用 `prop.addKey`，表达式用 `prop.setExpression`。
 > 表中 id 均为**已验证存在**；没有把握的不要写死，先 `describe` 或查目录。
 
 ## 一、光效与氛围

package/skills/artcraft-ops/references/command-families.md

@@ -1,6 +1,6 @@
 # ArtCraft 13 成员命令族总表（实测）
 
-> 来源：2026-10 在本机对 13 个成员 CLI 的 `commands` 注册表实测。
+> 来源：2026-10-21 在本机对 13 个成员 CLI 的 `commands` 注册表实测（家族全量更新后版本，见规模总览）。
 > 精确条目数来自 JSON 注册表（`commands --json`：filmcraft / effectcraft / photocraft / gridcraft / wordcraft / figcraft），其余为 id 扫描值（近似）。
 > 随时复核：`artcraft_cli { bin:"<app>", args:["commands","--json"] }`（不支持 `--json` 的成员直接 `commands`）。
 
@@ -8,37 +8,37 @@
 
 | 成员 | 命令数 | 版本实测 | 定位 |
 |---|---:|---|---|
-| EffectCraft | 731（含 **307 效果**） | 0.10.0 | 合成 / 动效 / VFX |
-| FilmCraft | 701 | 0.8.0 | 剪辑 / 字幕 / 调色 / 混音 |
-| FigCraft | 552 | — | 界面设计与原型 |
-| SoundCraft | 478 | 0.7.0 | 音频后期 / 混音 |
-| VectorCraft | 385 | 0.11.0 | 矢量插画 |
-| PhotoCraft | 364（**62 滤镜**） | 0.9.0 | 图像 / 影调 |
-| WordCraft | 299 | 0.7.0 | 写作 / 文档 |
-| DesignCraft | 279 | 0.8.0 | 页面排版 / 出版 |
-| LightCraft | 192（**122 develop 控制**） | 0.8.0 | 照片 / RAW 冲洗 |
-| DeckCraft | 165 | 0.7.0 | 演示 / 幻灯片 |
-| CADCraft | 139 | 0.7.0 | 制图 |
-| GridCraft | 115 | 0.7.0 | 表格 / 数据 |
-| PdfCraft | 71（**86 个可运行工具**） | 0.8.0 | PDF / 文档质检 |
+| EffectCraft | 731（含 **307 效果**；**`effect.setParam` 已移除，属性读写走 `prop.*`**） | 0.13.0 | 合成 / 动效 / VFX |
+| PhotoCraft | 918（**62 滤镜**；0.11 编辑器命令大量上引擎） | 0.11.1 | 图像 / 影调 |
+| FigCraft | 569 | 0.8.0 | 界面设计与原型 |
+| WordCraft | 633 | 0.9.0 | 写作 / 文档 |
+| SoundCraft | 480（**0.10 新增 `midi.*`/`video.*`/`audiosuite`**） | 0.10.0 | 音频后期 / 混音 |
+| VectorCraft | 401（**0.14 新增 `text`/`variable`/`pdf.preset`/`print`**） | 0.14.0 | 矢量插画 |
+| FilmCraft | 701 | 0.10.0 | 剪辑 / 字幕 / 调色 / 混音 |
+| LightCraft | 227（**122 develop 控制**；**0.10 新增 `print.*` 模板与 `slideshow.export`**） | 0.10.0 | 照片 / RAW 冲洗 |
+| DesignCraft | 309（**0.10 新增 `toc`/`footnote`/`xref`/`index`/`preflight`**） | 0.10.0 | 页面排版 / 出版 |
+| DeckCraft | 209 | 0.9.0 | 演示 / 幻灯片 |
+| PdfCraft | 77（**86 个可运行工具**；新增 `create`/`text_edit`） | 0.10.1 | PDF / 文档质检 |
+| CADCraft | 139 | 0.10.0 | 制图 |
+| GridCraft | 341 | 0.9.0 | 表格 / 数据 |
 
 ## 各成员主要命令族
 
 | 成员 | 主要族（数量） |
 |---|---|
 | FilmCraft | `graphics` 82 · `clip` 57 · `file` 57 · **`timeline` 56** · `sequence` 45 · `project` 40 · `edit` 39 · **`multicam` 35** · `markers` 32 · **`trim` 24** · **`captions` 22** · `mixer` 20 · `export` 19 · `effects` 16 · **`transcript` 14** · `masks` 12 · `essentialSound` 9 · **`lumetri` 7** · **`tts` 7** · `lut` 4 · `scopes` 1 · `color` 1 |
-| EffectCraft | `layer` 121 · `view` 78 · `file` 61 · **`keys` 36** · `comp` 31 · `edit` 27 · **`track` 22** · **`essential` 22** · `renderQueue` 20 · `effect` 19 · **`camera` 19** · `prop` 18 · `mask` 17 · `time` 17 · **`roto` 14** · `text` 13 · `footage` 12 · **`puppet` 10** |
+| EffectCraft | `layer` 121 · `view` 78 · `file` 61 · **`keys` 36** · `comp` 31 · `edit` 27 · **`track` 22** · **`essential` 22** · `renderQueue` 20 · `effect` 19 · **`camera` 19** · **`prop` 18（替代已移除的 `effect.setParam`）** · `mask` 17 · `time` 17 · **`roto` 14** · `text` 13 · `footage` 12 · **`puppet` 10** · `face` 5（0.13 新增） · `learn` 5（0.13 新增） |
 | FigCraft | `text` 52 · `view` 48 · `vector` 40 · `object` 27 · `tool` 21 · `select` 21 · **`component` 21** · `collab` 20 · `file` 20 · **`proto` 20** · `library` 18 · **`variable` 18** · `edit` 15 · `comment` 14 · `plugin` 11 · **`style` 10** · `version` 8 · `instance` 8 · `annotation` 8 · `branch` 7 |
-| SoundCraft | `view` 96 · `edit` 93 · **`track` 65** · `event` 35（含 **`beat_detective`/`identify_beat`/`extract_chords`**） · `options` 35 · `clip` 31 · **`mix` 29** · `setup` 20 · `file` 17（**`bounce_mix`/`bounce_stems`**） · `transport` 13 · **`session` 11（含 `audio_health`）** · **`automation` 10** |
-| VectorCraft | **`object` 71** · **`perspective` 24** · `select` 18 · `file` 17 · `swatch` 15 · `document` 12 · `layer` 11 · `path` 11 · **`symbol` 10** · **`dataset` 10** |
-| PhotoCraft | **`filter` 62**（gallery 47 / blur 11 / stylize 9 / distort 9 / render 9 / pixelate 7 / blurGallery 5 / noise 5 / sharpen 5 …） · `edit` 31 · `layer` 26 · `select` 19 · `file.automate` 18 · `channel` 18 · **`actions` 14** · `brush` 13 · `paint` 12 · `gradient` 12 · **`image.adjustments` 9** |
-| WordCraft | `para` 28 · `format` 25 · `file` 18（含 `accessibility`） · **`review` 16** · `equation` 15 · `insert` 15 · `table` 14 · `view` 13 · `select` 12 · `picture` 11 · `styles` 11 · **`references` 10** · `mailings` 9 |
-| DesignCraft | `object` 22 · **`style` 17** · `file` 15 · `transform` 10 · `data` 10 · `type` 10 · `library` 8 · `layout` 7 · `book` 7 · `article` 6 · `table` 7 |
-| LightCraft | `library` 20 · **`faces` 17** · **`denoise` 16** · **`develop` 16（122 控制 / 14 分区）** · `photo` 14 · `mask` 12 · `keyword` 12 · `preset` 9 · `crop` 6 · `stack` 6 · `version` 5 · `history` 5 |
-| DeckCraft | `format` 32 · `shape` 19 · `slide` 15 · `file` 13 · **`animation` 10** · `text` 10 · `edit` 9 · `media` 7 · `insert` 7 · `arrange` 7 · **`design` 5** · **`transition` 4** |
-| CADCraft | `table` 11 · `arc` 10 · `zoom` 9 · **`dimstyle` 7** · `blocks` 6 · `grip` 6 · `layout` 6 · `layerstate` 5 · `vports` 5 · `circle` 5 |
-| GridCraft | `home` 12 · **`pivot` 11** · `insert` 10 · **`data` 10** · `view` 9 · `sheet` 8 · `edit` 7 · `file` 7 · `selection` 6 · **`formulas` 5** · `chart` 3 · `slicer` 3 |
-| PdfCraft | `edit` 13 · `page` 10 · **`measure` 7** · **`a11y` 5** · `export` 4 · `ocr` 3 · `form` 3 · `comment` 3 · `protect` 2 · `sign` 2（另有 86 个可 `run` 的工具，含 `a11y.check`/`a11y.report`/`measure.info`/`optimize.reduce`/`standards.pdfa`/`doc.compare`） |
+| SoundCraft | `view` 96 · `edit` 93 · **`track` 65** · `event` 35（含 **`beat_detective`/`identify_beat`/`extract_chords`**） · `options` 35 · `clip` 31 · **`mix` 29** · `setup` 20 · `file` 17（**`bounce_mix`/`bounce_stems`**） · `transport` 13 · **`session` 11（含 `audio_health`）** · **`automation` 10** · **`midi` 6 · `video` 3 · `audiosuite` 1（0.10 新增）** |
+| VectorCraft | **`object` 71** · **`perspective` 24** · `select` 18 · `file` 17 · `swatch` 15 · `document` 12 · **`text` 10 · `variable` 9 · `brush` 9 · `library` 9 · `print` 9（0.14 新增）** · `layer` 11 · `path` 11 · **`symbol` 10** · **`dataset` 10** · **`pdf.preset` 5 · `flattener` 6（0.14 新增）** |
+| PhotoCraft | **`filter` 62**（gallery 47 / blur 11 / stylize 9 / distort 9 / render 9 / pixelate 7 / blurGallery 5 / noise 5 / sharpen 5 …） · `edit` 31 · `layer` 26 · `select` 19 · `file.automate` 18 · `channel` 18 · **`actions` 14** · `brush` 13 · `paint` 12 · `gradient` 12 · **`image.adjustments` 9** · **0.11 新增引擎化：`type` 9 · `shape` 9 · `path` 9 · `pattern` 10 · `swatches` 9 · `slice` 6 · `variables`/`jobs`/`plugin`** |
+| WordCraft | `para` 28 · `format` 25 · `file` 18（含 `accessibility`） · **`review` 16** · `equation` 15 · `insert` 15 · `table` 14 · **0.9 新增：`edit` 10 · `outline` 8 · `caret` 7 · `layout` 7 · `arrange` 9 · `draw` 9 · `shape` 6 · `canvas` 4 · `fields` 6 · `design` 4 · `hf` 3 · `developer` 3** |
+| DesignCraft | `object` 22 · **`style` 17** · `file` 15 · `transform` 10 · `data` 10 · `type` 10 · **0.10 新增：`toc` 3 · `footnote` 4 · `xref` 3 · `index` 3 · `preflight.run` · `condition` 5 · `flex` 5 · `xml` 4 · `variables` 4 · `spelling` 3 · `hyperlink` 4** · `layout` 7 · `book` 7 · `article` 6 |
+| LightCraft | `library` 20 · **`faces` 17** · **`denoise` 16** · **`develop` 16（122 控制 / 14 分区，未变）** · **0.10 新增：`print` 17（版式模板 cell/layout/template）· `slideshow.export`** · `photo` 14 · `mask` 12 · `keyword` 12 · `preset` 9 · `crop` 6 · `stack` 6 · `version` 5 · `history` 5 |
+| DeckCraft | `format` 32 · `shape` 19 · `slide` 15 · `file` 13 · **`animation` 10** · `text` 10 · **0.9 新增：`picture` 9 · `comment` 7 · `review` 7 · `table` 5 · `chart` 3 · `master` 2 · `handout` 1** · `media` 7 · `insert` 7 · `arrange` 7 · **`design` 5** · **`transition` 4** |
+| CADCraft | `table` 11 · `arc` 10 · `zoom` 9 · **`dimstyle` 7** · `blocks` 6 · `grip` 6 · `layout` 6 · `layerstate` 5 · `vports` 5 · `circle` 5 · **0.10 新增：`compare` 2 · `quickcalc` · `revcloud` 2 · `constraints` 2** |
+| GridCraft | `home` 12 · **`pivot` 11** · `insert` 10 · **`data` 10** · **0.9 新增：`cell` 2 · `range` · `table` 3 · `object` 2 · `link` · `draw` 4 · `review` 2 · `window`** · `view` 9 · `sheet` 8 · `edit` 7 · `file` 7 · `selection` 6 · **`formulas` 5** · `chart` 3 |
+| PdfCraft | `edit` 13 · `page` 10 · **`measure` 7** · **`a11y` 5** · `export` 4 · `ocr` 3 · `form` 3 · `comment` 3 · `protect` 2 · `sign` 2 · **0.10 新增：`create`（新建 PDF）· `text_edit` · `form_fields` · `standards`**（另有 86+ 个可 `run` 的工具，含 `a11y.check`/`a11y.report`/`measure.info`/`optimize.reduce`/`standards.pdfa`/`doc.compare`） |
 
 ## 自发现三件套