FR-182 · 需求索引 · 本頁由 build 掃資料夾生成

FR-182 Agent 授權照(一台一張、機器碼開通、離線可用)

Agent 比照主系統拿照:License Center 簽發、給序號、客戶抄 Agent 機器碼來開通、拿到綁機的照上傳。Agent 不分功能,只分有照/沒照;客戶封閉網路靠離線開通。LC、Agent、主系統三端全數完成。

狀態:結案(2026-11-07) 文件 5 份
§1

🔴 先看哪一份

文件 性質 什麼時候看
design.md 設計定版 v1.0 要知道定案是什麼、P1 怎麼拆
discussion.md 需求討論稿 v1(含 D1~D8、與 FR-181/179 接點對照) 要知道為什麼這樣決定、排除了什麼
prototype/lc-agent-license.html 雛形:LC 後台「Agent 授權」七場景 驗收 P1 後台頁對照用
prototype/agent-console-license.html 雛形:Agent 主控台「授權」分頁七場景 P2 開卡與驗收對照用
handoff/cards.py P1 拆卡底表(驗批用) 補卡、挪批時改這裡再產
§2

結論

  • Agent 要有自己的一張照,獨立於主系統的照(記上層照號對照用),一台一張、綁 Agent 的 device_uuid、有到期日、沒有模組清單。
  • License Center 新開模組 agent_licensing、新表,不動主系統照的表與四支凍結 API;序號與私鑰解鎖抽到共用層。
  • 第一期只做離線開通;線上開通走 Agent → 主系統 → LC(Agent 永不直連 LC),認證用註冊 token。
  • 沒照或過寬限的 Agent 不擋啟動,但整個 sync 模組(註冊/心跳/長輪詢)一道門不起;主控台可登入、看機器碼、上傳照。
  • 像但不做:主系統照加 max_agents(Agent 本機無法驗、離線做不出);一張照 N 座位;裝 jedi-license-runtime 到 Agent。
  • P2(Agent)第一批三張與 FR-181 零撞檔、已開;「未開通可登入」那段等 FR-179 A1 合回;P3(主系統)七張已開:批 5、6 與 FR-181 零撞檔;批 7(套件發版、FE 列表欄)與批 8(釘版)等 FR-181 全合回。
§3

📊 總進度

母卡 CM-3609。

棒 卡 做什麼 狀態
P1 批 1 CM-3610 L1 LC 模組地基、抽共用、CLI、空 blueprint ✅ 11-07 首腦實驗
P1 批 2 CM-3611 L2 LC 後台五頁 ✅
P1 批 2 CM-3612 L3 LC 機器 API 三支 ✅
P1 批 3 CM-3613 L4 文件與端到端證據 ✅
P2 批 4 CM-3621 P2-1 Agent 驗照、沒照不起 sync、模組登記 ✅ 11-07 首腦實驗(閘門改拆兩支)
P2 批 4 CM-3622 P2-2 主控台授權分頁 API ✅
P2 批 4 CM-3623 P2-3 主控台授權分頁畫面(FE) ✅
P2 後補 — 未開通時主控台放行 ✅ 不另開卡:FR-181 首腦直接修(evidence-agent 1a47d90、24ee084,FE 2a07071b);首次設定頁插「上傳照」併入真機驗收看是否仍需要
P3 批 5 CM-3624 P3-1 契約加 license 兩鍵、remote_agents 兩欄、migration 020(套件,不發版) ✅ 11-07 首腦實驗
P3 批 5 CM-3625 P3-2 主系統落庫+線上開通代打 LC(註冊 token 認證) ✅ 11-07 首腦真機鏈實打
P3 批 6 CM-3626 P3-3 Agent 送授權狀態、線上開通(Agent) ✅
P3 批 6 CM-3627 P3-3b 主控台線上開通畫面(FE) ✅
P3 批 7 CM-3629 P3-4a 兩套件發版 ✅ 11-07 發 protocol 0.5.3/remote-agent 1.17.4(合併 FR-181+182,取代被蓋掉的 0.5.2/1.17.2)
P3 批 7 CM-3630 P3-4b 主系統 Agent 列表授權欄、error-code(FE) ✅
P3 批 8 CM-3638 P3-4c Agent 改釘 protocol 0.5.3(工作坊首腦補開) ✅
P3 批 8 CM-3628 P3-4 主系統釘 0.5.3/1.17.4、SPEC 兩頁、手冊第十四章、README ✅ 11-07 首腦實驗、已合回
§4

