Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion PRIVACY.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
MoonDigest 的隐私政策。适用于 Chrome 应用商店版和 GitHub 发布的 zip 包。

- 设置、分拣结果、备注和对话都存在浏览器本地。API Key 也存在本地,不会出现在任何导出文件里。
- 插件只连这些地方:B站和 YouTube、你配置的 AI 平台、你本机的 Obsidian。允许读取网页以后,侧边栏开着时会在本机读它跟随的每个网页的正文;只有你提问或点 AI 总结时,正文才发给你选的 AI 平台。没有作者的服务器,没有统计。
- 插件只连这些地方:B站和 YouTube、你配置的 AI 平台、你本机的 Obsidian。允许读取网页以后,侧边栏开着时会在本机读它跟随的每个网页的正文;只有你提问或点 AI 总结时,正文才发给你选的 AI 平台。分拣台的收藏夹打开「联网核实」时,字幕细看由 DeepSeek 的服务器去搜索网页,插件自己不访问别的网站。没有作者的服务器,没有统计。
- B站 和 YouTube 视频页上的网页脚本(包括你用的 AI agent)可以向插件要这个视频的信息、字幕、章节和热门评论,这些都是网站本来就给这个页面的数据。
- 设置 → MCP 的「允许 Agent 使用我的 B站和 YouTube 账号」默认关闭。打开后,插件会连本机 `127.0.0.1:47823` 上的 MCP 服务(`mcp/`),你在本机运行的 AI 工具就能通过它用你的登录读和改下面这些。见 README 的「给 AI agent 用」。
- 能读:B站 和 YouTube 的视频搜索结果;视频的信息、字幕、章节、热门评论和画面;你 B站 的收藏夹和里面的视频、稍后再看、关注和分组、观看历史,连同分拣台的标签、备注、AI 判断和判断标准;你 YouTube 的稍后观看、赞过的视频、订阅、历史记录和 YouTube 播放列表。
Expand Down
3 changes: 2 additions & 1 deletion docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ B站 页面上的颜色是 `tokens.css` 的第三份拷贝:`content.css` 里
- 内置播放框下的标签行只有一种写法:`TriageUi.viewerLine`,行名用第 3/4 行的 `labeledRow`。收藏夹的「视频标签」行在 `fav-tags.js`,「UP 标签」行在 `follow.js`,收藏夹每次画完自己那行就通过 `MoonTriage.setViewerHook` 让关注重画 UP 那行;B站 自动连播换了视频时(`fav-page.js` 的 `showViewing`),关注也在这个 hook 里把 `F.viewing` / `F.viewingMid` 换成新视频。
- 后台(`background.js` 的 service worker)也加载 `tag-core.js` 和 `shared.js`,日期、时长、标签名清洗和关注分组名的上限与检查(`GROUP_NAME_MAX`、`groupNameError`)直接用 `TriageUi`,不在 `triage-bg.js`、`follow-bg.js` 里另写。弹窗也加载 `shared.js`,时长用 `TriageUi.fmtDuration`。笔记、弹窗和视频页共用的去句尾标点只在 `sites.js`(`trimReason`)。视频上下文的字段(标题、地址、站点和视频 id、分 P、选中的字幕)怎么整理也只在这里:`MdgSites.contextRef`,后台写笔记、读上下文和侧边栏存对话、画占位上下文都用它;它的网址(去掉专注模式和跟踪参数、带分 P)只由 `MdgSites.videoUrl` 拼,笔记、后台和视频页都用它。标签名最长几个字只有 `MdgTagCore.TAG_NAME_MAX`,各个标签名输入框都读它。B站 页面的标记开关默认值读 `MdgSettings.DEFAULTS`。加载顺序以 `background.js` 的 `importScripts` 为准,后台的 selftest 照它读;侧边栏、摘读记录页和视频页的 selftest 同样照 `sidepanel.html`、`history/history.html` 和 manifest 里 `content.js` 那一项读,不手写脚本清单。
- 「✦ AI 打标签」的后台只有一份:`triage-bg.js` 的 `triageAiCommand`(指令检查、新建上限按 `numSetting("newTagMax")` 取值、解析)。关注只把 UP 主整理成条目,带上自己的 unit 调它。摘读记录页自己把记录整理成条目(`history.js` 的 `aiItem`:标题、视频还是网页、现有标签和对话的问答,按 `TriageUi.READING_AI_CHARS` 截;没有对话的带分拣台的 AI 总结和备注),发 `triage-reading-ai-tag`,后台带 `READING_AI_UNIT` 调它;条目按 `id`(`MdgNote.readingKey`)认,没有 `id` 的按 `bvid`(`triageItemId`)。摘读记录的批次也走 `runs.js`(`history.html` 加载它,页面自己一个实例,没有胶囊,倒计时写在弹窗和状态文字里),用同一个 `MdgRuns.aiJudge`:限流倒计时重发、超时重发一次、设置类错误停下给「去设置」或「授权」。它的设置存在 sync 的 `KEYS.readingAiSettings`,读法和关注的 `follow_ai_settings` 同一个(`FollowCore.followAiSettings`:第一次用时照搬 `triage-settings-get` 的收藏夹值并存下,之后只读自己的),所以 `history.html` 也加载 `follow-core.js`;建议和「AI 刚打的」存在 local 的 `readingAiProposal` / `readingAiRecent`,U 的步骤只在页面内存里(`tag-store.js` 自己的栈,最多 `TRIAGE_UNDO_STEPS` 步)。设置行的样式(`.set-row` 等)在 `tags.css`,三个设置弹窗共用。
- 选哪个 AI 平台只有一处记:侧边栏顶部的选择存在扩展页面的 `localStorage`(`MdgLimits.KEYS.aiSelectedProvider`)。分拣台的每个请求由 `fav-base.js` 的 `sendRaw` 带上它(`aiProviderId`),后台的 `triageChat`(`triageProvider`)用它,没选或已停用就用第一个启用的平台,和侧边栏一样。收藏夹设置的「开启思考」显示不显示也跟着它:每次打开收藏夹设置都重新问一次 `triage-settings-get`,侧边栏换了平台不用重开分拣台。
- AI 平台在选项里怎么写只有一处:`MdgSettings.aiProviderLabel`(备注名 `note`,没有就「平台 · 模型」),侧边栏的下拉框和分拣台都用它。平台配置的字段由后台 `normalizeAiProvider` 整理,设置页 `collectAiProviders` 收,`note` 和别的字段一样随设置文件导出导入。
- 选哪个 AI 平台只有一处记:侧边栏顶部的选择存在扩展页面的 `localStorage`(`MdgLimits.KEYS.aiSelectedProvider`)。分拣台的每个请求由 `fav-base.js` 的 `sendRaw` 带上它(`aiProviderId`),后台的 `triageChat`(`triageProvider`)用它,没选或已停用就用第一个启用的平台,和侧边栏一样。打开具体收藏夹时,存过判断标准弹窗的收藏夹用自己的记录:`fav-base.js` 的 `K.folderAi`(`triage_folder_ai`,local,`{ [mediaId]: { providerId, thinking, search } }`,和 `folderCriteria` 一样经 `storeEdit` 读改写),`aiReq` 把 `aiProviderId` 和 `thinking` 放进粗看、细看、AI 打标签的请求,`sendRaw` 不再拿侧边栏的覆盖它。「所有收藏夹」是这两份记录里的一个 id(`ALL`):在它里面 `aiReq` 和 `searchWanted` 一律取它自己的记录(`aiFolder`),不取视频所在收藏夹的;判断标准取它自己的,空着才取视频所在收藏夹的(`critOf`),粗看、细看的请求和 `staleCoarse` / `staleFine` 都走这一处。后台 `triageAiSettings` 只在平台能开关思考时用页面给的 `thinking`,没带时用旧的全局 `triageThinking`(它的开关已去掉,只剩这个回落用途)。平台能做什么只由后台 `background.js` 的 `aiCaps`(`{ thinking, search }`)判断:`triage-settings-get` 回 `aiPlatforms`(启用的平台和各自的 `caps`),页面照着画、按同样的回落规则选中(`folderAiOf`),设置里的平台列表变了就重问一次。联网核实只在细看:`triage-analyze` 带 `search`,后台 `triageChat` 只在 `aiCaps(provider).search` 时加 `tools: [{ type: "deepseek_web_search" }]` 和提示词里那一句(`TRIAGE_SEARCH_PROMPT`),超时用思考那一档;结果记 `search: true`,页面的 `staleFine` 据此把收藏夹开着联网时没联网做的细看算作旧结果。`finish_reason` 为 `content_filter` 时报「AI 平台的内容审核拦下了这次回复」。
- 分拣台的长任务只有一个循环:`extension/triage/runs.js`(`MdgRuns.create`),每种模式一个实例(`fav-base.js` 和 `follow.js` 的 `runs`)。粗看、细看、AI 打标签(两种模式和摘读记录,`MdgTagStore` 的 `runAi`)、逐个视频笔记、「已出分拣范围」的核对、两边改 B站 的批量写和关注「视频投稿」的限流等待都是它的 `run` 或 `wait`:一个任务名同一时间只跑一个(第二个被拒并报出在跑的名字)、请求之间留间隔、限流时倒计时再重发同一个请求、暂停 / 停止 / 切换收藏夹在间隔和倒计时里立即生效、做完的个数由它数。每个回答怎么算由任务的 `judge` 定:AI 的超时和限流怎么数只有 `MdgRuns.aiJudge`(每次跑各数各的),粗看、细看、AI 打标签和摘读记录的 AI 打标签共用;等不等按这次运行实例的 `hold`(分拣台是 `THROTTLES`,细看遇到 B站 限流也等)。例外:「所有收藏夹」的加载(`runLoadAll`)两条队列会轮换、暂停后能接着跑,留着自己的循环,只用 `runs.wait` 等限流。
- 进度胶囊只从它画:`runs.pill(顺序)` 取第一个在跑、在等或有行的任务,都没有再取跑完留下的绿色结果行;等限流时一律在进度后面接「· B站限流卡住,m:ss 后重试」。别处来的状态(关注的后台刷新和它的「B站限流变慢」、观看进度、刷新中、标签建议待确认、「所有收藏夹」的加载)用 `runs.put` 放一行进去。收藏夹的顺序是 `fav-base.js` 的 `PILL`,按钮是 `PILL_BTN`;关注的在 `follow.js` 的 `renderSync` 旁边。第 3 行的「暂停粗看 N/M」也读 `runs.get`。
- 限流等多久只有 `hold`:收藏夹是 `fav-base.js` 的 `THROTTLES`(`MoonTriage.hold`),关注的 B站限流是 90 秒的 `TriageUi.BILI_HOLD_MS`。后台的队列暂停(`follow_jobs.hold`、`follow_hold`)和观看进度的 30 分钟来自后台存储,不走它。`runs.selftest.js` 在 node 里用假时钟测它。
Expand Down
Loading
Loading