dsh-fish-soul 0.13.8 → 0.14.0

package/README.md

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

package/lib/attachments.js

@@ -0,0 +1,187 @@
+/**
+ * attachments.js —— QQ 附件（文件消息）处理：文本类直接读进正文，看不了的格式存到插件数据目录再报路径。
+ *
+ * 只碰白名单目录里的文件（工作区 / 插件数据目录）：路径不在里面、文件已经没了、读失败，
+ * 一律保留原来的【文件：名字】占位，不往提示词里塞来路不明的东西。
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
+import { basename, extname, join, resolve } from 'node:path';
+import { isInside } from './gateway-util.js';
+
+/** 能直接读进提示词的扩展名。 */
+const TEXT_EXT = new Set(['.txt', '.md', '.log', '.csv', '.json']);
+/** 超过这个大小就不读（提示词放不下）。 */
+const MAX_TEXT_BYTES = 256 * 1024;
+/** 直读最多读前多少字节。 */
+const MAX_READ_BYTES = 8 * 1024;
+/** 二进制落盘单文件上限（超过就保留占位）。 */
+const MAX_BINARY_BYTES = 32 * 1024 * 1024;
+/** 正文里附件的占位（onebot.js 生成的）；用户自己打的【】会被换成〔〕，撞不上。 */
+const PLACEHOLDER_RE = /【文件[^】]*】/g;
+
+/** 附件开关：读文本 / 存二进制。 */
+export function attachmentConfig(cfg) {
+	const a = cfg?.attachments ?? {};
+	return { readText: a.readText !== false, saveBinary: a.saveBinary === true };
+}
+
+/** 文件名里不能有的字符（Windows 也不能有），顺手去掉开头的小点。 */
+function safeName(name) {
+	return String(name ?? '').replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_').replace(/^\.+/, '').trim().slice(0, 60);
+}
+
+/** 读前 8KB；切在多字节字符中间会多出一个替换字符，丢掉。 */
+function readHead(abs) {
+	const buf = readFileSync(abs);
+	const truncated = buf.length > MAX_READ_BYTES;
+	const slice = buf.subarray(0, MAX_READ_BYTES);
+	// 先检测是否合法 UTF-8；非法就抛异常（调用方 catch 保留占位）
+	new TextDecoder('utf-8', { fatal: true }).decode(slice);
+	const text = slice.toString('utf8');
+	// 切在多字节字符中间会多出一个替换字符（U+FFFD），丢掉
+	const clean = text.length > 0 && text.codePointAt(text.length - 1) === 0xfffd ? text.slice(0, -1) : text;
+	return { text: clean, truncated };
+}
+
+/**
+ * fileId 路线（SnowLuma 这类不给 path 的）：get_private_file_url 换直链 → 下载 → 按扩展名读进正文或落盘。
+ * 拿不到链接 / 下载失败 / 超上限：返回 null 保留占位。
+ */
+async function handleDownload(f, ctx, meta) {
+	const { name, ext, size, label, warn } = meta;
+	const fileId = String(f?.fileId ?? '').trim();
+	const fileHash = String(f?.fileHash ?? '').trim();
+	if (typeof ctx.fetchFile !== 'function') { warn('没有文件下载通道'); return null; }
+	if (size > MAX_BINARY_BYTES) { warn('太大了，没拉'); return null; }
+	let bytes = null;
+	try {
+		bytes = await ctx.fetchFile({ fileId, fileHash, url: String(f?.url ?? '') });
+	} catch {
+		warn('下载失败');
+		return null;
+	}
+	if (bytes === null || bytes.length === 0) { warn('没拉到内容'); return null; }
+	if (bytes.length > MAX_BINARY_BYTES) { warn('太大了，没拉'); return null; }
+
+	if (TEXT_EXT.has(ext)) {
+		if (!ctx.readText) return null;
+		if (bytes.length > MAX_TEXT_BYTES) { warn('太大了，没读'); return null; }
+		const slice = bytes.subarray(0, MAX_READ_BYTES);
+		try { new TextDecoder('utf-8', { fatal: true }).decode(slice); } catch { warn('不是有效 UTF-8'); return null; }
+		const text = slice.toString('utf8');
+		const clean = text.length > 0 && text.codePointAt(text.length - 1) === 0xfffd ? text.slice(0, -1) : text;
+		ctx.read.push(label);
+		const body = bytes.length > MAX_READ_BYTES ? `${clean}\n…（内容太长，只读了前 8KB）` : clean;
+		return `【文件 ${label} 内容】\n${body}`;
+	}
+
+	if (!ctx.saveBinary) return null;
+	const dir = String(ctx.dataDir ?? '');
+	if (dir === '') { warn('没有存放目录'); return null; }
+	const base = safeName(name);
+	const dest = join(dir, `${safeName(ctx.messageId) || 'file'}-${base !== '' ? base : '附件'}`);
+	try {
+		mkdirSync(dir, { recursive: true });
+		writeFileSync(dest, bytes);
+	} catch {
+		warn('存不下来');
+		return null;
+	}
+	ctx.saved.push(dest);
+	return `【文件 ${label}：我看不了这种格式，已存到 ${dest}】`;
+}
+
+/**
+ * 一个附件怎么处理：返回替换占位的新文本，处理不了返回 null（占位原样留着）。
+ * SnowLuma 这类不给本地 path 的：先用 fetchFile（get_private_file_url 换链接再下载）拿到 bytes 再走同一套逻辑。
+ * @param {{name?: string, path?: string, url?: string, size?: number, fileId?: string, fileHash?: string}} f
+ * @param {object} ctx
+ */
+async function handleOne(f, ctx) {
+	const name = String(f?.name ?? '').trim();
+	const rawPath = String(f?.path ?? '').trim();
+	const abs = rawPath === '' ? '' : resolve(rawPath);
+	const ext = extname(name !== '' ? name : rawPath).toLowerCase();
+	const size = Number(f?.size) || 0;
+	const label = name !== '' ? name : rawPath !== '' ? basename(rawPath) : '未命名';
+	const warn = (why) => ctx.log?.('warn', `[fish-soul] 附件没读进去（${why}）：${label}`);
+
+	// SnowLuma 路线：没有本地 path，但有 fileId——先用 OneBot API 换链接下载
+	const fileId = String(f?.fileId ?? '').trim();
+	if (abs === '' && fileId !== '') return await handleDownload(f, ctx, { name, ext, size, label, warn });
+
+	if (abs === '') { warn('没有本地路径'); return null; }
+	if (!ctx.roots.some((root) => isInside(root, abs))) { warn('路径不在允许的目录里'); return null; }
+	if (!existsSync(abs)) { warn('文件不在了'); return null; }
+
+	// P0 修复：白名单和源文件都做 realpath，防符号链接 / Windows junction 绕过
+	let realRoots;
+	try { realRoots = ctx.roots.filter((r) => { try { realpathSync.native(r); return true; } catch { return false; } }).map((r) => realpathSync.native(r)); } catch { realRoots = []; }
+	let realAbs;
+	try { realAbs = realpathSync.native(abs); } catch { warn('解析真实路径失败'); return null; }
+	if (!realRoots.some((root) => isInside(root, realAbs))) { warn('真实路径越界（符号链接/junction）'); return null; }
+
+	if (TEXT_EXT.has(ext)) {
+		if (!ctx.readText) return null; // 开关关着：跟以前一样，只留占位
+		if (size > MAX_TEXT_BYTES) { warn('太大了，没读'); return null; }
+		let st;
+		try { st = statSync(realAbs); } catch { warn('拿不到文件信息'); return null; }
+		if (!st.isFile()) { warn('不是文件'); return null; }
+		if (st.size > MAX_TEXT_BYTES) { warn('太大了，没读'); return null; }
+		let head;
+		try { head = readHead(realAbs); } catch { warn('读取失败'); return null; }
+		ctx.read.push(label);
+		const body = head.truncated ? `${head.text}\n…（内容太长，只读了前 8KB）` : head.text;
+		return `【文件 ${label} 内容】\n${body}`;
+	}
+
+	if (!ctx.saveBinary) return null; // 不存二进制：跟以前一样，只留占位
+	// P1 修复：二进制也设上限，防大文件占满磁盘
+	if (size > MAX_BINARY_BYTES) { warn('二进制太大，没存'); return null; }
+	let bst;
+	try { bst = statSync(realAbs); } catch { warn('拿不到文件信息'); return null; }
+	if (!bst.isFile()) { warn('不是普通文件'); return null; }
+	if (bst.size > MAX_BINARY_BYTES) { warn('二进制太大，没存'); return null; }
+	const dir = String(ctx.dataDir ?? '');
+	if (dir === '') { warn('没有存放目录'); return null; }
+	const base = safeName(name) !== '' ? safeName(name) : safeName(basename(realAbs));
+	const dest = join(dir, `${safeName(ctx.messageId) || 'file'}-${base !== '' ? base : '附件'}`);
+	try {
+		mkdirSync(dir, { recursive: true });
+		copyFileSync(realAbs, dest);
+	} catch {
+		warn('存不下来');
+		return null;
+	}
+	ctx.saved.push(dest);
+	return `【文件 ${label}：我看不了这种格式，已存到 ${dest}】`;
+}
+
+/**
+ * 把附件处理进消息正文：占位换成内容（或存下来的路径），处理不了的占位原样留着。
+ * @param {string} text 原正文（里面有【文件：名字】占位）
+ * @param {Array<{name?: string, path?: string, url?: string, size?: number}>} files 附件（顺序与占位一致）
+ * @param {{readText?: boolean, saveBinary?: boolean, roots?: string[], dataDir?: string, messageId?: string, log?: (level: string, msg: string) => void}} opts
+ * @returns {{text: string, read: string[], saved: string[]}} read = 读进正文的附件名，saved = 落盘的绝对路径
+ */
+export async function applyAttachments(text, files, opts = {}) {
+	const src = String(text ?? '');
+	const list = Array.isArray(files) ? files : [];
+	if (list.length === 0) return { text: src, read: [], saved: [] };
+	const marks = [...src.matchAll(PLACEHOLDER_RE)];
+	if (marks.length === 0) return { text: src, read: [], saved: [] };
+	const ctx = { readText: true, saveBinary: false, roots: [], dataDir: '', messageId: '', log: () => {}, ...opts };
+	const read = [];
+	const saved = [];
+	ctx.read = read;
+	ctx.saved = saved;
+	const repl = await Promise.all(marks.map((mark, i) => (list[i] === undefined ? null : handleOne(list[i], ctx))));
+	// 从后往前替换，前面占位的位置不受影响
+	let out = src;
+	for (let i = repl.length - 1; i >= 0; i--) {
+		if (repl[i] === null) continue;
+		const at = marks[i].index;
+		out = out.slice(0, at) + repl[i] + out.slice(at + marks[i][0].length);
+	}
+	return { text: out, read, saved };
+}

