dsh-social-trace 0.1.13 → 0.1.18

package/lib/index.js

@@ -4,11 +4,17 @@ import { parseHistoryRange } from './history-range.js';
 import { Store } from './store.js';
 import { Worker } from './worker.js';
 import { WeiboBrowser } from './platforms/weibo/index.js';
+import { DouyinBrowser } from './platforms/douyin/index.js';
+import { VideoLibrary } from './platforms/douyin/library.js';
+import { saveConfig as saveDouyinConfig, validatePublicConfig as validateDouyinPublicConfig, status as douyinStatus } from './platforms/douyin/service.js';
+import { platformModule } from './platforms/registry.js';
+import { createReadStream, statSync } from 'node:fs';
 import { XueqiuBrowser } from './platforms/xueqiu/index.js';
 import { dataDirectory, workspaceDirectory, saveWorkspaceDirectory, chooseDirectory } from './paths.js';
-import { Documents } from './documents.js';
+import { Documents, videoMarkdown } from './documents.js';
 import { Avatars } from './avatars.js';
 import { SocialAgent } from './agent.js';
+import { hostAgentRuntime } from './chat-runtime.js';
 import { hostModel } from './chat-model.js';
 import { BusinessChat } from './chat.js';
 import { createBusiness } from './business.js';
@@ -47,7 +53,7 @@ function localRequest(req) {
   return local && ['127.0.0.1', '::1', '::ffff:127.0.0.1'].includes(address);
 }
 
-export function createRuntime(directory = dataDirectory(), { adapterFactories = { weibo: WeiboBrowser, xueqiu: XueqiuBrowser }, chooseFolder = chooseDirectory, avatarFetch = fetch, getIM = () => null, model = hostModel(() => null), updates = createUpdates() } = {}) {
+export function createRuntime(directory = dataDirectory(), { adapterFactories = { weibo: WeiboBrowser, xueqiu: XueqiuBrowser, douyin: DouyinBrowser }, chooseFolder = chooseDirectory, avatarFetch = fetch, getIM = () => null, model = hostModel(() => null), updates = createUpdates(), videoOptions = {} } = {}) {
   let workspace = realpathSync(workspaceDirectory(directory));
   let store = new Store(workspace);
   let documents = new Documents(store, workspace);
@@ -66,9 +72,13 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
       requestGapMs: Math.max(browser.defaults?.requestGapMs || 15000, store.getSetting(id === 'weibo' ? 'requestGapMs' : `requestGapMs:${id}`, browser.defaults?.requestGapMs || 15000)) });
     return [id, { browser, worker, loginBusy: false, historyBusy: false }];
   }));
+  const videos = new VideoLibrary(() => store, () => documents, videoOptions);
   const { browser, worker } = sources.weibo;
   let closing = false;
-  const business = createBusiness(() => store, sources, () => documents.drainImages());
+  const business = createBusiness(() => store, sources, () => documents.drainImages(), {
+    validate(target, options) { if (target.platform !== 'douyin') throw new CaptureError('input', '此平台不支持视频保存或每日时间点设置'); return validateDouyinPublicConfig(store, target.uid, options); },
+    save(target, options) { saveDouyinConfig(store, { platform: target.platform, uid: target.uid, inherit: false, config: options }, { media: videos, worker: sources[target.platform].worker }); },
+  });
   const chat = new BusinessChat(() => store, business, model, { paused: () => changingWorkspace || applyingUpdate || closing || !!serviceError });
 
   function enableAuthorJob(uid, kind) {
@@ -95,7 +105,7 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
     if (destination === workspace) { saveWorkspaceDirectory(directory, destination); await documents.sync({ backgroundImages: true }); return; }
     const database = join(destination, 'archive.sqlite');
     if (existsSync(database)) throw new CaptureError('storage', '所选文件夹已有资料库，为避免覆盖，请选择一个新的文件夹');
-    if (agent.busy || chat.busy) throw new CaptureError('storage', '请等当前消息投递或 Chat 执行结束后再切换信息保存位置');
+    if (agent.busy || chat.busy || chat.confirmWork || videos.busy) throw new CaptureError('storage', '请等当前消息投递或 Chat 执行结束后再切换信息保存位置');
     if (exporting) throw new CaptureError('storage', '正在导出文档，请等导出完成后再切换信息保存位置');
     if (Object.values(sources).some(source => source.loginBusy || source.historyBusy)) throw new CaptureError('storage', '请等登录窗口打开完成后再切换信息保存位置');
     changingWorkspace = true;
@@ -157,6 +167,10 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
           res.writeHead(200, { 'Content-Type': 'image/png', 'Cache-Control': 'public, max-age=86400', 'X-Content-Type-Options': 'nosniff' });
           return res.end(readFileSync(new URL('../assets/xueqiu.png', import.meta.url)));
         }
