dsh-ppt-studio 1.1.2 → 1.1.4

package/lib/preview-server.js

@@ -1,20 +1,22 @@
 /**
  * PPT 预览服务（需求 A「对话内看 PPT」，v0.6.0）：
  * host 侧：webServer 注册 `/ppt-preview/` 前缀路由，静态服务于"预览根"。
- * - 预览根 = ~/.dsh/ppt-studio/preview/<token>/：pages/（render 的 html）+ media/（deck 媒体）。
+ * - 预览根 = `<dshHome>/ppt-studio/preview/<token>/`：pages/（render 的 html）+ media/（deck 媒体）。
  *   render 输出的 html 引用 `../media/`（相对 deck 根）→ 预览根内 pages/../media/ 恰好解析。
+ *   **路径每次调用求值**（认 `DSH_HOME`；见 src/home.js 的口径统一说明）。
  * - URL 为同源相对路径（/ppt-preview/<token>/pages/deck.html）：GUI 页面本身就在 host 上，
  *   点击/iframe 均同源，不依赖端口探测。
  */
 import { mkdir, rm, copyFile, cp, readFile, stat } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { join, dirname, extname, normalize } from 'node:path'
-import { homedir } from 'node:os'
 import { createHash } from 'node:crypto'
+import { pptStudioDir } from './home.js'
 import { resolveDeck } from './pptd/schema.js'
 import { renderDeck } from './pptd/render-html.js'
 
