dsh-ppt-studio 1.2.0 → 1.2.2

package/agent-presets/ppt/agent.cordis.yml

@@ -1,43 +1,6 @@
-# The `standard` agent preset: the full coding agent, mounted once per process.
-#
-# This file is an AGENT-PLANE composition. The roster mounts it ONCE under a
-# standing scope; every session naming it joins by scope parentage, so the
-# tools and prompt sections registered here cover each joined agent while a
-# session's own state stays keyed per Session/Agent inside the plugins. The
-# host composition (`base.cordis.yml` + `web.cordis.yml`) keeps everything a
-# preset must not own: the registries themselves, the sandbox and approval
-# stack, persistence, and the model route.
-#
-# A service row here MUST sit inside a group carrying an `isolate` realm.
-# Without one it publishes into the root realm, where it is process-global —
-# another preset publishing the same name collides, and a host reader would
-# resolve one preset's instance for every session; the agent-preset registry
-# rejects that at mount. `true` means an entry-local realm: this standing
-# mount's own private instance, apart from every other preset's. (A shared
-# label does NOT pool instances — `provide()` throws on the second registration
-# under the same realm symbol; labels join REALMS, and are not what this file
-# needs.)
-#
-# 【本文件在 DSH 0.1.7 上怎么被用（2026-09-24 适配）】
-# 它是一份 **Loader 方言的条目数组**，由 `lib/preset-delivery.js` 读出来、作为
-# `plugins` 交给 `ctx.agentPresets.register({id:'ppt', name, description, order, plugins})`。
-# 0.1.6 及以前是靠把本文件**写到 `<dshHome>/.agent-presets/ppt/`** 让宿主扫到——那条路
-# 在 0.1.7 已被上游删除（原文："the harness discovers no preset on disk"），所以现在是**声明**。
-# 两个必须守住的细节（都在 preset-delivery.js 里有源码级依据）：
-#   · `!!js` 会被 Loader 求值（`{__jsExpr}`），自己读 YAML 时必须**保真**，否则平台开关会失真；
-#   · 相对模块名会被解析到**注册表所在层**（= dsh-web-app 包目录），不是本目录——本文件里没有相对名。
-
-# ── identity ────────────────────────────────────────────────────────────────
-
-# The preset's own persona, shadowing the deployment default for this agent.
-# `{{model}}` and `{{cwd}}` resolve from the agent's own route and workspace.
-#
-# 【本预设唯一的**有意差异**（相对随包 standard）】2026-09-18：
-# 这行原来与 standard 逐字相同（通用编码人格），于是本预设只是"改了名字的 standard"——
-# 用户提问"我们的预设和标准模式有啥区别？"时，diff 给出的答案是"0 行差异"。
-# 工具/技能按预设隔离在这版 DSH 上做不到（切换预设时 agent 已存在 ⇒ `agent/created` 钩子不触发；
-# 技能注册表在父层读 ⇒ 子层注册看不见；见 docs/03 最新条目），所以**预设能可靠交付的只有人格**。
-# 改这行必须同步更新 scripts/check-preset.mjs 顶部的 INTENTIONAL 白名单（否则门禁会报配置漂移）。
+# Agent preset «PPT 工作室» —— 以 DSH 0.2.1-rc.2 的 standard 预设体为基准复制，
+# 唯一有意差异 = persona（PPT 工作室的人格/开工状态）。
+# 该文件由 scripts/check-preset.mjs 与随装 standard 预设逐行比对，漂移即失败。
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
@@ -51,81 +14,36 @@
       before showing it. The ppt_* tools, the /ppt commands and the PPT Studio skill manuals are your
       working set — reach for them instead of hand-rolling artifacts.
       If the human's request is clearly unrelated to decks, answer it normally without forcing this workflow.
-
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:
     maxBytes: 65536
-
-# ── shell ───────────────────────────────────────────────────────────────────
-
-# `shell-env` stays in the HOST composition: `apps/cli/src/web.ts` injects it to
-# publish `DSH_WEB_URL`/`DSH_WEB_MODE`, and a host row that injects a service is
-# the criterion for host-plane ownership — injection resolves before any session
-# exists, so there is no agent to key by. Behind a preset realm those variables
-# never reached the model's shell at all. Both shell tools consume the host
-# registry from here; their executors (`bash-sandbox`/`pwsh-sandbox`) are
-# host-plane too.
+- id: time-context
+  name: '@deepseek-ai/dsh-time-context'
 - id: tool-bash
   name: '@deepseek-ai/dsh-tool-bash'
   disabled: !!js process.platform === 'win32'
-
 - id: tool-pwsh
   name: '@deepseek-ai/dsh-tool-pwsh'
   disabled: !!js process.platform !== 'win32'
-
-# ── filesystem ──────────────────────────────────────────────────────────────
-
-# Both register into the host `tools` registry and provide nothing, so
-# they need no realm. The `fs` service and its policy stay in the host.
 - id: tool-fs
   name: '@deepseek-ai/dsh-tool-fs'
