dsh-fish-soul 0.11.2 → 0.12.0

package/README.md

@@ -2,22 +2,22 @@
 
 让一个 QQ 小号背后有"同一个人"：固定人格、按人记记忆、有自己的生活节奏、会主动开口；同一个"她"同时出现在 QQ、B站、抖音。
 
-DSH 插件（单角色 `feiyu`）。版本 **0.11.0**。
+DSH 插件（单角色 `feiyu`）。版本 **0.12.0**。
 
 ## 能力
 
 | 面 | 内容 |
 |---|---|
-| 人格 | 设置页「人格」：7 个内置模板一键换上（第一个「肥鱼 · 通用」只定性格和说话方式、生活细节聊着聊着才有，后面 6 个带现成的生活细节）、可视化编辑、导入 / 导出 SillyTavern 角色卡（PNG / JSON）、撤销上次更换，换完下一轮生效；角色卡（PNG / ccv3 / chara），`{{char}}` / `{{user}}` 宏，世界书（constant / 关键词）；卡里的作息（`extensions.fish_soul.routine`）用来排每天的日程、「看事情的方式」（`perspective`）进人格段、「不同心情下怎么说话」（`moods`）跟着她当下的心情带上；模板按气质分、不绑职业；聊久了会「慢慢长」（性格 / 看法的变化要多次、跨天、跨聊天的证据才生效，人格页可看可删）；从群聊 / 好友私聊里学梗、说话风格和「什么场合怎么说」（只学别人的话、不带人名，按学到的次数挑几条参考） |
-| 记忆 | 按人隔离、本轮即时召回（BM25 + 向量 RRF）、艾宾浩斯衰减（重要度高不淡）、可纠正（留旧档）、出处 `evidence`、每人 ≤150 字印象、8 栏结构化印象、关系阶段演进、好感与情绪、旧聊天记录导入；**聊完自动记**（一次调用产出事实 / 事件 / 感受 + 一句话小结，去重合并）；**隐私**：私聊里的敏感记忆标 `private`，群里检索和召回都不带 |
+| 人格 | 设置页「人格」：7 个内置模板一键换上（第一个「肥鱼 · 通用」只定性格和说话方式、生活细节聊着聊着才有，后面 6 个带现成的生活细节）、可视化编辑、导入 / 导出 SillyTavern 角色卡（PNG / JSON）、撤销上次更换，换完下一轮生效；角色卡（PNG / ccv3 / chara），`{{char}}` / `{{user}}` 宏，世界书（constant / 关键词，可单独导入多本 SillyTavern 世界书：正则 / 整词 / 次要关键词、扫描深度、条数和字数预算）；卡里的作息（`extensions.fish_soul.routine`）用来排每天的日程、「看事情的方式」（`perspective`）进人格段、「不同心情下怎么说话」（`moods`）跟着她当下的心情带上；模板按气质分、不绑职业；聊久了会「慢慢长」（性格 / 看法的变化要多次、跨天、跨聊天的证据才生效，人格页可看可删）；从群聊 / 好友私聊里学梗、说话风格和「什么场合怎么说」（只学别人的话、不带人名，按学到的次数挑几条参考） |
+| 记忆 | 按人隔离、本轮即时召回（BM25 + 向量 RRF）、艾宾浩斯衰减（重要度高不淡）、可纠正（留旧档）、出处 `evidence`、每人 ≤150 字印象、8 栏结构化印象、关系阶段演进、好感与情绪、旧聊天记录导入（断点续传，较早的聊天按时间段总结）、导入麦麦的表情包 / 表达方式 / 黑话、记忆页搜索与批量操作（删除 / 恢复 / 重要度 / 私密）；**聊完自动记**（一次调用产出事实 / 事件 / 感受 + 一句话小结，去重合并）；**隐私**：私聊里的敏感记忆标 `private`，群里检索和召回都不带 |
 | 生活 | 虚拟时钟、每日作息与基调、Dream 整理（只补没写的、会标过时）、主动开口与配额 |
-| QQ | 直连 SnowLuma（OneBot 11 正向 WS）：私聊 / 群聊、群合批带署名、只听点名、戳一戳、撤回不回、可选插话、打字节奏、`/鱼 暂停` |
-| B站 | 扫码登录、私信（只读 / 自动回复）、跨平台认人、空闲自己刷视频、自己发动态 / 回评论（默认关）、Cookie 自动续期、发图 |
-| 抖音 | 专用浏览器扫码登录、私信（只读 / 自动回复）、canary 防风控、空闲刷视频、刷到的分享发抖音私信、自己发图文 / 回作品评论（默认关，尽力而为）、表情包复用 |
+| QQ | 直连 SnowLuma（OneBot 11 正向 WS）：私聊 / 群聊、群合批带署名、只听点名、戳一戳、撤回不回、可选插话、打字节奏、`/鱼 暂停`；**群默认拒绝**（`groupAllowList` 为空且没开 `allGroups` 时谁都不回）、**没发出去的回复排队重发**（退避重试，连上即补发，重启不丢） |
+| B站 | 扫码登录、私信（只读 / 自动回复）、跨平台认人、空闲自己刷视频（看字幕 / 热评 / 弹幕，喜欢可点赞、想再看可收藏，后两个默认关）、自己发动态 / 回评论（默认关；可选别人评论区里 @ 她也回）、Cookie 自动续期、发图 |
+| 抖音 | 专用浏览器扫码登录、私信（只读 / 自动回复）、群聊按人区分（被叫到才回，默认关）、canary 防风控、空闲刷视频、刷到的分享发抖音私信、自己发图文 / 回作品评论（默认关，尽力而为）、表情包复用 |
 | 习惯 | 心情影响说话（快慢、长短、插话概率、表情包多少）、**去 AI 味**（删 markdown / AI 自称 / 套话，太长按句末截）、**每晚写日记**（私密记忆，第二天想跟谁聊）、合并转发展开、每个群的设定（气氛 / 忌讳）、**按聊天选模型**、群冷热、记忆调试器（输一句话看会想起哪几条）、戳回去 / 表情回应 |
 | 语音 | `get_record` → STT；回复 `[语音]` → TTS 发 record（失败 / 太长发文字）；听 / 说可以各配一套地址和 key（TTS 支持小米 MiMo） |
 | 模型 | 按功能选模型、按天 × 功能 × 模型统计用量与花费、可选上网查 |
-| 运维 | 单聊天暂停、动态页、每日自动备份（留 7 份）、记忆导出 / 原样导回 |
+| 运维 | 单聊天暂停、动态页、每日自动备份（留 7 份，设置页可恢复到某一份，重启生效）、设置文件读不懂时拒绝覆盖（带 BOM 也能读）、记忆导出 / 原样导回；设置页顶部显示当前版本，**自动检查更新**（npm / GitHub，每 12 小时，只提示不安装，可关） |
 
 ## 安装
 

package/lib/backup.js

@@ -3,15 +3,128 @@
  *
  *  - `VACUUM INTO` 拷一份完整、一致的库（WAL 模式下也安全，不用停插件）到 $DSH_HOME/fish-soul/backups/；
  *  - 打开自动备份时每天一份（真实时间，插件启动 1 分钟后先看一眼），只留最近 keep 份；
- *  - 恢复不在插件里做：停掉 DSH，把备份文件改名成 soul.db 覆盖回去即可（设置页给出路径）。
+ *  - 恢复（设置页点「恢复到这份」）：先校验备份能打开、结构对、quick_check 通过，记一个 restore-pending.json；
+ *    下次插件启动、打开 soul.db 之前换上去（运行中的库被很多模块拿着，不在跑着的时候硬换）。换之前把当前的库
+ *    VACUUM INTO 另存成 backups/pre-restore-时间.db（恢复错了还能换回来，最多留 3 份），再删掉旧的 -wal / -shm。
  */
