dsh-ppt 0.6.0 → 0.8.0

package/lib/client.js

@@ -0,0 +1,209 @@
+// Browser source, distributed directly. tsc deliberately does not rewrite this file.
+window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
+  const React = require('react');
+  const { useState, useEffect, useRef, useMemo } = React;
+  const h = React.createElement;
+  const ROUTE = 'api/dsh-ppt/workbench';
+  const fields = [['title', '标题'], ['subtitle', '副标题'], ['kicker', '眉题'], ['text', '正文'], ['bullets', '要点（每行一条）'], ['notes', '演讲备注']];
+  const css = `
+  .pptw {color:var(--fg,#27354b);font:14px/1.6 system-ui,sans-serif;min-width:0;max-width:1140px;margin:0 auto;padding:8px}
+  .pptw *{box-sizing:border-box}.pptw h2{font-size:22px;margin:0}.pptw h3{font-size:16px;margin:12px 0 6px}
+  .pptw .muted{color:var(--fg-muted,#66768a);font-size:13px}.pptw .tools{display:flex;gap:8px;flex-wrap:wrap;margin:12px 0;align-items:center}
+  .pptw button{font:inherit;border:1px solid var(--border,#ccd8e5);border-radius:9px;background:var(--bg-surface,#fff);color:inherit;padding:7px 12px;cursor:pointer;text-align:left;white-space:normal}
+  .pptw button.primary{background:#245ee9;border-color:#245ee9;color:#fff}.pptw button:disabled{opacity:.45;cursor:default}
+  .pptw input:not([type=file]),.pptw textarea,.pptw select{font:inherit;color:inherit;width:100%;background:var(--bg,#fff);border:1px solid var(--border,#c9d5e4);border-radius:8px;padding:8px 10px}
+  .pptw textarea{resize:vertical}.pptw label{display:block;margin:8px 0 3px}.pptw .layout{display:grid;grid-template-columns:minmax(130px,190px) minmax(0,1fr);gap:14px}
+  .pptw .pages{display:flex;flex-direction:column;gap:5px;max-height:480px;overflow:auto}.pptw .pages button[aria-current=true]{background:#245ee9;color:#fff}
+  .pptw .preview{border:1px solid var(--border,#ced8e6);border-radius:12px;overflow:hidden;background:#f0f4fa;aspect-ratio:16/9;position:relative}
+  .pptw iframe{position:absolute;inset:0;width:100%;height:100%;border:0}.pptw .render-page{width:100%;display:block}
+  .pptw .notice{border-radius:9px;padding:10px 12px;margin:10px 0;background:#edf4ff;color:#17408e;overflow-wrap:anywhere}.pptw .error{background:#fff1ef;color:#922d20}
+  .pptw .card{border:1px solid var(--border,#d5dfeb);border-radius:12px;padding:12px;margin:10px 0;background:var(--bg-surface,#fff)}
+  .pptw .project-list{display:flex;flex-direction:column;gap:8px}.pptw .project-list button{display:block;width:100%}
+  .pptw .file{font-size:12px;overflow-wrap:anywhere}.pptw .image-preview{width:100%;max-height:160px;object-fit:contain;background:#edf2f8;border-radius:8px}
+  .pptw :focus-visible{outline:3px solid #78a8ff;outline-offset:2px}.pptw .dirty{color:#986114;font-size:13px}
+  [role=dialog]:has(.pptw){width:min(1200px,calc(100vw - 48px))!important;max-width:1200px!important}
+  @media(max-width:700px){.pptw .layout{grid-template-columns:1fr}.pptw .pages{max-height:180px}.pptw .preview{min-height:190px}.pptw{padding:3px}
+    [role=dialog]:has(.pptw){width:100%!important;max-width:100%!important;flex-direction:column!important}
+    [role=dialog]:has(.pptw)>nav+div{min-width:0;width:100%}
+    [role=dialog]:has(.pptw)>nav+div>div:has(.pptw){padding:12px!important;min-width:0}
+    [role=dialog]:has(.pptw) nav{width:100%!important;flex-basis:auto!important;border-right:0;max-height:170px;overflow:auto}
+    [role=dialog]:has(.pptw) nav>div:has(>button){display:flex;flex-direction:row!important;flex-wrap:wrap;flex-shrink:0;gap:4px}
+  }`;
+
+  async function action(body, signal) {
+    const response = await fetch(new URL(ROUTE, document.baseURI), { method: 'POST', credentials: 'same-origin', signal,
+      headers: { 'content-type': 'application/json', 'x-dsh-ppt-action': '1' }, body: JSON.stringify(body) });
+    let value;
+    try { value = await response.json(); } catch { throw new Error('无法读取服务响应，请检查插件是否加载') }
+    if (!response.ok || value.ok === false) { const error = new Error((value.message || '操作未完成') + (value.installationHint ? '\n' + value.installationHint : '')); error.status = response.status; throw error; }
+    return value;
+  }
+  function draftFor(slide) {
+    return { title: slide.title || '', subtitle: slide.subtitle || '', kicker: slide.kicker || '', text: slide.text || '',
+      bullets: (slide.bullets || []).join('\n'), notes: slide.notes || '' };
+  }
+  function editorHtml(html, nonce) {
+    const bridge = `<style>#hud,#delivery-bar,#review-panel,#progress,#notes-panel,#help-panel,#toast,#blank{display:none!important}.slide-frame{pointer-events:none!important}.slide-frame .slide{pointer-events:auto!important}</style><script>(function(){const nonce=${JSON.stringify(nonce)};
+      function tell(field){parent.postMessage({type:'dsh-ppt-select',nonce:nonce,field:field},'*')}
+      document.addEventListener('keydown',function(e){e.stopImmediatePropagation();if(e.key!=='Tab')e.preventDefault()},true);
+      document.addEventListener('touchstart',function(e){e.stopImmediatePropagation()},true);
+      document.addEventListener('touchend',function(e){e.stopImmediatePropagation()},true);
+      document.addEventListener('wheel',function(e){e.stopImmediatePropagation()},{capture:true,passive:true});
+      document.addEventListener('click',function(e){const n=e.target.closest('h1,h2,.subtitle,.kicker,.statement-title,.quote-text,.quote-attr,li');if(!n)return;
+        e.preventDefault();e.stopImmediatePropagation();let field=n.matches('li')?'bullets':n.matches('.subtitle,.quote-attr')?'subtitle':n.matches('.kicker')?'kicker':'title';tell(field)},true);
+      window.addEventListener('message',function(e){if(e.source!==parent||e.data?.nonce!==nonce||e.data.type!=='dsh-ppt-jump')return;window.__dshPpt?.jump(e.data.page)});
+    })();<\/script>`;
+    const policy = `<meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'unsafe-inline'; script-src 'unsafe-inline'; font-src data:; connect-src 'none'; form-action 'none'">`;
+    // Presenter code contains a quoted </body>; only append at the document end.
+    return html.replace(/<head>/i, '<head>' + policy).replace(/<\/body>(\s*<\/html>\s*)$/i, bridge + '</body>$1');
+  }
+  function Workbench() {
+    const [projects, setProjects] = useState([]), [project, setProject] = useState(null), [selected, setSelected] = useState('');
+    const [draft, setDraft] = useState({}), [image, setImage] = useState(null), [dirty, setDirty] = useState(false);
+    const [busy, setBusy] = useState(false), [job, setJob] = useState(''), [message, setMessage] = useState(''), [error, setError] = useState('');
+    const [mode, setMode] = useState('html'), [raster, setRaster] = useState('');
+    const [conflict, setConflict] = useState(false), [overlaps, setOverlaps] = useState([]);
+    const frame = useRef(null), previewBox = useRef(null), fieldRefs = useRef({}), alive = useRef(true), operations = useRef(new Set());
+    const nonce = useRef(crypto.randomUUID());
+    const previewDocument = useMemo(() => project?.html ? editorHtml(project.html, nonce.current) : '', [project?.html]);
+    const index = project ? Math.max(0, project.slides.findIndex(s => s.id === selected)) : 0;
+    const slide = project?.slides[index];
+    function adopt(next, preferred) {
+      setProject(next);
+      const row = next.slides.find(s => s.id === preferred) || next.slides[0];
+      setSelected(row.id); setDraft(draftFor(row)); setImage(null); setDirty(false); setRaster(''); setOverlaps([]);
+      if (!next.render) setMode('html');
+    }
+    async function perform(work, success, label = '正在处理，请稍候…') {
+      setBusy(true); setJob(label); setError(''); setMessage(''); setConflict(false);
+      const controller = new AbortController(); operations.current.add(controller);
+      try { const result = await work(controller.signal); if (alive.current && success) success(result); }
+      catch (e) { if (alive.current) { setError(e.message || '操作失败'); setConflict(e.status === 409); } }
+      finally { operations.current.delete(controller); if (alive.current) setBusy(false); }
+    }
+    function refreshList() { return perform(signal => action({ operation: 'list' }, signal), value => setProjects(value.projects)); }
+    useEffect(() => {
+      alive.current = true; const abort = new AbortController();
+      action({ operation: 'list' }, abort.signal).then(value => { if (alive.current) setProjects(value.projects) }).catch(e => { if (!abort.signal.aborted) setError(e.message) });
+      return () => { alive.current = false; abort.abort(); for (const operation of operations.current) operation.abort(); };
+    }, []);
+    useEffect(() => {
+      function receive(event) {
+        if (event.source !== frame.current?.contentWindow || event.data?.nonce !== nonce.current || event.data.type !== 'dsh-ppt-select' || mode !== 'html') return;
+        const key = event.data.field;
+        const field = fields.find(([field]) => field === key);
+        if (field) { fieldRefs.current[key]?.focus(); fieldRefs.current[key]?.scrollIntoView({ block: 'nearest' }); setMessage('已定位到' + field[1] + '，在字段中修改后保存。'); }
+      }
+      window.addEventListener('message', receive); return () => window.removeEventListener('message', receive);
+    }, [mode]);
+    useEffect(() => {
+      if (mode !== 'html' || !project || !previewBox.current) return;
+      // Align iframe edges/dimensions when the host uses fractional text metrics.
+      const box = previewBox.current;
+      function align() {
+        const target = frame.current; if (!target) return;
+        const r = box.getBoundingClientRect(), x = r.x + box.clientLeft, y = r.y + box.clientTop;
+        target.style.width = box.clientWidth + 'px'; target.style.height = box.clientHeight + 'px';
+        target.style.transform = 'translate(' + (Math.ceil(x) - x) + 'px,' + (Math.ceil(y) - y) + 'px)';
+      }
+      align(); const observer = new ResizeObserver(align); observer.observe(box);
+      window.addEventListener('scroll', align, true);
+      return () => { observer.disconnect(); window.removeEventListener('scroll', align, true); };
+    }, [mode, !!project]);
+    function jump() { frame.current?.contentWindow?.postMessage({ type: 'dsh-ppt-jump', nonce: nonce.current, page: index }, '*'); }
+    useEffect(() => { jump(); }, [index, project?.revision, mode]);
+    useEffect(() => {
+      if (mode !== 'pptx' || !project?.render) return;
+      const abort = new AbortController(); setRaster('');
+      action({ operation: 'page', id: project.id, page: index + 1 }, abort.signal).then(value => setRaster(value.data)).catch(e => { if (!abort.signal.aborted) setError(e.message) });
+      return () => abort.abort();
+    }, [mode, index, project?.revision]);
+    function open(id) { return perform(signal => action({ operation: 'open', id }, signal), value => { adopt(value.project); setMessage('点击预览里的文字，或在下方修改字段。'); }); }
+    function keepInputsAndReload() {
+      const original = draftFor(slide), keys = fields.filter(([key]) => draft[key] !== original[key]).map(([key]) => key), pending = { ...draft }, pendingImage = image;
+      return perform(signal => action({ operation: 'open', id: project.id }, signal), value => {
+        const row = value.project.slides.find(s => s.id === selected);
+        if (!row) { setError('当前页已被删除，输入仍保留，请复制需要的内容后取消修改。'); return; }
+        const latest = draftFor(row), merged = { ...latest }, shared = [];
+        for (const key of keys) { merged[key] = pending[key]; if (latest[key] !== original[key] && latest[key] !== pending[key]) shared.push({ key, latest: latest[key], yours: pending[key] }); }
+        adopt(value.project, selected); setDraft(merged); setImage(pendingImage); setDirty(keys.length > 0 || !!pendingImage); setOverlaps(shared);
+        setMessage('已载入最新版本并保留你的修改，请核对后再保存。');
+      });
+    }
+    function choose(row) { if (dirty || busy) return; setSelected(row.id); setDraft(draftFor(row)); setImage(null); }
+    function save() {
+      const original = draftFor(slide), patch = {};
+      for (const [key] of fields) if (draft[key] !== original[key]) patch[key] = key === 'bullets' ? draft[key].split('\n').map(v => v.trim()).filter(Boolean) : draft[key];
+      if (image) patch.image = { src: image.src, alt: image.alt, fit: image.fit, caption: image.caption };
+      return perform(signal => action({ operation: 'edit', id: project.id, expectedRevision: project.revision, slide: slide.id, patch }, signal), value => {
+        adopt(value.project, slide.id); setMessage(value.changed === false ? '内容没有变化。' : '已保存，HTML、PPTX 和工程文件已同步更新。');
+      });
+    }
+    function move(delta) {
+      const order = project.slides.map(s => s.id); [order[index], order[index + delta]] = [order[index + delta], order[index]];
+      return perform(signal => action({ operation: 'edit', id: project.id, expectedRevision: project.revision, order }, signal), value => { adopt(value.project, slide.id); setMessage('页面顺序已更新，可撤销。'); });
+    }
+    function undo() { return perform(signal => action({ operation: 'undo', id: project.id, expectedRevision: project.revision }, signal), value => { adopt(value.project, selected); setMessage('已撤销上次修改。'); }); }
+    function render() {
+      return perform(signal => action({ operation: 'render', id: project.id, expectedRevision: project.revision }, signal), value => { adopt(value.project, selected); setMode('pptx'); setMessage('当前 PPTX 已生成逐页图片，请查看画面。'); }, '正在渲染最终 PPTX，较大文件可能需要几分钟…');
+    }
+    function download(kind) {
+      const url = new URL('api/dsh-ppt/download', document.baseURI);
+      url.searchParams.set('id', project.id); url.searchParams.set('kind', kind); url.searchParams.set('revision', String(project.revision));
+      // An authenticated attachment response keeps the click's user gesture and
+      // works in WebViews whose native download handler cannot read blob URLs.
+      const link = document.createElement('a'); link.href = url.href; link.download = '';
+      link.hidden = true; document.body.append(link); link.click(); link.remove();
+      setMessage('已请求下载，请查看浏览器的下载列表。');
+    }
+    function upload(event) {
+      const file = event.target.files?.[0]; event.target.value = ''; if (!file) return;
+      if (!['image/png', 'image/jpeg'].includes(file.type) || file.size > 8 * 1024 * 1024) { setError('请选择 8 MiB 以内的 PNG 或 JPEG 图片。'); return; }
+      const reader = new FileReader();
+      reader.onload = () => { if (!alive.current) return; setImage({ src: String(reader.result), alt: slide.image?.alt || file.name.replace(/\.[^.]+$/, ''), caption: slide.image?.caption || '', fit: slide.image?.fit || 'contain', name: file.name }); setDirty(true); setError(''); };
+      reader.onerror = () => setError('无法读取图片，请重试。'); reader.readAsDataURL(file);
+    }
+    const currentImage = image?.src || (slide?.image?.assetId && project.assets[slide.image.assetId]?.data);
+    return h('div', { className: 'pptw' }, h('style', null, css),
+      h('h2', null, '演示文稿编辑'), h('p', { className: 'muted' }, '修改本插件生成的成品，保存时同步更新 HTML、可编辑 PPTX 和工程文件。'),
+      error && h('div', { role: 'alert', className: 'notice error' }, error),
+      conflict && project && h('button', { disabled: busy, onClick: keepInputsAndReload }, '载入最新版本，保留我的输入'),
+      message && h('div', { role: 'status', className: 'notice' }, message),
+      busy && h('div', { role: 'status', className: 'muted' }, job),
+      !project ? h(React.Fragment, null,
+        h('div', { className: 'tools' }, h('button', { onClick: refreshList, disabled: busy }, '刷新项目')),
+        projects.length ? h('div', { className: 'project-list' }, projects.map(row => h('button', { key: row.id, onClick: () => open(row.id), disabled: busy }, h('strong', null, row.title), h('div', { className: 'file muted' }, row.path)))) :
+          h('div', { className: 'card' }, h('h3', null, '还没有可以编辑的项目'), h('p', null, '先在对话中让助手生成演示文稿。已有项目可以让助手调用 ppt_check 检查一次，它会出现在这里。'), h('p', { className: 'muted' }, '示例：请把这份材料制作成可直接交付的演示文稿，生成 HTML、PPTX 和工程文件。'))
+      ) : h(React.Fragment, null,
+        h('div', { className: 'tools' }, h('button', { disabled: busy || dirty, onClick: () => { setProject(null); refreshList(); } }, '返回项目'), h('strong', null, project.title), h('span', { className: 'muted' }, project.slides.length + ' 页 · 修订 ' + project.revision)),
+        h('div', { className: 'layout' },
+          h('div', null, h('h3', null, '页面'), h('div', { className: 'pages' }, project.slides.map((row, i) => h('button', { key: row.id, 'aria-current': row.id === selected ? 'true' : undefined, disabled: busy || dirty, onClick: () => choose(row) }, (i + 1) + '. ' + (row.title || '未命名页')))),
+            h('div', { className: 'tools' }, h('button', { disabled: busy || dirty || index === 0, onClick: () => move(-1) }, '上移'), h('button', { disabled: busy || dirty || index === project.slides.length - 1, onClick: () => move(1) }, '下移'))),
+          h('div', null,
+            h('div', { className: 'tools' }, h('button', { disabled: busy, 'aria-pressed': mode === 'html', onClick: () => setMode('html') }, 'HTML 预览'),
+              h('button', { disabled: busy || !project.render, 'aria-pressed': mode === 'pptx', onClick: () => setMode('pptx') }, '最终 PPTX 预览'),
+              h('button', { disabled: busy || dirty, onClick: render }, '渲染当前 PPTX')),
+            h('div', { className: 'preview', ref: previewBox }, mode === 'html' ? (project.html ? h('iframe', { ref: frame, title: '演示文稿 HTML 预览', sandbox: 'allow-scripts', srcDoc: previewDocument, onLoad: jump }) : h('p', null, '此项目尚无 HTML，请保存一次生成预览。')) : raster ? h('img', { className: 'render-page', src: raster, alt: '最终 PPTX 第 ' + (index + 1) + ' 页渲染结果' }) : h('p', null, '正在载入当前页渲染…')),
+            h('p', { className: 'muted' }, mode === 'html' ? '这是 HTML 放映预览。最终 PPTX 的字体和排版请用上方渲染检查。点击文字可定位编辑字段。' : '这是当前 PPTX 文件的实际渲染图片，仍需检查每页画面；PowerPoint / WPS 可能因字体环境而不同。'),
+            project.render?.missingFonts?.length ? h('div', { role: 'alert', className: 'notice error' }, '渲染引擎报告缺失字体：' + project.render.missingFonts.join('、') + '。请替换为目标电脑可用字体后重新渲染。') : null,
+            h('div', { className: 'card' }, h('h3', null, '编辑第 ' + (index + 1) + ' 页'),
+              dirty && h('p', { className: 'dirty' }, '有未保存修改，请先保存或取消，再切换页面。'),
+              overlaps.length ? h('div', { className: 'notice' }, h('strong', null, '这些字段也被修改过，请比较后决定是否保存：'), overlaps.map(row => h('div', { key: row.key }, h('strong', null, fields.find(([key]) => key === row.key)[1]), h('p', null, '最新版本：' + row.latest), h('p', null, '你的修改：' + row.yours)))) : null,
+              fields.filter(([key]) => key === 'title' || key === 'notes' || key === 'bullets' && (slide.layout === 'bullets' || slide.bullets?.length > 0) || key !== 'bullets' && (slide[key] || key === 'subtitle' && ['cover','section','closing','quote'].includes(slide.layout) || key === 'kicker' && ['cover','section','closing'].includes(slide.layout))).map(([key, label]) => h('div', { key }, h('label', { htmlFor: 'pptw-' + key }, label), h(key === 'title' || key === 'kicker' ? 'input' : 'textarea', { id: 'pptw-' + key, ref: el => { fieldRefs.current[key] = el }, disabled: busy, value: draft[key] || '', rows: key === 'bullets' ? 4 : 2, maxLength: 8000, onChange: e => { setDraft({ ...draft, [key]: e.target.value }); setDirty(true); } }))),
+              h('label', { htmlFor: 'pptw-image' }, slide.image ? '替换图片（PNG / JPEG）' : '添加图片（会改为图文布局）'),
+              h('input', { id: 'pptw-image', type: 'file', accept: 'image/png,image/jpeg', disabled: busy, onChange: upload }),
+              currentImage && h('img', { className: 'image-preview', src: currentImage, alt: image?.alt || slide.image?.alt || '当前图片' }),
+              image && h(React.Fragment, null, h('p', { className: 'muted' }, '已选择：' + image.name), h('label', { htmlFor: 'pptw-alt' }, '图片说明'), h('input', { id: 'pptw-alt', value: image.alt, disabled: busy, onChange: e => setImage({ ...image, alt: e.target.value }) }), h('label', { htmlFor: 'pptw-fit' }, '图片适应方式'), h('select', { id: 'pptw-fit', value: image.fit, disabled: busy, onChange: e => setImage({ ...image, fit: e.target.value }) }, h('option', { value: 'contain' }, '完整显示'), h('option', { value: 'cover' }, '填满并裁切'))),
+              h('div', { className: 'tools' }, h('button', { className: 'primary', disabled: busy || !dirty, onClick: save }, '保存此页'), h('button', { disabled: busy || !dirty, onClick: () => { setDraft(draftFor(slide)); setImage(null); setDirty(false); setError(''); setConflict(false); setOverlaps([]); } }, '取消修改'), h('button', { disabled: busy || dirty || !project.undoAvailable, onClick: undo }, '撤销上次修改'))),
+            h('details', { className: 'card' }, h('summary', null, '质量提醒（' + project.quality.warningCount + '）'), (project.quality.issues || []).map((issue, i) => h('p', { key: i }, '第 ' + issue.slide + ' 页：' + issue.message + '；' + issue.suggestion))),
+            h('div', { className: 'tools' }, h('button', { disabled: busy || dirty, onClick: () => download('pptx') }, '下载最新 PPTX'), h('button', { disabled: busy || dirty, onClick: () => download('html') }, '下载 HTML'), h('button', { disabled: busy || dirty, onClick: () => download('json') }, '备份工程'))
+          )
+        )
+      )
+    );
+  }
+  function apply(ctx) {
+    ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'dsh-ppt', order: 58, label: () => '演示文稿', inject: () => ({}) }, Workbench));
+  }
+  return { inject: ['slots'], apply, __internals: { draftFor, editorHtml } };
+} });

