feat: v0.3.8–v0.3.14 工作区汇总（依赖升级、整理来源、手动入库、原地入库等）

生产 v0.3.8～v0.3.13 均由 8013196 加工作区修改构建部署，此前未提交；本提交补齐源码，
并含未部署的 v0.3.14 原地入库。中间各版本源码状态未保存，无法逐版拆分，详见
docs/plan/17-full-upgrade.md 与 docs/plan/18-organize-release.md。

- v0.3.8 全面升级：Deno workspace 依赖、Router 8 / Vite 8、camofox 1.18.0 / Node 24、
  PostgreSQL 18.6、备份客户端 18.6、演示 qB 5.2.4
- v0.3.9 媒体整理：分类规则、整理来源与目录快照（0059）、文件管理整理入口
- v0.3.10 手动下载与入库：独立手动下载、详情页资源下载、TMDB / Local 元数据兜底
  （metadata.resolve_organize）、正常多版本 / 一次性洗版（0060）
- v0.3.11 搜索详情与桌面黑边修复
- v0.3.12 列表分页、搜索历史、首页概况
- v0.3.13 统一整理弹窗与队列
- v0.3.14 原地入库（0061，未部署）

同批审计修复：
- 刮削入队：确认原记录存在后才删重放产生的新记录；写回 run 关联失败时保持 queued，
  由处理器补关联（对齐 MP 先登记、只在入队失败时记失败）
- 识别升级链只在结果更确定时采用，不再用 no_match 顶替原有歧义候选
- bluray_dir 资产以原盘目录本身为刮削根（MP 同做法）
- metadata.resolve_organize 登记到入库排障 Skill 与能力地图
- db/src/types.ts 按迁移重新生成；contracts 整理动作枚举顺序与数据库对齐
- 测试：原地入库用例改为直接查记录表；domain 测试模板补 version
- 前端：通知铃铛弹层与用户菜单统一样式；站点卡片共用卡头、底栏贴底、分页间距

