Skip to content

docs(adr): record the youtube.js probe result #188

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
1morr merged 2 commits into from
Sep 30, 2026
Merged

docs(adr): record the youtube.js probe result #188

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b3eecf5
docs(adr): record the youtube.js probe result
1morr Sep 30, 2026
cb5e44d
chore(task): archive the youtube.js probe
1morr Sep 30, 2026
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
15 changes: 7 additions & 8 deletions .trellis/tasks/09-28-m1-skeleton-tracer/implement.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

## 進度與交接（2026-09-30 更新；compact 後從這裡接）

- **已合併進 `main`**：#173（設計文件）、#174（PR 1 指令檔分家）、#175（PR 2 骨架與 CI）、#177（PR 3 lint）、#178（PR 4 平台層）、#179（PR 5 drift）、#180（PR 6 log 與設定）、#181（PR 7 錯誤模型）、#182（PR 8 網路層）、#183（PR 9a JS 執行環境）、#184（PR 9b 契約執行器）、#185（PR 9c 紀錄）、#186（遮蔽修正）。#176 是 CI 路徑探測，已關閉。
- **已合併進 `main`**：#173（設計文件）、#174（PR 1 指令檔分家）、#175（PR 2 骨架與 CI）、#177（PR 3 lint）、#178（PR 4 平台層）、#179（PR 5 drift）、#180（PR 6 log 與設定）、#181（PR 7 錯誤模型）、#182（PR 8 網路層）、#183（PR 9a JS 執行環境）、#184（PR 9b 契約執行器）、#185（PR 9c 紀錄）、#186（遮蔽修正）、#187（PR 10 播放核心）。#176 是 CI 路徑探測，已關閉。
- **isar／sqlite3 共存探針**：已完成，兩平台共存、全部 16KB 對齊（`research/isar-sqlite3-coexistence.md`，ADR 0010 已補）。
- **PR 9a 完成**（#183，子任務已 archive 到 `.trellis/tasks/archive/2026-09/09-30-js-runtime/`）：每插件一個背景 isolate 的 QuickJS、宿主 API v1、manifest、從檔案安裝與 dev 開發入口、測試插件 `fmp-test`；數字在該子任務 `research/notes.md` §4。
- 實機：Windows dev 開發入口裝上、重啟後從資料庫載入、prod 不理會旗標；Android 模擬器 dev 的前兩項。模擬器上的 `com.personal.fmp` 是舊版 1.11.0，prod 沒裝上去驗；prod 那一段由單元測試守（`devPluginPath` 對 prod 一律回 `null`，有變異驗證）。
Expand All @@ -35,10 +35,9 @@
- 在 dev App 裝它：`fmp.exe --fmp-dev-plugin=<fmp-plugins>/bilibili/bilibili.js`（Android 照 9a 的 `run-as` 做法）。
- 真實連線：兩次錄製共 8 個 GET，沒有遇到風控；fixture 人工逐檔檢查過。
- **遮蔽修正**：`hdnts`／`buvid` 進內建名單、同 host 的規則合併套用；fmp-plugins 的 B 站 fixture 同步重新遮蔽。
- **進行中（2026-09-30 起並行）**：
- PR 10 播放核心：分支 `feat/playback-core`，子任務已 archive 到 `.trellis/tasks/archive/2026-09/09-30-playback-core/`。實機（審查前的產物）：Windows 測試插件三首連播、交接估計間隔 49 ms；Android 估計 -43／18 ms，整段只有一次 `requestAudioFocus`、沒有 `abandonAudioFocus`；Windows 以 B 站插件真實播放一首（3 個 API 請求、只帶 Referer／User-Agent，log 無 CDN 網址）。審查修了 5 個缺陷（含 Android 載入中暫停會永遠卡在 Loading）；修正後 Android 真後端契約連續 5 次 10/10、Windows 10/10，兩平台連播與焦點重跑通過（Windows 50／49 ms，Android -206／30 ms、焦點只要求一次）。
- YouTube.js 探針：在 Agent 的 worktree、分支 `probe/youtubejs`（不合併、不 push）；結論寫在該 worktree 的 `research/youtubejs-probe.md`，回報後由主對話開子任務收進 `research/`，並在 ADR 0014 §決定 10 補一句結論。
- **之後**：11 verify-on-device → 12 UI → 13 五平台建置與發版 workflow → 里程碑驗收。
- **PR 10 完成**（#187，子任務已 archive 到 `.trellis/tasks/archive/2026-09/09-30-playback-core/`）：播放核心、兩個後端、前瞻交接。dev 入口 `--fmp-dev-playback`（可加 `=<曲目鍵>`）；實機數字在該子任務與 #187 描述。
- **YouTube.js 探針完成**：通過（VISIONOS client），M3 的 YouTube 走插件；程式碼在分支 `probe/youtubejs`（已 push，不合併），結論在 `.trellis/tasks/archive/2026-09/09-30-youtubejs-probe/`，ADR 0014 §決定 10 已補。Android 只驗到音訊系統層（模擬器 `-no-audio`）。
- **下一步**：11 verify-on-device → 12 UI → 13 五平台建置與發版 workflow → 里程碑驗收。
- **擁有者決定**：1–8 都在父任務 `prd.md`「擁有者的決定」。9a、9b 期間新增了三項：
- 決定 6：插件安裝檔是單一 `.js`，開頭帶 `==FMP Plugin==` manifest；
- 決定 7：插件在背景 isolate 執行；逾時先送存活探測，沒回應才停用到重啟；
Expand Down Expand Up @@ -216,9 +215,9 @@ PR 10 留下的後續：