-export const PREVIEW_ROOT = join(homedir(), '.dsh', 'ppt-studio', 'preview')
+/** 预览根（调用时求值）。 */
+export function previewRoot() { return join(pptStudioDir(), 'preview') }
 const tokens = new Map() // token -> previewRoot
 
 const MIME = {
@@ -37,7 +39,7 @@ export async function buildPreview(dir) {
   const ctx = await resolveDeck(dir)
   const r = await renderDeck(ctx, {})
   const token = createHash('md5').update(dir).digest('hex').slice(0, 10)
-  const root = join(PREVIEW_ROOT, token)
+  const root = join(previewRoot(), token)
   await rm(root, { recursive: true, force: true })
   await mkdir(join(root, 'pages'), { recursive: true })
   for (const f of r.htmlFiles) {
@@ -71,7 +73,7 @@ export async function buildPreview(dir) {
 /** token → 预览根（内存优先，miss 时从 .meta.json 恢复并回填）。 */
 async function resolveToken(token) {
   if (tokens.has(token)) return tokens.get(token)
-  const root = join(PREVIEW_ROOT, token)
+  const root = join(previewRoot(), token)
   try {
     const meta = JSON.parse(await readFile(join(root, '.meta.json'), 'utf8'))
     if (meta?.sourceDir) {

package/lib/router.js

@@ -113,7 +113,7 @@ export function workflowSection(taskType, cfg) {
         '4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。',
         '5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。',
         '6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注"快速模式：未经视觉审阅"。',
-        '7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。',
+        '7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。',
         '8. 用户明确要求始终优先；回到完整模式：/ppt normal。',
       ].join('\n'),
     }
@@ -150,9 +150,10 @@ export function workflowSection(taskType, cfg) {
       '7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判"一致 / 冲突 / 无来源支撑 / 无法核实"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判"无法核实"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要"单页独立版"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；"看起来就是模板原样"用 `ppt_patch`（手术贴模板）。',
       '8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。',
       '9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。',
-      '10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。',
+      '10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。',
       '11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注"未经视觉审阅"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。',
       '12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑"美观重点页"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。',
+      '13. **改既有 PPT 的两条纪律**：① **就地手术优先**——任务若是"改某几页 / 改一处文字 / 换一张图"，优先 `ppt_splice`（把工作区某一页替换进原稿，**其余页逐字节不变**；用户要"单页独立版"用 `ppt_slice`；要"看起来就是模板原样"用 `ppt_patch`），不要图省事整册重渲。`ppt_import` 会给出**页码/元素级**的"无法保真特性"清单（工程内 `loss-audit.json` + 一行结论），并按 ✓/⚠/ℹ 三档区分：✓ 干净、⚠ 有会丢的可见特性（动画/阴影/超链接/切换/SmartArt/EMF 等）、ℹ 仅主题样式表里的渐变模板未被引用（不影响观感）；**⚠ 命中时"只改某几页"必须走 `ppt_splice`，并在交付说明里写明"整册重渲会丢 <类别 N 处>"**。② **Excel 素材的数字要么重算、要么标注**：从 xlsx 取数时公式的缓存值可能陈旧或缺失；探测到捆绑 LibreOffice kit 就用它的 `recalculate` 重算，做不到时必须在交付说明里写明"公式值未重算（可能陈旧）"，别把旧缓存值当已核对的数据。',
     ].join('\n'),
   }
 }

package/lib/state.js

@@ -1,14 +1,16 @@
 /**
  * ppt-studio 状态：会话级（路由/档位）+ 项目级（state.json）。
- * 会话状态持久化到 ~/.dsh/ppt-studio/session-<id>.json，供 resume 恢复。
+ * 会话状态持久化到 `<dshHome>/ppt-studio/session-<id>.json`，供 resume 恢复。
+ * **路径每次调用求值**（认 `DSH_HOME`）——见 src/home.js 顶部的口径统一说明；
+ * 此处原为模块常量 `homedir()/.dsh`，会让隔离 DSH_HOME 的测试/便携部署把状态写进真实家目录。
  */
 import { readFile, writeFile, mkdir, access } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
-import { homedir } from 'node:os'
+import { pptStudioDir } from './home.js'
 
-const ROOT = join(homedir(), '.dsh', 'ppt-studio')
-export const SESSION_DIR = ROOT
+/** 会话状态目录（调用时求值）。 */
+export function sessionDir() { return pptStudioDir() }
 
 export const DEFAULT_SESSION = () => ({
   routing: 'auto',            // auto | on | off（语义判断开关）
@@ -25,7 +27,7 @@ export const DEFAULT_SESSION = () => ({
   deckDir: null,
 })
 
-const sessionPath = (sessionId) => join(ROOT, `session-${sanitize(sessionId)}.json`)
+const sessionPath = (sessionId) => join(sessionDir(), `session-${sanitize(sessionId)}.json`)
 
 export async function loadSession(sessionId) {
   return (await loadSessionDiag(sessionId)).state
@@ -44,7 +46,7 @@ export async function loadSessionDiag(sessionId) {
 }
 
 export async function saveSession(sessionId, state) {
-  await mkdir(ROOT, { recursive: true })
+  await mkdir(sessionDir(), { recursive: true })
   await writeFile(sessionPath(sessionId), JSON.stringify(state, null, 2))
 }
 

package/lib/templates.js

@@ -7,9 +7,9 @@
 import { readFile, readdir, rm } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { join, dirname, resolve, sep } from 'node:path'
-import { homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
 import YAML from 'yaml'
+import { pptStudioDir } from './home.js'
 
 export const TEMPLATES_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates')
 
@@ -22,11 +22,11 @@ export const TEMPLATES_DIR = join(dirname(fileURLToPath(import.meta.url)), '..',
  *   **用户自己攒的模板会被整目录覆盖掉**。用户层目录在 node_modules 之外，升级不碰。
  *
  * **每次调用求值**（故意不做成模块常量）：测试/CI 可以把 `DSH_HOME` 指到临时目录来验证这一层，
- * 而常量会在 import 时就定死、无法覆盖。
+ * 而常量会在 import 时就定死、无法覆盖。2026-09-26 起该口径由 `src/home.js` 统一提供
+ * （state/preview/diag 也都改成了调用时求值，不再各自实现）。
  */
 export function userTemplatesDir() {
-  const home = process.env.DSH_HOME || join(homedir(), '.dsh')
-  return join(home, 'ppt-studio', 'templates')
+  return join(pptStudioDir(), 'templates')
 }
 
 /** 按 id 找模板目录：**用户层优先**（同名时用户覆盖随包），再找随包层。找不到返回 null。 */

package/lib/tools.js

@@ -26,6 +26,8 @@ import { crosscheckReport } from './crosscheck.js'
 import { buildPreview } from './preview-server.js'
 import { findPowerPoint, renderPptxToPng } from './msrender.js'
 import { runPythonExport, findPython } from './pptxPy.js'
+import { detectCapabilities, probeOfficeSkills } from './capabilities.js'
+import { runLibreOfficeRender, runOfficeStructureCheck } from './office-qa.js'
 import { imageInfo } from './imgmeta.js'
 import { loadProjectDiag, loadSessionDiag } from './state.js'
 
@@ -163,6 +165,42 @@ async function loadCtx(dir) {
   return resolveDeck(dir)
 }
 
+/**
+ * 第三方结构自证（一行；2026-09-26 第二轮 ②）：用官方 `check_office.py` 独立检查产物的 ZIP/XML/rels 完整性与页数。
+ * 为什么值得每次跑：我们自己的 parity 是"自己写、自己查"，而这一条是**外部**检查——两者同时绿才算真绿。
+ * 本部署没有官方资产时**如实说"未执行"**（web/headless 就是这种情况），不假装跑过。
+ */
+function officialQaNote(file, slides) {
+  const qa = runOfficeStructureCheck(file, { count: slides ?? 0 })
+  if (!qa.available) return `\nℹ 第三方结构自证：未执行（${qa.reason}）`
+  if (qa.ok) {
+    return `\n✅ 第三方结构自证（官方 check_office.py）：ZIP/XML/rels 完整`
+      + `${qa.summary?.slides !== undefined ? `、${qa.summary.slides} 页` : ''}——独立于我们自己的 parity 回读`
+  }
+  return `\n✗ 第三方结构自证失败：${qa.reason}——**请勿交付**，并把本行反馈插件团队`
+}
+
+/**
+ * 兜底路径的"环境说明"（2026-09-26，第二轮）：**用了哪个解释器** + 本部署有没有更强的替代通道。
+ * 为什么写在这里而不是提示段：兜底是罕见路径，说明只该在真的降级时出现（能力自适应），
+ * 且必须如实——官方 `office-pptx` 技能在我们这里只当"读取/补充"，不改变"pptd 才是主通道"。
+ */
+async function fallbackNote(ctx, r) {
+  const src = String(r?.interpreterSource ?? '')
+  const where = src.startsWith('bundled')
+    ? `捆绑 Python（${r?.interpreter}；自带 python-pptx/lxml/Pillow/XlsxWriter）`
+    : `PATH 解释器（${r?.interpreter ?? '?'}）`
+  const notes = [`\n解释器：${where}`]
+  try {
+    const skills = await probeOfficeSkills(ctx)
+    if (skills.available) {
+      notes.push('本部署提供官方 `office-pptx` 技能（同一套捆绑 Python + LibreOffice kit 渲染 + `check_office.py` 结构自检）：'
+        + '需要更细的读取/修改或渲染核对时**加载它**。注意它不改变引擎优先级——pptd 才是主通道，本产物是降级结果。')
+    }
+  } catch { /* 探测失败不影响导出 */ }
+  return notes.join('\n')
+}
+
 export function registerTools(ctx) {
   const reg = (tool) => ctx.effect(() => ctx.tools.register(defineTool(tool)), `ppt-studio: ${tool.name}`)
 
@@ -262,7 +300,7 @@ export function registerTools(ctx) {
 
   reg({
     name: 'ppt_visual',
-    description: 'Office 真渲染通道（v0.8.0）：用本机 PowerPoint COM 把 .pptx 逐页渲染成 PNG（1920×1080）——① 理解用户原稿（参考任务先看后做）② 成品视觉审核（导出后对 pptx 审核真实观感）。pages="15" / "15,18" 只渲染指定页（保持原页号命名；A5 反馈二）——看一页不再等整册。无 Office 时不可用（自动降级 HTML 预览+结构断言）。渲染后请逐页 read_image 查看；视觉理解写入设计摘要/交付说明',
+    description: 'Office 真渲染通道（v0.8.0；2026-09-26 起带 LibreOffice 降级）：优先用本机 PowerPoint COM 把 .pptx 逐页渲染成 PNG（1920×1080）——① 理解用户原稿（参考任务先看后做）② 成品视觉审核（导出后对 pptx 审核真实观感）。pages="15" / "15,18" 只渲染指定页（保持原页号命名；A5 反馈二）——看一页不再等整册。**本机无 Office 时自动降级到捆绑 LibreOffice kit**（桌面端有；报告里会标注引擎与缺字诊断，且明说"不能当逐像素等于 PowerPoint 的判据"）——两条都没有时明确报告不可用。渲染后请逐页 read_image 查看；视觉理解写入设计摘要/交付说明',
     parameters: {
       pptx: { type: 'string', required: true, description: '源/成品 .pptx 绝对路径（用户原稿或 out.pptx）' },
       out: { type: 'string', description: '输出目录（相对当前目录或绝对；缺省 <pptx 同目录>/..-rendered）' },
@@ -271,20 +309,42 @@ export function registerTools(ctx) {
     output: markdownResult(),
     async execute(args) {
       try {
-        if (!findPowerPoint()) {
-          return '⚠ 本机无 Microsoft Office（PowerPoint COM 不可用）：Office 真渲染通道不可用。可继续使用 HTML 预览（ppt_preview）+ 结构断言；本步骤不影响其他工作流。'
-        }
         const pagesSel = typeof args.pages === 'string' ? parsePagesArg(args.pages) : null
         const outDir = args.out ?? join(dirname(args.pptx), 'rendered')
-        const r = await renderPptxToPng(args.pptx, outDir, { pages: pagesSel ? [...pagesSel] : undefined })
-        if (!r.pages) throw new Error('渲染结果为空（请检查 pptx 是否可打开）')
-        return [
-          `✓ Office 真渲染完成（${r.pages} 页${pagesSel ? `，页码 [${[...pagesSel].sort((a, b) => a - b).join(', ')}]` : ''} → ${outDir}）：`,
-          '',
-          ...r.files.map((f) => `  - ${f}`),
-          '',
-          '下一步：逐页 read_image 查看（理解原稿/审核成品观感）。',
-        ].join('\n')
+        if (findPowerPoint()) {
+          const r = await renderPptxToPng(args.pptx, outDir, { pages: pagesSel ? [...pagesSel] : undefined })
+          if (!r.pages) throw new Error('渲染结果为空（请检查 pptx 是否可打开）')
+          return [
+            `✓ Office 真渲染完成（引擎：PowerPoint COM，${r.pages} 页${pagesSel ? `，页码 [${[...pagesSel].sort((a, b) => a - b).join(', ')}]` : ''} → ${outDir}）：`,
+            '',
+            ...r.files.map((f) => `  - ${f}`),
+            '',
+            '下一步：逐页 read_image 查看（理解原稿/审核成品观感）。',
+          ].join('\n')
+        }
+        // 无 Office ⇒ 试**捆绑 LibreOffice kit**（2026-09-26 第二轮 ②）：不依赖 Office/COM 的真渲染。
+        // 用途：没有 Office 的机器（CI、纯 web 部署）也能做视觉抽检；但**引擎不同**，
+        // 排版/字体与 PowerPoint 不是一套 ⇒ 绝不能当"逐像素等于 PowerPoint"的判据（交付说明要标注）。
+        const lo = runLibreOfficeRender(args.pptx, outDir, { pages: pagesSel ? [...pagesSel].sort((a, b) => a - b).join(',') : '', dpi: 144 })
+        if (lo.available && lo.ok) {
+          return [
+            `✓ LibreOffice 真渲染完成（本机无 Office → 降级到捆绑 LibreOffice kit；${lo.files.length} 张 → ${outDir}）：`,
+            '',
+            ...(lo.images.length
+              ? lo.images.map((i) => `  - 原第 ${i.page} 页 → ${i.path}（${i.width}×${i.height}）`)
+              : lo.files.map((f) => `  - ${f}`)),
+            '',
+            '⚠ 引擎差异：LibreOffice 的排版/字体与 PowerPoint 不是同一套引擎，此结果**不能**当"逐像素等于 PowerPoint"的判据——请在交付说明里标注"视觉审阅基于 LibreOffice 渲染"。',
+            ...(lo.missingFonts.length ? [`⚠ 缺字诊断 ${lo.missingFonts.length} 项：${JSON.stringify(lo.missingFonts).slice(0, 240)}`] : []),
+            '',
+            '下一步：逐页 read_image 查看。',
+          ].join('\n')
+        }
+        if (!lo.available) {
+          return `⚠ 真渲染通道不可用：本机无 Microsoft Office，且本部署没有 LibreOffice kit（${lo.reason}）。`
+            + '可继续使用 HTML 预览（ppt_preview）+ 结构断言；本步骤不影响其他工作流。'
+        }
+        return `✗ 真渲染都失败了：无 Office；LibreOffice kit 也失败：${lo.reason}\n（可降级：ppt_preview HTML 预览 + ppt_verify 结构断言）`
       } catch (error) {
         return `✗ Office 真渲染失败：${error?.message ?? String(error)}\n（可降级：ppt_preview HTML 预览 + ppt_verify 结构断言）`
       }
@@ -605,7 +665,7 @@ export function registerTools(ctx) {
 
   reg({
     name: 'ppt_export',
-    description: '导出 .pptx。engine 缺省 auto（=pptd 自研主引擎，图表矢量拼绘；hard 失败时自动回退 python-pptx 并醒目标注降级）；python-pptx 仅显式指定（其图表降级为表格）。out 支持绝对路径（原样使用）或文件名（相对 deck 目录）。audit 质量档自动追加回读断言（页数/尺寸/最小字号）',
+    description: '导出 .pptx。engine 缺省 auto（=pptd 自研主引擎，图表矢量拼绘；hard 失败时自动回退 python-pptx 并醒目标注降级）；python-pptx 仅显式指定（其图表为原生可编辑图表 + 内嵌数据工作簿）。out 支持绝对路径（原样使用）或文件名（相对 deck 目录）。audit 质量档自动追加回读断言（页数/尺寸/最小字号）',
     parameters: {
       dir: dirSchema,
       engine: { type: 'string', enum: ['auto', 'pptd', 'python-pptx'], description: '缺省 auto（=pptd）；python-pptx 需 python 环境' },
@@ -647,9 +707,9 @@ export function registerTools(ctx) {
         }
         if (eff.engine === 'python-pptx' && !eff.allowFallback) {
           const py = findPython()
-          if (!py.has) return `⚠ python-pptx 引擎不可用（未检测到 python + python-pptx 环境）：${py.cmd ? '请 pip install python-pptx' : '未找到 python 解释器'}。可改用默认 pptd 引擎。`
+          if (!py.has) return `⚠ python-pptx 引擎不可用（未检测到带 python-pptx 的解释器）：${py.cmd ? '请给它 pip install python-pptx' : '未找到 python 解释器，也没探测到捆绑 Python'}。可改用默认 pptd 引擎。`
           const r = await runPythonExport(ctx0, outName)
-          return `✓ 已导出（python-pptx 引擎）：${r.file}\n图表已降级为表格（引擎 A 才支持矢量拼绘图表）。${await withAudit(r.file)}${engineNote}`
+          return `✓ 已导出（python-pptx 引擎）：${r.file}\n图表为**原生可编辑图表**（带内嵌数据工作簿；引擎 A 的图表是矢量拼绘、不可改数据）。${await fallbackNote(ctx0, r)}${officialQaNote(r.file, ctx0.pages?.length)}${await withAudit(r.file)}${engineNote}`
         }
         try {
           const r = await exportPptx(ctx0, { out: outName, engine: 'pptd' })
@@ -673,8 +733,8 @@ export function registerTools(ctx) {
             : ''
           const parityNote = r.parity
             ? (r.parity.ok
-              ? `\n✅ 元素 parity 回读：表 ${r.parity.tablesExp}/${r.parity.tablesOut} · 图 ${r.parity.imagesExp}/${r.parity.imagesOut} · 媒体部件 ${r.parity.mediaExp ?? '?'}/${r.parity.mediaOut ?? '?'} · 线方向 ${r.parity.linesExp ?? 0}/${r.parity.linesOut ?? 0}（逐条从 OOXML 反推端点自证） · 结构合法（无 PowerPoint 弃帧类嵌套 xfrm）`
-              : `\n✗ 元素 parity 不一致：表 期望${r.parity.tablesExp}/实际${r.parity.tablesOut} · 图 期望${r.parity.imagesExp}/实际${r.parity.imagesOut} · 媒体 期望${r.parity.mediaExp ?? '?'}/实际${r.parity.mediaOut ?? '?'} · 线 期望${r.parity.linesExp ?? 0}/实际${r.parity.linesOut ?? 0}/方向错${r.parity.linesWrong ?? 0} · 非法帧 ${r.parity.illegalFrames}——请勿交付，附本输出反馈插件团队`)
+              ? `\n✅ 元素 parity 回读：表 ${r.parity.tablesExp}/${r.parity.tablesOut} · 图 ${r.parity.imagesExp}/${r.parity.imagesOut} · 媒体部件 ${r.parity.mediaExp ?? '?'}/${r.parity.mediaOut ?? '?'} · 线方向 ${r.parity.linesExp ?? 0}/${r.parity.linesOut ?? 0} · **文本内容 ${r.parity.textExp ?? 0}/${r.parity.textExp ?? 0}** · 图表图形 ${r.parity.chartShapesExp ?? 0}/${r.parity.chartShapesOut ?? 0}（均逐条从 OOXML 反推自证） · 结构合法（无 PowerPoint 弃帧类嵌套 xfrm）`
+              : `\n✗ 元素 parity 不一致：表 期望${r.parity.tablesExp}/实际${r.parity.tablesOut} · 图 期望${r.parity.imagesExp}/实际${r.parity.imagesOut} · 媒体 期望${r.parity.mediaExp ?? '?'}/实际${r.parity.mediaOut ?? '?'} · 线 期望${r.parity.linesExp ?? 0}/实际${r.parity.linesOut ?? 0}/方向错${r.parity.linesWrong ?? 0} · 文本缺 ${(r.parity.textMissing ?? []).length} 处${(r.parity.textMissing ?? []).length ? `（${r.parity.textMissing.slice(0, 3).join('；')}${r.parity.textMissing.length > 3 ? '…' : ''}）` : ''} · 图表图形 期望${r.parity.chartShapesExp ?? 0}/实际${r.parity.chartShapesOut ?? 0} · 非法帧 ${r.parity.illegalFrames}——请勿交付，附本输出反馈插件团队`)
             : ''
           // P8（测试反馈）：真渲染抽查策略——含复杂元素的页必须覆盖（P1 事故的直接防线）
           const riskyPages = (ctx0.pages ?? []).map((p, i) => {
@@ -684,7 +744,7 @@ export function registerTools(ctx) {
           const renderNote = riskyPages.length
             ? `\nP8 真渲染抽查：建议优先覆盖含 table/chart/image/custGeom 的页 → 第 ${riskyPages.join('、')} 页（每类至少一页；audit 档导出自动全页真渲染）`
             : ''
-          return `✓ 已导出（pptd 引擎，${r.slides} 页）：${r.file}${fit}${phNote}${renamedNote}${parityNote}${renderNote}${floorNote}${chartNote}${await withAudit(r.file)}${engineNote}`
+          return `✓ 已导出（pptd 引擎，${r.slides} 页）：${r.file}${fit}${phNote}${renamedNote}${parityNote}${renderNote}${floorNote}${chartNote}${officialQaNote(r.file, r.slides)}${await withAudit(r.file)}${engineNote}`
         } catch (error) {
           // 自动回退链（C1 决定）：auto 且 pptd 硬失败 → 有 python-pptx 则兜底并醒目标注降级（绝不静默）
           if (eff.allowFallback) {
@@ -692,7 +752,7 @@ export function registerTools(ctx) {
             if (py.has) {
               try {
                 const r2 = await runPythonExport(ctx0, outName)
-                return `⚠ pptd 引擎失败，已自动降级 python-pptx（图表降级为表格）：${error?.message ?? error}\n✓ 已导出（python-pptx 兜底）：${r2.file}\n建议排查 pptd 失败原因（见上）或改用质量更高的模式。${await withAudit(r2.file)}`
+                return `⚠ pptd 引擎失败，已自动降级 python-pptx（其图表为原生可编辑图表 + 内嵌数据工作簿）：${error?.message ?? error}\n✓ 已导出（python-pptx 兜底）：${r2.file}\n建议排查 pptd 失败原因（见上）或改用质量更高的模式。${await fallbackNote(ctx0, r2)}${officialQaNote(r2.file, ctx0.pages?.length)}${await withAudit(r2.file)}`
               } catch (e2) {
                 return `✗ pptd 失败（${error?.message ?? error}）且 python-pptx 兜底也失败：${e2?.message ?? e2}`
               }
@@ -777,7 +837,7 @@ export function registerTools(ctx) {
         const refLine = r.reference?.previews?.length
           ? `\n参考层（参考双轨 v0.9.1——创作前先 read_image 看 reference/previews/*.png 真身再动手，与"按模板做"同一通道）：reference/source.pptx + ${r.reference.previews.length} 页真渲染`
           : `\n⚠ 无整页真渲染参考（无 Office/渲染失败）：可用 ppt_visual 对 source.pptx 补渲；骨架层仍可用`
-        return `✓ 已导入：${r.outDir}（${r.pages} 页，${r.media.length} 个媒体；原始 pptx 已保留为 source.pptx —— 参考双轨真相层）${refLine}\n⚠ ${r.warnings.join('；')}`
+        return `✓ 已导入：${r.outDir}（${r.pages} 页，${r.media.length} 个媒体；原始 pptx 已保留为 source.pptx —— 参考双轨真相层）${refLine}\n⚠ ${r.warnings.join('；')}${r.lossLine ? '\n' + r.lossLine : ''}`
       } catch (error) {
         return `✗ 导入失败：\n${errText(error)}`
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ppt-studio",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "在 DeepSeek Harness 里做 PPT：说需求 → 逐页制作 → 导出可编辑的 .pptx。含布局检查、Office 真渲染复核，以及可扩展的本地模板库",
   "//publish": "2026-09-18 定：发 npm，**无 scope** 包名 `dsh-ppt-studio`。**状态（2026-09-26）：已发布** —— `dsh-ppt-studio@1.1.0` 在 npm 上（`dist-tags.latest`、public，发布者 `zbsph`），registry 的 tarball 与 GitHub Release 资产**逐字节相同**（sha256 `9303cc5c…`）。首个版本是 `npm publish <发版 tgz>` 直发的；**从下一版起改走 Trusted Publishing（OIDC）全自动通道**：`.github/workflows/publish.yml` 由 release 事件触发 → 下载 Release 资产 → OIDC `npm publish` → 发后自证 integrity —— 零长期 token、零手工（npm 已公告：Bypass-2FA 直发 2027-01 移除）。发布纪律不变：**用发版时那个 tgz**（`.sync-state.json` 的 `localTgz`），**别在 main 前进后跑裸 `npm publish`**（会按当前工作区重新打包 ⇒ 破坏'两条通道同一份字节'）。手动补发入口：Actions → Publish to npm → Run workflow。见 README §10 与 docs/05「发布-同步纪律」。",
   "repository": { "type": "git", "url": "git+https://github.com/zbsph/dsh-ppt-studio.git" },
@@ -71,6 +71,7 @@
     "test:preset": "node scripts/check-preset.mjs",
     "test:e2e": "node scripts/e2e-1.0.mjs",
     "test:bundle": "node scripts/verify-bundle-install.mjs",
+    "test:scope": "node scripts/verify-preset-scope.mjs",
     "check:lib": "node scripts/check-lib-freshness.mjs",
     "audit:facts": "node scripts/audit-manual-facts.mjs",
     "probe:effect": "node scripts/probe-effect-semantics.mjs",

package/scripts/audit-manual-facts.mjs

@@ -91,8 +91,10 @@ const tableKeys = src.schema.match(/table: \['cols', 'rows', 'header'\]/)
 check('table 只有 cols/rows/header（手册"没有逐列对齐字段"成立）', !!tableKeys, `schema.js ELEMENT_KEYS: ${tableKeys?.[0] ?? '未找到'}`)
 
 const chartKeys = src.schema.match(/chart: \['chart'\]/)
-const chartNoLabels = !/legend|dataLabels|labels\s*:/.test(src.schema.match(/function validateChart[\s\S]*?\n\}/)?.[0] ?? '')
-check('chart 没有分类名/数值/图例字段（手册"标签要自己补"成立）', !!chartKeys && chartNoLabels, `schema.js ELEMENT_KEYS.chart=${chartKeys?.[0] ?? '?'}；validateChart 只校验 type/data.cols/data.rows/series`)
+// 事实更正（2026-09-26 第三轮：chart 默认 native）：schema 现在**有**可选视觉字段（render/legend/labels/axes）——
+// 默认 native 时图表**自带**坐标轴/网格/图例/数据标签；只有 `render: vector` 才回到"作者自己补标签"。
+const chartHasRender = /CHART_RENDER\s*=\s*\['native',\s*'vector'\]/.test(src.schema)
+check('chart 的可选视觉字段 = render/legend/labels/axes（手册须按 native/vector 两路描述）', !!chartKeys && chartHasRender, `schema.js ELEMENT_KEYS.chart=${chartKeys?.[0] ?? '?'}；CHART_RENDER 常量=${chartHasRender}`)
 
 const trunc = Number((src.svgCharts.match(/c\.length\s*>\s*(\d+)/) ?? [])[1])
 const claimedTrunc = [...all.matchAll(/超过\s*(\d+)\s*字截断/g)].map((m) => Number(m[1]))

package/scripts/e2e-1.0.mjs

@@ -77,8 +77,8 @@ if (m.measured) {
 const exp = await exportPptx(ctx, { out: join(fx, 'fx-pro.pptx'), engine: 'pptd' })
 const z = zipRead(await readFile(exp.file))
 const slides = [...z.keys()].filter((k) => /^ppt\/slides\/slide\d+\.xml$/.test(k))
-const chartParts = [...z.keys()].filter((k) => k.startsWith('ppt/charts/'))
-ok('⑤ export = 12 张 slide + 无 chart 部件（矢量拼绘）', slides.length === seedPages && chartParts.length === 0, `${slides.length} slides`)
+const chartParts = [...z.keys()].filter((k) => k.startsWith('ppt/charts/') && k.endsWith('.xml') && !k.includes('_rels'))
+ok('⑤ export = 12 张 slide + 1 个**原生图表部件**（chart 默认 native；矢量降级见 smoke §57）', slides.length === seedPages && chartParts.length === 1, `${slides.length} slides / chart=${chartParts.length}`)
 // 连线方向自证（2026-09-14 真实反馈：预览对、PowerPoint 里线镜像/× 掉一笔）
 ok('⑤ export parity 自证：表/图/线方向全绿（线逐条从 OOXML 反推端点）',
   exp.parity?.ok === true && exp.parity.linesExp > 0 && exp.parity.linesExp === exp.parity.linesOut && exp.parity.linesWrong === 0,

package/scripts/fixtures/workflow-baseline.json

@@ -35,7 +35,7 @@
         "7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判\"一致 / 冲突 / 无来源支撑 / 无法核实\"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判\"无法核实\"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要\"单页独立版\"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；\"看起来就是模板原样\"用 `ppt_patch`（手术贴模板）。",
         "8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。",
         "9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。",
-        "10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。",
+        "10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。",
         "11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注\"未经视觉审阅\"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。",
         "12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑\"美观重点页\"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。"
       ]
@@ -74,7 +74,7 @@
         "7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判\"一致 / 冲突 / 无来源支撑 / 无法核实\"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判\"无法核实\"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要\"单页独立版\"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；\"看起来就是模板原样\"用 `ppt_patch`（手术贴模板）。",
         "8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。",
         "9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。",
-        "10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。",
+        "10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。",
         "11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注\"未经视觉审阅\"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。",
         "12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑\"美观重点页\"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。"
       ]
@@ -113,7 +113,7 @@
         "7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判\"一致 / 冲突 / 无来源支撑 / 无法核实\"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判\"无法核实\"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要\"单页独立版\"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；\"看起来就是模板原样\"用 `ppt_patch`（手术贴模板）。",
         "8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。",
         "9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。",
-        "10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。",
+        "10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。",
         "11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注\"未经视觉审阅\"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。",
         "12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑\"美观重点页\"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。"
       ]
@@ -152,7 +152,7 @@
         "7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判\"一致 / 冲突 / 无来源支撑 / 无法核实\"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判\"无法核实\"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要\"单页独立版\"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；\"看起来就是模板原样\"用 `ppt_patch`（手术贴模板）。",
         "8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。",
         "9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。",
-        "10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。",
+        "10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。",
         "11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注\"未经视觉审阅\"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。",
         "12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑\"美观重点页\"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。"
       ]
@@ -191,7 +191,7 @@
         "7. 交付前：S4 全通过 + S6 导出 .pptx + 交付说明（素材来源、未视觉审阅项、修改指引）。**内容审阅（M3 重写 2026-09-18）**：有具体数字/事实主张的稿子，交付前用 `ppt_crosscheck` 生成「审阅材料包」（全页正文 + 素材清单 + 审阅协议）→ 再按协议做一次内容审阅：**默认用独立子代理**（全新上下文、只给材料包与素材文件；**用户明确禁止子代理时改自审并标注「自审（同上下文）」**），逐条判\"一致 / 冲突 / 无来源支撑 / 无法核实\"，重点核对同一指标跨页值是否一致、数字是否有依据、结论是否强于数据；**没有外部素材时只能判\"无法核实\"，不得报绿**。该工具**只汇总材料、不做判定、不构成门禁**（旧版 grounded/unmapped 状态与跨页数字分组已废除）。制作进程中**供用户看稿优先用 ppt_preview(dir)**（返回同源预览链接，用户点击即看，附在交付信息里）；导出前/后均可预览。**修改既有精美 PPT 的某一页（edit/augment 高频场景）**：ppt_import 参考层读真身 → 改工作区页并审阅清零 → **`ppt_splice`**（只把该页替换进原稿：保留源母版横幅/页脚/备注关系/媒体，其余页条目 SHA256 逐字节一致——不要整册近似重渲伤及其他页）→ 交付整册副本；用户要\"单页独立版\"再 **`ppt_slice`**；抽查该页观感用 **`ppt_visual pages=N`**（按页真渲染，不必整册）；\"看起来就是模板原样\"用 `ppt_patch`（手术贴模板）。",
         "8. 版式系统（审美基线，用户风格优先）：写页面之前先定版式规则——默认基线：8px 网格对齐、3-4 级字号阶梯、4-5 色主题（只在 $theme 内取色）、统一间距节奏（8/16/24px）、左右外边界一致、构图重心居中；**用户对风格有要求（字体/字号/配色/密度）一律优先，默认基线仅为未指定时的风格参考**。文字：短句化（每块 ≤60 字为默认参考，可依内容放宽），**文本最小字号以用户指令为准**（hardConstraints；未给下限不设强制），长句在语义断点显式 \\\\n 换行。",
         "9. 审美建议（ppt_verify 输出的 [·] 建议）不是门禁，但请逐条斟酌采纳；overlap/out-of-page/text-overflow 错误仍必须清零（审美改进不得引入元素区块冲突）。",
-        "10. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；pptd 硬失败时自动回退 python-pptx（报告醒目标注降级）；python-pptx 仅用户显式指定时使用（其图表降级为表格）——除非用户要求，不要自行切换引擎。",
+        "10. 引擎：**PPT 制作唯一通道 = pptd**（`deck.yaml` + `pages/*.yaml`；图表矢量拼绘）。pptd 硬失败时自动回退 python-pptx（报告醒目标注降级；其图表为**原生可编辑图表 + 内嵌数据工作簿**）；python-pptx 仅用户显式指定时使用。**不要**用 python-pptx 或官方 `office-pptx` 技能从零拼版来绕过本工作流的门禁——它们只适合**读取**既有 pptx、或作为上面的兜底（能不能用由 `ppt_state` 的 `capabilities` 如实报告）。除非用户要求，不要自行切换引擎。",
         "11. 质量档 audit（/ppt quality audit，从严门禁）：禁 autoDeclare（工具已拦）；每页必须 ppt_shot + 读图视觉审阅（无读图能力则降级结构 Lint 并在交付说明标注\"未经视觉审阅\"）；导出报告必须包含并核对 audit 回读断言（页数/尺寸/最小字号 ≥ minFontSize）；有 Office 时导出后自动 **Office 真渲染**（成品视觉审核，逐页 read_image）；交付说明含素材来源与数据脱敏/假设标注。",
         "12. **真渲染抽检铁律（P1 事故教训）**：有 Office 时，真渲染抽查**必须覆盖所有含 table/chart/image/custGeom 的页**（每类至少一页，其余页轮换）——不要只挑\"美观重点页\"；抽查后逐页 read_image（渲染图已带 1px=1pt 比例标注水印，降低坐标误判）。导出报告会给出建议覆盖页清单（P8 行）。"
       ]
@@ -212,7 +212,7 @@
         "4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。",
         "5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。",
         "6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注\"快速模式：未经视觉审阅\"。",
-        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。",
+        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。",
         "8. 用户明确要求始终优先；回到完整模式：/ppt normal。"
       ]
     },
@@ -232,7 +232,7 @@
         "4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。",
         "5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。",
         "6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注\"快速模式：未经视觉审阅\"。",
-        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。",
+        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。",
         "8. 用户明确要求始终优先；回到完整模式：/ppt normal。"
       ]
     },
@@ -252,7 +252,7 @@
         "4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。",
         "5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。",
         "6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注\"快速模式：未经视觉审阅\"。",
-        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。",
+        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。",
         "8. 用户明确要求始终优先；回到完整模式：/ppt normal。"
       ]
     },
@@ -272,7 +272,7 @@
         "4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。",
         "5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。",
         "6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注\"快速模式：未经视觉审阅\"。",
-        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。",
+        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。",
         "8. 用户明确要求始终优先；回到完整模式：/ppt normal。"
       ]
     },
@@ -292,7 +292,7 @@
         "4. 页数：≤8 页（用户指定除外）；每页文本精简（每块 ≤40 字为默认参考，用户要求可放宽）。",
         "5. 审阅：ppt_render + ppt_verify 必跑——内容互压/出界/文本溢出/预期外重叠（设计意图声明制）必须清零；出界分级同标准模式（超页面不可声明；安全区外有意元素逐项加 expectedOutOfSafeArea）；autoDeclare 后附一句意图说明；跳过截图视觉审阅与美学迭代。",
         "6. 交付：ppt_export（引擎 auto=pptd）→ 交付说明标注\"快速模式：未经视觉审阅\"。",
-        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表降级为表格）。不要自行切换引擎。",
+        "7. 引擎：auto 默认 = pptd（自研主引擎，图表矢量拼绘）；python-pptx 仅显式指定或 pptd 失败时使用（其图表为原生可编辑图表 + 内嵌数据工作簿）。不要自行切换引擎。",
         "8. 用户明确要求始终优先；回到完整模式：/ppt normal。"
       ]
     }

package/scripts/install.mjs

@@ -70,19 +70,21 @@ const legacyPkgDir = join(profileDir, 'node_modules', '@dsh-external', 'dsh-ppt-
 const legacyPresetDir = join(prefix, '.agent-presets', 'ppt')
 
 if (args.includes('--isolate')) {
-  console.error(`✗ --isolate 在 DSH 0.1.7 上不再可用（本安装器拒绝写出一个永远不会被读到的预设）
+  console.error(`✗ --isolate 在 DSH 0.1.7 上不再可用（**隔离现在是默认行为**，不需要这个开关）
 
-  原因（两处，都有源码依据）：
-    · 宿主不再扫描 \`<dshHome>/.agent-presets/\`——上游原文 "the harness discovers no preset on disk"，
-      预设改为向 agentPresets 注册表声明；旧写法写完等于没写，且**静默**。
-    · 预设的行现在由注册表在它自己 ctx 的 baseUrl 下 mount（= dsh-web-app 包目录，不是 profile、
-      不是预设目录）⇒ 预设里的裸包名 \`dsh-ppt-studio\` 解析不到 ⇒ 预设被判 broken ⇒ 选择器看不到它。
+  原因：
+    · 插件声明「PPT 工作室」预设时会追加一行**自定位行**（本包入口的绝对 \`file://\` 名字）
+      ⇒ 预设的常驻组合把插件再挂一次，那一次的工具/技能/提示段只落在**预设作用域**
+      ⇒ 只有该预设的会话看得到，**其他预设完全不受影响**（2026-09-26 真宿主实测通过）。
+    · 所以"默认装法"与"隔离装法"已经合并：直接跑本脚本（不带 --isolate）即可。
+    · 0.1.6 时代的 \`--isolate\` 靠"预设目录内 junction + 相对路径行"实现；0.1.7 删除了目录发现，
+      且预设行按注册表所在 ctx 的 baseUrl 解析（= harness 包目录）⇒ 那条路必然产出 broken 预设，
+      本安装器不再写它（也不再写 \`<dshHome>/.agent-presets/\`）。
 
   可选做法：
-    · 默认（全局）安装：直接跑本脚本不带 --isolate —— 「PPT 工作室」预设会由插件自己声明，
-      该 profile 的**所有会话**都能用 ppt_* 工具（这也是当前发布的装配形状）。
-    · 真要"只在「PPT 工作室」里生效"：需要把插件行放进**预设声明**里、并用安装期算出的绝对
-      \`file://\` 名字（见 README §10「隔离安装」）。这条路尚未实现——宁可明确拒绝，也不静默失败。`)
+    · 默认安装：直接跑本脚本 —— 隔离即默认，一条命令。
+    · 想回到"所有预设都能用"：把 profile 里 \`ppt-studio\` 行的 config 改成 \`scope: 'profile'\`
+      （见 README §1.6「隔离 / 传统档」）。`)
   process.exit(1)
 }
 
@@ -96,7 +98,7 @@ if (!existsSync(join(root, 'lib', 'index.js'))) {
 }
 
 const steps = []
-steps.push(`装配模式：**全局**（profile bundle：该 profile 的所有会话都能用）`)
+steps.push(`装配模式：profile bundle（**隔离默认**：能力面只出现在「PPT 工作室」预设里；把装配行的 scope 改成 'profile' 可回到全局）`)
 
 // ── 1) 包本体可达性 + bundle 装配 ─────────────────────────────────────────────
 const profilePkgFile = join(profileDir, 'package.json')