← 全部的單
GitHub #243 ↗
帳務・功能
讓平台先把每一次智慧元件花了多少錢、如果收費會扣幾點記清楚（只看、不扣、不擋），等扣點數字與帳本規則都定了，再由負責人打開收費開關，開始從機構的點數扣。
#243 智慧元件第二段：點數帳本（扣點表、append-only 帳本、同 Farside 一份點數、先只監控不扣不收）
狀態
還沒開始
誰在做
宜芳分派
做到哪
還沒動工：main 上沒有帳本表、沒有 429-smart_quota 這個錯誤碼、扣點表（smart_points.py）是空的，AI Gateway 的 spend limit 也還沒設（runbook 寫「第二段之前要加」）。10/05 負責人已同意開工順序（
#326
）。相鄰的
#260
換算第一切片 PR
#282
已核准、還沒合併。
卡在
第一刀（只能加的帳本＋唯讀監控＋spend limit＋每日對帳）不卡，只等 PM 分派；第二刀（扣點與收費開關）卡在
#254
扣點數字（負責人裁）、
#260
換算（PR
#282
待合併）、
#256
帳本邊界，以及律師與會計師的意見（
#261
）。
下一步
宜芳把第一刀分派出去；同時把「唯讀監控給誰看」「手動核發誰能按」「正式租戶什麼時候開」三題排進給負責人的待裁清單。
提醒：
①第一刀現在就能做：10/05 負責人已同意開工順序（
#326
），扣點數字、
#260
、
#256
只擋第二刀（扣點與收費開關），可以直接分派。②分工：
#248
的分工表草案寫本單給某位開發者，負責人 10/05 改成一律先給 PM 看、由 PM 分派；
#248
已關。③本文〈相依〉要「動工前先跟 PM 確認
#240
與本單誰主導、帳本 schema 由誰定」——
#326
已定機構帳本與個人付款人帳本先不互接、唯一帳本另案，所以本單照機構記一份即可，分派時講一句就好。④本文寫「第二段沒有自帶金鑰路徑」已過期：
#267
自帶 BFL 金鑰 10/03 已上線，那幾次不扣點（本單 10/03 留言已補）。⑤本文驗收的「每日對帳拿 gateway cost 對 debit」在只監控期間對不到東西，見還沒定的第 6 題。⑥10/02 審查留言還有幾條建議沒寫進本文：並發扣款要鎖、開關打開時缺規則要擋、我方逾時但上游已收費的那筆、核發要有唯一鍵、失敗的那次也要記估計點數——都屬第二刀，開收費前要補進驗收。⑦正式租戶開智慧元件綁在本單，是
ADR-0124
的實作口徑、不是負責人裁決（還沒定的第 5 題）。⑧會計師 10/05 初步說儲值買的點數屬禮券性質（
#316
留言，不是裁決），影響之後怎麼加值，不影響第一刀。⑨標籤「待負責人裁決」可以留著（第二刀的題目還沒裁），但不要讓它擋住第一刀。
一步一步 9
已經定的 16
還沒定的 10
怎麼驗收 7
這張不做 8
這張要解決什麼
負責人（平台營運）與各機構的管理者
，智慧元件現在由平台的 Cloudflare 帳戶全付，沒有任何帳本：看不到每個機構用了多少、如果收費要扣幾點；支付系統還在註冊、跟 Compute 的帳號還沒合併，所以現在還不能收錢——要能 先建一本只能加、不能改的點數帳本，照實記下每一次的用量與成本（只監控、不扣不收），設好平台的花費上限與每日對帳；等扣點數字與帳本邊界都定了，負責人開開關就能開始扣點、點數不夠在送出前擋下
一步一步
9 步
機構成員（畫布上可以編輯的人）
在畫布的智慧元件（例如「生成圖片」）寫描述、按「執行」
跟今天一樣出結果。只監控期間不預扣、不擋、不會出現點數不足；元件上不新增任何點數顯示
畫布上的智慧元件（只監控期間，跟今天一樣）
生成圖片
描述
模型選單（機構開放超過一顆時才出現）
執行
生成的圖
放到畫布上
系統（後台）
記下這一次執行：用了哪一顆模型與等級、用量、平台實付的成本（美金）；扣點表有這一顆的規則時，另外記「如果收費會扣幾點」與規則版本
沒有規則時點數欄是空的，不是 0（0 等於宣稱免費）；用自帶金鑰（BYOK）跑的那次標成自帶金鑰、平台成本是空的、不算點；帳本不寫任何扣款列
負責人
在 Cloudflare 後台替 slate-smart 這個 AI Gateway 設 spend limit（平台付的花費上限），把數字、設定時間、設定人記進 docs/runbook.md
平台多一道花費保險絲。它是最終一致的，一批請求同時湧進時會短暫超過，所以原本的限速照留
系統（每天一次）
拿 AI Gateway 記錄的花費，跟我們這邊每一次執行的紀錄對一次
對不上就發告警，不自動補扣、不改帳本。gateway 記 0、但目錄有價格的模型，照目錄價格算
負責人（之後要不要也給機構管理者看，還沒定）
打開唯讀監控，看這段時間每個機構跑了幾次、平台花了多少、如果收費會扣幾點
用來檢查
#254
扣點表的假設，不是帳單；畫面上沒有任何可以改數字的按鈕
唯讀監控（放在哪、給誰看還沒定）
智慧元件用量（只監控：不扣點、不收費）
目前是只監控模式：帳本不扣點、不擋人
每一次執行：時間、機構、能力、模型／等級、誰付（平台／自帶金鑰）、平台成本、如果收費會扣幾點、規則版本
沒有扣點規則的那幾次顯示「還沒有規則」，不顯示 0
自帶金鑰的那幾次平台成本空白，不算進平台花費
平台營運者（誰能按還沒定）
替某個機構手動核發點數（grant），或做一筆人工調整（adjustment，要寫原因）
帳本多一列；舊的列永遠不能改、不能刪，餘額＝整本加總。只監控期間不擋人，所以這一步到開收費之前才真的需要
負責人
等
#254
扣點數字、
#260
換算、
#256
帳本邊界都定了，支付系統註冊完、律師與會計師有答案，才用一個 PR 打開收費開關（開關放在 git 查得到的地方）
合併後系統開始預扣與結算。開關、單價、告知版本的任何變動，合併前都要負責人點頭
機構成員
（收費開關打開之後）按「執行」，機構的點數夠
送出前先預扣估計的點數，完成後照實際用量結算，帳本記一筆扣款（帶這一次執行的編號）；結果照常出現
機構成員
（收費開關打開之後）按「執行」，機構的點數不夠
送出前就擋下，一個請求都不送到 AI 供應商；元件顯示固定格式的錯誤，上一次成功的結果留著。要不要附「升級方案」的路還沒定
智慧元件：點數不夠（收費開關打開之後）
生成圖片
錯誤類型｜429-smart_quota｜追查碼
上一次成功的圖，標「最新一次失敗」
執行
已經定的
16 條
帳本只能加、不能改也不能刪，只有三種列：核發（grant）、每次執行的扣款（debit，帶那一次執行的編號）、人工調整（adjustment，要寫原因）；餘額＝整本加總，不另外存一個會被改的「餘額」欄
ADR-0124
q2 裁決（R12，負責人 2026-09-30）
第一版加點數只能由管理台手動核發，不做線上購買
ADR-0124
q2 裁決第 3 點（R12）、
ADR-0115
〈2026-10-01 修訂〉二
帳本的單位是「點」，跟 Compute 同一種；一個會員一份餘額，Slate 的 AI 與 Compute 的 GPU 從同一份扣，Slate 不另外送
ADR-0124
R24（負責人 2026-10-01）、
ADR-0117
〈2026-10-01 修訂〉四
開工順序：先做只能加的帳本＋唯讀監控；扣點與收費開關等
#254
、
#260
的數字與
#256
的邊界都定了再開
負責人 10/05「照PM建議」（
#326
、本單 10/05 留言）
收費開關、單價、告知版本的任何變動，合併前都要負責人點頭
#326
（負責人 10/05）
現在只監控、不扣不收：每一次照實記成本與用量，不從任何餘額扣、不擋人；平台側的保險絲是 AI Gateway 的限速與 spend limit
ADR-0117
〈2026-10-01 修訂〉七之 1（負責人 2026-10-01 原話）
跟 Compute 的帳號合併之前不開收費
#248
帳務已裁定清單（
ADR-0117
〈修訂〉七、
#240
）
收費開關是獨立的開關、由負責人開，不能拿「扣點表還沒有數字」代替——不然哪天扣點數字裁下來，系統會在沒人決定收費的情況下自己開始扣、擋人
本單本文〈要做什麼〉第 4 點（依
ADR-0117
〈2026-10-01 修訂〉七之 1）、
#326
自帶金鑰（BYOK）的那幾次一律不扣點、不預扣、不寫扣款；平台成本是空的，不能當 0 算
ADR-0124
R18、本單 10/03 留言、
#326
沒有扣點規則時，「如果收費會扣幾點」記空的（NULL），不記 0
smart_points.py 檔頭（已寫好的程式）、本單本文〈已經裁定的〉
帳本照機構（租戶）各記一份；跟個人付款人那本（
#256
）先不互接、不重複發點，唯一帳本另案
負責人 10/05（
#326
會員與訂閱第 5 題）、
ADR-0115
〈2026-10-01 修訂〉二第 4 題
收費開關打開之後，點數不夠要在送出前擋下、回 429-smart_quota
ADR-0124
q2 裁決第 4 點
每天拿 AI Gateway 的花費紀錄對帳，對不上只告警、不自動補扣
ADR-0124
〈成本控制〉2026-10-01 修訂、本單本文〈要做什麼〉第 6 點
「這一次扣幾點」由
#260
算，本單只管記帳與收費開關，兩邊不各寫一套換算
#260
本文、本單 10/02 留言
Free 方案用完點數就停下來、提示升級，不自動扣款
負責人 2026-10-02（
#248
帳務已裁定清單）
儲值、加購點數包、自動加值要先有律師與會計師的書面意見才做
ADR-0057
決策九、
#261
還沒定的
10 題
扣點表的數字：每個能力 × 模型 × 等級扣幾點
照
#254
草案第三版定
改版重算再定
建議：
不擋第一刀（沒有規則也是安全狀態）；開收費之前一定要定
誰裁：負責人
唯讀監控給誰看、放在哪
只給負責人看（放進負責人自己用的監控小程式；10/03 負責人說產品裡不做開發端監控，
#304
已關）
機構管理者在畫面右下角的助理 dock 看自己機構的用量（
ADR-0124
〈成本控制〉寫的設計）
兩邊都要
建議：
第一刀先讓負責人看得到；給機構管理者的那一面等開收費前再做（建議，未裁）
誰裁：負責人
手動核發（grant）與人工調整（adjustment）誰能按、從哪裡按
只有平台營運者，用腳本或另一個平台角色
機構管理者在管理台按
建議：
只走平台營運者的路——開放自行註冊之後每個人都是自己機構的管理者，等於可以自己發點數（10/02 審查建議 g29）
誰裁：負責人
AI Gateway spend limit 的實際數字
負責人在 Cloudflare 後台定
建議：
正式租戶開放智慧元件之前要設好（runbook 寫「第二段之前要加」）
誰裁：負責人
正式租戶什麼時候開智慧元件：本單第一刀（只監控＋spend limit）上線就開，還是等收費開關打開才開
第一刀上線、spend limit 設好就開
等收費開關打開才開
建議：
ADR-0124
修訂（五）的實作口徑只寫「跟點數帳本一起上」，沒說哪一刀；runbook 的寫法（只監控期間平台照付、spend limit 當保險絲）比較像前者——請負責人確認
誰裁：負責人
每日對帳要對什麼
照本文：gateway 花費對帳本的扣款列（只監控期間沒有扣款列，會對不到東西）
改成對每一次執行記的平台成本（只監控期間也能跑）
建議：
改對每一次執行的平台成本（10/02 審查建議 g32），本文的驗收條件跟著改
誰裁：宜芳（改驗收條件）
合併之前要不要照四級每月自動發內含點數
不發（現況）
發
建議：
裁之前不發——自動發等於 Slate 另送一份，跟「不另送」相反（
ADR-0115
〈2026-10-01 修訂〉二第 2 題寫的現況）
誰裁：負責人
收費開關打開時，某顆模型剛好沒有扣點規則怎麼辦
照舊放行（等於那顆免費用到飽）
擋下、回一個新的錯誤碼，再加護欄：開關打開時每顆可選的模型都要有規則
建議：
擋下＋護欄（10/02 審查建議 g28）
誰裁：負責人
同一個機構好幾個人同時扣點時，怎麼防止扣過頭
每個請求自己「先查餘額再扣」
所有扣點只走一支函式、鎖住整個機構的帳
建議：
只走一支函式並鎖住機構的帳，CI 加一條「同時扣、餘額只夠一筆」的測試（10/02 審查建議 g30）
誰裁：宜芳分派的實作者（開收費那一刀時做）
點數用完的畫面要不要帶「升級方案」的路——Free 用完要提示升級已經定了，但方案掛在個人付款人那邊（
#256
），跟這本機構帳本先不互接
只顯示固定格式的錯誤
加一個去升級方案的連結
誰裁：負責人
怎麼驗收
7 項
前提：
只監控模式（收費開關關著）、扣點表沒有這顆模型的規則；用測試帳號 farside_dev（測試機構的管理者）登入
操作：
在畫布放「生成圖片」、寫描述、按「執行」
應該看到：
圖照常出來，沒有點數相關的錯誤；唯讀監控上看得到這一次：有平台成本，「如果收費會扣幾點」顯示還沒有規則（不是 0）；帳本沒有新增任何一列
前提：
只監控模式；實作者先替某一顆模型塞一條測試用扣點規則，並把測試機構的點數設成 0
操作：
用那一顆按「執行」
應該看到：
照樣送得出去、出圖；唯讀監控上這一次「如果收費會扣幾點」有數字；帳本沒有新列；沒有出現 429-smart_quota
前提：
同上一條，但在測試環境把收費開關打開（正面對照）
操作：
再按一次「執行」
應該看到：
被擋下，元件顯示固定格式錯誤 429-smart_quota；實作者附上「送出的請求次數是 0」的測試結果
前提：
測試機構管理者已在「開放哪些模型」打開 Black Forest Labs，成員存好自己的 BFL 金鑰
操作：
用標「自帶 BFL 金鑰」的模型按「執行」
應該看到：
唯讀監控上這一次標「自帶金鑰」、平台成本是空白（不是 0）、不算點；帳本沒有新列
前提：
PR 送審
操作：
打開 PR 的 How to Test／Verification 段
應該看到：
看得到三條綠燈：①對帳本任何一列做修改或刪除，被資料庫擋下 ②用另一個機構的帳號查不到這個機構的帳本、扣款只扣自己機構 ③把帳本每一列重加一次算出的餘額，跟系統回報的一樣（兩顆單價不同的模型各跑一次，兩筆要不同）
前提：
負責人說已設好 spend limit
操作：
打開 docs/runbook.md〈智慧元件第一段〉的「正式 gateway 的設定」
應該看到：
看到 spend limit 的數字、設定時間、設定人
前提：
實作者在測試環境刻意做出一筆對不上的紀錄
操作：
等每日對帳跑完（或手動跑一次）
應該看到：
看到一則告警；帳本沒有被自動補扣或改動
這張不做
線上購買、儲值、加購點數包、自動加值（要先有律師與會計師的書面意見，
#261
）
刷卡扣款與開發票（
#258
金流、
#259
電子發票）
扣點表的數字本身（
#254
）與「這一次扣幾點」的換算（
#260
）
合併之前照四級每月自動發內含點數（待裁，裁之前不發）
記 Compute 的 GPU 用量、把 Compute 的點數併進來（合併之前不做，
ADR-0115
）
跟個人付款人帳本（
#256
）互接——唯一帳本另案
Unified Billing 那 5% 手續費誰吸收（定價，另裁）
替自帶金鑰的執行扣點
相關的單
#236
#240
#242
#248
#254
#256
#258
#259
#260
#261
#267
#282
#316
#326