@shgroup/dsh-serenity-hooks 1.20.4 → 1.20.5

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.20.4",
+  "version": "1.20.5",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/client.js

@@ -240,6 +240,75 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/image-fallback-api.ts
+		/** 图片落盘接口路径（node half api.ts，client 专属 x-serenity-ui 头） */
+		const UPLOAD_PATH = "/serenity/image-upload";
+		/**
+		* 识别结果消息模板（协议固有，S142 用户迭代：v1.20.5 去掉具体文件路径——UI 突兀，
+		* 改为目录级自然提示；agent 自行查 _tmp/images_from_user/ 找图片 → 调 CCC vlm MSM 识别）
+		*/
+		const IMAGE_NOTE_TEMPLATE_SINGLE = "用户提供了一张图片（已保存到 _tmp/images_from_user/），请查看该目录下的图片并处理";
+		const IMAGE_NOTE_TEMPLATE_MULTI = (count) => `用户提供了 ${count} 张图片（已保存到 _tmp/images_from_user/），请查看该目录下的图片并处理`;
+		/** 浏览器 File → base64（与 ui-conversation serializeImages 等价的最小实现） */
+		function fileToBase64(file) {
+			return file.arrayBuffer().then((buffer) => {
+				const bytes = new Uint8Array(buffer);
+				let binary = "";
+				const chunk = 32768;
+				for (let offset = 0; offset < bytes.length; offset += chunk) binary += String.fromCharCode(...bytes.subarray(offset, offset + chunk));
+				return btoa(binary);
+			});
+		}
+		/**
+		* 上传一张图片到 CCC _tmp/images_from_user/，返回相对路径（如 _tmp/images_from_user/xxx.png）。
+		* sessionId 必传：node half 经会话 header.cwd 解析 CCC 根（进程 cwd 不可靠）。
+		*/
+		async function uploadImage(file, sessionId) {
+			const data = await fileToBase64(file);
+			const res = await fetch(UPLOAD_PATH, {
+				method: "POST",
+				headers: {
+					"content-type": "application/json",
+					"x-serenity-ui": "1"
+				},
+				body: JSON.stringify({
+					sessionId,
+					mediaType: file.type,
+					name: file.name,
+					data
+				})
+			});
+			const body = await res.json();
+			if (!res.ok || typeof body.path !== "string") throw new Error(`serenity image upload failed: ${body.error ?? res.status}`);
+			return body.path;
+		}
+		/**
+		* 取 rail 图片的浏览器 File。
+		* conversation.draftImages 是 root singleton 的公开方法（读 controller 的 draftAttachments Map，
+		* 与调用 ctx 的作用域无关）——直接 ctx.get('conversation')。
+		* ⚠️ 必须作为方法调用（conversation.draftImages(ids)）：解构取出再调会丢失 this
+		* （draftImages 内部读 this.draftAttachments → "Cannot read properties of undefined"）。
+		*/
+		async function getDraftFiles(ctx, _sessionId, ids) {
+			const conversation = ctx.get?.("conversation");
+			if (conversation?.draftImages === void 0) return [];
+			return (conversation.draftImages(ids) ?? []).map((a) => a.file);
+		}
+		/**
+		* 纯文本重发（绕过图片门禁——不含 image part，模型永不触发 MODEL_DOES_NOT_SUPPORT_IMAGES）。
+		* ⚠️ 必须作为方法调用（session.prompt(...)）：解构取出再调会丢失 this
+		* （prompt 内部读 this.promptError → "Cannot set properties of undefined (setting 'promptError')"）。
+		*/
+		async function resendText(ctx, sessionId, text) {
+			const session = ctx.sessions.binding(sessionId)?.session;
+			if (session?.prompt === void 0) throw new Error("serenity image fallback: session unavailable");
+			const result = await session.prompt([{
+				type: "text",
+				text
+			}], "queue");
+			if (!result.ok) throw new Error(`serenity image fallback resend failed: ${result.error?.code}: ${result.error?.message}`);
+		}
+		//#endregion
 		//#region \0sp-css:/home/yh/home/home-serenity/AI_LAB/dsh-serenity-plugin/hooks/dsh-serenity-hooks/src/client/ImageFallbackDock
 		const css = "/* ImageFallbackDock — 图片自动落盘兜底状态条（S142） */\n\n.serenity-image-fallback {\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n  font-size: 12px;\n  line-height: 1.5;\n  padding: 2px 8px;\n  border-radius: 6px;\n  background: var(--dsw-alias-surface-muted, rgba(127, 127, 127, 0.1));\n  color: var(--dsw-alias-text-secondary, currentColor);\n}\n\n.serenity-image-fallback[data-state='busy'] {\n  color: var(--dsw-alias-text-secondary, currentColor);\n}\n\n.serenity-image-fallback[data-state='done'] {\n  color: var(--dsw-alias-text-success, currentColor);\n}\n\n.serenity-image-fallback[data-state='error'] {\n  color: var(--dsw-alias-text-danger, currentColor);\n}\n\n.serenity-image-fallback code {\n  font-family: var(--dsw-alias-font-mono, monospace);\n  font-size: 11px;\n  background: var(--dsw-alias-surface-muted, rgba(127, 127, 127, 0.12));\n  border-radius: 4px;\n  padding: 0 4px;\n}\n";
 		if (typeof document !== "undefined" && document.querySelector("style[data-sp-css]") === null) {
@@ -276,7 +345,7 @@ window.__ModuleLoader__.load({
 						if (files.length === 0) throw new Error("no draft image files");
 						const saved = [];
 						for (const file of files) saved.push(await uploadImage(file, String(sessionId)));
-						const note = saved.map((p) => `用户提供了图片在 ${p}`).join("\n");
+						const note = saved.length === 1 ? IMAGE_NOTE_TEMPLATE_SINGLE : IMAGE_NOTE_TEMPLATE_MULTI(saved.length);
 						const draft = input?.draft ?? "";
 						const text = draft === "" ? note : `${draft}\n${note}`;
 						if (inputActions?.removeImage !== void 0 && inputActions.setDraft !== void 0 && inputActions.submit !== void 0) {
@@ -326,69 +395,6 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region src/client/image-fallback-api.ts
-		/** 图片落盘接口路径（node half api.ts，client 专属 x-serenity-ui 头） */
-		const UPLOAD_PATH = "/serenity/image-upload";
-		/** 浏览器 File → base64（与 ui-conversation serializeImages 等价的最小实现） */
-		function fileToBase64(file) {
-			return file.arrayBuffer().then((buffer) => {
-				const bytes = new Uint8Array(buffer);
-				let binary = "";
-				const chunk = 32768;
-				for (let offset = 0; offset < bytes.length; offset += chunk) binary += String.fromCharCode(...bytes.subarray(offset, offset + chunk));
-				return btoa(binary);
-			});
-		}
-		/**
-		* 上传一张图片到 CCC _tmp/images_from_user/，返回相对路径（如 _tmp/images_from_user/xxx.png）。
-		* sessionId 必传：node half 经会话 header.cwd 解析 CCC 根（进程 cwd 不可靠）。
-		*/
-		async function uploadImage(file, sessionId) {
-			const data = await fileToBase64(file);
-			const res = await fetch(UPLOAD_PATH, {
-				method: "POST",
-				headers: {
-					"content-type": "application/json",
-					"x-serenity-ui": "1"
-				},
-				body: JSON.stringify({
-					sessionId,
-					mediaType: file.type,
-					name: file.name,
-					data
-				})
-			});
-			const body = await res.json();
-			if (!res.ok || typeof body.path !== "string") throw new Error(`serenity image upload failed: ${body.error ?? res.status}`);
-			return body.path;
-		}
-		/**
-		* 取 rail 图片的浏览器 File。
-		* conversation.draftImages 是 root singleton 的公开方法（读 controller 的 draftAttachments Map，
-		* 与调用 ctx 的作用域无关）——直接 ctx.get('conversation')。
-		* ⚠️ 必须作为方法调用（conversation.draftImages(ids)）：解构取出再调会丢失 this
-		* （draftImages 内部读 this.draftAttachments → "Cannot read properties of undefined"）。
-		*/
-		async function getDraftFiles(ctx, _sessionId, ids) {
-			const conversation = ctx.get?.("conversation");
-			if (conversation?.draftImages === void 0) return [];
-			return (conversation.draftImages(ids) ?? []).map((a) => a.file);
-		}
-		/**
-		* 纯文本重发（绕过图片门禁——不含 image part，模型永不触发 MODEL_DOES_NOT_SUPPORT_IMAGES）。
-		* ⚠️ 必须作为方法调用（session.prompt(...)）：解构取出再调会丢失 this
-		* （prompt 内部读 this.promptError → "Cannot set properties of undefined (setting 'promptError')"）。
-		*/
-		async function resendText(ctx, sessionId, text) {
-			const session = ctx.sessions.binding(sessionId)?.session;
-			if (session?.prompt === void 0) throw new Error("serenity image fallback: session unavailable");
-			const result = await session.prompt([{
-				type: "text",
-				text
-			}], "queue");
-			if (!result.ok) throw new Error(`serenity image fallback resend failed: ${result.error?.code}: ${result.error?.message}`);
-		}
-		//#endregion
 		//#region src/client/index.ts
 		const inject = [
 			"slots",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.20.4",
+  "version": "1.20.5",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {