@roaming-ai/dsh-group-chat 0.3.1 → 0.4.0

package/README.md

@@ -1,5 +1,7 @@
 # dsh-group-chat
 
+![模型群聊面板](assets/banner.png)
+
 DSH Web GUI 的「模型群聊」插件：多模型角色群组对话面板。
 
 兼容：`dsh >= 0.1.5-rc.1`（Web profile）
@@ -18,7 +20,7 @@ DSH Web GUI 的「模型群聊」插件：多模型角色群组对话面板。
 - **@点名**：裸 `@` 弹出成员候选（↑↓ 选择、Enter/Tab 插入）；`@` 后继续键入则在群工作区内检索文件，插入 `@path` 芯片（只写入路径，不把文件正文再灌进 prompt）
 - **三区工作台**：左栏导航（搜索 + 目录树）；中栏会话流（色环头像 + 模型徽章 + 相对时间，贴底自动跟随、可回到底部）；右栏上下文（角色卡 + 工作区目录）。左右栏均可经接缝钮收起，窄面板时右栏覆盖式呈现
 - **群组工作区目录**：每个群组指定一个目录（群级、全会话共享；无独立笔记或文件清单）。角色发言时自动读取目录**根下一层**文本文件（扩展名白名单、跳过隐藏项、最多 20 个；单文件 16k / 总量 48k 截断）注入全体角色 system 提示词的「共享资料」块；支持 `~`、绝对路径与相对 DSH 工作区根解析，右栏内置目录选择浏览器；未设置则不注入、不暴露工具
-- **工具执行（docs/TOOLS.md）**：设置工作区后角色可调用 `read_file` / `list_dir` 主动查看工作区（realpath 硬边界，逃逸/软链越界一律拒绝）；**权限档位**于消息输入框下方左下角芯片切换（对齐主会话 `/permission` 三档：仅可查看 / 工作区内修改 / 完全权限；默认仅可查看，按群组记忆持久化）——工作区内修改档角色可请求执行 shell 命令（cwd 固定为工作区、超时 120s），**每条命令在会话流内逐条确认**（允许 / 拒绝 / 停止，命令全文展示不截断）；完全权限档免确认直接执行，切换时经主会话同款风险确认弹窗；工具调用以折叠行内嵌于角色消息（含耗时与状态），摘要注入后续发言上下文；不支持 tools 的模型自动降级为纯文本
+- **工具执行（docs/TOOLS.md）**：设置工作区后角色可调用 `read_file` / `list_dir` 主动查看工作区（realpath 硬边界，逃逸/软链越界一律拒绝）；**权限档位**于消息输入框下方左下角芯片切换（对齐主会话 `/permission` 三档：仅可查看 / 工作区内修改 / 完全权限；默认仅可查看，按群组记忆持久化）——工作区内修改档角色可请求执行 shell 命令（经 DSH `ctx.shell` 沙箱执行器：cwd 与沙箱策略均收紧到工作区、超时 120s），**每条命令在会话流内逐条确认**（允许 / 拒绝 / 停止，命令全文展示不截断）；完全权限档免确认直接执行（对齐 DSH danger-full-access 语义），切换时经主会话同款风险确认弹窗；工具调用以折叠行内嵌于角色消息（含耗时与状态），摘要注入后续发言上下文；不支持 tools 的模型自动降级为纯文本
 - **设置启用**：设置页「模型群聊」分区提供启停开关（持久化于 settings.yaml）；关闭时隐藏侧边栏入口并中止进行中的对话
 
 ## 架构
@@ -112,8 +114,8 @@ dsh plugin --profile web remove @roaming-ai/dsh-group-chat
 - **session-\<uuid\>.json**：名称/主题/`createdAt`/消息；可选 `namePinned` / `topicPinned`、`constraints` / `constraintsUpToSeq`（空数组与水位 0 省略）、消息上的 `toolCalls` / `error` / `failedRoleId`
 - 工作区文件内容不写入本目录；每次发言由 materials 实时读盘。全量保留，不裁剪
 - 事件驱动写：变更按文件标脏，同一 tick 内合并；流式 partial 不落盘。会话文件与 `roles.json` 紧凑序列化，ledger pretty
