@copylee/dsh-office 0.1.0 → 0.2.1

package/lib/client.js

@@ -37,6 +37,11 @@ window.__ModuleLoader__.load({
 		/** The Loader entry id (settings namespace); see cordis.patch.yml. */
 		const ENTRY_ID = "copylee-office";
 		const DEFAULTS = {
+			follow: true,
+			typing: true,
+			card: true,
+			finalCheck: true,
+			preferLive: true,
 			showOnOpen: true,
 			renderWidth: 1100
 		};
@@ -46,6 +51,11 @@ window.__ModuleLoader__.load({
 			if (raw !== null && typeof raw === "object") for (const [key, value] of Object.entries(raw)) out[key] = value !== null && typeof value === "object" && typeof value.get === "function" ? value.get() : value;
 			const width = out.renderWidth;
 			return {
+				follow: typeof out.follow === "boolean" ? out.follow : DEFAULTS.follow,
+				typing: typeof out.typing === "boolean" ? out.typing : DEFAULTS.typing,
+				card: typeof out.card === "boolean" ? out.card : DEFAULTS.card,
+				finalCheck: typeof out.finalCheck === "boolean" ? out.finalCheck : DEFAULTS.finalCheck,
+				preferLive: typeof out.preferLive === "boolean" ? out.preferLive : DEFAULTS.preferLive,
 				showOnOpen: typeof out.showOnOpen === "boolean" ? out.showOnOpen : DEFAULTS.showOnOpen,
 				renderWidth: typeof width === "number" && Number.isFinite(width) ? Math.min(2e3, Math.max(600, Math.round(width))) : DEFAULTS.renderWidth
 			};
@@ -478,7 +488,57 @@ window.__ModuleLoader__.load({
 			} }, APP_NAMES[app.app]), h("span", { style: {
 				...S.hint,
 				fontSize: 13
-			} }, !app.installed ? "未安装" : !app.running ? "已安装，未运行（需要时自动启动）" : app.documents.length === 0 ? "运行中，没有打开的文档" : `运行中：${app.documents.map((doc) => doc.name + (doc.saved ? "" : "（未保存）")).join("、")}`))), h("p", { style: S.hint }, "需要本机装有微软 Office。Word 里 AI 的一批修改可以用一次 Ctrl+Z 撤回；Excel 和 PowerPoint 的修改无法用 Ctrl+Z 撤回。你正在单元格里输入或开着对话框时，AI 会等你。")), h("section", { style: S.card }, h("h3", { style: S.cardTitle }, "行为"), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "打开文档时显示到前台", h("span", { style: {
+			} }, !app.installed ? "未安装" : !app.running ? "已安装，未运行（需要时自动启动）" : app.documents.length === 0 ? "运行中，没有打开的文档" : `运行中：${app.documents.map((doc) => doc.name + (doc.saved ? "" : "（未保存）")).join("、")}`))), h("p", { style: S.hint }, "需要本机装有微软 Office。Word 里 AI 的一批修改可以用一次 Ctrl+Z 撤回；Excel 和 PowerPoint 的修改无法用 Ctrl+Z 撤回。你正在单元格里输入或开着对话框时，AI 会等你。")), h("section", { style: S.card }, h("h3", { style: S.cardTitle }, "行为"), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "跟随 AI 的修改位置", h("span", { style: {
+				...S.hint,
+				fontWeight: 400
+			} }, "AI 改到哪里，窗口就自动滚动到哪里（Word 滚到那一段，Excel 滚到那片单元格，PowerPoint 切到那一页），不用自己翻找。关闭即静默执行：AI 照常修改，但不动你的视图。")), h(Switch, {
+				checked: settings.follow,
+				disabled,
+				label: "跟随 AI 的修改位置",
+				onChange: (value) => {
+					change("follow", value);
+				}
+			})), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "逐字写入", h("span", { style: {
+				...S.hint,
+				fontWeight: 400
+			} }, "文字像打字一样逐步出现，而不是整块贴上去；表格逐行填入。每段最多多花约 1 秒，关闭后写得最快。")), h(Switch, {
+				checked: settings.typing,
+				disabled,
+				label: "逐字写入",
+				onChange: (value) => {
+					change("typing", value);
+				}
+			})), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "迷你卡片", h("span", { style: {
+				...S.hint,
+				fontWeight: 400
+			} }, "AI 编辑时在屏幕右下角显示一张小卡片：正在改哪个文档、改到第几项，以及“跟随”“逐字”两个开关，点一下立即生效（连正在进行的这一批也会跟着变）。卡片可拖动，不抢焦点，AI 停手几秒后自动消失。在卡片上切换过的开关，本次运行期间以卡片为准。")), h(Switch, {
+				checked: settings.card,
+				disabled,
+				label: "迷你卡片",
+				onChange: (value) => {
+					change("card", value);
+				}
+			})), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "交付前整体视觉检查", h("span", { style: {
+				...S.hint,
+				fontWeight: 400
+			} }, "AI 保存时，如果它改完之后还没看过成品，就自动把文档各页（最多 8 页）渲染成图片交给它过一遍，发现问题先修再交付。会多用一些 token。")), h(Switch, {
+				checked: settings.finalCheck,
+				disabled,
+				label: "交付前整体视觉检查",
+				onChange: (value) => {
+					change("finalCheck", value);
+				}
+			})), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "优先在真实 Office 里操作", h("span", { style: {
+				...S.hint,
+				fontWeight: 400
+			} }, "DSH 自带的 office-docx / office-xlsx / office-pptx 技能是用脚本生成文件，你看不到过程，公式和排版也由脚本决定。开启后，AI 第一次想加载这些技能时会被引回本插件（对应的 Office 应用已安装时才拦）；它确有需要而再次请求时放行。")), h(Switch, {
+				checked: settings.preferLive,
+				disabled,
+				label: "优先在真实 Office 里操作",
+				onChange: (value) => {
+					change("preferLive", value);
+				}
+			})), h("div", { style: S.toggleRow }, h("div", { style: S.toggleText }, "打开文档时显示到前台", h("span", { style: {
 				...S.hint,
 				fontWeight: 400
 			} }, "关闭后文档仍会打开，只是不抢你当前的窗口。")), h(Switch, {

package/lib/index.js

@@ -223,15 +223,37 @@ var HelperClient = class {
 };
 //#endregion
 //#region lib/types/prompt.js
+/** The host's file-based Office skills, and the app each one stands in for. */
+const FILE_SKILLS = {
+	"office-docx": "word",
+	"office-xlsx": "excel",
+	"office-pptx": "ppt"
+};
+const APPS = {
+	word: "Microsoft Word",
+	excel: "Microsoft Excel",
+	ppt: "Microsoft PowerPoint"
+};
+/** What the model is told the first time it reaches for one of those skills. */
+function redirectText(skill, app) {
+	return [
+		`Not loaded: ${APPS[app]} is installed on this computer, so do this work inside it with the office_ tools instead of building the file with a script.`,
+		"Call office_open with the absolute path (a path that does not exist yet creates the document; the app is started for you if it is not running), then office_read, office_edit, office_render, office_save. The user watches the document take shape in the window and can edit alongside; formulas, captions and layout are done by the app itself.",
+		`Only if the task truly cannot be done that way (converting many files in bulk, a file the app cannot open, no document to show), call skill "${skill}" again and it will load.`
+	].join("\n");
+}
 /** System-prompt section: when to reach for the office_ tools, in as few tokens as will do. */
 function promptText() {
 	return [
 		"# Office documents (Word, Excel, PowerPoint)",
 		"The office_ tools work inside the real Office apps on this computer: the document is open in its window, every change you make appears there at once, and the user can read and edit alongside you.",
-		"- For any .docx / .xlsx / .pptx work, call office_open first, then office_read, then office_edit. Prefer this over writing the file with scripts or libraries: an open file cannot be overwritten, and the user would not see the work.",
+		"- For any Word, Excel or PowerPoint work, creating a new document included, start with office_open (it starts the app if it is not running, and a path that does not exist yet creates the file), then office_read and office_edit. Do not load the office-docx / office-xlsx / office-pptx skills and do not write the file with a script: an open file cannot be overwritten, and the user would not see the work.",
 		"- Put all the changes you can into one office_edit call; it runs them in order.",
 		"- The user may edit while you work. Read again before editing a part you have not just read, and pass \"expect\" on Word paragraphs.",
-		"- After editing, check the layout with office_render when it matters (slides, formatted pages), then office_save. Nothing is saved until you call office_save; do not close the user's documents.",
+		"- Use these tools, not python-docx / openpyxl / python-pptx or other file libraries, whenever the document is to be worked on in the user's Office app or is already open there; and check the result with office_render, not by converting the file with another renderer, which lays it out differently from Word.",
+		"- Finish with a polish pass, it is part of the job: office_render every page or slide you changed, look at the pictures the way a careful reader would, fix what is off with office_edit, and render again until it is right. Look for: content outside the frame or section it belongs to; fonts, sizes and line spacing that differ from the surrounding text or from what the template asks for; formulas left as plain text; tables that are too wide, uneven or uncentred; captions not next to their table or figure; leftover template hints and sample text; runs of blank paragraphs and half-empty pages. Then office_save. Nothing is saved until you call office_save; do not close the user's documents.",
+		"- In Word, formulas are LaTeX between dollar signs ($...$ inline, $$...$$ on its own line); they become native equations.",
+		"- When filling in a template, keep its structure: put each part where its heading is, replace or delete the sample text and hints, and match the formatting the template asks for.",
 		"- If a call reports the app is busy, the user is typing or has a dialog open: wait a moment and retry.",
 		"- If you also have mouse / keyboard computer tools, use them on an Office window only for what office_edit cannot do, such as a setting that exists only in a dialog."
 	].join("\n");
@@ -246,6 +268,11 @@ function promptText() {
 /** The Loader entry id (settings namespace); see cordis.patch.yml. */
 const ENTRY_ID = "copylee-office";
 const DEFAULTS = {
+	follow: true,
+	typing: true,
+	card: true,
+	finalCheck: true,
+	preferLive: true,
 	showOnOpen: true,
 	renderWidth: 1100
 };
@@ -255,12 +282,17 @@ function resolveConfig(raw) {
 	if (raw !== null && typeof raw === "object") for (const [key, value] of Object.entries(raw)) out[key] = value !== null && typeof value === "object" && typeof value.get === "function" ? value.get() : value;
 	const width = out.renderWidth;
 	return {
+		follow: typeof out.follow === "boolean" ? out.follow : DEFAULTS.follow,
+		typing: typeof out.typing === "boolean" ? out.typing : DEFAULTS.typing,
+		card: typeof out.card === "boolean" ? out.card : DEFAULTS.card,
+		finalCheck: typeof out.finalCheck === "boolean" ? out.finalCheck : DEFAULTS.finalCheck,
+		preferLive: typeof out.preferLive === "boolean" ? out.preferLive : DEFAULTS.preferLive,
 		showOnOpen: typeof out.showOnOpen === "boolean" ? out.showOnOpen : DEFAULTS.showOnOpen,
 		renderWidth: typeof width === "number" && Number.isFinite(width) ? Math.min(2e3, Math.max(600, Math.round(width))) : DEFAULTS.renderWidth
 	};
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-scope@0.2._0d6b19188928ab894325adc32e18b0b5/node_modules/@deepseek-ai/dsh-scope/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-scope@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4_@deepseek-ai+dsh-invariants_0d6b19188928ab894325adc32e18b0b5/node_modules/@deepseek-ai/dsh-scope/lib/index.js
 /**
 * Shared insertion-ordered storage and effect ownership for scope-aware registries.
 *
@@ -539,7 +571,7 @@ function scopeTarget(base, key) {
 	return carrier;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-pro_0ed6bf01f07b8aa74e2681abf2790db7/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-typert-protocol@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-typert-protocol/lib/index.js
 /** The one Remote failure class shared by owners, the Gateway, and consumers. */
 /**
 * One Remote call failure: a real Error carrying its stable code and typed
@@ -699,7 +731,7 @@ function validateName(subject, value) {
 	if (!isTypertRemoteSegment(value)) throw new TypeError(`typert-protocol: ${subject} must contain only RPC endpoint segment characters`);
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-util-value_a1b445b943dd6f2898d88d6b9ffb1320/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-values@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
 /** Duplicate-install-safe JSON and immutable-value helpers. @module @deepseek-ai/dsh-util-values */
 /**
 * Mark an unreachable closed-union branch.
@@ -911,7 +943,7 @@ function deepFreeze(value) {
 	return value;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-util-crypt_566393aaceb27aff7afe31ca52cb276c/node_modules/@deepseek-ai/dsh-util-crypto/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-util-crypto@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-util-crypto/lib/index.js
 /**
 * Random v4 UUID, minted from `crypto.getRandomValues`.
 * @returns the UUID string.
@@ -947,7 +979,7 @@ function brandString(value) {
 	return value;
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-timeout@0._b8424359025b5f3ee36fc59cc7db98be/node_modules/@deepseek-ai/dsh-timeout/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-timeout@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-timeout/lib/index.js
 /** Largest delay Node schedules without clamping it to one millisecond. */
 const MAX_TIMER_DELAY_MS = 2147483647;
 //#endregion
@@ -2128,7 +2160,7 @@ function adapterFailureChunk(error, signal) {
 	};
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-sandbox@0._2cc6ce11d95db65b014013a78bf96eaa/node_modules/@deepseek-ai/dsh-sandbox/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-sandbox@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4_@deepseek-ai+dsh-llm@0.2._2cc6ce11d95db65b014013a78bf96eaa/node_modules/@deepseek-ai/dsh-sandbox/lib/index.js
 /**
 * The escalation vocabulary and choreography shared by every sandbox-enforcing
 * tool family (`@deepseek-ai/dsh-tool-bash`, `@deepseek-ai/dsh-tool-fs`): the
@@ -2214,7 +2246,7 @@ async function approveEscalation(request, approval) {
 	}
 }
 //#endregion
-//#region node_modules/.pnpm/@deepseek-ai+dsh-tools@0.2._0055658947bc774f21f98df07f5a8468/node_modules/@deepseek-ai/dsh-tools/lib/index.js
+//#region node_modules/.pnpm/@deepseek-ai+dsh-tools@0.2.0-rc.2_c6e351a6a6cfd1c2a664558bffcd410d/node_modules/@deepseek-ai/dsh-tools/lib/index.js
 /**
 * Enforced JSON Schema subset shared by tool outputs, generated PTC mode
 * types, subagents, and workflows. The subset accepts any JSON root, an
@@ -5864,7 +5896,7 @@ function formatStatus(apps) {
 			continue;
 		}
 		if (!app.running) {
-			lines.push(`${name}: not running`);
+			lines.push(`${name}: installed, not running (office_open starts it)`);
 			continue;
 		}
 		if (app.error) {
@@ -5893,9 +5925,12 @@ function formatWord(read) {
 	return [
 		`${read.paragraphs} paragraphs, ${read.tables} table(s)${read.pages === void 0 ? "" : `, ${read.pages} page(s)`}.`,
 		...(read.items ?? []).map((item) => {
-			if (item.table !== void 0) return `${item.i}–${item.to} [table ${item.table}, ${item.size}]`;
+			if (item.size !== void 0) {
+				const name = item.table === void 0 ? "table inside a cell" : `table ${item.table}`;
+				return `${item.i}–${item.to} [${name}, ${item.size}]${item.open ? " holds the text below; write inside it by paragraph number:" : ""}`;
+			}
 			const tag = item.level !== void 0 ? `H${item.level}` : item.style !== void 0 && !BODY_STYLES.has(item.style.toLowerCase()) ? item.style : "";
-			return `${item.i}${tag ? ` [${tag}]` : ""} ${item.text ? item.text : "(empty)"}`;
+			return `${item.inTable ? "  " : ""}${item.i}${tag ? ` [${tag}]` : ""} ${item.text ? item.text : "(empty)"}`;
 		}),
 		...read.more ? [read.more] : []
 	].join("\n");
@@ -5925,7 +5960,11 @@ function formatPpt(read) {
 }
 function formatEdit(result) {
 	const done = result.done.map((line, index) => `${index + 1}. ${line}`);
-	if (!result.failed) return [`All ${result.total} operation(s) applied (not saved yet):`, ...done].join("\n");
+	if (!result.failed) return [
+		`All ${result.total} operation(s) applied (not saved yet):`,
+		...done,
+		"Before you finish, look at the pages you changed with office_render and fix what is off."
+	].join("\n");
 	const { index, op, error } = result.failed;
 	return [
 		`Stopped at operation ${index + 1} (${op}): ${error}`,
@@ -5941,6 +5980,47 @@ function formatEdit(result) {
 * instead of one per change.
 */
 const { extname, isAbsolute } = win32;
+const IMAGE = {
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		attachmentId: {
+			type: "string",
+			required: true
+		},
+		mediaType: {
+			type: "string",
+			required: true
+		},
+		bytes: {
+			type: "integer",
+			required: true
+		},
+		width: {
+			type: "integer",
+			required: true
+		},
+		height: {
+			type: "integer",
+			required: true
+		},
+		name: { type: "string" },
+		originalDimensions: {
+			type: "object",
+			additionalProperties: false,
+			properties: {
+				width: {
+					type: "integer",
+					required: true
+				},
+				height: {
+					type: "integer",
+					required: true
+				}
+			}
+		}
+	}
+};
 const output = {
 	schema: {
 		type: "object",
@@ -5950,59 +6030,20 @@ const output = {
 				type: "string",
 				required: true
 			},
-			image: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					attachmentId: {
-						type: "string",
-						required: true
-					},
-					mediaType: {
-						type: "string",
-						required: true
-					},
-					bytes: {
-						type: "integer",
-						required: true
-					},
-					width: {
-						type: "integer",
-						required: true
-					},
-					height: {
-						type: "integer",
-						required: true
-					},
-					name: { type: "string" },
-					originalDimensions: {
-						type: "object",
-						additionalProperties: false,
-						properties: {
-							width: {
-								type: "integer",
-								required: true
-							},
-							height: {
-								type: "integer",
-								required: true
-							}
-						}
-					}
-				}
+			image: IMAGE,
+			more: {
+				type: "array",
+				items: IMAGE
 			}
 		}
 	},
-	render: (_args, value) => value.image === void 0 ? [{
+	render: (_args, value) => [{
 		type: "text",
 		text: value.text
-	}] : [{
-		type: "text",
-		text: value.text
-	}, {
+	}, ...[value.image, ...value.more ?? []].filter((image) => image !== void 0).map((image) => ({
 		type: "image",
-		attachment: value.image
-	}]
+		attachment: image
+	}))]
 };
 function toJson(ref) {
 	return {
@@ -6064,14 +6105,17 @@ const APP = {
 };
 const EDIT_GUIDE = `Edit a document that is open in Word, Excel or PowerPoint, live: each change appears in the window, and the user can keep working in it. Runs ops in order and stops at the first that fails. Does not save (use office_save). Word edits are one undo step for the user; Excel and PowerPoint edits cannot be undone with Ctrl+Z.
 
-Word ops. para = paragraph number from office_read; pass expect = its first words so a number made stale by other edits is caught. where = after (default with para) | before | start | end (default without para).
-- insert_paragraphs {items:[{text, style?}], para?, expect?, where?} — style: Normal, Title, Heading 1..6, List Bullet, List Number, Quote, or a style name the document has. A newline in text starts another paragraph. Items also take the format_text fields.
+Word ops. para = paragraph number from office_read; pass expect = its first words so a number made stale by other edits is caught. where = after (default with para) | before | start | end (default without para: the very end of the document).
+In a form or template whose sections are table cells, write INSIDE the cell: give para = a paragraph of that cell. Without para the text or table lands after everything, outside the form.
+Formulas: write LaTeX between dollar signs in any text: $...$ inside a sentence, $$...$$ as a paragraph of its own. Number a display formula when the document numbers its formulas by ending it with \\tag{1}: $$T=2\\pi\\sqrt{l/g} \\tag{1}$$ puts (1) flush right. They become native Word equations (\\frac, \\sqrt, ^, _, Greek letters, \\bar, \\sum, \\int ...). Never write a formula as plain text such as T = 2π√(l/g).
+- insert_paragraphs {items:[{text, style?}], para?, expect?, where?} — style: Normal, Title, Heading 1..6, List Bullet, List Number, Quote, or a style name the document has. Without style a paragraph is body text in the font, size and spacing of the text it is placed next to. A newline in text starts another paragraph. Items also take the format_text fields.
 - set_text {para, expect, text} — rewrite one paragraph, keeping its style. expect is required ("" for an empty paragraph).
 - replace_text {find, replace, all?}
 - format_text {para?, to?, find?, style?, font?, size?, bold?, italic?, underline?, color?, align?, firstLineIndent?, spaceBefore?, spaceAfter?, lineSpacing?} — para..to, or the first match of find.
-- delete_range {para, expect, to?} — expect is required. Paragraph numbers shift after every insert or delete; each result tells you the new numbers.
-- insert_table {data:[[cell,..],..], para?, where?, header?}; set_cell {table, row, col, text}
-- insert_image {path, para?, where?, width?}
+- delete_range {para, expect, to?} — expect is required; para..to in one operation removes a run of paragraphs (leftover hints, surplus blank lines). Paragraph numbers shift after every insert or delete; each result tells you the new numbers.
+- insert_table {data:[[cell,..],..], caption?, para?, where?, header?} — with para inside a cell, the table goes inside that cell. set_cell {table, row, col, text}
+- Captions: give caption (the title only, no "表 1") on insert_table / insert_image. It is set the standard way: numbered automatically ("表 1", "图 1"), centred, above a table and below a figure. Do not write captions as ordinary paragraphs.
+- insert_image {path, caption?, para?, where?, width?} — the picture is centred on a line of its own.
 
 Excel ops. sheet = sheet name (default: the active sheet).
 - write_range {range: top-left cell, values:[[..],..]} — a string starting with "=" is a formula; also takes the format_range fields.
@@ -6093,6 +6137,47 @@ function createTools(host) {
 	const { helper } = host;
 	const tools = [];
 	let current;
+	const unseen = /* @__PURE__ */ new Set();
+	const keyOf = (on) => `${on.app}:${fileName(on.doc).toLowerCase()}`;
+	/** Pictures of the document as it is now: Word pages or PowerPoint slides first..last, or an Excel range. */
+	const picture = async (on, first, last, extra, width) => {
+		const folder = join(tmpdir(), "dsh-office");
+		await mkdir(folder, { recursive: true });
+		const lines = [];
+		const images = [];
+		let total;
+		for (let number = first; number <= last; number++) {
+			const out = join(folder, `render-${process.pid}-${Date.now()}-${number}.png`);
+			try {
+				const which = on.app === "word" ? { page: number } : on.app === "ppt" ? { slide: number } : {};
+				const result = await helper.call("render", {
+					...on,
+					...extra,
+					...which,
+					out,
+					width
+				}, 5e4);
+				images.push(toJson(await host.saveImage(await readFile(out), `${on.app}-${result.what.replace(/[^\w一-龥]+/g, "-")}.png`)));
+				lines.push(`${APP_NAMES[on.app]} ${result.what}, ${result.width}×${result.height}.`);
+				const of = / of (\d+)$/.exec(result.what);
+				if (of) {
+					total = Number(of[1]);
+					last = Math.min(last, total);
+				}
+			} catch (error) {
+				if (images.length === 0) throw error;
+				if (on.app === "word") lines.push(error instanceof Error ? error.message : String(error));
+				break;
+			} finally {
+				await rm(out, { force: true });
+			}
+		}
+		return {
+			lines,
+			images,
+			...total === void 0 ? {} : { total }
+		};
+	};
 	/** The helper arguments naming the document; the app comes from doc / app only, never from a save-as path. */
 	const target = (args) => {
 		if (args.doc === void 0 && args.app === void 0) {
@@ -6135,10 +6220,14 @@ function createTools(host) {
 				...app === void 0 ? {} : { app },
 				...path === void 0 ? {} : { path }
 			});
+			const { showOnOpen, follow, typing, card } = host.settings();
 			const doc = await helper.call("open", {
 				app: kind,
 				...path === void 0 ? {} : { path },
-				show: host.settings().showOnOpen
+				show: showOnOpen,
+				follow,
+				typing,
+				card
 			}, 8e4);
 			current = {
 				app: kind,
@@ -6236,10 +6325,17 @@ function createTools(host) {
 			const input = args;
 			if (!Array.isArray(input.ops) || input.ops.length === 0) throw new Error("ops must be a non-empty array.");
 			if (input.ops.length > 200) throw new Error("At most 200 operations per call.");
-			return { text: formatEdit(await helper.call("edit", {
-				...target(input),
-				ops: input.ops
-			}, 27e4)) };
+			const { follow, typing, card } = host.settings();
+			const on = target(input);
+			const result = await helper.call("edit", {
+				...on,
+				ops: input.ops,
+				follow,
+				typing,
+				card
+			}, 27e4);
+			if (result.done.length > 0) unseen.add(keyOf(on));
+			return { text: formatEdit(result) };
 		},
 		presentCall: (args) => {
 			const { doc, ops } = args;
@@ -6248,7 +6344,7 @@ function createTools(host) {
 	}));
 	tools.push(defineTool({
 		name: "office_render",
-		description: "Get a picture of how the document really looks, to check layout after editing: a Word page, a PowerPoint slide, or an Excel range (default: the used range). Cheaper and sharper than a screenshot, and works with the window in the background.",
+		description: "Get a picture of how the open document really looks: a Word page, a PowerPoint slide (with \"to\": up to 4 in a row), or an Excel range (default: the used range). Use it on every page you changed before you finish: it shows what office_read cannot, such as content that landed outside its frame, a table that is too wide, text that overflows. It pictures the document as Word itself lays it out, unsaved changes included, with the window in the background.",
 		parameters: {
 			doc: DOC,
 			app: APP,
@@ -6260,6 +6356,10 @@ function createTools(host) {
 				type: "integer",
 				description: "PowerPoint: slide number."
 			},
+			to: {
+				type: "integer",
+				description: "Word / PowerPoint: last page or slide, to get up to 4 in one call."
+			},
 			sheet: {
 				type: "string",
 				description: "Excel: sheet name."
@@ -6276,31 +6376,23 @@ function createTools(host) {
 			const on = target(input), kind = on.app;
 			if (kind === "ppt" && input.slide === void 0) throw new Error("slide is required for PowerPoint.");
 			if (!await host.vision(exec)) return { text: "The current model cannot view images; check the result with office_read instead." };
-			const folder = join(tmpdir(), "dsh-office");
-			await mkdir(folder, { recursive: true });
-			const out = join(folder, `render-${process.pid}-${Date.now()}.png`);
-			try {
-				const { doc: _doc, app: _app, ...rest } = input;
-				const result = await helper.call("render", {
-					...on,
-					...rest,
-					out,
-					width: host.settings().renderWidth
-				}, 5e4);
-				const ref = await host.saveImage(await readFile(out), `${kind}-${result.what.replace(/[^\w一-龥]+/g, "-")}.png`);
-				return {
-					text: `${APP_NAMES[kind]} ${result.what}, ${result.width}×${result.height}.`,
-					image: toJson(ref)
-				};
-			} finally {
-				await rm(out, { force: true });
-			}
+			const { doc: _doc, app: _app, to, page: _page, slide: _slide, ...rest } = input;
+			const first = kind === "word" ? input.page ?? 1 : kind === "ppt" ? input.slide : 0;
+			const last = kind === "excel" || to === void 0 ? first : Math.min(Math.max(to, first), first + 3);
+			const { lines, images } = await picture(on, first, last, rest, host.settings().renderWidth);
+			unseen.delete(keyOf(on));
+			const [image, ...more] = images;
+			return {
+				text: lines.join("\n"),
+				...image === void 0 ? {} : { image },
+				...more.length ? { more } : {}
+			};
 		},
 		presentCall: (args) => card(`查看 ${fileName(args.doc) || "当前文档"} 的排版`)
 	}));
 	tools.push(defineTool({
 		name: "office_save",
-		description: "Save the open document. With path: save a copy under another name or format (.pdf exports a PDF and keeps the document as it is; other extensions switch the document to the new file).",
+		description: "Save the open document; if you have edited since you last looked at it, the reply also shows you its pages for a final check. With path: save a copy under another name or format (.pdf exports a PDF and keeps the document as it is; other extensions switch the document to the new file).",
 		parameters: {
 			doc: DOC,
 			app: APP,
@@ -6311,14 +6403,37 @@ function createTools(host) {
 		},
 		output,
 		timeoutMs: 12e4,
-		async execute(args) {
+		async execute(args, exec) {
 			const input = args;
 			if (input.path !== void 0 && !isAbsolute(input.path)) throw new Error("path must be an absolute path.");
+			const on = target(input);
 			const result = await helper.call("save", {
-				...target(input),
+				...on,
 				...input.path === void 0 ? {} : { path: input.path }
 			}, 11e4);
-			return { text: `Saved ${result.path} (${result.bytes} bytes).` };
+			const moved = input.path !== void 0 && extname(input.path).toLowerCase() !== ".pdf";
+			const wasUnseen = unseen.delete(keyOf(on));
+			if (moved) current = {
+				app: on.app,
+				doc: result.path
+			};
+			const text = `Saved ${result.path} (${result.bytes} bytes).${moved ? " The open document is now this file." : ""}`;
+			if (!wasUnseen || !host.settings().finalCheck || !await host.vision(exec)) return { text };
+			try {
+				const now = moved ? {
+					app: on.app,
+					doc: result.path
+				} : on;
+				const shown = await picture(now, 1, on.app === "excel" ? 1 : 8, {}, Math.min(host.settings().renderWidth, 800));
+				const [image, ...more] = shown.images;
+				return {
+					text: `${text}\nFinal check: you edited after you last looked at the document, so here is ${on.app === "excel" ? "the sheet" : `${shown.images.length}${shown.total !== void 0 && shown.total > shown.images.length ? ` of ${shown.total}` : ""} ${on.app === "word" ? "page(s)" : "slide(s)"}`} as it is now. Go through every picture before you tell the user it is done. If anything is off (content outside its frame, uneven fonts or spacing, formulas as plain text, bad tables, leftover hints, blank gaps), fix it with office_edit and save again; if all is well, say so.`,
+					...image === void 0 ? {} : { image },
+					...more.length ? { more } : {}
+				};
+			} catch {
+				return { text };
+			}
 		},
 		presentCall: (args) => card(`保存 ${fileName(args.path ?? args.doc) || "当前文档"}`)
 	}));
@@ -6330,6 +6445,26 @@ const name = "@copylee/dsh-office";
 const inject = ["tools", "attachments"];
 const STATUS_ROUTE = "/api/dsh-office/status";
 const Config = z.object({
+	follow: z.boolean().default(true).volatile().i18n({
+		"zh-CN": { $description: "跟随 AI 正在修改的位置（自动滚动到那里）；关闭为静默执行，不动你的视图" },
+		"en-US": { $description: "Scroll to where the AI is editing; off = silent, your view is left alone" }
+	}),
+	typing: z.boolean().default(true).volatile().i18n({
+		"zh-CN": { $description: "文字像打字一样逐步写出，而不是整块出现（每段最多约 1 秒）" },
+		"en-US": { $description: "Write text progressively like typing instead of all at once (about a second per paragraph at most)" }
+	}),
+	card: z.boolean().default(true).volatile().i18n({
+		"zh-CN": { $description: "AI 编辑时在屏幕右下角显示迷你卡片，可随时开关“跟随”和“逐字”" },
+		"en-US": { $description: "Show a small card at the bottom right while the AI edits, with switches for following and typing" }
+	}),
+	finalCheck: z.boolean().default(true).volatile().i18n({
+		"zh-CN": { $description: "交付前整体视觉检查：保存时如果 AI 改完后还没看过成品，自动把各页渲染成图片给它检查" },
+		"en-US": { $description: "Whole-document visual check: on save, show the AI every page if it has not looked since its last edits" }
+	}),
+	preferLive: z.boolean().default(true).volatile().i18n({
+		"zh-CN": { $description: "优先在真实 Office 里操作：AI 想加载 DSH 自带的 office-docx / xlsx / pptx 技能（用脚本改文件）时，先把它引回本插件" },
+		"en-US": { $description: "Prefer the real Office app: when the AI reaches for the host's file-based office skills, point it back to this plugin first" }
+	}),
 	showOnOpen: z.boolean().default(true).volatile().i18n({
 		"zh-CN": { $description: "打开文档时把它的窗口带到前台" },
 		"en-US": { $description: "Bring the document window to the front when it is opened" }
@@ -6379,6 +6514,28 @@ function apply(ctx, config = {}) {
 		}
 	});
 	for (const tool of tools) ctx.effect(() => ctx.tools.register(tool), `office: tool ${tool.name}`);
+	let installed;
+	const installedApps = () => {
+		installed ??= helper.call("status", {}, 3e4).then((apps) => new Set(apps.filter((app) => app.installed).map((app) => app.app))).catch(() => {
+			installed = void 0;
+			return /* @__PURE__ */ new Set();
+		});
+		return installed;
+	};
+	const redirected = /* @__PURE__ */ new Set();
+	ctx.on("tools/pre-execute", async (exec, next) => {
+		if (exec.name !== "skill" || !settings().preferLive) return next();
+		const skill = String(exec.arguments?.name ?? "");
+		const app = FILE_SKILLS[skill];
+		if (app === void 0) return next();
+		const key = `${exec.agent?.session?.id ?? "default"}:${skill}`;
+		if (redirected.has(key) || !(await installedApps()).has(app)) return next();
+		redirected.add(key);
+		return {
+			kind: "deny",
+			reason: redirectText(skill, app)
+		};
+	});
 	ctx.inject(["webServer"], (webCtx) => {
 		const handler = async (_req, res) => {
 			let body;

package/lib/types/format.d.ts

@@ -29,6 +29,8 @@ export interface WordItem {
     to?: number;
     table?: number;
     size?: string;
+    open?: boolean;
+    inTable?: boolean;
 }
 export interface WordRead {
     paragraphs: number;

package/lib/types/index.d.ts

@@ -5,6 +5,11 @@ export declare const name = "@copylee/dsh-office";
 export declare const inject: string[];
 export declare const STATUS_ROUTE = "/api/dsh-office/status";
 export interface Config {
+    follow?: boolean;
+    typing?: boolean;
+    card?: boolean;
+    finalCheck?: boolean;
+    preferLive?: boolean;
     showOnOpen?: boolean;
     renderWidth?: number;
 }