-
 - id: tool-fs-search
   name: '@deepseek-ai/dsh-tool-fs-search'
   config:
     sampleOverCapGlobResults: false
-
-# ── background jobs ────────────────────────────────────────────────────────
-
-# Only the model-facing controls. The task REGISTRY stays on the host plane:
-# its producers sit outside any realm this file could put it in — `tool-bash`
-# above resolves it with `ctx.get`, and an entry-local realm here is invisible
-# to every sibling row, so `run_in_background` would answer "background jobs
-# unavailable" while these controls sat in the catalog. The registry is keyed by
-# owning agent anyway, so one host instance serves every session. What a preset
-# chooses is whether its agent can collect and stop background work at all.
 - id: tool-jobs
   name: '@deepseek-ai/dsh-tool-jobs'
-
-# ── skills ──────────────────────────────────────────────────────────────────
-
-# The skill REGISTRY lives in the host composition and is layered per scope:
-# these rows register into THIS preset's layer of it, so they need no realm.
-# `skill-filesystem` contributes local-root discovery for agents on this preset, and
-# `tool-skill` gives them the catalog and loader; the merged catalog also
-# carries whatever the deployment registered globally (repository plugins).
+- id: tool-schedule
+  name: '@deepseek-ai/dsh-tool-schedule'
 - id: skill-filesystem
   name: '@deepseek-ai/dsh-skill-filesystem'
-
 - id: tool-skill
   name: '@deepseek-ai/dsh-tool-skill'
-
-# ── goals ───────────────────────────────────────────────────────────────────
-
-# The goal service and session driver stay on the host plane, where the Gateway
-# can resolve them. The human command and model-facing tool register into this
-# preset's scoped layers.
 - id: command-goal
   name: '@deepseek-ai/dsh-command-goal'
-
 - id: tool-goal
   name: '@deepseek-ai/dsh-tool-goal'
-
-# ── plan mode ───────────────────────────────────────────────────────────────
-
-# Plan state is per-agent by nature, so an entry-local realm is not a
-# workaround here — it is the correct lifetime.
 - id: planning
   name: cordis:group
   group: true
@@ -136,29 +54,17 @@
       name: '@deepseek-ai/dsh-plan-mode'
       config:
         section: |
-              You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
-
-              Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
-
-              The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+          You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
 
-              Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+          Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
 
-              Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+          The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
 
-              When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+          Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
 
-# ── compaction ──────────────────────────────────────────────────────────────
+          Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
 
-# `compaction-basic` reads `toolResultPrune` through `ctx.get`, so the pruner must
-# share this realm rather than sit outside it.
-#
-# `tokenMeter` is deliberately NOT in this realm: the meter stays on the HOST
-# plane, and the rows here resolve that one instance. It takes no configuration,
-# keys every fold by Session, and owns the context-meter projection units the
-# browser reads for every session — behind a realm those units would come and go
-# with whichever presets happen to be mounted. What a preset chooses is whether
-# its agent compacts at all, which is `compaction-basic` below.
+          When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
 - id: compaction
   name: cordis:group
   group: true
@@ -168,28 +74,14 @@
   config:
     - id: compaction-basic
       name: '@deepseek-ai/dsh-compaction-basic'
-
     - id: command-compact
       name: '@deepseek-ai/dsh-command-compact'
-
     - id: tool-result-pruner
       name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
       config:
         thresholdChars: 8192
         headChars: 4096
         tailChars: 1024
-
-# ── delegation and workflows ────────────────────────────────────────────────
-
-# The `subagents` registry and its spawn/fork backends live in the HOST
-# composition: the registry is a process singleton whose cross-session queries
-# the api-proxy serves to the browser, and a provider name may only be
-# registered once. This preset contributes the delegation TOOLS, which resolve
-# that host registry.
-#
-# `workflows` is different — nothing outside an agent reads it — so every row
-# that reaches it shares one entry-local realm here, and a consumer left
-# outside would resolve a host registry this preset does not populate.
 - id: delegation
   name: cordis:group
   group: true
@@ -198,118 +90,41 @@
   config:
     - id: tool-subagent-control
       name: '@deepseek-ai/dsh-tool-subagent-control'
-
     - id: tool-subagent-list-agents
       name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
-
     - id: tool-subagent
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: spawn
         toolName: subagent
         modelSelectionSettings: true
-        backgroundMode: continuable
-
-    # Fork omits model selection so provider/model stay equal to the parent and
-    # the inherited history remains eligible for KV Cache reuse. This preset
-    # keeps fork continuable; parent and child inherit the same messaging tool,
-    # while the parent id and return guidance follow the inherited history.
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
-        backgroundMode: continuable
-
-    # Production dsh does not install these optional providers. Install the
-    # matching Bundle in this Profile and restart the Host, then copy this
-    # preset and remove `disabled` from the matching tool row. Host availability
-    # alone grants no tool.
-    - id: tool-subagent-codex
-      name: '@deepseek-ai/dsh-tool-subagent'
-      disabled: true
-      config:
-        provider: codex
-        toolName: subagent_codex
-        backgroundMode: one-shot
-        maxDepth: provider-managed
-
-    - id: tool-subagent-claude-code
-      name: '@deepseek-ai/dsh-tool-subagent'
-      disabled: true
-      config:
-        provider: claude-code
-        toolName: subagent_claude_code
-        backgroundMode: one-shot
-        maxDepth: provider-managed
-
     - id: workflow-ptc
       name: '@deepseek-ai/dsh-workflow-ptc'
       config:
         provider: spawn