-import { existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { DatabaseSync } from 'node:sqlite';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { fishSoulDir, getKv, setKv } from './db.js';
 
 const DAY_MS = 24 * 3600_000;
 const CHECK_MS = 3600_000;
 const NAME_RE = /^soul-\d{8}-\d{6}\.db$/;
+const PRE_RE = /^pre-restore-\d{8}-\d{6}\.db$/;
+const PRE_KEEP = 3;
+const REQUIRED_TABLES = ['memory', 'person', 'kv'];
+
+function pendingPath() {
+	return join(fishSoulDir(), 'restore-pending.json');
+}
+
+/** 等着下次启动换上去的备份（没有 = null）。 */
+export function pendingRestore() {
+	try { return JSON.parse(readFileSync(pendingPath(), 'utf8')); } catch { return null; }
+}
+
+/**
+ * 带着 -wal 的库文件（恢复前另存时库打不开、只能原样拷文件 + WAL）：把 WAL 合并回主文件、改回单文件。
+ * 合并不了（库坏了）就原样留着，恢复时连 WAL 一起拷。返回合并后还有没有 -wal。
+ */
+export function consolidateWal(path) {
+	if (!existsSync(`${path}-wal`)) return false;
+	try {
+		const db = new DatabaseSync(path);
+		try {
+			db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+			db.exec('PRAGMA journal_mode = DELETE');
+		} finally { db.close(); }
+	} catch { /* 合并不了：留着 WAL */ }
+	if (existsSync(`${path}-wal`) && statSync(`${path}-wal`).size === 0) rmSync(`${path}-wal`, { force: true });
+	rmSync(`${path}-shm`, { force: true });
+	return existsSync(`${path}-wal`);
+}
+
+/** 备份文件能不能用：打得开、quick_check 通过、有记忆 / 人物 / kv 表。返回 { memories, persons }。 */
+export function inspectBackup(path) {
+	consolidateWal(path);
+	const db = new DatabaseSync(path, { readOnly: true });
+	try {
+		const check = db.prepare('PRAGMA quick_check').get();
+		const ok = Object.values(check ?? {})[0];
+		if (ok !== 'ok') throw new Error(`备份文件损坏（${String(ok).slice(0, 60)}）`);
+		const tables = new Set(db.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all().map((r) => r.name));
+		const missing = REQUIRED_TABLES.filter((t) => !tables.has(t));
+		if (missing.length > 0) throw new Error(`不像 soul.db 的备份（缺表 ${missing.join('、')}）`);
+		return {
+			memories: db.prepare("SELECT COUNT(*) AS n FROM memory WHERE status = 'active'").get().n,
+			persons: db.prepare('SELECT COUNT(*) AS n FROM person').get().n
+		};
+	} finally {
+		db.close();
+	}
+}
+
+/**
+ * 插件启动时、openDatabase() 之前调：有待恢复的备份就换上去。
+ * @returns {{file: string, safety: string|null, at: number} | null}
+ */
+export function applyPendingRestore({ log = () => {}, nowMs = Date.now() } = {}) {
+	const pending = pendingRestore();
+	if (pending === null) return null;
+	const dir = backupDir();
+	const src = join(dir, String(pending.file ?? ''));
+	const target = join(fishSoulDir(), 'soul.db');
+	const drop = () => rmSync(pendingPath(), { force: true });
+	if (!(NAME_RE.test(pending.file) || PRE_RE.test(pending.file)) || !existsSync(src)) {
+		log('warn', `[fish-soul] 要恢复的备份 ${pending.file} 不在了，没换`);
+		drop();
+		return null;
+	}
+	try {
+		inspectBackup(src);
+	} catch (error) {
+		log('error', `[fish-soul] 要恢复的备份 ${pending.file} 校验失败，没换：${String(error instanceof Error ? error.message : error)}`);
+		drop();
+		return null;
+	}
+	// 当前的库先另存一份（VACUUM INTO 连 WAL 里没合并的也带上；库坏到打不开就原样拷文件）
+	let safety = null;
+	if (existsSync(target)) {
+		mkdirSync(dir, { recursive: true });
+		let name = `pre-restore-${stamp(nowMs)}.db`;
+		for (let i = 1; existsSync(join(dir, name)); i++) name = `pre-restore-${stamp(nowMs + i * 1000)}.db`;
+		const out = join(dir, name);
+		try {
+			const cur = new DatabaseSync(target);
+			try { cur.exec(`VACUUM INTO '${out.replace(/'/g, "''")}'`); } finally { cur.close(); }
+		} catch {
+			copyFileSync(target, out);
+			if (existsSync(`${target}-wal`)) copyFileSync(`${target}-wal`, `${out}-wal`);
+			// 最后一次 checkpoint 之后的写入都在 WAL 里：合并进另存的那份（换回去时才不会丢）
+			consolidateWal(out);
+		}
+		safety = name;
+	}
+	const tmp = `${target}.restoring`;
+	// 要恢复的那份带着 -wal（合并不了的另存）：WAL 跟着一起换上，否则最后一次 checkpoint 之后的数据全丢
+	const srcWal = consolidateWal(src) ? `${src}-wal` : null;
+	copyFileSync(src, tmp);
+	if (srcWal) copyFileSync(srcWal, `${tmp}-wal`);
+	rmSync(`${target}-wal`, { force: true });
+	rmSync(`${target}-shm`, { force: true });
+	renameSync(tmp, target);
+	if (srcWal) renameSync(`${tmp}-wal`, `${target}-wal`);
+	drop();
+	// 恢复前的另存只留最近几份
+	try {
+		const pres = readdirSync(dir).filter((f) => PRE_RE.test(f)).sort().reverse();
+		for (const f of pres.slice(PRE_KEEP)) for (const x of [f, `${f}-wal`, `${f}-shm`]) rmSync(join(dir, x), { force: true });
+	} catch { /* 下次再删 */ }
+	log('info', `[fish-soul] 已从备份 ${pending.file} 恢复 soul.db${safety ? `（恢复前的库另存为 ${safety}）` : ''}`);
+	return { file: pending.file, safety, at: nowMs };
+}
 
 export function backupDir() {
 	return join(fishSoulDir(), 'backups');
@@ -93,18 +206,48 @@ export class BackupService {
 		}
 	}
 
-	/** 现有备份，新的在前。 */
+	/** 现有备份，新的在前（只是自动 / 手动备份；恢复前的另存见 preRestoreList）。 */
 	list() {
+		return this.files(NAME_RE);
+	}
+
+	preRestoreList() {
+		return this.files(PRE_RE).map((f) => ({ ...f, preRestore: true }));
+	}
+
+	files(re) {
 		const dir = backupDir();
 		if (!existsSync(dir)) return [];
-		return readdirSync(dir).filter((f) => NAME_RE.test(f)).map((f) => {
+		return readdirSync(dir).filter((f) => re.test(f)).map((f) => {
 			const st = statSync(join(dir, f));
 			return { file: f, size: st.size, at: st.mtimeMs };
 		}).sort((a, b) => (a.file < b.file ? 1 : -1));
 	}
 
+	/** 选一份备份，下次启动时换上去（先校验）。 */
+	stageRestore(file) {
+		const name = String(file ?? '');
+		if (!(NAME_RE.test(name) || PRE_RE.test(name))) throw new Error('不是插件生成的备份文件');
+		const path = join(backupDir(), name);
+		if (!existsSync(path)) throw new Error('这份备份不在了');
+		const info = inspectBackup(path);
+		const pending = { file: name, at: Date.now(), ...info };
+		writeFileSync(pendingPath(), JSON.stringify(pending), 'utf8');
+		this.log('info', `[fish-soul] 已选好要恢复的备份 ${name}（${info.memories} 条记忆），重启 DSH 后换上`);
+		return pending;
+	}
+
+	cancelRestore() {
+		const had = pendingRestore() !== null;
+		rmSync(pendingPath(), { force: true });
+		return had;
+	}
+
 	state() {
 		const cfg = this.config();
-		return { ...cfg, dir: backupDir(), lastAt: Number(getKv(this.db, 'backup.lastAt', 0)) || null, list: this.list().slice(0, 10) };
+		return {
+			...cfg, dir: backupDir(), lastAt: Number(getKv(this.db, 'backup.lastAt', 0)) || null, list: this.list().slice(0, 10),
+			preRestore: this.preRestoreList(), pendingRestore: pendingRestore(), lastRestored: getKv(this.db, 'backup.restored', null)
+		};
 	}
 }

package/lib/browse.js

@@ -4,6 +4,7 @@
  * 聊天时就能自然说出"我今天刷到……"。默认不点赞、不投币、不评论（点赞可在设置页打开）。
  */
 import { tokenizeForBm25 } from './segment.js';
+import { getKv, setKv } from './db.js';
 
 const BV_RE = /BV[0-9A-Za-z]{10}/g;
 const SHORT_RE = /https?:\/\/(?:b23\.tv|bili2233\.cn)\/[0-9A-Za-z]+/g;
@@ -80,7 +81,10 @@ export class BiliBrowser {
 			perDay: num(br.perDay, 3, 0, 12),
 			videosPerSession: num(br.videosPerSession, 3, 1, 6),
 			like: br.like === true,
-			share: br.share !== false
+			share: br.share !== false,
+			favorite: br.favorite === true,
+			favoritePerDay: num(br.favoritePerDay, 2, 0, 10),
+			danmaku: br.danmaku !== false
 		};
 	}
 
@@ -108,16 +112,28 @@ export class BiliBrowser {
 	}
 
 	/** 视频的"看到的内容"：详情 + 字幕节选 + 热评（字幕要登录，取不到就只看简介和评论）。 */
-	async gather(bvid, { subtitleChars = 1200 } = {}) {
+	async gather(bvid, { subtitleChars = 1200, danmaku = this.cfg().danmaku } = {}) {
 		const info = await this.client.view(bvid);
 		let subtitle = '';
 		try { subtitle = await this.client.subtitleText(info.bvid, info.cid, subtitleChars); } catch { /* 没字幕 */ }
 		let comments = [];
 		try { comments = await this.client.hotComments(info.aid, 3); } catch { /* 没评论 */ }
-		return { ...info, subtitle, comments };
+		let danmakuLines = [];
+		if (danmaku && typeof this.client.danmaku === 'function') {
+			try { danmakuLines = await this.client.danmaku(info.cid, 12); } catch { /* 没弹幕 / 解不开 */ }
+		}
+		return { ...info, subtitle, comments, danmaku: danmakuLines };
+	}
+
+	favDayKey() {
+		return `bili.fav.${this.clock.getRoleDateParts().dateStr}`;
+	}
+
+	favoritedToday() {
+		return Number(getKv(this.db, this.favDayKey(), 0)) || 0;
 	}
 
-	promptFor(v, like, share = false) {
+	promptFor(v, like, share = false, favorite = false) {
 		const p = this.persona?.() ?? { name: '鱼', brief: '' };
 		return [
 			`你是「${p.name}」。${p.brief}`.trim(),
@@ -127,9 +143,11 @@ export class BiliBrowser {
 			v.desc ? `简介：${oneLine(v.desc, 200)}` : '',
 			v.subtitle ? `字幕节选：${v.subtitle}` : '（这个视频没有字幕，只能看简介和评论）',
 			v.comments.length > 0 ? `热评：\n${v.comments.map((c) => `- ${c}`).join('\n')}` : '',
+			(v.danmaku ?? []).length > 0 ? `弹幕（按时间抽了几条）：${v.danmaku.map((d) => oneLine(d, 30)).join(' / ')}` : '',
 			'',
 			'用第一人称、口语化写一两句你看完的感受（大概讲了什么 + 你怎么看），不超过 80 字，不要照抄标题。',
-			'完全没兴趣、划走了就只输出 [划走]。' + (like ? '特别喜欢的话在末尾加 [点赞]。' : '') + (share ? '特别有意思、很想发给朋友看的，在末尾加 [分享]（大多数视频不用）。' : '')
+			'完全没兴趣、划走了就只输出 [划走]。' + (like ? '特别喜欢的话在末尾加 [点赞]。' : '') + (share ? '特别有意思、很想发给朋友看的，在末尾加 [分享]（大多数视频不用）。' : '') +
+				(favorite ? '以后还想再看、值得存起来的（教程、攻略、菜谱、特别喜欢的），在末尾加 [收藏]（大多数视频不用）。' : '')
 		].filter((l) => l !== '').join('\n');
 	}
 
@@ -145,14 +163,15 @@ export class BiliBrowser {
 		return id;
 	}
 
-	async watch(item, like, share = false) {
+	async watch(item, like, share = false, favorite = false) {
 		const v = await this.gather(item.bvid);
-		const out = await this.callLlm(this.promptFor(v, like, share));
+		const out = await this.callLlm(this.promptFor(v, like, share, favorite));
 		const raw = String(out ?? '').trim();
 		const skipped = /\[划走\]/.test(raw);
 		const liked = like && /\[点赞\]/.test(raw);
 		const wantShare = share && !skipped && /\[分享\]/.test(raw);
-		const impression = oneLine(raw.replace(/\[(划走|点赞|分享)\]/g, ''), 120);
+		const wantFav = favorite && !skipped && /\[收藏\]/.test(raw);
+		const impression = oneLine(raw.replace(/\[(划走|点赞|分享|收藏)\]/g, ''), 120);
 		let memoryId = null;
 		if (!skipped) {
 			const who = v.owner ? `${v.owner} 的` : '';
@@ -166,13 +185,23 @@ export class BiliBrowser {
 				this.log('warn', `[fish-soul] 点赞失败：${String(error instanceof Error ? error.message : error)}`);
 			}
 		}
+		let favorited = false;
+		if (wantFav && this.favoritedToday() < this.cfg().favoritePerDay) {
+			try {
+				await this.client.favorite(v.aid);
+				favorited = true;
+				setKv(this.db, this.favDayKey(), this.favoritedToday() + 1);
+			} catch (error) {
+				this.log('warn', `[fish-soul] 收藏失败：${String(error instanceof Error ? error.message : error)}`);
+			}
+		}
 		this.db.prepare(`
-			INSERT INTO bili_seen (bvid, aid, title, owner_name, source, impression, skipped, liked, memory_id, seen_at, seen_real_at)
-			VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+			INSERT INTO bili_seen (bvid, aid, title, owner_name, source, impression, skipped, liked, favorited, memory_id, seen_at, seen_real_at)
+			VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
 			ON CONFLICT(bvid) DO NOTHING
 		`).run(v.bvid, v.aid, oneLine(v.title, 120), oneLine(v.owner, 40), item.source ?? 'recommend', impression,
-			skipped ? 1 : 0, liked ? 1 : 0, memoryId, this.clock.now(), Date.now());
-		return { bvid: v.bvid, title: v.title, owner: v.owner, impression, skipped, liked, share: wantShare && impression !== '', url: `https://www.bilibili.com/video/${v.bvid}` };
+			skipped ? 1 : 0, liked ? 1 : 0, favorited ? 1 : 0, memoryId, this.clock.now(), Date.now());
+		return { bvid: v.bvid, title: v.title, owner: v.owner, impression, skipped, liked, favorited, share: wantShare && impression !== '', url: `https://www.bilibili.com/video/${v.bvid}` };
 	}
 
 	/** 刷一轮。返回看过的视频。 */
@@ -188,7 +217,7 @@ export class BiliBrowser {
 					const [lo, hi] = this.watchDelayMs;
 					await sleep(lo + Math.floor(Math.random() * Math.max(0, hi - lo)));
 				}
-				try { watched.push(await this.watch(item, c.like, c.share && this.share !== null)); } catch (error) {
+				try { watched.push(await this.watch(item, c.like, c.share && this.share !== null, c.favorite && this.favoritedToday() < c.favoritePerDay)); } catch (error) {
 					this.log('warn', `[fish-soul] 看视频 ${item.bvid} 失败：${String(error instanceof Error ? error.message : error)}`);
 				}
 			}
@@ -203,9 +232,9 @@ export class BiliBrowser {
 	/** 设置页：最近看过的。 */
 	recent(limit = 8) {
 		return this.db.prepare(`
-			SELECT bvid, title, owner_name AS owner, impression, skipped, liked, source, seen_real_at AS seenAt
+			SELECT bvid, title, owner_name AS owner, impression, skipped, liked, favorited, source, seen_real_at AS seenAt
 			FROM bili_seen ORDER BY seen_real_at DESC LIMIT ?
-		`).all(limit).map((r) => ({ ...r, skipped: r.skipped === 1, liked: r.liked === 1 }));
+		`).all(limit).map((r) => ({ ...r, skipped: r.skipped === 1, liked: r.liked === 1, favorited: r.favorited === 1 }));
 	}
 
 	/** 瞬态块：最近一个虚拟日里看过、有感受的 2 条。 */
@@ -231,7 +260,7 @@ export class BiliBrowser {
 			const hit = this.described.get(bvid);
 			if (hit !== undefined && Date.now() - hit.at < DESCRIBE_TTL_MS) { notes.push(hit.text); continue; }
 			try {
-				const v = await this.gather(bvid, { subtitleChars: 300 });
+				const v = await this.gather(bvid, { subtitleChars: 300, danmaku: false });
 				const text = `【视频 ${bvid}：《${oneLine(v.title, 60)}》UP主 ${oneLine(v.owner, 20) || '未知'}` +
 					(v.desc ? `；简介：${oneLine(v.desc, 120)}` : '') +
 					(v.subtitle ? `；字幕节选：${oneLine(v.subtitle, 300)}` : '') +

package/lib/channels/bilibili.js

@@ -80,6 +80,16 @@ export function wbiSign(params, key, wts = Math.round(Date.now() / 1000)) {
 }
 
 /** 大整数（msg_key 等）先转字符串再解析。 */
+/** 弹幕 [{t, text}] → 按时间均匀抽 n 条文字（同样的话只留一条）。 */
+export function sampleDanmaku(items, n = 12) {
+	const seen = new Set();
+	const uniq = [...items].sort((a, b) => a.t - b.t).filter((d) => { const k = d.text.toLowerCase(); if (seen.has(k)) return false; seen.add(k); return true; });
+	if (uniq.length <= n) return uniq.map((d) => d.text);
+	const out = [];
+	for (let i = 0; i < n; i++) out.push(uniq[Math.floor((i + 0.5) * uniq.length / n)].text);
+	return out;
+}
+
 export function parseBiliJson(text) {
 	return JSON.parse(String(text).replace(/("(?:msg_key|msg_seqno|talker_id|sender_uid|receiver_id|session_ts|ack_ts|top_ts)"\s*:\s*)(\d{16,})/g, '$1"$2"'));
 }
@@ -518,6 +528,47 @@ export class BiliClient {
 		await this.call('api', '/x/web-interface/archive/like', { form: { aid, like: 1, csrf: this.auth.cookies.bili_jct ?? '' } });
 	}
 
+	/** 自己的默认收藏夹 id（第一次查完记在内存里）。 */
+	async defaultFavFolder() {
+		if (!this.uid) throw new Error('B站没登录');
+		if (this.favFolder?.uid === this.uid) return this.favFolder.id;
+		const json = await this.call('api', '/x/v3/fav/folder/created/list-all', { params: { up_mid: this.uid, type: 2 } });
+		const list = json.data?.list ?? [];
+		// 默认收藏夹 attr 的二进制最低位是 0（官方没写死顺序，找不到就用第一个）
+		const pick = list.find((f) => (Number(f?.attr) & 1) === 0) ?? list[0];
+		if (!pick?.id) throw new Error('没找到收藏夹');
+		this.favFolder = { uid: this.uid, id: String(pick.id) };
+		return this.favFolder.id;
+	}
+
+	/** 收藏到默认收藏夹。 */
+	async favorite(aid) {
+		const folder = await this.defaultFavFolder();
+		await this.call('api', '/x/v3/fav/resource/deal', {
+			form: { rid: aid, type: 2, add_media_ids: folder, del_media_ids: '', csrf: this.auth.cookies.bili_jct ?? '' },
+			referer: `https://www.bilibili.com/video/av${aid}`
+		});
+	}
+
+	/**
+	 * 弹幕抽样（按出现时间均匀取 n 条，去重、去太短的）。接口返回 deflate 压过的 XML，fetch 一般会自己解；
+	 * 解不开 / 没弹幕就返回 []，不影响看视频。
+	 */
+	async danmaku(cid, n = 12) {
+		if (!cid) return [];
+		const res = await this.raw(`https://api.bilibili.com/x/v1/dm/list.so?oid=${encodeURIComponent(cid)}`);
+		if (!res.ok) return [];
+		const xml = await res.text();
+		const items = [];
+		const re = /<d p="([\d.]+)[^"]*">([^<]*)<\/d>/g;
+		let m;
+		while ((m = re.exec(xml)) !== null && items.length < 3000) {
+			const text = m[2].replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&amp;/g, '&').replace(/\s+/g, ' ').trim();
+			if (text.length >= 2) items.push({ t: Number(m[1]) || 0, text: text.slice(0, 40) });
+		}
+		return sampleDanmaku(items, n);
+	}
+
 	// ───────────── 自己发动态 / 回评论（v0.10）─────────────
 
 	/** 发一条纯文字动态，返回动态 id。 */
@@ -568,6 +619,33 @@ export class BiliClient {
 		}).filter((r) => r.id !== '' && r.oid !== '' && r.rpid !== '' && r.type > 0);
 	}
 
