dsh-sidenote 0.8.4 → 0.8.5

package/lib/client.js

@@ -766,7 +766,7 @@ window.__ModuleLoader__.load({
 			let dockRegistered = false;
 			let report = {
 				versions: {
-					sidenote: "0.8.4",
+					sidenote: "0.8.5",
 					dsh: "unknown",
 					betterSidebar: null
 				},
@@ -966,6 +966,8 @@ window.__ModuleLoader__.load({
 			settingsDescription: "Choose the actions available when you select conversation text.",
 			hideNativeQuote: "Hide native quote",
 			hideNativeQuoteHint: "Hide the Quote action in main and side chats.",
+			showSideChatNote: "Add a note before asking in side chat",
+			showSideChatNoteHint: "Turn off to add selected text directly to side chat and write your question there.",
 			settingsSaving: "Saving…",
 			settingsLoading: "Loading preferences…",
 			settingsUnavailable: "Preferences are unavailable. Reload the page to reconnect.",
@@ -1141,6 +1143,8 @@ window.__ModuleLoader__.load({
 			settingsDescription: "调整划选对话文字时显示的操作。",
 			hideNativeQuote: "隐藏原生引用",
 			hideNativeQuoteHint: "在主对话和侧边聊天中隐藏“引用”按钮。",
+			showSideChatNote: "侧边提问前填写注解",
+			showSideChatNoteHint: "关闭后，划选内容直接添加到侧边聊天，可在侧聊输入框中继续提问。",
 			settingsSaving: "正在保存…",
 			settingsLoading: "正在加载偏好设置…",
 			settingsUnavailable: "暂时无法读取设置，请刷新页面重新连接。",
@@ -1420,13 +1424,13 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var diagnostics_module_css_default = {
-			"versions": "tGe0LW_versions",
+			"trigger": "tGe0LW_trigger",
+			"list": "tGe0LW_list",
 			"header": "tGe0LW_header",
 			"panel": "tGe0LW_panel",
-			"trigger": "tGe0LW_trigger",
 			"actions": "tGe0LW_actions",
-			"list": "tGe0LW_list",
-			"description": "tGe0LW_description"
+			"description": "tGe0LW_description",
+			"versions": "tGe0LW_versions"
 		};
 		//#endregion
 		//#region src/client/diagnostics/index.tsx
@@ -2349,32 +2353,32 @@ window.__ModuleLoader__.load({
 		}
 		var annotations_module_css_default = {
 			"contextNumber": "SVnebq_contextNumber",
-			"contextActions": "SVnebq_contextActions",
-			"chipClearAll": "SVnebq_chipClearAll",
-			"sentChips": "SVnebq_sentChips",
-			"contextText": "SVnebq_contextText",
-			"chipWrap": "SVnebq_chipWrap",
-			"contextFooter": "SVnebq_contextFooter",
-			"userContextHost": "SVnebq_userContextHost",
-			"chip": "SVnebq_chip",
+			"contextLabel": "SVnebq_contextLabel",
+			"contextEditor": "SVnebq_contextEditor",
 			"sentChipGroup": "SVnebq_sentChipGroup",
-			"sentChevron": "SVnebq_sentChevron",
-			"sentPreview": "SVnebq_sentPreview",
-			"contextList": "SVnebq_contextList",
-			"chipDismissShade": "SVnebq_chipDismissShade",
-			"chipDismiss": "SVnebq_chipDismiss",
 			"sentChip": "SVnebq_sentChip",
+			"chipMain": "SVnebq_chipMain",
+			"contextText": "SVnebq_contextText",
+			"chipClearAll": "SVnebq_chipClearAll",
 			"storageNotice": "SVnebq_storageNotice",
-			"contextLabel": "SVnebq_contextLabel",
+			"contextContent": "SVnebq_contextContent",
+			"sentChevron": "SVnebq_sentChevron",
+			"sentChevronOpen": "SVnebq_sentChevronOpen",
+			"userContextHost": "SVnebq_userContextHost",
+			"sentPreview": "SVnebq_sentPreview",
+			"contextActions": "SVnebq_contextActions",
+			"contextFooter": "SVnebq_contextFooter",
 			"contextAppear": "SVnebq_contextAppear",
+			"contextList": "SVnebq_contextList",
 			"contextPanel": "SVnebq_contextPanel",
-			"contextContent": "SVnebq_contextContent",
+			"chip": "SVnebq_chip",
 			"contextAction": "SVnebq_contextAction",
-			"contextEditor": "SVnebq_contextEditor",
-			"chipMain": "SVnebq_chipMain",
+			"sentChips": "SVnebq_sentChips",
+			"chipWrap": "SVnebq_chipWrap",
+			"chipDismiss": "SVnebq_chipDismiss",
 			"contextSource": "SVnebq_contextSource",
-			"sentChevronOpen": "SVnebq_sentChevronOpen",
-			"contextItem": "SVnebq_contextItem"
+			"contextItem": "SVnebq_contextItem",
+			"chipDismissShade": "SVnebq_chipDismissShade"
 		};
 		//#endregion
 		//#region src/client/annotations/NativeUserContext.tsx
@@ -2848,38 +2852,38 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var sidechat_module_css_default = {
-			"contextColumn": "_5KEEsG_contextColumn",
-			"progressDetail": "_5KEEsG_progressDetail",
-			"progressPreview": "_5KEEsG_progressPreview",
-			"headerSide": "_5KEEsG_headerSide",
-			"emptyTitle": "_5KEEsG_emptyTitle",
-			"progressContent": "_5KEEsG_progressContent",
-			"nativeToolbar": "_5KEEsG_nativeToolbar",
-			"contextUserRow": "_5KEEsG_contextUserRow",
+			"root": "_5KEEsG_root",
 			"progress": "_5KEEsG_progress",
-			"chatView": "_5KEEsG_chatView",
-			"contextChevron": "_5KEEsG_contextChevron",
-			"nativeConversation": "_5KEEsG_nativeConversation",
-			"contextBubble": "_5KEEsG_contextBubble",
-			"nativeHost": "_5KEEsG_nativeHost",
 			"progressProcess": "_5KEEsG_progressProcess",
-			"emptyIcon": "_5KEEsG_emptyIcon",
-			"root": "_5KEEsG_root",
-			"emptyText": "_5KEEsG_emptyText",
-			"contextImage": "_5KEEsG_contextImage",
 			"nativeToolbarActions": "_5KEEsG_nativeToolbarActions",
-			"progressEntries": "_5KEEsG_progressEntries",
-			"mainContext": "_5KEEsG_mainContext",
-			"contextChevronOpen": "_5KEEsG_contextChevronOpen",
-			"progressEntry": "_5KEEsG_progressEntry",
+			"nativeToolbar": "_5KEEsG_nativeToolbar",
 			"stateDetail": "_5KEEsG_stateDetail",
-			"progressLatest": "_5KEEsG_progressLatest",
+			"headerSide": "_5KEEsG_headerSide",
+			"nativeConversation": "_5KEEsG_nativeConversation",
+			"emptyText": "_5KEEsG_emptyText",
+			"contextChevron": "_5KEEsG_contextChevron",
+			"contextHint": "_5KEEsG_contextHint",
+			"progressEntry": "_5KEEsG_progressEntry",
+			"progressPreview": "_5KEEsG_progressPreview",
 			"nativeAction": "_5KEEsG_nativeAction",
+			"reflowAction": "_5KEEsG_reflowAction",
+			"chatView": "_5KEEsG_chatView",
+			"contextColumn": "_5KEEsG_contextColumn",
+			"contextChevronOpen": "_5KEEsG_contextChevronOpen",
+			"mainContext": "_5KEEsG_mainContext",
+			"emptyTitle": "_5KEEsG_emptyTitle",
 			"errorRow": "_5KEEsG_errorRow",
-			"contextHint": "_5KEEsG_contextHint",
+			"progressDetail": "_5KEEsG_progressDetail",
 			"historyToggle": "_5KEEsG_historyToggle",
+			"nativeHost": "_5KEEsG_nativeHost",
+			"progressEntries": "_5KEEsG_progressEntries",
+			"progressLatest": "_5KEEsG_progressLatest",
+			"progressContent": "_5KEEsG_progressContent",
 			"stateScreen": "_5KEEsG_stateScreen",
-			"reflowAction": "_5KEEsG_reflowAction"
+			"contextImage": "_5KEEsG_contextImage",
+			"contextBubble": "_5KEEsG_contextBubble",
+			"emptyIcon": "_5KEEsG_emptyIcon",
+			"contextUserRow": "_5KEEsG_contextUserRow"
 		};
 		//#endregion
 		//#region src/client/sidechat/ContextProgress.tsx
@@ -6684,35 +6688,35 @@ ${body}
 			document.head.appendChild(tag);
 		}
 		var annotate_module_css_default = {
-			"saveButton": "_SVViG_saveButton",
-			"hintClose": "_SVViG_hintClose",
-			"badgeSent": "_SVViG_badgeSent",
-			"deleteButton": "_SVViG_deleteButton",
-			"highlight": "_SVViG_highlight",
+			"badge": "_SVViG_badge",
+			"editorEdit": "_SVViG_editorEdit",
+			"sentCardQuote": "_SVViG_sentCardQuote",
 			"confirmButton": "_SVViG_confirmButton",
-			"editorFooter": "_SVViG_editorFooter",
-			"editorAskRow": "_SVViG_editorAskRow",
-			"sentCardNote": "_SVViG_sentCardNote",
+			"saveButton": "_SVViG_saveButton",
 			"cancelButton": "_SVViG_cancelButton",
+			"sentCardNote": "_SVViG_sentCardNote",
 			"toolbarBelow": "_SVViG_toolbarBelow",
-			"sentChipRow": "_SVViG_sentChipRow",
+			"sentCardTitle": "_SVViG_sentCardTitle",
+			"editorError": "_SVViG_editorError",
+			"sentChip": "_SVViG_sentChip",
+			"highlight": "_SVViG_highlight",
+			"editorTarget": "_SVViG_editorTarget",
+			"toolbarStatus": "_SVViG_toolbarStatus",
+			"dshSidenoteHintIn": "_SVViG_dshSidenoteHintIn",
+			"toolbarButton": "_SVViG_toolbarButton",
+			"editorAskRow": "_SVViG_editorAskRow",
 			"editorInput": "_SVViG_editorInput",
+			"deleteButton": "_SVViG_deleteButton",
+			"hintClose": "_SVViG_hintClose",
 			"toolbar": "_SVViG_toolbar",
 			"editorAsk": "_SVViG_editorAsk",
-			"editorError": "_SVViG_editorError",
-			"sentCardTitle": "_SVViG_sentCardTitle",
-			"editorTextarea": "_SVViG_editorTextarea",
-			"dshSidenoteHintIn": "_SVViG_dshSidenoteHintIn",
-			"editorTarget": "_SVViG_editorTarget",
-			"sentChip": "_SVViG_sentChip",
-			"sentCardQuote": "_SVViG_sentCardQuote",
-			"editorEdit": "_SVViG_editorEdit",
 			"editorSpacer": "_SVViG_editorSpacer",
+			"badgeSent": "_SVViG_badgeSent",
+			"editorFooter": "_SVViG_editorFooter",
 			"hint": "_SVViG_hint",
-			"toolbarStatus": "_SVViG_toolbarStatus",
 			"editorNew": "_SVViG_editorNew",
-			"badge": "_SVViG_badge",
-			"toolbarButton": "_SVViG_toolbarButton"
+			"sentChipRow": "_SVViG_sentChipRow",
+			"editorTextarea": "_SVViG_editorTextarea"
 		};
 		//#endregion
 		//#region src/client/annotate/hint.tsx
@@ -7025,6 +7029,7 @@ ${body}
 					y: anchor.y,
 					abort: new AbortController(),
 					target,
+					skipNote: !preference.showSideChatNote,
 					...targetTitle !== void 0 ? { targetTitle } : {}
 				});
 				controller.clear();
@@ -7053,6 +7058,10 @@ ${body}
 						view: snapshot.source.view
 					});
 					setSideDraft((current) => current === sideDraft ? null : current);
+					if (sideDraft.skipNote) {
+						const view = [...document.querySelectorAll("[data-sidenote-chat-session]")].find((element) => element.dataset.sidenoteChatSession === target.childId);
+						if (view) focusSideComposer(view);
+					}
 					return true;
 				} catch {
 					return false;
@@ -7136,6 +7145,7 @@ ${body}
 					x: sideDraft.x,
 					y: sideDraft.y,
 					targetTitle: sideDraft.targetTitle,
+					skipNote: sideDraft.skipNote,
 					bounds: sourceClip(sideDraft.snapshot.source),
 					onSave: commitSideDraft,
 					onCancel: () => {
@@ -7232,6 +7242,7 @@ ${body}
 		function SideChatNoteEditor(props) {
 			useLocaleTick();
 			const [note, setNote] = (0, react.useState)("");
+			const [showNote, setShowNote] = (0, react.useState)(!props.skipNote);
 			const noteInputRef = useAutoGrowingNote(note);
 			const [failed, setFailed] = (0, react.useState)(false);
 			const [pending, setPending] = (0, react.useState)(false);
@@ -7262,6 +7273,7 @@ ${body}
 					if (cancelled.current) return;
 					saved.current = ok;
 					failedRef.current = !ok;
+					if (!ok) setShowNote(true);
 					setFailed(!ok);
 					setPending(false);
 				};
@@ -7280,6 +7292,9 @@ ${body}
 			};
 			const saveRef = (0, react.useRef)(save);
 			saveRef.current = save;
+			(0, react.useEffect)(() => {
+				if (props.skipNote) saveRef.current();
+			}, [props.skipNote]);
 			(0, react.useEffect)(() => {
 				const onKeyDown = (event) => {
 					if (event.key === "Escape") {
@@ -7320,7 +7335,7 @@ ${body}
 						className: annotate_module_css_default.editorTarget,
 						children: t("sendToTarget", { title: props.targetTitle })
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					showNote && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: annotate_module_css_default.editorAskRow,
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
 							ref: noteInputRef,
@@ -8339,7 +8354,7 @@ ${body}
 		}
 		//#endregion
 		//#region src/client/preferences.ts
-		/** Share one host-backed value between every main and side conversation. */
+		/** Share host-backed preferences between every main and side conversation. */
 		function createSidenotePreferences(form) {
 			const listeners = /* @__PURE__ */ new Set();
 			let saving = false;
@@ -8348,6 +8363,7 @@ ${body}
 				const state = form.getSnapshot();
 				return {
 					hidden: state.value?.hideNativeQuote ?? true,
+					showSideChatNote: state.value?.showSideChatNote ?? true,
 					status: state.status,
 					writable: state.writable,
 					saving,
@@ -8360,6 +8376,20 @@ ${body}
 				for (const listener of listeners) listener();
 			};
 			const unsubscribe = form.subscribe(publish);
+			const set = async (field, value) => {
+				if (saving || snapshot.status !== "ready" || !snapshot.writable) return;
+				saving = true;
+				failed = false;
+				publish();
+				try {
+					failed = !await form.set(field, value);
+				} catch {
+					failed = true;
+				} finally {
+					saving = false;
+					publish();
+				}
+			};
 			return {
 				getSnapshot: () => snapshot,
 				subscribe(listener) {
@@ -8368,20 +8398,8 @@ ${body}
 						listeners.delete(listener);
 					};
 				},
-				async setHidden(hidden) {
-					if (saving || snapshot.status !== "ready" || !snapshot.writable) return;
-					saving = true;
-					failed = false;
-					publish();
-					try {
-						failed = !await form.set("hideNativeQuote", hidden);
-					} catch {
-						failed = true;
-					} finally {
-						saving = false;
-						publish();
-					}
-				},
+				setHidden: (hidden) => set("hideNativeQuote", hidden),
+				setShowSideChatNote: (show) => set("showSideChatNote", show),
 				dispose() {
 					unsubscribe();
 					listeners.clear();
@@ -8400,15 +8418,15 @@ ${body}
 			document.head.appendChild(tag);
 		}
 		var settings_module_css_default = {
-			"description": "_2xJwMG_description",
-			"error": "_2xJwMG_error",
 			"hint": "_2xJwMG_hint",
-			"label": "_2xJwMG_label",
-			"title": "_2xJwMG_title",
-			"copy": "_2xJwMG_copy",
+			"description": "_2xJwMG_description",
 			"status": "_2xJwMG_status",
 			"row": "_2xJwMG_row",
-			"page": "_2xJwMG_page"
+			"page": "_2xJwMG_page",
+			"copy": "_2xJwMG_copy",
+			"title": "_2xJwMG_title",
+			"label": "_2xJwMG_label",
+			"error": "_2xJwMG_error"
 		};
 		//#endregion
 		//#region src/client/settings.tsx
@@ -8455,6 +8473,32 @@ ${body}
 							}
 						})]
 					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: settings_module_css_default.row,
+						role: "group",
+						"aria-labelledby": `${id}-side-note-label`,
+						"aria-describedby": `${id}-side-note-description`,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: settings_module_css_default.copy,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								id: `${id}-side-note-label`,
+								className: settings_module_css_default.label,
+								children: t("showSideChatNote")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								id: `${id}-side-note-description`,
+								className: settings_module_css_default.hint,
+								children: t("showSideChatNoteHint")
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+							checked: state.showSideChatNote,
+							label: t("showSideChatNote"),
+							title: t("showSideChatNoteHint"),
+							disabled: state.status !== "ready" || !state.writable || state.saving,
+							onChange: (show) => {
+								preferences.setShowSideChatNote(show);
+							}
+						})]
+					}),
 					state.saving && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: settings_module_css_default.status,
 						role: "status",