-
     - id: tool-workflow
       name: '@deepseek-ai/dsh-tool-workflow'
-
-    # Off by default with the base row it mirrors: the tool description
-    # restricts `ralph` to runs the human explicitly asked for, and completion
-    # is a worker self-report, not an independent evaluation. Preset files take
-    # no patches, so a session that wants it duplicates this preset under a new
-    # id and drops `disabled`; the shipped root shadows a copy that reuses this
-    # id.
-    - id: tool-ralph
-      name: '@deepseek-ai/dsh-tool-ralph'
-      disabled: true
-      config:
-        subagentProvider: spawn
-        maxRounds: 64
-
-# ── remaining model-facing rows ─────────────────────────────────────────────
-
 - id: tool-ask-user
   name: '@deepseek-ai/dsh-tool-ask-user'
-
 - id: tool-todo
   name: '@deepseek-ai/dsh-tool-todo'
   config:
     allowParallelInProgress: true
-
-# The `web` service and its search provider stay in the host composition; only
-# the model-facing tool is per-session.
 - id: tool-web
   name: '@deepseek-ai/dsh-tool-web'
   config:
     fetch: true
     searchTimeoutMs: 60000
-
 - id: present
   name: '@deepseek-ai/dsh-tool-present'
-
 - id: tool-plugin-manager
   name: '@deepseek-ai/dsh-plugin-manager/tools'
   disabled: true
-
-# ── 本插件的"预设档"行**不写在这里**（2026-09-26 第四次修订）─────────────────────────────
-# 本文件是「PPT 工作室」预设的组合真相：装配时由 lib/preset-delivery.js 声明给 agentPresets 注册表。
-# 隔离靠**一行自定位行**实现，但那一行**由声明时程序化追加**（`preset-delivery.js` 的 `selfPresetRow()`）：
-#     { id: 'ppt-studio-scope', name: 'file:///<本包绝对路径>/lib/index.js', config: { scope: 'preset', autoPreset: false } }
-# 为什么不写死在 YAML 里：
-#   ① 写死就要在安装期把绝对路径填进来 ⇒ 换 profile/升级换代会陈旧；`import.meta.url` 现算永远是对的；
-#   ② 本文件的"不含插件行"是**被门禁断言**的（`scripts/verify-bundle-install.mjs` 断言预设组合里没有
-#      `ppt-studio` 插件行、`scripts/check-preset.mjs` 做逐行意图比对）——程序化追加让 YAML 保持干净，门禁全绿。
-# 为什么必须是**绝对 file://**（而裸包名不行）：
-#   预设的行由注册表在**它自己 ctx 的 baseUrl** 下 mount（源码 `mountPreset(scope.ctx.extend({ baseUrl: record.context.baseUrl }), …)`，
-#   而 `register()` 里 `context = this.ctx`）——那是 `dsh-web-app` 的包目录，**不是** profile、也不是预设目录
-#   ⇒ 裸包名 `dsh-ppt-studio` 解析不到 ⇒ 预设被判 `broken` ⇒ 前端选择器只渲染健康预设
-#   （`presetOptions() = presets.filter(p => p.broken === void 0)`）⇒ 用户根本选不到；
-#   而 Loader 对**非 `.` 开头**的名字是**原样 `import(name)`** ⇒ `file://` 绝对名不查 baseUrl。
-#   （0.1.7-rc.2 上真宿主实测：工具 22/0、技能 4/0、提示段有/无、切换预设、负面对照，全过。）
-#
-# 历史沿革（两次"证伪"的正确结论，别再按旧结论行事）：
-#   ① 2026-09-18 的"按 agent 动态门控"（`agent/created` 钩子 + 子层注册）**确实不可行** ——
-#      空白会话切预设时 agent 已存在、钩子不会为它触发。但那只是"插件自己按 agent 门控"这一种写法；
-#      **预设行挂载**不经过 agent 生命周期：声明即挂载，切换预设时宿主把 agent 的 scope 父指针 `rebind`
-#      到新代，可见性自动跟随。
-#   ② "技能分层 ⇒ 子层注册父层看不见"方向对、**但不是障碍**：技能读路径按"查看方 scope 的链"合并
-#      （含 agent 自己那一层）⇒ 注册进**预设作用域**正是技能能被该预设看到的**充要姿势**。
-
+- id: tool-plugin-market
+  name: '@deepseek-ai/dsh-plugin-market/tools'
+  disabled: true

package/cordis.patch.yml