+	/**
+	 * "@我的"消息（新的在前），归一化成和 replyFeed 一样的结构，id 加 "at:" 前缀免得和"回复我的"撞号。
+	 * 只留评论区里的 @（item.type === 'reply'）：动态正文里的 @ 没有可回的那条评论。
+	 */
+	async atFeed() {
+		const json = await this.call('api', '/x/msgfeed/at', { params: { platform: 'web', build: 0, mobi_app: 'web' }, referer: 'https://message.bilibili.com/' });
+		return (json.data?.items ?? []).map((it) => {
+			const x = it?.item ?? {};
+			return {
+				id: it?.id === undefined || it?.id === null ? '' : `at:${it.id}`,
+				kind: 'at',
+				mid: String(it?.user?.mid ?? ''),
+				name: String(it?.user?.nickname ?? ''),
+				type: Number(x.business_id ?? 0),
+				oid: String(x.subject_id ?? ''),
+				rpid: String(x.source_id ?? ''),
+				root: String(x.root_id && String(x.root_id) !== '0' ? x.root_id : x.source_id ?? ''),
+				title: String(x.title ?? ''),
+				content: String(x.source_content ?? ''),
+				target: '',
+				time: Number(it?.at_time ?? 0),
+				uri: String(x.uri ?? ''),
+				isComment: String(x.type ?? '') === 'reply'
+			};
+		}).filter((r) => r.id !== '' && r.isComment && r.oid !== '' && r.rpid !== '' && r.type > 0);
+	}
+
 	/** 在评论区回复一条评论（root = 楼主评论，parent = 要回的那条）。返回新评论 id。 */
 	async replyComment({ type, oid, root, parent, message }) {
 		const csrf = this.auth.cookies.bili_jct ?? '';

package/lib/channels/douyin.js

@@ -104,8 +104,40 @@ export function occurrenceIndexes(prints) {
 	});
 }
 
