dsh-sidenote 0.7.2 → 0.7.3

package/README.md

@@ -23,9 +23,9 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-60708E" alt="MIT license"></a>
 </p>
 
-![新版浅色界面：左侧保留主对话，右侧深入讨论，结论回到主输入框](docs/assets/workflow.jpg)
+![划选文字后可添加到对话或在侧边提问；同屏展示侧聊回答、待发送的批注与回流标签，以及已发送消息中的上下文气泡](docs/assets/workflow.jpg)
 
-<p align="center"><sub>dsh-sidenote 0.6.0 · DSH 0.2.0-rc.2 · 原生侧栏 · 浅色主题</sub></p>
+<p align="center"><sub>dsh-sidenote 0.7.2 · DSH 0.2.1-rc.2 · DeepSeek V4.1 Flash · 真实交互录制</sub></p>
 
 ## 安装
 
@@ -51,7 +51,7 @@ dsh plugin --profile web add dsh-sidenote
 
 划选主对话或侧聊中的一段回复，写下问题或修改意见。**原文和注释一起保留**，可累积多条，发送前预览、移除，正文草稿照常编辑。
 
-读到「没有结果时，引导用户调整搜索词」，就选中这一句，追问「这里如何设计才不会让用户卡住？」。
+读到「提示“未找到”，并给出放宽条件建议」，就选中这一句，追问「给一版可直接使用的空状态」。
 
 ### 有结论，带回正在做的事
 
@@ -61,11 +61,11 @@ dsh plugin --profile web add dsh-sidenote
 
 **划选一句 → 带着上下文追问 → 把结论带回主线。**
 
-![浅色主题操作录屏：划选原文、添加问题、发送到侧边聊天、回流结论](docs/assets/demo.gif)
+![真实 Flash 演示：划选批注、悬浮查看与编辑、侧聊追问、图标回流，以及发送后的气泡内引用](docs/assets/demo.gif)
 
 [观看清晰版 MP4](docs/assets/demo.mp4) · [查看静态截图](docs/assets/workflow.jpg)
 
-<sub>以上素材重新录制于 dsh-sidenote 0.6.0 / DSH 0.2.0-rc.2。使用隔离环境中的示例对话与本地演示模型，展示真实界面操作；内容与回答为合成示例。</sub>
+<sub>2026-10-25 录制于 dsh-sidenote 0.7.2 / DSH 0.2.1-rc.2。以笔记搜索设计为例，真实调用官方 DeepSeek V4.1 Flash 生成回答；约 43 秒的录屏展示实际操作与完整回复过程。<a href="docs/assets/README.md">素材说明</a></sub>
 
 ## 用起来顺手的细节
 

package/docs/assets/README.md

@@ -1,23 +1,38 @@
-# README media / 首页素材
+# README and storefront media / 首页与商店素材
 
-The screenshots and recording used by the README were captured on **2026-10-18** with **dsh-sidenote 0.6.0** (source: `7ed85e4`) and **DSH 0.2.0-rc.2**, using the native right sidebar without better-sidebar. The host's active bundle inventory and the mounted plugin's build hash were checked before capture.
+Captured on **2026-10-25** with the published **dsh-sidenote 0.7.2** package (source: `0d55fcd`) and **DSH 0.2.1-rc.2**, using native Conversation and the native right sidebar. The mounted plugin's version and bundle digest, plus the host's active conversation, composer, and sidebar packages, were checked before capture.
 
-首页截图与录屏于 **2026-10-18** 重新采集，使用 **dsh-sidenote 0.6.0**（源码 `7ed85e4`）与 **DSH 0.2.0-rc.2** 原生右侧栏，不安装 better-sidebar。采集前核对了宿主实际激活的组件版本与插件构建摘要。
+素材于 **2026-10-25** 重新录制，使用已发布的 **dsh-sidenote 0.7.2**（源码 `0d55fcd`）与 **DSH 0.2.1-rc.2** 原生对话和右侧栏。录制前核对了实际挂载的插件版本与构建摘要，以及宿主正在运行的对话、输入框和侧栏组件版本。
 
