dsh-douyin-browser-local 1.3.1 → 1.4.3

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# 更新记录
+
+## 1.4.3（2026-10-23）
+
+- 自检增加专用浏览器连接、登录提示、真实窗口最小化、媒体静音、调度和互动状态。
+- 报告包含错误码、处理步骤、报告编号、有效期和允许的修复动作，不包含私人内容。
+- 新增 DSH 诊断及修复工具，设置页和软件提供相同修复按钮及可复制报告。
+- 仅修复已开启静默但未生效的问题；执行前后重新检查，不改许可、记忆、Key、预算，不启动服务或发送。
+
+使用说明见 docs/features-1.4.3.md。此公开版本也包含下面1.3.2至1.4.2的本机候选更新；这些中间版本未单独公开发布。
+
+## 1.4.2（本地更新，2026-10-23，尚未发布 npm）
+
+- 修复静默设置无法应用到已打开专用浏览器、仅有私信页或准备页时不能最小化的问题。
+- 手动视频操作也应用静默最小化，界面显示实际应用结果及阻止原因。
+- 打开准备入口复用唯一初始空白页，避免遗留不受管空标签。
+- 软件左栏将“对话与视频”移到“业务设置”上方。
+
+使用方式与验证边界见 docs/features-1.4.2.md。
+
+## 1.4.1（本地更新，2026-10-23，尚未发布 npm）
+
+- 软件与插件新增每个允许时段自动开始一轮，共享调度许可和一次性时段回执。
+- 好友互动显示各服务是否运行，以及私信联系人暂停情况。
+- 软件新增GitHub正式版本检查、下载校验与更新重启入口。
+- 修复软件包和左上角图标，移除左栏与设置分类重复的导航。
+
+使用条件、更新包要求和复用记录见 docs/features-1.4.1.md。
+
+## 1.4.0（本地更新，2026-10-23，尚未发布 npm）
+
+- 插件和软件新增一键自检、共用用量看板及主题观看设置。
+- 单轮时长可选择不限，有限值上限扩大到1,000,000分钟；自主请求和手动任务预算上限同步扩大。
+- 新增DeepSeek谷时段、全天和晚间快捷选择，支持周末全天。
+- 保留旧设置及共享记忆，保存较长规则不会延长旧轮次。
+
+使用方式、计数范围和停止行为见 docs/features-1.4.0.md。
+
+## 1.3.2（候选版，2026-10-23，尚未发布 npm）
+
+- 修复部分 DSH 桌面版进入设置后提示“没有可用的同源设置服务”、全部操作不可用的问题。
+- 支持常用桌面协议、本机 HTTPS 和宿主 RPC，后台同时适配 Connection 的设置路由，保留旧 WebServer 入口。
+- 连接失败后仍可刷新，恢复成功后清除旧错误。
+- 继续校验同源、宿主认证及写入令牌；写操作失败不自动重放。
+
+软件版同步到 1.3.2：打包共享领域模块，补齐静默观看、公开评论许可及观看日报界面；断连后可手动刷新，连接恢复会清除旧连接错误。软件仍独立使用用户 API Key，沿用与插件共用的人格、记忆和许可设置。软件包的检查范围见 desktop/VERIFICATION.md。
+
+升级后请完全退出并重开 DSH。不要删除人格、记忆、登录目录或重填 API Key。各第三方宿主的兼容程度以实测为准；记录见 docs/verification/settings-compatibility-20261023.md。

package/README.md

