Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
267 Commits 27 Branches 0 Tags
23f2fd499afbd75b738c2ed77783f783fe8b5634
Commit Graph

14 Commits

Author SHA1 Message Date
uncle6me-web 23f2fd499a t189：/portal/daemon/extract 拿掉 tenant 等值比對——geek6688 萃取永遠 401 
leo 實測（拔掉所有 Gemini 金鑰後跑 daemon）：
  深海熱泉.md → failed 雲端萃取失敗（HTTP 401）：X-Arcrun-API-Key 不正確

## 真兇＝我在 t181 自己加的錯誤假設
t181 那輪改成 apiKey !== portalTenant(env) 就 401，
假設「daemon 的 api_key ＝ 實例的 CONSOLE_TENANT」。實測不成立：
  geek6688：tenant=ckxt8yr9、daemon api_key=yuga3bse ⇒ 真用戶**永遠 401**
  youlin  ：兩者碰巧相同 ⇒ 我這邊怎麼測都對
又一次「在 A 能動不代表 B 能動」（與 t188 同源）。

## 更糟的是：我把錯誤假設寫成了測試
t181 附的「API Key 錯 → 401（租戶隔離）」只證明「符合我的假設」，
不證明假設是對的 ⇒ **綠燈把錯誤焊死**。
本次翻轉成守衛：「key 與實例 tenant 不同**也要能萃**」，
若有人再加回等值比對，該則會紅。

## 正解
照本 repo 既有慣例——這把 key 是租戶識別，不是共用密語
（webhooks-named.ts 用 owner_id: apiKey）。
本端點只用實例自己的 env.AI 生成、不寫任何資料、不回傳庫內內容
⇒ 有帶 key 即可。

測試：portal-admin 31 passed（含四則 extract 全過）；
唯一 failed 的 v-admin 為基準線既有（stash 對照確認），與本次無關。
 2026-08-04 20:39:40 +08:00
uncle6me-web a7d54751fb merge main：把 t176（拔雲端 LLM 下發）與 workers_ai_chat 種子併進 CIS 分支 
出貨前發現兩條分支各有一半：
  main                  → t176 拔掉雲端下發 extractor／刪 admin/extractor／workers_ai_chat 種子
  fix/cis-round3-portal → t181 新萃取端點 /portal/daemon/extract、CIS 視覺
**要合起來才是完整的出貨內容**（實測：合併前 bundle 仍含 admin/extractor ×2）。

原始碼三檔全自動合併；只有 portal-admin.test.ts 衝突——
HEAD 側是**過時的 t131/t122 測試**（測 main 已刪的端點，留著必紅），
main 側是刪除。解法：接受刪除、保留我這側的 t181 守衛。

測試 31 passed，唯一 failed 是基準線既有的 GET /portal 靜態資源案。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 15:33:43 +08:00
uncle6me-web 60f481938d t181 修正：/portal/daemon/extract 認證改用 X-Arcrun-API-Key（帳密行不通） 
【我自己的設計錯誤】前一版用帳密認證，但查證 daemon 實際行為後發現行不通：
**密碼只在連線精靈當下用過就丟、不落地**（config.json 沒有密碼欄，刻意的安全設計，
wiki 記為「密碼零落地」），而背景萃取是每輪自動跑的 ⇒ 根本拿不到密碼。

【改法】沿用 daemon 送卡片上雲時本來就帶的 `X-Arcrun-API-Key`（＝namespace，
collector/direct.go:355）⇒ 同一把憑證、同一個身份模型，不必為此新增任何儲存。
不符即 401（租戶隔離）。

測試四則全過（沒帶 key 401／key 錯 401／缺參數 400／
**回歸守衛：錯誤訊息不得出現 gemini_api_key 或 credential**）。
全檔 38 passed，唯一 failed 與 tsc 的 1190 行 'auto' 皆為基準線既有、與本次無關。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 14:37:16 +08:00
uncle6me-web d728071a6a t181：新增 POST /portal/daemon/extract——daemon 萃取走 Workers AI（免金鑰） 
【leo 08-04 列為最優先】「daemon 的 AI 改用 workers AI」
——「這是我的用戶**最大障礙**，造成首輪測試用戶的**好評或惡評**」。

