dsh-fish-soul 0.15.21 → 0.15.23

package/README.md

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

package/lib/capability.js

@@ -0,0 +1,77 @@
+/**
+ * capability.js —— 「她关于自己装置能力」的说法（#76）。
+ *
+ * 问题：她曾长期坚称「我没有识图能力、只能读字」。这类陈述写进长期记忆后，
+ * 会因为「被反复想起」被自动升到 3 星（3 星不衰减 → 永生），每轮都注入，
+ * 于是现实（插件早就能发图 / 抽帧）变了，记忆却比现实更坚定，最后她被自己写下的记忆说服。
+ *
+ * 这里只做判定，不做存储策略：
+ *  - isCapabilityClaim(text)：这是不是一句「关于自己能不能做某事」的话；
+ *  - CAPABILITY_NEGATIONS / CAPABILITY_SUBJECTS：判定用的词表（保守，宁可漏判也不误伤）；
+ *  - 她现在实际能做什么（PLUGIN_CAPABILITIES）：插件侧的代码事实，供注入时的标注与人工核对。
+ *
+ * 只认**她自己**说的（owner_id = 'self'）：说别人「他不能看图」是稳定的事实，不受影响。
+ */
+
+/** 否定 / 限定的说法。 */
+const NEGATIONS = ['不能', '不会', '没法', '无法', '不支持', '没有', '只能', '只会', '看不了', '读不了', '识不了', '发不了'];
+
+/** 能力名词：装置 / 平台相关的功能。 */
+const SUBJECTS = [
+	'看图', '识图', '读图', '看图片', '看照片', '图片', '照片', '看视频', '视频', '抽帧',
+	'语音', '表情包', '表情', '上网', '搜图', '搜索', '回评论', '评论', '刷B站', '刷抖音', 'B站', '抖音'
+];
+
+/** 明确"只能读字"这类说法：字面不含上面的能力名词，但同样是能力断言。 */
+const TEXT_ONLY = ['只能读字', '只能看字', '只认字', '只能看文字', '只能处理文字', '只支持文字'];
+
+/**
+ * 插件现在实际做的事（代码事实，供人工核对 / 文档引用）。
+ * 注意：能不能"看懂"由宿主模型决定，插件只保证"确实把图/帧/语音送到她面前"。
+ */
+export const PLUGIN_CAPABILITIES = [
+	'看图（QQ 照片、表情包原图）',
+	'看视频抽帧',
+	'收发语音',
+	'刷 B站 / 抖音',
+	'回评论（抖音 / B站）',
+	'主动开口、按人记忆'
+];
+
+/**
+ * 这句话是不是「关于自己能不能做某事」的能力断言。
+ * 判定保守：必须同时出现"否定/限定"和"能力名词"，或命中"只能读字"这类固定说法。
+ * @param {string} text
+ * @returns {boolean}
+ */
+export function isCapabilityClaim(text) {
+	const s = String(text ?? '').trim();
+	if (s === '') return false;
+	if (TEXT_ONLY.some((t) => s.includes(t))) return true;
+	if (!NEGATIONS.some((n) => s.includes(n))) return false;
+	return SUBJECTS.some((t) => s.includes(t));
+}
+
+/** 第三人称标记：出现了就说明说的不是她自己（"他不能看图"是稳定事实，不该按易失能力处理）。 */
+const THIRD_PERSON = ['他们', '她们', '别人', '大家', '同事', '朋友', '老师', '他', '她'];
+
+/**
+ * 这句话是不是「**她自己**说自己不能做某事」。
+ * 自己写的记忆通常是第一人称；出现第三人称就当说的是别人。
+ * @param {string} text
+ * @returns {boolean}
+ */
+export function isSelfCapabilityClaim(text) {
+	const s = String(text ?? '').trim();
+	if (!isCapabilityClaim(s)) return false;
+	return !THIRD_PERSON.some((t) => s.includes(t));
+}
+
+/**
+ * 注入时给能力类记忆加的标注：提醒模型这是"以前的说法"，装置 / 模型变了就可能过期。
+ * @param {string} text
+ * @returns {string} 标注（不是能力断言就返回空串）
+ */
+export function capabilityStaleTag(text) {
+	return isSelfCapabilityClaim(text) ? '可能已过时' : '';
+}

package/lib/config-platforms.js