@@ -12,7 +12,7 @@
 #   · 本行 = 把插件挂进 **profile 层**。`config.scope` 决定它的角色：
 #       - `auto`（缺省，= 本行现在写的值）：声明「PPT 工作室」预设，并给它追加一行**自定位行**
 #         （本包入口的绝对 `file://`）⇒ 预设的常驻组合会再挂本包一次（`scope: 'preset'`），
-#         **那一次**把 22 个 `ppt_*` 工具 / `/ppt` 命令 / `ppt_state` / 4 本内嵌技能 / 语义路由 / 工作流提示段
+#         **那一次**把 22 个 `ppt_*` 工具 / `/ppt` 命令 / `ppt_state` / 17 本内嵌技能 / 语义路由 / 工作流提示段
 #         全部注册在**预设作用域** ⇒ 只有「PPT 工作室」的会话看得到，**其他预设零影响**。
 #         本档自己不注册任何能力面；只有判定隔离没生效时才**自动回落**到全局（功能不丢，只是没隔离）。
 #       - `profile`：传统档，一律全局（所有预设都能用）。想回到旧行为就改成这个。

package/docs/03-/346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -2,6 +2,47 @@
 
 > 格式：`## [版本号] 日期` → 目的（为什么改，引测试反馈编号）→ 改动 → 验证 → 影响/后续。
 
+## [1.2.2] 2026-10-18 —— 适配 DSH 0.2.1-rc.2 + CI 稳定性
+
+**环境事实（实测 2026-10-17）**
+- 桌面 App 外壳 `app.asar/package.json` = `@deepseek-ai/dsh-desktop@0.2.1-rc.2`；运行宿主 `plugin_manager list_bundles` 的 `dsh-base` / `dsh-web-app` / agent-team 全部 = 0.2.1-rc.2 ⇒ **运行宿主 = 0.2.1-rc.2** ✓。
+- npm 全局 CLI（`dsh --version`）原为 0.2.0-rc.2（**落后**）⇒ 按"先对齐后适配"用 `npm install -g @deepseek-ai/dsh@next` 升到 0.2.1-rc.2（守卫：`@next` = 0.2.1-rc.2 = 桌面端，未超前 ✓）。
+- `~/.dsh/dsh-runtimes/dsh-primary-runtime/runtime.json` 的 `desktopVersion` 仍是 0.2.0-rc.2 —— **陈旧元数据**，不代表运行宿主；版本判据以 `app.asar/package.json` + 宿主 bundle 目录为准。
+- profile 仍为 desktop / web / headless 三个（`tui` 只出现在检查脚本的搜索列表里，不是实际 profile）。
+
+**兼容性复核（0.2.1-rc.2 上实测）**
+- 服务与签名不变：`tools.register(definition)`、`commands.register(definition)`、`systemPrompt.section(section)`、`skills.register(skill)`（另有 `registerProvider`）、`agentPresets.register(definition) → Promise<() => Promise<void>>`。
+- `dsh-skill` 同时保留 `register` 与 `registerProvider` ⇒ 17 本内嵌技能仍按原通道注册。
+- `dsh.bundle.patch`（profile 层 patch）语义不变；`plugin_manager` 仍能识别本插件 bundle。
+- **标准预设改了形状**：参照从 `dsh-agent-presets/presets/standard/agent.cordis.yml` 迁到 `dsh-web-app/presets/standard.patch.yml`（`- insert:` → `preset-standard` → `config.plugins`），standard 组合行 **19 → 22**（新增 `time-context`、`tool-schedule` 等），`planning` / `delegation` 两个分组的 config 也变了。
+- **修法**：以 0.2.1 的 standard 组合为基准重写 `agent-presets/ppt/agent.cordis.yml`（**文本级拼接**，保留 `!!js` 标签与多行字符串，不靠 YAML 重序列化），只保留唯一有意差异 `persona`（PPT 工作室人格）。
+- 同步更新 smoke §40 的三处行数期望（19/20 → 22/23）。
+
+**验收证据（全部实测）**
+- `npm test`：**全部通过**（`check-preset` 漂移 0 / 缺行 0 / 有意差异 1 ✓；`lib ⟷ src` 逐字节一致 ✓；痕迹扫描 0 ✓；生成器 9/9 ✓）
+- `node scripts/verify-preset-scope.mjs --expect-skills 17`：**PASS 22 / 0** —— ppt 预设 **17 技能 / 22 个 ppt_* 工具**、standard 预设 **0**、全局视图 **0** ✓
+- `npm run verify:package`：通过（249 文件、装到干净目录后 `require` 可用 ✓）
+- `npm run verify:products`：通过（13 页 PNG 与基线一致，差异 0 ✓）
+
+**CI 稳定性（同版一并交付）**
+- **被测 DSH 版本单源化**：新增 `dsh-target.json`（唯一事实源）；`ci.yml` 用 `node -p` 读取，不再手写死数字；`scripts/check-dsh-target.mjs` 并入 `npm test`，强制它 == `docs/14` 的 `dsh-target:` 行，且 `dsh.engines.dsh` 下限不得高于目标。
+- **PR 不跑安装链**：`install-path` 加 `if: github.event_name != 'pull_request'` ⇒ PR 只跑干净检出的快测档，安装链在 main / 手动 时跑。
+- **`@next` 周检**：新增 `dsh-next-probe.yml`（每周一 + 手动，作业级 `continue-on-error`）⇒ 上游 DSH 变化**只告警、不拦 PR**。
+- **工作流语法守卫**：新增 `scripts/check-workflows.mjs`（并入 `npm test`），解析全部 workflow 并校验结构。起因：`dsh-next-probe.yml` 的 step 名含 `: ` 未加引号 ⇒ GitHub 判文件无效（显示文件路径 + "No jobs were run"）；该类错误现在**本地即被拦住**。
+- **修复**：`ci.yml` 的 one-command install 钉版由 `0.1.6-alpha.2` 改为跟随 `dsh-target.json`（= 0.2.1-rc.2），消除"预设来自新版、CLI 是旧版"的安装自证假红。
+
+**发布**：本条目即 **1.2.2**（2026-10-18）；发版前检查全绿：`npm test` 322/0、`verify:package`、`verify:products` 13/13。安装方式：两端统一改为 npm 安装 `dsh-ppt-studio@1.2.2`。
+
+## [1.2.1] 2026-09-30 —— 修复：复杂图 skills 未被注册（用户实测）
+
+**问题**：新预设会话里，斜杠命令与助手的 skill 清单都找不到复杂图相关 skill（四份 `ppt-studio-*` 正常可见）。
+
+**根因（实测）**：DSH 按「`SKILL.md` + frontmatter（`name`/`description`/`whenToUse`）」注册 skill；而 `skills/ppt-studio-diagram/SKILL.md` **没有 frontmatter**，12 份配方只是 `skills/diagrams/` 下**散装的 `.md`**、该目录**没有 `SKILL.md`** ⇒ 两组都不满足注册条件（打包正常，文件都在）。
+
+**修法**：① 给 `ppt-studio-diagram/SKILL.md` 补 frontmatter；② 把 12 份配方各自拆成独立 skill 目录（各带 frontmatter），并**统一命名为 `ppt-studio-` 前缀**：`ppt-studio-diagram`（总纲）+ 12 份 `ppt-studio-diagram-<类型>`（tree/matrix/timeline/swimlane/compare/loop/funnel/steps-ring/sequence/state/flow/layers）⇒ 共 **17 个**内置技能（含原有 4 份）随**预设作用域**注册，不进全局技能目录。同期修：描述补足 >20 字符并剔除会破坏 YAML 的 `: ` 写法、正文 >800 字符、每份补「收工自检」与「优先级边界」块、smoke 的 §40/§52 期望技能数 4→17。
+
+**验证**：仓库内 17 个 skill 目录均含 `SKILL.md`；安装后应能在预设会话的 skill 清单/斜杠命令中看到 `ppt-studio-diagram` 与 12 份 `diagram-*`。
+
 ## [1.2.0] 2026-09-30 —— 复杂图通路定稿 + 适配 DSH 0.2.0-rc.2
 
 **场景**（docs/07 §2 的可验证内核）：拿到一份已有风格的参考稿，要在**同一风格**下换/加一页复杂图。