【舊路徑的三種災難（實測）】要用戶自備 Gemini API Key ⇒
① 完全不知道去哪設定（台大資工碩士都卡住 ⇒ leo：「一般人就完蛋了」）
② 金鑰所屬 Google 帳號被 flag → 403 PERMISSION_DENIED，換專案也無效、申訴有死結
③ 52 檔全滅，還要把金鑰傳給總管實打才查得出真因

【修法】新端點收「已在本機轉成純文字的原稿」，用 env.AI binding 萃卡回傳
⇒ **完全不需要任何金鑰**，用的是用戶自己 CF 帳號內建的 AI，
他的 Google 帳號被封也不受影響。認證沿用 daemon/config 那把（帳密）。

為什麼放雲端：daemon 端沒有 AI binding（binding 是 Worker 專屬），
且模型選型集中在雲端才能統一換。
⚠️ 隱私邊界不變：送上來的是已轉文字的原稿、回傳知識卡，
原始檔案（docx/pdf）仍不出用戶電腦。

提示詞與 daemon 端 gemmaPrompt 同一份契約（第一行必須是「# <頁名>」），
兩邊要一起改。缺 AI binding 時回 501 並指名缺什麼（禁假綠）。

測試 4 則全過（含**回歸守衛：錯誤訊息不得出現 gemini_api_key/credential**
——若有人把它改回打 Google 會立刻紅）；全檔 38 passed，
唯一失敗是基準線既有的 GET /portal 靜態資源案，與本次無關。
tsc 對 portal.ts 零錯誤。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-04 14:10:00 +08:00
uncle6me-web 66f1b59f7f t176：雲端不再管地端 LLM 設定（leo 08-03 緊急） 
leo 回報四件事：①雲端 Gemini 無法用 ②搞不清楚設定 AI 是設雲端還是地端
③地端不會萃、每個人都死掉因為都去抓 Claude ④雲端還要設置明明就有 Workers AI。
目標：「雲端裝好就能用，地端輸一個 Gemini API Key，然後就開始用。」

根因：extractor_config 的 KV key 由 portalTenant() 組出，而 portalTenant 是
**worker 層級**環境變數（portal.ts:43）⇒ **全租戶共用一把**。任一處設了 claude，
所有人的 daemon 都收到 claude；沒裝 Claude Code 的機器萃取全滅，而 portal 的
Claude 勾選框又恆 disabled（daemon 從未實作 report-capabilities ⇒ daemon_caps 永遠空）
⇒ 用戶自己解不開（awindhon 08-03 實證：雲端同步成功、金鑰有效、零張卡）。

本次（雲端側）：
- POST /portal/daemon/config **不再下發** extractor／gemini_api_key／llm_model，
  只回連線欄位。⚠️ route 本身與 daemon/libraries 資料夾管理完全不動（leo 明確劃界：
  「雲端拉地端檔案夾部分不要刪，刪掉從雲端設置地端 LLM 選項部分」）。
- 移除 POST|GET /portal/admin/extractor（t122）——這是「雲端指定地端引擎」的入口，
  且無任何伺服器端驗證，打一下就能把全租戶設成 claude。
- 移除 POST /portal/daemon/report-capabilities（t131）——daemon 端從未實作該呼叫。
- 移除 t131 那組重複註冊的 /portal/admin/ai。**它是重複 route**：後段（arcrun-rag#10）
  另有同路徑一組，Hono 先到先比 ⇒ 舊的一直贏，後段修好的「金鑰真的寫進 credentials」
  形同死碼。保留後段那組（只管 Gemini 金鑰、走 storeCredential），並拿掉 Claude 偏好欄。