+        if (path === '/assets/douyin.ico') {
+          res.writeHead(200, { 'Content-Type': 'image/x-icon', 'Cache-Control': 'public, max-age=86400' });
+          return res.end(readFileSync(new URL('../assets/douyin.ico', import.meta.url)));
+        }
         if (path === '/assets/weibo.ico') {
           res.writeHead(200, { 'Content-Type': 'image/x-icon', 'Cache-Control': 'public, max-age=86400', 'X-Content-Type-Options': 'nosniff' });
           return res.end(readFileSync(new URL('../assets/weibo.ico', import.meta.url)));
@@ -168,11 +182,11 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
           update: updates.view(), agent: agent.status(), enabled: store.getSetting('monitorEnabled', true),
           account: store.account(), targets: store.targets().map(target => ({ ...target, historyOriginalOnly: store.getSetting('historyOriginalOnly:' + target.uid, false), policy: store.getSetting('targetPolicy:' + target.uid, null), enabled: store.getSetting('targetEnabled:' + target.uid, true) })), jobs: store.jobs().map(({ checkpoint, ...job }) => ({
             ...job, page: checkpoint.page || 1, pending: checkpoint.pending?.length || 0,
-            reportedTotal: checkpoint.reportedTotal, oldestAt: checkpoint.oldestAt,
+            reportedTotal: checkpoint.reportedTotal, oldestAt: checkpoint.oldestAt, contentIssue: checkpoint.contentIssue || null,
             platform: store.target(job.uid).platform,
           })), notices: store.notices(), unreadNotices: store.unreadNotices(), count: store.count(), todayNewCount: store.todayNewCount(),
           requestGapMs: worker.requestGapMs, loginBusy: sources.weibo.loginBusy, stopped: Object.values(sources).every(source => source.worker.stopping),
-          serviceError,
+          serviceError, douyin: douyinStatus(store, videos),
           unreadContent: store.unreadContent(), archiveSummary: store.archiveSummary(), progress: store.targetProgress(), activeJobId: worker.currentJobId,
           storage: { workspaceDirectory: workspace, workspaceConfigured: existsSync(join(directory, 'workspace.json')), documentsDirectory: documents.directory,
             changing: changingWorkspace, syncing: documents.syncing, mediaSyncing: documents.imageTasks.size > 0, mediaQueued: documents.imageQueue.size, error: documents.error, mediaError: documents.mediaError },
@@ -213,6 +227,27 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
             return res.end(bytes);
           } finally { exporting--; }
         }