package/docs/07-/345/244/215/346/235/202/345/233/276/350/203/275/345/212/233/347/253/213/351/241/271/344/270/216/351/243/216/351/231/251/347/231/273/350/256/260.md

@@ -314,6 +314,6 @@ expectedIntersections:
 | 5 | 裁决优先级细则（参考稿内部矛盾取舍） | **留待后续版本** |
 | 6 | `role` 覆盖阈值告警 | 待定 |
 
-> 现行唯一通路是**手写显式 elements**，见 `skills/diagram-drawing/`（SKILL.md / mechanisms.md）。
+> 现行唯一通路是**手写显式 elements**，见 `skills/ppt-studio-diagram/`（SKILL.md / mechanisms.md）。
 > 本文件仅作历史对照保留。
 

package/docs/08-/351/230/266/346/256/265A/350/256/276/350/256/241/350/257/264/346/230/216-/347/273/223/346/236/204/345/205/263/347/263/273/344/270/216/345/233/276/344/270/223/345/261/236/346/240/241/351/252/214.md

@@ -301,6 +301,6 @@ resolveDeck → normalizePage
 - `attach` 只支持"边 + 最近点"锚定；折线中途拐点吸附（`attach` 到中段）不在阶段 A 范围。
 
 
-> 现行唯一通路是**手写显式 elements**，见 `skills/diagram-drawing/`（SKILL.md / mechanisms.md）。
+> 现行唯一通路是**手写显式 elements**，见 `skills/ppt-studio-diagram/`（SKILL.md / mechanisms.md）。
 > 本文件仅作历史对照保留。
 

package/docs/13-/345/217/221/347/211/210/345/207/206/345/244/207/350/256/241/345/210/222.md