- portal 設定頁「AI 設定」整塊移除，改成一句話說明：雲端不需設定（Workers AI 免金鑰），
  地端請在同步小幫手的「AI 設定…」填 Gemini Key。順手清掉 main 上既有的 conflict 標記。
- 清掉隨之孤兒化的 helper（ExtractorConfig／AiConfig／DaemonCapabilities／
  syncExtractorFromAiConfig／readAiPref 等）。

測試：**相對 merge 前 main 基準線，新增失敗 = 0**（基準線本就 9 紅：console 藏書地圖 6／
portal HTML 殼 2／POST execute 1，皆與本次無關）。t122/t131 兩組測試改寫成
**回歸守衛**（斷言那些端點/欄位確實 404、確實不存在），不是刪掉充綠。
順手修 health bundle_version 測試與實作對齊（實作刻意省略該欄，測試卻期待空字串）。

未送達：本 commit 只到 code，尚未部署上線。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-03 22:11:45 +08:00
Leo 5b983c47b8 Merge branch 'main' into fix/merge-main-into-batch-t173 
# Conflicts:
#	console-ui/public/portal/index.html
#	cypher-executor/src/routes/health.ts
#	cypher-executor/src/routes/portal.ts
#	registry/components/kbdb_upsert_block/component.contract.yaml
#	registry/examples/km-wiki-ingest/workflow.yaml
 2026-08-02 23:43:16 +08:00
uncle6me-web 341bcb13c8 t160 測試跟上規格：人工建庫 POST → 404（庫只從 daemon 同步來） 
舊測試驗「POST 建庫 200＋重複 409」＝已刪端點的規格；vitest 回基線 9 failed/187 passed。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 14:57:22 +08:00
Leo e28e19069f t142: 雲端子庫顯示同步幾張卡＋幾個三元組（政府專案驗收需求） 
leo 07-29：「要在雲端子庫顯示同步了幾個 wiki，既然這樣也同步顯示有幾個三元組，
這是為了政府專案驗收。」

kbdb 兩支統計端點：
- entries.ts: COUNT(DISTINCT page_name) AS card_count
  ⚠️ 必須 distinct——算 block 數會膨脹 3-5 倍，政府驗收看到假數字比沒數字更糟
- records.ts: COUNT(*) AS triplet_count（三元組本來就算全部）
portal.ts 聚合兩者掛進庫目錄；前端 index.html 顯示。

驗：卡數確為 COUNT(DISTINCT page_name)／前端內嵌 JS node --check 全通過
（07-29 白畫面事故教訓）／portal-admin 測試 34 passed（改動前 31 passed，
唯一的 1 failed 是既有債：GET /portal 回 404，改動前後相同，非本次造成）。

註：此為子 CC 完成後未 commit 的懸置工作，總管收工檢查時發現並補收。
 2026-07-29 19:55:03 +08:00
uncle6me-web 9d38d580f2 feat(t131): AI 設定合併成一把金鑰——聊天與萃取共用，Claude 為選填加強 
leo：「拿到一把就很難了，還要拿兩把。一律規定先輸入 gemini api key，
如果想要強化本地萃取，可以選擇 claude……前面那個，聊天和萃都一次設好，後面那把，不填就是 gemini」
＋「重點是更好的模型萃取知識更能抓重點，不然他也不知道加強什麼」（文案講感覺得到的差別）
＋「本地如果有裝 claude，掃到，只要一個 checkbox 就好」（daemon 偵測回報，沒偵測到就停用選項）。
- POST/GET /portal/admin/ai（一次寫 chat-key 與 extractor）＋/portal/daemon/report-capabilities
- 舊 chat-key/extractor 端點保留相容；UI 兩區合併成「AI 設定」
t131 新測 7 條全綠（總體 229 passed／9 紅皆 pre-existing：HTML shell 搬遷×2、library-map 未實作×6、
executor 零件×1）。（實作＝子 CC；驗證+commit＝總管）
 2026-07-29 15:28:10 +08:00