需求討論紀錄

  • 2026-11-07 決策者:主系統有 License,Agent 也要用一樣的模式拿機器碼來註冊;Agent 不需要功能分級,只要授權檢查;要能離線註冊激活;先改 License Center。
  • 2026-11-07 首腦白話複述+七項建議(獨立照/新模組新表/兩段式到期/用 device_uuid/離線先行線上經主系統/不擋啟動但不起 sync/數量欄批號),決策者「都對,照你的建議」。
  • 2026-11-07 決策者提醒 FR-181 是 Agent 通訊大改,要對衝突。首腦對照結論:P1 零影響;P2 三個接點(閘門放在 sync 模組整層、registry.py 排 F-2 後、主控台未註冊放行用 FR-179 A1 的門、線上開通用註冊 token 認證)寫進 discussion §2.4 與 design §4.8。
  • 2026-11-07 決策者:「用完就開卡」→ P1 開卡:母卡 CM-3609,子卡 CM-3610~3613(批 1:L1;批 2:L2、L3;批 3:L4)。
  • 2026-11-07 P1 四張首腦實驗通過(565 測試綠、CLI/三支 API/後台五頁實打),決策者 Done;工作坊合回 feature/FR-172,LC 升 189(POC)與 188(STG,順修 git safe.directory 版號 unknown)。DEV 測試資料清掉。
  • 2026-11-07 決策者「蛤 Agent 還沒做?」→ 查 FR-181/179 進度:F-2 已合回、A-3 不同檔、FR-179 A1 暫緩。P2 拆三張(CM-3621~3623,Stage 4)與 FR-181 零撞檔先派;P3 撞 FR-181 B-1/B-3 等它合回。
  • 2026-11-07 決策者「P3 也可以解禁嗎」→ 對 FR-181 工作區實查:181 動套件的 commands.py/routing.py/plugin/*,沒動 events.py/模型/serializer/migrations;主系統 _agent_status.py 沒動。P3 拆七張(CM-3624~3630):批 5 契約+落庫+代打 LC 現在可派(套件只改檔不發版、主系統 path dependency 不 commit);批 6 等 P2;批 7 發版與 FE 列表欄、批 8 釘版等 181 合回。線上開通認證用註冊 token「只驗不消耗」(套件既有 get_enabled_by_hash)。
  • 2026-11-07 FR-181 十五張程式卡全合回四 repo feature/FR-172(首腦實查:退役 grep、兩開關預設、釘版 0.5.1/1.17.1/1.10.1 在 Nexus、BE 158/Agent 2332/三套件 73+540+303 綠、FE build 綠)→ P3 批 7/8 前置解除;P3-4a 版號改 0.5.2/1.17.2 避開 181 已發的號。
  • 2026-11-07 批 6~8 六張首腦實驗通過(Agent 106/jedi 75+572/BE 166 綠、FE 兩 build 綠),四 repo ws-CM-3609 合回 feature/FR-172 並推:BE 720770c76、Agent 2692fa1、FE 19acca4e、jedi 2fc3dfc4。P3-4a 第 1 輪發的 0.5.2/1.17.2 撞到 FR-181 同號被 Nexus 覆蓋(少 KIND_VERIFY_FILE),決策者裁合併後重發 0.5.3/1.17.4,工作坊首腦補開 CM-3638 讓 Agent 改釘;Nexus「允許同版號重傳」建議關掉(待決策者)。
  • 2026-11-07 P2 三張+P3-1/P3-2 首腦實驗通過:Agent 84+118(合併後)綠、FE build 綠、protocol 51/remote-agent 525 綠(突變有牙)、BE 141 綠;P3-2 真機鏈(LC 5063+BE 8001)開通 200→agent-verify 過→409/401/404/400→主系統零寫入→token 未扣。181 與 182 在 Agent registry.py 撞檔,首腦解(兩邊都留,de72ebb)。P3-2 error code 開自己的檔 AGENT_LICENSE_<HTTP><序號>,P3-4b 照這組。remote-agent poetry.lock 過期,P3-4a 發版前要 lock。
§5

文件

以下全部由 build 掃資料夾產生,新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML,md 連向源檔。

需求與討論

文件 類型 標題 最後更新
discussion / md 需求討論稿 Agent 也要有照:比照主系統,先改 License Center 2026-11-07

設計

文件 類型 標題 最後更新
design / md 設計 FR-182 Agent 授權照(一台一張、機器碼開通、離線可用) 2026-11-07

evidence/(1 份)

證據與盤點

文件 類型 標題 最後更新
p1-e2e / md 文件 FR-182 P1 端到端證據(License Center DEV) 2026-11-07

互動雛形(2 份)

其他文件

文件 類型 標題 最後更新
agent-console-license 文件(手刻 HTML) FR-182 雛形 · Agent 主控台「授權」分頁 2026-11-07
lc-agent-license 文件(手刻 HTML) FR-182 雛形 · License Center「Agent 授權」 2026-11-07
§6

Notion 卡

卡片內容(決策紀錄、驗收條件)以 Notion 為準,本頁只記座標。

關係 卡號 標題 狀態
母案 CM-3609 FR-182 母案(15 張子卡,已 Done) —
子卡 CM-3610 — —
子卡 CM-3611 — —
子卡 CM-3612 — —
子卡 CM-3613 — —
子卡 CM-3621 — —
子卡 CM-3622 — —
子卡 CM-3623 — —
子卡 CM-3624 — —
子卡 CM-3625 — —
子卡 CM-3626 — —
子卡 CM-3627 — —
子卡 CM-3628 — —
子卡 CM-3629 — —
子卡 CM-3630 — —
子卡 CM-3638 — —