-- `workflow.jpg`: the main and side conversations with a returned answer / 主、侧对话与回流结论。
-- `selection.jpg`: a selected passage and its note editor / 划选与注释编辑器。
-- `sidechat.jpg`: a completed side-chat response / 侧聊问答。
-- `demo.gif`, `demo.mp4`: the same continuous selection → annotation → side reply → reflow sequence / 同一段连续操作的 GIF 与 MP4。
-- `hero.svg`, `hero-en.svg` and their `-compact.svg` variants: original vector covers; regenerate with `python3 scripts/build-brand-assets.py` / 原创矢量封面，可用该命令重新生成。
+## Real model responses / 真实模型回答
 
-The host uses its **light theme** and a 16 px conversation font. Screenshots show the real interface; they are not UI mockups. The recording preserves browser frame timing. A browser translation extension's floating control was temporarily hidden during capture and restored afterwards. No DSH controls were altered.
+The example task is designing a note app's search experience. All assistant replies were generated through the official **DeepSeek V4.1 Flash** API at `api.deepseek.com`, using model ID `deepseek-flash` with thinking off. This ID's mapping is documented in the [official model updates](https://api-docs.deepseek.com/updates/). Request metadata confirmed successful, completed responses. No fixed-answer adapter or prewritten assistant messages were used.
 
-宿主使用**浅色主题**与 16 px 会话字号。截图来自真实界面，录屏保留浏览器帧的时间间隔。录制期间临时隐藏了浏览器翻译扩展的浮动控件，随后恢复；没有修改 DSH 控件。
+演示任务是设计笔记应用的搜索体验。全部助手回复都实际调用 `api.deepseek.com` 的 **DeepSeek V4.1 Flash** 生成，模型 ID 为 `deepseek-flash`，关闭思考模式；该 ID 的对应关系见[官方更新说明](https://api-docs.deepseek.com/updates/)。请求元数据确认调用成功并完成，没有使用固定回答的适配器或预先写入的助手消息。
 
-Conversation content is a synthetic note-search design example. A local demo adapter supplies fixed answers through the host's LLM interface; the fork, annotation, submission, and reflow paths are real. This illustrates the workflow, not model answer quality or latency. No private sessions or external model credentials are used.
+The recording starts with the real main-chat answer already visible. It then shows selection and annotation, a real side-chat response, hover previews, editing a pending note, the clear button's reveal, the reply-toolbar handback action, sending the main draft with both kinds of context, and inspecting the sent message. The main model's final answer incorporates the returned empty-state copy and the edited annotation.
 
-对话内容是合成的笔记搜索设计示例。本地演示模型通过宿主 LLM 接口提供固定回答；fork、注释、发送与回流均执行真实流程。素材用于说明操作，不代表模型回答质量或响应速度，也不使用私人会话或外部模型凭证。
+录屏从已经生成的主线回答开始，随后展示划选与批注、真实侧聊回答、悬浮预览、原位编辑、清除按钮显现、回复操作栏回流、携带两类上下文发送，以及发送后的气泡详情。主线最后的真实回答同时采纳了带回的空状态文案与修改后的批注。
 
-For future captures, use a fresh isolated DSH home and a verified host version, confirm the mounted bundle, select the light theme, and repeat the complete workflow. The older `capture-demo.mjs` and `capture-video.mjs` scripts target historical BS layouts and do not reproduce these native-sidebar assets unchanged.
+## Assets / 文件
 
-以后重录时，使用全新隔离的 DSH home 和已验证宿主版本，核对实际挂载构建，选择浅色主题，并走完完整流程。旧 `capture-demo.mjs`、`capture-video.mjs` 面向历史 BS 布局，不能原样用于复现这组原生侧栏素材。
+- `workflow.jpg`: a follow-up capture showing the selection toolbar's two destinations, a real side-chat answer, pending annotation and handback chips, and context bubbles in sent messages / 补拍主图：同屏展示划选菜单的两种去向、真实侧聊回答、待发送的批注与回流标签，以及已发送消息中的上下文气泡。
+- `context-preview.jpg`: a compact preview with the selected passage, editable note, and horizontal context chips / 紧凑悬浮层中的原文、可编辑注解与横向标签。
+- `selection.jpg`: selected text and the two annotation destinations, taken from the recording / 从录屏提取的划选画面与两种批注去向。
+- `sidechat.jpg`: a real side-chat answer and the hovered reply-toolbar handback icon / 真实侧聊回答与悬停中的回流图标。
+- `demo.gif`, `demo.mp4`: the same approximately **43-second** continuous workflow / 同一段约 **43 秒**的连续操作。
+- `hero.svg`, `hero-en.svg` and their `-compact.svg` variants: vector brand covers; regenerate with `python3 scripts/build-brand-assets.py` / 品牌矢量封面，可用该命令重新生成。
+
+## Capture and distribution / 录制与展示
+
+The real interface uses the host's **light theme** and **18 px** conversation font. The hero uses a **1440 × 780** viewport and is exported at 2160 × 1170 so the selection menu and both composers fit together. Other stills use a **1440 × 900** viewport, captured at 2× pixel density and exported at 2160 × 1350; the selection still is a native 1440 × 900 recording frame. MP4 is 1440 × 900 at 30 fps; GIF is 1120 × 700 at 12 fps. Encoding preserves the browser's frame timing without speeding up responses. A small pointer overlay follows actual mouse events in the recording; product controls and model replies are not redrawn or substituted.
+
+真实界面使用宿主的**浅色主题**和 **18 px** 会话字号。主图以 **1440 × 780** 视口补拍，导出为 2160 × 1170，让划选菜单和两侧输入框完整同屏。其余静态截图使用 **1440 × 900** 视口，按 2 倍像素密度采集后导出为 2160 × 1350；划选截图直接取自 1440 × 900 的录屏帧。MP4 为 1440 × 900 / 30 fps，GIF 为 1120 × 700 / 12 fps，均按浏览器帧时间编码，没有加速模型响应。录屏中仅添加跟随真实鼠标事件的小光标辅助层，没有重绘产品控件或替换模型回答。
+
+[`screenshots.json`](../../screenshots.json) declares the storefront gallery. The [catalog's screenshot convention](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md#screenshots--截图optional-recommended--可选推荐) resolves those paths from this repository, and the next catalog build refreshes the gallery. Existing screenshot paths remain available for cached catalogs.
+
+[`screenshots.json`](../../screenshots.json) 声明商店展示顺序。[商店截图约定](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md#screenshots--截图optional-recommended--可选推荐) 会从本仓库读取这些路径，下一次索引构建时更新图集；原有图片路径继续提供新版内容，供已缓存的索引读取。
+
+For future captures, use a fresh isolated DSH home, install the published plugin with the official CLI, verify the active bundles, and run the complete workflow against the official model API. Keep credentials, launch tokens, private conversations, raw frames, and recording logs out of public assets. The older `capture-demo.mjs` and `capture-video.mjs` scripts target historical layouts and synthetic sessions; they do not reproduce this recording unchanged.
+
+后续重录应使用全新隔离的 DSH home，通过官方 CLI 安装已发布插件，核对实际加载的构建，并调用官方模型走完完整流程。凭证、启动 token、私人会话、原始帧和录制日志不进入公开素材。旧 `capture-demo.mjs`、`capture-video.mjs` 面向历史布局与合成会话，不能原样用于复现本次录制。

package/lib/client.js

@@ -611,7 +611,7 @@ window.__ModuleLoader__.load({
 			let dockRegistered = false;
 			let report = {
 				versions: {
-					sidenote: "0.7.2",
+					sidenote: "0.7.3",
 					dsh: "unknown",
 					betterSidebar: null
 				},
@@ -1262,15 +1262,15 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var diagnostics_module_css_default = {
+			"setting": "tGe0LW_setting",
+			"list": "tGe0LW_list",
+			"header": "tGe0LW_header",
 			"versions": "tGe0LW_versions",
-			"trigger": "tGe0LW_trigger",
 			"actions": "tGe0LW_actions",
-			"panel": "tGe0LW_panel",
+			"trigger": "tGe0LW_trigger",
 			"settingTitle": "tGe0LW_settingTitle",
-			"setting": "tGe0LW_setting",
-			"header": "tGe0LW_header",
-			"description": "tGe0LW_description",
-			"list": "tGe0LW_list"
+			"panel": "tGe0LW_panel",
+			"description": "tGe0LW_description"
 		};
 		//#endregion
 		//#region src/client/diagnostics/index.tsx
@@ -1855,17 +1855,19 @@ window.__ModuleLoader__.load({
 		const sideChatBridge = { current: null };
 		//#endregion
 		//#region src/client/chat/transcript.ts
-		/** ContentBlock[] → 纯文本：text 块拼接；image 块降级占位；其余忽略。 */
+		/** Protocol readers need actual text, not attachment preview labels before it.
+		* Native Conversation renders images; only an image-only message needs a label. */
 		function contentTextOf(content) {
 			if (!Array.isArray(content)) return "";
 			const parts = [];
+			let hasImage = false;
 			for (const block of content) {
 				if (typeof block !== "object" || block === null) continue;
 				const b = block;
 				if (b.type === "text" && typeof b.text === "string") parts.push(b.text);
-				else if (b.type === "image") parts.push(t("imagePlaceholder"));
+				else if (b.type === "image") hasImage = true;
 			}
-			return parts.join("\n");
+			return parts.join("\n") || (hasImage ? t("imagePlaceholder") : "");
 		}
 		function seqKey(prefix, node) {
 			return `${prefix}:${typeof node.seq === "number" ? node.seq : "?"}`;
@@ -2331,29 +2333,29 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var sidechat_module_css_default = {
-			"emptyText": "_5KEEsG_emptyText",
-			"headerSide": "_5KEEsG_headerSide",
-			"nativeConversation": "_5KEEsG_nativeConversation",
-			"errorRow": "_5KEEsG_errorRow",
+			"nativeToolbarActions": "_5KEEsG_nativeToolbarActions",
 			"nativeAction": "_5KEEsG_nativeAction",
+			"stateScreen": "_5KEEsG_stateScreen",
+			"nativeHost": "_5KEEsG_nativeHost",
+			"root": "_5KEEsG_root",
+			"mainContext": "_5KEEsG_mainContext",
+			"emptyIcon": "_5KEEsG_emptyIcon",
 			"stateDetail": "_5KEEsG_stateDetail",
-			"progressEntries": "_5KEEsG_progressEntries",
+			"visibilitySetting": "_5KEEsG_visibilitySetting",
+			"nativeConversation": "_5KEEsG_nativeConversation",
+			"chatView": "_5KEEsG_chatView",
+			"historyToggle": "_5KEEsG_historyToggle",
 			"contextChevron": "_5KEEsG_contextChevron",
+			"progressEntries": "_5KEEsG_progressEntries",
 			"nativeToolbar": "_5KEEsG_nativeToolbar",
-			"mainContext": "_5KEEsG_mainContext",
-			"root": "_5KEEsG_root",
-			"nativeHost": "_5KEEsG_nativeHost",
-			"contextHint": "_5KEEsG_contextHint",
-			"visibilitySetting": "_5KEEsG_visibilitySetting",
+			"emptyTitle": "_5KEEsG_emptyTitle",
 			"progressEntry": "_5KEEsG_progressEntry",
+			"contextHint": "_5KEEsG_contextHint",
 			"reflowAction": "_5KEEsG_reflowAction",
-			"emptyIcon": "_5KEEsG_emptyIcon",
-			"nativeToolbarActions": "_5KEEsG_nativeToolbarActions",
 			"contextChevronOpen": "_5KEEsG_contextChevronOpen",
-			"stateScreen": "_5KEEsG_stateScreen",
-			"emptyTitle": "_5KEEsG_emptyTitle",
-			"historyToggle": "_5KEEsG_historyToggle",
-			"chatView": "_5KEEsG_chatView"
+			"emptyText": "_5KEEsG_emptyText",
+			"errorRow": "_5KEEsG_errorRow",
+			"headerSide": "_5KEEsG_headerSide"
 		};
 		//#endregion
 		//#region src/client/sidechat/NativeConversation.tsx
@@ -5553,34 +5555,34 @@ ${entries.map((entry) => {
 			document.head.appendChild(tag);
 		}
 		var annotate_module_css_default = {
-			"dshSidenoteHintIn": "_SVViG_dshSidenoteHintIn",
-			"deleteButton": "_SVViG_deleteButton",
-			"editorEdit": "_SVViG_editorEdit",
+			"badge": "_SVViG_badge",
+			"editorSpacer": "_SVViG_editorSpacer",
+			"editorError": "_SVViG_editorError",
+			"confirmButton": "_SVViG_confirmButton",
+			"hint": "_SVViG_hint",
+			"sentChipRow": "_SVViG_sentChipRow",
 			"hintClose": "_SVViG_hintClose",
+			"sentCardTitle": "_SVViG_sentCardTitle",
+			"editorTextarea": "_SVViG_editorTextarea",
+			"editorNew": "_SVViG_editorNew",
 			"editorTarget": "_SVViG_editorTarget",
-			"sentChipRow": "_SVViG_sentChipRow",
+			"editorFooter": "_SVViG_editorFooter",
+			"cancelButton": "_SVViG_cancelButton",
+			"dshSidenoteHintIn": "_SVViG_dshSidenoteHintIn",
+			"sentChip": "_SVViG_sentChip",
 			"editorInput": "_SVViG_editorInput",
-			"toolbarButton": "_SVViG_toolbarButton",
 			"highlight": "_SVViG_highlight",
-			"sentChip": "_SVViG_sentChip",
-			"editorTextarea": "_SVViG_editorTextarea",
-			"editorNew": "_SVViG_editorNew",
-			"toolbarBelow": "_SVViG_toolbarBelow",
-			"badgeSent": "_SVViG_badgeSent",
+			"toolbarButton": "_SVViG_toolbarButton",
 			"toolbar": "_SVViG_toolbar",
-			"editorFooter": "_SVViG_editorFooter",
+			"deleteButton": "_SVViG_deleteButton",
 			"editorAsk": "_SVViG_editorAsk",
-			"confirmButton": "_SVViG_confirmButton",
-			"hint": "_SVViG_hint",
-			"badge": "_SVViG_badge",
-			"saveButton": "_SVViG_saveButton",
+			"badgeSent": "_SVViG_badgeSent",
+			"sentCardQuote": "_SVViG_sentCardQuote",
 			"sentCardNote": "_SVViG_sentCardNote",
-			"cancelButton": "_SVViG_cancelButton",
+			"saveButton": "_SVViG_saveButton",
 			"editorAskRow": "_SVViG_editorAskRow",
-			"editorSpacer": "_SVViG_editorSpacer",
-			"editorError": "_SVViG_editorError",
-			"sentCardTitle": "_SVViG_sentCardTitle",
-			"sentCardQuote": "_SVViG_sentCardQuote"
+			"toolbarBelow": "_SVViG_toolbarBelow",
+			"editorEdit": "_SVViG_editorEdit"
 		};
 		//#endregion
 		//#region src/client/annotate/hint.tsx
@@ -6393,34 +6395,34 @@ ${entries.map((entry) => {
 			document.head.appendChild(tag);
 		}
 		var annotations_module_css_default = {
+			"chipClearAll": "SVnebq_chipClearAll",
+			"sentChips": "SVnebq_sentChips",
+			"chipDismissShade": "SVnebq_chipDismissShade",
 			"storageNotice": "SVnebq_storageNotice",
+			"contextText": "SVnebq_contextText",
+			"contextAppear": "SVnebq_contextAppear",
+			"chip": "SVnebq_chip",
+			"contextList": "SVnebq_contextList",
+			"contextActions": "SVnebq_contextActions",
+			"contextLabel": "SVnebq_contextLabel",
 			"contextAction": "SVnebq_contextAction",
-			"userContextHost": "SVnebq_userContextHost",
-			"chipDismissShade": "SVnebq_chipDismissShade",
 			"sentChipGroup": "SVnebq_sentChipGroup",
+			"userContextHost": "SVnebq_userContextHost",
 			"sentChip": "SVnebq_sentChip",
-			"contextFooter": "SVnebq_contextFooter",
-			"sentContext": "SVnebq_sentContext",
+			"contextItem": "SVnebq_contextItem",
 			"sentChevronOpen": "SVnebq_sentChevronOpen",
-			"contextPanel": "SVnebq_contextPanel",
-			"contextAppear": "SVnebq_contextAppear",
-			"sentChevron": "SVnebq_sentChevron",
-			"contextEditor": "SVnebq_contextEditor",
-			"contextNumber": "SVnebq_contextNumber",
-			"contextText": "SVnebq_contextText",
-			"sentChips": "SVnebq_sentChips",
-			"contextContent": "SVnebq_contextContent",
+			"contextFooter": "SVnebq_contextFooter",
+			"contextSource": "SVnebq_contextSource",
 			"sentPreview": "SVnebq_sentPreview",
+			"contextNumber": "SVnebq_contextNumber",
+			"contextEditor": "SVnebq_contextEditor",
+			"sentChevron": "SVnebq_sentChevron",
 			"chipMain": "SVnebq_chipMain",
-			"contextItem": "SVnebq_contextItem",
-			"contextLabel": "SVnebq_contextLabel",
-			"chipWrap": "SVnebq_chipWrap",
-			"contextActions": "SVnebq_contextActions",
-			"contextSource": "SVnebq_contextSource",
-			"chipClearAll": "SVnebq_chipClearAll",
-			"chip": "SVnebq_chip",
+			"sentContext": "SVnebq_sentContext",
 			"chipDismiss": "SVnebq_chipDismiss",
-			"contextList": "SVnebq_contextList"
+			"contextPanel": "SVnebq_contextPanel",
+			"contextContent": "SVnebq_contextContent",
+			"chipWrap": "SVnebq_chipWrap"
 		};
 		//#endregion
 		//#region src/client/annotations/chip.tsx

package/lib/types/client/chat/transcript.d.ts

@@ -21,7 +21,8 @@ export interface ChatMessage {
     /** 被打断冻结的 assistant 输出（渲染「已停止」标记）。 */
     interrupted?: boolean;
 }
-/** ContentBlock[] → 纯文本：text 块拼接；image 块降级占位；其余忽略。 */
+/** Protocol readers need actual text, not attachment preview labels before it.
+ * Native Conversation renders images; only an image-only message needs a label. */
 export declare function contentTextOf(content: unknown): string;
 /**
  * 单个 ConversationNode → ChatMessage；返回 null = 面板不渲染

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidenote",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Follow the tangent. Keep the thread. Annotate, explore on the side, and bring answers back to DeepSeek Harness. / 思路可以分岔，主线始终向前。划选注释、侧边追问，再把结论带回正在推进的任务。",
   "icon": "docs/assets/logo.svg",
   "type": "module",

package/src/client/chat/transcript.ts

@@ -31,17 +31,19 @@ interface LooseBlock {
   name?: unknown
 }
 
-/** ContentBlock[] → 纯文本：text 块拼接；image 块降级占位；其余忽略。 */
+/** Protocol readers need actual text, not attachment preview labels before it.
+ * Native Conversation renders images; only an image-only message needs a label. */
 export function contentTextOf(content: unknown): string {
   if (!Array.isArray(content)) return ''
   const parts: string[] = []
+  let hasImage = false
   for (const block of content) {
     if (typeof block !== 'object' || block === null) continue
     const b = block as LooseBlock
     if (b.type === 'text' && typeof b.text === 'string') parts.push(b.text)
-    else if (b.type === 'image') parts.push(t('imagePlaceholder'))
+    else if (b.type === 'image') hasImage = true
   }
-  return parts.join('\n')
+  return parts.join('\n') || (hasImage ? t('imagePlaceholder') : '')
 }
 
 function seqKey(prefix: string, node: Record<string, unknown>): string {