package/lib/browse.js

@@ -56,7 +56,7 @@ export class BiliBrowser {
 	 * @param {(level: string, msg: string) => void} [deps.log]
 	 * @param {[number, number]} [deps.watchDelayMs] 两条视频之间"看"多久（真实毫秒）
 	 */
-	constructor({ db, clock, client, getConfig, callLlm, persona, worker, log, watchDelayMs = [8000, 20000], share, note }) {
+	constructor({ db, clock, client, getConfig, callLlm, persona, worker, log, watchDelayMs = [8000, 20000], share, note, frames }) {
 		this.share = share ?? null; // 刷到特别想分享的：交给自走层排一条主动消息（带链接）
 		this.note = note ?? null; // 记一条动态
 		this.db = db;
@@ -70,6 +70,7 @@ export class BiliBrowser {
 		this.watchDelayMs = watchDelayMs;
 		this.running = false;
 		this.described = new Map();
+		this.framesOf = frames ?? null; // 抽九宫格看画面（可缺：没有就只读文字）
 	}
 
 	cfg() {
@@ -84,7 +85,15 @@ export class BiliBrowser {
 			share: br.share !== false,
 			favorite: br.favorite === true,
 			favoritePerDay: num(br.favoritePerDay, 2, 0, 10),
+			commentReply: br.commentReply === true,
+			commentReplyPerDay: num(br.commentReplyPerDay, 1, 0, 5),
+			hotComments: num(br.hotComments, 6, 0, 10),
 			danmaku: br.danmaku !== false,
+			comment: br.comment === true,
+			commentPerDay: num(br.commentPerDay, 1, 0, 5),
+			frames: br.frames === true,
+			framesPerDay: num(br.framesPerDay, 1, 0, 5),
+			framesPerDayChat: num(br.framesPerDayChat, 10, 0, 30),
 			search: br.search === true,
 			searchKeywords: (Array.isArray(br.searchKeywords) ? br.searchKeywords : [])
 				.map((w) => String(w ?? '').trim()).filter((w) => w !== '').slice(0, 20),
@@ -149,7 +158,7 @@ export class BiliBrowser {
 			try { subtitle = await this.client.subtitleText(info.bvid, info.cid, subtitleChars); } catch { /* 没字幕 */ }
 		}
 		let comments = [];
-		try { comments = await this.client.hotComments(info.aid, 3); } catch { /* 没评论 */ }
+		try { comments = await this.client.hotComments(info.aid, this.cfg().hotComments); } catch { /* 没评论 */ }
 		let danmakuLines = [];
 		if (danmaku && typeof this.client.danmaku === 'function') {
 			try { danmakuLines = await this.client.danmaku(info.cid, 12); } catch { /* 没弹幕 / 解不开 */ }
@@ -157,10 +166,40 @@ export class BiliBrowser {
 		return { ...info, subtitle, comments, danmaku: danmakuLines };
 	}
 
+	framesDayKey() {
+		return `bili.frames.${this.clock.getRoleDateParts().dateStr}`;
+	}
+
+	framedToday() {
+		return Number(getKv(this.db, this.framesDayKey(), 0)) || 0;
+	}
+
+	/** 你发链接给她时抽的帧，另记一本账，不占她自己刷视频的次数。 */
+	framesChatDayKey() {
+		return `bili.frames.chat.${this.clock.getRoleDateParts().dateStr}`;
+	}
+
+	framedTodayChat() {
+		return Number(getKv(this.db, this.framesChatDayKey(), 0)) || 0;
+	}
+
 	favDayKey() {
 		return `bili.fav.${this.clock.getRoleDateParts().dateStr}`;
 	}
 
+	replyDayKey() {
+		return `bili.reply.${this.clock.getRoleDateParts().dateStr}`;
+	}
+
+	repliedToday() {
+		return Number(getKv(this.db, this.replyDayKey(), 0)) || 0;
+	}
+
+	/** 最近一次回过的评论（设置页显示用），没回过返回 null。 */
+	recentReply() {
+		return getKv(this.db, 'bili.reply.last', null) ?? null;
+	}
+
 	favoritedToday() {
 		return Number(getKv(this.db, this.favDayKey(), 0)) || 0;
 	}
@@ -173,6 +212,14 @@ export class BiliBrowser {
 		return Number(getKv(this.db, this.searchDayKey(), 0)) || 0;
 	}
 
+	commentDayKey() {
+		return `bili.comment.${this.clock.getRoleDateParts().dateStr}`;
+	}
+
+	commentedToday() {
+		return Number(getKv(this.db, this.commentDayKey(), 0)) || 0;
+	}
+
 	/** 她最近看过的几条标题（给她自己提搜索词当原料）。 */
 	recentTitles(n = 5) {
 		try {
@@ -234,7 +281,7 @@ export class BiliBrowser {
 		return drafted;
 	}
 
-	promptFor(v, like, share = false, favorite = false) {
+	promptFor(v, like, share = false, favorite = false, hasFrames = false) {
 		const p = this.persona?.() ?? { name: '鱼', brief: '' };
 		return [
 			`你是「${p.name}」。${p.brief}`.trim(),
@@ -244,6 +291,7 @@ 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')}` : '',
+			hasFrames ? '画面：附了一张九宫格截图（从开头每 6 秒一格，共 9 格）。如果画面能看清，就在感受里写一句画面里的具体细节——谁在做什么、什么颜色、场景长什么样；实在看不清就写“没看到画面”。' : '',
 			(v.danmaku ?? []).length > 0 ? `弹幕（按时间抽了几条）：${v.danmaku.map((d) => oneLine(d, 30)).join(' / ')}` : '',
 			'',
 			'用第一人称、口语化写一两句你看完的感受（大概讲了什么 + 你怎么看），不超过 80 字，不要照抄标题。',
@@ -264,9 +312,147 @@ export class BiliBrowser {
 		return id;
 	}
 
+	/**
+	 * 要不要抽帧看画面：开关开着、有 cid、不是短片、今天还有额度。
+	 * 失败只记一条 warn，返回 null —— 绝不因为抽帧失败就看不到视频。
+	 */
+	async frameIfWanted(v, c) {
+		if (c.frames !== true || typeof this.framesOf !== 'function') return null;
+		if (!v.cid || (Number(v.duration ?? 0) < 120)) return null;
+		if (this.framedToday() >= Number(c.framesPerDay ?? 1)) return null;
+		try {
+			const img = await this.framesOf(v);
+			if (img?.data) {
+				setKv(this.db, this.framesDayKey(), this.framedToday() + 1);
+				return img;
+			}
+		} catch (error) {
+			this.log('warn', `[fish-soul] 抽帧没成（照旧只看文字）：${String(error instanceof Error ? error.message : error)}`);
+		}
+		return null;
+	}
+
+	/** 你发链接过来时抽一帧，额度跟"自己刷"分开。 */
+	async frameForLink(v, c) {
+		if (c.frames !== true || typeof this.framesOf !== 'function') return null;
+		if (!v.cid || (Number(v.duration ?? 0) < 60)) return null;
+		if (this.framedTodayChat() >= Number(c.framesPerDayChat ?? 10)) return null;
+		try {
+			const img = await this.framesOf(v);
+			if (img?.data) {
+				setKv(this.db, this.framesChatDayKey(), this.framedTodayChat() + 1);
+				return img;
+			}
+		} catch (error) {
+			this.log('warn', `[fish-soul] 分享抽帧没成（照旧只看文字）：${String(error instanceof Error ? error.message : error)}`);
+		}
+		return null;
+	}
+
+	/** 把一张九宫格读成一句话，写进聊天时她能看到的那段文字里。 */
+	async visualNote(v, frame) {
+		try {
+			const text = await this.callLlm(
+				`这是 B站 视频《${oneLine(v.title, 40)}》开头的九宫格截图（每格约 6 秒）。` +
+					'用一句不超过 30 字的话，写画面里看到的具体东西：谁在做什么、什么颜色、什么场景。' +
+					'看不清就只写「没看清」。不要分点、不要引号、不要写"这张图"。',
+				{ feature: 'browse', maxTokens: 80, images: [frame] }
+			);
+			const t = oneLine(String(text ?? '').replace(/^["“]|["”]$/g, ''), 40);
+			return t && t !== '没看清' ? t : '';
+		} catch (error) {
+			this.log('warn', `[fish-soul] 读画面没成：${String(error instanceof Error ? error.message : error)}`);
+			return '';
+		}
+	}
+
+	/** 评论区留一句的提示词（短、口语、像真人随手写的）。 */
+	commentPrompt(v, impression) {
+		const p = this.persona?.() ?? { name: '鱼', brief: '' };
+		return [
+			`你是「${p.name}」。${p.brief}`.trim(),
+			`你刚看完 B站 视频《${oneLine(v.title, 60)}》${v.owner ? `（UP主 ${oneLine(v.owner, 20)}）` : ''}。`,
+			`你自己记下的感受：${oneLine(impression, 100)}`,
+			'现在想在评论区留一句（不是回谁，就是自己看完想说）。',
+			'要求：第一人称、口语、一到两句，不超过 25 个字；像真人随手写的，不要「打卡」「沙发」「前排」这类；不@人、不贴链接、不复述标题、不评价 UP主 本人。',
+			'只想说「好看」这种空话，就只输出 [不评]。否则只输出那句话本身。'
+		].filter(Boolean).join('\n');
+	}
+
+	/** 在视频底下留一句。成功返回评论文本，没留返回 ''。 */
+	async commentOn(v, impression) {
+		let text = '';
+		try {
+			const out = String((await this.callLlm(this.commentPrompt(v, impression))) ?? '').trim();
+			if (/\[不评\]/.test(out)) return '';
+			text = oneLine(out.replace(/^[「“"']|[」”"']$/g, ''), 25);
+		} catch (error) {
+			this.log('warn', `[fish-soul] 想评论没想出来：${String(error instanceof Error ? error.message : error)}`);
+			return '';
+		}
+		if (text === '') return '';
+		try {
+			await Promise.race([
+				this.client.replyComment({ type: 1, oid: v.aid, root: 0, parent: 0, message: text }),
+				new Promise((_, reject) => setTimeout(() => reject(new Error('评论发帖超时')), 15_000))
+			]);
+			setKv(this.db, this.commentDayKey(), this.commentedToday() + 1);
+			this.log('info', `[fish-soul] 在《${oneLine(v.title, 30)}》评论区留了一句：${text}`);
+			return text;
+		} catch (error) {
+			this.log('warn', `[fish-soul] 评论没发出去：${String(error instanceof Error ? error.message : error)}`);
+			return '';
+		}
+	}
+
+	/**
+	 * 楼中楼：从视频现有评论里挑一条值得搭话的，回一句（只回一条，不追着聊）。
+	 * 模型输出「序号|回复内容」；[不回] / 序号不合法 / 内容为空都算没回。
+	 */
+	async commentReplyOn(v) {
+		let list = [];
+		try {
+			list = await this.client.commentList(v.aid, 10);
+		} catch (error) {
+			this.log('warn', `[fish-soul] 读评论没成：${String(error instanceof Error ? error.message : error)}`);
+			return '';
+		}
+		const me = String(this.client.uid ?? '');
+		list = (list ?? []).filter((x) => x.content && x.rpid && String(x.mid) !== me);
+		if (list.length === 0) return '';
+		const p = this.persona?.() ?? { name: '鱼', brief: '' };
+		const lines = [
+			`你是「${p.name}」。${p.brief}`.trim(),
+			`你刚看完 B站 视频《${oneLine(v.title, 50)}》。评论区长这样：`,
+			...list.map((x, i) => `${i + 1}. ${x.name || '有人'}：${x.content}`),
+			'挑一条你想接话的，回一句。要求：第一人称、口语、一到两句，不超过 30 个字；',
+			'不要复述他说的话，不要@人，不要引战、不要跟人抬杠，不评价 UP主 本人，广告和骂人的别接。',
+			'没有想接的就只输出 [不回]。要回就只输出「序号|回复内容」，两行都不要解释。'
+		];
+		const out = String((await this.callLlm(lines.join('\n'))) ?? '').trim();
+		if (out === '' || /\[不回\]/.test(out)) return '';
+		const m = out.match(/^\s*(\d{1,2})\s*[|｜]\s*([\s\S]+)$/);
+		if (!m) return '';
+		const pick = list[Number(m[1]) - 1];
+		const text = oneLine(m[2].replace(/^[「“"']|[」”"']$/g, ''), 60);
+		if (!pick || text === '') return '';
+		try {
+			await this.client.replyComment({ type: 1, oid: v.aid, root: pick.rpid, parent: 0, message: text });
+			setKv(this.db, this.replyDayKey(), this.repliedToday() + 1);
+			setKv(this.db, 'bili.reply.last', { bvid: v.bvid, title: oneLine(v.title, 40), name: pick.name, text, root: pick.rpid, at: Date.now() });
+			this.log('info', `[fish-soul] 回了 @${pick.name} 的评论：${text}`);
+			return text;
+		} catch (error) {
+			this.log('warn', `[fish-soul] 回评论没发出去：${String(error instanceof Error ? error.message : error)}`);
+			return '';
+		}
+	}
+
 	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, favorite));
+		const c = this.cfg();
+		const frame = await this.frameIfWanted(v, c);
+		const out = await this.callLlm(this.promptFor(v, like, share, favorite, frame !== null), frame ? { images: [frame] } : undefined);
 		const raw = String(out ?? '').trim();
 		const skipped = /\[划走\]/.test(raw);
 		const liked = like && /\[点赞\]/.test(raw);
@@ -296,13 +482,24 @@ export class BiliBrowser {
 				this.log('warn', `[fish-soul] 收藏失败：${String(error instanceof Error ? error.message : error)}`);
 			}
 		}
+		// 评论区留一句：只在真看完、有感受、开关开着、今天还没到额度时
+		let commented = '';
+		if (!skipped && impression !== '' && c.comment && v.aid && this.commentedToday() < c.commentPerDay) {
+			commented = await this.commentOn(v, impression);
+		}
+		// 楼中楼：回一条别人的评论（默认关，单独额度）
+		let replied = '';
+		const replyCfg = this.cfg();
+		if (!skipped && replyCfg.commentReply && v.aid && this.repliedToday() < replyCfg.commentReplyPerDay) {
+			replied = await this.commentReplyOn(v);
+		}
 		this.db.prepare(`
 			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, 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}` };
+		return { bvid: v.bvid, title: v.title, owner: v.owner, impression, skipped, liked, favorited, commented, replied, share: wantShare && impression !== '', url: `https://www.bilibili.com/video/${v.bvid}` };
 	}
 
 	/** 刷一轮。返回看过的视频。 */
@@ -363,10 +560,13 @@ export class BiliBrowser {
 			if (hit !== undefined && Date.now() - hit.at < DESCRIBE_TTL_MS) { notes.push(hit.text); continue; }
 			try {
 				const v = await this.gather(bvid, { subtitleChars: c.subtitleChars, danmaku: false });
+				const frame = await this.frameForLink(v, c);
+				const visual = frame ? await this.visualNote(v, frame) : '';
 				const text = `【视频 ${bvid}：《${oneLine(v.title, 60)}》UP主 ${oneLine(v.owner, 20) || '未知'}` +
 					(v.desc ? `；简介：${oneLine(v.desc, c.descChars)}` : '') +
 					(v.subtitle ? `；字幕节选：${oneLine(v.subtitle, c.subtitleChars)}` : '') +
-					(v.comments[0] ? `；热评：${oneLine(v.comments[0], c.hotCommentChars)}` : '') + '】';
+					(v.comments[0] ? `；热评：${oneLine(v.comments[0], c.hotCommentChars)}` : '') +
+					(visual ? `；画面：${visual}` : '') + '】';
 				this.described.set(bvid, { text, at: Date.now() });
 				if (this.described.size > 200) this.described.delete(this.described.keys().next().value);
 				notes.push(text);

package/lib/channels/bilibili.js

@@ -546,6 +546,24 @@ export class BiliClient {
 		return body.map((b) => String(b.content ?? '')).join('，').slice(0, maxChars);
 	}
 
+	/**
+	 * 视频评论列表（给"回一条别人的评论"用）：带 rpid / 作者 / 内容，按热度取前 n 条。
+	 */
+	async commentList(aid, n = 10) {
+		if (!aid) return [];
+		const json = await this.call('api', '/x/v2/reply/wbi/main', { wbi: true, params: { type: 1, oid: aid, mode: 3, ps: 20 } });
+		return (json.data?.replies ?? [])
+			.map((r) => ({
+				rpid: String(r?.rpid ?? ''),
+				mid: String(r?.mid ?? ''),
+				name: String(r?.member?.uname ?? '').slice(0, 20),
+				content: String(r?.content?.message ?? '').replace(/\s+/g, ' ').slice(0, 120),
+				like: Number(r?.like ?? 0)
+			}))
+			.filter((x) => x.rpid && x.mid && x.content !== '')
+			.slice(0, n);
+	}
+
 	async hotComments(aid, n = 3) {
 		if (!aid) return [];
 		const json = await this.call('api', '/x/v2/reply/wbi/main', { wbi: true, params: { type: 1, oid: aid, mode: 3, ps: 5 } });
@@ -653,7 +671,7 @@ export class BiliClient {
 	 */
 	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 list = (json.data?.items ?? []).map((it) => {
 			const x = it?.item ?? {};
 			return {
 				id: it?.id === undefined || it?.id === null ? '' : `at:${it.id}`,
@@ -664,6 +682,8 @@ export class BiliClient {
 				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 ?? ''),
+				// 他是「回复某条评论」时 @ 她的吗？target_id 指向被回复的那条（0 = 顶层新评论）
+				targetId: String(x.target_id ?? '0'),
 				title: String(x.title ?? ''),
 				content: String(x.source_content ?? ''),
 				target: '',
@@ -672,6 +692,36 @@ export class BiliClient {
 				isComment: String(x.type ?? '') === 'reply'
 			};
 		}).filter((r) => r.id !== '' && r.isComment && r.oid !== '' && r.rpid !== '' && r.type > 0);
+		// 「回复某条评论 + @ 她」时，把她被回的那条原文也带上（顶层 @ 没有这条，跳过）
+		for (const it of list) {
+			if (it.targetId === '' || it.targetId === '0' || it.targetId === it.rpid) continue;
+			const text = await this.commentText({ type: it.type, oid: it.oid, root: it.root, rpid: it.targetId });
+			if (text !== '') it.target = text;
+		}
+		return list;
+	}
+
+	/** 取一条评论的原文（被 @ 时用来还原"他回的是谁"），拿不到返回空串。 */
+	async commentText({ type, oid, root, rpid }) {
+		const flat = (s) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 160);
+		const want = (r) => (r && String(r.rpid) === String(rpid) ? flat(`${r?.member?.uname ?? ''}：${r?.content?.message ?? ''}`) : '');
+		try {
+			for (const pn of [1, 2]) {
+				const json = await this.call('api', '/x/v2/reply/reply', {
+					params: { type, oid, root, ps: 50, pn },
+					referer: 'https://www.bilibili.com/'
+				});
+				const data = json?.data ?? {};
+				const hitRoot = want(data.root);
+				if (hitRoot !== '') return hitRoot;
+				for (const r of data.replies ?? []) {
+					const hit = want(r);
+					if (hit !== '') return hit;
+				}
+				if ((data.replies ?? []).length < 50) break;
+			}
+		} catch { /* 拿不到就当没有 */ }
+		return '';
 	}
 
 	/** 在评论区回复一条评论（root = 楼主评论，parent = 要回的那条）。返回新评论 id。 */