@@ -78,7 +78,9 @@ export function douyinConfigSchema(z) {
 			videosPerSession: z.number().default(3),
 			like: z.boolean().default(false),
 			share: z.boolean().default(true), // 刷到特别想分享的，给主人发链接 + 感受（走主动开口的限制）
-			shareInDm: z.boolean().default(true) // 抖音刷到的分享发在抖音私信里（主人；抖音没开 / 没连上就发 QQ）
+			shareInDm: z.boolean().default(true), // 抖音刷到的分享发在抖音私信里（主人；抖音没开 / 没连上就发 QQ）
+			// 刷抖音走哪条路：'http' = 纯 HTTP（tab/feed + detail + comment/list，不开浏览器）；'browser' = 老路（专用浏览器里滑推荐页）
+			mode: z.string().default('http')
 		}).default({}),
 		post: z.object({ // 自己发图文作品（文字卡片 + 文案，走创作者中心，尽力而为）
 			enabled: z.boolean().default(false),

package/lib/douyin-browse.js

@@ -1,8 +1,14 @@
 /**
- * douyin-browse.js —— 鱼自己刷抖音：空闲时在专用浏览器里打开推荐页，像人一样看几条（每条停 5–20 秒）再划走，
- * 然后挑出来的几条打开详情读文案和热评，用她自己的口吻写一两句感受，记进"自己的记忆"（owner_id='self'）。
+ * douyin-browse.js —— 鱼自己刷抖音：空闲时拿一批推荐，像人一样看几条（每条停 5–20 秒）再划走，
+ * 然后挑出来的几条读详情和热评，用她自己的口吻写一两句感受，记进"自己的记忆"（owner_id='self'）。
  * 默认不点赞（设置页可打开）；直播间、看过的跳过。
  *
+ * 两条路（`douyin.browse.mode`）：
+ *  - **http（默认）**：纯 HTTP 拉推荐流（tab/feed）+ 详情 + 评论列表，不开浏览器。
+ *    实测（2026-11-08 真机）：tab/feed 与 aweme/detail 只要 secsdk 那道 md5 签名；
+ *    comment/list 还要 a_bogus（见 lib/douyin-http.js 与 vendor/douyin-bogus.js）。
+ *  - **browser（旧路）**：在专用浏览器里滑推荐页，像以前一样。http 模式失败时自动退回这条路。
+ *
  * 读推荐页当前视频的做法参考了 LockyBee/dsh-douyin-agent（MIT）的 core.mjs，代码是这里自己写的。
  */
 import { afterRound } from './browse.js';
@@ -94,8 +100,9 @@ export class DouyinBrowser {
 	 * @param {() => {name: string, brief: string}} deps.persona
 	 * @param {[number, number]} [deps.dwellMs] 推荐页每条看多久（真实毫秒）
 	 * @param {(opts: {browser: object, id: string, commentLimit?: number}) => Promise<object>} [deps.readDetail]
+	 * @param {import('./douyin-http.js').DouyinHttp} [deps.http] 纯 HTTP 客户端（http 模式用）
 	 */
-	constructor({ db, clock, host, getConfig, callLlm, persona, worker, log, dwellMs = [5000, 20000], readDetail = detail, settleMs = 8000, fetchImpl, share, note }) {
+	constructor({ db, clock, host, getConfig, callLlm, persona, worker, log, dwellMs = [5000, 20000], readDetail = detail, settleMs = 8000, fetchImpl, share, note, http }) {
 		this.share = share ?? null;
 		this.note = note ?? null;
 		this.db = db;
@@ -110,7 +117,9 @@ export class DouyinBrowser {
 		this.readDetail = readDetail;
 		this.settleMs = settleMs;
 		this.fetch = fetchImpl ?? ((...a) => fetch(...a));
+		this.http = http ?? null; // 纯 HTTP 客户端（http 模式用；没有就退回浏览器）
 		this.running = false;
+		this.httpBroken = false; // 这轮试过纯 HTTP 不行 → 退回浏览器
 		this.described = new Map();
 	}
 
@@ -128,9 +137,21 @@ export class DouyinBrowser {
 	}
 
 	get ready() {
+		// http 模式：cookie 里有登录态就行；没有 cookie 但浏览器在跑且已登录，也能现抓一次 cookie。
+		if (this.useHttp()) {
+			return (this.http !== null && this.http.isLoggedIn()) || (this.host.running && this.host.loggedIn === true);
+		}
 		return this.host.running && this.host.loggedIn === true;
 	}
 
+	/** 走纯 HTTP 还是走浏览器。默认 http；没有 http 客户端、或这轮试过不行，就退回浏览器。 */
+	useHttp() {
+		if (this.http === null) return false;
+		if (this.httpBroken === true) return false;
+		const mode = this.getConfig()?.browse?.mode;
+		return mode !== 'browser';
+	}
+
 	seen(id) {
 		return this.db.prepare('SELECT 1 FROM douyin_seen WHERE aweme_id = ?').get(String(id)) !== undefined;
 	}
@@ -195,6 +216,43 @@ export class DouyinBrowser {
 	}
 
 	async scroll(count) {
+		if (this.useHttp()) {
+			const items = await this.httpScroll(count);
+			if (items.length > 0) return items;
+			this.log('warn', '[fish-soul] 抖音纯 HTTP 没拿到推荐，退回浏览器刷');
+		}
+		return this.browserScroll(count);
+	}
+
+	/**
+	 * 纯 HTTP 拿推荐：tab/feed 每次返回都是全新的一批（实测 0 条重复），要多几条就多请求几次。
+	 * 过滤：看过的、广告、直播/生活号、下架的。
+	 */
+	async httpScroll(count) {
+		const picked = [];
+		const seenThisRound = new Set();
+		for (let round = 0; round < 3 && picked.length < count; round++) {
+			const feed = await this.http.feed(12);
+			if (!feed.ok) {
+				this.log('warn', `[fish-soul] 抖音推荐流没拉到：${feed.raw?.error ?? `status=${feed.raw?.status} status_code=${feed.raw?.json?.status_code}`}`);
+				break;
+			}
+			for (const a of feed.list) {
+				if (picked.length >= count) break;
+				const id = String(a.aweme_id ?? '');
+				if (id === '' || this.seen(id) || seenThisRound.has(id)) continue;
+				if (a.is_ads === true || a.is_life_item === true || a.is_story === true) continue; // 广告 / 直播 / 生活号
+				if (a.status?.is_prohibited === true || a.status?.in_reviewing === true) continue; // 下架 / 审核中
+				seenThisRound.add(id);
+				picked.push({ id, title: String(a.desc ?? '').trim().slice(0, 300), author: String(a.author?.nickname ?? '').trim().slice(0, 40) });
+				await sleep(this.dwell()); // 每条停一会儿 —— 跟以前在推荐页上滑一样
+			}
+		}
+		return picked;
+	}
+
+	/** 旧路：在浏览器推荐页里滑。 */
+	async browserScroll(count) {
 		const b = this.host.browser;
 		await b.goto(FEED_URL, { settleMs: this.settleMs });
 		// 被 302 弹回精选页时，用真实鼠标点进推荐流；进不去就停下来，别再空刷一轮
@@ -252,6 +310,60 @@ export class DouyinBrowser {
 
 	/** 细看一条：详情页读文案 + 热评 → 感受 → 记忆（要点赞就在详情页点）。 */
 	async watch(item, like, share = false) {
+		if (this.useHttp()) {
+			const r = await this.httpWatch(item, like, share);
+			if (r !== null) return r;
+			this.log('warn', `[fish-soul] 抖音纯 HTTP 没读到 ${item.id}，退回浏览器`);
+		}
+		return this.browserWatch(item, like, share);
+	}
+
+	/**
+	 * 纯 HTTP 细看一条：aweme/detail 拿文案与话题 + comment/list 拿热评（comment/list 要 a_bogus）。
+	 * 点赞暂时不做（纯 HTTP 的点赞接口要另外验签名），所以 liked 恒为 false。
+	 * @returns {Promise<object|null>} null = 这条读不到，交给调用方退回浏览器
+	 */
+	async httpWatch(item, like, share = false) {
+		const det = await this.http.detail(item.id);
+		if (!det.ok || det.detail === null) {
+			this.log('warn', `[fish-soul] 抖音视频 ${item.id} 详情没拉到：${det.raw?.error ?? `status=${det.raw?.status}`}`);
+			return null;
+		}
+		const d = det.detail;
+		const cm = await this.http.comments(item.id, { count: 6 });
+		const v = {
+			id: item.id,
+			title: String(d.desc ?? item.title ?? ''),
+			desc: String(d.desc ?? item.title ?? ''),
+			author: String(d.author?.nickname ?? item.author ?? ''),
+			tags: (Array.isArray(d.text_extra) ? d.text_extra : []).map((t) => String(t?.hashtag_name ?? '')).filter(Boolean),
+			comments: (cm.ok ? cm.list : []).map((c) => ({ text: String(c.text ?? ''), author: String(c.user?.nickname ?? '') }))
+		};
+		const out = await this.callLlm(this.promptFor(v, like, share));
+		const raw = String(out ?? '').trim();
+		const skipped = /\[划走\]/.test(raw);
+		const wantLike = like && /\[点赞\]/.test(raw);
+		const wantShare = share && !skipped && /\[分享\]/.test(raw);
+		const impression = oneLine(raw.replace(/\[(划走|点赞|分享)\]/g, ''), 120);
+		const title = oneLine(v.title || v.desc, 60);
+		let memoryId = null;
+		if (!skipped) {
+			const who = v.author ? `${oneLine(v.author, 20)} 的` : '';
+			const content = impression !== ''
+				? `我在抖音刷到${who}视频《${title || '没写文案'}》：${impression}`
+				: `我在抖音刷到${who}视频《${title || '没写文案'}》`;
+			memoryId = this.writeMemory(content, v.id);
+		}
+		this.db.prepare(`
+			INSERT INTO douyin_seen (aweme_id, title, author, impression, skipped, liked, memory_id, seen_at, seen_real_at)
+			VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+			ON CONFLICT(aweme_id) DO NOTHING
+		`).run(v.id, oneLine(v.title || v.desc, 120), oneLine(v.author, 40), impression, skipped ? 1 : 0, 0, memoryId, this.clock.now(), Date.now());
+		return { id: v.id, title: v.title || v.desc, author: v.author, impression, skipped, liked: false, share: wantShare && impression !== '', url: `https://www.douyin.com/video/${v.id}` };
+	}
+
+	/** 旧路：浏览器里打开详情页读文案 + 热评（要点赞就在详情页点）。 */
+	async browserWatch(item, like, share = false) {
 		const b = this.host.browser;
 		let d = null;
 		try { d = await this.readDetail({ browser: b, id: item.id, commentLimit: 6 }); } catch (error) {
@@ -297,6 +409,17 @@ export class DouyinBrowser {
 	/** 刷一轮。返回看过的视频。 */
 	async run({ count } = {}) {
 		if (this.running) return { ok: false, error: '正在刷，稍等' };
+		// http 模式：先把登录态准备好（cookie 落盘优先，没有才去浏览器 CDP 抓一次）。
+		// 拿不到就这轮退回浏览器（旧路），别硬刷。
+		if (this.useHttp()) {
+			const ok = await this.http.ensureCookies();
+			if (!ok || !this.http.isLoggedIn()) {
+				this.httpBroken = true;
+				this.log('warn', `[fish-soul] 抖音纯 HTTP 没拿到登录态（${this.http.lastError || '未登录'}），这轮退回浏览器`);
+			} else {
+				this.httpBroken = false;
+			}
+		}
 		if (!this.ready) return { ok: false, error: this.host.running ? '抖音还没登录' : '抖音浏览器没在运行' };
 		this.running = true;
 		try {
@@ -355,7 +478,8 @@ export class DouyinBrowser {
 
 	/** 聊天里有人发了抖音视频：打开详情读文案和热评，拼一段简短介绍进消息，让她"看过"再回。 */
 	async describe(refs, { max = 1 } = {}) {
-		if (!this.ready) return [];
+		// http 模式不卡 ready：没有 cookie 就退回浏览器那条路（浏览器没在跑就自然读不到）
+		if (!this.ready && !(this.useHttp() && this.host.running)) return [];
 		const ids = [...(refs.ids ?? [])];
 		for (const s of refs.shorts ?? []) {
 			if (ids.length >= max) break;
@@ -366,6 +490,16 @@ export class DouyinBrowser {
 		for (const id of ids.slice(0, max)) {
 			const hit = this.described.get(id);
 			if (hit !== undefined && Date.now() - hit.at < DESCRIBE_TTL_MS) { notes.push(hit.text); continue; }
+			// http 模式：详情 + 热评都走接口（comment/list 要 a_bogus）；读不到再退回浏览器
+			if (this.useHttp()) {
+				const text = await this.httpDescribe(id);
+				if (text !== null) {
+					this.described.set(id, { text, at: Date.now() });
+					if (this.described.size > 200) this.described.delete(this.described.keys().next().value);
+					notes.push(text);
+					continue;
+				}
+			}
 			try {
 				const d = await this.host.exclusive('看分享的抖音', () => this.readDetail({ browser: this.host.browser, id, commentLimit: 3 }), { maxMs: 45_000 });
 				if (!d?.ok) continue;
@@ -379,4 +513,15 @@ export class DouyinBrowser {
 		}
 		return notes;
 	}
+
+	/** 纯 HTTP 拼一段视频介绍（详情 + 第一条热评）。读不到返回 null。 */
+	async httpDescribe(id) {
+		const det = await this.http.detail(id);
+		if (!det.ok || det.detail === null) return null;
+		const d = det.detail;
+		const cm = await this.http.comments(id, { count: 3 });
+		const c0 = cm.ok ? cm.list[0] : null;
+		return `【抖音视频：${oneLine(d.desc, 120) || '（没有文案）'}；作者 ${oneLine(d.author?.nickname, 20) || '未知'}` +
+			(c0 ? `；热评：${oneLine(c0.text ?? c0, 60)}` : '') + '】';
+	}
 }

package/lib/douyin-http.js

@@ -0,0 +1,314 @@
+/**
+ * douyin-http.js —— 抖音网页端的纯 HTTP 客户端（不开浏览器）。
+ *
+ * 三件事，别的模块都靠它：
+ *  1. **登录态**：cookie 落盘在 ~/.dsh/fish-soul/douyin-cookie.json；没有就从**正在跑的抖音浏览器**
+ *     用 CDP `Network.getCookies` 抓一次明文（Chrome 的 Cookies 文件是 DPAPI+AES 加密的，
+ *     浏览器开着时还锁着文件，copy 不了 —— 只能走 CDP）。抓完落盘，之后浏览器可以关。
+ *  2. **签名**：两道，都能本地算：
+ *     - `x-secsdk-web-signature` = md5(`${uifid}_${timestamp}_${SALT}_${query}`)
+ *       （SALT 是 project 34 = douyin_web 的常量；uifid 取自 cookie，名字是**大写** UIFID / UIFID_TEMP）
+ *       —— tab/feed、aweme/detail 这类端点只要这一道。
+ *     - `a_bogus`（SM3+RC4，见 vendor/douyin-bogus.js）—— comment/* 这类端点还要它，
+ *       光有 secsdk 签名会返回 0 字节 / status_code 8。
+ *  3. **公共参数**：网页端那组 device_platform/aid/channel/version_code/… **是整体校验的**，
+ *     少一个就报「参数不合法」——整组照抄（来源：douyin-cli 油猴脚本的公共参数块）。
+ *
+ * 实测（2026-11-08 真机）：tab/feed → 200/status_code 0/12 条；aweme/detail → 200/84KB；
+ * comment/list → 0 字节（缺 a_bogus）。
+ */
+import { createHash } from 'node:crypto';
+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';
+
+export const DOUYIN_WEB_ORIGIN = 'https://www.douyin.com';
+
+/** x-secsdk-web-signature 的盐（project 34 = douyin_web）。抖音换 project id 就得换这个值。 */
+export const SECSDK_SALT = 'A96D855A08C0A9707F8BEF0D9A527E4E';
+
+/** cookie 里 uifid 的可能名字。**注意实际是大写**（UIFID / UIFID_TEMP）。 */
+export const UIFID_COOKIE_NAMES = ['uifid', 'uifid_temp', 'uifidtemp', 'UIFID', 'UIFID_TEMP', 'UIFIDTEMP'];
+
+export const CHROME_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36';
+
+/** 屏指纹：a_bogus 会把它编进签名，必须和 User-Agent 对得上（Win 就用 Windows 那组）。 */
+export const WIN_SCREEN_FINGERPRINT = '1920|366|1918|1048|1920|1050|1920|1080|Win32';
+
+/**
+ * 网页端公共参数（整体校验，少一个就「参数不合法」）。
+ * @param {{width?: number, height?: number, chromeVersion?: string}} [opts]
+ * @returns {Array<[string, string]>}
+ */
+export function douyinBaseParams(opts = {}) {
+	const chromeVer = opts.chromeVersion ?? '156.0.0.0';
+	return [
+		['device_platform', 'webapp'],
+		['aid', '6383'],
+		['channel', 'channel_pc_web'],
+		['pc_client_type', '1'],
+		['pc_libra_divert', 'Windows'],
+		['update_version_code', '170400'],
+		['support_h265', '1'],
+		['support_dash', '1'],
+		['version_code', '170400'],
+		['version_name', '17.4.0'],
+		['cookie_enabled', 'true'],
+		['screen_width', String(opts.width ?? 1536)],
+		['screen_height', String(opts.height ?? 864)],
+		['browser_language', 'zh-CN'],
+		['browser_platform', 'Win32'],
+		['browser_name', 'Chrome'],
+		['browser_version', chromeVer],
+		['browser_online', 'true'],
+		['engine_name', 'Blink'],
+		['engine_version', chromeVer],
+		['os_name', 'Windows'],
+		['os_version', '10'],
+		['cpu_core_num', '12'],
+		['device_memory', '16'],
+		['platform', 'PC'],
+		['downlink', '10'],
+		['effective_type', '4g'],
+		['round_trip_time', '100'],
+	];
+}
+
+/** 秒级时间戳（签名里用）。 */
+export const nowStamp = () => String(Math.floor(Date.now() / 1000));
+
+/**
+ * 算 x-secsdk-web-signature。
+ * @param {{uifid: string, stamp: string, query: string}} args
+ * @returns {string} 32 位小写 hex
+ */
+export function secsdkSignature({ uifid, stamp, query }) {
+	return createHash('md5').update(`${uifid}_${stamp}_${SECSDK_SALT}_${query}`).digest('hex');
+}
+
+/**
+ * 算 a_bogus（comment/* 这类端点要）。
+ * @param {{query: string, body?: string, userAgent?: string, screenFingerprint?: string}} args
+ * @returns {string}
+ */
+export function aBogusSignature({ query, body = '', userAgent = CHROME_UA, screenFingerprint = WIN_SCREEN_FINGERPRINT }) {
+	return generateABogus({ query, body, userAgent, screenFingerprint });
+}
+
+/** cookie 文件位置（和插件其它数据放一起，不进仓库；跟着 DSH_HOME 走，测试才能隔离）。 */
+export function douyinCookiePath() {
+	return join(dshHome(), 'fish-soul', 'douyin-cookie.json');
+}
+
+/**
+ * 抖音网页端的纯 HTTP 客户端。
+ */
+export class DouyinHttp {
+	/**
+	 * @param {object} deps
+	 * @param {() => object} [deps.getConfig] config.douyin（取 browserPort 之类）
+	 * @param {(level: string, msg: string) => void} [deps.log]
+	 * @param {number} [deps.cdpPort] 抖音浏览器的 CDP 端口（默认 47890）
+	 * @param {typeof fetch} [deps.fetchImpl]
+	 */
+	constructor({ getConfig, log, cdpPort = 47890, fetchImpl } = {}) {
+		this.getConfig = getConfig ?? (() => ({}));
+		this.log = log ?? (() => {});
+		this.cdpPort = cdpPort;
+		this.fetch = fetchImpl ?? ((...a) => fetch(...a));
+		/** @type {Map<string,string>} name → value（同名取第一个） */
+		this.jar = new Map();
+		this.loaded = false;
+		this.lastError = '';
+		// 构造时就读一次落盘的 cookie：这样 isLoggedIn() 立刻准（路由层是同步判断）
+		this.loadCookies();
+	}
+
+	/** cookie 落盘路径。 */
+	cookiePath() {
+		return douyinCookiePath();
+	}
+
+	/** 从磁盘读 cookie（落盘过一次就用它，浏览器可以关）。 */
+	loadCookies() {
+		const p = this.cookiePath();
+		if (!existsSync(p)) return false;
+		try {
+			const raw = JSON.parse(readFileSync(p, 'utf8'));
+			const map = raw?.cookies ?? {};
+			this.jar = new Map(Object.entries(map).filter(([, v]) => typeof v === 'string' && v !== ''));
+			this.loaded = this.jar.size > 0;
+			return this.loaded;
+		} catch (error) {
+			this.lastError = `cookie 文件读不了：${error instanceof Error ? error.message : error}`;
+			return false;
+		}
+	}
+
+	/** 把 cookie 落盘（本地目录，不进仓库；含登录态，权限设 0600）。 */
+	saveCookies() {
+		try {
+			const p = this.cookiePath();
+			mkdirSync(join(p, '..'), { recursive: true });
+			writeFileSync(p, JSON.stringify({ savedAt: Date.now(), cookies: Object.fromEntries(this.jar) }), { mode: 0o600 });
+			return true;
+		} catch (error) {
+			this.lastError = `cookie 存不了：${error instanceof Error ? error.message : error}`;
+			return false;
+		}
+	}
+
+	/**
+	 * 从正在跑的抖音浏览器 CDP 抓一次明文 cookie（只读）。
+	 * Chrome 的 Cookies 文件是 DPAPI+AES 加密的，浏览器开着时还锁着 —— 只能走 CDP。
+	 * @returns {Promise<boolean>} 有没有抓到
+	 */
+	async captureFromBrowser() {
+		if (!(this.cdpPort > 0)) {
+			this.lastError = '没配 CDP 端口，抓不了 cookie';
+			return false;
+		}
+		try {
+			const listRes = await this.fetch(`http://127.0.0.1:${this.cdpPort}/json/list`, { signal: AbortSignal.timeout(5000) });
+			const targets = await listRes.json();
+			const page = targets.find((t) => t.type === 'page' && String(t.url).includes('douyin.com'));
+			if (page === undefined) {
+				this.lastError = `CDP ${this.cdpPort} 上没有抖音页面`;
+				return false;
+			}
+			const cookies = await new Promise((resolve, reject) => {
+				const ws = new WebSocket(page.webSocketDebuggerUrl);
+				const timer = setTimeout(() => { ws.close(); reject(new Error('CDP 超时')); }, 10_000);
+				ws.addEventListener('open', () => ws.send(JSON.stringify({ id: 1, method: 'Network.getCookies', params: { urls: ['https://www.douyin.com/'] } })));
+				ws.addEventListener('message', (ev) => {
+					const msg = JSON.parse(String(ev.data));
+					if (msg.id !== 1) return;
+					clearTimeout(timer);
+					ws.close();
+					if (msg.error) { reject(new Error(`CDP 报错：${JSON.stringify(msg.error)}`)); return; }
+					resolve(msg.result?.cookies ?? []);
+				});
+				ws.addEventListener('error', (e) => { clearTimeout(timer); reject(new Error(`WS 出错：${e.message ?? e}`)); });
+			});
+			const jar = new Map();
+			for (const c of cookies) {
+				if (!String(c.domain ?? '').includes('douyin.com')) continue;
+				if (!jar.has(c.name)) jar.set(c.name, String(c.value ?? '')); // 同名取第一个
+			}
+			if (jar.size === 0) {
+				this.lastError = 'CDP 拿到的 cookie 是空的';
+				return false;
+			}
+			this.jar = jar;
+			this.loaded = true;
+			this.saveCookies();
+			return true;
+		} catch (error) {
+			this.lastError = `从浏览器抓 cookie 失败：${error instanceof Error ? error.message : error}`;
+			return false;
+		}
+	}
+
+	/** 有 cookie 就用；没有就先去浏览器抓一次（抓不到就返回 false）。 */
+	async ensureCookies() {
+		if (this.loaded && this.jar.size > 0) return true;
+		if (this.loadCookies()) return true;
+		return this.captureFromBrowser();
+	}
+
+	/** 登录态：有没有 sessionid。 */
+	isLoggedIn() {
+		return (this.jar.get('sessionid') ?? '') !== '' || (this.jar.get('sessionid_ss') ?? '') !== '';
+	}
+
+	/** uifid（secsdk 签名要用；cookie 里是大写名字）。 */
+	uifid() {
+		for (const n of UIFID_COOKIE_NAMES) {
+			const v = this.jar.get(n);
+			if (v !== undefined && v !== '') return v;
+		}
+		return '';
+	}
+
+	/** Cookie 头。 */
+	cookieHeader() {
+		return [...this.jar.entries()].map(([k, v]) => `${k}=${v}`).join('; ');
+	}
+
+	/**
+	 * 发一个网页端请求（GET / POST）。
+	 * @param {object} args
+	 * @param {string} args.path 例如 '/aweme/v1/web/tab/feed/'
+	 * @param {Array<[string,string]>} [args.params] 端点自己的参数
+	 * @param {string} [args.body] POST 的表单体（会自动算 a_bogus 的 body 摘要）
+	 * @param {boolean} [args.aBogus] 是否要 a_bogus（comment/* 要）
+	 * @param {boolean} [args.post] 用 POST
+	 * @param {string} [args.referer]
+	 * @returns {Promise<{status: number, ok: boolean, json: any, text: string}>}
+	 */
+	async request({ path, params = [], body = '', aBogus = false, post = false, referer = `${DOUYIN_WEB_ORIGIN}/`, timeoutMs = 20_000 }) {
+		if (!(await this.ensureCookies())) {
+			return { status: 0, ok: false, json: null, text: '', error: this.lastError || '没有抖音登录态' };
+		}
+		const stamp = nowStamp();
+		const uifid = this.uifid();
+		const pairs = [...douyinBaseParams(), ...params];
+		if (uifid !== '') pairs.push(['uifid', uifid]);
+		pairs.push(['timestamp', stamp]);
+		const query = new URLSearchParams(pairs).toString();
+		const headers = {
+			'User-Agent': CHROME_UA,
+			Referer: referer,
+			Accept: 'application/json, text/plain, */*',
+			...(uifid !== '' ? { uifid } : {}),
+			'x-secsdk-web-expire': stamp,
+			Cookie: this.cookieHeader(),
+		};
+		let url = `${DOUYIN_WEB_ORIGIN}${path}?${query}&x-secsdk-web-signature=${secsdkSignature({ uifid, stamp, query })}`;
+		if (aBogus) {
+			const ab = aBogusSignature({ query, body });
+			url += `&a_bogus=${encodeURIComponent(ab)}`;
+			headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=UTF-8';
+		}
+		const init = { method: post ? 'POST' : 'GET', headers, signal: AbortSignal.timeout(timeoutMs) };
+		if (post) init.body = body;
+		let res;
+		try {
+			res = await this.fetch(url, init);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			this.lastError = message;
+			return { status: 0, ok: false, json: null, text: '', error: message };
+		}
+		const text = await res.text();
+		let json = null;
+		try { json = JSON.parse(text); } catch { /* 不是 JSON 就原样返回 */ }
+		return { status: res.status, ok: res.ok, json, text, url };
+	}
+
+	/** 首页推荐流。实测每次请求都是全新的一批（0 条重复），所以要更多就多请求几次。 */
+	async feed(count = 12) {
+		const r = await this.request({ path: '/aweme/v1/web/tab/feed/', params: [['count', String(count)], ['refresh_index', '1'], ['video_type_select', '1'], ['aweme_type', '0'], ['disable_group_auto_play', '1'], ['is_home_taken_down', 'false'], ['need_time_list', '0']] });
+		const list = r.json?.aweme_list ?? r.json?.data?.aweme_list ?? [];
+		return { ok: r.ok && Array.isArray(list) && list.length > 0, list, raw: r };
+	}
+
+	/** 单个视频详情（要 a_bogus 的端点用 aBogus: true）。 */
+	async detail(awemeId) {
+		const r = await this.request({ path: '/aweme/v1/web/aweme/detail/', params: [['aweme_id', String(awemeId)]] });
+		const d = r.json?.aweme_detail ?? r.json?.data?.aweme_detail ?? null;
+		return { ok: r.ok && d !== null, detail: d, raw: r };
+	}
+
+	/** 评论列表（**要 a_bogus**，否则返回 0 字节）。 */
+	async comments(awemeId, { cursor = '0', count = 20 } = {}) {
+		const r = await this.request({
+			path: '/aweme/v1/web/comment/list/',
+			params: [['aweme_id', String(awemeId)], ['cursor', String(cursor)], ['count', String(count)], ['item_type', '0'], ['insert_ids', '']],
+			aBogus: true,
+		});
+		const list = r.json?.comments ?? r.json?.data?.comments ?? [];
+		return { ok: r.ok && Array.isArray(list) && list.length > 0, list, raw: r };
+	}
+}