From 206d8847023df1f3018dd721456c60e216cd1dad Mon Sep 17 00:00:00 2001 From: PathGao <42336971+PathGao@users.noreply.github.com> Date: Sun, 15 Nov 2026 03:08:07 +0800 Subject: [PATCH 1/7] =?UTF-8?q?AI=20=E5=B9=B3=E5=8F=B0=E5=8A=A0=E5=A4=87?= =?UTF-8?q?=E6=B3=A8=E5=90=8D=EF=BC=9B=E4=BE=A7=E8=BE=B9=E6=A0=8F=E7=9A=84?= =?UTF-8?q?=E5=B9=B3=E5=8F=B0=E9=80=89=E9=A1=B9=E5=86=99=E5=A4=87=E6=B3=A8?= =?UTF-8?q?=E5=90=8D=EF=BC=8C=E4=B8=8D=E5=A1=AB=E6=97=B6=E5=86=99=E3=80=8C?= =?UTF-8?q?=E5=B9=B3=E5=8F=B0=20=C2=B7=20=E6=A8=A1=E5=9E=8B=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ARCHITECTURE.md | 1 + docs/DESIGN.md | 1 + extension/background.js | 1 + extension/background.selftest.js | 8 ++++++-- extension/options.css | 6 +++++- extension/options.html | 3 ++- extension/options.js | 3 +++ extension/options.selftest.js | 2 ++ extension/settings.js | 3 +++ extension/settings.selftest.js | 6 ++++++ extension/sidepanel.js | 5 ++--- extension/sidepanel.selftest.js | 7 +++++++ 12 files changed, 39 insertions(+), 7 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index f5378425..3e20f97a 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -23,6 +23,7 @@ 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 平台在选项里怎么写只有一处:`MdgSettings.aiProviderLabel`(备注名 `note`,没有就「平台 · 模型」),侧边栏的下拉框和分拣台都用它。平台配置的字段由后台 `normalizeAiProvider` 整理,设置页 `collectAiProviders` 收,`note` 和别的字段一样随设置文件导出导入。 - 选哪个 AI 平台只有一处记:侧边栏顶部的选择存在扩展页面的 `localStorage`(`MdgLimits.KEYS.aiSelectedProvider`)。分拣台的每个请求由 `fav-base.js` 的 `sendRaw` 带上它(`aiProviderId`),后台的 `triageChat`(`triageProvider`)用它,没选或已停用就用第一个启用的平台,和侧边栏一样。收藏夹设置的「开启思考」显示不显示也跟着它:每次打开收藏夹设置都重新问一次 `triage-settings-get`,侧边栏换了平台不用重开分拣台。 - 分拣台的长任务只有一个循环:`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`。 diff --git a/docs/DESIGN.md b/docs/DESIGN.md index 73e7e066..98e7cce6 100644 --- a/docs/DESIGN.md +++ b/docs/DESIGN.md @@ -68,6 +68,7 @@ | 存储用量里各收藏夹视频列表那一行 | 收藏夹快照 | 收藏夹列表缓存 | 2026-10-23:存的是每个收藏夹的视频快照,不是收藏夹列表 | | 设置页「B站页面上显示什么」里管没单列的页面那一行 | 首页、搜索和其他页面(热门、分区、番剧等都归它) | 首页、搜索(单写) | 2026-10-23:单写让人以为别的页面不受这一行管 | | 关注设置、摘读记录设置里隔开 AI 打标签每批的秒数 | AI 打标签每批间隔(收藏夹设置里同一个数还隔开 B站 请求,叫「请求间隔」) | 请求间隔(关注、摘读记录) | 2026-10-23:关注的刷新不按它隔开 | +| AI 平台配置上自己起的名字 | 备注名(设置页「AI 平台」每行一格,可选;侧边栏和分拣台的平台选项写它,不填时写「平台 · 模型」,模型空着时只写平台) | 别名、昵称 | 同一个平台配两个 Key 时分得开 | | 侧边栏和摘读记录写成单独一篇 AI 笔记时结果后面的说明 | (单独的 AI 笔记) | (视频已失效,只写了对话) | 视频失效时也是同一种文件,里面还有 AI 总结和备注 | 下面的时间格式管的是分拣台。 diff --git a/extension/background.js b/extension/background.js index 059a40fe..5a856a6a 100644 --- a/extension/background.js +++ b/extension/background.js @@ -935,6 +935,7 @@ function normalizeAiProvider(item) { id, presetId: String(item.presetId || "custom"), name: String(item.name || "").trim() || MdgErrors.LABEL.customAi, + note: String(item.note || "").trim(), baseUrl: MdgSettings.trimBaseUrl(item.baseUrl), model: String(item.model || "").trim(), temperature: typeof item.temperature === "number" ? item.temperature : 0.7, diff --git a/extension/background.selftest.js b/extension/background.selftest.js index beea086c..ebedaa82 100644 --- a/extension/background.selftest.js +++ b/extension/background.selftest.js @@ -175,6 +175,7 @@ process.on("exit", (code) => { const src = ["background.js", "triage/triage-bg.js"].map((f) => fs.readFileSync(path.join(__dirname, f), "utf8")).join("\n"); assert.strictEqual(src.match(/await hostPermissionError\(/g).length, 1, "hostPermissionError is asked only in aiFetchError"); assert.strictEqual(ctx.normalizeAiProvider({ id: "x", baseUrl: " https://ai.test/v1// " }).baseUrl, "https://ai.test/v1", "a saved platform's address is trimmed"); + assert.deepStrictEqual([ctx.normalizeAiProvider({ id: "x", note: " 自己的 " }).note, ctx.normalizeAiProvider({ id: "x" }).note], ["自己的", ""], "a saved platform keeps its 备注名"); const timeout = async () => { throw Object.assign(new Error("timeout"), { name: "TimeoutError" }); }; @@ -1064,11 +1065,11 @@ process.on("exit", (code) => { assert.deepStrictEqual(syncLeft, { triageCriteria: "全局" }); // Settings file: everything in sync (收藏夹 and 关注 included), never a key, even one an older version left in sync. - const exportSync = { noteFolder: "X", triageFineBatchSize: 20, follow_ai_settings: { batchSize: 7 }, aiProviders: [{ id: "p", apiKey: "sk-old" }], obsidianApiKey: "leak" }; + const exportSync = { noteFolder: "X", triageFineBatchSize: 20, follow_ai_settings: { batchSize: 7 }, aiProviders: [{ id: "p", note: "自己的", apiKey: "sk-old" }], obsidianApiKey: "leak" }; ctx.chrome = { runtime: { getManifest: () => ({ version: "9" }) }, storage: { sync: area(exportSync), local: area({ obsidianApiKey: "k", aiProviderKeys: { p: "sk" }, triage_included_folders: ["11", "toview"], triage_folder_criteria: { 11: "只留菜谱" }, triage_sort: { 11: "pub" }, triage_tags: [] }) } }; const file = JSON.parse(JSON.stringify(await ctx.exportSettings())); assert.deepStrictEqual([file.kind, file.extensionVersion, file.settings.triageFineBatchSize, file.settings.follow_ai_settings], ["settings", "9", 20, { batchSize: 7 }]); - assert.deepStrictEqual(file.settings.aiProviders, [{ id: "p" }]); + assert.deepStrictEqual(file.settings.aiProviders, [{ id: "p", note: "自己的" }], "a platform's 备注名 goes with it"); assert.ok(!/sk|leak|"k"/.test(JSON.stringify(file)), "no keys in the file"); assert.deepStrictEqual(file.local, { triage_included_folders: ["11", "toview"], triage_folder_criteria: { 11: "只留菜谱" } }, "the 分拣台's folder choice and 判断标准; no sort, no data"); @@ -1080,6 +1081,9 @@ process.on("exit", (code) => { const old = { ...file, settings: { ...file.settings, aiInitialQuickPrompts: ["旧"], obsidianApiKey: "x", aiProviders: [{ id: "p", apiKey: "sk-file" }] } }; await ctx.importSettings(old); assert.ok(!JSON.stringify(importSync).includes("sk-file") && importSync.aiProviders?.[0]?.id === "p", "a provider's key in the file stays out of sync"); + await ctx.importSettings(file); + assert.strictEqual(ctx.normalizeAiProvider(importSync.aiProviders[0]).note, "自己的", "the 备注名 comes back with an imported file"); + await ctx.importSettings(old); assert.deepStrictEqual([importSync.noteFolder, importSync.triageFineBatchSize, importSync.follow_ai_settings], ["X", 20, { batchSize: 7 }]); assert.ok(!("stray" in importSync) && !("aiInitialQuickPrompts" in importSync) && !("obsidianApiKey" in importSync)); assert.ok(importSync.aiPresetPrompts.includes("旧")); diff --git a/extension/options.css b/extension/options.css index af285be8..f479ce63 100644 --- a/extension/options.css +++ b/extension/options.css @@ -664,7 +664,7 @@ details.adv[open] > summary::before { .ai-provider-row { display: grid; - grid-template-columns: 136px minmax(150px, 1fr) 150px 150px 96px minmax(30px, max-content); + grid-template-columns: 124px 112px minmax(130px, 1fr) 140px 140px 96px minmax(30px, max-content); gap: 8px; align-items: center; } @@ -713,6 +713,10 @@ details.adv[open] > summary::before { font-size: var(--fs-sm); } +.prov > .hint { + margin: 0 0 10px; +} + .ai-later { margin: 6px 0 14px; color: var(--muted); diff --git a/extension/options.html b/extension/options.html index 5a9b6b39..cae0675a 100644 --- a/extension/options.html +++ b/extension/options.html @@ -186,9 +186,10 @@
备注名显示在侧边栏和分拣台的平台选项里。不填时显示「平台 · 模型」。
加好平台后,这里会出现系统提示词、AI 总结要求、播放器上的 ✦ AI 总结按钮和快捷追问。
diff --git a/extension/options.js b/extension/options.js index 7210097c..a68e8c4e 100644 --- a/extension/options.js +++ b/extension/options.js @@ -1218,6 +1218,7 @@ function renderAiProviders(items) { function updateAiProvidersEmptyState() { const hasRows = elements.aiProvidersList.children.length > 0; elements.aiProvidersHead.hidden = !hasRows; + elements.aiNoteHint.hidden = !hasRows; // The prompt settings do nothing without a platform, so they wait until a row is added. elements.aiPromptRows.hidden = !hasRows; elements.aiPromptsLater.hidden = hasRows; @@ -1270,6 +1271,7 @@ function addAiProviderRow(item = {}) { +