dsh-fish-soul 0.15.39 → 0.15.41

package/README.md

@@ -2,7 +2,7 @@
 
 让一个 QQ 小号背后有"同一个人"：固定人格、按人记记忆、有自己的生活节奏、会主动开口；同一个"她"同时出现在 QQ、B站、抖音。
 
-DSH 插件（单角色 `feiyu`）。版本 **0.15.39**。
+DSH 插件（单角色 `feiyu`）。版本 **0.15.41**。
 
 QQ 交流群：**1125962189**
 

package/lib/client.diag.js

@@ -0,0 +1,107 @@
+/**
+ * dsh-fish-soul — 设置面板「运行日志」页（client.diag.js，按需加载的包内分块）
+ *
+ * 主面板 client.js 用 require.async("./client.diag.js") 拿到 DiagPane；
+ * api / notify / 控件（props.ui）都由主面板传进来，分块自己不 require 主文件。
+ *
+ * 🔴 必须走 window.__ModuleLoader__.load 注册：裸 ES module 宿主能加载文件，
+ *    但不会注册，设置页报 "loaded without registering"（2026-11-12 真机踩过）。
+ *
+ * 两个视图共用一份数据：
+ *   - 默认中文时间线：给用户看，也方便原样贴到 issue；
+ *   - 「看原始」切 JSON：给维护者 grep。
+ *
+ * 这里只放**装置层面**的事件（启动卡在哪、人格段挂不上、会话恢复失败、上下文长度）。
+ * 对话层面的「谁说了什么、想起了几条」在「日常 → 最近动态」那边 —— 一事实一出处。
+ */
+window.__ModuleLoader__.load({
+	id: "dsh-fish-soul",
+	chunk: "client.diag.js",
+	factory: (require) => {
+		const react = require("react");
+
+		/** 跟 ActivityPane 一样的轮询小工具（各分块页各有一份，不跨块 import）。 */
+		function usePoll(api, path, ms) {
+			const [data, setData] = react.useState(null);
+			const load = react.useCallback(async () => {
+				const r = await api("GET", path);
+				if (r?.ok) setData(r);
+			}, [api, path]);
+			react.useEffect(() => {
+				let alive = true;
+				const run = async () => { if (alive) await load(); };
+				run();
+				const t = setInterval(run, ms);
+				return () => { alive = false; clearInterval(t); };
+			}, [load, ms]);
+			return [data, load];
+		}
+
+		function DiagPane({ api, notify, ui }) {
+			const { h, Group, Tag, Button, Muted } = ui;
+			const [raw, setRaw] = react.useState(false);
+			const [data, load] = usePoll(api, "/diag-log", 15000);
+			if (!data) return null;
+
+			const entries = data.entries ?? [];
+			const pad = (n) => String(n).padStart(2, "0");
+			const fmtTime = (ms) => {
+				const d = new Date(ms);
+				return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+			};
+			// 一行中文：时间 + 说人话的标题 + 细节
+			const describe = (e) => {
+				const d = e.detail ?? {};
+				const bits = [];
+				if (d.step !== undefined) bits.push(`第 ${d.step} 步${d.name ? `「${d.name}」` : ""}`);
+				if (d.sessionId) bits.push(`会话 ${String(d.sessionId).slice(0, 12)}…`);
+				if (d.channelId) bits.push(`聊天 ${d.channelId}`);
+				if (d.chars !== undefined) bits.push(`${d.chars} 字${d.budget ? ` / 预算 ${d.budget}` : ""}${d.over80 ? "（超 80%）" : ""}`);
+				if (d.reason) bits.push(String(d.reason).slice(0, 120));
+				if (e.count > 1) bits.push(`重复 ${e.count} 次`);
+				return bits.join("，") || "（没有细节）";
+			};
+			const levelStyle = (lv) => (lv === "error"
+				? { color: "var(--dsw-alias-state-error-primary, #d93025)" }
+				: lv === "warn" ? { color: "var(--dsw-alias-state-warning-primary, #b26a00)" } : null);
+
+			return Group({
+				title: "运行日志",
+				aside: h("span", { style: { display: "flex", gap: 8, alignItems: "center" } },
+					Tag(String(entries.length), "outline"),
+					Button({ variant: "ghost", onClick: () => load() }, "刷新"),
+					Button({ variant: "ghost", onClick: () => setRaw((v) => !v) }, raw ? "看时间线" : "看原始"),
+					Button({
+						variant: "ghost", disabled: entries.length === 0,
+						onClick: async () => {
+							const r = await api("POST", "/diag-log/clear", {});
+							if (r?.ok) { notify("已清空"); load(); } else notify(r?.error ?? "清空失败");
+						}
+					}, "清空"))
+			},
+				Muted("插件自己的运行记录：启动到哪一步、人格卡/瞬态块有没有挂上、会话是新建还是恢复、每轮上下文多长。只留最近 200 条，不落盘。"),
+				Muted("这里没有「宿主压缩上下文」的记录 —— 宿主不广播那个事件，插件看不到。上下文变长能在「这一轮上下文长度」里看出来。"),
+				entries.length === 0
+					? h("div", { className: "fs-empty" }, "还没有记录。重启宿主后回来就能看到启动过程。")
+					: raw
+						? h("pre", {
+							className: "fs-report",
+							style: { maxHeight: 420, overflow: "auto", fontSize: 12, whiteSpace: "pre-wrap", wordBreak: "break-all" }
+						}, JSON.stringify(entries, null, 2))
+						: h("div", { style: { display: "flex", flexDirection: "column", gap: 2 } },
+							entries.map((e, i) => h("div", {
+								key: `${e.at}-${i}`,
+								style: {
+									display: "flex", gap: 10, alignItems: "baseline",
+									padding: "4px 0", borderBottom: "1px solid var(--dsw-alias-border-l1, #eee)", fontSize: 13
+								}
+							},
+								h("span", { style: { color: "var(--dsw-alias-text-3, #888)", fontVariantNumeric: "tabular-nums", flex: "0 0 auto" } }, fmtTime(e.at)),
+								h("span", { style: { fontWeight: 500, flex: "0 0 auto", ...(levelStyle(e.level) ?? {}) } }, e.label),
+								h("span", { style: { color: "var(--dsw-alias-text-2, #555)", wordBreak: "break-word" } }, describe(e)))))
+			);
+		}
+
+		return { DiagPane };
+	}
+});

