dsh-plugin-deck-studio 0.2.6 → 0.2.9

package/index.js

@@ -11,7 +11,8 @@
 
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
-import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { execFile } from "node:child_process";
+import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { PLUGIN_DIR, mergeConfig, repoRootFrom } from "./lib/config.js";
 import { createRuntimeStore } from "./lib/store.js";
 import { createDeckWorkspace, scriptSectionRange } from "./lib/deck-workspace.js";
@@ -26,13 +27,33 @@ import { contentDensityOptions, densitySpec, normalizeContentDensity } from "./l
 import { defineDeckTools } from "./lib/tools.js";
 import { registerReviewAgentProvider } from "./lib/review-agent.js";
 import { faqIndex, searchFaq } from "./lib/faq.js";
-import { createScriptToSourceSync, decideProposal } from "./lib/proposal-decision.js";
-import { createDesignRegistry, normalizeAbbr } from "./lib/designs.js";
-import { readSampleRecords, readStyleDefinition, writeStyleDefinition } from "./lib/design-style.js";
+import { applyConfirmedBatch, createScriptToSourceSync, decideProposal } from "./lib/proposal-decision.js";
+import { autolandBadge, latestAutoland, rollbackFirstDraft } from "./lib/first-draft.js";
+import { createDesignRegistry, normalizeAbbr, suggestAbbr } from "./lib/designs.js";
+import { appendSampleRecord, readSampleRecords, readStyleDefinition, writeStyleDefinition } from "./lib/design-style.js";
 import { resolveMediaFile, scanDesignStyles, scanResources } from "./lib/home-catalog.js";
 import { defaultSelection, renderModelPayload, resolveSelection } from "./lib/render-nodes.js";
 import { applyRenderSettings, readRenderSettings, renderSettingsPayload, saveRenderSettings } from "./lib/render-settings.js";
-import { editEndpointFor, selectRenderer } from "./lib/render.js";
+import { buildPrompt, editEndpointFor, selectRenderer } from "./lib/render.js";
+import { readDeckBrief } from "./lib/deck-brief.js";
+import { detectProfileDir, installModeOf, isNewer, latestFromRegistry, repoLinksOf } from "./lib/update-check.js";
+
+/** 跑一个外部命令（异步、带超时、合并 stdout/stderr；失败时把输出带进错误信息）。 */
+function runCommand(command, args, { cwd = "", timeoutMs = 120000 } = {}) {
+  return new Promise((resolve, reject) => {
+    execFile(command, args, { cwd: cwd || undefined, timeout: timeoutMs, maxBuffer: 8 * 1024 * 1024, env: process.env }, (error, stdout, stderr) => {
+      const output = `${stdout ?? ""}${stderr ?? ""}`.trim();
+      if (error) {
+        const failure = new Error(`${command} ${args.join(" ")} 失败：${error.message}${output ? `
+${output.slice(-2000)}` : ""}`);
+        failure.output = output;
+        reject(failure);
+        return;
+      }
+      resolve(output);
+    });
+  });
+}
 
 /** 稳定 Cordis 插件名。 */
 export const name = "deck-studio";