@@ -43,8 +43,8 @@
 |---|---|
 | P4-1 | `docs/09-代码地图与模块职责.md`：修复上轮"删行"后可能出现的**表格缺列/断行**（P1-5 扫描同时核对） |
 | P4-2 | `docs/07-复杂图能力立项与风险登记.md`：修复删行留下的**段落断口**（列表项悬空等） |
-| P4-3 | `skills/diagram-drawing/pitfalls.md`：补 **F 组五条流程坑**（清 fixture 只用 `examples/smoke`／参数化必测缺省路径／改基线必留痕／破坏性脚本先只读定位／先打印现场再动手） |
-| P4-4 | `skills/diagram-drawing/mechanisms.md`：写入**门禁原则**（只锁事实与声明自洽；风格与表达取向不入门禁）+ 把 `unknown-key` 登记进 §2 code 对照表 |
+| P4-3 | `skills/ppt-studio-diagram/pitfalls.md`：补 **F 组五条流程坑**（清 fixture 只用 `examples/smoke`／参数化必测缺省路径／改基线必留痕／破坏性脚本先只读定位／先打印现场再动手） |
+| P4-4 | `skills/ppt-studio-diagram/mechanisms.md`：写入**门禁原则**（只锁事实与声明自洽；风格与表达取向不入门禁）+ 把 `unknown-key` 登记进 §2 code 对照表 |
 | P4-5 | `docs/03-更新日志.md`：补写**本轮条目**（标 `[下一版 · 待发]` ✓，**不写版本号生效** ✗）+ **已知限制**段（见 §6） |
 | P4-6 | 交付物侧 `手画12+1/结论表.md`：口径修正为"**机制等价 + 0 页变差 + 2 页风格取向不同**" ✓ + 页 04 五条警告的最终处置（内容层面、不涉插件 ✓） |
 | P4-7 | `README.md` 与根目录文件核查（上一轮未扫 ✗）：不得描述已移除方案；如需补一句"复杂图用手写 elements"✓ 则补 |

package/docs/14-/345/217/221/345/270/203/346/270/205/345/215/225/357/274/210/350/215/211/347/250/277/357/274/211.md

@@ -35,3 +35,85 @@
 ## 5. 发布后
 
 确认装出来的包可用（`npm run verify:package` 已覆盖"装到干净目录 → `require` 可用"）；如需回滚，回滚点标签：`pre-P1`／`pre-P1b`／`pre-P2`／`pre-P3`／`pre-P4`／`pre-P5`／`pre-release` ✓。
