dsh-ppt 0.8.0 → 0.8.1

package/lib/client.js

@@ -3,6 +3,99 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
   const React = require('react');
   const { useState, useEffect, useRef, useMemo } = React;
   const h = React.createElement;
+
+// Interface language follows DSH; user content and stored records keep their original text.
+let localeService;
+const EN = Object.freeze({
+  "标题": "Title",
+  "副标题": "Subtitle",
+  "眉题": "Kicker",
+  "正文": "Body text",
+  "要点（每行一条）": "Bullets (one per line)",
+  "演讲备注": "Speaker notes",
+  "无法读取服务响应，请检查插件是否加载": "Could not read the server response. Check that the plugin is loaded.",
+  "操作未完成": "The operation did not complete.",
+  "正在处理，请稍候…": "Working, please wait…",
+  "操作失败": "Operation failed.",
+  "已定位到": "Focused ",
+  "，在字段中修改后保存。": ". Edit this field, then save.",
+  "点击预览里的文字，或在下方修改字段。": "Click text in the preview, or edit the fields below.",
+  "当前页已被删除，输入仍保留，请复制需要的内容后取消修改。": "This slide was deleted. Your input is preserved; copy anything you need before cancelling your edits.",
+  "已载入最新版本并保留你的修改，请核对后再保存。": "Latest version loaded with your edits preserved. Review before saving.",
+  "内容没有变化。": "No changes to save.",
+  "已保存，HTML、PPTX 和工程文件已同步更新。": "Saved. HTML, PPTX and project files were updated together.",
+  "页面顺序已更新，可撤销。": "Slides reordered. You can undo this change.",
+  "已撤销上次修改。": "Last change undone.",
+  "当前 PPTX 已生成逐页图片，请查看画面。": "Slide images were rendered from the current PPTX. Review each slide.",
+  "正在渲染最终 PPTX，较大文件可能需要几分钟…": "Rendering the final PPTX. Large files may take a few minutes…",
+  "已请求下载，请查看浏览器的下载列表。": "Download requested. Check your browser’s downloads.",
+  "请选择 8 MiB 以内的 PNG 或 JPEG 图片。": "Choose a PNG or JPEG image up to 8 MiB.",
+  "无法读取图片，请重试。": "Could not read the image. Try again.",
+  "演示文稿编辑": "Presentation editor",
+  "修改本插件生成的成品，保存时同步更新 HTML、可编辑 PPTX 和工程文件。": "Edit presentations generated by this plugin. Saving updates the HTML, editable PPTX and project file together.",
+  "载入最新版本，保留我的输入": "Load latest and keep my input",
+  "刷新项目": "Refresh projects",
+  "还没有可以编辑的项目": "No editable projects yet",
+  "先在对话中让助手生成演示文稿。已有项目可以让助手调用 ppt_check 检查一次，它会出现在这里。": "Ask the assistant to generate a presentation in chat. For an existing project, ask it to run ppt_check; the project will appear here.",
+  "示例：请把这份材料制作成可直接交付的演示文稿，生成 HTML、PPTX 和工程文件。": "Example: Turn this material into a presentation ready to deliver, including HTML, PPTX and project files.",
+  "返回项目": "Back to projects",
+  " 页 · 修订 ": " slides · Revision ",
+  "页面": "Slides",
+  "未命名页": "Untitled slide",
+  "上移": "Move up",
+  "下移": "Move down",
+  "HTML 预览": "HTML preview",
+  "最终 PPTX 预览": "Final PPTX preview",
+  "渲染当前 PPTX": "Render current PPTX",
+  "演示文稿 HTML 预览": "Presentation HTML preview",
+  "此项目尚无 HTML，请保存一次生成预览。": "This project has no HTML yet. Save to generate a preview.",
+  "最终 PPTX 第 ": "Final PPTX slide ",
+  " 页渲染结果": " rendered image",
+  "正在载入当前页渲染…": "Loading the rendered slide…",
+  "这是 HTML 放映预览。最终 PPTX 的字体和排版请用上方渲染检查。点击文字可定位编辑字段。": "This is the HTML playback preview. Use the render controls above to check fonts and layout in the final PPTX. Click text to focus its editing field.",
+  "这是当前 PPTX 文件的实际渲染图片，仍需检查每页画面；PowerPoint / WPS 可能因字体环境而不同。": "This image is rendered from the current PPTX. Review every slide; PowerPoint / WPS may display it differently depending on installed fonts.",
+  "渲染引擎报告缺失字体：": "The renderer reported missing fonts: ",
+  "。请替换为目标电脑可用字体后重新渲染。": ". Choose fonts available on the target computer and render again.",
+  "编辑第 ": "Edit slide ",
+  " 页": "",
+  "有未保存修改，请先保存或取消，再切换页面。": "You have unsaved edits. Save or cancel before switching slides.",
+  "这些字段也被修改过，请比较后决定是否保存：": "These fields were changed elsewhere. Compare them before saving:",
+  "最新版本：": "Latest version: ",
+  "你的修改：": "Your edits: ",
+  "替换图片（PNG / JPEG）": "Replace image (PNG / JPEG)",
+  "添加图片（会改为图文布局）": "Add image (changes to an image-and-text layout)",
+  "当前图片": "Current image",
+  "已选择：": "Selected: ",
+  "图片说明": "Image description",
+  "图片适应方式": "Image fit",
+  "完整显示": "Show complete image",
+  "填满并裁切": "Fill and crop",
+  "保存此页": "Save slide",
+  "取消修改": "Cancel edits",
+  "撤销上次修改": "Undo last change",
+  "质量提醒（": "Quality findings (",
+  "第 ": "Slide ",
+  " 页：": ": ",
+  "下载最新 PPTX": "Download latest PPTX",
+  "下载 HTML": "Download HTML",
+  "备份工程": "Back up project",
+  "演示文稿": "Presentations"
+});
+function languageOf(locale = localeService) {
+  try { return String(locale?.getSnapshot?.().active || '').startsWith('en') ? 'en' : 'zh'; } catch { return 'zh'; }
+}
+function t(zh) { return languageOf() === 'en' ? (EN[zh] ?? zh) : zh; }
+function englishError(message, status) {
+  if (status === 401) return 'Your session has expired. Reopen DSH and try again.';
+  if (status === 404) return 'The presentation workbench is unavailable. Check that the plugin is loaded and restart DSH.';
+  if (status === 409) return 'The project changed. Load the latest version and review your edits before saving.';
+  return /[\u3400-\u9fff]/.test(message || '') ? 'The operation failed. Check the project files and DSH logs, then retry.' : message;
+}
+function useLanguage(locale) {
+  const [, rerender] = useState(0);
+  useEffect(() => { const update = () => rerender(n => n + 1); update(); return locale?.subscribe?.(update); }, [locale]);
+}
+
   const ROUTE = 'api/dsh-ppt/workbench';
   const fields = [['title', '标题'], ['subtitle', '副标题'], ['kicker', '眉题'], ['text', '正文'], ['bullets', '要点（每行一条）'], ['notes', '演讲备注']];
   const css = `
@@ -34,8 +127,8 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
     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; }
+    try { value = await response.json(); } catch { throw new Error(t("无法读取服务响应，请检查插件是否加载")) }
+    if (!response.ok || value.ok === false) { const localized = languageOf() === 'en' ? value.messageEn || englishError(value.message, response.status) : value.message; const hint = languageOf() === 'en' ? value.installationHintEn : value.installationHint; const error = new Error((localized || t("操作未完成")) + (hint ? '\n' + hint : '')); error.status = response.status; throw error; }
     return value;
   }
   function draftFor(slide) {
@@ -57,7 +150,8 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
     // 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() {
+  function Workbench({ locale } = {}) {
+    useLanguage(locale);
     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('');
@@ -74,11 +168,11 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
       setSelected(row.id); setDraft(draftFor(row)); setImage(null); setDirty(false); setRaster(''); setOverlaps([]);
       if (!next.render) setMode('html');
     }
-    async function perform(work, success, label = '正在处理，请稍候…') {
+    async function perform(work, success, label = t("正在处理，请稍候…")) {
       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); } }
+      catch (e) { if (alive.current) { setError(e.message || t("操作失败")); 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)); }
@@ -92,7 +186,7 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
         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] + '，在字段中修改后保存。'); }
+        if (field) { fieldRefs.current[key]?.focus(); fieldRefs.current[key]?.scrollIntoView({ block: 'nearest' }); setMessage(t("已定位到") + t(field[1]) + t("，在字段中修改后保存。")); }
       }
       window.addEventListener('message', receive); return () => window.removeEventListener('message', receive);
     }, [mode]);
@@ -118,16 +212,16 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
       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 open(id) { return perform(signal => action({ operation: 'open', id }, signal), value => { adopt(value.project); setMessage(t("点击预览里的文字，或在下方修改字段。")); }); }
     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; }
+        if (!row) { setError(t("当前页已被删除，输入仍保留，请复制需要的内容后取消修改。")); 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('已载入最新版本并保留你的修改，请核对后再保存。');
+        setMessage(t("已载入最新版本并保留你的修改，请核对后再保存。"));
       });
     }
     function choose(row) { if (dirty || busy) return; setSelected(row.id); setDraft(draftFor(row)); setImage(null); }
@@ -136,16 +230,16 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
       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 和工程文件已同步更新。');
+        adopt(value.project, slide.id); setMessage(value.changed === false ? t("内容没有变化。") : t("已保存，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('页面顺序已更新，可撤销。'); });
+      return perform(signal => action({ operation: 'edit', id: project.id, expectedRevision: project.revision, order }, signal), value => { adopt(value.project, slide.id); setMessage(t("页面顺序已更新，可撤销。")); });
     }
-    function undo() { return perform(signal => action({ operation: 'undo', id: project.id, expectedRevision: project.revision }, signal), value => { adopt(value.project, selected); setMessage('已撤销上次修改。'); }); }
+    function undo() { return perform(signal => action({ operation: 'undo', id: project.id, expectedRevision: project.revision }, signal), value => { adopt(value.project, selected); setMessage(t("已撤销上次修改。")); }); }
     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，较大文件可能需要几分钟…');
+      return perform(signal => action({ operation: 'render', id: project.id, expectedRevision: project.revision }, signal), value => { adopt(value.project, selected); setMode('pptx'); setMessage(t("当前 PPTX 已生成逐页图片，请查看画面。")); }, t("正在渲染最终 PPTX，较大文件可能需要几分钟…"));
     }
     function download(kind) {
       const url = new URL('api/dsh-ppt/download', document.baseURI);
@@ -154,56 +248,57 @@ window.__ModuleLoader__.load({ id: 'dsh-ppt', factory: require => {
       // 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('已请求下载，请查看浏览器的下载列表。');
+      setMessage(t("已请求下载，请查看浏览器的下载列表。"));
     }
     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; }
+      if (!['image/png', 'image/jpeg'].includes(file.type) || file.size > 8 * 1024 * 1024) { setError(t("请选择 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);
+      reader.onerror = () => setError(t("无法读取图片，请重试。")); 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 和工程文件。'),
+      h('h2', null, t("演示文稿编辑")), h('p', { className: 'muted' }, t("修改本插件生成的成品，保存时同步更新 HTML、可编辑 PPTX 和工程文件。")),
       error && h('div', { role: 'alert', className: 'notice error' }, error),
-      conflict && project && h('button', { disabled: busy, onClick: keepInputsAndReload }, '载入最新版本，保留我的输入'),
+      conflict && project && h('button', { disabled: busy, onClick: keepInputsAndReload }, t("载入最新版本，保留我的输入")),
       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 }, '刷新项目')),
+        h('div', { className: 'tools' }, h('button', { onClick: refreshList, disabled: busy }, t("刷新项目"))),
         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('div', { className: 'card' }, h('h3', null, t("还没有可以编辑的项目")), h('p', null, t("先在对话中让助手生成演示文稿。已有项目可以让助手调用 ppt_check 检查一次，它会出现在这里。")), h('p', { className: 'muted' }, t("示例：请把这份材料制作成可直接交付的演示文稿，生成 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: 'tools' }, h('button', { disabled: busy || dirty, onClick: () => { setProject(null); refreshList(); } }, t("返回项目")), h('strong', null, project.title), h('span', { className: 'muted' }, project.slides.length + t(" 页 · 修订 ") + 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('h3', null, t("页面")), 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 || t("未命名页"))))),
+            h('div', { className: 'tools' }, h('button', { disabled: busy || dirty || index === 0, onClick: () => move(-1) }, t("上移")), h('button', { disabled: busy || dirty || index === project.slides.length - 1, onClick: () => move(1) }, t("下移")))),
           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('div', { className: 'tools' }, h('button', { disabled: busy, 'aria-pressed': mode === 'html', onClick: () => setMode('html') }, t("HTML 预览")),
+              h('button', { disabled: busy || !project.render, 'aria-pressed': mode === 'pptx', onClick: () => setMode('pptx') }, t("最终 PPTX 预览")),
+              h('button', { disabled: busy || dirty, onClick: render }, t("渲染当前 PPTX"))),
+            h('div', { className: 'preview', ref: previewBox }, mode === 'html' ? (project.html ? h('iframe', { ref: frame, title: t("演示文稿 HTML 预览"), sandbox: 'allow-scripts', srcDoc: previewDocument, onLoad: jump }) : h('p', null, t("此项目尚无 HTML，请保存一次生成预览。"))) : raster ? h('img', { className: 'render-page', src: raster, alt: t("最终 PPTX 第 ") + (index + 1) + t(" 页渲染结果") }) : h('p', null, t("正在载入当前页渲染…"))),
+            h('p', { className: 'muted' }, mode === 'html' ? t("这是 HTML 放映预览。最终 PPTX 的字体和排版请用上方渲染检查。点击文字可定位编辑字段。") : t("这是当前 PPTX 文件的实际渲染图片，仍需检查每页画面；PowerPoint / WPS 可能因字体环境而不同。")),
+            project.render?.missingFonts?.length ? h('div', { role: 'alert', className: 'notice error' }, t("渲染引擎报告缺失字体：") + project.render.missingFonts.join('、') + t("。请替换为目标电脑可用字体后重新渲染。")) : null,
+            h('div', { className: 'card' }, h('h3', null, t("编辑第 ") + (index + 1) + t(" 页")),
+              dirty && h('p', { className: 'dirty' }, t("有未保存修改，请先保存或取消，再切换页面。")),
+              overlaps.length ? h('div', { className: 'notice' }, h('strong', null, t("这些字段也被修改过，请比较后决定是否保存：")), overlaps.map(row => h('div', { key: row.key }, h('strong', null, t(fields.find(([key]) => key === row.key)[1])), h('p', null, t("最新版本：") + row.latest), h('p', null, t("你的修改：") + 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 }, t(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 ? t("替换图片（PNG / JPEG）") : t("添加图片（会改为图文布局）")),
               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') }, '备份工程'))
+              currentImage && h('img', { className: 'image-preview', src: currentImage, alt: image?.alt || slide.image?.alt || t("当前图片") }),
+              image && h(React.Fragment, null, h('p', { className: 'muted' }, t("已选择：") + image.name), h('label', { htmlFor: 'pptw-alt' }, t("图片说明")), h('input', { id: 'pptw-alt', value: image.alt, disabled: busy, onChange: e => setImage({ ...image, alt: e.target.value }) }), h('label', { htmlFor: 'pptw-fit' }, t("图片适应方式")), h('select', { id: 'pptw-fit', value: image.fit, disabled: busy, onChange: e => setImage({ ...image, fit: e.target.value }) }, h('option', { value: 'contain' }, t("完整显示")), h('option', { value: 'cover' }, t("填满并裁切")))),
+              h('div', { className: 'tools' }, h('button', { className: 'primary', disabled: busy || !dirty, onClick: save }, t("保存此页")), h('button', { disabled: busy || !dirty, onClick: () => { setDraft(draftFor(slide)); setImage(null); setDirty(false); setError(''); setConflict(false); setOverlaps([]); } }, t("取消修改")), h('button', { disabled: busy || dirty || !project.undoAvailable, onClick: undo }, t("撤销上次修改")))),
+            h('details', { className: 'card' }, h('summary', null, t("质量提醒（") + project.quality.warningCount + (languageOf() === 'en' ? ')' : '）')), (project.quality.issues || []).map((issue, i) => h('p', { key: i }, t("第 ") + issue.slide + t(" 页：") + (languageOf() === 'en' ? issue.messageEn : issue.message) + (languageOf() === 'en' ? ' ' : '；') + (languageOf() === 'en' ? issue.suggestionEn : issue.suggestion)))),
+            h('div', { className: 'tools' }, h('button', { disabled: busy || dirty, onClick: () => download('pptx') }, t("下载最新 PPTX")), h('button', { disabled: busy || dirty, onClick: () => download('html') }, t("下载 HTML")), h('button', { disabled: busy || dirty, onClick: () => download('json') }, t("备份工程")))
           )
         )
       )
     );
   }
   function apply(ctx) {
-    ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'dsh-ppt', order: 58, label: () => '演示文稿', inject: () => ({}) }, Workbench));
+    try { localeService = ctx.get?.('locale') || ctx.locale; } catch { localeService = ctx.locale; }
+    ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'dsh-ppt', order: 58, label: () => t("演示文稿"), inject: () => ({ locale: localeService }) }, Workbench));
   }
-  return { inject: ['slots'], apply, __internals: { draftFor, editorHtml } };
+  return { inject: ['slots', 'locale'], apply, __internals: { draftFor, editorHtml } };
 } });

package/lib/workbench-language.d.ts

@@ -0,0 +1,4 @@
+export declare function englishWorkbenchMessage(message: string): string;
+export declare function bilingualQuality<T extends {
+    issues?: any[];
+}>(report: T): T;

package/lib/workbench-language.js

@@ -0,0 +1,65 @@
+/** UI messages are independent of the deck's language; slide content is never translated. */
+const messages = {
+    '文件不是普通文件或超过 64 MiB': 'The file is not a regular file or exceeds 64 MiB.',
+    '项目索引超过 8 MiB，请备份后整理 projects.jsonl': 'The project index exceeds 8 MiB. Back it up before reviewing projects.jsonl.',
+    '项目索引已满，请备份后整理 projects.jsonl': 'The project index is full. Back it up before reviewing projects.jsonl.',
+    '请选择已有项目': 'Select an existing project.',
+    '项目不在本机索引中，请先在对话中创建或检查演示文稿': 'This project is not in the local index. Create it or run ppt_check in chat first.',
+    '项目位置已改变，请在对话中重新检查': 'The project location changed. Run ppt_check in chat again.',
+    '项目已被修改，请重新打开后再编辑；当前输入保留': 'The project changed. Load the latest version before editing; your input is preserved.',
+    '项目已被修改，请重新打开后下载': 'The project changed. Open the latest version before downloading.',
+    '修改内容无效': 'The edits are invalid.', '文字字段过长或无效': 'A text field is invalid or exceeds 8,000 characters.',
+    '要点内容无效': 'Bullets must contain up to 50 lines, each no longer than 2,000 characters.',
+    '请选择 PNG 或 JPEG 图片': 'Choose a PNG or JPEG image.',
+    '图片必须从面板上传，不能读取其他本地文件': 'Upload the image from this panel. Other local file paths cannot be read.',
+    '图片说明或适应方式无效': 'The image description or fit setting is invalid.',
+    '不支持此文件类型': 'This file type is unsupported.', '请先渲染当前版本的 PPTX': 'Render the current PPTX version first.',
+    '页码无效': 'The slide number is invalid.', '渲染图片已变化，请重新渲染当前 PPTX': 'The rendered image changed. Render the current PPTX again.',
+    '项目已被修改，请重新渲染': 'The project changed. Render it again.', '页面不存在': 'This slide no longer exists.',
+    '不支持此操作': 'This operation is unsupported.', '请使用 GET': 'Use GET.', '请使用 POST': 'Use POST.',
+    '拒绝跨站操作': 'Cross-site operations are refused.', '拒绝跨源操作': 'Cross-origin operations are refused.', '无效来源': 'Invalid request origin.',
+    '请从演示文稿面板操作': 'Perform this operation from the presentation panel.', '缺少请求内容': 'The request body is missing.',
+    '图片或请求超过 12 MiB，请压缩后重试': 'The image or request exceeds 12 MiB. Reduce its size and try again.', '请求必须是对象': 'The request must be an object.',
+};
+export function englishWorkbenchMessage(message) {
+    if (messages[message])
+        return messages[message];
+    if (/修订号冲突|已被修改|正在被另一次|其他操作修改/.test(message))
+        return 'The project changed or is busy. Load the latest version and review your edits before retrying.';
+    if (/渲染引擎不可用/.test(message))
+        return 'The optional PPTX renderer is unavailable. Install the supported LibreOffice Kit version and restart DSH.';
+    if (/渲染超过|超时/.test(message))
+        return 'PPTX rendering timed out. Try a smaller presentation and check the renderer logs.';
+    if (/面板不支持修改此字段/.test(message))
+        return 'This field cannot be edited from the panel.';
+    if (/没有可撤销|无法撤销|历史记录为空/.test(message))
+        return 'No change is available to undo.';
+    if (/没有.*图片|超过.*MiB|图片.*无效/.test(message))
+        return 'The image is invalid or too large. Choose another PNG or JPEG image.';
+    return /[\u3400-\u9fff]/.test(message) ? 'The operation failed. Check the project files and DSH logs, then try again.' : message;
+}
+const quality = {
+    'missing-title': ['This slide has no title.', 'Add a title that explains the slide.'],
+    'title-overflow': ['The title may wrap too much or exceed its area.', 'Shorten the title and move explanations into the body.'],
+    'dense-bullets': ['This slide has too many bullets for comfortable reading.', 'Reduce the bullets or split them across slides.'],
+    'body-overflow': ['The body may exceed the available height.', 'Shorten or split the text before reducing font size.'],
+    'template-unfilled': ['Template placeholders remain.', 'Fill in actual facts, evidence and actions, then check again.'],
+    'small-font': ['This table uses a small font and may be hard to read.', 'Reduce the columns or use a chart; check readability after export.'],
+    'table-density': ['Long table cells may cause crowded wrapping.', 'Shorten the cells or reduce the columns.'],
+    'missing-image': ['The embedded image is missing.', 'Edit the slide with a new image.'],
+    'invalid-image': ['The embedded image is invalid.', 'Replace it with a valid local image.'],
+    'low-resolution': ['The image may look blurry when enlarged.', 'Use a higher-resolution image. Small logos may be acceptable.'],
+    'missing-alt': ['The image has no description.', 'Fill in image.alt for accessibility and context.'],
+    'invalid-chart': ['The chart data is invalid.', 'Check the categories, series and numeric values.'],
+    'chart-density': ['Chart categories or labels may overlap.', 'Reduce categories or use a horizontal bar chart.'],
+    'chart-legend': ['Chart legend labels are long.', 'Shorten series names and check the render.'],
+    'low-contrast': ['Body text and background contrast is below 4.5:1.', 'Adjust the brand background or text colour.'],
+    'missing-logo': ['The brand logo asset is missing.', 'Provide the logo again.'],
+    'invalid-logo': ['The brand logo asset is invalid.', 'Replace the logo with a valid image.'],
+};
+export function bilingualQuality(report) {
+    return { ...report, issues: report.issues?.map(issue => {
+            const entry = quality[issue.code];
+            return { ...issue, messageEn: entry?.[0] ?? englishWorkbenchMessage(issue.message || ''), suggestionEn: entry?.[1] ?? englishWorkbenchMessage(issue.suggestion || '') };
+        }) };
+}

package/lib/workbench.js

@@ -4,6 +4,7 @@ import { appendFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpat
 import { homedir } from 'node:os';
 import { basename, dirname, join, resolve } from 'node:path';
 import { getEngine } from './execution.js';
+import { bilingualQuality, englishWorkbenchMessage } from './workbench-language.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;
@@ -19,7 +20,7 @@ function pathsFor(path) { const base = path.slice(0, -5); return { json: path, h
 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 fail(status, message) { return json(status, { ok: false, message, messageEn: englishWorkbenchMessage(message) }); }
 function originVerdict(request) {
     const site = request.headers.get('sec-fetch-site'), origin = request.headers.get('origin');
     if (site && !['same-origin', 'none'].includes(site))
@@ -94,7 +95,7 @@ export class PptWorkbench {
     }
     async view(id) {
         const { entry, engine, manifest, files } = await this.project(id);
-        const check = engine.checkDeck({ deckPath: entry.path });
+        const check = bilingualQuality(engine.checkDeck({ deckPath: entry.path }));
         let html = '';
         try {
             html = ordinaryFile(files.html).toString('utf8');
@@ -172,7 +173,10 @@ export class PptWorkbench {
             const view = await this.view(entry.id);
             if (result.ok && !view.project.render)
                 throw new Error('项目已被修改，请重新渲染');
-            return { ...result, project: view.project };
+            return { ...result, ...(result.ok ? {} : {
+                    messageEn: englishWorkbenchMessage(result.message || 'PPTX rendering failed.'),
+                    installationHintEn: 'Optional renderer: @deepseek-ai/libreoffice-kit@0.1.5. Install it in this DSH profile and restart DSH.',
+                }), project: view.project };
         }
         if (body.operation === 'edit') {
             if (body.slide !== undefined && (typeof body.slide !== 'string' || !manifest.slides.some((s) => s.id === body.slide)))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ppt",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "DSH 演示文稿插件：生成 HTML、可编辑 PPTX 和工程文件，支持图表、轻量编辑、撤销与质量检查。",
   "type": "module",
   "main": "lib/index.js",

package/skills/dsh-ppt/package.json

@@ -1,11 +1,11 @@
-{
-  "name": "dsh-ppt-skill",
-  "version": "0.7.0",
-  "private": true,
-  "type": "module",
-  "description": "Standalone dsh-ppt skill dependencies for image/chart export",
-  "dependencies": { "@office-kit/pptx": "0.21.0" },
-  "peerDependencies": { "@deepseek-ai/libreoffice-kit": "0.1.3" },
-  "peerDependenciesMeta": { "@deepseek-ai/libreoffice-kit": { "optional": true } },
-  "engines": { "node": "^22.19.0 || >=24.0.0" }
-}
+{
+  "name": "dsh-ppt-skill",
+  "version": "0.7.0",
+  "private": true,
+  "type": "module",
+  "description": "Standalone dsh-ppt skill dependencies for image/chart export",
+  "dependencies": { "@office-kit/pptx": "0.21.0" },
+  "peerDependencies": { "@deepseek-ai/libreoffice-kit": "0.1.3" },
+  "peerDependenciesMeta": { "@deepseek-ai/libreoffice-kit": { "optional": true } },
+  "engines": { "node": "^22.19.0 || >=24.0.0" }
+}

package/skills/dsh-ppt/references/copywriting.md

@@ -1,59 +1,59 @@
-# dsh-ppt 幻灯片写作规则（中英双语）
-
-## 结构模板
-
-任何 deck 都遵循同一叙事骨架：
-
-1. **封面**：标题（判断句或名词短语 + 价值承诺）+ 副标题（一句话定位）。
-2. **背景/问题**：现状 → 痛点 → 为什么现在。
-3. **方案/论点**：每个论点一页，先结论后理由。
-4. **证据/案例**：数字、对比、客户/数据点。
-5. **行动号召**：希望听众下一步做什么。
-6. **结束页**：谢谢 + 联系方式或 CTA 重复。
-
-一句话输入的最小完整结构：封面 → 核心观点页 → 结束页。
-
-## 单页规则
-
-- 一个页面只讲一个观点。
-- 标题是完整的判断句，例如「AI 客服把首响时间压缩到 8 秒」，而不是「关于客服」。
-- bullets 1–8 条，中文每条 ≤ 20 字，英文每条 ≤ 12 词。
-- 优先使用数字、对比、动词；避免「赋能、抓手、闭环」等空词。
-- 最后一页要给出可执行的 CTA，不是只写「谢谢」。
-
-## 双语规则
-
-- 插件 `lang` 参数只控制界面（页码/标签/结束页默认文案）；**内容双语由写作阶段完成**。
-- 双语 deck 推荐两种做法：
-  1. 同一页内：中文标题 + 英文副标题；bullets 中文为主，关键词括号英文。
-  2. 两份 deck：同一大纲分别以 `zh` 与 `en` 生成，主题保持一致。
-- 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
-- 双语时不要逐句直译，按目标语言习惯重写。
-
-## Markdown 与结构化输入
-
-解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
-
-## 示例
-
-输入：
-
-```markdown
-# 让会议少一半
-
-用异步决策替代同步例会。
-
-## 问题
-- 工程师每周 6 小时在例会上
-- 决策没有记录，反复讨论
-
-## 方案
-- 会前异步文档 + 24h 评论期
-- 只有分歧项才开会
-
-## 效果
-- 周会从 4 次降到 1 次
-- 决策记录 100% 沉淀
-```
-
-产出：封面 → 问题 → 方案 → 效果 → 结束页，共 5 页，主题可选 `swiss`（数据/效率）或 `soft`（团队协作）。
+# dsh-ppt 幻灯片写作规则（中英双语）
+
+## 结构模板
+
+任何 deck 都遵循同一叙事骨架：
+
+1. **封面**：标题（判断句或名词短语 + 价值承诺）+ 副标题（一句话定位）。
+2. **背景/问题**：现状 → 痛点 → 为什么现在。
+3. **方案/论点**：每个论点一页，先结论后理由。
+4. **证据/案例**：数字、对比、客户/数据点。
+5. **行动号召**：希望听众下一步做什么。
+6. **结束页**：谢谢 + 联系方式或 CTA 重复。
+
+一句话输入的最小完整结构：封面 → 核心观点页 → 结束页。
+
+## 单页规则
+
+- 一个页面只讲一个观点。
+- 标题是完整的判断句，例如「AI 客服把首响时间压缩到 8 秒」，而不是「关于客服」。
+- bullets 1–8 条，中文每条 ≤ 20 字，英文每条 ≤ 12 词。
+- 优先使用数字、对比、动词；避免「赋能、抓手、闭环」等空词。
+- 最后一页要给出可执行的 CTA，不是只写「谢谢」。
+
+## 双语规则
+
+- 插件 `lang` 参数只控制界面（页码/标签/结束页默认文案）；**内容双语由写作阶段完成**。
+- 双语 deck 推荐两种做法：
+  1. 同一页内：中文标题 + 英文副标题；bullets 中文为主，关键词括号英文。
+  2. 两份 deck：同一大纲分别以 `zh` 与 `en` 生成，主题保持一致。
+- 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
+- 双语时不要逐句直译，按目标语言习惯重写。
+
+## Markdown 与结构化输入
+
+解析规则、表格/金句/备注语法与结构化 `slides` JSON 见 `syntax.md`。
+
+## 示例
+
+输入：
+
+```markdown
+# 让会议少一半
+
+用异步决策替代同步例会。
+
+## 问题
+- 工程师每周 6 小时在例会上
+- 决策没有记录，反复讨论
+
+## 方案
+- 会前异步文档 + 24h 评论期
+- 只有分歧项才开会
+
+## 效果
+- 周会从 4 次降到 1 次
+- 决策记录 100% 沉淀
+```
+
+产出：封面 → 问题 → 方案 → 效果 → 结束页，共 5 页，主题可选 `swiss`（数据/效率）或 `soft`（团队协作）。