### 探針：YouTube.js（擁有者決定 3）

- [ ] 9 合併後開一個子任務，時限約 2–3 個 session。
- [ ] 分支不合併，結論寫進研究檔。
- [ ] ADR 0014 補一句結論。
- [x] 9 合併後開一個子任務，時限約 2–3 個 session。
- [x] 分支不合併，結論寫進研究檔。
- [x] ADR 0014 補一句結論。

### 10. 播放核心最小集

Expand Down
3 changes: 2 additions & 1 deletion .trellis/tasks/09-28-m1-skeleton-tracer/task.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@
"09-30-plugin-contract",
"09-30-bilibili-plugin",
"09-30-redaction-cdn-rules",
"09-30-playback-core"
"09-30-playback-core",
"09-30-youtubejs-probe"
],
"parent": "09-26-fmp-rewrite",
"relatedFiles": [],
Expand Down
1 change: 1 addition & 0 deletions .trellis/tasks/archive/2026-09/09-30-youtubejs-probe/check.jsonl
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"file": "docs/adr/0014-script-source-plugins.md", "reason": "Decision 10: YouTube fallback"}
1 change: 1 addition & 0 deletions .trellis/tasks/archive/2026-09/09-30-youtubejs-probe/implement.jsonl
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"file": "docs/adr/0014-script-source-plugins.md", "reason": "Decision 10: YouTube fallback"}
24 changes: 24 additions & 0 deletions .trellis/tasks/archive/2026-09/09-30-youtubejs-probe/prd.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# YouTube.js 可行性探針（M1）

父任務：`../09-28-m1-skeleton-tracer`（擁有者決定 3；implement「探針：YouTube.js」）。依據 ADR 0014 §決定 10。

## 問題

YouTube.js（npm `youtubei.js`）能否在 FMP 的插件執行環境裡搜尋，並解出可以播放的串流？執行環境是 `flutter_js` 0.8.7 的 QuickJS，每個插件一個背景 isolate，只有宿主 API v1。

## 過關標準

Android 與 Windows 都要做到：
- 能載入；
- 搜尋有結果；
- 解出的音訊網址 FMP 播得出聲音；
- 不需要登入，也不需要另外生成 PO token。

效能只記錄，不影響過關。時限約 2–3 個 session，程式碼不合併。

## 結果

**通過**，前提是 `resolveStream` 改用 VISIONOS client，IOS 當備援。證據、墊片、client 現況、效能與宿主 API 缺口都在 `research/youtubejs-probe.md`。
- 探針程式碼保存在分支 `probe/youtubejs`：已 push，不合併。
- 但書：Android 模擬器是以 `-no-audio` 啟動的，Android 的「播得出聲音」只驗到音訊系統那一層。
- 結論：M3 的 YouTube 走插件，不改用 Dart 實作。ADR 0014 §決定 10 已補一句。
Loading
Loading