+
+---
+
+## 7. 发布通道与硬规矩（2026-09-30 实测确立）
+
+**通道**：`dsh-ppt-studio` 用 **npm Trusted Publishing（OIDC）** 发布 —— **本机没有也不该有 npm 凭据**。
+
+| 事实 | 说明 |
+|---|---|
+| **只有创建 GitHub Release 才触发发布** | `publish.yml` 的触发是 **`release` 事件** ⇒ **只推 tag 不会发布**（1.2.1 首次就因此没发出去）；补发用 `workflow_dispatch` 指定 tag。 |
+| 本地 `npm publish` 必然 E401/E404 | 预期行为，**不是故障**；**不得**把它的退出码当发布判据。 |
+| 发布判据 = **registry 现状** | `npm view dsh-ppt-studio version` / `dist-tags` 必须显示目标版本；否则就是没发。 |
+| Release 事件触发后 | 用 `gh run list` 看 `Publish to npm` 是否 success；必要时取消（撤回触发：删 Release + `gh run cancel`）。 |
+
+**硬规矩（用户指令）**
+1. **没有用户明确指令，不得创建 GitHub Release、不得打版本标签、不得改版本号** —— 创建 Release 就等于发布。
+2. 每次发布前必须逐条跑通发版前检查（本文件 §1–§4）。
+3. 发布后必须**从 registry 复核**，并把结果写进 `docs/03` 与发布报告。
+
+**标准发布序列**：`npm test` 全绿 → `verify:package` / `verify:products` → 版本号 + `docs/03` 定稿 → 提交并推 `main` → 打 `v<版本>` 标签并推 → **创建 Release（附 tgz）** → 轮询 registry 至目标版本 → 两端安装升级 → 复核。
+
+---
+
+## 8. 发布 RUNBOOK（npm OIDC 专用 · 照抄执行）
+
+> **一句话**：本包**没有也不该有**本机 npm 凭据；发布**只能**通过"创建 GitHub Release → `publish.yml` 用 OIDC 发到 npm"这条路。
+
+### 8.1 铁律（违反即算事故）
+1. **没有用户明确指令，不得**：改 `package.json` 版本号 / 打 `v*` 标签 / 创建 GitHub Release。**创建 Release = 发布**。
+2. **不得用本机 `npm publish`** —— 必然 `E401/E404`，这是**设计如此**，不是故障；**永远不要**把它的退出码当发布判据。
+3. **发布判据只有一个**：`npm view dsh-ppt-studio version`（与 `dist-tags`）显示目标版本。
+
+### 8.2 标准序列（逐条执行，任一不过即停）
+```powershell
+# 0) 发版前检查（全绿才能继续）
+npm test                        # 期望 322 通过 / 0 失败
+npm run verify:package          # 打包与安装一致性（装到干净目录后 require 可用）
+npm run verify:products         # 本机专用：重出 → 导出 → 渲染 13 PNG → 与基线比对
+
+# 1) 版本与日志
+#    package.json 的 version → <新版本>；docs/03 写 [<新版本>] <日期> 条目（含已知限制）
+
+# 2) 提交并推主干
+git add -A; git commit -m "release(<版本>): …"; git push origin main
+
+# 3) 打标签（注意：**只推 tag 不会发布**）
+git tag -a v<版本> -m "<一句话>"; git push origin v<版本>
+
+# 4) 打包并**创建 Release** —— 这一步才触发发布
+$tmp = Join-Path $env:TEMP ("rel" + (Get-Random)); New-Item -ItemType Directory -Force -Path $tmp | Out-Null
+$tgz = (npm pack --pack-destination $tmp | Select-Object -Last 1).Trim()
+gh release create v<版本> (Join-Path $tmp $tgz) -R zbsph/dsh-ppt-studio -t "dsh-ppt-studio <版本>" -n "<发布说明>"
+
+# 5) 等发布并**从 registry 复核**（唯一判据）
+gh run list -R zbsph/dsh-ppt-studio --limit 3        # 看 "Publish to npm" 是否 success
+npm view dsh-ppt-studio version                       # 必须等于 <版本>
+npm view dsh-ppt-studio dist-tags --json
+
+# 6) 两端安装升级
+#    web： dsh plugin --profile web add dsh-ppt-studio@<版本>
+#    桌面端：应用「插件管理」界面升级（CLI 对 desktop profile 会被拒：managed exclusively by the Electron application）
+#    ⇒ 桌面端升级后需**重启应用**才生效；重启后在插件管理里确认版本
+
+# 7) 记录：docs/15 追加发布小节；docs/03 条目保持与实际一致
+```
+
+### 8.3 撤回（仅当尚未真正发布到 npm）
+```powershell
+gh release delete v<版本> -R zbsph/dsh-ppt-studio --yes   # 移除触发源
+gh run list -R zbsph/dsh-ppt-studio --limit 5             # 找到 queued/in_progress 的 Publish run
+gh run cancel <数据库ID> -R zbsph/dsh-ppt-studio          # 取消它
+npm view dsh-ppt-studio version                           # 确认仍是上一版（= 未发布）
+```
+**一旦已发布**：**不要** unpublish（会伤消费者）⇒ 改用**发下一个补丁版本**修正。
+
+### 8.4 补发/重发
+用工作流自带的手动入口（`publish.yml` 支持 `workflow_dispatch` 并接受 tag 入参）：
+```powershell
+gh workflow run publish.yml -R zbsph/dsh-ppt-studio -f tag=v<版本>
+```
+
+`dsh-target: 0.2.1-rc.2`（CI install-path 的被测 DSH 版本；与 `dsh-target.json` 同源，由 `scripts/check-dsh-target.mjs` 强制一致）

package/docs/15-1.2.0 /345/217/221/345/270/203/346/212/245/345/221/212.md"