@@ -1,126 +1,132 @@
-# DSH 抖音助手
-
-让 DSH 里的 DeepSeek（大肥鱼）自己刷抖音：搜索、换片、看真实画面，把有意思的内容记下来，并在你许可的范围内分享给好友。
-
-在专用 Edge 里浏览电脑网页版抖音，每隔几秒采样视频画面交给模型。所有外发功能默认关闭，每一项都有独立开关、次数上限和时间限制。这是第三方适配，不是 DeepSeek 官方出品。
-
-## 能做什么
-
-| 功能 | 说明 | 默认 |
-| --- | --- | --- |
-| 自主观看 | 按人格和兴趣自己搜索、换片、继续看或停止，并给出理由 | 需手动开始有限轮次 |
-| 兴趣与人格 | 兴趣来自实际观看进度和已确认行为，不是看到主题就算喜欢 | 随观看自动积累 |
-| 时间限制 | 每日允许时段（北京时间）加单轮时长，到点视频真的暂停 | 单轮 10 分钟 |
-| 静默观看 | 静音，核对窗口归属后尝试最小化（仍是有窗口的 Edge，不是 headless） | 关闭 |
-| 观看日报 | 把当天实际看过的标题、作者、链接汇总成 Markdown，不调用模型 | 可手动生成，每轮观看结束后也会尝试生成 |
-| 主动分享 | 通过官方分享界面把当前看过的作品发给许可好友，每天默认 3 次 | 关闭 |
-| 自动问候 | 每位许可好友每天最多一次，合计默认 2 次，带「自动问候」标记 | 关闭 |
-| 私信自动回复 | 只处理你确认的最多两位好友，只回复启动之后的新消息 | 关闭 |
-| 公开评论 | 每天默认 3 条，每轮 1 条，同一作品只评论一次 | 关闭 |
-| 音频理解 | 本地 Whisper 转写对白，可选 MiMo 或 MiniMax 云端 | 关闭 |
-
-发送结果不确定时一律暂停，不会自动重发。
-
-## 两种用法
-
-| | 插件版 | 软件版 |
-| --- | --- | --- |
-| 在哪用 | DSH 的「设置 → 刷抖音」，全部用按钮操作 | 独立的 Windows 桌面软件，对话式下任务 |
-| 模型 | 用 DSH 里已配置的提供商 | 用你自己填的 DeepSeek API Key |
-| 版本 | 1.3 | 已打包的是 1.2.0，1.3 尚未打包 |
-
-两者共用同一份人格、兴趣和记忆，但同一时刻只会运行一个自主观看。
-
-## 快速开始（插件版）
-
-### npm 安装（1.3.1 发布后可用）
-
-在 DSH Desktop 自带终端中运行：
-
-```powershell
-dsh plugin --profile desktop add dsh-douyin-browser-local@1.3.1
-```
-
-需要 Windows、已安装 Microsoft Edge 和 DSH 0.2.0-rc.2。安装后按宿主提示重新加载，在设置中打开“刷抖音”；抖音登录和验证由使用者自行完成。市场收录与 npm 包发布分别同步，不能把发布成功当成市场已刷新。
-
-### 从源码安装
-
-
-需要 Windows、Microsoft Edge、Node.js 22.13 以上，以及 DSH 0.2.0-rc.2 系列（已在 DSH Desktop 2.0.17 上核对过设置页）。
-
-```powershell
-git clone https://github.com/LockyBee/dsh-douyin-agent.git
-cd dsh-douyin-agent
-pnpm install --frozen-lockfile
-$dshInstallDirectory = 'C:\Apps\DSH Desktop' # 替换为正在使用的 DSH 安装目录
-.\install-native.ps1 -DshRoot $dshInstallDirectory
-```
-
-第一条命令安装依赖；不带 `-Install` 的脚本只做检查，不改配置也不开窗口。确认无误后完全退出 DSH，再执行：
-
-```powershell
-.\install-native.ps1 -DshRoot $dshInstallDirectory -Install
-```
-
-重新打开 DSH，在「设置」里找到「刷抖音」，按这个顺序用：
-
-1. 基础设置：选提供商和模型（模型必须支持图片），保存。
-2. 视频观看：点「打开抖音」，在专用 Edge 里自己登录或过验证。
-3. 设置允许时段和单轮时长，点「开始有限轮次」，再点「开始自主观看」。
-
-安装细节和本机现有入口的说明见 [插件说明](docs/plugin.md)。
-
-## 当前验证状态
-
-| 状态 | 内容 |
-| --- | --- |
-| 真实环境验证过 | 推荐播放、搜索、上下切换、暂停、画面采样、限时到点暂停；旧版 DSH 原生工具调用；表情图片采样；一次人工授权的好友转发；DSH 2.0.17 中设置页挂载并读回状态 |
-| 只有合成测试 | 自主分享、行为偏好、自动问候、自主评论、静默、日报 |
-| 还没验证 | 抖音最小化后的持续播放、真实评论区、收到新私信后的完整自动回复、MiMo 与 MiniMax 云端、标准 bundle 安装 |
-
-合成测试用的是替身模型和临时页面，不能当作真实抖音上能用的证据。最新测试数字和已知失败见 [v10 验证记录](docs/verification/native-v10.md)。
-
-## 目录
-
-| 位置 | 内容 |
-| --- | --- |
-| `dsh-plugin.mjs`、`client.js`、`cordis.bundle.yml` | 原生插件入口、设置页前端、标准 bundle 声明 |
-| `tool-definitions.mjs` | 32 项工具目录，插件和软件共用 |
-| `native-*.mjs` | 设置页后端、模型路由、人格注入、问候与观看决策 |
-| `core.mjs`、`browser-*.mjs` | 专用 Edge 的控制、采样、限时 |
-| `video-limits.mjs`、`task-limits.mjs`、`watch-mode.mjs` | 时段与轮次、任务预算、静默 |
-| `autonomous-*.mjs`、`spark-*.mjs`、`daily-report.mjs` | 自主观看、分享、评论、问候、日报 |
-| `chat-*.mjs`、`message-tracker.mjs`、`outbound-send.mjs` | 私信自动回复和统一的发送账本 |
-| `memory.mjs`、`persona-memory.mjs`、`qq-sync.mjs` | 共享记忆、人格卡、QQ 侧同步 |
-| `app.mjs`、`api-agent.mjs`、`public/`、`start-api.*` | 旧的本机 HTTP 控制台（`http://127.0.0.1:3218`） |
-| `desktop/` | Electron 桌面软件的源码、打包脚本和上游许可证 |
-| `media/` | 可选音频模块，内置三份社区项目源码 |
-| `tests/`、`verification/` | 单元测试，以及实机验收脚本 |
-| `skill/SKILL.md` | 给模型看的使用说明 |
-
-## 文档
-
-| 文档 | 内容 |
-| --- | --- |
-| [插件说明](docs/plugin.md) | 插件安装、设置页逐项说明、预算、各项外发的规则 |
-| [独立软件说明](docs/standalone-api.md) | 独立 API 控制台和软件版的配置 |
-| [详细说明](docs/details.md) | 原 README 全文，按时间累积，内容多 |
-| [功能复用与来源](docs/reuse.md) | 参考和复用的开源项目，以及边界 |
-| [docs/verification/](docs/verification) | 各版本的测试记录 |
-| [desktop/README.md](desktop/README.md) | 桌面软件的构建和使用 |
-| [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) | 第三方许可证 |
-
-## 开发
-
-```powershell
-pnpm test
-pnpm run test:native
-```
-
-`pnpm test` 会起临时 Edge 页面，不碰真实抖音和你的账号。运行状态、浏览器资料、密钥、数据库、私信正文和联系人信息都只保存在本机，不进入仓库。
-
-## 许可证
-
-本项目原创代码采用 [MIT](LICENSE)。第三方源码和依赖的原许可证、版权及通知见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
-
-公开准备、分发包检查与社区市场申请见 [发布记录](docs/publication.md)。
+# DSH 抖音助手
+
+1.4.3 增强自检与按报告修复，并汇总设置通信兼容、静默最小化、时段自动启动、用量看板和主题观看等更新。查看[功能说明](docs/features-1.4.3.md)或[下载 1.4.3 软件与插件包](https://github.com/LockyBee/dsh-douyin-agent/releases/tag/v1.4.3)。
+
+让 DSH 里的 DeepSeek（大肥鱼）自己刷抖音：搜索、换片、看真实画面，把有意思的内容记下来，并在你许可的范围内分享给好友。
+
+在专用 Edge 里浏览电脑网页版抖音，每隔几秒采样视频画面交给模型。所有外发功能默认关闭，每一项都有独立开关、次数上限和时间限制。这是第三方适配，不是 DeepSeek 官方出品。
+
+## 能做什么
+
+| 功能 | 说明 | 默认 |
+| --- | --- | --- |
+| 自主观看 | 按人格和兴趣自己搜索、换片、继续看或停止，并给出理由；可配置每个允许时段自动开始一轮 | 自动启动关闭 |
+| 兴趣与人格 | 兴趣来自实际观看进度和已确认行为，不是看到主题就算喜欢 | 随观看自动积累 |
+| 时间限制 | 每日允许时段（北京时间）加单轮时长，到点视频真的暂停 | 单轮 10 分钟 |
+| 静默观看 | 静音，核对窗口归属后尝试最小化（仍是有窗口的 Edge，不是 headless） | 关闭 |
+| 观看日报 | 把当天实际看过的标题、作者、链接汇总成 Markdown，不调用模型 | 可手动生成，每轮观看结束后也会尝试生成 |
+| 主动分享 | 通过官方分享界面把当前看过的作品发给许可好友，每天默认 3 次 | 关闭 |
+| 自动问候 | 每位许可好友每天最多一次，合计默认 2 次，带「自动问候」标记 | 关闭 |
+| 私信自动回复 | 只处理你确认的最多两位好友，只回复启动之后的新消息 | 关闭 |
+| 公开评论 | 每天默认 3 条，每轮 1 条，同一作品只评论一次 | 关闭 |
+| 音频理解 | 本地 Whisper 转写对白，可选 MiMo 或 MiniMax 云端 | 关闭 |
+
+发送结果不确定时一律暂停，不会自动重发。
+
+## 两种用法
+
+| | 插件版 | 软件版 |
+| --- | --- | --- |
+| 在哪用 | DSH 的「设置 → 刷抖音」，全部用按钮操作 | 独立的 Windows 桌面软件，对话式下任务 |
+| 模型 | 用 DSH 里已配置的提供商 | 用你自己填的 DeepSeek API Key |
+| 版本 | 1.4.3 | 1.4.3 Windows 便携包，见 [软件说明](desktop/README.md) |
+
+两者共用同一份人格、兴趣和记忆，但同一时刻只会运行一个自主观看。
+
+## 快速开始（插件版）
+
+1.4.3 包含“没有可用的同源设置服务”兼容修复，适配常用桌面载体、Connection 设置路由和刷新恢复。更新后请完全退出并重开 DSH，无需删除记忆、登录目录或重填 Key。各第三方宿主仍以实际自检结果为准，见[验证记录](docs/verification/settings-compatibility-20261023.md)。
+
+### npm 安装或更新（1.4.3）
+
+DSH Desktop：打开“应用 → 桌面插件”，在 npm 包输入框填写 `dsh-douyin-browser-local@1.4.3`，点击安装或更新。Desktop profile 由 Electron 管理，不能用普通 CLI 修改。完成后完全退出并重开 DSH。
+
+Web 版在终端运行：
+
+```powershell
+dsh plugin --profile web add dsh-douyin-browser-local@1.4.3
+```
+
+需要 Windows、Microsoft Edge 和 DSH 0.2.0-rc.2 至 0.2.x 兼容宿主。抖音登录和验证由使用者自行完成。npm、GitHub Release 和社区市场分别同步；市场未更新时可使用固定版本号安装。
+
+### 从源码安装
+
+
+需要 Windows、Microsoft Edge、Node.js 22.13 以上，以及 DSH 0.2.0-rc.2 系列（已在 DSH Desktop 2.0.17 上核对过设置页）。
+
+```powershell
+git clone https://github.com/LockyBee/dsh-douyin-agent.git
+cd dsh-douyin-agent
+pnpm install --frozen-lockfile
+$dshInstallDirectory = 'C:\Apps\DSH Desktop' # 替换为正在使用的 DSH 安装目录
+.\install-native.ps1 -DshRoot $dshInstallDirectory
+```
+
+第一条命令安装依赖；不带 `-Install` 的脚本只做检查，不改配置也不开窗口。确认无误后完全退出 DSH，再执行：
+
+```powershell
+.\install-native.ps1 -DshRoot $dshInstallDirectory -Install
+```
+
+重新打开 DSH，在「设置」里找到「刷抖音」，按这个顺序用：
+
+1. 基础设置：选提供商和模型（模型必须支持图片），保存。
+2. 视频观看：点「打开抖音」，在专用 Edge 里自己登录或过验证。
+3. 设置允许时段和单轮时长，点「开始有限轮次」，再点「开始自主观看」。
+
+安装细节和本机现有入口的说明见 [插件说明](docs/plugin.md)。
+
+## 当前验证状态
+
+| 状态 | 内容 |
+| --- | --- |
+| 真实环境验证过 | 推荐播放、搜索、上下切换、暂停、画面采样、限时到点暂停；旧版 DSH 原生工具调用；表情图片采样；一次人工授权的好友转发；DSH 2.0.17 中设置页挂载并读回状态 |
+| 通过专项或合成测试 | 自主分享、行为偏好、自动问候、自主评论、静默修复及日报；不代表全部真实外发已验证 |
+| 还没验证 | 抖音最小化后的持续播放、真实评论区、收到新私信后的完整自动回复、MiMo 与 MiniMax 云端、标准 bundle 安装 |
+
+合成测试用的是替身模型和临时页面，不能当作真实抖音上能用的证据。1.4.3 的专项检查、实机自检、软件包验收及完整回归首轮失败记录见[本版验证记录](docs/verification/local-1.4.3-20261023.md)；[v10 记录](docs/verification/native-v10.md)仅对应旧版本。
+
+## 目录
+
+| 位置 | 内容 |
+| --- | --- |
+| `dsh-plugin.mjs`、`client.js`、`cordis.bundle.yml` | 原生插件入口、设置页前端、标准 bundle 声明 |
+| `tool-definitions.mjs` | 34 项工具目录，插件和软件共用 |
+| `native-*.mjs` | 设置页后端、模型路由、人格注入、问候与观看决策 |
+| `core.mjs`、`browser-*.mjs` | 专用 Edge 的控制、采样、限时 |
+| `video-limits.mjs`、`task-limits.mjs`、`watch-mode.mjs` | 时段与轮次、任务预算、静默 |
+| `autonomous-*.mjs`、`spark-*.mjs`、`daily-report.mjs` | 自主观看、分享、评论、问候、日报 |
+| `chat-*.mjs`、`message-tracker.mjs`、`outbound-send.mjs` | 私信自动回复和统一的发送账本 |
+| `memory.mjs`、`persona-memory.mjs`、`qq-sync.mjs` | 共享记忆、人格卡、QQ 侧同步 |
+| `app.mjs`、`api-agent.mjs`、`public/`、`start-api.*` | 旧的本机 HTTP 控制台（`http://127.0.0.1:3218`） |
+| `desktop/` | Electron 桌面软件的源码、打包脚本和上游许可证 |
+| `media/` | 可选音频模块，内置三份社区项目源码 |
+| `tests/`、`verification/` | 单元测试，以及实机验收脚本 |
+| `skill/SKILL.md` | 给模型看的使用说明 |
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [插件说明](docs/plugin.md) | 插件安装、设置页逐项说明、预算、各项外发的规则 |
+| [独立软件说明](docs/standalone-api.md) | 独立 API 控制台和软件版的配置 |
+| [详细说明](docs/details.md) | 原 README 全文，按时间累积，内容多 |
+| [功能复用与来源](docs/reuse.md) | 参考和复用的开源项目，以及边界 |
+| [docs/verification/](docs/verification) | 各版本的测试记录 |
+| [desktop/README.md](desktop/README.md) | 桌面软件的构建和使用 |
+| [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) | 第三方许可证 |
+
+## 开发
+
+```powershell
+pnpm test
+pnpm run test:native
+```
+
+`pnpm test` 会起临时 Edge 页面，不碰真实抖音和你的账号。运行状态、浏览器资料、密钥、数据库、私信正文和联系人信息都只保存在本机，不进入仓库。
+
+## 许可证
+
+本项目原创代码采用 [MIT](LICENSE)。第三方源码和依赖的原许可证、版权及通知见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+
+公开准备、分发包检查与社区市场申请见 [发布记录](docs/publication.md)。

package/api-agent.mjs

@@ -1,12 +1,13 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { normalizeUsage } from './usage-ledger.mjs';
 import { parseEnv } from 'node:util';
 import { TOOL_DEFINITIONS, validateToolArguments } from './tool-definitions.mjs?v=9';
 
 export const DEFAULT_QQ_ROOT = 'D:/codex分局/聊天机器人';
 export const DEFAULT_MODEL = 'deepseek-flash';
 export const DEFAULT_LIMITS = Object.freeze({ maxSteps: 20, maxToolCalls: 20, apiTimeoutMs: 60_000, taskTimeoutMs: 180_000, maxTokens: 2_048, maxFrames: 4, maxFrameBytes: 2_000_000 });
-export const HARD_LIMITS = Object.freeze({ ...DEFAULT_LIMITS, maxSteps: 1000, maxToolCalls: 1000, taskTimeoutMs: 86_400_000 });
+export const HARD_LIMITS = Object.freeze({ ...DEFAULT_LIMITS, maxSteps: 10000, maxToolCalls: 10000, taskTimeoutMs: 604_800_000 });
 
 export function normalizeApiConfig(value = {}) {
   if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).some(key => !['apiKey', 'baseUrl', 'model', 'keySource'].includes(key))) throw new Error('API 设置只接受密钥、接口地址和模型。');