-- 原子写（tmp + fsync + rename，每个实际发生 rename 的目录一次 fsync）、单实例 `.lock`（PID 存活检测，崩溃残留自动清理）
-- 写失败保留脏标记，下次 flush 自动重试；插件卸载时先唤醒确认等待并 kill 子进程，再同步最终 flush、释放锁
+- 原子写（`@deepseek-ai/dsh-atomic-write` 的 `writeFileAtomic`：wx 独占创建 + 随机后缀 tmp + rename，无 per-file fsync 对齐 DSH 基座标准；每个实际发生 rename 的目录一次 fsync）、单实例 `.lock`（PID 存活检测，崩溃残留自动清理）
+- 写失败保留脏标记，下次 flush 自动重试；插件卸载时先唤醒确认等待并 kill 子进程，再等待挂起 flush 并最终落盘、释放锁（异步 disposer，cordis await）
 - 损坏处理：单会话文件坏仅丢该会话消息（隔离 `.corrupt-*`，每前缀保留最近 1 份）；ledger 有 id 而文件缺失则空消息重建；`roles.json` 坏仅空该群角色；ledger 坏可扫描群组目录回收（仅丢群组名）；行级校验丢弃孤儿条目；hydrate 清 `.tmp-*`
 - v1 双文件布局（ledger.json + messages.json）首次启动自动迁移（幂等；旧 messages.json 归档为 `.migrated-*`，从不删除）
 - 锁不可得（双进程）时降级为内存态运行并告警

package/lib/client.js