@@ -0,0 +1,59 @@
+# 1.2.0 发布报告
+
+> 数据来源：本机实测命令输出（2026-09-30）。**结论：1.2.0 已发布且两端可用。**
+
+## 1. 发布渠道与地址
+
+| 渠道 | 状态 |
+|---|---|
+| **npm registry** | `dsh-ppt-studio@1.2.0` 已发布；`dist-tags = { latest: "1.2.0" }` ✓（由 tag `v1.2.0` 触发仓库的 GitHub Actions **OIDC 受信发布**，发布者显示为 `GitHub Actions <npm-oidc-no-reply@github.com>`） |
+| **git** | annotated tag `v1.2.0` → commit `976e97e`；分支 `main` 已推送 ✓ |
+| **GitHub Release** | `https://github.com/zbsph/dsh-ppt-studio/releases/tag/v1.2.0`（含 `dsh-ppt-studio-1.2.0.tgz` 资产，可用于离线/归档安装） |
+
+## 2. 两端安装与激活
+
+| 端 | profile | 插件版本 | 说明 |
+|---|---|---|---|
+| 桌面端 | `desktop` | **1.2.0** ✓ | 经**应用侧**插件管理升级成功（`changed: true`，返回 `restart-required`）⇒ **重启应用后生效**；用户已在界面确认显示 **1.2.0** ✓ |
+| Web 端 | `web` | **1.2.0** ✓ | 由 GitHub Release 的 tgz 安装；用户已在界面确认显示 **1.2.0** ✓ |
+| headless | `headless` | 未装 | 按既定决定保持干净；需要时：`dsh plugin --profile headless add dsh-ppt-studio@1.2.0` |
+
+## 3. 发版前检查（全部通过）
+
+- `npm test`：**322 通过 / 0 失败** ✓（含 `lib ⟷ src` 39/39 逐字节相同 ✓、未知键零误报 0 ✓、可见文本痕迹扫描 0 ✓、生成器检查网 9/9 ✓、13 页手画摘要与基线一致 ✓）
+- `npm run verify:package`：通过 ✓（`npm pack` 248 文件、必含项齐全、装到干净目录后入口可 `require`、包内无已移除方案的痕迹）
+- `npm run verify:products`：通过 ✓（13 张 PNG 与基线一致，差异 0）
+- 预设漂移：**0 / 缺行 0 / 有意差异 1**（插件 persona）✓
+
+## 4. 本次发布内容
+
+见 `docs/03-更新日志.md` 的 `## [1.2.0] 2026-09-30` 条目：复杂图通路定稿（手写 elements + 门禁）＋ 适配 DSH 0.2.0-rc.2（含四条长期适配规则）。
+
+## 5. 已知限制（随版本发布）
+
+1. 无逐形状样式（阴影/高光/笔触）；开发期的强样式控制选项未纳入；
+2. 手写几何由作者给出 ⇒ 单页成本更高、批量大 deck 更慢；
+3. 生成器检查为**语法级**（运行期类错误仍可能漏网）；
+4. 13 页手画回归语料**不随包发布** ⇒ 该回归只在仓库内可跑；包内只发 `lib`；
+5. `unknown-key` 仍是**测试链守卫**，尚未进入每页门禁报告。
+
+## 6. 遗留与回滚
+
+- **遗留 1**：已发布的 1.2.0 构建自 tag `976e97e`，**不含**其后 `9cb5184` 的"更新日志同名标题"排版修复 ⇒ 若希望包内文档也干净，需发 **1.2.1**（功能无差异）。
+- **遗留 2**：`systemPrompt` 出现在 `inject` 声明中，但源码未发现直接调用点（无害，列为可选清理）。
+- **遗留 3**：装配语义（C）只核到"名字与结构仍在"层，未逐行验证行为等价。
+- **回滚点**：`pre-release`、`pre-adapt-D/E/F`、`pre-release-1.2.0`；上一版 tag `v1.1.5`。
+- **平台事实**：桌面 profile 由 Electron 独占管理（`dsh plugin --profile desktop …` 会被拒 ⇒ 桌面端插件变更只能走应用「插件管理」）；`web` / `headless` profile 可用 CLI 管理。
+
+---
+
+## 7. 1.2.1 发布小节（2026-09-30）
+
+| 项 | 值 |
+|---|---|
+| 版本 | **1.2.1**（`package.json`） |
+| 内容 | 修复复杂图 skills 未被注册；13 份统一命名为 `ppt-studio-diagram` + 12 份 `ppt-studio-diagram-<类型>`；描述/正文长度与「优先级边界」合规；smoke §40/§52 期望技能数 4→17 |
+| 发布通道 | **创建 GitHub Release `v1.2.1`** ⇒ `publish.yml` 以 **OIDC 受信发布** → npm（**未使用本机 `npm publish`**，本机无凭据属设计如此） |
+| 发布证据 | `npm view dsh-ppt-studio version` → **1.2.1** ✓；Release 资产 `dsh-ppt-studio-1.2.1.tgz`（含 **17** 个 skill）✓ |
+| 发布前检查 | `npm test` 322/0 ✓、`verify:package` ✓、`verify:products` 13/13 ✓、痕迹扫描 0 ✓、`lib ⟷ src` 39/39 ✓ |
+| 回滚 | 上一版 `v1.2.0`；撤回流程见 `docs/14` §8.3（仅未发布时可用） |

package/dsh-target.json

@@ -0,0 +1,4 @@
+{
+  "dsh": "0.2.1-rc.2",
+  "note": "CI install-path 的被测 DSH 版本（唯一事实源）。升级 DSH 时：改本文件 + docs/14 的 `dsh-target:` 行 + 适配预设，三处由 npm test 的 check-dsh-target 守卫强制一致。"
+}

package/lib/scaffold.js

@@ -152,7 +152,7 @@ expectedOverlaps:
 - 复杂图导出基元：points >2 点 = 折线（一帧 custGeom 开放路径，不是多条拼的）；arrow: 'both' = 两端箭头（arrow: true 等价 'end'）；line.dash: solid|dash|dot|dashDot；kind: notchedRightArrow（流程图常用）。
 
 
-不要再指望引擎替你算几何 —— 按需读 skills/diagram-drawing/（调度手册 mechanisms.md + 12 份子 skill 配方），用显式 elements 把图拼出来。
+不要再指望引擎替你算几何 —— 按需读 skills/ppt-studio-diagram/（调度手册 mechanisms.md + 12 份子 skill 配方），用显式 elements 把图拼出来。
 这是受支持的正式路径，不是退路（13 页实测：零族依赖、门禁 0 错、与旧族产物同内容对照 10 更好 / 1 持平 / 2 持平偏旧 / 0 变差）。
 
 关键机制（都在手画侧）：