package/lib/client.douyin.js

@@ -163,7 +163,7 @@ window.__ModuleLoader__.load({
 					Row({ title: "主人的名字", desc: "仅作显示（提示词里怎么称呼）；不授予任何权限" }, Input({ ...bind("masterName"), placeholder: "她私信列表里你的名字" })),
 					Row({ title: "回所有能私信她的人", desc: d.replyAll ? "建议在抖音隐私设置里把「谁可以私信我」设为互关好友" : null },
 						sw("回所有能私信她的人", d.replyAll === true, (v) => save({ top: { replyAll: v } }))),
-					d.replyAll ? null : Row({ title: "白名单", stack: true }, Area({ ...bind("allowList"), placeholder: "对方的抖音数字 uid，每行一个；昵称不参与放行" })),
+					d.replyAll ? null : Row({ title: "白名单", stack: true }, Area({ ...bind("allowList"), placeholder: "对方的抖音数字 uid，每行一个；昵称不参与放行" }))),
 				Group({ title: "群聊" },
 					Row({ title: "群里被叫到时回", desc: "群聊按说话的人分开认，不会当成一个人；没人 @ 她或叫她名字时只看不说" },
 						sw("群里被叫到时回", d.groupReply === true, (v) => save({ top: { groupReply: v } }))),

package/lib/client.js

@@ -806,14 +806,14 @@ window.__ModuleLoader__.load({
 		}
 
 		// ── 面板根组件：页签 + 数据装载 + 轮询 ──
-		const TAB_KEYS = { memory: "忆", character: "角", daily: "常", channels: "台", models: "模", system: "统", guide: "引", retrieval: "索", persona: "人", life: "自", inspector: "忆", activity: "动", behavior: "习", qq: "Q", bili: "B", douyin: "抖", version: "版" };
+		const TAB_KEYS = { memory: "忆", character: "角", daily: "常", channels: "台", models: "模", system: "统", guide: "引", retrieval: "索", persona: "人", life: "自", inspector: "忆", activity: "动", behavior: "习", qq: "Q", bili: "B", douyin: "抖", version: "版", diag: "志" };
 		const TABS = [
 			["memory", "记忆", [["retrieval", "检索设置"], ["people", "人物与关系"], ["memories", "记忆内容"], ["recall-test", "检索测试"], ["weekly", "周记"], ["archives", "记忆存档"], ["backups", "导入与备份"]]],
 			["character", "角色", [["persona", "人格卡"], ["templates", "人格模板"], ["growth", "成长"], ["worldinfo", "世界书"], ["habits", "说话习惯"], ["groups", "群设定"], ["chat-models", "聊天模型"]]],
 			["daily", "日常", [["life", "主动开口"], ["activity", "最近动态"], ["diary", "日记"], ["stickers", "表情包"], ["slang", "学到的说法"]]],
 			["channels", "平台", [["qq", "QQ"], ["bili", "B站"], ["douyin", "抖音"]]],
 			["models", "模型", [["models", "功能模型"], ["usage", "用量与价格"], ["web", "联网搜索"], ["voice", "语音"]]],
-			["system", "系统", [["interface", "界面"], ["version", "版本更新"]]]
+			["system", "系统", [["interface", "界面"], ["version", "版本更新"], ["diag", "运行日志"]]]
 		];
 		const NAV_GROUPS = TABS.map(([id, label]) => ({ id, label }));
 		const SUBTABS = Object.fromEntries(TABS.map(([id, , subs]) => [id, subs]));
@@ -1010,6 +1010,7 @@ window.__ModuleLoader__.load({
 				: ["habits", "groups", "chat-models", "diary"].includes(subtab) ? h(ChunkTab, { file: "client.behavior.js", pick: (m) => m.BehaviorPane, failText: "习惯页加载失败", section: subtab === "chat-models" ? "models" : subtab, notify })
 				: ["models", "usage", "web", "voice"].includes(subtab) ? h(ChunkTab, { file: "client.models.js", pick: (m) => m.ModelsPane, failText: "模型页加载失败", section: subtab, notify })
 				: ["persona", "templates", "growth", "worldinfo"].includes(subtab) ? h(ChunkTab, { file: "client.persona.js", pick: (m) => m.PersonaPane, failText: "人格页加载失败", section: subtab === "persona" ? "current" : subtab, notify })
+				: subtab === "diag" ? h(ChunkTab, { file: "client.diag.js", pick: (m) => m.DiagPane, failText: "运行日志加载失败", notify })
 				: subtab === "qq" ? h(ChannelPane, { data: channels, refresh: loadChannels, notify })
 				: subtab === "bili" ? h(BiliPane, { data: channels, refresh: loadChannels, notify })
 				: h(ChunkTab, { file: "client.douyin.js", pick: (m) => m.DouyinPane, failText: "抖音页加载失败", data: channels, refresh: loadChannels, notify });

package/lib/diag-log.js

@@ -0,0 +1,130 @@
+/**
+ * diag-log.js —— 排查用的结构化日志（系统页「运行日志」）。
+ *
+ * 和动态页（gateway.decisions）的区别：
+ *   - decisions 记的是**对话层面**的事（谁说了什么、想起了几条），给人翻的；
+ *   - 这里记的是**装置层面**的事（启动卡在哪、人格段挂不上、会话恢复失败降级新建、
+ *     上下文长度趋势），是"她为什么突然不对劲"时第一个要看的地方。
+ *
+ * 两个视图共用一份数据：
+ *   - 中文时间线：给用户看，也方便贴到 issue 里；
+ *   - 原始 JSON：给维护者 grep。
+ *
+ * 设计约束：
+ *   - 只在内存里留最近 N 条（默认 200），**不落盘** —— 这是排查快照不是审计日志，
+ *     落盘会变成第二个事实来源，也会把日志越攒越大。
+ *   - 同样的 key 在短时间窗内重复发生时只累加 count，不刷屏（启动失败那种每秒一次的
+ *     情况不会把缓冲冲干净）。
+ */
+import { getKv, setKv } from './db.js';
+
+/** 内存里最多留多少条。 */
+const LIMIT = 200;
+/** 同一个 key 在这个窗口内重复出现就合并计数（毫秒）。 */
+const DEDUPE_MS = 60_000;
+
+/**
+ * 每条日志的中文说法。key 是稳定的机器标识，人话在这里查。
+ * 加新 key 时**必须**在这里补一条，否则界面会显示成 key 本身（这是故意的：
+ * 宁可露出机器名，也别悄悄显示成空白让人以为没发生）。
+ */
+const LABELS = {
+	'startup-step': '启动到某一步',
+	'startup-failed': '启动失败',
+	'mount-failed': '人格卡 / 瞬态块挂不上',
+	'mount-no-ctx': '拿不到 agent.ctx',
+	'session-create': '新建了会话',
+	'session-resume': '恢复了会话',
+	'resume-failed': '恢复会话失败，改为新建',
+	'session-retired': '会话退役',
+	'context-size': '这一轮上下文长度',
+	'image-skip': '图片没送进模型',
+	'sticker-skip': '表情没收藏成功',
+	'turn-no-recall': '这一轮没组装记忆',
+	'config-invalid': '配置文件读不懂'
+};
+
+export class DiagLog {
+	/**
+	 * @param {{ db: object, log?: Function, now?: () => number }} deps
+	 */
+	constructor({ db, log, now = () => Date.now() }) {
+		this.db = db;
+		this.log = log ?? (() => {});
+		this.now = now;
+		/** @type {Array<{at:number,key:string,level:string,detail:object,count:number}>} */
+		this.entries = [];
+		this.lastKeyAt = new Map();
+	}
+
+	/**
+	 * 记一条。
+	 * @param {string} key LABELS 里的机器标识
+	 * @param {object} [detail] 结构化细节（别塞大对象：这里只留 200 条）
+	 * @param {'info'|'warn'|'error'} [level]
+	 */
+	add(key, detail = {}, level = 'info') {
+		const at = this.now();
+		const k = String(key);
+		// 同一个 key 在窗口内重复：合并成一条 + count，别把缓冲冲干净
+		const lastAt = this.lastKeyAt.get(k) ?? 0;
+		if (at - lastAt < DEDUPE_MS && this.entries.length > 0) {
+			const tail = this.entries[this.entries.length - 1];
+			if (tail.key === k) {
+				tail.count += 1;
+				tail.at = at;
+				tail.detail = detail;
+				this.lastKeyAt.set(k, at);
+				return;
+			}
+		}
+		this.lastKeyAt.set(k, at);
+		this.entries.push({ at, key: k, level, detail, count: 1 });
+		if (this.entries.length > LIMIT) this.entries.splice(0, this.entries.length - LIMIT);
+		// 同时打一行到宿主日志：设置页没开着的时候也能在终端看到
+		if (level !== 'info') this.log(level, `[fish-soul] ${LABELS[k] ?? k}：${JSON.stringify(detail).slice(0, 200)}`);
+	}
+
+	/** 这一轮上下文长度（字符数粗估）。只在明显变化时记，避免每轮刷一条。 */
+	noteContextSize(sessionId, chars, budget) {
+		const key = `ctx:${String(sessionId)}`;
+		const prev = getKv(this.db, key, null);
+		const n = Number(chars) || 0;
+		// 变化不到 20% 且没跨过 80% 预算线就不记
+		const crossed = budget > 0 && n >= budget * 0.8 && !(prev !== null && Number(prev) >= budget * 0.8);
+		if (prev !== null && !crossed && Math.abs(n - Number(prev)) < Math.max(200, Number(prev) * 0.2)) return;
+		setKv(this.db, key, n);
+		this.add('context-size', { sessionId: String(sessionId).slice(0, 24), chars: n, budget: Number(budget) || 0, over80: budget > 0 ? n >= budget * 0.8 : false });
+	}
+
+	/** 给界面用：最近的日志，新的在前。 */
+	list(limit = LIMIT) {
+		return [...this.entries].reverse().slice(0, limit).map((e) => ({
+			at: e.at,
+			key: e.key,
+			label: LABELS[e.key] ?? e.key,
+			level: e.level,
+			detail: e.detail,
+			count: e.count
+		}));
+	}
+
+	/** 清空（设置页「清空日志」按钮）。 */
+	clear() {
+		this.entries.length = 0;
+		this.lastKeyAt.clear();
+	}
+}
+
+/** 一行中文（时间线视图用）。放在这里而不是前端：格式化逻辑要能测。 */
+export function describeEntry(entry) {
+	const d = entry.detail ?? {};
+	const bits = [];
+	if (d.step !== undefined) bits.push(`第 ${d.step} 步${d.name ? `「${d.name}」` : ''}`);
+	if (d.sessionId) bits.push(`会话 ${String(d.sessionId).slice(0, 12)}…`);
+	if (d.channelId) bits.push(`聊天 ${d.channelId}`);
+	if (d.chars !== undefined) bits.push(`${d.chars} 字${d.budget ? ` / 预算 ${d.budget}` : ''}${d.over80 ? '（超 80%）' : ''}`);
+	if (d.reason) bits.push(String(d.reason).slice(0, 120));
+	if (entry.count > 1) bits.push(`重复 ${entry.count} 次`);
+	return bits.join('，') || '（没有细节）';
+}

package/lib/gateway.js

@@ -132,7 +132,7 @@ export class ChatGateway {
 	 * @param {object} deps.soul index.js 提供的人格/记忆回调
 	 * @param {(agentCtx: object) => void} [deps.agentSections] 给单个 agent 挂人格卡 / 瞬态块（index.js 传入 registerAgentSections）
 	 */
-	constructor({ ctx, db, clock, getConfig, log, channel, bili = null, browser = null, douyin = null, douyinBrowser = null, canvasConvert = null, soul, voice = null, stickers = null, slang = null, agentSections = null, groupAdmin = null, embedder = null, embeddingCfg = null }) {
+	constructor({ ctx, db, clock, getConfig, log, channel, bili = null, browser = null, douyin = null, douyinBrowser = null, canvasConvert = null, soul, voice = null, stickers = null, slang = null, agentSections = null, groupAdmin = null, embedder = null, embeddingCfg = null, diag = null }) {
 		this.ctx = ctx;
 		this.db = db;
 		this.clock = clock;
@@ -170,6 +170,7 @@ export class ChatGateway {
 		this.groupAdmin = groupAdmin;
 		/** 给单个 agent 挂人格卡 / 瞬态块：`(agentCtx) => void`（在 setup 里调，只对那个 agent 生效） */
 		this.agentSections = agentSections;
+		this.diag = diag;
 		/** sessionId → chat_session 行（只存我们建的会话） */
 		this.bound = new Map();
 		/** channelId → Promise<Agent>（同一聊天并发来消息时只建一个会话） */
@@ -278,7 +279,9 @@ export class ChatGateway {
 		this.decisions.unshift({
 			at: Date.now(), kind, channelId, title: title || this.titleOf(channelId),
 			who: String(who ?? '').slice(0, 24), text: String(text ?? '').replace(/\s+/g, ' ').slice(0, 80), reason,
-			...(Array.isArray(memories) && memories.length > 0 ? { memories: memories.slice(0, 5) } : {}),
+			// #78：以前写死 5 条，用户把「召回条数」调到 10 后动态页永远只显示 5 条，
+			// 看起来像「设置没生效」。上限跟 topK 走（再留个 20 的硬顶，别让一条动态撑爆）。
+			...(Array.isArray(memories) && memories.length > 0 ? { memories: memories.slice(0, Math.min(20, Math.max(5, Number(this.getConfig?.()?.retrieval?.topK) || 5))) } : {}),
 			// #78：这一轮记忆到底有没有参与。没跑 / 认不出人 / 跑了没召回到，界面要分得开 ——
 			// 以前三种都是"什么都不显示"，看不出问题在哪儿
 			...(Number(recallAt) > 0 ? { recallAt: Number(recallAt), speakerUnknown: speakerUnknown === true } : {}),
@@ -705,9 +708,12 @@ export class ChatGateway {
 						setup: (agentCtx) => this.setupAgent(agentCtx, key)
 					});
 					this.log('info', `[fish-soul] 已恢复会话 ${row.title || key}`);
+					this.diag?.add('session-resume', { sessionId: row.session_id, channelId: key });
 					return handle.agent;
 				} catch (error) {
-					this.log('warn', `[fish-soul] 恢复会话 ${row.session_id} 失败，改为新建：${String(error instanceof Error ? error.message : error)}`);
+					const msg = String(error instanceof Error ? error.message : error);
+					this.log('warn', `[fish-soul] 恢复会话 ${row.session_id} 失败，改为新建：${msg}`);
+					this.diag?.add('resume-failed', { sessionId: row.session_id, channelId: key, reason: msg }, 'warn');
 					this.db.prepare("UPDATE chat_session SET status = 'retired' WHERE id = ?").run(row.id);
 					this.bound.delete(row.session_id);
 				}
@@ -756,6 +762,7 @@ export class ChatGateway {
 			setup: (agentCtx) => this.setupAgent(agentCtx, chat.channelId)
 		});
 		const title = await this.chatTitle(chat);
+		this.diag?.add('session-create', { sessionId, channelId: chat.channelId, reason: title });
 		try { await ws.attachSession?.(sessionId); } catch (error) {
 			this.log('warn', `[fish-soul] 会话挂到工作区失败：${String(error instanceof Error ? error.message : error)}`);
 		}
@@ -1371,7 +1378,9 @@ export class ChatGateway {
 			//    以前每条都重算 fromUs ⇒ 被它们改成 false ⇒ 回复生成了却不发（DSH 里看得见，QQ / 抖音收不到）。
 			//    现在只有我们自己的来源置 true；只有真人在界面里打字（kind 'user'）才置 false；别的宿主上下文不管。
 			if (OUR_SOURCES.has(kind)) st.fromUs = true;
-			else if (kind === 'user') st.fromUs = false;
+			else if (kind === 'user') { st.fromUs = false; st.dshTyped = true; } // #78：DSH 桌面端打字，不外发但要记动态
+			// 其他宿主上下文（runtime-context / model-selection 等）：不动 fromUs ——
+			// 它们不是我们发的消息，但也不是真人打字，重置会把 B站/抖音 的回复憋回去（smoke #13 守着）
 			// 共享会话里一个会话对应多个通道（QQ + B站）：这一轮从哪个通道进来的，来源里也带着 ——
 			// 开轮时 dispatch 已经登记过，这里兜的是「插件重启后宿主重放消息」那条路（否则会回错平台）
 			if (OUR_SOURCES.has(kind) && msg?.source?.channelId) st.channelId = String(msg.source.channelId);
@@ -1409,6 +1418,19 @@ export class ChatGateway {
 			};
 			if (!completed || !st.fromUs) {
 				if (st.fromUs) this.note('failed', { channelId: st.channelId ?? this.bound.get(sessionId)?.channel_id ?? '', reason: `这一轮没正常结束（${d.reason?.kind ?? '未知'}）` });
+				// #78：DSH 桌面端打字的轮次不外发，但**要记动态** —— 以前在 DSH 里聊，动态页整片空白。
+				if (st.dshTyped === true) {
+					const recall = this.soul.recallInfo?.(sessionId, st) ?? { memories: [], at: 0, unknown: false };
+					this.note('dsh', {
+						channelId: st.channelId ?? this.bound.get(sessionId)?.channel_id ?? '',
+						text: String(st.text ?? '').slice(0, 60),
+						reason: '在 DSH 里聊的，不外发',
+						memories: recall.memories ?? [],
+						recallAt: recall.at ?? 0,
+						speakerUnknown: recall.unknown === true,
+						recallMiss: recall.miss ?? ''
+					});
+				}
 				this.interjectTurns.delete(sessionId);
 				settle(false);
 				return;

package/lib/index.js

@@ -52,6 +52,7 @@ import { VirtualClock } from './clock.js';
 import { EmbeddingClient, VectorWorker, recall, recallSync, vectorRanks } from './retrieval.js';
 import { LifeEngine } from './life.js';
 import { registerRoutes, registerAgentHooks, registerAgentSections, mountApiGate } from './routes.js';
+import { DiagLog } from './diag-log.js';
 import { UpdateChecker, pluginVersion } from './update-check.js';
 import { GroupAdmin } from './qq-group-admin.js';
 import { tokenizeForBm25 } from './segment.js';
@@ -71,7 +72,7 @@ const defineTool = hostDeps.defineTool;
 export const name = 'dsh-fish-soul';
 
 /** 只给测试用：换掉抖音专用浏览器的启动 / 页面驱动（抖音网页在测试里打不开）。正式运行时是空的。 */
-export const testHooks = { douyin: null, memory: null };
+export const testHooks = { douyin: null, memory: null, gateway: null };
 // agents / workspaceRegistry：给每个 QQ 聊天建会话；sessionTitle / attachments / agentPresets /
 // agentDefaultModel 是可选的，运行时用 ctx.get 取，缺了就降级（不写进 inject，免得整个插件不激活）。
 export const inject = ['webServer', 'tools', 'systemPrompt', 'llm', 'agents', 'workspaceRegistry'];
@@ -188,9 +189,13 @@ export async function apply(ctx, config) {
 }
 
 async function startup(ctx, config, { log, gate }) {
+	// 排查日志：启动每一步都记一条 —— 「插件挂在第几步」是最常被问的问题，
+	// 以前只在宿主终端里有，重启就没了（系统页「运行日志」读这个）。
+	const diag = new DiagLog({ db: null, log, now: () => Date.now() });
 	const step = (name) => {
 		gate.step(name);
 		log('debug', `[fish-soul] 启动第 ${gate.state.index}/${gate.state.total} 步：${name}`);
+		diag.add('startup-step', { step: gate.state.index, name });
 	};
 	// 配置来源：宿主 Config（schema 默认值）为底，设置页写的文件覆盖其上——
 	// 旧实现 {...file, ...host} 浅合并会让 schema 的空默认值把文件里的 Key/BaseURL 清空。
@@ -223,6 +228,7 @@ async function startup(ctx, config, { log, gate }) {
 	// 虚拟钟从上次快照续走（加速验收中途重启不倒退）
 	const clock = new VirtualClock(undefined, Number(getKv(db, 'clock.virtualMs', 0)) || 0);
 
+	diag.db = db;
 	step(STARTUP_STEPS[1]);
 	// ── 检索 ──
 	const embedder = new EmbeddingClient(embeddingCfg);
@@ -831,7 +837,14 @@ async function startup(ctx, config, { log, gate }) {
 			}
 		}
 		if (persona.postHistory !== '') lines.push(applyMacros(persona.postHistory, { charName: persona.name, userName }));
-		return lines.join('\n');
+		const block = lines.join(String.fromCharCode(10));
+		// 上下文长度趋势：宿主压缩（compaction）插件这边看不到，但「越来越长」是能测的。
+		// 只在明显变化或跨过 80% 预算线时记一条，别每轮刷。
+		try {
+			const sid = arg?.agent?.id ?? arg?.scope?.id ?? arg?.sessionId;
+			if (sid !== undefined) diag.noteContextSize(sid, block.length, Number(currentConfig.retrieval?.tokenBudget) || 1200);
+		} catch { /* 记日志失败不影响这一轮 */ }
+		return block;
 	}
 
 	/** 宿主消息正文（content 是块数组）。 */
@@ -856,10 +869,15 @@ async function startup(ctx, config, { log, gate }) {
 		// mountSectionsFor 有幂等保护（sectionsMounted），所有会话都在 inbox 时补挂一次做保险。
 		mountSectionsFor(payload?.agent);
 		if (source.kind === SOURCE_QQ || source.kind === SOURCE_PROACTIVE || source.kind === SOURCE_BILI || source.kind === SOURCE_DOUYIN) return;
-		if (gateway?.isOurSession(agentId)) return;
 		if (agentId === undefined || agentId === null) return;
+		// #78：**在 DSH 界面里打开我们的会话打字**时，isOurSession 是 true，但消息不走
+		// gateway.dispatch（那条路只服务 QQ / B站 / 抖音 的入站），于是没有 beginTurn、
+		// 也没有 note —— 动态页整片空白。用户原话：「只能在 QQ 上说话才能正常调起功能」。
+		// 现在这条路也登记一轮：身份按 DSH 桌面端算（#57：桌面端就是主人自己的环境）。
+		const ours = gateway?.isOurSession(agentId) === true;
 		const qqUin = String(source.userId ?? source.qqUin ?? source.user_id ?? '');
-		const person = qqUin === '' ? null : resolveOrCreatePerson(db, {
+		// 我们的会话在 DSH 里被打开时，说话的人就是主人自己 —— 不去猜 QQ 号（那会建出幽灵 person）
+		const person = ours || qqUin === '' ? null : resolveOrCreatePerson(db, {
 			qqUin, nickname: String(source.nickname ?? ''), nowMs: clock.now(), masterQqUin: currentConfig.masterQqUin ?? ''
 		});
 		if (person !== null) life.noteInteraction(ownerOf(person));
@@ -868,11 +886,14 @@ async function startup(ctx, config, { log, gate }) {
 		else life.noteInteraction('user:master');
 		const groupId = source.groupId ?? source.group_id ?? null;
 		// #56：桌面端（person=null）也把消息文本传进去——世界书扫描要用，身份仍是 unknown。
+		// 我们的会话在 DSH 里打字：沿用这个会话真正的 channelId（记忆/日志仍按它归），
+		// 只是说话人按主人算 —— 这样瞬态块能跑、动态页也能显示这一轮想起了什么。
+		const boundChannel = ours ? (gateway?.chatForSession(agentId)?.channel_id ?? '') : '';
 		beginTurn(agentId, {
-			channel: person === null ? 'dsh' : (groupId != null ? 'qq-group' : 'qq-private'),
-			channelId: person === null ? '' : (groupId != null ? `group:${groupId}` : `private:${qqUin}`),
-			speakers: [{ person, userId: qqUin, displayName: person?.display_name ?? '对方', text: messageText(message) }],
-			workspacePath: ''
+			channel: ours ? sessionChannelOf(boundChannel) : (person === null ? 'dsh' : (groupId != null ? 'qq-group' : 'qq-private')),
+			channelId: ours ? boundChannel : (person === null ? '' : (groupId != null ? `group:${groupId}` : `private:${qqUin}`)),
+			speakers: [{ person, userId: qqUin, displayName: person?.display_name ?? (ours ? '主人' : '对方'), text: messageText(message) }],
+			workspacePath: ours ? (gateway?.chatForSession(agentId)?.workspace_path ?? '') : ''
 		});
 		// #41：别的插件把自己的 QQ 消息转进它建的会话 —— 那个会话不走我们的 create/resume，人格卡没挂上。
 		// 认出身份后（有人说话）用宿主给的 `agent.ctx` 补挂，仍然只对这一个 agent 生效，不碰全局。
@@ -921,6 +942,7 @@ async function startup(ctx, config, { log, gate }) {
 	slang.start();
 	ctx.effect(() => () => slang.stop(), 'dsh-fish-soul: slang');
 
+	testHooks.gateway = null;
 	gateway = new ChatGateway({
 		ctx, db, clock, getConfig, log, channel, bili, browser, douyin, douyinBrowser, canvasConvert, voice, stickers, slang,
 		// 按感觉挑表情：复用记忆那套嵌入模型（主人拍板）。没配就跟以前一样按文件名发
@@ -928,6 +950,7 @@ async function startup(ctx, config, { log, gate }) {
 		groupAdmin, // 群管理（入群申请）：主人回"/鱼 同意/拒绝"时用它
 		// 每个自家会话建/恢复好后，把人格卡 + 此刻状态挂到它的 agent 上（不注册全局段，别的会话看不见）
 		agentSections: (agentCtx) => registerAgentSections(agentCtx, { personaText: () => persona.staticText, buildContextBlock, log }),
+		diag,
 		soul: {
 			beginTurn,
 			nowLabel,
@@ -1069,12 +1092,13 @@ async function startup(ctx, config, { log, gate }) {
 		db, clock, embedder, worker, life, getConfig, saveConfig, log, gateway, channel, bili, biliClient, browser, biliSocial, douyinSocial,
 		douyin, douyinHost, douyinBrowser, backup, historyImporter, updater, worldBooks,
 		llmRouter, voice, stickers, slang, persona, reloadPersona, webConfig, hasWebTools, webUsedToday, hostWebAvailable, hostWebState, runWebSearch,
-		journal, digester, diary, weekly, storage, chatArchive,
+		journal, digester, diary, weekly, storage, chatArchive, diag,
 		debugRecall: (o) => debugRecall({ db, clock, embedder, embeddingCfg: embeddingCfg(), config: retrievalCfg(), ...o })
 	});
 
 	log('info', '[fish-soul] 路由已挂：设置页接口可用');
 
+	testHooks.gateway = gateway;
 	step(STARTUP_STEPS[15]);
 	// 只挂与具体 agent 无关的全局钩子（互动登记）。人格卡 / 瞬态块是 per-agent 的，
 	// 在 gateway 的 setup(agentCtx) 里挂，这里不再注册任何全局 prompt 段。

package/lib/routes-soul.js

@@ -58,7 +58,7 @@ export function sourceLabel(src, channel = '') {
  * @returns {Promise<boolean>} 处理了就返回 true
  */
 export async function handleSoulRoute({ method, path, url, req, res, send, readBody, sameOrigin, deps }) {
-	const { db, clock, worker, life, gateway, backup, historyImporter, getConfig, saveConfig, journal, digester, weekly, storage, chatArchive } = deps;
+	const { db, clock, worker, life, gateway, backup, historyImporter, getConfig, saveConfig, journal, digester, weekly, storage, chatArchive, diag } = deps;
 	const post = method === 'POST';
 	const body = async () => {
 		const raw = await readBody(req);
@@ -326,6 +326,19 @@ export async function handleSoulRoute({ method, path, url, req, res, send, readB
 	}
 
 	// ── 动态 / 暂停 ──
+	// ── 运行日志（系统页）──
+	// 排查用的装置层面事件：启动卡在哪、人格段挂不上、会话恢复失败、上下文长度。
+	// 和 /activity（对话层面的动态）分开：一事实一出处，别混在一起。
+	if (path === '/diag-log' && method === 'GET') {
+		send(200, { ok: true, entries: (diag?.list?.(200) ?? []) });
+		return true;
+	}
+	if (path === '/diag-log/clear' && post) {
+		if (!guard()) return true;
+		diag?.clear?.();
+		send(200, { ok: true });
+		return true;
+	}
 	if (path === '/activity' && method === 'GET') {
 		const paused = gateway?.pausedMap() ?? {};
 		send(200, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-fish-soul",
-  "version": "0.15.39",
+  "version": "0.15.41",
   "description": "鱼 · 人格、按人记忆（可纠正、有印象、能导入旧聊天记录）、日程自走与主动开口，直连 SnowLuma 收发 QQ（群里会自己插话），B站 / 抖音小号私信与自己刷视频；按功能选模型并统计用量花费，能听会说 QQ 语音、收藏表情包、学群里的梗，可选上网查；心情影响说话、去 AI 味、每个群的设定、按聊天选模型、每晚写日记、每周记忆存档与可选周记（DSH 插件，单角色 feiyu ，v0.15.37）",
   "type": "module",
   "main": "./lib/index.js",
@@ -64,7 +64,7 @@
     }
   },
   "scripts": {
-    "test": "node test/safe-download.mjs && node test/douyin-exact-id.mjs && node test/douyin-pb-init.mjs && node test/douyin-conversation.mjs && node test/douyin-inbox.mjs && node test/douyin-quarantine.mjs && node test/douyin-send-target.mjs && node test/douyin-gap-dedupe.mjs && node test/douyin-read-fail-retry.mjs && node test/douyin-read-cache.mjs && node test/douyin-read-fail-retry-poll.mjs && node test/douyin-inbox-contract.mjs && node test/memory-owner-reassign.mjs && node test/douyin-poll-and-timer-safety.mjs && node test/p2-limits.mjs && node test/resource-safety.mjs && node test/leftover-edge-cases.mjs && node test/douyin-master-uid.mjs && node test/douyin-identity-e2e.mjs && node test/douyin-post-jobs.mjs && node test/retrieval-filtered-vectors.mjs && node test/security-boundaries.mjs && node test/smoke.mjs && node test/douyin-browser.mjs && node test/douyin-music.mjs && node test/startup-gate.mjs && node test/outbox.mjs && node test/import-coverage.mjs && node test/update-check.mjs && node test/issue-fixes.mjs && node test/import-resume.mjs && node test/maibot-extras.mjs && node test/worldinfo.mjs && node test/memory-bulk.mjs && node test/memory-tiers.mjs && node test/memory-weekly.mjs && node test/memory-storage.mjs && node test/memory-storage-restore.mjs && node test/backup-restore.mjs && node test/douyin-group.mjs && node test/review-fixes.mjs && node test/at-reads-video.mjs && node test/search-source.mjs && node test/followups.mjs && node test/detail-config.mjs && node test/qq-send-any-image.mjs && node test/qq-read-attachment.mjs && node test/qq-batch-window.mjs && node test/comment-video.mjs && node test/frames.mjs && node test/face-name.mjs && node test/comment-reply.mjs && node test/chat-comment.mjs && node test/at-target.mjs && node test/quota-caps.mjs && node test/client-lint.mjs && node test/client-panels.mjs && node test/dsh-desktop.mjs && node test/issue-59-interject.mjs && node test/issue-59-diagnose.mjs && node test/sticker-manage.mjs && node test/bili-emotes.mjs && node test/qq-outbound-sanitize.mjs && node test/person-delete.mjs && node test/qq-group-admin.mjs && node test/douyin-recovery.mjs && node test/session-preset.mjs && node test/qq-connect-error.mjs && node test/douyin-comment-bridge.mjs && node test/bili-comment-emoji.mjs && node test/douyin-state-echo.mjs && node test/issue-75-proactive.mjs && node test/issue-76-capability.mjs && node test/douyin-http-browse.mjs && node test/douyin-verify-backoff.mjs && node test/douyin-digg-bridge.mjs && node test/memory-evidence-transcript.mjs && node test/chat-archive-default.mjs && node test/dream-transcript-wire.mjs && node test/douyin-frames-collect.mjs && node test/master-qq-uin-rebind.mjs && node test/douyin-session-health.mjs && node test/douyin-delivered.mjs && node test/douyin-card-share.mjs && node test/douyin-push-drop.mjs && node test/douyin-uid-binding.mjs && node test/image-webp-fallback.mjs && node test/douyin-emoji-fallback.mjs && node test/relay-other-platform.mjs && node test/voice-volcengine.mjs && node test/voice-minimax-dashscope.mjs && node test/bili-switch-persist.mjs && node test/cross-channel-context.mjs && node test/reply-target.mjs && node test/shared-session.mjs && node test/memory-source-label.mjs && node test/pending-delivery.mjs && node test/recall-window-78.mjs && node test/self-update.mjs",
+    "test": "node test/safe-download.mjs && node test/douyin-exact-id.mjs && node test/douyin-pb-init.mjs && node test/douyin-conversation.mjs && node test/douyin-inbox.mjs && node test/douyin-quarantine.mjs && node test/douyin-send-target.mjs && node test/douyin-gap-dedupe.mjs && node test/douyin-read-fail-retry.mjs && node test/douyin-read-cache.mjs && node test/douyin-read-fail-retry-poll.mjs && node test/douyin-inbox-contract.mjs && node test/memory-owner-reassign.mjs && node test/douyin-poll-and-timer-safety.mjs && node test/p2-limits.mjs && node test/resource-safety.mjs && node test/leftover-edge-cases.mjs && node test/douyin-master-uid.mjs && node test/douyin-identity-e2e.mjs && node test/douyin-post-jobs.mjs && node test/retrieval-filtered-vectors.mjs && node test/security-boundaries.mjs && node test/smoke.mjs && node test/douyin-browser.mjs && node test/douyin-music.mjs && node test/startup-gate.mjs && node test/outbox.mjs && node test/import-coverage.mjs && node test/update-check.mjs && node test/issue-fixes.mjs && node test/import-resume.mjs && node test/maibot-extras.mjs && node test/worldinfo.mjs && node test/memory-bulk.mjs && node test/memory-tiers.mjs && node test/memory-weekly.mjs && node test/memory-storage.mjs && node test/memory-storage-restore.mjs && node test/backup-restore.mjs && node test/douyin-group.mjs && node test/review-fixes.mjs && node test/at-reads-video.mjs && node test/search-source.mjs && node test/followups.mjs && node test/detail-config.mjs && node test/qq-send-any-image.mjs && node test/qq-read-attachment.mjs && node test/qq-batch-window.mjs && node test/comment-video.mjs && node test/frames.mjs && node test/face-name.mjs && node test/comment-reply.mjs && node test/chat-comment.mjs && node test/at-target.mjs && node test/quota-caps.mjs && node test/client-lint.mjs && node test/client-panels.mjs && node test/dsh-desktop.mjs && node test/issue-59-interject.mjs && node test/issue-59-diagnose.mjs && node test/sticker-manage.mjs && node test/bili-emotes.mjs && node test/qq-outbound-sanitize.mjs && node test/person-delete.mjs && node test/qq-group-admin.mjs && node test/douyin-recovery.mjs && node test/session-preset.mjs && node test/qq-connect-error.mjs && node test/douyin-comment-bridge.mjs && node test/bili-comment-emoji.mjs && node test/douyin-state-echo.mjs && node test/issue-75-proactive.mjs && node test/issue-76-capability.mjs && node test/douyin-http-browse.mjs && node test/douyin-verify-backoff.mjs && node test/douyin-digg-bridge.mjs && node test/memory-evidence-transcript.mjs && node test/chat-archive-default.mjs && node test/dream-transcript-wire.mjs && node test/douyin-frames-collect.mjs && node test/master-qq-uin-rebind.mjs && node test/douyin-session-health.mjs && node test/douyin-delivered.mjs && node test/douyin-card-share.mjs && node test/douyin-push-drop.mjs && node test/douyin-uid-binding.mjs && node test/image-webp-fallback.mjs && node test/douyin-emoji-fallback.mjs && node test/relay-other-platform.mjs && node test/voice-volcengine.mjs && node test/voice-minimax-dashscope.mjs && node test/bili-switch-persist.mjs && node test/cross-channel-context.mjs && node test/reply-target.mjs && node test/shared-session.mjs && node test/memory-source-label.mjs && node test/pending-delivery.mjs && node test/recall-window-78.mjs && node test/client-syntax.mjs && node test/diag-log.mjs && node test/self-update.mjs",
     "eval": "node test/eval/persona-eval.mjs"
   }
 }