package/lib/index.js

@@ -1094,6 +1094,7 @@ defineMethod("transform", [
 /** Live presentation preference stored in the host's profile document. */
 const Config = Schema.object({
 	hideNativeQuote: Schema.boolean().default(true).volatile(),
+	showSideChatNote: Schema.boolean().default(true).volatile(),
 	finalRepliesDefaultAttempted: Schema.boolean().default(false).volatile()
 });
 //#endregion

package/lib/types/client/annotate/overlay.d.ts

@@ -23,6 +23,7 @@ export declare function SideChatNoteEditor(props: {
     y: number;
     targetTitle?: string;
     bounds?: Bounds;
+    skipNote?: boolean;
     onSave: (note: string) => boolean | Promise<boolean>;
     onCancel: () => void;
 }): ReactNode;

package/lib/types/client/locales.d.ts

@@ -69,6 +69,8 @@ export declare const en: {
     settingsDescription: string;
     hideNativeQuote: string;
     hideNativeQuoteHint: string;
+    showSideChatNote: string;
+    showSideChatNoteHint: string;
     settingsSaving: string;
     settingsLoading: string;
     settingsUnavailable: string;

package/lib/types/client/preferences.d.ts

@@ -1,23 +1,26 @@
 import type { ObservableSnapshot } from './host/contracts.ts';
-/** The host ConfigForm subset used by the single Sidenote preference. */
+/** The host ConfigForm subset used by Sidenote preferences. */
 export interface SidenoteConfigForm extends ObservableSnapshot<{
     status: 'loading' | 'ready' | 'unavailable';
     value: {
         hideNativeQuote: boolean;
+        showSideChatNote?: boolean;
     } | undefined;
     writable: boolean;
 }> {
-    set(field: 'hideNativeQuote', value: boolean): Promise<boolean>;
+    set(field: 'hideNativeQuote' | 'showSideChatNote', value: boolean): Promise<boolean>;
 }
 export interface SidenotePreferences extends ObservableSnapshot<{
     hidden: boolean;
+    showSideChatNote: boolean;
     status: 'loading' | 'ready' | 'unavailable';
     writable: boolean;
     saving: boolean;
     failed: boolean;
 }> {
     setHidden(hidden: boolean): Promise<void>;
+    setShowSideChatNote(show: boolean): Promise<void>;
     dispose(): void;
 }
-/** Share one host-backed value between every main and side conversation. */
+/** Share host-backed preferences between every main and side conversation. */
 export declare function createSidenotePreferences(form: SidenoteConfigForm): SidenotePreferences;

package/lib/types/settings.d.ts

@@ -2,8 +2,10 @@ import z from '@deepseek-ai/schemastery';
 /** Live presentation preference stored in the host's profile document. */
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     hideNativeQuote: z<boolean, boolean, "volatile-defined">;
+    showSideChatNote: z<boolean, boolean, "volatile-defined">;
     finalRepliesDefaultAttempted: z<boolean, boolean, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     hideNativeQuote: z<boolean, boolean, "volatile-defined">;
+    showSideChatNote: z<boolean, boolean, "volatile-defined">;
     finalRepliesDefaultAttempted: z<boolean, boolean, "volatile-defined">;
 }>>, "plain">;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidenote",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "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/annotate/overlay.tsx

@@ -17,6 +17,7 @@ import type { ReactNode } from 'react'
 import { IconCheckOutline16, IconTrashOutline16 } from '../host/icons.ts'
 import type { Context } from '../host/contracts.ts'
 import { currentSessionIdOf } from '../host/currentSession.ts'
+import { focusSideComposer } from '../host/dom.ts'
 import { hostDiagnostics } from '../host/probes.ts'
 import { insertNativeQuote, probeInput, resolveInput } from '../host/input.ts'
 import { sideChatBridge, type SideChatBridge } from '../bridge.ts'
@@ -56,8 +57,8 @@ function useAutoGrowingNote(note: string) {
   return input
 }
 
-/** 「Ask in side chat」的注解收集态：先弹编辑器（与「Add to conversation」一致，
- *  允许空注解），保存后经 bridge 等待真实子会话，创建共享注释对象；正文保持干净。 */
+/** 「Ask in side chat」的投递草稿：按偏好填写或跳过注解，
+ *  经 bridge 等待真实子会话后创建共享注释对象；正文保持干净。 */
 interface SideDraftState {
   readonly snapshot: SelectionSnapshot
   readonly x: number
@@ -66,6 +67,7 @@ interface SideDraftState {
   readonly targetTitle?: string
   readonly abort: AbortController
   readonly target: ReturnType<SideChatBridge['captureTarget']> | undefined
+  readonly skipNote: boolean
 }
 
 interface OverlayProps {
@@ -188,11 +190,12 @@ function AnnotateOverlayInner({ ctx, store, controller, preferences }: OverlayPr
   }
 
   const askInSideChat = (snapshot: SelectionSnapshot): void => {
-    // 收集注解（可空），等选定的实际目标就绪后递交共享对象。
+    // 按偏好收集注解，等选定的实际目标就绪后递交共享对象。
     const anchor = selectionBadgePoint(snapshot)
     const target = sideChatBridge.current?.captureTarget(snapshot.sessionId)
     const targetTitle = target?.title
-    setSideDraft({ snapshot, x: anchor.x, y: anchor.y, abort: new AbortController(), target, ...(targetTitle !== undefined ? { targetTitle } : {}) })
+    setSideDraft({ snapshot, x: anchor.x, y: anchor.y, abort: new AbortController(), target, skipNote: !preference.showSideChatNote,
+      ...(targetTitle !== undefined ? { targetTitle } : {}) })
     controller.clear()
     window.getSelection()?.removeAllRanges()
   }
@@ -211,6 +214,11 @@ function AnnotateOverlayInner({ ctx, store, controller, preferences }: OverlayPr
       })
       rangeCache.current.set(annotation.id, { ranges: snapshot.ranges.map(range => range.cloneRange()), view: snapshot.source.view })
       setSideDraft(current => current === sideDraft ? null : current)
+      if (sideDraft.skipNote) {
+        const view = [...document.querySelectorAll<HTMLElement>('[data-sidenote-chat-session]')]
+          .find(element => element.dataset.sidenoteChatSession === target.childId)
+        if (view) focusSideComposer(view)
+      }
       return true
     } catch { return false }
   }
@@ -298,6 +306,7 @@ function AnnotateOverlayInner({ ctx, store, controller, preferences }: OverlayPr
           x={sideDraft.x}
           y={sideDraft.y}
           targetTitle={sideDraft.targetTitle}
+          skipNote={sideDraft.skipNote}
           bounds={sourceClip(sideDraft.snapshot.source)}
           onSave={commitSideDraft}
           onCancel={() => { sideDraft.abort.abort(); setSideDraft(null) }}
@@ -392,11 +401,13 @@ export function SideChatNoteEditor(props: {
   y: number
   targetTitle?: string
   bounds?: Bounds
+  skipNote?: boolean
   onSave: (note: string) => boolean | Promise<boolean>
   onCancel: () => void
 }): ReactNode {
   useLocaleTick()
   const [note, setNote] = useState('')
+  const [showNote, setShowNote] = useState(!props.skipNote)
   const noteInputRef = useAutoGrowingNote(note)
   const [failed, setFailed] = useState(false)
   const [pending, setPending] = useState(false)
@@ -415,6 +426,7 @@ export function SideChatNoteEditor(props: {
       if (cancelled.current) return
       saved.current = ok
       failedRef.current = !ok
+      if (!ok) setShowNote(true)
       setFailed(!ok)
       setPending(false)
     }
@@ -426,6 +438,9 @@ export function SideChatNoteEditor(props: {
   }
   const saveRef = useRef(save)
   saveRef.current = save
+  useEffect(() => {
+    if (props.skipNote) saveRef.current()
+  }, [props.skipNote])
 
   useEffect(() => {
     const onKeyDown = (event: KeyboardEvent): void => {
@@ -460,40 +475,42 @@ export function SideChatNoteEditor(props: {
       {props.targetTitle !== undefined && props.targetTitle !== '' && (
         <div className={css.editorTarget}>{t('sendToTarget', { title: props.targetTitle })}</div>
       )}
-      <div className={css.editorAskRow}>
-        <textarea
-          ref={noteInputRef}
-          rows={1}
-          className={css.editorInput}
-          value={note}
-          placeholder={t('sideNotePlaceholder')}
-          aria-label={t('sideNoteAria')}
-          autoFocus
-          disabled={pending}
-          onChange={(event) => {
-            setNote(event.target.value)
-            failedRef.current = false
-            setFailed(false)
-          }}
-          onKeyDown={(event) => {
-            if (event.key !== 'Enter' || event.shiftKey) return
-            // IME 保护：组合中（候选窗未提交）的 Enter 属于输入法，不能算确认。
-            if (event.nativeEvent.isComposing || event.nativeEvent.keyCode === 229) return
-            event.preventDefault()
-            save()
-          }}
-        />
-        <button
-          type="button"
-          className={css.confirmButton}
-          title={t('confirmTitle')}
-          aria-label={t('confirmAskAria')}
-          onClick={() => { save() }}
-          disabled={pending}
-        >
-          <IconCheckOutline16 size={14} />
-        </button>
-      </div>
+      {showNote && (
+        <div className={css.editorAskRow}>
+          <textarea
+            ref={noteInputRef}
+            rows={1}
+            className={css.editorInput}
+            value={note}
+            placeholder={t('sideNotePlaceholder')}
+            aria-label={t('sideNoteAria')}
+            autoFocus
+            disabled={pending}
+            onChange={(event) => {
+              setNote(event.target.value)
+              failedRef.current = false
+              setFailed(false)
+            }}
+            onKeyDown={(event) => {
+              if (event.key !== 'Enter' || event.shiftKey) return
+              // IME 保护：组合中（候选窗未提交）的 Enter 属于输入法，不能算确认。
+              if (event.nativeEvent.isComposing || event.nativeEvent.keyCode === 229) return
+              event.preventDefault()
+              save()
+            }}
+          />
+          <button
+            type="button"
+            className={css.confirmButton}
+            title={t('confirmTitle')}
+            aria-label={t('confirmAskAria')}
+            onClick={() => { save() }}
+            disabled={pending}
+          >
+            <IconCheckOutline16 size={14} />
+          </button>
+        </div>
+      )}
       {failed && <div className={css.editorError}>{t('openSideFailed')}</div>}
       {pending && <div className={css.editorTarget} role="status">{t('sideTargetWaiting')}</div>}
     </div>

package/src/client/locales.ts

@@ -62,6 +62,8 @@ export const en = {
   settingsDescription: 'Choose the actions available when you select conversation text.',
   hideNativeQuote: 'Hide native quote',
   hideNativeQuoteHint: 'Hide the Quote action in main and side chats.',
+  showSideChatNote: 'Add a note before asking in side chat',
+  showSideChatNoteHint: 'Turn off to add selected text directly to side chat and write your question there.',
   settingsSaving: 'Saving…',
   settingsLoading: 'Loading preferences…',
   settingsUnavailable: 'Preferences are unavailable. Reload the page to reconnect.',
@@ -271,6 +273,8 @@ export const zh: Record<CopyKey, string> = {
   settingsDescription: '调整划选对话文字时显示的操作。',
   hideNativeQuote: '隐藏原生引用',
   hideNativeQuoteHint: '在主对话和侧边聊天中隐藏“引用”按钮。',
+  showSideChatNote: '侧边提问前填写注解',
+  showSideChatNoteHint: '关闭后，划选内容直接添加到侧边聊天，可在侧聊输入框中继续提问。',
   settingsSaving: '正在保存…',
   settingsLoading: '正在加载偏好设置…',
   settingsUnavailable: '暂时无法读取设置，请刷新页面重新连接。',

package/src/client/preferences.ts

@@ -1,33 +1,36 @@
 import type { ObservableSnapshot } from './host/contracts.ts'
 
-/** The host ConfigForm subset used by the single Sidenote preference. */
+/** The host ConfigForm subset used by Sidenote preferences. */
 export interface SidenoteConfigForm extends ObservableSnapshot<{
   status: 'loading' | 'ready' | 'unavailable'
-  value: { hideNativeQuote: boolean } | undefined
+  value: { hideNativeQuote: boolean; showSideChatNote?: boolean } | undefined
   writable: boolean
 }> {
-  set(field: 'hideNativeQuote', value: boolean): Promise<boolean>
+  set(field: 'hideNativeQuote' | 'showSideChatNote', value: boolean): Promise<boolean>
 }
 
 export interface SidenotePreferences extends ObservableSnapshot<{
   hidden: boolean
+  showSideChatNote: boolean
   status: 'loading' | 'ready' | 'unavailable'
   writable: boolean
   saving: boolean
   failed: boolean
 }> {
   setHidden(hidden: boolean): Promise<void>
+  setShowSideChatNote(show: boolean): Promise<void>
   dispose(): void
 }
 
-/** Share one host-backed value between every main and side conversation. */
+/** Share host-backed preferences between every main and side conversation. */
 export function createSidenotePreferences(form: SidenoteConfigForm): SidenotePreferences {
   const listeners = new Set<() => void>()
   let saving = false
   let failed = false
   const read = () => {
     const state = form.getSnapshot()
-    return { hidden: state.value?.hideNativeQuote ?? true, status: state.status, writable: state.writable, saving, failed }
+    return { hidden: state.value?.hideNativeQuote ?? true, showSideChatNote: state.value?.showSideChatNote ?? true,
+      status: state.status, writable: state.writable, saving, failed }
   }
   let snapshot = read()
   const publish = (): void => {
@@ -35,18 +38,20 @@ export function createSidenotePreferences(form: SidenoteConfigForm): SidenotePre
     for (const listener of listeners) listener()
   }
   const unsubscribe = form.subscribe(publish)
+  const set = async (field: 'hideNativeQuote' | 'showSideChatNote', value: boolean): Promise<void> => {
+    if (saving || snapshot.status !== 'ready' || !snapshot.writable) return
+    saving = true
+    failed = false
+    publish()
+    try { failed = !await form.set(field, value) }
+    catch { failed = true }
+    finally { saving = false; publish() }
+  }
   return {
     getSnapshot: () => snapshot,
     subscribe(listener) { listeners.add(listener); return () => { listeners.delete(listener) } },
-    async setHidden(hidden) {
-      if (saving || snapshot.status !== 'ready' || !snapshot.writable) return
-      saving = true
-      failed = false
-      publish()
-      try { failed = !await form.set('hideNativeQuote', hidden) }
-      catch { failed = true }
-      finally { saving = false; publish() }
-    },
+    setHidden: hidden => set('hideNativeQuote', hidden),
+    setShowSideChatNote: show => set('showSideChatNote', show),
     dispose() { unsubscribe(); listeners.clear() },
   }
 }

package/src/client/settings.tsx

@@ -24,6 +24,15 @@ function SidenoteSettings({ preferences }: { preferences: SidenotePreferences })
           disabled={state.status !== 'ready' || !state.writable || state.saving}
           onChange={hidden => { void preferences.setHidden(hidden) }} />
       </div>
+      <div className={css.row} role="group" aria-labelledby={`${id}-side-note-label`} aria-describedby={`${id}-side-note-description`}>
+        <div className={css.copy}>
+          <span id={`${id}-side-note-label`} className={css.label}>{t('showSideChatNote')}</span>
+          <p id={`${id}-side-note-description`} className={css.hint}>{t('showSideChatNoteHint')}</p>
+        </div>
+        <Switch checked={state.showSideChatNote} label={t('showSideChatNote')} title={t('showSideChatNoteHint')}
+          disabled={state.status !== 'ready' || !state.writable || state.saving}
+          onChange={show => { void preferences.setShowSideChatNote(show) }} />
+      </div>
       {state.saving && <p className={css.status} role="status">{t('settingsSaving')}</p>}
       {state.status === 'loading' && <p className={css.status} role="status">{t('settingsLoading')}</p>}
       {state.status === 'unavailable' && <p className={css.error} role="alert">{t('settingsUnavailable')}</p>}

package/src/settings.ts

@@ -3,5 +3,6 @@ import z from '@deepseek-ai/schemastery'
 /** Live presentation preference stored in the host's profile document. */
 export const Config = z.object({
   hideNativeQuote: z.boolean().default(true).volatile(),
+  showSideChatNote: z.boolean().default(true).volatile(),
   finalRepliesDefaultAttempted: z.boolean().default(false).volatile(),
 })