package/lib/execution.d.ts

@@ -11,6 +11,7 @@ export interface PptExecution {
         };
     };
 }
+export declare function getEngine(): Promise<DeckEngine>;
 /** Build executors with a shared engine loader; resolve paths separately for each call. */
 export declare function createPptExecutors(config: ResolvedPptConfig, loadEngine?: () => Promise<DeckEngine>): {
     themes(rawArgs: unknown, exec?: PptExecution): Promise<PptThemesResult>;

package/lib/execution.js

@@ -1,6 +1,6 @@
 import { resolve } from 'node:path';
 let enginePromise = null;
-function getEngine() {
+export function getEngine() {
     if (enginePromise === null) {
         const engineUrl = new URL('../skills/dsh-ppt/scripts/deck-advanced.mjs', import.meta.url);
         enginePromise = import(engineUrl.href).then((module) => module)

package/lib/index.d.ts

@@ -16,6 +16,7 @@ export interface PptPluginContext {
         warn?(message: string): void;
     };
     on?(event: string, listener: () => void): () => void;
+    inject?(services: string[], callback: (ctx: any) => void): unknown;
 }
 export declare function apply(ctx: PptPluginContext, config?: Config): void;
 export { resolvePptConfig, PPT_OUTPUT_DIR_ENV, DEFAULT_MAX_SLIDES, clampInt } from './config.js';

package/lib/index.js

@@ -18,6 +18,7 @@
 import { resolvePptConfig } from './config.js';
 import { registerPptSkill } from './skill.js';
 import { buildPptTools } from './tools.js';
+import { PptWorkbench, installPptWorkbench } from './workbench.js';
 /** cordis 服务注入：apply 里要使用 ctx.tools 与 ctx.skills。 */
 export const inject = ['tools', 'skills'];
 export const name = 'dsh-ppt';
@@ -25,6 +26,9 @@ export function apply(ctx, config = {}) {
     const resolved = resolvePptConfig(config);
     const warn = (message) => { ctx.logger?.warn?.(message); };
     const disposers = [];
+    const workbench = typeof ctx.inject === 'function' ? new PptWorkbench() : undefined;
+    if (workbench)
+        installPptWorkbench(ctx, workbench);
     // 技能注册：单个技能文件缺失只告警，不弄崩宿主启动。
     try {
         disposers.push(registerPptSkill(ctx));
@@ -33,7 +37,17 @@ export function apply(ctx, config = {}) {
         warn('[dsh-ppt] 技能加载失败：' + (error instanceof Error ? error.message : String(error)));
     }
     for (const definition of buildPptTools(resolved)) {
-        disposers.push(ctx.tools.register(definition));
+        const execute = definition.execute;
+        disposers.push(ctx.tools.register({ ...definition, async execute(args, exec) {
+                const result = await execute(args, exec);
+                try {
+                    await workbench?.remember(result, args, exec);
+                }
+                catch (error) {
+                    warn('[dsh-ppt] 项目索引未更新：' + (error instanceof Error ? error.message : String(error)));
+                }
+                return result;
+            } }));
     }
     if (typeof ctx.on === 'function') {
         ctx.on('dispose', () => {

package/lib/tools.js

@@ -109,10 +109,10 @@ function renderThemes(value) {
 }
 function renderCreate(value) {
     return oneText('dsh-ppt 已生成 ' + value.slideCount + ' 页' + (value.deliveryStatus === 'draft' ? '草稿（还有待填写内容，不能作为成品交付）' : '演示文稿') + '（主题 ' + value.theme + '，语言 ' + value.language + '）：\n' +
-        'HTML 网页放映：' + value.htmlPath + '\n' +
-        'PPTX 导出：' + value.pptxPath + '\n' +
-        'Manifest：' + value.jsonPath + '\n' +
-        'HTML 双击即可放映（← → 翻页 / V 演讲者视图 / S 备注 / G 缩略图总览 / F 全屏 / P 打印 / ? 快捷键）；PPTX 可用 PowerPoint / WPS / Keynote 打开。' +
+        '打开演示文稿：' + value.htmlPath + '\n' +
+        '可直接修改的 PPTX：' + value.pptxPath + '\n' +
+        '可继续编辑的项目：' + value.jsonPath + '\n' +
+        'HTML 双击即可放映；可点击上一页/下一页、输入页码，以及“检查与导出”定位问题或下载 PPTX。PPTX 可用 PowerPoint / WPS / Keynote 直接编辑。' +
         (value.revision !== undefined ? '\n修订号：' + value.revision + '；可撤销修改：' + value.undoAvailable + '。用 ppt_edit 修改指定页，ppt_undo 撤销。' : '') +
         (value.quality ? '\n\n' + qualityText(value.quality) : ''));
 }
@@ -215,6 +215,7 @@ export function buildPptTools(config) {
             description: 'Modify selected slides in an existing dsh-ppt JSON project, preserving other pages and stable IDs. Each edit uses a 1-based slide number or ID and a patch of changed fields. Regenerates the HTML/PPTX/JSON trio atomically, embeds new images, stores undo history. Use ppt_check first and expectedRevision. 中文：按页码或 ID 修改指定页，其他页不变，支持撤销；可同步调整品牌。',
             parameters: compileParameters({ ...projectParameters,
                 edits: { type: 'array', items: { type: 'object', properties: { slide: { type: ['integer', 'string'], description: '1-based page number or stable slide ID' }, patch: { type: 'object', properties: slideProperties, additionalProperties: false } }, required: ['slide', 'patch'], additionalProperties: false } },
+                order: { type: 'array', items: { type: 'string' }, description: 'Reorder pages using every stable slide ID exactly once. May be used alone or together with edits; one undo restores the previous content and order.' },
                 brand: { type: ['object', 'null'], properties: brandProperties, additionalProperties: false, description: 'Merge shared branding. null clears all branding. Empty footer clears footer; logo:null clears logo.' },
             }),
             output: { schema: createResultSchema, render: (_args, value) => renderCreate(value) },
@@ -238,7 +239,7 @@ export function buildPptTools(config) {
         },
         {
             name: 'ppt_render',
-            description: 'Read the final PPTX and render all pages to PNG, PDF, or both using optional official @deepseek-ai/libreoffice-kit@0.1.3. Returns unavailable plus installation guidance when absent; ordinary deck creation remains usable. Retains original editable PPTX and creates a separate unique output folder and integrity receipt. Reports missing fonts. Inspect actual pages before delivery. 中文：把最终 PPTX 渲染为逐页图片和 PDF，报告缺失字体；需安装可选官方引擎，渲染成功仍需检查画面。',
+            description: 'Read the final PPTX and render all pages to PNG, PDF, or both using optional official @deepseek-ai/libreoffice-kit@0.1.5. Returns unavailable plus installation guidance when absent; ordinary deck creation remains usable. Retains original editable PPTX and creates a separate unique output folder and integrity receipt. Reports missing fonts. Inspect actual pages before delivery. 中文：把最终 PPTX 渲染为逐页图片和 PDF，报告缺失字体；需安装可选官方引擎，渲染成功仍需检查画面。',
             parameters: compileParameters({
                 pptxPath: { type: 'string', required: true, description: 'Final .pptx path, absolute or relative to session cwd.' },
                 outputDir: { type: 'string', description: 'Base output folder. Existing folders are preserved; creates a unique sibling when needed. Default <deck>-render.' },

package/lib/types.d.ts

@@ -85,6 +85,7 @@ export interface PptEditArgs {
         slide: number | string;
         patch: Partial<Omit<PptSlideSpec, 'id'>>;
     }>;
+    order?: string[];
     brand?: PptBrand | null;
     expectedRevision?: number;
 }

package/lib/workbench.d.ts

@@ -0,0 +1,32 @@
+import { type PptExecution } from './execution.js';
+import type { DeckEngine } from './types.js';
+export declare const PPT_WORKBENCH_ROUTE = "/api/dsh-ppt/workbench";
+export declare const PPT_DOWNLOAD_ROUTE = "/api/dsh-ppt/download";
+type WorkbenchEngine = DeckEngine & {
+    readDeckProject(options: Record<string, unknown>): {
+        manifest: any;
+        path: string;
+    };
+};
+type Options = {
+    catalogPath?: string;
+    loadEngine?: () => Promise<WorkbenchEngine>;
+};
+export declare class PptWorkbench {
+    readonly catalogPath: string;
+    private readonly loadEngine;
+    private readonly renders;
+    constructor(options?: Options);
+    private catalog;
+    /** Recording a completed tool never turns a successful generation into an error. */
+    remember(result: any, args: unknown, exec?: PptExecution): Promise<void>;
+    private project;
+    private view;
+    private revision;
+    private patch;
+    action(body: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
+    fetchDownload(request: Request): Promise<Response>;
+    fetch(request: Request): Promise<Response>;
+}
+export declare function installPptWorkbench(ctx: any, workbench: PptWorkbench): void;
+export {};

package/lib/workbench.js

@@ -0,0 +1,266 @@
+/** Operator-only workbench. Paths come from successful tools, never browser input. */
+import { createHash } from 'node:crypto';
+import { appendFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, dirname, join, resolve } from 'node:path';
+import { getEngine } from './execution.js';
+export const PPT_WORKBENCH_ROUTE = '/api/dsh-ppt/workbench';
+export const PPT_DOWNLOAD_ROUTE = '/api/dsh-ppt/download';
+const REQUEST_LIMIT = 12 * 1024 * 1024;
+const FILE_LIMIT = 64 * 1024 * 1024;
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+function ordinaryFile(path) {
+    const stat = lstatSync(path);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > FILE_LIMIT)
+        throw new Error('文件不是普通文件或超过 64 MiB');
+    return readFileSync(path);
+}
+function pathsFor(path) { const base = path.slice(0, -5); return { json: path, html: base + '.html', pptx: base + '.pptx' }; }
+function json(status, value) {
+    return new Response(JSON.stringify(value), { status, headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' } });
+}
+function fail(status, message) { return json(status, { ok: false, message }); }
+function originVerdict(request) {
+    const site = request.headers.get('sec-fetch-site'), origin = request.headers.get('origin');
+    if (site && !['same-origin', 'none'].includes(site))
+        return fail(403, '拒绝跨站操作');
+    if (origin && /^https?:/i.test(origin)) {
+        try {
+            if (new URL(origin).host !== (request.headers.get('host') || new URL(request.url).host))
+                return fail(403, '拒绝跨源操作');
+        }
+        catch {
+            return fail(403, '无效来源');
+        }
+    }
+}
+export class PptWorkbench {
+    catalogPath;
+    loadEngine;
+    renders = new Map();
+    constructor(options = {}) {
+        this.catalogPath = options.catalogPath ?? join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'plugins', 'dsh-ppt', 'projects.jsonl');
+        this.loadEngine = options.loadEngine ?? getEngine;
+    }
+    catalog() {
+        if (!existsSync(this.catalogPath))
+            return [];
+        if (lstatSync(this.catalogPath).size > 8 * 1024 * 1024)
+            throw new Error('项目索引超过 8 MiB，请备份后整理 projects.jsonl');
+        const rows = new Map();
+        for (const line of readFileSync(this.catalogPath, 'utf8').split('\n')) {
+            try {
+                const row = JSON.parse(line);
+                if (typeof row.path === 'string' && row.path.endsWith('.json') && row.id === digest(row.path) && typeof row.title === 'string' && typeof row.updatedAt === 'string') {
+                    rows.delete(row.id);
+                    rows.set(row.id, row);
+                }
+            }
+            catch { /* A crash may leave an incomplete last append; keep older rows. */ }
+        }
+        return [...rows.values()].reverse().slice(0, 100);
+    }
+    /** Recording a completed tool never turns a successful generation into an error. */
+    async remember(result, args, exec) {
+        const file = result?.jsonPath ?? result?.deckPath;
+        if (typeof file !== 'string')
+            return;
+        exec?.signal?.throwIfAborted();
+        const path = realpathSync(resolve(exec?.agent?.session.header.cwd ?? process.cwd(), file));
+        ordinaryFile(path);
+        const engine = await this.loadEngine();
+        const { manifest } = engine.readDeckProject({ deckPath: path });
+        // Versioned generator projects only; arbitrary JSON and externally edited PPTX cannot enter.
+        if (manifest.schemaVersion !== 1 || typeof manifest.deckId !== 'string' || manifest.slides.some((s) => typeof s.id !== 'string'))
+            return;
+        const row = { id: digest(path), path, title: manifest.title, updatedAt: new Date().toISOString() };
+        mkdirSync(dirname(this.catalogPath), { recursive: true });
+        if (existsSync(this.catalogPath) && lstatSync(this.catalogPath).size >= 8 * 1024 * 1024)
+            throw new Error('项目索引已满，请备份后整理 projects.jsonl');
+        appendFileSync(this.catalogPath, JSON.stringify(row) + '\n');
+    }
+    async project(id) {
+        if (typeof id !== 'string' || !/^[0-9a-f]{64}$/.test(id))
+            throw new Error('请选择已有项目');
+        const entry = this.catalog().find(row => row.id === id);
+        if (!entry)
+            throw new Error('项目不在本机索引中，请先在对话中创建或检查演示文稿');
+        if (realpathSync(entry.path) !== entry.path)
+            throw new Error('项目位置已改变，请在对话中重新检查');
+        ordinaryFile(entry.path);
+        const engine = await this.loadEngine();
+        const { manifest } = engine.readDeckProject({ deckPath: entry.path });
+        return { entry, engine, manifest, files: pathsFor(entry.path) };
+    }
+    async view(id) {
+        const { entry, engine, manifest, files } = await this.project(id);
+        const check = engine.checkDeck({ deckPath: entry.path });
+        let html = '';
+        try {
+            html = ordinaryFile(files.html).toString('utf8');
+        }
+        catch { /* A check can register an older JSON-only project. */ }
+        const render = this.renders.get(entry.id);
+        const currentRender = render && render.revision === manifest.revision && digest(ordinaryFile(files.pptx)) === render.sourceSha256 ? render : undefined;
+        return { ok: true, project: { ...entry, deckId: manifest.deckId, revision: manifest.revision, slides: manifest.slides,
+                undoAvailable: manifest.history.length, quality: check, html,
+                assets: Object.fromEntries(Object.entries(manifest.assets ?? {}).map(([key, value]) => [key, { data: value.data, mime: value.mime }])),
+                render: currentRender ? { pageCount: currentRender.pngPaths.length, missingFonts: currentRender.missingFonts ?? [] } : null } };
+    }
+    revision(body, manifest) {
+        if (!Number.isSafeInteger(body.expectedRevision) || body.expectedRevision !== manifest.revision)
+            throw new Error('项目已被修改，请重新打开后再编辑；当前输入保留');
+    }
+    patch(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new Error('修改内容无效');
+        const result = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (['title', 'subtitle', 'kicker', 'text', 'notes'].includes(key)) {
+                if (typeof item !== 'string' || item.length > 8000)
+                    throw new Error('文字字段过长或无效');
+            }
+            else if (key === 'bullets') {
+                if (!Array.isArray(item) || item.length > 50 || item.some(v => typeof v !== 'string' || v.length > 2000))
+                    throw new Error('要点内容无效');
+            }
+            else if (key === 'image') {
+                if (!item || typeof item !== 'object' || Array.isArray(item))
+                    throw new Error('请选择 PNG 或 JPEG 图片');
+                const image = item;
+                if (Object.keys(image).some(k => !['src', 'alt', 'fit', 'caption'].includes(k)) || typeof image.src !== 'string' || !/^data:image\/(png|jpeg);base64,[A-Za-z0-9+/=]+$/.test(image.src))
+                    throw new Error('图片必须从面板上传，不能读取其他本地文件');
+                if (['alt', 'caption'].some(k => image[k] !== undefined && (typeof image[k] !== 'string' || image[k].length > 2000)) || (image.fit !== undefined && !['contain', 'cover'].includes(String(image.fit))))
+                    throw new Error('图片说明或适应方式无效');
+            }
+            else
+                throw new Error('面板不支持修改此字段：' + key);
+            result[key] = item;
+        }
+        return result;
+    }
+    async action(body, signal) {
+        signal?.throwIfAborted();
+        if (body.operation === 'list')
+            return { ok: true, projects: this.catalog() };
+        if (body.operation === 'open')
+            return this.view(body.id);
+        const { entry, engine, manifest, files } = await this.project(body.id);
+        signal?.throwIfAborted();
+        if (body.operation === 'download') {
+            if (!['html', 'pptx', 'json'].includes(String(body.kind)))
+                throw new Error('不支持此文件类型');
+            const path = files[body.kind];
+            return { ok: true, name: basename(path), data: ordinaryFile(path).toString('base64') };
+        }
+        if (body.operation === 'page') {
+            const render = this.renders.get(entry.id);
+            if (!render || render.revision !== manifest.revision || digest(ordinaryFile(files.pptx)) !== render.sourceSha256)
+                throw new Error('请先渲染当前版本的 PPTX');
+            if (!Number.isSafeInteger(body.page) || Number(body.page) < 1 || Number(body.page) > render.pngPaths.length)
+                throw new Error('页码无效');
+            const bytes = ordinaryFile(render.pngPaths[Number(body.page) - 1]);
+            if (digest(bytes) !== render.pngHashes[Number(body.page) - 1])
+                throw new Error('渲染图片已变化，请重新渲染当前 PPTX');
+            return { ok: true, data: 'data:image/png;base64,' + bytes.toString('base64') };
+        }
+        this.revision(body, manifest);
+        if (body.operation === 'render') {
+            const result = await engine.renderDeck({ pptxPath: files.pptx, format: 'png', signal });
+            if (result.ok)
+                this.renders.set(entry.id, { revision: manifest.revision, pngPaths: result.pngPaths ?? [], pngHashes: (result.pngPaths ?? []).map(path => digest(ordinaryFile(path))), missingFonts: result.missingFonts, sourceSha256: result.sourceSha256 });
+            const view = await this.view(entry.id);
+            if (result.ok && !view.project.render)
+                throw new Error('项目已被修改，请重新渲染');
+            return { ...result, project: view.project };
+        }
+        if (body.operation === 'edit') {
+            if (body.slide !== undefined && (typeof body.slide !== 'string' || !manifest.slides.some((s) => s.id === body.slide)))
+                throw new Error('页面不存在');
+            const args = { deckPath: entry.path, expectedRevision: body.expectedRevision, signal,
+                ...(body.slide === undefined ? {} : { edits: [{ slide: body.slide, patch: this.patch(body.patch) }] }),
+                ...(body.order === undefined ? {} : { order: body.order }) };
+            const result = await engine.editDeck(args);
+            await this.remember(result, args);
+            return { ...await this.view(entry.id), changed: result.changed };
+        }
+        if (body.operation === 'undo') {
+            await engine.undoDeck({ deckPath: entry.path, expectedRevision: body.expectedRevision, signal });
+            return this.view(entry.id);
+        }
+        throw new Error('不支持此操作');
+    }
+    async fetchDownload(request) {
+        if (request.method !== 'GET')
+            return fail(405, '请使用 GET');
+        const denied = originVerdict(request);
+        if (denied)
+            return denied;
+        try {
+            const params = new URL(request.url).searchParams, kind = params.get('kind');
+            if (!['html', 'pptx', 'json'].includes(String(kind)))
+                return fail(400, '不支持此文件类型');
+            const { entry, manifest, files } = await this.project(params.get('id'));
+            if (String(manifest.revision) !== params.get('revision'))
+                return fail(409, '项目已被修改，请重新打开后下载');
+            request.signal.throwIfAborted();
+            const path = files[kind], bytes = ordinaryFile(path);
+            if ((await this.project(entry.id)).manifest.revision !== manifest.revision)
+                return fail(409, '项目已被修改，请重新打开后下载');
+            const type = kind === 'pptx' ? 'application/vnd.openxmlformats-officedocument.presentationml.presentation' : kind === 'html' ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8';
+            return new Response(new Uint8Array(bytes), { headers: {
+                    'content-type': type, 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
+                    'content-disposition': `attachment; filename="presentation.${kind}"; filename*=UTF-8''${encodeURIComponent(basename(path))}`,
+                } });
+        }
+        catch (error) {
+            return fail(400, error instanceof Error ? error.message : String(error));
+        }
+    }
+    async fetch(request) {
+        if (request.method !== 'POST')
+            return fail(405, '请使用 POST');
+        if (request.headers.get('x-dsh-ppt-action') !== '1' || request.headers.get('content-type')?.split(';')[0].trim().toLowerCase() !== 'application/json')
+            return fail(403, '请从演示文稿面板操作');
+        const denied = originVerdict(request);
+        if (denied)
+            return denied;
+        try {
+            const reader = request.body?.getReader();
+            if (!reader)
+                return fail(400, '缺少请求内容');
+            let size = 0;
+            const chunks = [];
+            try {
+                for (;;) {
+                    const { value, done } = await reader.read();
+                    if (done)
+                        break;
+                    size += value.byteLength;
+                    if (size > REQUEST_LIMIT) {
+                        await reader.cancel();
+                        return fail(413, '图片或请求超过 12 MiB，请压缩后重试');
+                    }
+                    chunks.push(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+            const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            if (!body || typeof body !== 'object' || Array.isArray(body))
+                return fail(400, '请求必须是对象');
+            return json(200, await this.action(body, request.signal));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return fail(/修订号冲突|已被修改|正在被另一次|其他操作修改/.test(message) ? 409 : 400, message);
+        }
+    }
+}
+export function installPptWorkbench(ctx, workbench) {
+    ctx.inject?.(['connection'], (host) => {
+        host.connection?.fetch?.register({ path: PPT_WORKBENCH_ROUTE, methods: ['POST'], requestBody: 'buffered', fetch: (request) => workbench.fetch(request) });
+        host.connection?.fetch?.register({ path: PPT_DOWNLOAD_ROUTE, methods: ['GET'], requestBody: 'buffered', fetch: (request) => workbench.fetchDownload(request) });
+    });
+}