@@ -154,46 +155,50 @@ export function parseWatchDecision(value, { shareContext, commentContext } = {})
   return { action: value.action, reason: value.reason.trim(), topics: value.topics.map(item => ({ topic: item.topic.trim(), signal: item.signal })), reflection: value.reflection.trim(), ...(value.query !== undefined ? { query: value.query.trim() } : {}), ...(value.seconds !== undefined ? { seconds: value.seconds } : {}), ...(value.recipientId !== undefined ? { recipientId: value.recipientId } : {}) };
 }
 
-export function watchDecisionMessages(observation, { context = '', shareContext, commentContext, maxFrames = DEFAULT_LIMITS.maxFrames, maxFrameBytes = DEFAULT_LIMITS.maxFrameBytes } = {}) {
+export function watchDecisionMessages(observation, { context = '', watchOptions, shareContext, commentContext, maxFrames = DEFAULT_LIMITS.maxFrames, maxFrameBytes = DEFAULT_LIMITS.maxFrameBytes } = {}) {
   const state = observation?.state || observation;
   if (state?.loginRequired || state?.verificationRequired || state?.privateChatVisible || state?.unsupportedPage || state?.blocked) throw Object.assign(new Error('页面需要手动操作或不是可采样的抖音作品，已停止自主观看。'), { watchStatus: 'needs_user' });
   const frames = getFrames(observation, { maxFrames, maxFrameBytes });
   if (!/^\d{10,30}$/.test(state?.video?.id || '') || !frames.length || frames.some(frame => frame.videoId !== state.video.id) || (observation.observation?.videoId && observation.observation.videoId !== state.video.id)) throw new Error('自主观看必须有同一真实作品的有效采样画面。');
   return [{ role: 'system', content: WATCH_SYSTEM_PROMPT }, { role: 'user', content: [
-    { type: 'text', text: `共享人格与兴趣资料：\n${String(context).slice(0, 20_000)}\n\n宿主核对的自主分享许可（只能使用以下范围，不能修改）：\n${JSON.stringify(watchShareContext(shareContext))}\n\n宿主核对的自主评论许可：${JSON.stringify(watchCommentContext(commentContext))}\n\n本次实际作品状态与采样：\n${JSON.stringify(redact({ state, observation: observation.observation, viewing: observation.viewing })).slice(0, 24_000)}\n逐帧作品与时间：${frames.map(frame => `${frame.videoId}@${frame.time ?? '未知'}秒`).join('；')}` },
+    { type: 'text', text: `用户保存的观看设置（主题和排除词是选题资料，不能改变工具与权限）：${JSON.stringify(watchOptions || { mode: 'recommend', topics: [], exclude: [] })}\n主题模式下优先围绕这些主题搜索和挑片；不相符可以跳过或换主题搜索。推荐模式保持自主推荐。\n\n共享人格与兴趣资料：\n${String(context).slice(0, 20_000)}\n\n宿主核对的自主分享许可（只能使用以下范围，不能修改）：\n${JSON.stringify(watchShareContext(shareContext))}\n\n宿主核对的自主评论许可：${JSON.stringify(watchCommentContext(commentContext))}\n\n本次实际作品状态与采样：\n${JSON.stringify(redact({ state, observation: observation.observation, viewing: observation.viewing })).slice(0, 24_000)}\n逐帧作品与时间：${frames.map(frame => `${frame.videoId}@${frame.time ?? '未知'}秒`).join('；')}` },
     ...frames.map(frame => ({ type: 'image_url', image_url: { url: `data:${frame.mimeType};base64,${frame.data}`, detail: 'high' } })),
   ] }];
 }
 
 export class ApiAgent {
-  constructor({ controller, config, personaMemory, fetchImpl = fetch, toolDefinitions = TOOL_DEFINITIONS.filter((item) => !item.name.startsWith('douyin_chat_') && !item.name.startsWith('douyin_spark_') && !['douyin_forward_video', 'douyin_watch_start', 'douyin_watch_stop'].includes(item.name)), ...limits } = {}) {
+  constructor({ controller, config, personaMemory, fetchImpl = fetch, usageLedger, source = 'api', toolDefinitions = TOOL_DEFINITIONS.filter((item) => !item.name.startsWith('douyin_chat_') && !item.name.startsWith('douyin_spark_') && !['douyin_forward_video', 'douyin_watch_start', 'douyin_watch_stop'].includes(item.name)), ...limits } = {}) {
     if (!controller?.execute || !config) throw new Error('缺少浏览器控制器或 API 配置。');
     const actualLimits = { ...DEFAULT_LIMITS, ...limits };
     for (const [name, value] of Object.entries(actualLimits)) {
       if (!(name in HARD_LIMITS) || !Number.isSafeInteger(value) || value < 1 || value > HARD_LIMITS[name]) throw new Error(`预算参数 ${name} 必须是 1 至 ${HARD_LIMITS[name] ?? '硬上限'} 的整数。`);
     }
-    Object.assign(this, { controller, config, personaMemory, fetchImpl, toolDefinitions, ...actualLimits });
+    Object.assign(this, { controller, config, personaMemory, fetchImpl, toolDefinitions, usageLedger, source, ...actualLimits });
   }
 
-  async decideWatch({ observation, context = this.personaMemory?.context() || '', shareContext, commentContext, signal, decisionProvider } = {}) {
-    const messages = watchDecisionMessages(observation, { context: redact(context, [this.config.apiKey]), shareContext, commentContext, maxFrames: this.maxFrames, maxFrameBytes: this.maxFrameBytes });
+  async decideWatch({ observation, context = this.personaMemory?.context() || '', watchOptions, shareContext, commentContext, signal, decisionProvider } = {}) {
+    const messages = watchDecisionMessages(observation, { context: redact(context, [this.config.apiKey]), watchOptions, shareContext, commentContext, maxFrames: this.maxFrames, maxFrameBytes: this.maxFrameBytes });
     if (!decisionProvider && !this.config.apiKey) throw new Error('自主观看需要先配置 API Key。');
     const timeout = new AbortController(); const timer = setTimeout(() => timeout.abort(new Error('自主观看单次模型请求超时。')), this.apiTimeoutMs);
     const actualSignal = signal ? AbortSignal.any([signal, timeout.signal]) : timeout.signal;
+    let usageRecorded = false;
+    const recordUsage = usage => { this.usageLedger?.record({ source: this.source, kind: 'watch', model: this.config.model, usage }); usageRecorded = true; };
     try {
       let text, usage;
       if (decisionProvider) ({ text, usage } = await decisionProvider({ system: WATCH_SYSTEM_PROMPT, messages, signal: actualSignal }));
       else {
         const response = await this.fetchImpl(`${this.config.baseUrl}/chat/completions`, { method: 'POST', redirect: 'error', signal: actualSignal, headers: { authorization: `Bearer ${this.config.apiKey}`, 'content-type': 'application/json' }, body: JSON.stringify({ model: this.config.model, messages, thinking: { type: 'disabled' }, stream: false, max_tokens: this.maxTokens }) });
         if (!response.ok) throw new Error(`自主观看模型请求失败（HTTP ${response.status}）。`);
-        const data = await response.json(); const choice = data?.choices?.[0];
+        const data = await response.json(); recordUsage(data.usage); const choice = data?.choices?.[0];
         if (!choice?.message || choice.message.tool_calls?.length || !['stop', undefined, null].includes(choice.finish_reason)) throw new Error('自主观看模型响应未完成或包含未授权工具。');
         text = contentText(choice.message.content); usage = data.usage;
       }
+      if (!usageRecorded) recordUsage(usage);
       actualSignal.throwIfAborted();
-      const normalizedUsage = Object.fromEntries([['promptTokens', 'prompt_tokens'], ['completionTokens', 'completion_tokens'], ['totalTokens', 'total_tokens']].map(([camel, snake]) => [camel, Number.isSafeInteger(usage?.[snake] ?? usage?.[camel]) && (usage[snake] ?? usage[camel]) >= 0 ? usage[snake] ?? usage[camel] : 0]));
+      const normalizedUsage = Object.fromEntries([['promptTokens', 'prompt_tokens'], ['completionTokens', 'completion_tokens'], ['totalTokens', 'total_tokens']].map(([camel, snake]) => [camel, normalizeUsage(usage)[camel]]));
       return { decision: redact(parseWatchDecision(text, { shareContext, commentContext }), [this.config.apiKey]), usage: normalizedUsage };
-    } finally { clearTimeout(timer); }
+    } catch (error) { if (!usageRecorded && error.usage) recordUsage(error.usage); throw error; }
+    finally { clearTimeout(timer); }
   }
 
   async runTask({ instruction, signal, onEvent = () => {} } = {}) {
@@ -230,6 +235,7 @@ export class ApiAgent {
             throw new Error(`DeepSeek 请求失败（HTTP ${response.status}）${detail ? `：${redact(String(detail), [this.config.apiKey]).slice(0, 400)}` : ''}`);
           }
           const data = await response.json();
+          this.usageLedger?.record({ source: this.source, kind: 'task', model: this.config.model, usage: data.usage });
           taskSignal.throwIfAborted();
           usage.requests++;
           for (const [field, key] of [['promptTokens', 'prompt_tokens'], ['completionTokens', 'completion_tokens'], ['totalTokens', 'total_tokens']]) {

package/assets/PROVENANCE.json

@@ -0,0 +1,8 @@
+{
+  "icon": {
+    "source": "用户指定的大肥鱼启动器桌面快捷方式引用的bot-shortcut-icon.ico",
+    "sha256": "28e0a5fa638185ae3e96e2a5cbcf321b768d8267d8acedd34c567716a87335bb",
+    "reuse": "ICO原文件直接随包复制；界面PNG从ICO最大帧无损提取。",
+    "requestedAt": "2026-10-23"
+  }
+}

package/autonomous-watch.mjs

@@ -9,7 +9,10 @@ import { AutonomousComments } from './autonomous-comments.mjs?v=9';
 import { PublicCommentAgent } from './public-comment-agent.mjs?v=9';
 import { DailyReport } from './daily-report.mjs?v=9';
 
-export const WATCH_LIMITS = Object.freeze({ maxRequests: 30, hardMaxRequests: 100, dailyLimit: 200, sampleSeconds: 3 });
+import { WatchOptions } from './watch-options.mjs';
+import { UsageLedger } from './usage-ledger.mjs';
+
+export const WATCH_LIMITS = Object.freeze({ maxRequests: 30, hardMaxRequests: 10000, dailyLimit: 20000, sampleSeconds: 3 });
 const alive = pid => { if (!Number.isSafeInteger(pid) || pid < 1) return false; try { process.kill(pid, 0); return true; } catch (error) { return error.code === 'EPERM'; } };
 const read = (file, fallback) => { try { return JSON.parse(fs.readFileSync(file, 'utf8')); } catch (error) { if (error.code === 'ENOENT') return fallback; throw new Error('自主观看状态文件损坏，未重置预算或运行锁。'); } };
 const write = (file, value) => { const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`; try { fs.writeFileSync(temporary, JSON.stringify(value, null, 2), { mode: 0o600, flag: 'wx' }); fs.renameSync(temporary, file); } finally { if (fs.existsSync(temporary)) fs.unlinkSync(temporary); } };
@@ -21,9 +24,13 @@ export class AutonomousWatch {
   constructor({ controller, config = {}, videoLimits, personaMemory, agent, shareService, commentService, commentAgent, reportService, decisionProvider, stateDir = resolveRuntimePaths().stateDir, source = 'api', fetchImpl = fetch, now = Date.now, delayImpl = (ms, signal) => delay(ms, undefined, { signal }), onEvent = () => {} } = {}) {
     if (!controller?.execute || !videoLimits?.state || !personaMemory?.context || !['api', 'dsh'].includes(source)) throw new Error('自主观看缺少浏览器、时限或共同人格接口。');
     Object.assign(this, { controller, config, videoLimits, personaMemory, shareService, decisionProvider, stateDir, source, now, delayImpl, onEvent });
+    this.optionsService = new WatchOptions({ stateDir });
+    this.usageLedger = new UsageLedger({ stateDir, now });
     this.agent = agent || new ApiAgent({ controller, config, personaMemory, fetchImpl });
     Object.assign(this, { commentService, reportService });
+    this.agent.usageLedger = this.usageLedger; this.agent.source = source;
     this.commentAgent = commentAgent || new PublicCommentAgent({ config, fetchImpl });
+    this.commentAgent.usageLedger = this.usageLedger; this.commentAgent.source = source;
     fs.mkdirSync(stateDir, { recursive: true });
     this.files = Object.fromEntries(['lock', 'guard', 'budget', 'state', 'stop'].map(name => [name, path.join(stateDir, `watch-${name === 'lock' ? 'loop.lock' : name === 'guard' ? 'control.guard' : name === 'stop' ? 'stop.request.json' : name + '.json'}`)]));
     this.files.manual = path.join(stateDir, 'watch-manual.lock');
@@ -51,7 +58,7 @@ export class AutonomousWatch {
     const sessionId = worker?.sessionId || time.session?.id || saved.sessionId || null;
     const budget = this.budget(), counts = budget.sessions[sessionId] || { requests: 0, maxRequests: WATCH_LIMITS.maxRequests };
     const request = read(this.files.stop, null), stopping = worker?.alive && request?.runId === worker.runId;
-    return redact({ protocol: 'autonomous-watch-v1', running: Boolean(worker?.alive), owned: Boolean(worker?.owned), worker, status: stopping ? 'stopping' : worker?.alive ? 'running' : ['running', 'stopping'].includes(saved.status) ? 'stopped' : saved.status || 'stopped', sessionId, counts: { ...counts, dailyRequests: budget.days[day(this.now())] || 0, dailyLimit: WATCH_LIMITS.dailyLimit }, lastDecision: saved.lastDecision || null, lastError: saved.lastError || '', remainingSeconds: time.allowed && time.session?.id === sessionId ? time.remainingSeconds : 0 }, [this.config.apiKey]);
+    return redact({ protocol: 'autonomous-watch-v1', running: Boolean(worker?.alive), owned: Boolean(worker?.owned), worker, status: stopping ? 'stopping' : worker?.alive ? 'running' : ['running', 'stopping'].includes(saved.status) ? 'stopped' : saved.status || 'stopped', sessionId, counts: { ...counts, dailyRequests: budget.days[day(this.now())] || 0, dailyLimit: WATCH_LIMITS.dailyLimit }, options: this.optionsService.state().policy, lastDecision: saved.lastDecision || null, lastError: saved.lastError || '', remainingSeconds: time.allowed && time.session?.id === sessionId ? time.remainingSeconds : 0 }, [this.config.apiKey]);
   }
   save(value) { write(this.files.state, redact({ ...read(this.files.state, {}), ...value, source: this.source, sessionId: this.sessionId, updatedAt: new Date(this.now()).toISOString() }, [this.config.apiKey])); }
   assertAllowed() {
@@ -86,9 +93,10 @@ export class AutonomousWatch {
   }
   start({ startSession = false, maxRequests = WATCH_LIMITS.maxRequests } = {}, { explicit = false } = {}) {
     if (!explicit) throw Object.assign(new Error('自主观看只能由用户明确启动。'), { status: 403 });
-    if (typeof startSession !== 'boolean' || !Number.isSafeInteger(maxRequests) || maxRequests < 1 || maxRequests > WATCH_LIMITS.hardMaxRequests) throw Object.assign(new Error('自主观看请求上限须为1至100的整数。'), { status: 400 });
+    if (typeof startSession !== 'boolean' || !Number.isSafeInteger(maxRequests) || maxRequests < 1 || maxRequests > WATCH_LIMITS.hardMaxRequests) throw Object.assign(new Error('自主观看请求上限须为1至10000的整数。'), { status: 400 });
     if (!this.decisionProvider && !this.config.apiKey) throw Object.assign(new Error('请先配置 API Key，再启动自主观看。'), { status: 400 });
     if (this.running || this.completion) throw Object.assign(new Error('当前自主观看正在执行或结束。'), { status: 409 });
+    this.optionsService.state();
     read(this.files.state, {});
     this.control(() => {
       const worker = this.worker(); if (worker) throw Object.assign(new Error(worker.alive ? '另一个入口已有自主观看运行。' : '上次自主观看留下运行锁，请先点击停止清理残留。'), { status: 409 });
@@ -116,8 +124,7 @@ export class AutonomousWatch {
         this.control(() => { const worker = this.worker(); if (!worker?.owned) throw failure('自主观看锁已改变。'); write(this.files.lock, { ...worker, heartbeatAt: this.now() }); });
       } catch (error) { if (error.code !== 'WATCH_CONTROL_BUSY') this.abort.abort(error); }
     }, 500); this.heartbeat.unref?.();
-    const remaining = this.videoLimits.state().session.expiresAt - this.now();
-    this.deadline = setTimeout(() => this.abort.abort(failure('本轮刷视频时间已用完。', 'limited')), Math.max(1, Math.min(remaining, 2_147_483_647))); this.deadline.unref?.();
+    // 心跳持续核对最新时段和截止时间，支持不限时长及超过定时器范围的长轮次。
     this.completion = Promise.resolve().then(() => this.run()).catch(error => { this.onEvent({ type: 'watch.failed', message: redact(error.message || String(error), [this.config.apiKey]) }); return { running: false, status: 'failed' }; }).finally(() => { this.completion = null; });
     return this.state();
     } catch (error) {
@@ -157,6 +164,13 @@ export class AutonomousWatch {
     try {
       let current = await this.execute('douyin_status');
       if (!(current.state || current).video?.id) current = await this.execute('douyin_open');
+      const options = this.optionsService.state().policy;
+      if (options.mode === 'topic') {
+        current = await this.execute('douyin_search', { query: options.topics[0] });
+        const first = (current.state || current).searchResults?.find(item => Number.isSafeInteger(item.index) && /^\d{10,30}$/.test(item.id));
+        if (!first) throw failure('主题搜索没有可核实的作品结果，请更换主题后重试。', 'needs_user');
+        current = await this.execute('douyin_open_video', { index: first.index });
+      }
       while (true) {
         this.assertAllowed();
         const budget = this.budget();
@@ -166,6 +180,8 @@ export class AutonomousWatch {
         let observation = await this.execute('douyin_observe', { seconds: WATCH_LIMITS.sampleSeconds });
         const observedAt = this.now(), observedState = observation.state || observation;
         watchDecisionMessages(observation);
+        const title = String(observedState.video?.title || '');
+        if (options.exclude.some(word => title.toLocaleLowerCase().includes(word.toLocaleLowerCase()))) { current = await this.execute('douyin_next'); continue; }
         const evidenceId = observation.personaEvidenceId || observation.state?.personaEvidenceId || this.personaMemory.recordObservation(observation, { source: this.source, kind: 'visual' }).evidenceId;
         let viewing = observation.viewing;
         if (viewing) {
@@ -174,7 +190,7 @@ export class AutonomousWatch {
         observation = { ...observation, ...(viewing ? { viewing } : {}) };
         const context = this.personaMemory.context(), shareContext = this.shareContext(), commentContext = this.commentContext();
         this.reserveRequest();
-        const result = await this.agent.decideWatch({ observation, context, shareContext, commentContext, signal: this.abort.signal, decisionProvider: this.decisionProvider });
+        const result = await this.agent.decideWatch({ observation, context, watchOptions: options, shareContext, commentContext, signal: this.abort.signal, decisionProvider: this.decisionProvider });
         this.assertAllowed();
         const decision = redact(parseWatchDecision(result.decision, { shareContext: this.shareContext(), commentContext: this.commentContext() }), [this.config.apiKey]);
         current = await this.execute('douyin_status');

package/browser-launcher.mjs

@@ -82,6 +82,14 @@ export class BrowserLauncher {
     if (!context) throw new Error('专用 Edge 没有可用资料窗口，请在专用窗口完成系统提示后重试。');
     let page = await this.findPage(browser, PREPARE_PAGE_NAME, signal), reused = Boolean(page);
     worker = this.getWatchState(); if (worker) return this.showWatch(browser, worker, signal);
+    if (!page) {
+      const blank = [];
+      for (const candidate of context.pages()) {
+        if (candidate.isClosed() || candidate.url() !== 'about:blank') continue;
+        if (await abortable(candidate.evaluate(() => !window.name && !document.body?.textContent?.trim() && document.querySelectorAll('body *').length === 0).catch(() => false), signal)) blank.push(candidate);
+      }
+      if (blank.length === 1) { page = blank[0]; reused = true; }
+    }
     if (!page) page = await abortable(context.newPage(), signal, value => value.close().catch(() => {}));
     worker = this.getWatchState();
     if (worker) { if (!reused) await page.close().catch(() => {}); return this.showWatch(browser, worker, signal); }

package/chat-agent.mjs

@@ -49,10 +49,11 @@ export class ChatAgent {
         });
         if (!response.ok) throw new Error(`私信模型请求失败（HTTP ${response.status}）。`);
         const data = await response.json(), choice = data?.choices?.[0];
-        if (choice?.message?.tool_calls?.length || choice?.finish_reason !== 'stop') throw new Error('私信模型响应未完整结束，未发送。');
+        if (choice?.message?.tool_calls?.length || choice?.finish_reason !== 'stop') { this.usageLedger?.record({ source: this.source || 'api', kind: 'chat', model: this.config.model, usage: data.usage }); throw new Error('私信模型响应未完整结束，未发送。'); }
         return { text: choice?.message?.content, usage: data.usage };
       });
       const result = await Promise.race([generated, cancelled]);
+      this.usageLedger?.record({ source: this.source || 'api', kind: 'chat', model: this.config.model, usage: result?.usage });
       combined.throwIfAborted();
       if (result?.tool_calls?.length || result?.toolCalls?.length) throw new Error('私信回复提供器返回了工具调用，未发送。');
       const text = typeof result?.text === 'string' ? result.text.trim() : '';