-/** 一条抖音私信 → 入站消息（与 QQ 的 normalizeMessageEvent 同形）。不该当消息的返回 null。 */
-export function normalizeDouyinMessage(m, { name, timeMs, messageId }) {
+/**
+ * 这个会话是不是群聊：接口里的会话类型 = 2、会话 ID 不是单聊的 0:1:xxx:yyy 形状、
+ * 对方的消息来自两个以上不同的人，或者设置页「抖音群聊」里填了这个会话名。
+ */
+export function isGroupConversation(msgs, { name = '', groups = [] } = {}) {
+	if (groups.includes(String(name).trim())) return true;
+	const peers = new Set();
+	for (const m of msgs ?? []) {
+		if (!m) continue;
+		if (Number(m.convType) === 2) return true;
+		const cid = String(m.convId ?? '');
+		if (cid !== '' && /^\d+:\d+:/.test(cid) && !/^0:1:/.test(cid)) return true;
+		if (!m.fromMe) {
+			const who = String(m.senderId || m.secUid || m.senderName || '');
+			if (who !== '') peers.add(who);
+		}
+	}
+	return peers.size >= 2;
+}
+
+/**
+ * 群聊里这条是谁说的：有昵称用昵称（和私信里一样按名字认人，同一个人私信 / 群聊归到一起）；
+ * 只有发送者 ID 就查这个群之前对上过的昵称，再不行用「群友 + ID 后四位」。
+ */
+export function groupSender(m, members = {}) {
+	const id = String(m?.senderId || m?.secUid || '');
+	const name = String(m?.senderName ?? '').trim() || (id !== '' ? String(members[id] ?? '').trim() : '');
+	if (name !== '') return { userId: name, nickname: name };
+	if (id !== '') return { userId: `uid:${id}`, nickname: `群友${id.slice(-4)}` };
+	return { userId: '', nickname: '' };
+}
+
+/** 一条抖音私信 → 入站消息（与 QQ 的 normalizeMessageEvent 同形）。不该当消息的返回 null。群聊按发送者分人。 */
+export function normalizeDouyinMessage(m, { name, timeMs, messageId, group = false, members = {} }) {
 	if (!m || m.fromMe || m.system || m.unsupported) return null;
 	const media = m.media ?? {};
 	const images = [];
@@ -133,6 +165,28 @@ export function normalizeDouyinMessage(m, { name, timeMs, messageId }) {
 		if (!/分享/.test(text)) text = `【分享视频】${text}`;
 	}
 	if (text === '' && images.length === 0) return null;
+	if (group) {
+		const who = groupSender(m, members);
+		// 认不出是谁说的（DOM 里的媒体消息、接口没带发送者）：不能把整个群当成一个人，丢掉
+		if (who.userId === '') return null;
+		return {
+			channel: 'douyin',
+			chatType: 'group',
+			channelId: `douyin-group:${name}`,
+			targetId: name,
+			groupId: name,
+			userId: who.userId,
+			nickname: who.nickname,
+			subType: '',
+			messageId,
+			mentioned: false,
+			replyId: null,
+			text: text.slice(0, 1000),
+			images,
+			links,
+			timeMs
+		};
+	}
 	return {
 		channel: 'douyin',
 		chatType: 'private',
@@ -710,6 +764,12 @@ export class DouyinChannel {
 		for (const item of todo.slice(0, MAX_READS_PER_POLL)) await this.readConversation(item);
 	}
 
+	/** 设置页「抖音群聊」：认不出来的群可以手动填会话名。 */
+	groupNames() {
+		const g = this.getConfig?.()?.groups;
+		return Array.isArray(g) ? g.map((x) => String(x).trim()).filter(Boolean) : [];
+	}
+
 	async readConversation({ c, name, key, st, sig, unread }) {
 		const res = await this.driver.read(name);
 		if (!res?.ok) {
@@ -731,7 +791,21 @@ export class DouyinChannel {
 			const want = typeof c.unread === 'number' && c.unread > 0 ? Math.min(INJECT_ON_FIRST_READ, c.unread) : INJECT_ON_FIRST_READ;
 			fresh = msgs.slice(lastMine + 1).filter((m) => !m.fromMe && !m.system && !m.unsupported).slice(-want);
 		}
-		setKv(this.db, key, { name, sig, window: prints.slice(-WINDOW_KEEP), readAt: Date.now() });
+		// 群聊：认出来一次就记住（之后读到的消息里没带会话类型也按群处理）；顺便记下"发送者 ID → 昵称"
+		const groups = this.groupNames();
+		const group = st?.group === true || isGroupConversation(msgs, { name, groups });
+		const members = { ...(st?.members ?? {}) };
+		if (group) {
+			for (const m of msgs) {
+				const id = String(m?.senderId || m?.secUid || '');
+				const n = String(m?.senderName ?? '').trim();
+				if (id !== '' && n !== '' && !m.fromMe) members[id] = n;
+			}
+			const ids = Object.keys(members);
+			for (const id of ids.slice(0, Math.max(0, ids.length - 200))) delete members[id];
+			if (st?.group !== true) this.log('info', `[fish-soul] 抖音会话「${name}」是群聊，之后按发言的人分开认`);
+		}
+		setKv(this.db, key, { name, sig, window: prints.slice(-WINDOW_KEEP), readAt: Date.now(), ...(group ? { group: true, members } : {}) });
 		const fallbackTime = convTimeMs(c.time) || Date.now();
 		// 同一指纹在这次读到的列表里是第几次出现：对方连发同一句话时，没 seq 的 ID 也不会撞
 		const occ = occurrenceIndexes(prints);
@@ -739,7 +813,7 @@ export class DouyinChannel {
 		for (const [i, m] of fresh.entries()) {
 			const timeMs = Number(m.time) > 1e12 ? Number(m.time) : Number(m.time) > 1e9 ? Number(m.time) * 1000 : fallbackTime;
 			const messageId = m.seq ? `s${m.seq}` : `${prints[base + i]}-${timeMs}-${occ[base + i]}`;
-			const norm = normalizeDouyinMessage(m, { name, timeMs, messageId });
+			const norm = normalizeDouyinMessage(m, { name, timeMs, messageId, group, members });
 			if (norm === null) continue;
 			try { await this.onMessage(norm); } catch (error) {
 				this.log('error', `[fish-soul] 抖音私信处理失败：${errText(error)}`);

package/lib/channels/vendor/douyin-bridge/douyin-api.mjs

@@ -284,6 +284,14 @@ export function parseMessages(raw, opts = {}) {
     const senderId = getInt(c, 7) ?? 0
     const timeMs = getInt(c, 10) ?? 0
     const secUid = getString(c, 14)
+    // fish-soul：#2 是会话类型（1 = 单聊，2 = 群聊）；#9 的扩展属性里有时带发送者昵称
+    const convType = getInt(c, 2) ?? 0
+    let senderName = ''
+    for (const a of c.filter((x) => x.field === 9 && x.kind === 'message')) {
+      const k = getString(a.children, 1)
+      const v = getString(a.children, 2)
+      if (v && /^(s:)?(sender_?nick_?name|nick_?name|sender_?name|user_?name)$/i.test(k)) { senderName = v.trim().slice(0, 40); break }
+    }
 
     // 正文：优先 #8 的 JSON
     let text = ''
@@ -334,6 +342,8 @@ export function parseMessages(raw, opts = {}) {
       /** 是不是我自己发的（靠 sec_uid 比对，拿不到就当未知） */
       fromMe: selfSecUid ? secUid === selfSecUid : null,
       convId: getString(c, 1),
+      convType,
+      senderName,
     })
   }
 

package/lib/channels/vendor/douyin-bridge/douyin-dm.mjs

@@ -162,6 +162,12 @@ function shapeResult(rawMessages, limit, via) {
     seq: m.seq,
     time: m.time,
     kind: m.kind,
+    // fish-soul：群聊要按人分开（谁说的），单聊用不上
+    senderId: m.senderId ? String(m.senderId) : '',
+    secUid: m.secUid || '',
+    senderName: m.senderName || '',
+    convId: m.convId || '',
+    convType: m.convType || 0,
   }))
   return {
     ok: true,
@@ -366,6 +372,18 @@ async function readDMDom({ browser, limit = 30, uname = '', scrollBack = 0 }) {
         .filter(Boolean)
         .filter((s) => !isMeta(s))
 
+      // fish-soul：群聊里对方气泡上面有昵称（单聊没有）。认出来就单独拿出来，别混进正文
+      let senderName = ''
+      if (!fromMe) {
+        const nameEl = box.querySelector('[class*="nickname" i], [class*="nickName"], [class*="senderName" i], [class*="userName"], [data-e2e*="nickname" i]')
+        const n = nameEl ? (nameEl.innerText || nameEl.textContent || '').replace(/\u200b/g, '').trim() : ''
+        if (n && n.length <= 40 && !n.includes(String.fromCharCode(10))) {
+          senderName = n
+          const k = lines.indexOf(n)
+          if (k >= 0) lines.splice(k, 1)
+        }
+      }
+
       const text = lines.join(' ').trim()
 
       // ── 媒体信息（图片 / 表情 / 语音 / 视频 / 位置）──────────────
@@ -410,6 +428,7 @@ async function readDMDom({ browser, limit = 30, uname = '', scrollBack = 0 }) {
         type,
         text: text.slice(0, 500),
         media,
+        senderName,
         // ⭐ y 坐标用于排序（DOM 顺序不可靠）
         y: Math.round(r.top),
       })

package/lib/channels/vendor/douyin-bridge/media.mjs

@@ -306,6 +306,8 @@ export function mergeMessages(api, dom) {
     }
     if (found >= 0) {
       // 把 API 消息（带准确时间戳）放进去
+      // fish-soul：DOM 认出的群聊昵称补到接口消息上（接口里一般只有发送者 ID）
+      if (d.senderName && !apiList[found].senderName) apiList[found] = { ...apiList[found], senderName: d.senderName }
       for (let k = ai; k <= found; k++) out.push(apiList[k])
       ai = found + 1
     } else {