dsh-fish-soul 0.15.26 → 0.15.28

package/README.md

@@ -2,7 +2,7 @@
 
 让一个 QQ 小号背后有"同一个人"：固定人格、按人记记忆、有自己的生活节奏、会主动开口；同一个"她"同时出现在 QQ、B站、抖音。
 
-DSH 插件（单角色 `feiyu`）。版本 **0.15.26**。
+DSH 插件（单角色 `feiyu`）。版本 **0.15.28**。
 
 QQ 交流群：**1125962189**
 
@@ -24,6 +24,8 @@ QQ 交流群：**1125962189**
 
 ## 安装
 
+**第一次装、想照着一步步走**：[从零跑起来](https://github.com/Britneycode/dsh-fish-soul/blob/main/docs/QUICKSTART.md) —— 五步到她在 QQ 里回你第一句话，每步都写了怎么确认成功、卡住了是什么原因。
+
 需要 Node ≥ 22.5。抖音专用浏览器需要一台常开的 Windows 桌面。
 
 从 npm：
@@ -120,4 +122,4 @@ MIT
 
 容量界面显示数据库、存档、备份、聊天文本的占用和磁盘剩余空间，并允许设置告警阈值；上下文指标仅按字符估计记忆片段的预算占用，连续接近上限时在页面标题栏提示，不代表模型完整上下文 Token 用量。预算不够放下某条匹配记忆时，会尝试后续较短的匹配结果，而不是直接停止。磁盘不足时停止创建存档。存档和备份位于本地，未加密，可能包含私密记忆；删除在线记录不会删除先前的存档或备份，请单独管理。
 
-「聊天文本存档」默认关闭，必须明确输入要保存的会话 ID（如 `private:123`、`group:456`）并设置保留天数。仅保存启用后插件实际接入并写入聊天日志的文本，不包含附件、未被接入的消息或历史消息，不能保证平台聊天全量；历史请另行导入。文本单独存于未加密的本地数据库，可分会话查看或删除，过期文本在插件运行期间清理；离线期间不会清理。缩短期限可能立即删除过期文本；用户自行制作的备份和复制件需要另行删除。
+「聊天文本存档」**默认开启**（`chatArchive.enabled`，v0.15.25 起）：会话列表**留空 = 记下所有会话**；只有填了会话 ID（如 `private:123`、`group:456`）才按白名单过滤。**不想要就在设置页关掉，或按会话删**。仅保存插件实际接入并写入聊天日志的文本，不包含附件、未被接入的消息或历史消息，不能保证平台聊天全量；历史请另行导入。文本单独存于未加密的本地数据库，可分会话查看或删除，默认保留 30 天、过期文本在插件运行期间清理；离线期间不会清理。缩短期限可能立即删除过期文本；用户自行制作的备份和复制件需要另行删除。

package/lib/browse.js

@@ -3,15 +3,16 @@
  * 读标题、简介、字幕节选和热评，用她自己的口吻写一两句感受，记进"自己的记忆"（owner_id='self'），
  * 聊天时就能自然说出"我今天刷到……"。默认不点赞、不投币、不评论（点赞可在设置页打开）。
  */
-import { tokenizeForBm25 } from './segment.js';
+
 import { getKv, setKv } from './db.js';
+import { sleep } from './time-util.js';
+import { tokenizeForBm25 } from './segment.js';
 
 const BV_RE = /BV[0-9A-Za-z]{10}/g;
 const SHORT_RE = /https?:\/\/(?:b23\.tv|bili2233\.cn)\/[0-9A-Za-z]+/g;
 const DESCRIBE_TTL_MS = 3600_000;
 const DAY_MS = 86_400_000;
 
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 const oneLine = (s, n) => String(s ?? '').replace(/\s+/g, ' ').replace(/【/g, '〔').replace(/】/g, '〕').trim().slice(0, n);
 
 /** 文本里的 BV 号与 b23 短链。 */

package/lib/channels/bilibili.js

@@ -1,3 +1,4 @@
+import { sleep } from '../time-util.js';
 /**
  * bilibili.js —— B站网页接口客户端（扫码 / Cookie 登录、刷视频、私信收发）与私信轮询渠道。
  *
@@ -96,7 +97,6 @@ export function parseBiliJson(text) {
 }
 
 const stemOf = (url) => String(url ?? '').slice(String(url).lastIndexOf('/') + 1, String(url).lastIndexOf('.'));
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 
 function errorOf(json, fallback) {
 	return new Error(`${fallback}：${json?.code ?? '?'} ${json?.message ?? json?.msg ?? ''}`.trim());

package/lib/channels/douyin.js

@@ -1,3 +1,4 @@
+import { sleep } from '../time-util.js';
 /**
  * douyin.js —— 抖音小号：专用浏览器（Edge / Chrome …，CDP 控制）+ 网页版私信渠道。
  *
@@ -41,7 +42,6 @@ const RECENT_MS = 15 * 60_000;
 const WINDOW_KEEP = 30;
 const INJECT_ON_FIRST_READ = 3;
 
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 const errText = (e) => String(e instanceof Error ? e.message : e);
 const sha1 = (s) => createHash('sha1').update(String(s)).digest('hex');
 
@@ -182,6 +182,8 @@ export function normalizeDouyinMessage(m, { name, timeMs, messageId, group = fal
 			groupId: name,
 			userId: who.userId,
 			nickname: who.nickname,
+			// 群聊的「会话名」是整个群，不是发言的人 —— 跟私信的语义对齐，出口不用改
+			peerName: name,
 			subType: '',
 			messageId,
 			mentioned: false,
@@ -192,14 +194,33 @@ export function normalizeDouyinMessage(m, { name, timeMs, messageId, group = fal
 			timeMs
 		};
 	}
+	// 🔴 单聊认人：优先用**接口给的 senderId**（真实数字 ID，改名也不变），
+	//    拿不到才退回会话名。
+	//
+	//    以前这里硬编码 `userId: name`（会话名 = 抖音昵称），于是「主人是谁」靠昵称比对 ——
+	//    主人一改昵称就认不出来，别人起个同名就能冒充。实测（2026-11-08）接口路**是给
+	//    senderId 的**（如 7702399256389125000），只有 DOM 路没有。所以能稳就稳。
+	//
+	//    ⚠️ 必须是 `uid:<id>` 这个格式，**不能是裸 id** —— 群聊那条路
+	//       （groupSender）早就用 `uid:<id>` 存 douyin_uid 了。格式不一致的话，
+	//       同一个人在群里是 `uid:7702399256389125000`、在私信里是 `7702399256389125000`，
+	//       会被当成两个人，各记一套记忆。
+	//
+	//    ⚠️ `channelId` **仍然按会话名**：私信面板是按名字打开会话的，
+	//    改成 ID 会导致 sendDM/enterChat 全部找不到人。这两件事必须分开：
+	//    认人用 ID，找会话用名字。
+	const sid = String(m?.senderId ?? '').trim();
 	return {
 		channel: 'douyin',
 		chatType: 'private',
 		channelId: `douyin:${name}`,
 		targetId: name,
 		groupId: null,
-		userId: name,
+		userId: sid !== '' ? `uid:${sid}` : name,
 		nickname: name,
+		// 会话名单独留一份：出口要靠它找会话，认人不能靠它。
+		// 老数据里 douyin_uid 存的是这个名字，认人时会拿它当兜底（见 resolveDouyinPerson）。
+		peerName: name,
 		subType: '',
 		messageId,
 		mentioned: true,
@@ -949,13 +970,25 @@ export class DouyinChannel {
 	}
 
 	/**
-	 * 发一组内容（串行、每段之间模拟打字）。parts: [{type:'text', text} | {type:'image', path} | {type:'emoji', name}]
-	 * @returns {Promise<boolean>} 全部发出去了
+	 * 发一组内容（串行、每段之间模拟打字）。
+	 * parts: [{type:'text', text} | {type:'image', path} | {type:'emoji', name}]
+	 *
+	 * @returns {Promise<{ok: boolean, delivered: boolean, parts: Array<object>}>}
+	 *   `ok`        —— 每段的发送动作都执行完、driver 没报错
+	 *   `delivered` —— 至少有一段落到了「回读能看见」的证据
+	 *
+	 * 🔴 为什么要把这两个分开：
+	 *   抖音风控会**静默吞消息** —— Enter 按了、UI 没报错，但消息根本没进会话。
+	 *   以前 send() 只返回一个 allOk，被吞的时候照样 true，上层以为发出去了。
+	 *   现在 driver 的回读结果（sendDM 的 `verified` / sendImage 的 `verified`）
+	 *   一路带上来，上层才能说清「动作做了」和「对方真能看见」是两回事。
 	 */
 	send(name, parts) {
 		const run = async () => {
 			if (!this.host.running) throw new Error('抖音浏览器没在运行');
 			let allOk = true;
+			let delivered = false;
+			const details = [];
 			for (const part of parts) {
 				await sleep(this.typingDelay(part.type === 'text' ? part.text : ''));
 				const r = await this.host.exclusive('发私信', async () => {
@@ -967,13 +1000,23 @@ export class DouyinChannel {
 					}
 					return await this.driver.sendText(name, part.text);
 				}, { maxMs: 90_000 }).catch((error) => ({ ok: false, error: errText(error) }));
+				// 回读确认：文字（sendDM）/ 图片（sendImage）/ 表情（sendEmoji）三条都会
+				// 在发完之后数一遍气泡，真的多出来才回 verified。所以这里统一认 verified。
+				// ⚠️ 表情走文字兜底（面板里没这个名字）时就没有 verified 了 ——
+				//    那条是当普通消息发的，`type` 仍是 emoji，只能按「没回读」算。
+				const seen = r?.ok === true && r.verified === true;
+				if (seen) delivered = true;
 				if (!r?.ok) {
 					allOk = false;
 					this.log('error', `[fish-soul] 发抖音私信给「${name}」失败：${r?.error ?? '未知'}`);
+				} else if (part.type !== 'emoji' && r.verified !== true) {
+					// 动作做了但回读没看见 —— 大概率被风控吞了，这条要留下来
+					this.log('warn', `[fish-soul] 发给「${name}」的${part.type === 'image' ? '图片' : '消息'}没在列表里回读到，可能被风控吞了`);
 				}
+				details.push({ type: part.type, ok: r?.ok === true, delivered: seen, error: r?.error ?? '' });
 			}
 			// 自己发出去的消息进窗口，下一轮不当成新消息（下一轮读的时候它们是"我"发的，本来也不会回）
-			return allOk;
+			return { ok: allOk, delivered, parts: details };
 		};
 		const p = this.sendChain.then(run, run);
 		this.sendChain = p.catch(() => {});

package/lib/client.douyin.js

@@ -143,7 +143,7 @@ window.__ModuleLoader__.load({
 				Group({ title: "私信" },
 					Row({ title: "抖音接入" }, poll, sw("抖音接入", d.enabled === true, (v) => save({ top: { enabled: v } }))),
 					Row({ title: "自动回复" }, d.autoReply ? null : Muted("只记不回"), sw("自动回复", d.autoReply === true, (v) => save({ top: { autoReply: v } }))),
-					Row({ title: "主人的名字" }, Input({ ...bind("masterName"), placeholder: "她私信列表里你的名字" })),
+					Row({ title: "主人的名字", desc: "填了之后，可以在 QQ 私聊里让她去抖音给你发一条私信" }, 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: "私信列表里显示的名字，每行一个" })),

package/lib/client.js

@@ -670,7 +670,7 @@ window.__ModuleLoader__.load({
 					Row({ title: "B站接入" }, poll, sw("B站接入", b.enabled === true, (v) => save({ top: { enabled: v } })))),
 				Group({ title: "私信" },
 					Row({ title: "自动回复" }, b.autoReply ? null : Muted("只记不回"), sw("自动回复", b.autoReply === true, (v) => save({ top: { autoReply: v } }))),
-					Row({ title: "主人 UID" }, field("masterUid", { inputMode: "numeric" })),
+					Row({ title: "主人 UID", desc: "填了之后，可以在 QQ 私聊里让她去 B站 给你发一条私信" }, field("masterUid", { inputMode: "numeric" })),
 					Row({ title: "白名单" }, field("allowList", { placeholder: "UID，逗号分隔" })),
 					Row({ title: "互关的人也回" }, sw("互关的人也回", b.replyMutual !== false, (v) => save({ top: { replyMutual: v } }))),
 					Row({ title: "主动私信主人" }, sw("主动私信主人", b.proactive === true, (v) => save({ top: { proactive: v } }))),

package/lib/client.soul.js

@@ -545,7 +545,10 @@ window.__ModuleLoader__.load({
 			reply: ["要回", "info"], interject: ["插话", "info"], sent: ["已发", "success"], silent: ["没说", "outline"],
 			memorize: ["只记", "outline"], paused: ["暂停", "warning"], resumed: ["恢复", "success"], failed: ["失败", "danger"],
 			recalled: ["撤回", "outline"], command: ["命令", "info"], proactive: ["主动", "info"], digest: ["记下", "success"],
-			filtered: ["改写", "outline"], diary: ["日记", "success"], browse: ["刷视频", "outline"], share: ["分享", "success"], post: ["发动态", "success"], comment: ["评论区", "info"], mood: ["心情", "info"], poke: ["戳回", "info"], react: ["回应", "info"]
+			filtered: ["改写", "outline"], diary: ["日记", "success"], browse: ["刷视频", "outline"], share: ["分享", "success"], post: ["发动态", "success"], comment: ["评论区", "info"], mood: ["心情", "info"], poke: ["戳回", "info"], react: ["回应", "info"],
+			// 发出去了但回读没看到 —— 抖音风控会静默吞消息，这种要跟「失败」区分开
+			unconfirmed: ["可能被吞", "warning"],
+			relay: ["转达", "success"]
 		};
 		/** 读本地图片 → base64（去掉 data: 前缀）；读不出来给 null。 */
 		function readBase64(file) {

package/lib/db.js

@@ -445,11 +445,74 @@ export function ensureMasterPerson(db, nowMs) {
  * @returns {object} person 行
  */
 export function resolveOrCreatePerson(db, { qqUin, nickname, nowMs, masterQqUin }) {
-	const isMaster = masterQqUin !== undefined && masterQqUin !== '' && qqUin === masterQqUin;
+	// ⚠️ 一律转字符串再比、再写。
+	//    OneBot 事件里的 user_id 是**数字**，配置里的 masterQqUin 是**字符串**；
+	//    混着用会出现两种诡异结果：
+	//      ① `10001 === '10001'` 为假 → 主人认不出来（原本就有这个隐患）
+	//      ② 数字写进 TEXT 列会存成 "10001.0" → 跟字符串 "10001" 永远对不上
+	//    所以入口统一 String()，后面的比较和写入都用同一个值。
+	qqUin = String(qqUin ?? '');
+	const master = masterQqUin === undefined || masterQqUin === null ? undefined : String(masterQqUin);
+	const isMaster = master !== undefined && master !== '' && qqUin === master;
+	masterQqUin = master;
 	const canonicalId = isMaster ? 'master' : randomCanonicalId();
 	const initialStage = isMaster ? 'close' : 'stranger';
-	// 主人先从 B站来过（master 行还没有 QQ 号）：补上 QQ 号，下面的 Upsert 走更新分支而不是主键冲突
+	// 主人换过 QQ 号：master 行上还挂着旧号。
+	// 旧号占着 master 的 qq_uin，新号 INSERT 时既撞 qq_uin 的 UNIQUE、又撞 canonical_id='master' 主键，
+	// 而下面的 Upsert 只兜得住 qq_uin —— 于是每轮消息都在认人阶段抛
+	// `UNIQUE constraint failed: person.canonical_id`，整条 QQ 通道一个字都不回。
+	//
+	// 修法：**只在「master 行恰好挂着这个号、但这个号已经不是主人」时**把那一行处理掉。
+	//
+	// 🔴 这个判据必须写死成「master 行挂着 qqUin」，不能放宽成「只要不是当前 master 就摘」：
+	//    放宽后随便哪个陌生人来一条消息都会把主人的 qq_uin 清空（smoke 里 55555 就这么干过）。
+	//
+	// 🔴 也不能只在 isMaster 时处理 —— 旧号自己那条消息先到时 isMaster 是假，
+	//    不处理就永远卡在「旧号顶着 master、新号撞主键」的死循环里。
+	//
+	// ⚠️ 参数必须是字符串：数字写进 TEXT 列会变成 "10001.0"，跟 "10001" 永远对不上。
+	//    入口已经统一 String() 过了。
+	if (!isMaster && master !== undefined && master !== '') {
+		const stale = db.prepare("SELECT * FROM person WHERE qq_uin = ? AND canonical_id = 'master'").get(qqUin) ?? null;
+		if (stale !== null) {
+			// master 行上还挂着别的平台身份（主人先从 B站 / 抖音来过）⇒ 只摘 QQ 号，不搬行
+			if (stale.bili_uid !== null || stale.douyin_uid !== null) {
+				db.prepare("UPDATE person SET qq_uin = NULL WHERE canonical_id = 'master' AND qq_uin = ?").run(qqUin);
+			} else {
+				// 整行都是「曾经的主人」⇒ 给它一个新身份退回陌生人，记忆跟着走，不丢
+				const newCid = randomCanonicalId();
+				db.prepare("UPDATE person SET canonical_id = ?, relation_stage = 'stranger' WHERE canonical_id = 'master' AND qq_uin = ?").run(newCid, qqUin);
+				db.prepare('UPDATE memory SET owner_id = ? WHERE owner_id = ?').run(`user:${newCid}`, 'user:master');
+				db.prepare('UPDATE pending SET owner_id = ? WHERE owner_id = ?').run(`user:${newCid}`, 'user:master');
+				// 腾出来的 master 主键补一行，给真正的主人接管
+				db.prepare(`
+					INSERT INTO person (canonical_id, qq_uin, display_name, relation_stage, interaction_count, first_seen_at, last_seen_at)
+					VALUES ('master', NULL, '主人', 'close', 0, ?, ?)
+				`).run(nowMs, nowMs);
+			}
+		}
+	}
+	// 主人先从 B站来过 / 刚腾出位置：master 行没有 QQ 号就补上，下面的 Upsert 才不会撞主键
 	if (isMaster) db.prepare("UPDATE person SET qq_uin = ? WHERE canonical_id = 'master' AND qq_uin IS NULL").run(qqUin);
+
+	// 🔴 非主人这条消息如果正好命中 master 行（上面刚摘成 NULL、但 canonical_id 还是 master 的那行，
+	//    或从没设过主人的老库），下面那句 `ON CONFLICT(qq_uin)` 只会更新名字和次数，
+	//    **canonical_id 仍然是 'master'** —— 旧号于是继续顶着主人的身份，新号反而接管不了。
+	//    所以在 INSERT 之前把它挪成一个独立的陌生人身份（记忆跟着搬，不丢）。
+	//
+	// ⚠️ **只在「这一行除了 qq_uin 没有别的身份」时才搬**。
+	//    master 行上还可能挂着 bili_uid / douyin_uid（主人先从那两个平台来过），
+	//    把整行搬走会连带把主人的 B站 / 抖音身份一起搬给陌生人 —— smoke 里
+	//    「B站私信认主人」那条就是这么红的。这种情况只摘 qq_uin，不搬行。
+	if (!isMaster) {
+		const hijack = db.prepare("SELECT * FROM person WHERE qq_uin IS NOT NULL AND canonical_id = 'master' AND qq_uin = ?").get(qqUin) ?? null;
+		if (hijack !== null && hijack.bili_uid === null && hijack.douyin_uid === null) {
+			const newCid = randomCanonicalId();
+			db.prepare("UPDATE person SET canonical_id = ?, relation_stage = 'stranger' WHERE canonical_id = 'master' AND qq_uin = ?").run(newCid, qqUin);
+			db.prepare('UPDATE memory SET owner_id = ? WHERE owner_id = ?').run(`user:${newCid}`, 'user:master');
+			db.prepare('UPDATE pending SET owner_id = ? WHERE owner_id = ?').run(`user:${newCid}`, 'user:master');
+		}
+	}
 	return db.prepare(`
 		INSERT INTO person (canonical_id, qq_uin, display_name, relation_stage, interaction_count, first_seen_at, last_seen_at)
 		VALUES (@canonicalId, @qqUin, @nickname, @initialStage, 1, @nowMs, @nowMs)

package/lib/douyin-browse.js

@@ -1,3 +1,4 @@
+import { sleep } from './time-util.js';
 /**
  * douyin-browse.js —— 鱼自己刷抖音：空闲时拿一批推荐，像人一样看几条（每条停 5–20 秒）再划走，
  * 然后挑出来的几条读详情和热评，用她自己的口吻写一两句感受，记进"自己的记忆"（owner_id='self'）。
@@ -24,7 +25,6 @@ const DESCRIBE_TTL_MS = 3600_000;
 const DAY_MS = 86_400_000;
 const MOBILE_UA = 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1';
 
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 const oneLine = (s, n) => String(s ?? '').replace(/\s+/g, ' ').replace(/【/g, '〔').replace(/】/g, '〕').trim().slice(0, n);
 const errText = (e) => String(e instanceof Error ? e.message : e);
 

package/lib/douyin-http.js

@@ -22,6 +22,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dshHome } from './db.js';
 import { join } from 'node:path';
 import { generateABogus } from './vendor/douyin-bogus.js';
+import { sessionHealth } from './session-health.js';
 
 export const DOUYIN_WEB_ORIGIN = 'https://www.douyin.com';
 
@@ -101,6 +102,26 @@ export function douyinCookiePath() {
 	return join(dshHome(), 'fish-soul', 'douyin-cookie.json');
 }
 
+/**
+ * 从落盘的 cookie 文件里读登录态还剩多久（**只读文件，不联网、不抓浏览器**）。
+ *
+ * 为什么单独开一个：诊断页每 10 秒轮询一次，不能为了看一眼过期时间去连 CDP。
+ * 文件里有 `sid_guard` 就够了 —— 它自带签发时间和有效期。
+ *
+ * @returns {{remainingSec: number, expiresAt: number} | null}
+ *          没登录 / 没这个文件 / 没有 sid_guard 都返回 null（诊断页照常显示其它项）
+ */
+export function douyinSessionHealth() {
+	try {
+		const p = douyinCookiePath();
+		if (!existsSync(p)) return null;
+		const data = JSON.parse(readFileSync(p, 'utf8'));
+		return sessionHealth(data?.cookies ?? null);
+	} catch {
+		return null;
+	}
+}
+
 /**
  * 抖音网页端的纯 HTTP 客户端。
  */

package/lib/douyin-social.js

@@ -1,3 +1,4 @@
+import { sleep } from './time-util.js';
 /**
  * douyin-social.js —— 鱼在抖音自己发图文作品、回作品下的评论（v0.10，默认都关，尽力而为）。
  *
@@ -32,7 +33,6 @@ const SEL = {
 	commentBtn: '[data-e2e="feed-comment-icon"]'
 };
 
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 const oneLine = (s, n) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, n);
 const errText = (e) => String(e instanceof Error ? e.message : e);
 

package/lib/gateway-media.js

@@ -58,18 +58,25 @@ export const mediaMethods = {
 		if (!cfg.enabled || m.userId === '') return;
 		if (m.messageId !== '' && !this.markSeen(`${m.channelId}#${m.messageId}`)) return;
 		if (m.chatType === 'group') { await this.onDouyinGroupMessage(m, cfg); return; }
-		const person = this.soul.resolveDouyinPerson(m, { masterName: cfg.masterName, linkedQq: this.douyinLinks().get(m.userId) ?? '' });
+		// 单聊里的两个身份要分清（见 normalizeDouyinMessage 的注释）：
+		//   m.userId   —— 认人用的 ID（接口有就给真实数字 ID，没有才退回名字）
+		//   m.peerName —— 会话名（私信面板按它找会话，出口全靠它）
+		//
+		// 主人 / 白名单 / 设置页填的都是**会话名**，所以判定继续用会话名；
+		// 只有「这是谁」交给 resolveDouyinPerson（它会用 ID 建 person 行）。
+		const peer = m.peerName || m.userId;
+		const person = this.soul.resolveDouyinPerson(m, { masterName: cfg.masterName, linkedQq: this.douyinLinks().get(peer) ?? '' });
 		const stale = Date.now() - m.timeMs > cfg.replyWindowMinutes * 60_000;
 		const paused = this.isPaused(m.channelId);
 		const trusted = cfg.autoReply && !stale && !paused && !this.douyin.replyPaused &&
-			(m.userId === cfg.masterName || cfg.allowList.includes(m.userId) || cfg.replyAll);
+			(peer === cfg.masterName || cfg.allowList.includes(peer) || cfg.replyAll);
 		if (!trusted) {
 			this.soul.memorizeUnanswered(person, m);
-			this.note(paused ? 'paused' : 'memorize', { channelId: m.channelId, who: m.userId, text: m.text, title: `抖音·${sanitizeName(m.userId, '抖音用户')}`,
+			this.note(paused ? 'paused' : 'memorize', { channelId: m.channelId, who: peer, text: m.text, title: `抖音·${sanitizeName(peer, '抖音用户')}`,
 				reason: paused ? '这个聊天暂停着' : !cfg.autoReply ? '自动回复关着' : stale ? '超过回复时限的旧消息' : this.douyin.replyPaused ? '页面自检没过，先不回' : '不是主人 / 白名单' });
 			return;
 		}
-		this.note('reply', { channelId: m.channelId, who: m.userId, text: m.text });
+		this.note('reply', { channelId: m.channelId, who: peer, text: m.text });
 		this.enqueue(m, person, cfg);
 	},
 
@@ -262,7 +269,14 @@ export const mediaMethods = {
 		}
 		const out = [];
 		for (const f of files.slice(0, MAX_DM_IMAGES)) {
-			const img = await prepareImage(f, { cacheDir, canvasConvert: this.canvasConvert, log: this.log });
+			// keepWebpIfNoConverter：这台机器没有 sharp（loadSharp 返回 null），
+			// webp 只能靠浏览器 canvas 兜底；兜不住时以前是**静默丢掉**，
+			// 表现就是「表情包明明在库里，发出去什么都没有」。
+			// 现在原样交给 sendImage —— 私信走 DOM.setFileInputFiles，它绕过文件框的
+			// accept 过滤，webp 是能发的（抖音官方实现里 webp 走普通图片分支）。
+			const img = await prepareImage(f, {
+				cacheDir, canvasConvert: this.canvasConvert, log: this.log, keepWebpIfNoConverter: true
+			});
 			if (img !== null) out.push(img);
 			else this.log('warn', `[fish-soul] 这张图发不了（格式不支持或者太大）：${f}`);
 		}
@@ -364,21 +378,80 @@ export const mediaMethods = {
 		return allOk;
 	},
 
-	/** 抖音私信：文字按空行拆条；单独一段 [名字] 发成抖音自带表情；图片（≤2 张）跟在最后。 */
+	/**
+	 * 抖音私信：文字按空行拆条；单独一段 [名字] 发成抖音自带表情；图片（≤2 张）跟在最后。
+	 *
+	 * @returns {Promise<{ok: boolean, delivered: boolean, parts: Array<object>}>}
+	 *   `ok` = 动作都做了；`delivered` = 至少一条回读到证据。
+	 *   🔴 两者要分开报：抖音风控静默吞消息时 `ok` 仍然是 true，
+	 *      但对方根本收不到 —— 只报 ok 等于撒谎。
+	 */
 	async sendDouyin(row, text, images = []) {
-		if (this.douyin === null) return false;
+		const fail = (error) => {
+			this.log('error', `[fish-soul] 发到 ${row.title || row.channel_id} 失败：${String(error instanceof Error ? error.message : error)}`);
+			return { ok: false, delivered: false, parts: [] };
+		};
+		if (this.douyin === null) return { ok: false, delivered: false, parts: [] };
 		const name = splitChannelId(row.channel_id)[1];
 		const parts = this.dmParagraphs(text).map((p) => {
 			const e = p.match(DOUYIN_EMOJI_RE);
 			return e ? { type: 'emoji', name: e[1] } : { type: 'text', text: p };
 		});
 		for (const img of images) parts.push({ type: 'image', path: img.path });
-		if (parts.length === 0) return true;
+		if (parts.length === 0) return { ok: true, delivered: true, parts: [] };
 		try {
-			return await this.douyin.send(name, parts);
+			const r = await this.douyin.send(name, parts);
+			// 兼容老返回（布尔）：真出现布尔就当「动作做了、回读未知」
+			if (typeof r === 'boolean') return { ok: r, delivered: false, parts: [] };
+			return r ?? { ok: false, delivered: false, parts: [] };
 		} catch (error) {
-			this.log('error', `[fish-soul] 发到 ${row.title || row.channel_id} 失败：${String(error instanceof Error ? error.message : error)}`);
-			return false;
+			return fail(error);
+		}
+	},
+
+	/**
+	 * 跨平台转达：主人在 QQ 私聊里让她去抖音 / B站 私信自己一条。
+	 * 只发主人自己的账号 —— 小号主动私信真人 = 封号 + 社交双重风险（见 DECISIONS D11）。
+	 *
+	 * @returns {Promise<{ok: boolean, delivered: boolean, platform: string, reason: string}>}
+	 *   `ok` = 动作做了；`delivered` = 至少有一条回读到证据（抖音风控吞消息时 ok 仍是 true）。
+	 */
+	async relayTo(platform, text) {
+		const said = String(text ?? '').trim();
+		if (said === '') return { ok: false, delivered: false, platform, reason: '内容是空的' };
+		try {
+			if (platform === 'bili') {
+				const cfg = this.biliConfig();
+				if (!cfg.enabled) return { ok: false, delivered: false, platform, reason: 'B站那边没开' };
+				if (this.bili === null || !this.bili.connected) return { ok: false, delivered: false, platform, reason: 'B站没连上' };
+				if (cfg.masterUid === '') return { ok: false, delivered: false, platform, reason: '没填主人的 B站 UID（设置页「平台」→ B站）' };
+				const channelId = 'bili:' + cfg.masterUid;
+				const ok = await this.sendBili({ channel_id: channelId, title: 'B站·' + cfg.masterUid }, said, []);
+				if (ok) this.afterRelay(channelId, said, 'bili');
+				return { ok, delivered: ok, platform, reason: ok ? '' : '发送时报错了，看日志' };
+			}
+			if (platform === 'douyin') {
+				const cfg = this.douyinConfig();
+				if (!cfg.enabled) return { ok: false, delivered: false, platform, reason: '抖音那边没开' };
+				if (this.douyin === null || !this.douyin.connected) return { ok: false, delivered: false, platform, reason: '抖音没连上' };
+				if (cfg.masterName === '') return { ok: false, delivered: false, platform, reason: '没填主人抖音的会话名（设置页「平台」→ 抖音）' };
+				const channelId = 'douyin:' + cfg.masterName;
+				const r = await this.sendDouyin({ channel_id: channelId, title: '抖音·' + cfg.masterName }, said, []);
+				if (r.ok === true) this.afterRelay(channelId, said, 'douyin');
+				return { ok: r.ok === true, delivered: r.delivered === true, platform, reason: r.ok === true ? '' : '发送时报错了，看日志' };
+			}
+			return { ok: false, delivered: false, platform, reason: '只支持 douyin / bili' };
+		} catch (error) {
+			// 绝不往上抛：工具层会把异常当成"这次没发成"，这里自己收住并把原因带给主人
+			const msg = String(error instanceof Error ? error.message : error);
+			this.log('error', `[fish-soul] 转达消息失败：${msg}`);
+			return { ok: false, delivered: false, platform, reason: msg.slice(0, 80) };
 		}
+	},
+
+	/** 转达发出去了：记进聊天日志 + 记一条「动态」。 */
+	afterRelay(channelId, text, platform) {
+		try { this.soul.journalOut?.(channelId, text); } catch { /* 记日志失败不影响已经发出去的消息 */ }
+		this.note('relay', { channelId, text, reason: `主人让去${platform === 'bili' ? 'B站' : '抖音'}发的` });
 	}
 };

package/lib/gateway.js

@@ -46,6 +46,10 @@ const OUR_SOURCES = new Set([SOURCE_QQ, SOURCE_PROACTIVE, SOURCE_BILI, SOURCE_DO
 
 /** QQ 会话里模型能用的全部工具（宿主 PTC 传输 run_code 不算工具本身，单独放行）。 */
 export const QQ_SESSION_TOOLS = ['remember', 'recall', 'forget'];
+/** 跨平台转达：主人在 QQ 私聊里让她去抖音 / B站 私信自己一条。 */
+export const RELAY_TOOL = 'send_elsewhere';
+/** 聊天会话里放行的插件工具（记忆 + 跨平台转达）。 */
+export const CHAT_TOOLS = [...QQ_SESSION_TOOLS, RELAY_TOOL];
 /** 宿主的联网工具：设置里打开「让她能上网查」才放行（护栏按天限次数）。 */
 export const WEB_TOOLS = ['web_search', 'web_fetch'];
 /** 自己填 key 的搜索服务（插件注册的工具） */
@@ -463,7 +467,7 @@ export class ChatGateway {
 	allowedTools(agentCtx) {
 		const has = (reg, n) => { try { return typeof reg?.get === 'function' && reg.get(n) !== undefined; } catch { return false; } };
 		const tools = this.ctx.tools;
-		return [...QQ_SESSION_TOOLS, ...WEB_TOOLS, OWN_WEB_TOOL].filter((n) =>
+		return [...CHAT_TOOLS, ...WEB_TOOLS, OWN_WEB_TOOL].filter((n) =>
 			WEB_TOOLS.includes(n) || typeof tools?.get !== 'function' || has(tools, n) || has(agentCtx?.tools, n));
 	}
 
@@ -1332,8 +1336,22 @@ export class ChatGateway {
 			// [语音] 段：主人的话转成语音发到 QQ 私聊，其余去掉标记当文字发
 			const dmText = (await this.relayDmVoice(row, 净文字)).split(/\n{2,}/).map((p) => p.replace(VOICE_RE, '')).filter((p) => p.trim() !== '').join('\n\n');
 			if (dmText === '' && images.length === 0) return true;
-			const ok = platform === 'bili' ? await this.sendBili(row, dmText, images) : await this.sendDouyin(row, dmText, images);
-			this.note(ok ? 'sent' : 'failed', { channelId: row.channel_id, title: row.title, text: dmText || '[图片]', reason: ok ? '' : '发送失败', memories });
+			let ok;
+			let delivered;
+			if (platform === 'bili') {
+				ok = await this.sendBili(row, dmText, images);
+				delivered = ok; // B站 那条是直连接口，onMessage 就带 message_id，没有「静默被吞」这回事
+			} else {
+				const r = await this.sendDouyin(row, dmText, images);
+				ok = r.ok === true;
+				delivered = r.delivered === true;
+			}
+			// 🔴 「动作做了」和「对方真能看见」分开记：
+			//    抖音风控会静默吞消息（Enter 按了、UI 没报错、消息没进会话）。
+			//    只记 sent 会让动态页/日记看起来一切正常，实际上对方什么都没收到。
+			const kind = !ok ? 'failed' : (delivered ? 'sent' : 'unconfirmed');
+			const reason = !ok ? '发送失败' : (delivered ? '' : '发出去了但回读没看到，可能被风控吞了');
+			this.note(kind, { channelId: row.channel_id, title: row.title, text: dmText || '[图片]', reason, memories });
 			if (ok && dmText) this.soul.journalOut?.(row.channel_id, dmText);
 			return ok;
 		}

package/lib/imageconv.js

@@ -133,13 +133,18 @@ export function sharpReady() {
 
 /**
  * 图片整理：返回能直接发的 {path, bytes, type, width, height}；发不了返回 null。
+ *
  * @param {string} file 本地路径
  * @param {object} opts
  * @param {string} opts.cacheDir 转换结果放这里
  * @param {((bytes: Buffer) => Promise<Buffer|null>)|null} [opts.canvasConvert] 浏览器 canvas 兜底（转 png）
  * @param {(level: string, msg: string) => void} [opts.log]
+ * @param {boolean} [opts.keepWebpIfNoConverter] webp 转不了时**原样交出去**，别丢。
+ *        （抖音私信走 `DOM.setFileInputFiles`，它绕过文件框的 accept 过滤，
+ *          webp 是能直接发的 —— 官方客户端实现里 webp 走的是普通图片分支。
+ *          但这条没真机验过，所以调用方做好「原样发失败再退文字」的准备。）
  */
-export async function prepareImage(file, { cacheDir, canvasConvert = null, log = () => {} } = {}) {
+export async function prepareImage(file, { cacheDir, canvasConvert = null, log = () => {}, keepWebpIfNoConverter = false } = {}) {
 	let bytes;
 	try {
 		if (!existsSync(file) || statSync(file).size > MAX_INPUT_BYTES) return null;
@@ -171,7 +176,15 @@ export async function prepareImage(file, { cacheDir, canvasConvert = null, log =
 	if (out === null && typeof canvasConvert === 'function') {
 		try { out = await canvasConvert(bytes); ext = 'png'; } catch { out = null; }
 	}
-	if (out === null || sniffImage(out) !== ext) return null;
+	// 转不出来（没 sharp、canvas 也不行）
+	if (out === null || sniffImage(out) !== ext) {
+		if (keepWebpIfNoConverter) {
+			// 别丢：原样交出去，让上层试一次。webp 的宽高自己解析得出来。
+			log('warn', `[fish-soul] ${file} 转不了格式（没有 sharp / canvas 也不行），按原样试试`);
+			return { path: file, bytes, type: 'webp', ...imageSize(bytes), converted: false };
+		}
+		return null;
+	}
 	if (out.length > MAX_OUTPUT_BYTES) {
 		log('warn', `[fish-soul] ${file} 转出来 ${(out.length / 1048576).toFixed(1)} MB，太大不发`);
 		return null;
@@ -179,5 +192,5 @@ export async function prepareImage(file, { cacheDir, canvasConvert = null, log =
 	mkdirSync(cacheDir, { recursive: true });
 	const path = join(cacheDir, `${hash}.${ext}`);
 	writeFileSync(path, out);
-	return { path, bytes: out, type: ext, ...imageSize(out) };
+	return { path, bytes: out, type: ext, ...imageSize(out), converted: true };
 }

package/lib/index.js

@@ -45,7 +45,7 @@ import { DouyinHttp } from './douyin-http.js';
 import { fishSoulConfigSchema } from './config-schema.js';
 import { loadSharp, sharpReady } from './imageconv.js';
 import {
-	ChatGateway, SOURCE_QQ, SOURCE_PROACTIVE, SOURCE_BILI, SOURCE_DOUYIN, QQ_SESSION_TOOLS, WEB_TOOLS, OWN_WEB_TOOL, splitChannelId, sessionChannelOf
+	ChatGateway, SOURCE_QQ, SOURCE_PROACTIVE, SOURCE_BILI, SOURCE_DOUYIN, CHAT_TOOLS, RELAY_TOOL, WEB_TOOLS, OWN_WEB_TOOL, splitChannelId, sessionChannelOf
 } from './gateway.js';
 import { VirtualClock } from './clock.js';
 import { EmbeddingClient, VectorWorker, recall, recallSync, vectorRanks } from './retrieval.js';
@@ -147,6 +147,21 @@ function parseRoleIso(iso) {
 
 const UNKNOWN_OWNER = 'user:unknown';
 
+/**
+ * 抖音自带表情里**确认存在**的兜底名字。
+ *
+ * 🔴 以前这里写的是 `[比心] [捂脸]` —— 而 `[捂脸]` **不在抖音表情面板里**（2026-11-09 实测）。
+ *    后果不是报错：`sendEmoji` 找不到就退回 `sendText`，把 `[捂脸]` 当**纯文字**发出去，
+ *    对方看到一串方括号。模型被提示词引到一个不存在的名字上，锅在提示词这边。
+ *
+ * 下面这几个都来自 2026-11-09 真机抓的面板（`emojiNames` 为空时的兜底）：
+ *   续火花 比心 在干嘛 笑死 麻了 躺平 摇骰子 猜拳 开心 嗨 吹泡泡 黑人问号
+ *   早上好 晚上好 早点睡 爱心 便便 戳一戳 绝了 已阅 生日祝福
+ * 挑的是**语义通用、不挑场合**的几个；`[摇骰子]` 那种只在特定场景才合适，不放进来。
+ * ⚠️ 这份清单要跟面板对得上 —— `test/douyin-emoji-fallback.mjs` 会核对。
+ */
+const DOUYIN_EMOJI_FALLBACK = ['比心', '笑死', '绝了', '爱心'];
+
 /** 启动步骤（顺序即 apply 里的顺序），日志和 503 里的"第 N 步"按这个数。 */
 const STARTUP_STEPS = [
 	'底座（soul.db / 虚拟钟）', '检索', 'QQ 渠道', '人格', 'B站', '给主人的提醒', '抖音', '自走层', '上网查',
@@ -737,10 +752,12 @@ async function startup(ctx, config, { log, gate }) {
 					? '[抖音群聊回复规则] 你的最后一条回复会原样发到这个抖音群里（群消息格式是"昵称：内容"，你回的时候直接说、前面别加自己的名字；记的是谁的事，remember 时 speaker 就填谁的署名）；空一行会拆成多条消息；'
 					: '[抖音私信回复规则] 你的最后一条回复会原样发到抖音私信；空一行会拆成多条消息；') + stickerRule +
 					// 抖音的表情按**名字**匹配面板格子，所以知道名字就能发。
-					// 已知名字通常是空的（要读完私信发现有不认识的表情才会去抓面板），空了就用原来的说法
+					// 已知名字通常是空的（要读完私信发现有不认识的表情才会去抓面板），
+					// 空了就用 DOUYIN_EMOJI_FALLBACK —— 那几个是**真机核对过**存在的名字。
+					// ⚠️ 别在这儿现写名字：写错不会报错，只会把 `[某某]` 当纯文字发出去。
 					(douyinNames.length > 0
 						? `单独一段只写表情名会发成表情，这些确认能用：${douyinNames.map((n) => `[${n}]`).join(' ')}；`
-						: '单独一段只写 [比心] [捂脸] 这类抖音自带表情名会发成表情；') +
+						: `单独一段只写表情名会发成表情，这些确认能用：${DOUYIN_EMOJI_FALLBACK.map((n) => `[${n}]`).join(' ')}；`) +
 					'不想接话就只输出 [不回]。');
 		}
 		if ((isQq || isBili || isDouyin) && biliCfg().enabled === true) {
@@ -863,10 +880,46 @@ async function startup(ctx, config, { log, gate }) {
 				life.noteInteraction(ownerOf(person));
 				return person;
 			},
-			/** 抖音私信认人：按会话里显示的名字；主人 / "抖音名字=QQ号"对应上的归到同一个人。 */
+			/**
+			 * 抖音私信认人。
+			 *
+			 * v0.15.27 起优先按**真实用户 ID**（`uid:<senderId>`）认，改名也不丢；
+			 * 老的库里存的是昵称，所以这里做一次「新旧键合并」：
+			 *   新键 `uid:xxx` 找到人 → 用它；
+			 *   找不到但**旧昵称键**能找到人 → 把旧行改挂到新键上（记忆跟着走，不新增一条）；
+			 *   都找不到 → 建新的。
+			 *
+			 * 主人判定仍然走 `masterName`（会话名）—— 设置页里填的就是那个名字。
+			 */
 			resolveDouyinPerson(m, { masterName, linkedQq }) {
+				const uid = String(m.userId ?? '');
+				const peer = String(m.peerName ?? m.nickname ?? '');
+				// 迁移：老库里 douyin_uid 存的是**昵称**，新键是 `uid:<senderId>`。
+				// 这两者指同一个人时要并成一行，否则改名后立刻分裂成两个「人」、各记一套记忆。
+				// 只在新键还没人用、旧昵称键确实有人时才搬。
+				// 只在「新键是 uid: 格式、且跟旧昵称不同」时才谈得上迁移
+				if (uid.startsWith('uid:') && peer !== '' && uid !== peer) {
+					const byOld = findPersonByDouyin(db, peer);
+					const byNew = findPersonByDouyin(db, uid);
+					if (byOld !== null && byNew === null) {
+						try { db.prepare('UPDATE person SET douyin_uid = ? WHERE canonical_id = ?').run(uid, byOld.canonical_id); }
+						catch { /* 新键被占：让下面常规路径自己收拢 */ }
+					}
+				}
+				// 主人判定：
+				//   设置页填的 `masterName` 是**会话名**，而新的 userId 是 `uid:<id>`，两者永远不相等 ——
+				//   照原样传 masterName 的话，换到 ID 绑定之后主人立刻认不出来。
+				//   所以「会话名 == masterName」时，直接把 masterId 传成当前 uid：
+				//   resolveOrCreatePlatformPerson 内部是 `uid === masterId`，这样就落到 master 那行，
+				//   同时把它的 douyin_uid 更新成真实 ID（这正好是我们要的迁移）。
+				//
+				//   ⚠️ 残留风险（如实记）：**迁移发生前**，认主人仍然靠会话名，
+				//      也就是说「别人把昵称改成跟你一样」在第一次迁移前还是能冒充。
+				//      一旦那行迁到 `uid:<id>`，之后再比对的就是 ID 了，改名/同名都免疫。
+				const isMasterPeer = masterName !== undefined && masterName !== '' && peer === String(masterName);
+				const effectiveMasterId = isMasterPeer ? uid : masterName;
 				const person = resolveOrCreatePlatformPerson(db, {
-					platform: 'douyin', platformId: m.userId, nickname: m.nickname, nowMs: clock.now(), masterId: masterName, linkedQq
+					platform: 'douyin', platformId: uid, nickname: m.nickname, nowMs: clock.now(), masterId: effectiveMasterId, linkedQq
 				});
 				life.noteInteraction(ownerOf(person));
 				return person;
@@ -989,7 +1042,7 @@ async function startup(ctx, config, { log, gate }) {
 	// #37：tools.sessionAllow = 'master' / 'all' 时，放开的会话不再拦宿主工具（run_code 仍然拦）。
 	try {
 		if (typeof ctx.tools.guard === 'function') {
-			const allowed = new Set(QQ_SESSION_TOOLS);
+			const allowed = new Set(CHAT_TOOLS);
 			const sessionOpen = (id) => {
 				const row = gateway?.chatForSession(id);
 				return row !== null && row !== undefined && gateway.sessionOpenFor(row.channel_id) === true;
@@ -1011,7 +1064,7 @@ async function startup(ctx, config, { log, gate }) {
 				}
 				if (exec.name === 'run_code') return `聊天会话里不能运行代码（放开工具也不放 run_code：它能跑任意程序）`;
 				if (sessionOpen(id)) return undefined; // #37 主人/全部放开：宿主工具都放
-				return allowed.has(exec.name) ? undefined : `聊天会话（QQ / B站 / 抖音）里不能用 ${exec.name}（只开放记忆工具和上网查；设置页「模型」里可以放开）`;
+				return allowed.has(exec.name) ? undefined : `聊天会话（QQ / B站 / 抖音）里不能用 ${exec.name}（只开放记忆工具、跨平台转达和上网查；设置页「模型」里可以放开）`;
 			}), 'dsh-fish-soul: qq tool guard');
 		} else {
 			log('warn', '[fish-soul] 宿主没有 tools.guard：QQ 会话的工具限制只靠建会话时的 restrict');
@@ -1181,6 +1234,37 @@ async function startup(ctx, config, { log, gate }) {
 		}
 	})), 'dsh-fish-soul: forget');
 
+	// ── 工具：send_elsewhere（主人在 QQ 私聊里让她去抖音 / B站 私信自己一条）──
+	ctx.effect(() => ctx.tools.register(defineTool({
+		name: RELAY_TOOL,
+		description: '在另一个平台（抖音私信 / B站私信）给主人发一条消息。只有主人明确要求（「去抖音给我发」「去B站说一声」这类）时才用，别自己找机会用。' +
+			'话由你自己写，像平时发私信那样自然，直接写要发出去的那一条。只能在主人的私聊里用。',
+		parameters: objectSchema({
+			platform: { type: 'string', enum: ['douyin', 'bili'], required: true, description: "'douyin' | 'bili'" },
+			text: { type: 'string', required: true, description: '要发出去的原话（一段，别加引号）' }
+		}),
+		output: textOutput,
+		async execute(args, toolCtx) {
+			const session = sessionForTool(toolCtx);
+			const channelId = String(session.channelId ?? '');
+			if (channelId === '' || gateway === null) return '不知道现在是在哪个聊天里，先不发。';
+			if (!gateway.isMasterChannel(channelId)) return '这个只能在主人的私聊里用。';
+			const text = String(args.text ?? '').trim();
+			if (text === '') return '内容是空的，没发。';
+			const platform = String(args.platform ?? '');
+			const where = platform === 'bili' ? 'B站' : '抖音';
+			try {
+				const r = await gateway.relayTo(platform, text);
+				if (!r.ok) return `没发成：${r.reason}。`;
+				return r.delivered ? `已经发到${where}了。` : `发到${where}了，但回读没看到，可能被风控吞了。`;
+			} catch (error) {
+				const msg = String(error instanceof Error ? error.message : error);
+				log('warn', `[fish-soul] 跨平台转达失败：${msg}`);
+				return `没发成：${msg.slice(0, 120)}。`;
+			}
+		}
+	})), 'dsh-fish-soul: send_elsewhere');
+
 	// ── 工具：fish_search（自己填 key 的搜索服务；只在鱼的聊天会话里能用，开关 / 次数由上面的护栏管）──
 	ctx.effect(() => ctx.tools.register(defineTool({
 		name: OWN_WEB_TOOL,

package/lib/routes.js

@@ -9,6 +9,8 @@
 import { readFileSync, existsSync } from 'node:fs';
 import { readVecMeta, writeVecMeta, listChatSessions } from './db.js';
 import { douyinState, handleDouyinRoute } from './routes-douyin.js';
+import { douyinSessionHealth } from './douyin-http.js';
+import { describeHealth } from './session-health.js';
 import { handleSoulRoute, sourceLabel } from './routes-soul.js';
 import { handleV07Route } from './routes-v07.js';
 import { handleV09Route } from './routes-v09.js';
@@ -563,6 +565,15 @@ export function registerRoutes(ctx, deps) {
 					item('qq', 'QQ 登录态', qqSt?.connected === true, qqSt?.connected === true
 						? `已登录 ${qqSt.nickname || qqSt.selfId || ''}${qqSt.friendCount != null ? ` · ${qqSt.friendCount} 位好友` : ''}`.trim()
 						: (qqOn ? `没连上${qqSt?.lastError ? '：' + qqSt.lastError : ''}` : 'QQ 没开'));
+					// 抖音登录态还剩多久（只读本地 cookie 文件里的 sid_guard，不联网不抓浏览器）
+					//
+					// 为什么值得单独一项：抖音掉登录的表现和「签名错了」「被风控」一模一样
+					// （都是 status_code 8 / 空 body），查的时候分不清。sid_guard 自带签发时间，
+					// 一眼就能看出是「登录快没了」还是「别的问题」。
+					const dyHealth = douyinSessionHealth();
+					const dyDesc = describeHealth(dyHealth, { warnHours: 24 });
+					item('douyin-session', '抖音登录', dyDesc.ok, dyDesc.detail,
+						dyHealth === null ? '没抓过 cookie，或者抖音还没登录过' : undefined);
 					// 记忆条数
 					try {
 						const n = db.prepare("SELECT COUNT(*) AS n FROM memory WHERE status = 'active' AND valid_to IS NULL").get().n;

package/lib/session-health.js

@@ -0,0 +1,83 @@
+/**
+ * 登录态「还能活多久」——从 cookie 里读，不用等它坏掉才知道。
+ *
+ * 为什么要有这个：
+ *   以前唯一的信号是「请求开始失败」。抖音这边掉登录的表现跟「签名错了」「风控了」
+ *   一模一样（都是 status_code 8 / 空 body），排查时根本分不清是哪一种。
+ *   `sid_guard` 这个 cookie 自带签发时间和有效期，看一眼就知道还剩多久。
+ *
+ * 格式（实测，抖音）：
+ *   sid_guard = <session>|<签发秒>|<有效期秒>|<GMT 字符串>
+ *   例：bfc8e3...%7C1794133354%7C5184001%7CThu,+07-Jan-2027+10:22:35+GMT
+ *   值是 URL 编码的，要 decodeURIComponent 之后再按 `|` 拆。
+ *
+ * 只读：这里只解析字符串，不碰网络、不改 cookie。
+ */
+
+/** 把秒数说成人话：还剩 3 天 / 12 小时 / 8 分钟。 */
+export function humanizeSeconds(sec) {
+	const s = Math.floor(Number(sec));
+	if (!Number.isFinite(s)) return '';
+	if (s <= 0) return '已过期';
+	const day = Math.floor(s / 86400);
+	const hour = Math.floor((s % 86400) / 3600);
+	const min = Math.floor((s % 3600) / 60);
+	if (day > 0) return `${day} 天${hour > 0 ? ` ${hour} 小时` : ''}`;
+	if (hour > 0) return `${hour} 小时${min > 0 ? ` ${min} 分钟` : ''}`;
+	return `${Math.max(1, min)} 分钟`;
+}
+
+/**
+ * 从 sid_guard 的值算出还剩多少秒。
+ * @param {string} raw cookie 原始值（可能是 URL 编码的）
+ * @returns {{remainingSec: number, expiresAt: number, issuedAt: number, ttlSec: number} | null}
+ *          解不出来返回 null（格式变了、或者根本不是 sid_guard）
+ */
+export function parseSidGuard(raw) {
+	if (raw === undefined || raw === null || raw === '') return null;
+	let text = String(raw);
+	try { text = decodeURIComponent(text); } catch { /* 编码坏了就按原样拆 */ }
+	const parts = text.split('|');
+	if (parts.length < 3) return null;
+	const issuedAt = Number(parts[1]);
+	const ttlSec = Number(parts[2]);
+	if (!Number.isFinite(issuedAt) || !Number.isFinite(ttlSec) || issuedAt <= 0 || ttlSec <= 0) return null;
+	const expiresAt = issuedAt + ttlSec;
+	return { remainingSec: expiresAt - Math.floor(Date.now() / 1000), expiresAt, issuedAt, ttlSec };
+}
+
+/**
+ * 从一份 cookie 集合里找 sid_guard 并解析。
+ * @param {Record<string, string>|Array<{name:string,value:string}>} cookies
+ *       两种形态都吃：对象（插件自己存的 `{name: value}`）或 CDP 的数组。
+ * @returns {{remainingSec: number, expiresAt: number} | null}
+ */
+export function sessionHealth(cookies) {
+	if (!cookies) return null;
+	let raw;
+	if (Array.isArray(cookies)) {
+		const hit = cookies.find((c) => c && c.name === 'sid_guard');
+		raw = hit?.value;
+	} else if (typeof cookies === 'object') {
+		raw = cookies.sid_guard ?? cookies.SID_GUARD;
+	}
+	const parsed = parseSidGuard(raw);
+	if (parsed === null) return null;
+	return { remainingSec: parsed.remainingSec, expiresAt: parsed.expiresAt };
+}
+
+/**
+ * 给诊断页用的一句话。
+ * @param {{remainingSec: number}|null} health sessionHealth() 的结果
+ * @param {{warnHours?: number}} [opts] 少于这么多小时就标黄（默认 24）
+ * @returns {{ok: boolean, detail: string}}
+ */
+export function describeHealth(health, { warnHours = 24 } = {}) {
+	if (health === null) return { ok: true, detail: '读不到过期时间（cookie 里没有 sid_guard）' };
+	const { remainingSec } = health;
+	if (remainingSec <= 0) return { ok: false, detail: '登录已过期，需要重新扫码' };
+	const hours = remainingSec / 3600;
+	const text = `还剩 ${humanizeSeconds(remainingSec)}`;
+	if (hours < warnHours) return { ok: false, detail: `${text}（不足 ${warnHours} 小时，快过期了）` };
+	return { ok: true, detail: text };
+}

package/lib/social.js

@@ -1,3 +1,4 @@
+import { sleep } from './time-util.js';
 /**
  * social.js —— 鱼自己发动态 / 作品、回评论区的留言（v0.10，默认都关）。SocialBase 是 B站 / 抖音共用的部分，
  * 这里是 B站（走接口）；抖音（走专用浏览器，尽力而为）在 douyin-social.js。
@@ -20,7 +21,6 @@ const POST_MIN_GAP_REAL_MS = 30 * 60_000;
 const STALE_MS = 24 * HOUR_MS;
 const TYPE_NAME = { 1: '视频', 11: '动态', 17: '动态' };
 
-const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
 const oneLine = (s, n) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, n);
 const errText = (e) => String(e instanceof Error ? e.message : e);
 

package/lib/time-util.js

@@ -1,7 +1,13 @@
 /**
- * time-util.js —— 日期格式化的极小共享工具（零依赖）。
+ * time-util.js —— 时间相关的极小共享工具（零依赖）。
  */
 
+/**
+ * 等一会儿。定时器 unref，不让这个等待挡住 Node 进程退出
+ *（后台轮询里 sleep 时，宿主要退出就退，别被一条 sleep 吊住）。
+ */
+export const sleep = (ms) => new Promise((r) => { const t = setTimeout(r, ms); t.unref?.(); });
+
 /** 两位补零：1 → '01'（备份文件名 / 时间戳格式化共用）。 */
 export function pad2(n) {
 	return String(n).padStart(2, '0');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-fish-soul",
-  "version": "0.15.26",
-  "description": "鱼 · 人格、按人记忆（可纠正、有印象、能导入旧聊天记录）、日程自走与主动开口，直连 SnowLuma 收发 QQ（群里会自己插话），B站 / 抖音小号私信与自己刷视频；按功能选模型并统计用量花费，能听会说 QQ 语音、收藏表情包、学群里的梗，可选上网查；心情影响说话、去 AI 味、每个群的设定、按聊天选模型、每晚写日记、每周记忆存档与可选周记（DSH 插件，单角色 feiyu ，v0.15.14）",
+  "version": "0.15.28",
+  "description": "鱼 · 人格、按人记忆（可纠正、有印象、能导入旧聊天记录）、日程自走与主动开口，直连 SnowLuma 收发 QQ（群里会自己插话），B站 / 抖音小号私信与自己刷视频；按功能选模型并统计用量花费，能听会说 QQ 语音、收藏表情包、学群里的梗，可选上网查；心情影响说话、去 AI 味、每个群的设定、按聊天选模型、每晚写日记、每周记忆存档与可选周记（DSH 插件，单角色 feiyu ，v0.15.28）",
   "type": "module",
   "main": "./lib/index.js",
   "files": [
@@ -64,7 +64,7 @@
     }
   },
   "scripts": {
-    "test": "node test/smoke.mjs && node test/douyin-browser.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",
+    "test": "node test/smoke.mjs && node test/douyin-browser.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-uid-binding.mjs && node test/image-webp-fallback.mjs && node test/douyin-emoji-fallback.mjs && node test/relay-other-platform.mjs",
     "eval": "node test/eval/persona-eval.mjs"
   }
 }