+        if (path === '/video') {
+          const row = store.db.prepare('SELECT * FROM video_records WHERE post_id=?').get(url.searchParams.get('id') || '');
+          const type = url.searchParams.get('type') === 'audio' ? 'audio' : 'video';
+          if (!row || row[type + '_status'] !== 'done') return json(res, 404, { error: '该媒体尚未保存在本地' });
+          const file = videos.paths(row)[type];
+          if (!existsSync(file)) return json(res, 404, { error: '本地媒体文件已不存在，可重试下载' });
+          const length = statSync(file).size, range = req.headers.range;
+          let start = 0, end = length - 1;
+          if (range) {
+            const match = /^bytes=(\d+)-(\d*)$/.exec(range);
+            if (!match) { res.writeHead(416, { 'Content-Range': 'bytes */' + length }); return res.end(); }
+            start = Number(match[1]); end = match[2] ? Math.min(Number(match[2]), end) : end;
+            if (!Number.isSafeInteger(start) || start > end || start >= length) { res.writeHead(416, { 'Content-Range': 'bytes */' + length }); return res.end(); }
+          }
+          res.writeHead(range ? 206 : 200, { 'Content-Type': type === 'audio' ? 'audio/wav' : 'video/mp4', 'Content-Length': end - start + 1,
+            'Accept-Ranges': 'bytes', ...(range ? { 'Content-Range': `bytes ${start}-${end}/${length}` } : {}),
+            'Cache-Control': 'private, no-store', 'X-Content-Type-Options': 'nosniff',
+            ...(url.searchParams.has('download') ? { 'Content-Disposition': `attachment; filename="${row.post_id.replace('douyin:', '')}.${type === 'audio' ? 'wav' : 'mp4'}"` } : {}) });
+          const stream = createReadStream(file, { start, end }); exporting++;
+          res.once('close', () => { stream.destroy(); exporting--; }); stream.on('error', () => res.destroy()); stream.pipe(res); return;
+        }
         if (path === '/posts') return json(res, 200, { items: store.posts({
           ids: url.searchParams.get('postId') ? [url.searchParams.get('postId')] : null,
           uid: url.searchParams.get('uid') || '', query: (url.searchParams.get('q') || '').slice(0, 200), kind: url.searchParams.get('kind') || 'all',
@@ -235,9 +270,10 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
               ${uid ? 'WHERE uid=?' : ''} ORDER BY published_at DESC,id DESC`);
             for (const post of statement.iterate(...(uid ? [uid] : []))) {
               const quote = post.quote ? JSON.parse(post.quote) : null;
+              const video = post.id.startsWith('douyin:') ? store.posts({ ids: [post.id], limit: 1 })[0]?.video : null;
               const text = markdown
-                ? `## ${post.author} · ${new Date(post.published_at).toISOString()}\n\n${post.url}\n\n${post.text}\n\n${quote ? '转发原文 · ' + quote.author + '\n\n' + quote.text + '\n\n' : ''}---\n\n`
-                : JSON.stringify({ ...post, quote }) + '\n';
+                ? `## ${post.author} · ${new Date(post.published_at).toISOString()}\n\n${post.url}\n\n${post.text}\n\n${quote ? '转发原文 · ' + quote.author + '\n\n' + quote.text + '\n\n' : ''}${videoMarkdown(video)}---\n\n`
+                : JSON.stringify({ ...post, quote, ...(video ? { video } : {}) }) + '\n';
               if (!res.write(text)) await once(res, 'drain');
             }
             return res.end();
@@ -258,25 +294,25 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
           if (path === '/chat/session/delete') return json(res, 200, await chat.deleteSession(body.id));
           if (path === '/chat/session/restore') return json(res, 200, chat.restoreSession(body.id));
           if (path === '/chat/message') return json(res, 202, chat.start(body.message, body.sessionId || ''));
-          if (path === '/chat/confirm') return json(res, 200, chat.confirm(body.id));
+          if (path === '/chat/confirm') return json(res, 200, await chat.confirm(body.id));
           chat.cancel(body.id); return json(res, 200, { ok: true });
         } catch (error) { return json(res, 400, { error: error.message }); }
       }
       if (path === '/update') {
-        if (chat.busy) return json(res, 409, { error: '请先停止或等候当前 Chat 任务结束后再更新' });
+        if (chat.busy || chat.confirmWork) return json(res, 409, { error: '请先停止或等候当前 Chat 任务结束后再更新' });
         if (exporting || Object.values(sources).some(source => source.loginBusy || source.historyBusy)) return json(res, 409, { error: '请等当前登录、缓存设置或导出完成后再更新' });
         try {
           const update = updates.start(body.version, async apply => {
-            applyingUpdate = true;
+            applyingUpdate = true; videos.suspended = true; videos.controller?.abort();
             Object.values(sources).forEach(source => { source.worker.suspended = true; });
             documents.stopping = true;
             try {
-              await Promise.all([agent.busy, documents.task, documents.queueTask, ...documents.imageTasks.values(), ...Object.values(sources).map(source => source.worker.busy)]);
+              await Promise.all([videos.busy, agent.busy, documents.task, documents.queueTask, ...documents.imageTasks.values(), ...Object.values(sources).map(source => source.worker.busy)]);
               return await apply();
             } finally {
               applyingUpdate = false;
               if (!closing) {
-                documents.stopping = false;
+                documents.stopping = false; videos.suspended = false;
                 Object.values(sources).forEach(source => { source.worker.suspended = false; source.worker.wake(); });
                 documents.drainImages();
               }
@@ -315,6 +351,7 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
         store.setSetting(key, body.enabled);
         Object.values(sources).forEach(source => source.worker.wake());
         if (body.enabled) documents.drainImages();
+        videos.cancelInactive();
         return json(res, 200, { ok: true });
       }
       const platform = body.platform || 'weibo';
@@ -323,7 +360,16 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
       const { browser: platformBrowser, worker: platformWorker } = source;
       const platformName = platformBrowser.name;
       if (source.historyBusy) return json(res, 409, { error: '正在调整缓存范围，请稍候' });
-      if (path === '/targets/policy') {
+      if (path === '/jobs/skip-content') {
+        return json(res, 200, business.skipContent(body.id, body.postId));
+      }
+      if (path === '/douyin/config') {
+        saveDouyinConfig(store, { ...body, platform }, { media: videos, worker: platformWorker });
+      } else if (path === '/video/retry') {
+        if (platform !== 'douyin' || !store.db.prepare('SELECT post_id FROM video_records WHERE post_id=?').get(body.id)) throw new CaptureError('input', '视频不存在');
+        videos.retry(body.id);
+      } else if (path === '/targets/policy') {
+        if (platformModule(platform).intervalScheduling === false) throw new CaptureError('input', platformModule(platform).scheduleHelp);
         business.policy({ ...body, platform });
       } else if (path === '/history/pause') {
         const targets = body.uid ? [store.target(body.uid)] : body.scope === 'platform' ? store.targets().filter(target => target.platform === platform) : [];
@@ -349,30 +395,12 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
           store.notice('task', target.name + (body.kind === 'history' ? '：已开启历史缓存' : body.mode === 'history' ? '：已开启历史缓存与新动态监控' : '：从现在开始记录新动态'), Date.now(), target.uid);
         })();
       } else if (path === '/history/range') {
-        if (body.enableTarget !== undefined && typeof body.enableTarget !== 'boolean') return json(res, 400, { error: '无效的博主开关值' });
         const targets = body.uid ? [store.target(body.uid)] : body.scope === 'platform' ? store.targets().filter(target => target.platform === platform && target.capture_mode !== 'pending') : [];
-        if (!targets.length || targets.some(target => !target || target.platform !== platform)) return json(res, 400, { error: '请先添加并设置要缓存的博主' });
+        if (!targets.length || targets.some(target => !target || target.platform !== platform)) throw new CaptureError('input', '请先添加并设置要缓存的博主');
+        if (body.enableTarget !== undefined && typeof body.enableTarget !== 'boolean') throw new CaptureError('input', '无效的博主开关值');
         if (targets.some(target => target.capture_mode === 'pending')) return json(res, 409, { error: '请先确认从何时开始记录' });
         if (source.loginBusy) return json(res, 409, { error: '请完成当前账号操作后重试' });
-        const range = parseHistoryRange(body.from, body.to);
-        if (body.originalOnly !== undefined && typeof body.originalOnly !== 'boolean') return json(res, 400, { error: '请选择有效的缓存内容类型' });
-        source.historyBusy = true; platformWorker.suspended = true;
-        try {
-          if (platformWorker.busy) await platformWorker.busy;
-          store.transaction(() => {
-            for (const target of targets) {
-              if (body.enableTarget === true && body.uid) enableAuthorJob(target.uid, 'history');
-              const job = store.jobs().find(job => job.uid === target.uid && job.kind === 'history');
-              const originalOnly = body.originalOnly ?? store.getSetting('historyOriginalOnly:' + target.uid, false);
-              const changed = target.history_from !== range.from || target.history_to !== range.to || originalOnly !== store.getSetting('historyOriginalOnly:' + target.uid, false);
-              store.db.prepare('UPDATE targets SET history_from=?,history_to=? WHERE uid=?').run(range.from, range.to, target.uid);
-              store.setSetting('historyOriginalOnly:' + target.uid, originalOnly);
-              store.setSetting('historyRequested:' + target.uid, true);
-              if (changed) store.updateJob(job.id, { checkpoint: {}, pages: 0, saved: 0, last_success_at: null, status: 'queued', next_run_at: 0, message: '按选定日期缓存以前的消息，已有内容保留' });
-              else if (job.status !== 'complete') store.updateJob(job.id, { status: 'queued', message: '等待继续缓存以前的消息' });
-            }
-          })();
-        } finally { source.historyBusy = false; platformWorker.suspended = false; platformWorker.wake(); }
+        await business.scope({ uids: targets.map(target => target.uid), from: body.from || '', to: body.to || '', ...(body.originalOnly === undefined ? {} : { originalOnly: body.originalOnly }), historyEnabled: true });
       } else if (path === '/targets/profile') {
         const target = store.target(body.uid);
         if (!target || target.platform !== platform || !platformBrowser.profile) return json(res, 400, { error: '请选择有效的' + platformName + '博主' });
@@ -434,6 +462,7 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
           store.db.prepare('UPDATE targets SET history_gap_ms=? WHERE platform=?').run(seconds * 1000, platform);
         })();
       } else if (path === '/settings') {
+        if (platformModule(platform).intervalScheduling === false) throw new CaptureError('input', platformModule(platform).scheduleHelp);
         const gap = body.requestGapSeconds === undefined ? platformWorker.requestGapMs / 1000 : Number(body.requestGapSeconds);
         const history = body.historyGapSeconds === undefined ? store.getSetting(platform === 'weibo' ? 'targetDefaults' : `targetDefaults:${platform}`, { historyGapMs: 60000 }).historyGapMs / 1000 : Number(body.historyGapSeconds);
         const interval = Number(body.intervalMinutes);
@@ -464,7 +493,7 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
       }
       const clockChanges = ['/targets/start', '/monitoring', '/verify'].includes(path) || path.startsWith('/jobs/') && path.endsWith('/resume') && store.job(path.split('/')[2])?.kind === 'updates';
       Object.values(sources).forEach(source => { if (clockChanges) source.worker.rescheduleUpdates(); source.worker.wake(); });
-      documents.drainImages();
+      documents.drainImages(); videos.cancelInactive();
       return json(res, 200, { ok: true });
     } catch (error) {
       if (res.headersSent) return res.destroy();
@@ -483,6 +512,7 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
         Object.values(sources).forEach(source => { source.worker.stopping = true; source.worker.running = false; clearTimeout(source.worker.timer); });
         return;
       }
+      videos.start();
       chat.recover();
       agent.start();
       chat.startScheduler();
@@ -490,13 +520,13 @@ export function createRuntime(directory = dataDirectory(), { adapterFactories =
       void documents.drainImages();
   }
   return {
-    get store() { return store; }, get documents() { return documents; }, updates, agent, chat, worker, browser, sources, handle, start,
+    get store() { return store; }, get documents() { return documents; }, updates, agent, chat, videos, worker, browser, sources, handle, start,
     async close() {
       if (closing) return;
       closing = true;
       if (workspaceTask) await workspaceTask.catch(() => {});
       documents.stopping = true;
-      await Promise.all([chat.close(), agent.close(), avatars.close(), ...Object.values(sources).map(source => source.worker.stop())]);
+      await Promise.all([videos.close(), chat.close(), agent.close(), avatars.close(), ...Object.values(sources).map(source => source.worker.stop())]);
       if (documents.task) await documents.task;
       if (documents.queueTask) await documents.queueTask;
       await Promise.allSettled([...documents.imageTasks.values()]);
@@ -517,7 +547,7 @@ export function apply(ctx) {
   ctx.effect(() => {
     let runtime;
     let startupError;
-    try { runtime = createRuntime(undefined, { getIM: () => im, model: hostModel(getService), updates }); runtime.start(); }
+    try { runtime = createRuntime(undefined, { getIM: () => im, model: hostAgentRuntime(getService, hostModel(getService)), updates }); runtime.start(); }
     catch { startupError = '无法打开本地资料库，请检查信息保存位置和文件权限后重新启用插件'; }
     const unregister = ctx.webServer.register({ kind: 'prefix', path: PREFIX,
       handler: (req, res) => startupError ? json(res, 503, { error: startupError }) : runtime.handle(req, res) });

package/lib/plain-text.js

@@ -0,0 +1,10 @@
+import he from 'he';
+
+export function plainText(html = '') {
+  return he.decode(String(html)
+    .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '')
+    .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, '')
+    .replace(/<img\b[^>]*alt=["']([^"']*)["'][^>]*>/gi, '$1')
+    .replace(/<br\s*\/?>|<\/p>|<\/div>/gi, '\n')
+    .replace(/<[^>]+>/g, '')).trim();
+}

package/lib/platforms/douyin/client.js

@@ -0,0 +1,44 @@
+export function createDouyinUI({ React, h, SettingRow, TaskControl, LegacyNodeSettings }) {
+    function DouyinConfigForm({ state, uid = '', act, busy, part = 'all' }) {
+      const base = { times: ['20:00'], repeat: 'daily', platformAI: true, saveVideo: false, saveAudio: false, transcribe: false, maxFileMB: 256, python: 'python3', ffmpeg: 'ffmpeg', modelPath: '', threads: 2, ...(state.douyin?.config || {}) };
+      const [value, setValue] = React.useState(() => ({ ...base, ...(state.douyin?.overrides?.[uid] || {}) }));
+      const [inherit, setInherit] = React.useState(!!uid && !state.douyin?.overrides?.[uid]);
+      const [message, setMessage] = React.useState('');
+      const change = (key, val) => { if (uid && inherit) { setInherit(false); setMessage('已切换为这位博主的独立配置，保存后生效'); } else setMessage(''); setValue(old => ({ ...old, [key]: val })); };
+      const disabled = busy;
+      return h('form', { className: 'st-douyin-config', 'aria-label': uid ? '抖音博主配置' : '抖音平台默认配置', onSubmit: async event => {
+        event.preventDefault();
+        if (await act('/douyin/config', { platform: 'douyin', uid: uid || undefined, inherit, section: part, config: value })) setMessage('抖音配置已保存');
+      } },
+        uid ? h(SettingRow, { label: '跟随平台', description: '修改下方选项会自动切换为独立配置，其他博主不受影响' }, h('input', { type: 'checkbox', role: 'switch', 'aria-label': '跟随抖音平台配置', checked: inherit, disabled: busy, onChange: event => { setInherit(event.target.checked); if (event.target.checked) setValue(base); } })) : h('p', { className: 'st-caption' }, '只更新跟随平台的博主；独立配置保持不变。'),
+        part !== 'media' ? h('section', { 'aria-label': '抖音定时检查' }, h('h3', null, '定时检查'),
+          h(SettingRow, { label: '执行日期' }, h('select', { 'aria-label': '抖音检查日期', value: value.repeat, disabled, onChange: event => change('repeat', event.target.value) }, h('option', { value: 'daily' }, '每天'), h('option', { value: 'weekdays' }, '工作日（周一至周五）'))),
+          value.times.map((time, index) => h(SettingRow, { key: index, label: '检查时间 ' + (index + 1), description: '北京时间' }, h('div', { className: 'st-actions' }, h('input', { type: 'time', 'aria-label': '抖音检查时间 ' + (index + 1), value: time, required: true, disabled, onChange: event => change('times', value.times.map((item, at) => at === index ? event.target.value : item)) }),
+            value.times.length > 1 ? h('button', { type: 'button', disabled, onClick: () => change('times', value.times.filter((item, at) => at !== index)) }, '删除') : null))),
+          h('button', { type: 'button', disabled: disabled || value.times.length >= 8, onClick: () => change('times', [...value.times, '']) }, '+ 添加检查时间'),
+          h('p', { className: 'st-caption' }, '只在指定时间检查；重启后会补查离线更新。下载与转写单独排队，不阻塞检查。')) : null,
+        part !== 'frequency' ? h('section', { 'aria-label': '抖音内容保存' }, h('h3', null, '内容保存'),
+          [['platformAI', '平台 AI 解析', '保存平台返回的摘要与章节，不是作者逐字原话'], ['saveVideo', '保存视频', '把新发现的视频下载到本地'], ['saveAudio', '保存音频', '从视频音轨提取，不把背景音乐当人声'], ['transcribe', '本地转写', '用本地 SenseVoice 生成识别稿；一次处理一个作品']].map(([key, label, description]) => h(SettingRow, { key, label, description }, h('input', { type: 'checkbox', role: 'switch', 'aria-label': label, checked: value[key], disabled, onChange: event => change(key, event.target.checked) }))),
+          h(SettingRow, { label: '单文件上限', description: 'MB，超过上限会停止该文件下载' }, h('input', { type: 'number', 'aria-label': '抖音单文件上限', min: 16, max: 2048, value: value.maxFileMB, disabled, onChange: event => change('maxFileMB', Number(event.target.value)) })),
+          value.saveAudio || value.transcribe ? h(SettingRow, { label: 'ffmpeg', description: '程序名或完整路径；音频和转写需要' }, h('input', { 'aria-label': 'ffmpeg 程序', value: value.ffmpeg, disabled, onChange: event => change('ffmpeg', event.target.value) })) : null,
+          value.transcribe ? h(React.Fragment, null,
+            h(SettingRow, { label: 'Python', description: '需安装 FunASR、PyTorch 依赖' }, h('input', { 'aria-label': '转写 Python', value: value.python, disabled, onChange: event => change('python', event.target.value) })),
+            h(SettingRow, { label: '模型目录', description: '已下载的 SenseVoice 本地目录；不会自动下载模型' }, h('input', { 'aria-label': 'SenseVoice 模型目录', value: value.modelPath, disabled, onChange: event => change('modelPath', event.target.value) })),
+            h(SettingRow, { label: 'CPU 线程', description: '1–4；空闲时不常驻模型' }, h('input', { type: 'number', 'aria-label': '转写 CPU 线程', min: 1, max: 4, value: value.threads, disabled, onChange: event => change('threads', Number(event.target.value)) }))) : null,
+          h('p', { className: 'st-caption' }, '关闭选项会停止后续处理，已有文件保留；音频和转写支持一小时以内的作品。图集保留配图，不生成音轨。')) : null,
+        message ? h('p', { role: 'status', className: 'st-caption' }, message) : null,
+        h('button', { className: 'st-primary', disabled: busy, type: 'submit' }, '保存抖音配置'));
+    }
+    function DouyinNodeSettings(props) {
+      const { context, state, act, busy, close, embedded } = props;
+      const dialog = React.useRef(null), [tab, setTab] = React.useState(context.tab || 'frequency');
+      const target = state.targets.find(item => item.uid === context.uid);
+      React.useEffect(() => { if (!embedded) dialog.current?.showModal(); }, []);
+      return h(embedded ? 'section' : 'dialog', { ref: embedded ? undefined : dialog, className: embedded ? 'st-inline-settings' : 'st-node-dialog', 'aria-label': '抖音详细设置', onCancel: close },
+        !embedded ? h('div', { className: 'st-dialog-head' }, h('h2', null, (target?.name || '抖音平台') + '的详细设置'), h('button', { onClick: close, 'aria-label': '关闭监控设置' }, '×')) : null,
+        h('div', { className: 'st-platform-tabs', role: 'tablist', 'aria-label': '抖音配置分组' }, [['frequency', '定时检查'], ['media', '内容保存'], ['history', '历史缓存']].map(([id, title]) => h('button', { key: id, type: 'button', role: 'tab', 'aria-selected': tab === id, onClick: () => setTab(id) }, title))),
+        props.error ? h('p', { role: 'alert', className: 'st-inline-error' }, props.error) : null,
+        h('div', { hidden: tab === 'history' }, target && tab === 'frequency' ? h(TaskControl, { state, target, kind: 'updates', act, busy, openSettings: props.openSettings }) : null, h(DouyinConfigForm, { state, uid: target?.uid, act, busy, part: tab === 'media' ? 'media' : 'frequency' })), tab === 'history' ? h(LegacyNodeSettings, { ...props, embedded: true, context: { ...context, tab: 'history' } }) : null);
+    }
+  return { DouyinConfigForm, DouyinNodeSettings };
+}

package/lib/platforms/douyin/config.js

@@ -0,0 +1,33 @@
+import { isAbsolute } from 'node:path';
+
+export const defaults = { requestGapMs: 30000, historyGapMs: 120000, intervalMs: 86400000 };
+export const defaultConfig = Object.freeze({ times: ['20:00'], repeat: 'daily', platformAI: true, saveVideo: false,
+  saveAudio: false, transcribe: false, maxFileMB: 256, python: 'python3', ffmpeg: 'ffmpeg', modelPath: '', threads: 2 });
+
+export function validateConfig(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).some(key => !Object.hasOwn(defaultConfig, key))) throw new Error('抖音配置包含无效字段');
+  const config = { ...defaultConfig, ...value };
+  if (!Array.isArray(config.times) || !config.times.length || config.times.length > 8 || config.times.some(time => typeof time !== 'string' || !/^([01]\d|2[0-3]):[0-5]\d$/.test(time)) || !['daily', 'weekdays'].includes(config.repeat)) throw new Error('请选择每天或工作日，并填写1–8个有效检查时间');
+  for (const key of ['platformAI', 'saveVideo', 'saveAudio', 'transcribe']) if (typeof config[key] !== 'boolean') throw new Error('请选择有效的保存选项');
+  if (!Number.isInteger(config.maxFileMB) || config.maxFileMB < 16 || config.maxFileMB > 2048 || !Number.isInteger(config.threads) || config.threads < 1 || config.threads > 4) throw new Error('单文件上限16–2048MB，转写线程1–4个');
+  for (const key of ['python', 'ffmpeg']) if (typeof config[key] !== 'string' || !config[key] || config[key].length > 500 || /[\0\r\n]/.test(config[key]) || !(isAbsolute(config[key]) || /^[\w.-]+$/.test(config[key])) || config[key].startsWith('-')) throw new Error('请填写有效的程序名或完整路径');
+  if (typeof config.modelPath !== 'string' || config.modelPath.length > 1000 || config.modelPath.includes('\0') || config.modelPath && !isAbsolute(config.modelPath)) throw new Error('模型目录需要填写本机完整路径');
+  return { ...config, times: [...new Set(config.times)].sort() };
+}
+
+export function configFor(store, uid = '') {
+  return validateConfig({ ...store.getSetting('douyinConfig', defaultConfig), ...(uid ? store.getSetting('douyinConfig:' + uid, null) || {} : {}) });
+}
+
+export function nextCheckAt(config, after, inclusive = false) {
+  const start = Math.floor((after + 28800000) / 86400000) * 86400000 - 28800000;
+  for (let day = 0; day < 8; day++) {
+    const at = start + day * 86400000, weekday = new Date(at + 28800000).getUTCDay();
+    if (config.repeat === 'weekdays' && [0, 6].includes(weekday)) continue;
+    for (const time of [...config.times].sort()) {
+      const candidate = at + (Number(time.slice(0, 2)) * 60 + Number(time.slice(3))) * 60000;
+      if (inclusive ? candidate >= after : candidate > after) return candidate;
+    }
+  }
+  throw new Error('抖音检查时间无效');
+}

package/lib/platforms/douyin/data.js

@@ -0,0 +1,49 @@
+import { CaptureError } from '../../capture-error.js';
+import { plainText } from '../../plain-text.js';
+import { avatar, images, firstURL } from './media.js';
+export { mediaURL, avatar, images } from './media.js';
+
+export function parseAuthor(input) {
+  const value = String(input || '').trim();
+  if (/^MS4w[\w-]{16,180}$/.test(value)) return value;
+  try {
+    const url = new URL(value);
+    if (['www.douyin.com', 'douyin.com'].includes(url.hostname) && ['http:', 'https:'].includes(url.protocol) && !url.username && !url.password && !url.port) {
+      const match = /^\/user\/(MS4w[\w-]{16,180})\/?$/.exec(url.pathname);
+      if (match) return match[1];
+    }
+  } catch {}
+  throw new Error('请粘贴抖音博主完整主页链接（/user/…），或 sec_uid；抖音号不是内部用户ID');
+}
+
+export function normalizePost(raw, uid) {
+  if (raw?.author?.sec_uid !== uid) return null;
+  if (typeof raw.aweme_id !== 'string' || !/^\d{5,30}$/.test(raw.aweme_id)) throw new CaptureError('schema', '抖音作品ID无效，已停止以防记录错位');
+  const publishedAt = Number(raw.create_time) * 1000;
+  if (!Number.isSafeInteger(publishedAt) || publishedAt <= 0) throw new CaptureError('schema', '抖音发布时间无效');
+  const description = plainText(raw.desc || raw.caption || '') || (raw.images?.length ? '分享图片' : '视频作品');
+  const chapters = (Array.isArray(raw.chapter_list) ? raw.chapter_list : []).slice(0, 200).map(chapter => ({
+    atMs: Number.isSafeInteger(Number(chapter.timestamp)) && Number(chapter.timestamp) >= 0 ? Number(chapter.timestamp) : 0,
+    title: plainText(chapter.desc || '').slice(0, 1000), text: plainText(chapter.detail || '').slice(0, 10000),
+  }));
+  const reviewed = Number(raw.chapter_review_status) === 2;
+  const abstract = plainText(raw.chapter_abstract || '').slice(0, 20000);
+  const video = { durationMs: Math.max(0, Number(raw.video?.duration) || 0),
+    summary: { status: abstract || chapters.length ? reviewed ? 'available' : 'unconfirmed' : 'not_returned', abstract, chapters,
+      reviewStatus: raw.chapter_review_status ?? null, origin: 'platform_ai' },
+    videoURL: firstURL(raw.video?.play_addr) || firstURL(raw.video?.play_addr_h264),
+    imagePost: !!raw.images?.length };
+  return { id: raw.aweme_id, uid, author: plainText(raw.author.nickname || uid), publishedAt, text: description,
+    url: `https://www.douyin.com/${video.imagePost ? 'note' : 'video'}/${raw.aweme_id}`, complete: true, quote: null,
+    avatar: avatar(raw.author), images: images(raw), video,
+    raw: { aweme_id: raw.aweme_id, create_time: raw.create_time, desc: description, author: { sec_uid: uid, nickname: raw.author.nickname }, images: raw.images || [], video } };
+}
+
+export function decodeList(body) {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) throw new CaptureError('verification', '抖音未返回作品数据，请检查独立登录窗口');
+  if (Number(body.status_code) !== 0 || !Array.isArray(body.aweme_list) || ![0, 1, false, true].includes(body.has_more)) throw new CaptureError('verification', '抖音未确认作品列表，可能需要登录或验证；不会当成没有更新');
+  const cursor = String(body.max_cursor ?? '');
+  if (body.has_more && !/^\d+$/.test(cursor)) throw new CaptureError('schema', '抖音分页游标缺失，断点已保留');
+  return { items: body.aweme_list, end: !body.has_more, nextCursor: cursor,
+    endMessage: body.has_more ? '' : '已到抖音当前可见作品末尾，不代表完整历史' };
+}

package/lib/platforms/douyin/index.js

@@ -0,0 +1,163 @@
+import { chromium } from 'playwright';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
+import { CaptureError } from '../../capture-error.js';
+import { parseAuthor, normalizePost, decodeList, avatar } from './data.js';
+import { defaults } from './config.js';
+
+export { parseAuthor, normalizePost, defaults };
+export function parseResponse(text) {
+  return JSON.parse(text, (key, value, context) => {
+    if (['aweme_id', 'uid', 'max_cursor'].includes(key) && typeof value === 'number') {
+      if (context?.source && /^\d+$/.test(context.source)) return context.source;
+      if (!Number.isSafeInteger(value)) throw new CaptureError('schema', '抖音ID无法无损解析');
+      return String(value);
+    }
+    return value;
+  });
+}
+
+export class DouyinBrowser {
+  constructor(directory, beforeRequest, expectedUid = () => null) {
+    this.id = 'douyin'; this.name = '抖音'; this.defaults = defaults;
+    this.directory = directory; this.beforeRequest = beforeRequest; this.expectedUid = expectedUid;
+    this.sessionFile = join(directory, 'douyin-session.json');
+    this.context = null; this.browser = null; this.backgroundContext = null; this.page = null; this.idle = null; this.closed = false;
+    this.sessionData = null; this.activeUid = ''; this.responses = []; this.profileData = null;
+  }
+  parseAuthor(input) { return parseAuthor(input); }
+  normalizePost(raw, uid) { return normalizePost(raw, uid); }
+  isPinned(raw) { return raw.is_top === 1 || raw.is_top === true || raw.is_top === '1'; }
+  needsRequest() { return false; }
+  async complete(raw) { return raw; }
+
+  loadSession() {
+    if (!this.sessionData && existsSync(this.sessionFile)) {
+      try { this.sessionData = JSON.parse(readFileSync(this.sessionFile, 'utf8')); }
+      catch { throw new CaptureError('login', '抖音授权文件不可读，请重新登录'); }
+    }
+    const cookies = this.sessionData?.storageState?.cookies || [];
+    if (!cookies.some(cookie => /(^|\.)douyin\.com$/.test(cookie.domain) && ['sessionid', 'sessionid_ss'].includes(cookie.name) && cookie.value && (cookie.expires <= 0 || cookie.expires > Date.now() / 1000))) throw new CaptureError('login', '抖音本地授权缺失或过期，请主动登录；不会自动弹出窗口');
+    if (this.expectedUid() && this.expectedUid() !== this.sessionData.uid) throw new CaptureError('login', '抖音授权与资料库绑定账号不一致');
+    return this.sessionData;
+  }
+  async login() {
+    await this.release(); this.closed = false;
+    this.context = await chromium.launchPersistentContext(join(this.directory, 'douyin-browser'), { channel: 'chrome', headless: false, viewport: null });
+    this.context.on('close', () => { this.context = null; });
+    const page = this.context.pages()[0] || await this.context.newPage();
+    await page.goto('https://www.douyin.com/', { waitUntil: 'domcontentloaded', timeout: 45000 });
+  }
+  async checkLogin() {
+    if (this.context) {
+      const storageState = await this.context.storageState();
+      const identity = storageState.cookies.find(cookie => /(^|\.)douyin\.com$/.test(cookie.domain) && cookie.name === 'uid_tt');
+      if (!identity?.value) throw new CaptureError('login', '尚未确认抖音登录，请在授权窗口完成登录后再继续');
+      const uid = createHash('sha256').update(identity.value).digest('hex');
+      if (this.expectedUid() && this.expectedUid() !== uid) throw new CaptureError('login', '抖音账号与资料库绑定账号不同');
+      const previous = this.sessionData;
+      this.sessionData = { uid, storageState };
+      try { this.loadSession(); } catch (error) { this.sessionData = previous; throw error; }
+      mkdirSync(this.directory, { recursive: true, mode: 0o700 });
+      writeFileSync(this.sessionFile + '.tmp', JSON.stringify(this.sessionData), { mode: 0o600 });
+      renameSync(this.sessionFile + '.tmp', this.sessionFile);
+      await this.context.close(); this.context = null;
+    }
+    // Only local session validity is checked here. Actual access is confirmed by the next list response.
+    return this.loadSession().uid;
+  }
+  async release() {
+    clearTimeout(this.idle); this.idle = null;
+    const browser = this.browser; this.browser = null; this.backgroundContext = null; this.page = null; this.activeUid = ''; this.responses = [];
+    if (browser) await browser.close();
+  }
+  armIdle() {
+    clearTimeout(this.idle);
+    this.idle = setTimeout(() => { void this.release().catch(() => {}); }, 180000); this.idle.unref();
+  }
+  async finishScan() { this.armIdle(); }
+  async openAuthor(uid) {
+    clearTimeout(this.idle);
+    const session = this.loadSession();
+    if (!this.browser) {
+      this.browser = await chromium.launch({ headless: true });
+      this.backgroundContext = await this.browser.newContext({ storageState: session.storageState, viewport: { width: 1100, height: 800 } });
+    }
+    if (this.page) await this.page.close();
+    this.page = await this.backgroundContext.newPage(); this.activeUid = uid; this.profileData = null; this.responses = [];
+    const owner = this.page;
+    this.page.on('response', async response => {
+      try {
+        const url = new URL(response.url());
+        if (!['www.douyin.com', 'www-hj.douyin.com', 'douyin.com'].includes(url.hostname)) return;
+        if (url.pathname.includes('/aweme/post/') && url.searchParams.get('sec_user_id') === uid) {
+          const status = response.status();
+          const entry = { cursor: url.searchParams.get('max_cursor') || '0' };
+          if ([401, 403, 429].includes(status)) entry.error = new CaptureError(status === 429 ? 'limited' : 'verification', '抖音限制了访问，请在独立授权窗口检查');
+          else if (status !== 200) entry.error = new CaptureError('network', '抖音作品请求未成功');
+          else { try { entry.data = parseResponse(await response.text()); } catch { entry.error = new CaptureError('schema', '抖音未返回可解析的作品数据'); } }
+          if (this.activeUid === uid && this.page === owner) this.responses.push(entry);
+        } else if (url.pathname.includes('/user/profile/other/') && url.searchParams.get('sec_user_id') === uid) {
+          const body = parseResponse(await response.text());
+          if (body.user?.sec_uid === uid && this.page === owner) this.profileData = body.user;
+        }
+      } catch { /* Ignore unrelated resource responses. */ }
+    });
+    await this.page.goto('https://www.douyin.com/user/' + uid, { waitUntil: 'domcontentloaded', timeout: 45000 });
+  }
+  async pageResult(uid, cursor, options) {
+    this.closed = false;
+    await this.beforeRequest(options);
+    const requested = String(cursor ?? '0');
+    try {
+      if (!this.page || this.activeUid !== uid || requested === '0') await this.openAuthor(uid);
+      const deadline = Date.now() + 30000;
+      let scrollAt = 0, progressed = false;
+      while (Date.now() < deadline && !this.closed) {
+        const index = this.responses.findIndex(item => item.cursor === requested);
+        if (index >= 0) {
+          const [entry] = this.responses.splice(index, 1);
+          if (entry.error) throw entry.error;
+          const result = decodeList(entry.data);
+          if (!result.items.length && !result.end) throw new CaptureError('schema', '抖音返回不明空页，保留断点，不当成没有更新');
+          if (!result.end && String(result.nextCursor) === requested) throw new CaptureError('schema', '抖音分页未前进，已停止并保留断点');
+          const refreshed = await this.backgroundContext.storageState?.();
+          if (refreshed) {
+            this.sessionData = { ...this.sessionData, storageState: refreshed };
+            writeFileSync(this.sessionFile + '.tmp', JSON.stringify(this.sessionData), { mode: 0o600 });
+            renameSync(this.sessionFile + '.tmp', this.sessionFile);
+          }
+          this.armIdle(); return result;
+        }
+        if (requested !== '0' && this.responses.length) {
+          for (const entry of this.responses.splice(0)) {
+            if (entry.error) throw entry.error;
+            if (decodeList(entry.data).end) throw new CaptureError('schema', '历史分页位置已失效，请重新选择历史范围');
+            progressed = true;
+          }
+        }
+        if (requested !== '0' && Date.now() >= scrollAt) {
+          await this.page.evaluate(() => { window.scrollTo(0, document.body.scrollHeight); window.dispatchEvent(new Event('scroll')); });
+          await this.page.mouse.wheel(0, 2000); scrollAt = Date.now() + defaults.requestGapMs;
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+      }
+      if (progressed && requested !== '0') { this.armIdle(); throw new CaptureError('wait', '正在恢复抖音历史分页位置，已保留作品断点', defaults.requestGapMs); }
+      throw new CaptureError('network', '抖音作品列表加载超时，已保留进度，将自动重试，无需重新登录');
+    } catch (error) {
+      if (error.kind !== 'wait') await this.release();
+      if (error.kind) throw error;
+      throw new CaptureError('network', '抖音读取中断，进度已保留');
+    }
+  }
+  async profile(uid, options) {
+    const result = await this.pageResult(uid, '0', options);
+    const user = this.profileData || result.items.find(item => item.author?.sec_uid === uid)?.author;
+    if (!user?.nickname) throw new CaptureError('schema', '抖音未返回可确认的博主昵称，请稍后重试');
+    const total = Number(user.aweme_count);
+    return { name: user.nickname, avatar: avatar(user), total: Number.isSafeInteger(total) && total >= 0 ? total : null };
+  }
+  timeline(uid, page, cursor, options) { return this.pageResult(uid, page === 1 ? '0' : cursor, options); }
+  async close() { this.closed = true; if (this.context) await this.context.close(); this.context = null; await this.release(); }
+}