uncle6me-web 0860e84d22 feat(t135): 庫目錄可自主移除＋標示還在不在同步 
leo：「需要加移除按鈕。因為別人裝錯我沒辦法幫他弄，需要可以自主」
＋「你應該要顯示這個庫沒有本地對應的 folder，那就不容易刪錯」
（兩態非三態——leo 二修：「分兩種沒意義」，那是內部狀態不是用戶分類）。
- DELETE /portal/admin/libraries/:id（登記簿）與 by-name/:name（auto 庫需輸入庫名確認）
- kbdb 加 deprecate-by-library（auto 庫移除＝標 deprecated，資料保留可還原）
- daemon/libraries 存 active 清單 → 卡片標 🟢同步中／灰目前沒有在同步
- 不自動刪（daemon 可能沒開機）；daemon 從未回報時整列不標
vitest 24 passed（1 紅＝console HTML 搬遷陳舊測試，非本案）。
（實作＝子 CC；驗證+commit＝總管。含 t116/t117 先前未 commit 的 graph-executor/wasi-shim 修正）
 2026-07-29 14:45:44 +08:00
uncle6me-web 6d4980d3d7 fix(t130 🔴🔴): PORTAL_TEMPLATE_SEEDS 補 triplet——新實例總圖不再永遠空 
真兇（總管探針定罪）：seeds 只有 portal_user/portal_library，寫三元組回 400
'template not found: triplet' ⇒ 每個新用戶（含封測者）總圖必空。
geek6688 有是舊實例早期流程建過＝拿它驗會假綠（已記 mistakes）。
呼叫路徑已驗：daemon/libraries、admin/libraries、init/seed 皆會 ensurePortalTemplates（冪等）。
vitest 24/24 綠（總管親跑）。（實作＝子 CC；驗證+commit＝總管）
 2026-07-29 14:35:36 +08:00
uncle6me-web eb9f2db513 feat(t122 🔴🔴): 萃取引擎雲端設定＋隨連線下發——封測者終於萃得出東西 
真兇（總管查證）：daemon/config 寫死 extractor='claude' 且不下發金鑰 ⇒ 封測者 100% 萃取失敗
（leo：「地端沒有 AI 根本不能萃，那它就不能玩」）。
- POST/GET /portal/admin/extractor（admin 閘；GET 只回 has_key 不回明文）
- daemon/config 改讀設定：未設定→gemma 無金鑰；設定後→含 gemini_api_key
- portal 設定頁加「萃取引擎」區（Gemini 推薦＋aistudio 連結，存後提示「小幫手點連上知識庫重連即可」）
測試 3 條新綠（vitest 17 passed；1 紅＝console HTML 搬遷陳舊測試，非本案）。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-29 13:21:26 +08:00
uncle6me-web 429b2d965f fix(t97+t114): 庫目錄只顯示用戶同步進來的庫、拿掉兩段式登記 
leo 07-28 原話：「用戶沒加上的庫，不要自作主張給它加上」／「掃進來的就是要進目錄…
加入目錄這件小事還要分兩段做？…這是在攻打用戶嗎？根本是 attack」。
- portal.ts:859 auto 段濾掉 general（系統未標庫桶，非用戶的庫）
- index.html：bootstrap 不再預埋 kb 庫；移除「登記到目錄」按鈕與 auto/registered 視覺分岔
驗證（總管 grep 真相源）：登記到目錄=0、kb 種子=0、general 濾在；
os-split 10/10＋safejson 8/8 綠；portal-admin 1 紅＝console HTML 搬遷陳舊測試
（stash 基線同紅，與本案無關）。（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 23:54:57 +08:00
Leo 52dbd31dea portal-auth P4（#24 #25）：admin 帳號＋庫管理頁＋last-admin 鎖死保護（不 merge，待總管審） (#53) 2026-07-14 08:54:41 +00:00