@@ -122,6 +122,7 @@ window.__ModuleLoader__.load({
 			".dsgc-msg.mine{flex-direction:row-reverse}",
 			".dsgc-avatar{width:28px;height:28px;box-sizing:border-box;border:2px solid var(--dsw-alias-border-l3,rgba(128,128,128,.4));border-radius:50%;background:var(--dsw-alias-bg-module-platform,rgba(128,128,128,.12));color:var(--dsw-alias-label-primary,inherit);display:flex;align-items:center;justify-content:center;font-size:12px;font-weight:600;flex:none;margin-top:1px}",
 			".dsgc-avatar.mine{border-color:transparent;background:var(--dsw-alias-button-info-fill,#4f6ef7);color:var(--dsw-alias-label-primary-foreground,#fff)}",
+			".dsgc-avatar .dsgc-orb{display:block}",
 			".dsgc-msgbody{max-width:76%;min-width:0;display:flex;flex-direction:column;gap:5px}",
 			".dsgc-msg.mine .dsgc-msgbody{align-items:flex-end}",
 			".dsgc-msghead{display:flex;gap:6px;align-items:center;min-width:0;font-size:12px;color:var(--dsw-alias-label-secondary,inherit)}",
@@ -197,8 +198,8 @@ window.__ModuleLoader__.load({
 			".dsgc-ph{position:absolute;left:14px;top:6px;max-width:calc(100% - 22px);color:var(--dsw-alias-label-tertiary,inherit);pointer-events:none;user-select:none;font-size:13px;line-height:24px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
 			".dsgc-chipin{display:inline-flex;align-items:center;gap:4px;background:color-mix(in srgb,var(--role-color,#888) 15%,transparent);border-radius:999px;padding:1px 7px 1px 5px;margin:0 1px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-primary,inherit);white-space:nowrap;user-select:all}",
 			".dsgc-card .dsgc-sendrow{padding:0 12px 10px}",
-			".dsgc-stopbtn{background:var(--dsw-alias-state-error-primary,#e5484d);border-color:transparent;color:#fff;font-weight:600}",
-			".dsgc-stopbtn:hover:not(:disabled){filter:brightness(1.08);color:#fff}",
+			"button.dsgc-stopbtn{background:var(--dsw-alias-state-error-primary,#e5484d);border-color:transparent;color:#fff;font-weight:600}",
+			"button.dsgc-stopbtn:hover:not(:disabled){background:var(--dsw-alias-state-error-primary,#e5484d);filter:brightness(1.08);color:#fff}",
 			".dsgc-parts{display:flex;align-items:flex-start;gap:6px;min-height:24px}",
 			".dsgc-partslabel{font-size:12px;line-height:24px;color:var(--dsw-alias-label-tertiary,inherit);flex:none}",
 			".dsgc-partlist{display:flex;flex-wrap:wrap;align-items:center;gap:6px;row-gap:4px;flex:1;min-width:0}",
@@ -2125,6 +2126,167 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/components/SpeakerOrb.tsx
+		/**
+		* 发言人执行态点阵光球（live 行头像内容）：角色色单色点阵 Canvas 2D 动画。
+		* thinking（轨道热斑游走＝等待首字节/推理中）与 listening（向外涟漪＝正文
+		* 流出）两态间弹簧缩放 + 权重交叉淡入；裁掉参考实现 MatrixOrb 的 label、
+		* level 与 idle 态（本场景只有执行中一种挂载时机），尺寸钉死为头像内容盒。
+		* @module dsh-group-chat/client/SpeakerOrb
+		*/
+		const TAU = Math.PI * 2;
+		const STATES = ["thinking", "listening"];
+		/** 头像内容盒：28px 外框减 2px 描边 ×2；圆形轮廓由 d 截断近似。 */
+		const SIZE = 24;
+		const GRID = 7;
+		/** 点阵铺开比例：外圈点贴近描边又不被 border-radius 裁切。 */
+		const SPREAD = .86;
+		const SCALE = {
+			thinking: .94,
+			listening: 1
+		};
+		const DAMPING = 26;
+		const ATTACK = .22;
+		const RELEASE = .08;
+		/** thinking 态热斑轨道（点阵归一化坐标）。 */
+		const ORBITERS = [
+			{
+				radius: .62,
+				speed: 2.2,
+				phase: 0,
+				spread: .42
+			},
+			{
+				radius: .4,
+				speed: -1.7,
+				phase: 2.1,
+				spread: .36
+			},
+			{
+				radius: .8,
+				speed: 1.15,
+				phase: 4,
+				spread: .34
+			}
+		];
+		function envelope(t) {
+			const slow = .5 + .5 * Math.sin(t * .62 + .4);
+			const fast = .5 + .5 * Math.sin(t * 1.9 + 1.1);
+			return .22 + .78 * (.45 + .55 * slow) * fast;
+		}
+		function intensityOf(state, d, nx, ny, t, amplitude) {
+			if (state === "listening") return .32 + amplitude * (.34 + .38 * (.5 + .5 * Math.sin(d * 4.2 - t * 3)));
+			let heat = 0;
+			for (const o of ORBITERS) {
+				const a = t * o.speed + o.phase;
+				const dx = nx - Math.cos(a) * o.radius;
+				const dy = ny - Math.sin(a) * o.radius;
+				heat += Math.exp(-(dx * dx + dy * dy) / (o.spread * o.spread));
+			}
+			return .26 + .8 * Math.min(1, heat);
+		}
+		function subscribeToZoom(onChange) {
+			window.addEventListener("resize", onChange);
+			return () => window.removeEventListener("resize", onChange);
+		}
+		function useDevicePixelRatio() {
+			return (0, react.useSyncExternalStore)(subscribeToZoom, () => Math.min(window.devicePixelRatio || 1, 4), () => 1);
+		}
+		function SpeakerOrb(props) {
+			const { state, color } = props;
+			const canvasRef = (0, react.useRef)(null);
+			const stateRef = (0, react.useRef)(state);
+			const redrawRef = (0, react.useRef)(null);
+			const dpr = useDevicePixelRatio();
+			(0, react.useEffect)(() => {
+				stateRef.current = state;
+			}, [state]);
+			(0, react.useEffect)(() => {
+				const canvas = canvasRef.current;
+				const ctx = canvas?.getContext("2d");
+				if (!canvas || !ctx) return;
+				const buffer = Math.round(SIZE * dpr);
+				canvas.width = canvas.height = buffer;
+				ctx.scale(buffer / SIZE, buffer / SIZE);
+				ctx.fillStyle = color;
+				const half = 3;
+				const spacing = SIZE * SPREAD / 6;
+				const maxRadius = spacing * .6;
+				const center = SIZE / 2;
+				const weights = {
+					thinking: 0,
+					listening: 0
+				};
+				weights[stateRef.current] = 1;
+				const draw = (t, amplitude, scale) => {
+					ctx.clearRect(0, 0, SIZE, SIZE);
+					for (let iy = 0; iy < GRID; iy++) for (let ix = 0; ix < GRID; ix++) {
+						const nx = (ix - half) / half;
+						const ny = (iy - half) / half;
+						const d = Math.hypot(nx, ny);
+						if (d > 1.12) continue;
+						let blended = 0;
+						for (const s of STATES) {
+							if (weights[s] < .001) continue;
+							blended += weights[s] * intensityOf(s, d, nx, ny, t, amplitude);
+						}
+						const intensity = Math.min(1, Math.max(0, blended));
+						const radius = maxRadius * Math.exp(-d * d * 1.7) * intensity * scale;
+						if (radius * dpr < .5) continue;
+						ctx.beginPath();
+						ctx.arc(center + (ix - half) * spacing * scale, center + (iy - half) * spacing * scale, radius, 0, TAU);
+						ctx.fill();
+					}
+				};
+				if (typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches) {
+					redrawRef.current = () => {
+						const current = stateRef.current;
+						for (const s of STATES) weights[s] = s === current ? 1 : 0;
+						draw(0, envelope(0), SCALE[current]);
+					};
+					redrawRef.current();
+					return () => {
+						redrawRef.current = null;
+					};
+				}
+				let t = 0;
+				let amplitude = 0;
+				let scale = SCALE[stateRef.current];
+				let velocity = 0;
+				let last = performance.now();
+				let raf = 0;
+				const frame = (now) => {
+					const dt = Math.min((now - last) / 1e3, .05);
+					last = now;
+					t += dt;
+					const current = stateRef.current;
+					const target = envelope(t);
+					const rate = target > amplitude ? ATTACK : RELEASE;
+					amplitude += (target - amplitude) * (1 - Math.pow(1 - rate, dt * 60));
+					const step = 1 - Math.pow(.84, dt * 60);
+					for (const s of STATES) weights[s] += ((s === current ? 1 : 0) - weights[s]) * step;
+					velocity += (-180 * (scale - SCALE[current]) - DAMPING * velocity) * dt;
+					scale += velocity * dt;
+					draw(t, amplitude, scale);
+					raf = requestAnimationFrame(frame);
+				};
+				raf = requestAnimationFrame(frame);
+				return () => cancelAnimationFrame(raf);
+			}, [color, dpr]);
+			(0, react.useEffect)(() => {
+				redrawRef.current?.();
+			}, [state]);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("canvas", {
+				ref: canvasRef,
+				"aria-hidden": true,
+				className: "dsgc-orb",
+				style: {
+					width: SIZE,
+					height: SIZE
+				}
+			});
+		}
+		//#endregion
 		//#region src/client/components/MessageFlow.tsx
 		function MessageFlow(props) {
 			const { snap, sess, busyNow, msgById, action, onRetrySpeak } = props;
@@ -2133,15 +2295,20 @@ window.__ModuleLoader__.load({
 			const replaceMsg = replaceId ? msgById[replaceId] : null;
 			const liveRoleId = snap.run.currentRoleId || replaceMsg && (replaceMsg.failedRoleId || replaceMsg.speaker) || null;
 			const lr = busyNow && liveRoleId ? roleById(snap, liveRoleId) : null;
+			const liveColor = lr ? lr.color || "#888" : "#888";
+			const orbState = snap.run.partial ? "listening" : "thinking";
 			const live = lr ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsgc-msg live",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: "dsgc-avatar",
 					style: {
-						border: "2px solid " + (lr.color || "#888"),
-						"--role-color": lr.color || "#888"
+						border: "2px solid " + liveColor,
+						"--role-color": liveColor
 					},
-					children: lr.name.slice(0, 1)
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SpeakerOrb, {
+						state: orbState,
+						color: liveColor
+					})
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "dsgc-msgbody",
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2615,7 +2782,7 @@ window.__ModuleLoader__.load({
 								!input.trim() ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "dsgc-ph",
 									"aria-hidden": "true",
-									children: "发消息给全群，@成员 点名让其回应（留空则让角色自由讨论）…"
+									children: "发消息给全群，@成员 点名让其回应…"
 								}) : null,
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "dsgc-edit",
@@ -2698,7 +2865,7 @@ window.__ModuleLoader__.load({
 									onClick: () => {
 										sendMsg();
 									},
-									disabled: !participants.length && !mentionedRoles.length || !sess,
+									disabled: !input.trim() || !participants.length && !mentionedRoles.length || !sess,
 									children: [Icon(_deepseek_ai_dsh_client_ui_primitives.IconSendOutline16, 16), "发送"]
 								})
 							]
@@ -2801,7 +2968,7 @@ window.__ModuleLoader__.load({
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "dsgc-hint",
-									children: enabledRoles.length ? "发送消息开始讨论；@成员 点名让其优先回应；留空直接发送可让角色自由讨论——每轮全体参与角色按顺序各发言一次，可用右下角轮数控制（1–10 轮）" : "先在右侧添加角色（每个角色可绑定不同模型），再回到这里发起讨论。"
+									children: enabledRoles.length ? "发送消息开始讨论；@成员 点名让其优先回应——每轮全体参与角色按顺序各发言一次，可用右下角轮数控制（1–10 轮）" : "先在右侧添加角色（每个角色可绑定不同模型），再回到这里发起讨论。"
 								})
 							]
 						})
@@ -3528,6 +3695,7 @@ window.__ModuleLoader__.load({
 			const { insertChip, insertFileChip } = useMentionChip(inputRef, setMention, setMentionIdx, syncFromDOM);
 			const sendMsg = (0, react.useCallback)(async () => {
 				if (busyNow || !sess || sendingRef.current) return;
+				if (!input.trim()) return;
 				sendingRef.current = true;
 				try {
 					if (!participants.length && !mentionedRoles.length) {