@@ -50,6 +71,7 @@ export const ROUTES = {
   docfile: "/api/deck-studio.docfile",
   export: "/api/deck-studio.export",
   pageEdit: "/api/deck-studio.page-edit",
+  pagePrompt: "/api/deck-studio.page-prompt",
   pageSave: "/api/deck-studio.page-save",
   media: "/api/deck-studio.media",
   renderModel: "/api/deck-studio.render-model",
@@ -66,6 +88,8 @@ export const ROUTES = {
   sessionBind: "/api/deck-studio.session-bind",
   // F-108：工作台「确认落版 / 驳回」按钮——与 Agent 的 deck_revision_confirm 共用落版逻辑。
   proposalDecide: "/api/deck-studio.proposal-decide",
+  // F-173：首稿自动落版的回滚入口（工作台徽标旁的「回滚首稿」按钮）
+  draftRollback: "/api/deck-studio.draft-rollback",
   sessionBindings: "/api/deck-studio.session-bindings",
   handoff: "/api/deck-studio.handoff",
   sourcefile: "/api/deck-studio.sourcefile",
@@ -75,6 +99,9 @@ export const ROUTES = {
   manual: "/api/deck-studio.manual",
   manualDoc: "/api/deck-studio.manual-doc",
   docsAsset: "/api/deck-studio.docs-asset",
+  // F-188：顶栏「更新」按钮——查 npm 最新版 / 一键更新到最新版（只在 npm 安装模式下执行）
+  updateCheck: "/api/deck-studio.update-check",
+  update: "/api/deck-studio.update",
 };
 
 /** 出图资产 MIME（image deck 只有图片；svg 仅 fake 测试用）。 */
@@ -195,6 +222,117 @@ function pluginVersion() {
   return versionCache;
 }
 
+  /** 插件自己的 package.json（版本 / 仓库链接来源；只读一次）。 */
+  let pluginMetaCache = null;
+  function pluginMeta() {
+    if (pluginMetaCache) return pluginMetaCache;
+    let pkg = {};
+    try {
+      pkg = JSON.parse(readFileSync(join(PLUGIN_DIR, "package.json"), "utf8"));
+    } catch {
+      pkg = {};
+    }
+    pluginMetaCache = {
+      name: String(pkg.name ?? "dsh-plugin-deck-studio"),
+      version: String(pkg.version ?? pluginVersion()),
+      links: repoLinksOf(pkg),
+    };
+    return pluginMetaCache;
+  }
+
+  /** 本机 profile 目录：先按插件真实路径反推（npm 布局），再退回 DSH 注入的 env。 */
+  function profileDirHint() {
+    const env = typeof process !== "undefined" ? process.env : {};
+    const meta = pluginMeta();
+    const found = detectProfileDir({ pluginDir: PLUGIN_DIR, packageName: meta.name, env });
+    if (found) return found;
+    const home = env.DSH_HOME ? String(env.DSH_HOME) : "";
+    const profile = env.DSH_PROFILE ? String(env.DSH_PROFILE) : "";
+    return home && profile ? join(home, "profiles", profile) : "";
+  }
+
+  /** 更新相关的静态信息（不发网络请求；workbench 首屏用）。 */
+  function updateBrief() {
+    const meta = pluginMeta();
+    const install = installModeOf({ profileDir: profileDirHint(), packageName: meta.name });
+    const env = typeof process !== "undefined" ? process.env : {};
+    return {
+      currentVersion: meta.version,
+      installMode: install.mode,
+      installSpec: install.spec,
+      installReason: install.reason,
+      profile: (() => {
+        const dir = profileDirHint();
+        return dir ? basename(dir) : String(env.DSH_PROFILE ?? "");
+      })(),
+      repo: meta.links.repo,
+      issues: meta.links.issues,
+      suggest: meta.links.suggest,
+      registry: `https://registry.npmjs.org/${encodeURIComponent(meta.name)}`,
+    };
+  }
+
+  /** 查 npm 上的最新版本（6s 超时；离线 / 超时不抛，只在 payload 里报错）。 */
+  async function updateStatus() {
+    const brief = updateBrief();
+    const payload = { ...brief, latestVersion: "", hasUpdate: false, checkedAt: new Date().toISOString(), error: "" };
+    try {
+      const res = await fetch(`${brief.registry}/latest`, {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(12000),
+      });
+      if (!res.ok) throw new Error(`registry HTTP ${res.status}`);
+      const latest = latestFromRegistry(await res.json());
+      if (!latest) throw new Error("registry 返回里没有 latest 版本");
+      payload.latestVersion = latest;
+      payload.hasUpdate = isNewer(latest, brief.currentVersion);
+      payload.command = brief.installMode === "npm"
+        ? `dsh plugin --profile ${brief.profile || "<profile>"} add ${pluginMeta().name}@${latest}`
+        : "";
+      if (brief.installMode === "linked") payload.note = "本机是开发链接安装，更新走仓库（git pull）；界面不执行 pnpm。";
+    } catch (error) {
+      const message = String(error?.message ?? error);
+      const timedOut = error?.name === "TimeoutError" || /abort|timeout/i.test(message);
+      payload.error = timedOut
+        ? "检查更新超时：连不上 npm registry（网络 / 代理问题），可以直接用命令手动更新。"
+        : `检查更新失败：${message}`;
+    }
+    return payload;
+  }
+
+  /** 一键更新：npm 安装模式下在 profile 目录跑 pnpm add <name>@<latest>（超时 240s）。 */
+  async function runSelfUpdate() {
+    const brief = updateBrief();
+    if (brief.installMode !== "npm") {
+      throw new Error(
+        brief.installMode === "linked"
+          ? "本机是开发链接安装（link:/file:），界面不执行更新；请在仓库里 git pull 后重启 DSH。"
+          : "没识别出 profile 的安装方式，无法自动更新；请手动执行 dsh plugin --profile <profile> add dsh-plugin-deck-studio@latest。",
+      );
+    }
+    const status = await updateStatus();
+    if (status.error) throw new Error(status.error);
+    if (!status.latestVersion) throw new Error("没查到 npm 上的最新版本");
+    const target = `${pluginMeta().name}@${status.latestVersion}`;
+    const output = await runCommand("pnpm", ["add", target], { cwd: brief.profile, timeoutMs: 240000 });
+    store.recordEvent({
+      type: "plugin.update",
+      deckId: "",
+      actor: "user",
+      status: "succeeded",
+      payload: { from: brief.currentVersion, to: status.latestVersion, target },
+    });
+    return {
+      ok: true,
+      from: brief.currentVersion,
+      to: status.latestVersion,
+      target,
+      restarted: false,
+      restartHint: "更新已写入 profile，重启 DSH 后生效（当前进程仍是旧版本）。",
+      output,
+    };
+  }
+
 function json(payload, status = 200) {
   return Response.json(payload, { status, headers: { "cache-control": "no-store" } });
 }
@@ -709,7 +847,7 @@ export function createService(config, logger, env = process.env) {
     }
   }
 
-  /** F-157：风格注册表为空时，自动导入插件自带的 8 个预设风格（含样张）。 */
+  /** F-157：风格注册表为空时，自动导入插件自带的 9 个预设风格（含样张）。 */
   function bootstrapDesignStyles() {
     try {
       if (designRegistry.listDesigns().length > 0) return;
@@ -1003,6 +1141,111 @@ export function createService(config, logger, env = process.env) {
     return { design: designProjectView(design), deckId: canvas.deckId };
   }
 
+  /**
+   * F-186：把某个 deck 已出图页面的成品图复制成 design 样张（不重新出图、不花额度）。
+   * 默认挑 3 张（封面 / 信息页 / 数据页各一更好）——三张最能说明一套风格在封面、信息页、
+   * 对比/数据页上都成立，和预设风格的 3 张基线样张口径一致。
+   */
+  function copyDeckImagesAsSamples(design, { deckId, pages, max = 3 }) {
+    const adapter = adapterOf(deckId);
+    if (!adapter) throw new Error(`未知 deck：${deckId}`);
+    const dir = designStyleDir(design);
+    mkdirSync(dir, { recursive: true });
+    const deck = workspace.manifest(deckId) ?? workspace.ensureDeck(adapter, { styleBrief: config.styleBrief });
+    const requested = Array.isArray(pages) ? pages : [];
+    const pageIds = requested.length
+      ? requested.map((page) => `p${String(Number(String(page).replace(/^p/i, ""))).padStart(2, "0")}`)
+      : deck.slides.slice(0, max).map((slide) => slide.id);
+    const sourceImages = adapter.sourceImages?.() ?? {};
+    const samples = [];
+    for (const pageId of pageIds.slice(0, 6)) {
+      const info = slideRenderInfo(deckId, pageId);
+      if (!info) continue;
+      const sourcePath = info.fromSource
+        ? sourceImages[pageId]?.path
+        : join(workspace.slideDir(deckId, pageId), "versions", info.revision, `image${info.ext}`);
+      if (!sourcePath || !existsSync(sourcePath)) continue;
+      const ext = String(info.ext ?? "png").replace(/^\./, "");
+      let fileName = `sample-${pageId}-${info.revision}.${ext}`;
+      let n = 1;
+      while (existsSync(join(dir, fileName))) fileName = `sample-${pageId}-${info.revision}-${++n}.${ext}`;
+      writeFileSync(join(dir, fileName), readFileSync(sourcePath));
+      let prompt = "";
+      try {
+        prompt = readFileSync(join(workspace.slideDir(deckId, pageId), "versions", info.revision, "prompt.txt"), "utf8");
+      } catch {
+        prompt = "";
+      }
+      appendSampleRecord(dir, {
+        revision: info.revision,
+        brief: `从 ${deckId} ${pageId} 的成品图复制（登记风格用，未重新出图）`,
+        prompt,
+        imagePath: `designs/${design.abbr}/${fileName}`,
+        model: "",
+        size: "",
+      });
+      samples.push({ pageId, revision: info.revision, file: fileName, sizeBytes: statSync(join(dir, fileName)).size });
+    }
+    if (samples.length) {
+      store.recordEvent({
+        type: "design.sample.add",
+        deckId: design.canvasDeckId,
+        actor: "agent",
+        status: "succeeded",
+        payload: { designId: design.designId, abbr: design.abbr, fromDeck: deckId, samples: samples.map((item) => item.file) },
+      });
+    }
+    return samples;
+  }
+
+  /**
+   * F-186：普通对话里登记风格——没先选风格，deck 做出来后觉得这套视觉语言值得复用。
+   *
+   * 两种用法：
+   * - 不传 designId：新建 design（与 Designs 页「＋添加风格」同一份实体），缩写可自动生成；
+   * - 传 designId（或缩写）：只往已有风格里补样张，不动名称与提示词。
+   * 样张一律从 deck 已出图页面**复制成品图**，不重新出图、不花额度，登记下来和用户看到的一致。
+   */
+  function createStyleFromDeck(payload = {}) {
+    const deckId = String(payload.deckId ?? "").trim();
+    const existingKey = String(payload.designId ?? "").trim();
+    if (existingKey) {
+      const design = designRegistry.findDesign(existingKey) ?? designRegistry.findDesignByAbbr(existingKey);
+      if (!design) throw new Error(`未知 design：${existingKey}`);
+      if (!deckId) throw new Error("补样张要指定 deckId（从哪个 deck 复制成品图）");
+      const samples = copyDeckImagesAsSamples(design, { deckId, pages: payload.pages, max: 3 });
+      return {
+        designId: design.designId,
+        abbr: design.abbr,
+        name: design.name,
+        canvasDeckId: design.canvasDeckId,
+        samples,
+        appended: true,
+        totalSamples: readSampleRecords(designStyleDir(design)).length,
+      };
+    }
+    const name = String(payload.name ?? "").trim();
+    if (!name) throw new Error("风格名称不能为空");
+    const styleBrief = String(payload.styleBrief ?? "").trim();
+    if (!styleBrief) throw new Error("风格提示词不能为空：先写清这套风格的画面语言（颜色 / 材质 / 字体 / 版式）");
+    const description = String(payload.description ?? "").trim() || styleBrief;
+    const taken = designRegistry.listDesigns().map((item) => item.abbr);
+    const abbr = String(payload.abbr ?? "").trim() ? normalizeAbbr(payload.abbr) : suggestAbbr(name, taken);
+    if (designRegistry.findDesignByAbbr(abbr)) throw new Error(`缩写 ${abbr} 已被其他风格占用，换一个 abbr`);
+    const created = createDesign({
+      name,
+      abbr,
+      description,
+      styleBrief,
+      constraints: payload.constraints,
+      reference: payload.reference,
+    });
+    const design = designRegistry.findDesign(created.design.designId);
+    mkdirSync(designStyleDir(design), { recursive: true });
+    const samples = deckId ? copyDeckImagesAsSamples(design, { deckId, pages: payload.pages, max: 3 }) : [];
+    return { designId: design.designId, abbr: design.abbr, name: design.name, canvasDeckId: design.canvasDeckId, samples, appended: false };
+  }
+
   /** 预设风格包里某个缩写的 styleBrief（老 design 迁移用；没有就 null）。 */
   function readSeedStyleBrief(abbr) {
     const file = join(SEED_STYLES_DIR, `${String(abbr ?? "").toUpperCase()}.json`);
@@ -1300,26 +1543,23 @@ export function createService(config, logger, env = process.env) {
 
   /** script revision 列表（修改日志用：revisions/vNNN.md + 同名 note）。 */
   function deckRevisions(deckId) {
-    let dir;
     try {
-      dir = join(workspace.deckDir(deckId), "script", "revisions");
+      return workspace.listScriptRevisions(deckId).map((row) => {
+        const autoland = autolandOf(deckId, row.revision);
+        return { ...row, ...(autoland ? { autoland, autolandBadge: autolandBadge(autoland) } : {}) };
+      });
     } catch {
       return [];
     }
-    if (!existsSync(dir)) return [];
-    return readdirSync(dir)
-      .filter((name) => /^v\d+\.md$/.test(name))
-      .sort()
-      .reverse()
-      .map((name) => {
-        const revision = name.replace(/\.md$/, "");
-        const noteFile = join(dir, `${revision}.note.txt`);
-        return {
-          revision,
-          savedAt: statSync(join(dir, name)).mtime.toISOString(),
-          note: existsSync(noteFile) ? readFileSync(noteFile, "utf8").trim() : "",
-        };
-      });
+  }
+
+  function autolandOf(deckId, revision) {
+    try {
+      const raw = readFileSync(join(workspace.deckDir(deckId), "script", "revisions", `${revision}.autoland.json`), "utf8");
+      return JSON.parse(raw);
+    } catch {
+      return null;
+    }
   }
 
   /** 9 份必备 deck 文档的治理状态（不含大段正文）。 */
@@ -1334,14 +1574,15 @@ export function createService(config, logger, env = process.env) {
   }
 
   /** 单份文档（中间区标签用）：正文 + 结构化视图。 */
-  function deckDoc(deckId, docId) {
+  /** F-187：`file` 指定同一份文档下的某个相关文件（如审稿页的 review.gap.md），不传就用默认正文。 */
+  function deckDoc(deckId, docId, file = "") {
     let deckDir;
     try {
       deckDir = workspace.deckDir(deckId);
     } catch {
       return null;
     }
-    return readDeckDoc({ adapter: adapterOf(deckId), deckDir, docId, render: config.render, revisions: deckRevisions(deckId), events: deckEvents(deckId) });
+    return readDeckDoc({ adapter: adapterOf(deckId), deckDir, docId, file, render: config.render, revisions: deckRevisions(deckId), events: deckEvents(deckId) });
   }
 
   /** 给缺失文档打骨架（只写 .deck 工作副本，不动源 deck）。 */
@@ -1358,6 +1599,39 @@ export function createService(config, logger, env = process.env) {
     return pageEditView(adapter, pageId);
   }
 
+  /**
+   * F-189：某页「拼装后的完整出图 prompt」（只读，脚本页折叠展示用）。
+   * 与出图工具同一套拼装：deck 关联 design 的 styleBrief + 图上文字清单 + 讲述用正文 + 画面要求。
+   */
+  function pagePrompt(deckId, pageId) {
+    const adapter = adapterOf(deckId);
+    if (!adapter?.available()) return null;
+    const deck = workspace.manifest(deckId);
+    const normalized = String(pageId ?? "").trim();
+    const slide = (deck?.slides ?? []).find((item) => item.id === normalized || `p${String(item.order).padStart(2, "0")}` === normalized);
+    if (!slide) return null;
+    let styleBrief = config.styleBrief;
+    const association = designRegistry.deckDesignFor(deckId);
+    const design = association?.designId ? designRegistry.findDesign(association.designId) : null;
+    if (design) {
+      let definition = null;
+      try {
+        definition = readStyleDefinition(adapter.sourceRoot, design.abbr ?? "", design);
+      } catch {
+        definition = null;
+      }
+      const brief = String(design.styleBrief || definition?.styleBrief || definition?.description || design.description || "").trim();
+      const constraints = String(design.constraints || definition?.constraints || "").trim();
+      if (brief) styleBrief = [brief, constraints ? `不要什么：${constraints}` : ""].filter(Boolean).join("\n");
+    }
+    return {
+      deckId,
+      pageId: slide.id,
+      design: design?.abbr ?? null,
+      prompt: buildPrompt(slide, styleBrief, { brief: readDeckBrief(adapter.sourceRoot) }),
+    };
+  }
+
   /**
    * 页面微调保存：写回源 script.md / prompts/Pnn.txt，重建 manifest，并自动 git 提交。
    * 这是唯一允许直接写源 deck 的动作（ADR-0006 的例外，见 ADR-0008）。
@@ -1731,6 +2005,12 @@ export function createService(config, logger, env = process.env) {
         // 已过期：工作副本变了，这条提案的 before 行不存在，确认会「工作副本已漂移」。
         stale: isStaleProposal(proposal),
         createdAt: proposal.createdAt,
+        // F-176 / I-18：评审意见清单要靠这些字段分组和判断能否勾选（C 类不可选）。
+        status: proposal.status,
+        reviewRef: proposal.reviewRef ?? null,
+        severity: proposal.severity ?? null,
+        confidence: proposal.confidence ?? null,
+        evidence: typeof proposal.evidence === "string" ? proposal.evidence.slice(0, 300) : null,
       })),
       generatedAt: new Date().toISOString(),
     };
@@ -1993,6 +2273,8 @@ export function createService(config, logger, env = process.env) {
       designProjects: designProjects(),
       bindings: listBindings(),
       proposals: base.pendingProposals,
+      // F-188：顶栏「更新 / GitHub」按钮首屏数据（不打网络，检查更新另调 update-check）
+      update: updateBrief(),
     };
   }
 
@@ -2002,7 +2284,7 @@ export function createService(config, logger, env = process.env) {
     bootstrapDesignStyles();
   }
 
-  return { config, store, workspace, adapters, status, state, workbench, readManual, readUserName: () => config.userName, saveUserName, readDoc, docsAsset, setDeckDensity, renderSettings, saveRenderConfig, isLocalDeck: (deckId) => localDeckIds().has(String(deckId ?? "")), assetFile, slideRenderInfo, deckCoverUrl, deckRevisions, deckDocs, deckDoc, deckDocsScaffold, deckDocFile, pageForEdit, savePage, exportDeckFile, designSamples, sourceFile, homeCatalog, mediaFile, renderState, setRenderSelection, renderRuntime, createDeck, createDesign, designProjects, designStyle, updateDesignStyle, backfillStyleBriefs, listBindings, bindSession, unbindSession, deleteDesign, deleteDeck, setDeckDesign, addDesignSamples, seedStyleDesigns, renderStatus, exportHandoff }
+  return { config, store, workspace, adapters, status, state, workbench, readManual, readUserName: () => config.userName, saveUserName, readDoc, docsAsset, setDeckDensity, renderSettings, saveRenderConfig, isLocalDeck: (deckId) => localDeckIds().has(String(deckId ?? "")), assetFile, slideRenderInfo, deckCoverUrl, deckRevisions, deckDocs, deckDoc, deckDocsScaffold, deckDocFile, pageForEdit, pagePrompt, savePage, exportDeckFile, designSamples, sourceFile, homeCatalog, mediaFile, renderState, setRenderSelection, renderRuntime, createDeck, createDesign, createStyleFromDeck, designProjects, designStyle, updateDesignStyle, backfillStyleBriefs, listBindings, bindSession, unbindSession, deleteDesign, deleteDeck, setDeckDesign, addDesignSamples, seedStyleDesigns, renderStatus, exportHandoff, updateBrief, updateStatus, runSelfUpdate }
 }
 
 /**
@@ -2079,6 +2361,12 @@ export function apply(ctx, rawConfig) {
     return view ? json({ ok: true, ...view }) : json({ ok: false, error: { message: "page not found" } }, 404);
   });
 
+  registerRoute(ROUTES.pagePrompt, (request) => {
+    const url = new URL(request?.url ?? "/", "http://localhost");
+    const view = service.pagePrompt(url.searchParams.get("deckId") ?? "", url.searchParams.get("pageId") ?? "");
+    return view ? json({ ok: true, ...view }) : json({ ok: false, error: { message: "page not found" } }, 404);
+  });
+
   registerRoute(ROUTES.pageSave, async (request) => {
     const body = await request.json().catch(() => ({}));
     const result = service.savePage(body.deckId ?? "", body.pageId ?? "", body.fields ?? body);
@@ -2198,6 +2486,18 @@ export function apply(ctx, rawConfig) {
       const quote = String(body?.quote ?? "").trim()
         || (confirmed ? "（工作台：用户点了「确认落版」）" : "（工作台：用户点了「驳回」）");
       const syncScriptToSource = createScriptToSourceSync({ adapters: service.adapters, isLocalDeck: (deckId) => service.isLocalDeck(deckId) });
+      // F-176 / I-18：「接受并更新」——勾选的一批评审修改合成**一条** revision（不是一条提案一条 revision）。
+      if (confirmed && body?.batch === true) {
+        const proposals = ids.map((proposalId) => service.workspace.proposal(proposalId)).filter(Boolean);
+        const missing = ids.filter((proposalId) => !proposals.some((proposal) => proposal.proposalId === proposalId));
+        if (missing.length) return json({ ok: false, error: { message: `提案不存在：${missing.join("、")}`, missing } }, 404);
+        try {
+          const landed = applyConfirmedBatch({ store: service.store, workspace: service.workspace, proposals, quote, sessionId: null, syncScriptToSource });
+          return json({ ok: true, batch: true, revision: landed.revision, reviewRefs: landed.reviewRefs, decided: proposals.length, sourceSync: landed.sourceSync ?? null });
+        } catch (error) {
+          return json({ ok: false, error: { message: String(error?.message ?? error) } }, 409);
+        }
+      }
       const results = [];
       for (const proposalId of ids) {
         const proposal = service.workspace.proposal(proposalId);
@@ -2217,6 +2517,31 @@ export function apply(ctx, rawConfig) {
     ["POST"],
   );
 
+  // F-173：工作台「回滚首稿」——与 Agent 的 deck_draft_rollback 同一条逻辑。
+  registerRoute(
+    ROUTES.draftRollback,
+    async (request) => {
+      if ((request?.method ?? "POST").toUpperCase() !== "POST") return json({ ok: false, error: { message: "POST only" } }, 405);
+      const body = await request.json().catch(() => ({}));
+      const deckId = String(body?.deckId ?? "").trim();
+      if (!deckId) return json({ ok: false, error: { message: "缺少 deckId" } }, 400);
+      if (!service.workspace.manifest(deckId)) return json({ ok: false, error: { message: `未知 deck：${deckId}` } }, 404);
+      const latest = latestAutoland(service.workspace, deckId);
+      if (!latest) return json({ ok: false, error: { message: "没有可回滚的首稿：最新 revision 不是自动落版（或已回滚过）" } }, 409);
+      try {
+        const result = rollbackFirstDraft({ workspace: service.workspace, deckId, note: String(body?.note ?? "（工作台：用户点了「回滚首稿」）") });
+        const text = service.workspace.scriptCurrent(deckId) ?? "";
+        const syncScriptToSource = createScriptToSourceSync({ adapters: service.adapters, isLocalDeck: (id) => service.isLocalDeck(id) });
+        const sourceSync = syncScriptToSource ? syncScriptToSource(deckId, text, null) : null;
+        service.store.recordEvent({ type: "deck.edit", sessionId: null, taskId: null, deckId, slideIds: [], actor: "user", status: "succeeded", payload: { outcome: "autoland-rollback", fromRevision: result.beforeRevision, revision: result.revision } });
+        return json({ ok: true, ...result, ...(sourceSync ? { sourceSync } : {}) });
+      } catch (error) {
+        return json({ ok: false, error: { message: String(error?.message ?? error) } }, 409);
+      }
+    },
+    ["POST"],
+  );
+
   // 同一路径只能注册一次（connection 按 path 去重）：GET 读状态 / POST 切换选择。
   registerRoute(
     ROUTES.renderModel,
@@ -2266,6 +2591,19 @@ export function apply(ctx, rawConfig) {
     });
   });
 
+  // F-188：顶栏「更新」按钮——GET 查 npm 最新版（6s 超时，离线只报错不抛）。
+  registerRoute(ROUTES.updateCheck, async () => json({ ok: true, ...(await service.updateStatus()) }), ["GET"]);
+
+  // F-188：一键更新到最新版（只在 npm 安装模式执行；开发链接安装返回 400 说明原因）。
+  registerRoute(ROUTES.update, async (request) => {
+    if ((request?.method ?? "POST").toUpperCase() !== "POST") return json({ ok: false, error: { message: "POST only" } }, 405);
+    try {
+      return json(await service.runSelfUpdate());
+    } catch (error) {
+      return json({ ok: false, error: { message: String(error?.message ?? error) } }, 400);
+    }
+  }, ["POST"]);
+
   registerRoute(ROUTES.faq, (request) => {
     const url = new URL(request?.url ?? "/", "http://localhost");
     const query = String(url.searchParams.get("q") ?? "").trim();
@@ -2286,8 +2624,10 @@ export function apply(ctx, rawConfig) {
     const deckId = url.searchParams.get("deckId") ?? "";
     const docId = url.searchParams.get("docId") ?? "";
     // F-163：读取失败要把真实原因吐给前端，不能 500 空手而归（前端以前会一直转圈）。
+    // F-187：审稿页的「相关文件」（review.readers.md / review.gap.md / review.experts.md …）可逐个打开。
+    const file = url.searchParams.get("file") ?? "";
     try {
-      const doc = service.deckDoc(deckId, docId);
+      const doc = service.deckDoc(deckId, docId, file);
       if (!doc) return json({ ok: false, error: { message: `unknown deck or doc：deckId=${deckId || "(空)"} docId=${docId || "(空)"}` } }, 404);
       return json({ ok: true, deckId, ...doc });
     } catch (error) {
@@ -2334,7 +2674,7 @@ export function apply(ctx, rawConfig) {
     if (!toolRuntime?.register) {
       ctx.logger?.warn?.(`${name}: config.tools=true 但 tools 服务不可用——deck 工具未注册`);
     } else {
-      const tools = defineDeckTools({ store: service.store, workspace: service.workspace, adapters: service.adapters, config, env: process.env, repoRoot: repoRootFrom(PLUGIN_DIR), isLocalDeck: (deckId) => service.isLocalDeck(deckId), resolveRender: (deckId) => service.renderRuntime(deckId), subagents: () => ctx.get("subagents") ?? null });
+      const tools = defineDeckTools({ store: service.store, workspace: service.workspace, adapters: service.adapters, config, env: process.env, repoRoot: repoRootFrom(PLUGIN_DIR), isLocalDeck: (deckId) => service.isLocalDeck(deckId), resolveRender: (deckId) => service.renderRuntime(deckId), createStyle: (payload) => service.createStyleFromDeck(payload), subagents: () => ctx.get("subagents") ?? null });
       for (const tool of tools) {
         disposers.push(toolRuntime.register(tool));
       }