依赖升级证据只提交摘要文件，registry-snapshot.json 移至 .local/（SHA-256 记于文档）。

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/agent/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@umt/agent",
-  "version": "0.3.7",
+  "version": "0.3.14",
   "exports": { ".": "./src/index.ts" },
   "tasks": {
     "test": "deno run -A npm:vitest run",

packages/agent/skills/import-troubleshoot/SKILL.md

@@ -17,6 +17,7 @@ capabilities:
   - organize.plan
   - organize.execute
   - metadata.enrich
+  - metadata.resolve_organize
 sessions: [chat, investigate, child]
 ---
 
@@ -33,7 +34,7 @@ sessions: [chat, investigate, child]
    - 已完成待整理 / 整理中 → 看关联的核验入库任务（task.inspect 看错误）；
    - 入库失败 → 读整理记录和错误，一句话说原因；
    - 有「没识别出作品」的待处理事项 → decision.list 确认，说明要用户指定作品。
-4. 身份问题：资源还没对上作品时可以用 identity.resolve 提出映射；TMDB 查不到的作品，网页搜索开启时用 metadata.enrich 出建议。
+4. 身份问题：资源还没对上作品时可以用 identity.resolve 提出映射；TMDB 查不到的作品，网页搜索开启时用 metadata.enrich 出建议。整理要用的资源连常规识别也对不上作品时，用 metadata.resolve_organize 补全译名重查 TMDB，仍没有合适条目才建立带来源证据的本地作品。
 5. 需要重新整理时：organize.plan 生成计划（不动文件），再 organize.execute。
 
 ## 需要批准

packages/agent/src/pi/catalog.ts

@@ -12,10 +12,10 @@ import type {
 } from "@umt/contracts";
 
 // pi-ai 内置 provider → 能力表。认证方式、模型表直接读 builtinProviders();
-// 登录方式、env 字段、条款提示是研究文档(docs/design/pi-providers.md §1.3/§2/§5)核对 0.87.1 源码后的静态表,
+// 登录方式、env 字段、条款提示是研究文档(docs/design/pi-providers.md §1.3/§2/§5)及 0.99.2 升级核对的静态表,
 // 升级 pi-ai 时随文档一起复核。
 
-export const PI_AI_VERSION = "0.87.1";
+export const PI_AI_VERSION = "0.99.2";
 
 let cached: readonly Provider[] | null = null;
 /** 内置 provider 实例(无状态的共享;Radius 这类动态 provider 按上游另建新实例) */
@@ -32,6 +32,7 @@ export function builtinProvider(id: string, fresh = false): Provider | undefined
 /** 订阅/OAuth 登录方式(第一个是推荐项;有 device 的优先 device,不用粘 URL) */
 export const OAUTH_MODES: Record<string, PiOAuthMode[]> = {
   anthropic: ["browser"],
+  openai: ["browser"],
   "openai-codex": ["device", "browser"],
   "github-copilot": ["device"],
   xai: ["device"],
@@ -45,6 +46,7 @@ export const OAUTH_MODES: Record<string, PiOAuthMode[]> = {
 /** 浏览器模式 pi 会在服务端监听的回调端口(占用时 Anthropic 会直接失败) */
 export const OAUTH_CALLBACK_PORTS: Record<string, number> = {
   anthropic: 53692,
+  openai: 1455,
   "openai-codex": 1455,
   radius: 1456,
 };
@@ -117,6 +119,8 @@ const NOTES: Record<string, string> = {
   "opencode-go": "OpenCode Go:没有订阅登录,用 opencode.ai 控制台生成的 key(与 Zen 同一个 OPENCODE_API_KEY)",
   openrouter: "登录换得永久 API Key,不需要刷新",
   radius: "Pi 官方网关,模型列表动态刷新",
+  openai: "API Key 或原生 Sign in with ChatGPT;OAuth 请求使用官方 Responses 端点",
+  typesafe: "分类服务,不提供 Agent 聊天模型",
   "amazon-bedrock": "API Key 填 Bedrock bearer token;或选“不需要凭证”使用服务端 AWS 凭证链",
   "google-vertex": "API Key 填 Google Cloud API key;或选“不需要凭证”使用服务端 ADC / 服务账号",
 };

packages/agent/src/prompt/layers/capabilities.ts

@@ -114,6 +114,7 @@ export const INTENT_ROUTES: readonly IntentRoute[] = [
       { cap: "web.search", note: "搜索" },
       { cap: "web.fetch", note: "读其中一条结果的正文" },
       { cap: "metadata.enrich", note: "TMDB 查不到的作品出元数据建议" },
+      { cap: "metadata.resolve_organize", note: "整理用的资源对不上作品时兜底识别或建本地作品" },
     ],
   },
 ];

packages/agent/test/upstream.test.ts

@@ -46,10 +46,10 @@ const spec = (s: Partial<UpstreamSpec> & Pick<UpstreamSpec, "provider" | "authKi
 });
 
 describe("能力表", () => {
-  it("41 个内置 provider + openai-compatible + fake,id 与合同枚举一致", () => {
+  it("42 个内置 provider + openai-compatible + fake,id 与合同枚举一致", () => {
     const c = providerCatalog({ models: false });
     const ids = c.providers.map((p) => p.id);
-    expect(ids).toHaveLength(43);
+    expect(ids).toHaveLength(44);
     expect(new Set(ids)).toEqual(new Set(PiProviderId.options));
     expect(ids.filter((i) => i !== "fake" && i !== "openai-compatible").sort()).toEqual(
       [...PI_BUILTIN_PROVIDER_IDS].sort(),
@@ -58,11 +58,21 @@ describe("能力表", () => {
     expect(c.providers.every((p) => p.models.length === 0)).toBe(true);
   });
 
-  it("订阅登录:8 种 OAuth;订阅型带条款提示;Codex 只有 oauth 且优先 device", () => {
+  it("订阅登录:9 种 OAuth;Codex 只有 oauth 且优先 device;OpenAI 支持原生 ChatGPT 登录", () => {
     const c = providerCatalog();
     const oauth = c.providers.filter((p) => p.oauth && p.id !== "fake").map((p) => p.id);
     expect(oauth.sort()).toEqual(
-      ["anthropic", "github-copilot", "kimi-coding", "meta", "openai-codex", "openrouter", "radius", "xai"].sort(),
+      [
+        "anthropic",
+        "github-copilot",
+        "kimi-coding",
+        "meta",
+        "openai",
+        "openai-codex",
+        "openrouter",
+        "radius",
+        "xai",
+      ].sort(),
     );
     const byId = Object.fromEntries(c.providers.map((p) => [p.id, p]));
     expect(byId["openai-codex"]!.authKinds).toEqual(["oauth"]);
@@ -80,6 +90,10 @@ describe("能力表", () => {
     expect(byId["amazon-bedrock"]!.authKinds).toContain("none");
     expect(byId.openai!.models.length).toBeGreaterThan(10);
     expect(byId.openai!.baseUrlOverridable).toBe(true);
+    expect(byId.openai!.authKinds).toEqual(["oauth", "api_key"]);
+    expect(byId.openai!.oauth!.modes).toEqual(["browser"]);
+    expect(byId.openai!.termsNote).toBeNull();
+    expect(byId.typesafe!.models).toEqual([]);
   });
 });