finch-markdown-editor 0.1.8 → 0.1.9

package/dist/panel.html

@@ -69,6 +69,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
 .doc-title{font-size:13px;font-weight:600;line-height:1.35;color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .doc-sub{margin-top:2px;display:flex;gap:6px;font-size:11px;line-height:1.4;color:var(--muted)}
 .doc-sub .doc-path{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;direction:rtl;text-align:left}
+.doc-sub .doc-path.absolute-path{direction:ltr}
 .doc-sub .doc-time{flex:none;opacity:.8}
 .doc-reveal{position:absolute;top:6px;right:6px;z-index:1;display:flex;align-items:center;justify-content:center;width:24px;height:24px;padding:0;border:none;border-radius:7px;background:color-mix(in srgb, var(--bg) 72%, transparent);color:var(--muted);cursor:pointer;opacity:0;transition:opacity .12s ease,background .12s ease,color .12s ease}
 .doc-reveal svg{width:14px;height:14px}
@@ -80,6 +81,20 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
 .status a{color:var(--accent);text-decoration:underline;text-underline-offset:2px;cursor:pointer}
 .status.error{color:#c54232}
 .status:empty{padding:0;border-top:0}
+/* Lines an external revision (AI apply, or an on-disk edit) just rewrote.
+   The decoration is dropped again after the animation, so the highlight is
+   purely transient — it marks the change without leaving the doc annotated.
+   It eases in rather than appearing at full strength, and leaves a thin
+   change-bar on the left the way a diff view would, so the eye reads it as
+   "this got rewritten" instead of a highlighter pen being slapped down. */
+.cm-line.cm-ai-changed{border-radius:6px;animation:ai-edit-flash 1.9s cubic-bezier(.33,0,.2,1) both}
+@keyframes ai-edit-flash{
+  0%{background:transparent;box-shadow:inset 2px 0 0 transparent}
+  26%{background:color-mix(in srgb,var(--accent) 13%,transparent);box-shadow:inset 2px 0 0 color-mix(in srgb,var(--accent) 52%,transparent)}
+  55%{background:color-mix(in srgb,var(--accent) 11%,transparent);box-shadow:inset 2px 0 0 color-mix(in srgb,var(--accent) 44%,transparent)}
+  100%{background:transparent;box-shadow:inset 2px 0 0 transparent}
+}
+@media (prefers-reduced-motion:reduce){.cm-line.cm-ai-changed{animation:none;background:transparent;box-shadow:none}}
 .popup{position:fixed;z-index:20;display:flex;align-items:center;gap:6px;background:var(--card);border:1px solid var(--border);border-radius:9px;box-shadow:0 8px 22px rgba(0,0,0,.22);padding:5px;transform-origin:center bottom;animation:popup-in .18s cubic-bezier(.2,.8,.2,1)}
 .popup.hidden{display:none}
 @keyframes popup-in{from{opacity:0;transform:translateY(5px) scale(.98)}to{opacity:1;transform:translateY(0) scale(1)}}
@@ -247,6 +262,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'home.revealInFileManager': '在文件管理器中定位',
       'home.emptyDoc': '（空文档）',
       'home.cwdTitle': '在访达 / 文件资源管理器中打开：{path}',
+      'home.cwdFallback': 'homePath（无 cwd 回退）',
       'home.today': '今天 {clock}',
       'home.yesterday': '昨天 {clock}',
       'editor.ariaLabel': '写字编辑器',
@@ -278,6 +294,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'toolbar.mode.label': '预览',
       'toolbar.mode.tooltipToPreview': '切换到预览',
       'toolbar.mode.tooltipToEdit': '切换到编辑',
+      'toolbar.mode.tooltipRendering': '正在渲染预览…',
       'toolbar.style.tooltip': '排版风格',
       'toolbar.style.tooltipNeedsPreview': '请先切换到预览',
       'toolbar.style.customSlot': '自定义风格 {n} · {label}',
@@ -303,20 +320,20 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'annotate.requirementWith': '要求：{comment}',
       'annotate.requirementDefault': '让表达更清晰',
       'annotate.pathMissing': '（未关联本地文件，请先粘贴/保存全部内容）',
-      'annotate.promptText': '请改写这段 Markdown 内容（位置：{lineLabel}），{requirement}：\n\n{text}\n\n给出可直接替换的片段；我确认后调用 markdown_editor_document 的 apply 动作，用更新后的完整内容覆盖源文件（path={path}）。',
-      'annotate.reminder': '仅给出改写建议，不要在未确认前直接写入源文件。',
+      'annotate.promptText': '请改写这段 Markdown 内容（位置：{lineLabel}），{requirement}：\n\n{text}\n\n先给出可直接替换的片段；我确认后，用针对这一段的局部替换写回源文件（{path}），不用重发全文。',
+      'annotate.reminder': '仅给出改写建议，不要在未确认前直接写入源文件。回复用自然的说法（如“确认后我就改到文件里”），不要提工具名或动作名。【强制要求，不可省略】只要本回合给出了改写建议并等我确认，就必须在回复文本之后、本回合结束前调用一次 Session action=suggest，附上 1–3 个一键确认选项（如“就用这版”“用更短的那版”“再换个语气”）。只写完回复文字、不调用 suggest，视为任务未完成——“把方案写给用户看”和“让用户能一键确认”是同一个任务的两半，缺一不可，不要因为文字已给完就认为确认环节已经处理完毕。',
       'newdoc.needChat': '请在 Finch 对话中使用“新建文档”。',
       'newdoc.label': '新建 Markdown 文档',
-      'newdoc.promptText': '我想新建一篇 Markdown 文档。请先根据我的要求确定标题、内容与一个尚不存在的绝对保存路径；信息不足时先问我。确认后调用 markdown_editor_document 的 create 动作，传入完整 Markdown 正文和绝对 path，并在编辑器中打开新文件。',
-      'newdoc.reminder': '新建文件时必须使用 markdown_editor_document 的 create 动作；不要覆盖已有文件。',
+      'newdoc.promptText': '我想新建一篇 Markdown 文档。请先根据我的要求确定标题、内容与一个尚不存在的绝对保存路径；信息不足时先问我。确认后把完整正文写入那个路径，并在编辑器中打开这篇新文档。',
+      'newdoc.reminder': '只能新建文件，不要覆盖已有文件。回复用自然的说法，不要提工具名或动作名。【强制要求，不可省略】只要本回合需要我确认标题、方向或保存位置，就必须在回合结束前调用一次 Session action=suggest，给出 1–3 个一键选项，不要让我手打。光在文字里问问题而不调 suggest，视为这次询问没完成。',
       'newdoc.added': '已把新建文档引导加入输入框。',
       'aiStyle.label': '根据 {file} 设计风格',
       'aiStyle.note': 'AI 一键排版',
       'aiStyle.baseNoteCustom': '当前基础风格是 kami（自定义 CSS 叠加其上）',
       'aiStyle.baseNoteOther': '当前基础风格是 {style}',
       'aiStyle.pathMissing': '（未关联本地文件）',
-      'aiStyle.promptText': '请为这篇公众号文章设计一套自定义排版 CSS。{baseNote}，你的 CSS 会叠加在基础风格之上。要求：只写普通 CSS 规则，选择器限定在 #bm-md 下的标签/结构（如 #bm-md h1、#bm-md p、#bm-md blockquote、#bm-md pre code、#bm-md a、#bm-md strong、#bm-md table 等），不要使用 class（bm.md 输出没有 class，只有内联样式），必要时用 !important 覆盖基础风格。可参考 bm.md 内置风格的设计语言：kami（暖色纸感）、bauhaus（几何撞色）、blueprint（技术蓝图网格）、botanical（清新绿意）、newsprint（报刊衬线）、retro（复古怀旧）、sketch（手绘风）、terminal（等宽暗色终端风）。文章路径：{path}。动手生成 CSS 前，先询问用户要覆盖「自定义风格 1、2、3」中的哪一个槽位；用户选择后，再调用 markdown_editor_document 的 set_style，必须传入 css、简短 label 和 slot（1/2/3）。该调用会覆盖并持久化那个槽位，同时立即应用预览。',
-      'aiStyle.reminder': '必须先询问槽位，不能自行猜测或覆盖；用户明确选定 1/2/3 后才调用 set_style。',
+      'aiStyle.promptText': '请为这篇公众号文章设计一套自定义排版 CSS。{baseNote}，你的 CSS 会叠加在基础风格之上。要求：只写普通 CSS 规则，选择器限定在 #bm-md 下的标签/结构（如 #bm-md h1、#bm-md p、#bm-md blockquote、#bm-md pre code、#bm-md a、#bm-md strong、#bm-md table 等），不要使用 class（bm.md 输出没有 class，只有内联样式），必要时用 !important 覆盖基础风格。可参考 bm.md 内置风格的设计语言：kami（暖色纸感）、bauhaus（几何撞色）、blueprint（技术蓝图网格）、botanical（清新绿意）、newsprint（报刊衬线）、retro（复古怀旧）、sketch（手绘风）、terminal（等宽暗色终端风）。文章路径：{path}。动手生成 CSS 前，先询问用户要覆盖「自定义风格 1、2、3」中的哪一个槽位；用户选择后，再把设计好的 CSS 应用到那个槽位（需要 css、简短标签和槽位编号 1/2/3）。这会覆盖并持久化那个槽位，同时立即应用到预览。',
+      'aiStyle.reminder': '必须先询问槽位，不能自行猜测或覆盖；用户明确选定 1/2/3 后才应用。回复用自然的说法，不要提工具名或动作名。【强制要求，不可省略】询问槽位时必须在回合结束前调用一次 Session action=suggest，给出“用自定义风格 1/2/3”三个一键选项，不要让我手打。只在文字里问选哪个槽位、不调 suggest，视为询问未完成。',
       'aiStyle.requested': '已请求 AI 设计自定义排版。',
       'status.saved': '已保存。',
       'status.savedWithNewChanges': '已保存，编辑器中仍有新改动。',
@@ -333,6 +350,9 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'status.opening': '正在打开…',
       'status.opened': '已打开 {file}。',
       'status.contentUpdated': '内容已更新。',
+      'status.contentUpdatedLine': '已更新第 {line} 行。',
+      'status.contentUpdatedLines': '已更新第 {from}–{to} 行。',
+      'status.contentUpdatedSpots': '已更新 {count} 处，共 {lines} 行。',
       'status.pasteImageTimeout': '粘贴图片超时',
       'status.pasteImageFailed': '粘贴图片失败：{msg}',
       'status.clipboardPrepareTimeout': '准备公众号图片超时',
@@ -364,7 +384,6 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'status.appliedStyleSlot': '已应用「{label}」。',
       'status.needCustomStyleFirst': '请先应用一个自定义/AI 设计的风格，再保存到槽位。',
       'status.savedToSlot': '已保存到槽位 {slot}：{label}',
-      'status.rendering': '正在渲染…',
       'status.serializeFailed': '无法序列化预览内容：{err}',
       'status.imageConversionFailed': '预览内容无法转成图片（可能含有无法跨域读取的外部图片）',
       'status.imageGenFailed': '生成图片数据失败',
@@ -386,6 +405,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'home.revealInFileManager': 'Show in file manager',
       'home.emptyDoc': '(Empty document)',
       'home.cwdTitle': 'Open in Finder / File Explorer: {path}',
+      'home.cwdFallback': 'homePath (no-cwd fallback)',
       'home.today': 'Today {clock}',
       'home.yesterday': 'Yesterday {clock}',
       'editor.ariaLabel': 'Writing editor',
@@ -417,6 +437,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'toolbar.mode.label': 'Preview',
       'toolbar.mode.tooltipToPreview': 'Switch to preview',
       'toolbar.mode.tooltipToEdit': 'Switch to edit',
+      'toolbar.mode.tooltipRendering': 'Rendering preview…',
       'toolbar.style.tooltip': 'Layout style',
       'toolbar.style.tooltipNeedsPreview': 'Switch to preview first',
       'toolbar.style.customSlot': 'Custom style {n} · {label}',
@@ -442,20 +463,20 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'annotate.requirementWith': 'Requirement: {comment}',
       'annotate.requirementDefault': 'make the wording clearer',
       'annotate.pathMissing': '(No local file linked — ask me to paste/save the full text first)',
-      'annotate.promptText': 'Please rewrite this Markdown passage (location: {lineLabel}), {requirement}:\n\n{text}\n\nGive a drop-in replacement snippet; once I confirm, call markdown_editor_document\u2019s apply action to overwrite the source file (path={path}) with the updated content.',
-      'annotate.reminder': "Only propose the rewrite — don't write to the source file before I confirm.",
+      'annotate.promptText': 'Please rewrite this Markdown passage (location: {lineLabel}), {requirement}:\n\n{text}\n\nGive a drop-in replacement snippet first; once I confirm, write it back to the source file ({path}) as a targeted local replacement, not a full resend of the document.',
+      'annotate.reminder': "Only propose the rewrite — don't write to the source file before I confirm. Reply in natural language (e.g. “I'll put it into the file once you confirm”); never name the tool or its actions. [MANDATORY, not optional] Whenever this turn proposes a rewrite and is waiting on my confirmation, calling Session action=suggest with 1–3 one-tap confirmations (e.g. “Use this one”, “Use the shorter version”, “Try another tone”) is part of completing that same turn — writing the proposal text is only half the job. Do not treat the turn as done, and do not skip the call, just because the proposal text itself was already sent.",
       'newdoc.needChat': 'Use \u201cNew Document\u201d from the Finch chat instead.',
       'newdoc.label': 'New Markdown Document',
-      'newdoc.promptText': "I want to create a new Markdown document. First work out the title, content, and a not-yet-existing absolute save path from my request — ask me first if anything is missing. Once confirmed, call markdown_editor_document's create action with the full Markdown body and absolute path to write and open the new file.",
-      'newdoc.reminder': "Always use markdown_editor_document's create action for new files; never overwrite an existing file.",
+      'newdoc.promptText': 'I want to create a new Markdown document. First work out the title, content, and a not-yet-existing absolute save path from my request — ask me first if anything is missing. Once confirmed, write the full body to that path and open the new document in the editor.',
+      'newdoc.reminder': 'Only create a new file; never overwrite an existing one. Reply in natural language and never name the tool or its actions. [MANDATORY, not optional] Whenever this turn ends still waiting on me to confirm a title, an angle, or a save location, it must call Session action=suggest with 1–3 one-tap options before the turn ends — asking the question in plain text is not enough on its own; skipping the call leaves the question unfinished.',
       'newdoc.added': 'Added the new-document prompt to the composer.',
       'aiStyle.label': 'Design a layout based on {file}',
       'aiStyle.note': 'One-click AI layout',
       'aiStyle.baseNoteCustom': 'The current base style is kami (your custom CSS layers on top of it)',
       'aiStyle.baseNoteOther': 'The current base style is {style}',
       'aiStyle.pathMissing': '(No local file linked)',
-      'aiStyle.promptText': 'Please design a custom layout CSS for this WeChat article. {baseNote}, and your CSS will layer on top of the base style. Requirements: write plain CSS rules only, with selectors scoped to tags/structure under #bm-md (e.g. #bm-md h1, #bm-md p, #bm-md blockquote, #bm-md pre code, #bm-md a, #bm-md strong, #bm-md table); don\u2019t use classes (bm.md\u2019s output has no classes, only inline styles), and use !important where needed to override the base style. You can draw on bm.md\u2019s built-in style language: kami (warm paper feel), bauhaus (geometric color-blocking), blueprint (technical grid), botanical (fresh green), newsprint (editorial serif), retro (nostalgic), sketch (hand-drawn), terminal (monospace dark). Article path: {path}. Before generating any CSS, ask the user which of \u201cCustom style 1/2/3\u201d slots to overwrite; once they choose, call markdown_editor_document\u2019s set_style with css, a short label, and slot (1/2/3). That call overwrites and persists that slot and applies it to the preview immediately.',
-      'aiStyle.reminder': "Always ask which slot first — never guess or overwrite on your own; call set_style only after the user picks 1/2/3.",
+      'aiStyle.promptText': 'Please design a custom layout CSS for this WeChat article. {baseNote}, and your CSS will layer on top of the base style. Requirements: write plain CSS rules only, with selectors scoped to tags/structure under #bm-md (e.g. #bm-md h1, #bm-md p, #bm-md blockquote, #bm-md pre code, #bm-md a, #bm-md strong, #bm-md table); don\u2019t use classes (bm.md\u2019s output has no classes, only inline styles), and use !important where needed to override the base style. You can draw on bm.md\u2019s built-in style language: kami (warm paper feel), bauhaus (geometric color-blocking), blueprint (technical grid), botanical (fresh green), newsprint (editorial serif), retro (nostalgic), sketch (hand-drawn), terminal (monospace dark). Article path: {path}. Before generating any CSS, ask the user which of \u201cCustom style 1/2/3\u201d slots to overwrite; once they choose, apply the CSS you designed to that slot (it needs the css, a short label, and the slot number 1/2/3). That overwrites and persists the slot and applies it to the preview immediately.',
+      'aiStyle.reminder': 'Always ask which slot first — never guess or overwrite on your own; apply it only after the user picks 1/2/3. Reply in natural language and never name the tool or its actions. [MANDATORY, not optional] Asking which slot must always be paired with calling Session action=suggest (“Use custom style 1/2/3” as one-tap options) before the turn ends — the question is not considered asked until that call happens, not merely the text of the question.',
       'aiStyle.requested': 'Asked AI to design a custom layout.',
       'status.saved': 'Saved.',
       'status.savedWithNewChanges': "Saved — but the editor already has newer changes.",
@@ -472,6 +493,9 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'status.opening': 'Opening…',
       'status.opened': 'Opened {file}.',
       'status.contentUpdated': 'Content updated.',
+      'status.contentUpdatedLine': 'Updated line {line}.',
+      'status.contentUpdatedLines': 'Updated lines {from}\u2013{to}.',
+      'status.contentUpdatedSpots': 'Updated {count} spots, {lines} lines in total.',
       'status.pasteImageTimeout': 'Paste image timed out',
       'status.pasteImageFailed': 'Paste image failed: {msg}',
       'status.clipboardPrepareTimeout': 'Preparing WeChat images timed out',
@@ -503,7 +527,6 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       'status.appliedStyleSlot': 'Applied \u201c{label}\u201d.',
       'status.needCustomStyleFirst': 'Apply a custom/AI-designed style first before saving it to a slot.',
       'status.savedToSlot': 'Saved to slot {slot}: {label}',
-      'status.rendering': 'Rendering…',
       'status.serializeFailed': 'Failed to serialize the preview content: {err}',
       'status.imageConversionFailed': "The preview couldn't be converted to an image (it may contain external images that can't be read cross-origin)",
       'status.imageGenFailed': 'Failed to generate image data',
@@ -621,6 +644,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
   var html = '';
   var frameReady = false;
   var renderId = 0;
+  var renderingPreview = false;
   var saveId = 0;
   var pendingSaveContents = {};
   // Resolvers for callers that need to *await* a save round-trip (the
@@ -699,6 +723,14 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
   // the backend scopes its recent-file list to whatever we hand back, so a
   // panel in another Space never shows this Space's documents.
   var envCwd = '';
+  var envSessionId = '';
+  var envSpaceId = '';
+  var fallbackCwd = '';
+  // Some Home views arrive without cwd/session. The backend may return the
+  // persisted ordinary-chat homePath as `fallbackCwd`, so empty envCwd must
+  // not block the request. Only "no `finch:env` yet" should, which this
+  // separate flag tracks instead of overloading envCwd.
+  var envReceived = false;
   var recentRequested = false;
   var assistantName = '';
   var homeDir = '';
@@ -758,14 +790,19 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
 
   function renderHomeCwd() {
     if (!homeCwd) return;
-    homeCwd.textContent = truncateFriendlyPath(formatFriendlyPath(envCwd));
-    homeCwd.title = envCwd ? t('home.cwdTitle', { path: envCwd }) : '';
-    homeCwd.hidden = !envCwd;
+    // `fallbackCwd` is the persisted real cwd from an ordinary no-Space
+    // Session, not a virtual filesystem path. It makes the Home view and
+    // that Session share exactly one recent-document scope.
+    var effectiveCwd = envCwd || fallbackCwd;
+    homeCwd.textContent = truncateFriendlyPath(formatFriendlyPath(effectiveCwd));
+    homeCwd.title = effectiveCwd ? t('home.cwdTitle', { path: effectiveCwd }) : '';
+    homeCwd.hidden = !effectiveCwd;
   }
 
   if (homeCwd) homeCwd.addEventListener('click', function () {
-    if (!envCwd || !api || !api.postMessage) return;
-    api.postMessage({ type: 'openPath', path: envCwd });
+    var effectiveCwd = envCwd || fallbackCwd;
+    if (!effectiveCwd || !api || !api.postMessage) return;
+    api.postMessage({ type: 'openPath', path: effectiveCwd });
   });
 
   function formatDocTime(ts) {
@@ -783,9 +820,9 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
   }
 
   function requestRecentDocuments() {
-    if (!api || !api.postMessage || !envCwd) return;
+    if (!api || !api.postMessage || !envReceived) return;
     recentRequested = true;
-    api.postMessage({ type: 'requestRecentDocuments', cwd: envCwd });
+    api.postMessage({ type: 'requestRecentDocuments', cwd: envCwd, sessionId: envSessionId, spaceId: envSpaceId });
   }
 
   function renderRecentDocuments(documents) {
@@ -802,6 +839,11 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
     var cards = '';
     for (var i = 0; i < list.length; i++) {
       var doc = list[i] || {};
+      // Under the virtual homePath scope relativePath is necessarily an
+      // absolute path. The normal RTL tail-truncation presentation would
+      // visually move its leading '/' to the far right, so keep it LTR.
+      var docPath = doc.relativePath || doc.fileName || '';
+      var docPathClass = /^(\/|[A-Za-z]:[\\/])/.test(docPath) ? 'doc-path absolute-path' : 'doc-path';
       cards += '<button class="doc-card" type="button" data-path="' + escapeHtml(doc.path || '') + '" title="' + escapeHtml(doc.path || '') + '">'
         + '<span class="doc-reveal" data-reveal-path="' + escapeHtml(doc.path || '') + '" role="button" tabindex="0" title="' + escapeHtml(t('home.revealInFileManager')) + '" aria-label="' + escapeHtml(t('home.revealInFileManager')) + '">'
         + '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m6 14 1.45-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.55 6a2 2 0 0 1-1.94 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2"/></svg>'
@@ -809,7 +851,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         + '<div class="doc-preview">' + escapeHtml(doc.preview || t('home.emptyDoc')) + '</div>'
         + '<div class="doc-foot">'
         + '<div class="doc-title">' + escapeHtml(doc.title || doc.fileName || t('home.untitled')) + '</div>'
-        + '<div class="doc-sub"><span class="doc-path">' + escapeHtml(doc.relativePath || doc.fileName || '') + '</span>'
+        + '<div class="doc-sub"><span class="' + docPathClass + '">' + escapeHtml(docPath) + '</span>'
         + '<span class="doc-time">' + escapeHtml(formatDocTime(doc.modifiedAt)) + '</span></div>'
         + '</div></button>';
     }
@@ -860,7 +902,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
     if (actions) actions.hidden = !html;
     // Refresh whenever the home page comes back into view: mtimes change while
     // a document is open, and a file may have been created since last render.
-    if (!empty.hidden && envCwd) requestRecentDocuments();
+    if (!empty.hidden && envReceived) requestRecentDocuments();
   }
 
   function showPane() {
@@ -945,8 +987,8 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         // icon plus `checked` already communicate on/off; flipping the word
         // itself between "预览"/"编辑" read as ambiguous ("is this the mode
         // I'm in, or the one I'm switching to?").
-        id: 'mode', icon: 'ext:markdown-editor-icons/swatch-book',
-        label: t('toolbar.mode.label'), tooltip: hasDoc ? (mode === 'edit' ? t('toolbar.mode.tooltipToPreview') : t('toolbar.mode.tooltipToEdit')) : t('toolbar.needDoc'),
+        id: 'mode', icon: renderingPreview ? 'ext:markdown-editor-icons/hourglass' : 'ext:markdown-editor-icons/swatch-book',
+        label: t('toolbar.mode.label'), tooltip: hasDoc ? (renderingPreview ? t('toolbar.mode.tooltipRendering') : mode === 'edit' ? t('toolbar.mode.tooltipToPreview') : t('toolbar.mode.tooltipToEdit')) : t('toolbar.needDoc'),
         checked: mode === 'preview', disabled: !hasDoc,
       },
       {
@@ -1079,7 +1121,8 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
   function render() {
     if (!markdown || !api) return;
     var id = ++renderId;
-    setStatus(t('status.rendering'));
+    renderingPreview = true;
+    syncToolbar();
     api.postMessage({
       type: 'renderBm',
       markdown: markdown,
@@ -1565,6 +1608,10 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
     fileHandle = null;
   }
 
+  // Line range touched by the most recent in-place external revision, so the
+  // status line can say *what* moved instead of just "content updated".
+  var lastExternalChange = null;
+
   function applyDocument(nextMarkdown, nextName, nextPath, force, diskBaseline) {
     // Deliberately does NOT check cm.hasFocus(): unsaved local edits must
     // never be silently clobbered by an external update, whether or not the
@@ -1575,6 +1622,10 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       setStatus(t('status.externalUpdateSkipped'), true);
       return false;
     }
+    // Is this a revision of the document already on screen (an AI apply, or
+    // an external save), rather than a switch to a different file? Must be
+    // decided before `sourcePath` is reassigned below.
+    var revisesOpenDocument = savedMarkdown !== null && (!nextPath || !sourcePath || nextPath === sourcePath);
     markdown = nextMarkdown;
     name = nextName;
     if (nextPath) sourcePath = nextPath;
@@ -1588,7 +1639,11 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
     // content sitting unchanged at the real baseline and wrongly report
     // an external-edit conflict that never happened.
     savedMarkdown = typeof diskBaseline === 'string' ? diskBaseline : markdown;
-    cm.setValue(markdown);
+    // Patching only the changed span keeps the scroll offset and the caret
+    // where the user left them, and flashes the rewritten lines. A fresh
+    // document still gets the plain full replacement.
+    lastExternalChange = revisesOpenDocument ? cm.applyExternalValue(markdown) : null;
+    if (!lastExternalChange) cm.setValue(markdown);
     setDirty(false); // also rebuilds+syncs the whole toolbar, picking up the new sourcePath/fileName below
     setPanelTitle(fileName);
     updateEmptyState();
@@ -2457,8 +2512,14 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         // Panel scope changed (first open, or Home → Session relocation): rescope
         // the recent list to this panel's own working directory.
         var incomingCwd = m.cwd || '';
-        if (incomingCwd !== envCwd) {
+        var incomingSessionId = m.sessionId || '';
+        var incomingSpaceId = m.spaceId || '';
+        if (incomingCwd !== envCwd || incomingSessionId !== envSessionId || incomingSpaceId !== envSpaceId || !envReceived) {
           envCwd = incomingCwd;
+          envSessionId = incomingSessionId;
+          envSpaceId = incomingSpaceId;
+          fallbackCwd = '';
+          envReceived = true;
           renderHomeCwd();
           renderRecentDocuments([]);
         }
@@ -2468,6 +2529,8 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
       if (m.type === 'recentDocuments') {
         // Ignore a late reply for a directory we no longer belong to.
         if ((m.cwd || '') !== envCwd) return;
+        fallbackCwd = m.fallbackCwd || '';
+        renderHomeCwd();
         renderRecentDocuments(m.documents);
         return;
       }
@@ -2511,7 +2574,16 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         } else if (wasLoadingFromHome) {
           setStatus(t('status.opened', { file: fileName }));
         } else if (!isFirst) {
-          setStatus(t('status.contentUpdated'));
+          var touched = lastExternalChange;
+          if (touched && touched.hunks > 1) {
+            setStatus(t('status.contentUpdatedSpots', { count: touched.hunks, lines: touched.changedLines }));
+          } else if (touched && touched.fromLine === touched.toLine) {
+            setStatus(t('status.contentUpdatedLine', { line: touched.fromLine }));
+          } else if (touched) {
+            setStatus(t('status.contentUpdatedLines', { from: touched.fromLine, to: touched.toLine }));
+          } else {
+            setStatus(t('status.contentUpdated'));
+          }
         }
         return;
       }
@@ -2523,6 +2595,7 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         if (m.requestId !== renderId) return;
         showHtml(m.html || '');
         updateEmptyState();
+        renderingPreview = false;
         syncToolbar(); // `html` just became available (or changed) — refresh the copy menu's disabled state
         setStatus('');
         return;
@@ -2587,6 +2660,9 @@ body{margin:0;background:var(--bg);color:var(--text);font:13px var(--finch-font-
         nativePickPending = false;
         clearNativePickTimer();
         if (m.fallback) pickFileSupported = false;
+        // renderBm failures arrive through the same error channel; never
+        // leave the preview button stuck on the hourglass after one.
+        renderingPreview = false;
         syncToolbar();
         setStatus(m.message, true);
         return;

package/i18n/zh-CN.json

@@ -1,7 +1,7 @@
 {
   "name": "写字",
   "description": "在 Finch 中编辑 Markdown，并可预览为微信公众号文章样式；支持框选文字请求 AI 修改和自定义排版。",
-  "systemPrompt": "当用户要编辑或预览本地 Markdown 文件时，调用 markdown_editor_document，action 使用 open，并提供绝对路径。用户说“写文章”“开始写作”“写一篇”“写个帖子”或“起草内容”时，即使未提 Markdown，也视为要使用写字。新建文档时，若缺少标题/主题或保存位置，先引导用户补齐；信息足够后，调用 action=create，传入一个尚不存在的绝对 .md 路径和 Markdown 内容。用户提供了写作需求时，直接起草完整 Markdown；用户只想开始写作时，创建带标题的最小起稿文档。该工具会一次性写入文件并在 Markdown 编辑器中打开——用户要在编辑器开始写作时，不要只在聊天中返回一段文字。编辑器界面故意不提供“新建”按钮。当用户要修改编辑器或预览中框选的文字时，给出精确的替换 Markdown，确认后调用 action=apply 并提供完整更新后的 Markdown。当用户要求自定义/AI 设计公众号排版风格时，编写限定在 #bm-md 下的普通 CSS（标签/id 选择器，不用 class，必要时用 !important 覆盖基础风格），可参考 bm.md 内置风格（kami、bauhaus、blueprint、botanical、newsprint、retro、sketch、terminal），然后调用 action=set_style 并提供 css 与简短 label，会立即应用到当前打开的预览。",
+  "systemPrompt": "当用户要编辑或预览本地 Markdown 文件时，调用 markdown_editor_document，action 使用 open，并提供绝对路径。用户说“写文章”“开始写作”“写一篇”“写个帖子”或“起草内容”时，即使未提 Markdown，也视为要使用写字。新建文档时，若缺少标题/主题或保存位置，先引导用户补齐；信息足够后，调用 action=create，传入一个尚不存在的绝对 .md 路径和 Markdown 内容。用户提供了写作需求时，直接起草完整 Markdown；用户只想开始写作时，创建带标题的最小起稿文档。该工具会一次性写入文件并在 Markdown 编辑器中打开——用户要在编辑器开始写作时，不要只在聊天中返回一段文字。编辑器界面故意不提供“新建”按钮。当用户要修改编辑器或预览中框选的文字时，给出精确的替换 Markdown，确认后调用 action=apply——改动小的场合传 edits（一组针对文件当前内容的 {old_string, new_string} 局部替换），不要整篇重发；只有真正的全文重写才传完整的 markdown。一旦当前对话已通过写字开始编辑某个 Markdown 文件，后续对同一 .md 文件的所有修改都【必须优先】继续走写字的 apply/edits 路径，即使系统内置 Edit 也能完成同样的文字替换：这样才能让已打开的编辑器刷新并精准高亮改动。只有写字的 apply 实际失败后才退回系统内置 Edit；不能因为 Edit 看起来更短或更方便就切换。当用户要求自定义/AI 设计公众号排版风格时，编写限定在 #bm-md 下的普通 CSS（标签/id 选择器，不用 class，必要时用 !important 覆盖基础风格），可参考 bm.md 内置风格（kami、bauhaus、blueprint、botanical、newsprint、retro、sketch、terminal），然后调用 action=set_style 并提供 css 与简短 label，会立即应用到当前打开的预览。回复用户时，用用户能感知的说法（如“确认后我就改到文件里”“已在编辑器中打开”），不要出现工具名或 action 名——那是内部实现，照搬进回复会像在背 API。凡是给出改写方案、标题/路径或风格槽位后要等用户确认的场合，调用 Session action=suggest 给出 1-3 个可点击的简短确认项（如“就用这版”“用更短的那版”“再换个语气”）是【强制要求，不是可选项】——它和给出方案本身是同一个回合的两个必需部分，不是事后可以补的动作。不要因为方案文字已经写完、读起来像是一个完整的问句或提议，就认为确认这一步已经处理好了；只要没有实际调用 action=suggest，这个回合就还没完成。",
   "appPanel": {
     "title": "写字",
     "toolbar": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "finch-markdown-editor",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "A Markdown editor and WeChat Official Account style preview, with selection-based AI edits and AI-generated custom styles.",
   "author": {
     "name": "PuterJam",
@@ -36,7 +36,7 @@
     "minVersion": "1.6.1",
     "name": "Writing",
     "description": "Edit Markdown and preview it as a WeChat Official Account article. Select text for AI edits, or ask AI to design a custom style.",
-    "systemPrompt": "When the user wants to edit or preview a local Markdown file, call markdown_editor_document with action 'open' and its absolute path. Treat requests such as \"write an article\", \"start writing\", \"write a post\", or \"draft something\" as an intent to use Writing even when Markdown is not mentioned. For a new document, guide the user to supply a title/topic and destination when they are missing; once enough information is available, call action 'create' with a new absolute .md path and Markdown content. If the user supplied a writing brief, draft the full Markdown; if they only want to begin, create a minimal titled starter document. The tool writes the file and opens it in Markdown Editor in one step — do not merely return prose in chat when the user wants to begin writing in the editor. Markdown Editor's own UI intentionally has no 'new file' button. When the user asks to revise a passage selected in Markdown Editor, propose precise replacement Markdown and, once approved, call action 'apply' with the full updated Markdown. When the user asks for a custom/AI-designed WeChat layout style, write plain CSS scoped under #bm-md (tag/id selectors only, use !important where needed to override the base style) inspired by bm.md's built-in styles (kami, bauhaus, blueprint, botanical, newsprint, retro, sketch, terminal), then call action 'set_style' with that css and a short label — it applies immediately in the open preview.",
+    "systemPrompt": "When the user wants to edit or preview a local Markdown file, call markdown_editor_document with action 'open' and its absolute path. Treat requests such as \"write an article\", \"start writing\", \"write a post\", or \"draft something\" as an intent to use Writing even when Markdown is not mentioned. For a new document, guide the user to supply a title/topic and destination when they are missing; once enough information is available, call action 'create' with a new absolute .md path and Markdown content. If the user supplied a writing brief, draft the full Markdown; if they only want to begin, create a minimal titled starter document. The tool writes the file and opens it in Markdown Editor in one step — do not merely return prose in chat when the user wants to begin writing in the editor. Markdown Editor's own UI intentionally has no 'new file' button. When the user asks to revise a passage selected in Markdown Editor, propose precise replacement Markdown and, once approved, call action 'apply' — for a small change pass edits (an array of {old_string, new_string} targeted replacements matched against the file's current content) instead of resending the whole document; reserve the full markdown parameter for a genuine full rewrite. Once this conversation has started editing a Markdown document through Writing, ALL subsequent changes to that .md file MUST keep using Writing's apply/edits path first, even though the built-in Edit tool can make the same textual replacement: Writing refreshes the open editor and highlights exactly what changed. Use the built-in Edit tool only if Writing's apply actually fails, and do not switch merely because Edit appears shorter or more convenient. When the user asks for a custom/AI-designed WeChat layout style, write plain CSS scoped under #bm-md (tag/id selectors only, use !important where needed to override the base style) inspired by bm.md's built-in styles (kami, bauhaus, blueprint, botanical, newsprint, retro, sketch, terminal), then call action 'set_style' with that css and a short label — it applies immediately in the open preview. In your visible replies, describe this capability the way the user experiences it (\"I'll write it into the file\", \"opened it in the editor\"); never surface the tool name or its action names, which are internal plumbing — quoting them back makes the reply read like a machine reciting an API. Whenever you propose a rewrite, a title/path, or a style slot and then wait for the user's approval, calling Session action=suggest with 1-3 short click-to-send confirmations (e.g. 'Use this one', 'Use the shorter version', 'Try another tone') is MANDATORY, not optional — it is part of the same turn as the proposal, not a separate follow-up. Do not treat sending the proposal text as having finished the confirmation step; the turn is incomplete until action=suggest has actually been called, even if the wording already reads as a complete question or offer.",
     "main": "dist/index.js",
     "activationEvents": [
       "onStartup"