Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
349 Commits 27 Branches 0 Tags
fix/error-message-truth-92
Commit Graph

48 Commits

Author SHA1 Message Date
uncle6me-web d58a6e152d fix(portal): 安裝完成清單拿掉「去 Google 申請 AI 金鑰」那一項（arcrun-rag#81） 
leo 2026-08-12：「已經改用 workers AI，刪掉。」

那一項長在**安裝完成清單裡而且是勾選項** ⇒ 使用者會以為不做這步就沒裝完，
而它要人離開流程、去第三方網站申請帳號、把金鑰貼進表單
——**這是整條安裝路徑上最重的一個動作，而它現在是白做的**。

連帶：步數不再寫死「還差 2 步」，改成由剩下的項目算出來
（少一項卻還寫 2，是另一種說謊）。
 2026-08-12 14:44:38 +08:00
uncle6me-web a5e4caf5cb fix(portal): 讀不到就說讀不到——總圖不再把「讀不到」畫成「你沒有」（Arcrun#100） 
leo 2026-08-12 打開總圖看到：「0 個實體 · 0 條關聯／知識庫還沒有任何關聯——
上傳文件後 AI 會自動織網」。**而他庫裡有 1854 條三元組。**
那句話會叫他去做一件不需要做的事。

三個獨立的洞疊起來才變成那句謊：
  ① console-dashboard.ts 打 kbdb-graph-plugin 沒帶認證（同段落打 kbdb 的兩支都有帶）
  ② 那顆 worker 不在更新的部署清單裡 ⇒ token 一換它就落單
  ③ **畫面把 null 畫成 0**——後端已經誠實回 null 了，是前端把它變成謊話

為什麼一直沒被發現：graph plugin 原本身上沒有 token ⇒ 門開著 ⇒ 沒帶也進得去。
2026-08-12 輪替後它有了 token，門關上，401 才浮出來。

📍 repo：matrix/arcrun（cypher-executor/src/routes/、console-ui/public/）
📍 票：Leo/Arcrun#100
 2026-08-12 13:33:53 +08:00
Claude 9a29eb5af6 fix(portal): 瀏覽器實測抓到的兩個前端缺陷——連結被路由吃掉、.hide 從來沒有在藏東西 
兩個都是「HTTP 200 看不出來、真的開瀏覽器才會現形」的（規則五點五③）。

① `#/reset?token=…` 被路由正規化吃掉
   route() 的第一行是「raw 不在 VIEWS 就換成 HOME」，而 reset 不是站內的 view
   ⇒ 使用者點信裡的連結，網址被改寫成 `#/search`、修改密碼畫面根本沒出現，
     **而且 token 一起被丟掉**——連結一次有效，等於這條連結就這樣廢了。
   改：route() 開頭先看有沒有 reset token，有就走 showReset 並 return。
   （boot() 那條只顧得到「整頁重新載入」；hash 變動這條路以前沒人守。）

② `.hide` 一直只有三條有 scope 的規則（#tabbar .tab / #sidenav .nav / .modebtn）
   沒有通用的 `.hide { display:none }` ⇒ 任何其他元素掛上 class="hide" **完全沒被藏起來**，
   看起來有藏、其實沒藏。實測畫面：登入頁還沒按「忘記密碼」就已經露出 email 欄與「寄出連結」；
   連結模式下「現有密碼」那一格也照樣顯示（D62 的「差別只有一格」當場破功）。
   補通用規則，帶 !important 以蓋過 inline display（#forgot-box 有）。
   既有三種用法意圖一致（都是要藏），行為不變。

stage 瀏覽器實測（youlin，playwright）：忘記密碼 → 取連結 → 點進去 →
不輸入現有密碼設新密碼 → 自動回登入頁 → 用新密碼登入成功 → 進站 →
設定頁同一份表單（現有密碼那一格回來）改密碼 → **沒有被踢出去、可以繼續操作**。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R8vF2zS2XpaZjzkC75Fjss
 2026-08-10 13:51:41 +00:00
Claude 8d49d883c0 feat(portal): 改密碼與忘記密碼合成同一個機制，用連結不用一次性密碼（D62） 
leo 2026-08-10 拍板：「這兩個機制其實是一個機制，可以簡化。」
  修改密碼：輸入**現有的** → 輸入新的 → 覆蓋
  忘記密碼：收到**「修改密碼」連結** → **不輸入現有密碼（忽略）** → 輸入新的 → 覆蓋
⇒ 同一個畫面、同一條寫入路徑，差別只有「現有密碼」那一格。

後端（cypher-executor/src/routes/portal.ts）
- POST /portal/password/change ＝**那一支**。帶 reset_token 就走連結那一格（忽略 current），
  沒帶就要登入 ＋ 正確的 current。兩條路在 writeNewPassword 之後完全相同。
  /portal/me/password 保留成**別名轉呼同一支**（不留第二份實作，兩份必然漂移）。
- POST /portal/password/forgot（公開）／GET /portal/password/reset（看票，不消耗）
- 連結的安全性（承 D50，不可退讓）：**一次有效**（用掉即刪，先刪再回）、
  **會過期**（KV TTL 30 分鐘）、**與註冊辨識碼不同源**（現場 crypto 亂數，
  只活在本實例 SESSIONS_KV，與 landing SIGNUPS 那組安裝辨識碼毫無關係）。
  KV 存的是 token 的 sha256，不是 token 本身。
- 🔴 不做一次性密碼（leo：「不要發一次性密碼太麻煩」）。
- 🔴 已否決不准寫回來的三條（D50）：console 密碼救援／重裝重設密碼／直接用固定辨識碼。

中央代寄（arcrun-rag landing 那半在該 repo）
leo 給的職責切法：實例產生連結、管一次性/過期；arcrun.dev 只是郵差。
必須這樣切的硬理由：用戶自己的實例**沒有 send_email binding**，根本寄不了信。
🔴 總管紅線：**絕不把整條 URL 交給郵差**——寄件網域帶 DKIM，肯收「任意 URL＋任意 email」
就是一台開放的釣魚中繼，燒的是整個網域信譽、不可逆。
故只交出本實例 origin ＋ 一張回呼票，並新增 POST /portal/password/relay-verify：
郵差**回頭打這個 origin** 問「這張票是你發的嗎」，冒用別人網域會被那台實例自己否認
⇒ 主機屬於呼叫方這件事由郵差親自確認，不是相信宣稱。
信裡的連結落點 GET /portal/password/reset-link（主機刻意＝被確認過的那個 origin）。

前端（console-ui/public/portal/index.html）
- 登入頁「忘記密碼」入口，**在 portal 不在 console**（leo：「是對 portal 不是對 console，
  這樣 youlin 雖然忘記，我還是可以去 portal 忘記密碼。」）
- 拆掉登入頁原有的「用管理主控台密碼救援自己」連結與「忘記密碼請聯絡管理員」
  ——兩條都是 D50 已否決的做法（console 與 portal 是同一組帳密的兩個鑰匙孔）。
- #v-reset 殼**沒有自己的密碼欄位**：真正的表單是設定頁那唯一一份 #pw-form，
  進入連結模式時被原封不動搬過去，只切換「現有密碼」那一格顯不顯示。
  同一個表單元素、同一支送出函式 —— D62「同一個畫面」的字面落地。

驗證：tsc 與 baseline 同為 23 個既有錯誤（零新增）；27/27 既有測試綠；前端 JS node --check 過。
stage 實測見交付回報。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R8vF2zS2XpaZjzkC75Fjss
 2026-08-10 13:23:44 +00:00
Claude 417d69ceb3 fix(portal): 傳播空窗期不再銷毀 session——讀不到 ≠ 這個人不存在（arcrun-rag#66） 
leo 2026-08-10 在 youlin stage 改完密碼被登出，之後怎麼登都回不去。
病灶是「這一瞬間讀不到」被當成「這個人不存在」，而且做的是**不可逆**的動作。

認證的家是 CF Workers Secret，改它會產生 worker 新版本，既有 isolate 讀到的
還是舊 env（#55 實測 ≥15 秒）。舊的 requirePortalUser 在那個空窗裡直接把
session 從 KV 刪掉——不是擋下讓你重試，是當場銷毀，等 secret 鋪開也回不來。
#55 補的「讀不到就再問一次加速器」只加在登入路徑（findAndVerifyUser），這道門沒有。

三處修法（缺一不可）：

1. requirePortalUser 先問一次加速器再判定（與登入路徑同一招、同一支函式）
2. **永不因「讀不到」刪 session**；仍讀不到且正在傳播空窗 → 回 503
   `auth_store_propagating` 而不是 401（讀得到 record 的「已停用」照舊刪，那是確定的事實）
3. 前端 boot() 從「任何非 2xx 都 dropSession」收斂成**只有 401 才算被登出**
   ——後端不刪、前端卻自己丟掉 localStorage 的 token，症狀一模一樣

順帶修掉同一族的一個資料遺失路徑：mutateAuthStore 舊版拿「可能是舊版 env」當底稿做
read-modify-write，而 writeAuthStore 會重切分片並刪掉多出來的舊分片 ⇒ 底稿若是
「某帳號被建立之前」的版本，那個帳號會在這次寫入中被抹掉且無法還原（secret 是唯一真相源）。
改成先問加速器、再把 env 版與 overlay 版取聯集當底稿；刪除仍有效（fn() 在聯集之後才跑）。

驗證：tsc 與 baseline 同為 23 個既有錯誤（零新增）；tests/portal-auth.test.ts 27/27 綠。
stage 實測見交付回報。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R8vF2zS2XpaZjzkC75Fjss
 2026-08-10 13:22:34 +00:00
uncle6me-web 19c82df05f fix(portal): 管理員忘記密碼自救援出口（arcrun-rag#25） 
唯一 admin 忘記 portal 密碼就永久卡死：requirePortalAdmin 系列端點全部要
先有 portal session 才進得去，bootstrap 又只能跑一次——登入頁只會叫他
「聯絡管理員」，而他自己就是管理員，沒有下一步。

新增 POST /portal/admin/recover-password，複用 bootstrap 已在用的 console
owner session 當人閘（與 portal 密碼完全獨立存放的另一組帳密）。畫面入口：
/console → 設定 → 「Portal 帳號密碼救援」；/portal 登入頁加一行連結指過去。

本機真瀏覽器 E2E 驗證（wrangler dev 18787/18788 + 本機靜態伺服，真的走一輪
forgot-password 狀態）：first-time setup 建帳號 → 故意打錯密碼確認鎖死
（email 或密碼錯誤）→ 點連結進 /console → 用 console 密碼登入 → 設定頁輸入
portal email → 產生新密碼 BPq2Rs4p7dBWMd6d → 回 /portal 用新密碼登入成功。

cypher-executor 4 個新測試 + 既有 59/60 綠（唯一失敗是既有 pre-existing
/portal HTML 殼 404，與本次無關，git stash 驗證過）。
 2026-08-09 15:06:17 +08:00
uncle6me-web 23d36b311a portal 設定頁補顯示 MCP 連接網址（arcrun-rag#7） 
封測者原話：「說明叫我把 MCP 加進 claude.ai connector，但我找不到網址」。文件一直寫
「登入 portal → 設定頁，那裡可以直接複製」，但畫面上從沒真的顯示過（grep 0 命中），
用戶照文件走一定撲空。

設定頁新增「接上你的 AI（MCP）」面板：純前端把 apiBase 的 worker 名字從
arcrun-cypher-executor 換成 arcrun-mcp（同一顆自架帳號 workers.dev 子網域，對齊
cli/src/lib/deploy.ts:386-392 部署時的組法），不符形狀就誠實顯示「尚未偵測到」，
不亂猜連不到的網址。複製按鈕從既有 copyOriginUrl 拆出共用 copyText(btn, url)。

端到端本機瀏覽器實測：真 wrangler dev（kbdb+cypher-executor local D1）+ 真登入流程
（console setup → bootstrap admin → portal login）走到設定頁，面板正確顯示/隱藏；
用貼近真實自架形狀的假網址驗算，結果與 deploy.ts 的組法逐字相同；複製鈕點擊行為與
既有、未改動的 st-copy-url 按鈕在同一自動化環境下一致（clipboard-write 是瀏覽器自動化
環境限制，非本次改動的迴歸）。詳細記錄見 system-dev/docs/3-specs/portal-auth/tasks.md t218。

未部署（紅線：只 commit+push，未動任何 Cloudflare 實例）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-09 14:23:56 +08:00
uncle6me-web 889b70b8f9 feat(portal): 執行紀錄保留期 UI（P7 補前端，arcrun-rag#21） 
後端（4ca23c2）已提供 GET/PUT /portal/admin/execution-log-retention，
但管理頁完全沒有對應介面——leo 只能自己 curl。本次補管理頁「執行紀錄保留期」
卡片：顯示目前保留天數、可改天數、可勾「不刪除」（企業稽核）。純薄殼，
零業務邏輯，呼叫既有端點（rule 07 薄殼原則）。

驗證（本機真瀏覽器 E2E，非 curl／非讀原始碼）：
本機起兩個真 wrangler dev（kbdb:18787／cypher-executor:18788，local D1+KV，
真的套用 migrations 0001-0006）＋本機靜態伺服 console-ui/public（18790，
config.js 指向本機 apiBase）＋UI_ORIGINS 加白名單解 CORS。瀏覽器走真實
「首次設定」流程建帳號、登入、進管理頁：
- 預設值：保留天數顯示 90（無資料時退回預設，非空白）
- 改 45 天 → 儲存 → 畫面即時更新「目前設定：保留 45 天」→ reload 頁面仍是 45
- 勾「不刪除」→ 儲存 → 天數輸入框停用、清空 → 顯示「不刪除（企業稽核）」
  → reload 仍是不刪除
- 改回 90 天 → 儲存 → reload 仍是 90（雙向都驗過）
- 全程 Network 面板每筆 GET/PUT 皆 200；console 除了測試前置階段的舊
  bootstrap-conflict 雜訊外，無新增紅字

發現但沒動的問題：console-ui 本身沒有本機可跑的 dev/test 腳本
（package.json 只有 deploy/verify），E2E 用的是手工起 wrangler dev +
python http.server 兜出來的，建議之後補一支 `npm run preview:local`
方便下次驗證不用重找路。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-09 13:28:36 +08:00
uncle6me-web 6846d6ddae fix(semantic): 故障照實說是故障——不再把壞掉說成「沒開通」（leo 2026-08-09 直令） 
一、文案（portal/console/kbdb hint）：語意搜尋是一安裝就提供的功能，
   降級＝故障。橫幅改「語意搜尋目前故障／我們的問題／你不用做任何事」，
   拿掉「還沒開通、想開通請匯出診斷檔」這種要使用者申請開通的假框架。
   kbdb 降級回應加 degraded_reason（module_off / embed_query_failed）。

二、查詢向量化失敗不再偽裝成空結果（leo 點名的謊）：
   semanticSearch 舊行為「AI 額度用完 → 回 []」會讓使用者以為
   自己的知識庫裡沒有這筆資料。改丟 EmbedQueryFailedError，
   route 誠實降級 keyword＋照實告知是暫時故障。

三、源頭機制（裝好的實例為什麼會失去語意搜尋）：
   - acr update：kbdb_embed 判斷 ===true → !==false。config 缺欄位時
     redeploy 會把 [[vectorize]]+[ai] binding 靜默剝掉（wrangler deploy
     整份覆蓋），一台正常實例就此壞掉。init 預設同步翻成 [Y/n]。
   -（另 repo）deploy-all.mjs ensureVectorizeIndex 失敗改致命中止。

四、順手自癒：孤兒向量/下架殘影搜尋時背景清除；空結果且 pending>0
   背景 backfill；no_index 拆「故障」vs「還沒有資料」兩態。

測試：kbdb 146/146（新增 degraded 6 案＋selftest 1 案）；cli 10/10；
瀏覽器端到端兩種故障畫面實測（local wrangler dev＋portal 真登入）。
無 SDD 對應：leo 直令修故障（同 08-07 檢修孔前例的人閘直接授權路徑）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-09 02:05:12 +08:00
uncle6me-web 831cb62d2e feat(portal): 拔掉雲端「疑難排解」匯出按鈕，改導向本機小幫手（t213 收尾） 
leo 08-08：「雲端那個要刪掉？不刪用戶搞不清楚要去哪裏下載」；08-09 追認「通知
完畢可以刪除」——封測者已被通知去更新到有地端匯出的版本（arcrun-app「版本與
更新」頁的疑難排解卡，見 products/arcrun-rag commit 9f1ca58 起），放行條件已滿足。

三處改動：
1. 設定頁「疑難排解」面板：移除 #st-diag-export 按鈕與 #st-diag-status，
   改成純文字指路到電腦上的 Arcrun App。
2. 對應的前端 JS 點擊處理（打 GET /portal/data/diagnostics 的那段 IIFE）整段刪除
   ——按鈕已不存在，留著是死代碼。
3. 語意搜尋降級橫幅（se-banner）：原本也教用戶「到設定→疑難排解匯出診斷檔」，
   同步改成指向本機小幫手，否則使用者會照著走進一個不存在的按鈕。

GET /portal/data/diagnostics 端點本身未刪（無害、已無任何 UI 呼叫），純粹清路標
不動後端；已知例外——同步小幫手完全連不上、且封測者是老版本沒有本機匯出時，
會真的無路可走，判斷為可接受（他們已被個別通知升級，且雲端 portal 仍能用文字
指路，不是把人晾在原地不給說明）。

驗證：本機起 static server（config.js 指向 dummy apiBase）＋瀏覽器 JS 強制顯示
setting/search view，實際截圖確認按鈕消失、#st-diag-export/#st-diag-status 在
DOM 裡是 null、文案渲染正確無破版；console 只有 dummy apiBase 連不上的預期錯誤，
無語法/參照錯誤。cypher-executor vitest（portal-data/admin/auth）114 通過、2 個
既有失敗（HTML 殼 404，改動前後一致，非本次影響——用 git stash 前後對照過）。

未部署（紅線：本輪只到本機驗過＋commit＋push gitea，prod 需 leo 開閘）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-09 01:09:10 +08:00
uncle6me-web 42cb1d7aa9 console-ui：把「線上跑的是不是當代的」變成機械判準，並接進部署鏈 
leo 2026-08-08：「已經發生過一次這個錯誤，把舊版界面上到 prod，
你要確定不可再犯。」

實測（repo 對線上，純文字資產比對）：
  repo   portal/index.html  343,969 bytes
  線上   mira.uncle6.me      82,911 bytes（Songti 12 處，舊金色 serif 品牌）
  線上   pages.dev           82,911 bytes（同上）
而 e730b3f 那版 verify-live 對這兩站**三項檢查全過**——因為它驗的是
組態（apiBase、profile 的 views/home），不是世代。
⇒ 一個網址可以組態完全正確、卻對外展示一套早就被淘汰的介面，
  而所有機械檢查都說它是綠的。這就是要消滅的狀態。

本次落地：

一、世代指紋（targets.mjs）
  逐一取線上／產物的資產（index / portal / console / favicon.svg），
  遮掉本來就該隨部署目標不同的那兩行（VIEWS/HOME），其餘按位元組比對。
  刻意不用關鍵字清單——清單要人維護，而舊世代能無聲上線正是因為沒人記得維護它。
  誠實 trade-off 寫在檔內：repo 改了沒部署就會判紅，那是正確的（那時線上確實不當代）。

二、宣告值真的寫進產物（收掉 e730b3f 標的 WIP）
  deploy.mjs 改為由 targets.mjs 產出 .staging/<目標> 再推：
  config.js 由宣告值即時產生、console 的 VIEWS/HOME 依 profile 覆寫，
  **覆寫沒命中就中止部署**；推之前回頭讀磁碟上那份驗一次（不看腳本印了什麼）。
  public/config.js 刪除——它是產物不是原始碼。

三、修好一道從 08-03 起就在誤判的閘
  t160 的世代閘比對 portal 全文含「登記新庫」即拒部，而 66f1b59（08-03）
  加了一則**說明「已經把它拿掉了」的 HTML 註解** ⇒ 該閘自那天起每次誤判，
  npm run deploy:personal 連續五天推不出去。改成剝掉註解後只看可見內容，
  並降級為輔助（主判準是指紋）。這正是「手工關鍵字閘會腐爛」的實例。

四、讓它在該跑的時候真的被跑到（不再生出沒人記得執行的腳本）
  · deploy.mjs 推完自動回頭驗線上，不過就算本次部署失敗
  · .deploy-state.json 只在線上實測通過後才寫，且不進版控
    （新 checkout 沒紀錄＝狀態未知＝該被提醒，而不是繼承別人的綠燈）
  · Stop hook 每回合離線比對「手上這一代 vs 最後一次驗過的部署」，
    在要說「做完了」的那一刻出聲（實測 0.096s，不連網）

五、uncle6 邊界寫進工具本身（leo 08-08：「要看範例只在 youlin 網站，不要去碰 uncle6」）
  deploy.targets.json 的 enterprise 標 frozen：deploy 拒絕部署、verify 連抓都不抓。
  目標本身保留不刪——刪掉就變成下一個 AI 眼中「從來沒有過這個站」的失憶。
  同源清掉兩處還活著的舊記錄：README 的線上 demo 連結、public/index.html 的註解。

驗收證據見 commit 後的實測輸出（舊世代樣本取自 git 歷史 ad367e4，本機起站餵判準，
未碰任何線上資源）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 20:36:18 +08:00
uncle6me-web e730b3f831 console-ui 部署：宣告值只解讀一次，並補上線上實況驗證（WIP） 
同源於 2026-08-08 的 apiBase 事故：部署腳本把 apiBase/profile 印在
終端機上，卻沒有寫進推上去的產物 ⇒ 印對的、推錯的。

根因比想像深：deploy.targets.json 原本靠 build.mjs 在 build 期把
profile/apiBase 烤進產物，但 t160（e744ad1）清世代債時把 build.mjs
整支刪掉改成直接託管 public/，沒有人接手「把宣告值寫進產物」這件事
⇒ 前兩次事故的解等於被還原，只剩下「印出來給人看」。

本次落地：
- targets.mjs：宣告值的唯一讀取點，把「一個目標展開成期望的產物長相」
  定死成函式，供部署／驗證共用同一個答案，杜絕三邊各自解讀而漂移。
  缺 apiBase／accountId／verifyUrls／未定義的 profile 一律拒絕部署。
- verify-live.mjs：獨立可跑，驗「線上網址真的在用的組態」＝「宣告值」。
- deploy.targets.json：補 _profiles（profile → views/home）與 verifyUrls。

WIP：deploy.mjs 尚未改接 targets.mjs，public/config.js 尚未退役。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 20:14:20 +08:00
uncle6me-web 84471659af docs(portal): 疑難排解按鈕文案改導流（t213，InkStoneCo 總管交辦） 
這顆按鈕在封測者瀏覽器裡執行，構不到他電腦上 daemon 的本機資料（檔案總量／
失敗分類／daemon 版本）——那半已改在 arcrun-app 本機端匯出（見
products/arcrun-rag commit 9f1ca58）。按鈕本身保留當退路（daemon 完全掛掉時
唯一還按得到的東西），文案改成誠實講清楚自己只有一半、導去完整版，照總管
給的原話：「這裡只看得到雲端這半，完整診斷請到你電腦上的 Arcrun 匯出。」

純文案改動，未動任何邏輯/端點；跑過 portal-data/portal-admin/portal-auth
三份測試，114 通過、2 個既有失敗（HTML 殼 404，測試環境問題，與本次無關，
改動前後一致）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 13:13:06 +08:00
uncle6me-web 962d863ef7 fix(kbdb): 藏書地圖 M3 收尾——讀端自動核對重算，不再依賴 ingest 接鏈 
真因（總管實測，system-dev/wiki/mistakes.md 08-08 段）：design 原訂「ingest 尾端呼
POST /map/recompute」，但 repo 內查無任何呼叫點，三週沒接上，沒手動 backfill 過的租戶
（絕大多數）GET /map 恆回空；MCP 說明文字還宣稱「地圖由 ingest 尾端自動重算（M3）」——假話。

leo 否決「降級成即時聚合、不維護快取」的提案（會丟失 narrative 這類摘要本體，只算得出
count）。改法：GET /map／GET /map/:library 讀端自己核對即時三元組數，落差就地呼叫既有的
recomputeLibraryMap 補算（kbdb/src/actions/library-map.ts ensureFreshLibraryMaps）。聚合
SQL 沒有第二套、narrative/relation_profile/bridges 摘要欄位原封不動，只是觸發時機從「等
外部呼叫」改成「讀的當下順手核對」。同時解掉：全租戶自動 backfill／跟得上新資料／不依賴
跨 repo 的 ingest 接鏈。

附帶修 recomputeLibraryMap 的 narrative 欄位：沒帶值時原本會清空，改成沿用上一版（避免
自動重算把 ingest 端/人工填過的 narrative 靜默洗掉）。

修正三處說謊的說明文字（mcp/src/tools/kbdb_map.ts、console-ui console/index.html）：
「地圖由 ingest 尾端自動重算（M3）」不存在，改為誠實描述讀端即時核對機制；404 語意從
「從未 recompute」改為「查無此庫」（已知但空的庫現在會自動補成 triplet_count:0 的 200，
不會落到 404）。

測試：kbdb 新增 6 案（18/18 全綠，覆蓋自動 backfill／跟得上資料／narrative 保留／
404 vs 空庫誠實分辨／owner 隔離／無 triplet template 不報錯）；mcp 新增 1 案釘住舊謊言
不再出現。kbdb 125/125、mcp 69/77（同基線 8 個 oauth 既有失敗，非本次引入）全綠；
tsc 兩包乾淨（kbdb 1 個既有 auth.test.ts 錯誤與 stash 前一致，非本次引入）。

SDD：system-dev/docs/3-specs/library-map/tasks.md M3 從「07-19 誤標 ✅」更正為實況；
design.md §3 加 2026-08-08 更正說明。未動 frontmatter status（仍 draft，D35 生命週期
鐵律留給總管/leo 裁）。

殘項：本次修改只在本機驗證（真 SQLite + 假 binding 單元測試），未部署 prod；未在真實
KBDB（如 yuga3bse 租戶）重新實測 kbdb_get_map 非空——需部署後才能貼實測輸出。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-08 00:44:55 +08:00
uncle6me-web ac4fb56c91 portal 前端文案：語意搜尋降級提示改講人話＋entry_type/mode 不再吐原始英文值 
封測者 Oscar 回報「語義搜尋搜不到」，追查發現 portal 使用者實際會看到的降級提示
其實是後端 kbdb capability_hint 直接透傳（寫給工程師看的：「叫 CC」「vectorize」
「kbdb_embed:true」「redeploy」），比 UI 裡原本的 fallback 文案還難懂。

- se-banner：不再透傳後端 capability_hint，前端固定顯示「發生了什麼＋現在怎麼辦」
  （語意搜尋還沒開通→以下是關鍵字結果→到設定頁疑難排解匯出診斷檔給我們）
- 新增 entryTypeLabel()：entry_type 原始值（wiki_card/block/execution_log…）
  不再直接印給用戶看——尤其 wiki_card 原樣顯示會打臉上傳頁自己講的「AI 整理後
  會以 wiki 卡形式出現」
- 新增 searchModeLabel()：搜尋結果「模式 keyword/semantic」的英文值改顯示
  中文（關鍵字/語意/圖譜），AI 問答來源標籤同步套用

不動 console/index.html（僅供部署擁有者/維運者使用，非客戶介面，根目錄
index.html 明文寫「不該對客戶露出」，同類字眼在此屬合理專業詞彙，故不改）。
不動 cypher-executor/src、kbdb/src（另一 agent 正在改 credential 路徑；
真正的降級文案根因在 kbdb/src/routes/entries.ts 的 capability_hint，
已另行回報總管，非本次改動範圍）。

已用 installer/scripts/build-ui-bundle.mjs 打包驗證：新文案進 bundle、
舊文案消失，entryTypeLabel/searchModeLabel 均實際生效（非死代碼）。
 2026-08-07 22:38:07 +08:00
uncle6me-web 5388f40c03 feat(portal-ui): 設定頁「匯出診斷檔給我們看」按鈕（檢修孔前端，2026-08-07） 
leo 直接指令的簡化版規格：一顆按鈕、按下去下載一個檔案、用戶自己把檔案傳出去——
同意天然內建在「他自己按、自己傳」這個動作裡，不需要額外授權流程或內部概念外露。

按鈕打 GET /portal/data/diagnostics，把回應存成單一 JSON 檔（不是要解壓的一包）
直接觸發瀏覽器下載，檔名帶時間戳。沿用既有 authHeaders/safeJson/guard401/friendlyErr
helper（與同頁其餘按鈕同一套錯誤處理慣例）。

既有前端輕量測試（safejson.test.mjs／os-split.test.mjs）跑過，18/18 全綠，未受影響。
 2026-08-07 18:39:30 +08:00
uncle6me-web 36a5630c63 portal 顯示同步器版本＋下載網址改讀真相源（leo 08-06） 
leo：「Portal 和 rag.arcrun.dev 應該顯示同步器的版本⋯⋯因為你說最新 0.18.5
連我都沒辦法確認，所以用戶到底是否最新版他自己也不知道」。

## 病
release（雲端知識庫）與 daemon（桌面同步器）是兩條版本線。
版本卡只顯示前者；下載按鈕的檔名是寫死的固定別名
（DAEMON_MAC/DAEMON_WIN）⇒ 頁面上完全看不出「同步器是哪一版」。

## 改
- 下載網址改向 /api/latest 取 daemon.downloads（真相源＝bundles manifest），
  取不到才退回原本的固定別名 ⇒ 按鈕永遠可用。
  ⚠️ 沒有違背 fe0ee82 立的「不要每出一版就改 code」——網址是取來的，
     一樣不必改 code；還順便解掉固定別名的兩個老問題：
     ① 別名指向 @main 會吃 CDN/ref 快取拿到舊檔（08-04 撞過）
     ② 檔名不帶版號 ⇒ 無從顯示「這是哪一版」＝leo 這次抱怨的正題
- 版本卡下方加一行「最新的同步器版本是 X（你手上那支在同步器視窗左下角）」
  ＋連到版本說明頁。取不到就**不顯示**，不編數字。
- 渲染改成「先用退路畫、取到真相源再重畫」，renderDaemonDownload 做成可重複呼叫
  （清掉上一輪插入的節點，否則會疊出兩份「不是這個系統？」）。

## 驗
· node --test os-split.test.mjs safejson.test.mjs → 8 passed, 0 failed
· index.html 三個 script 區塊逐塊 node --check → 全部語法 OK
· 未驗：線上畫面（要等 bundle 出貨後才有 daemon 欄位可讀）⇒ ◐
 2026-08-06 13:12:15 +08:00
uncle6me-web 0ff369f818 修語意搜尋全 0 命中：分數門檻沒跟著 bge-m3 換代（換模型漏掉的第五處） 
leo 2026-08-05 實撞：「新上傳的『loop-engine-north-star.md』語義 0 命中，
但舊的『人力媒合系統規劃書』語義 2 命中」。

## 根因不在向量——向量是好的
直打 Vectorize 實測（youlin 實例、bge-m3、1024 維 index）：
  搜「閉環機」→ loop-engine-north-star.md 穩坐第 1-4 名（0.638/0.603/0.588/0.552）
D1 與 Vectorize 也對得上：659 筆 embeddable 全 is_embedded=1、index vectorCount 659。

真兇是 **min_score 門檻綁在舊模型的分數尺度上**：
  舊 bge-base-en-v1.5：中文分數全擠 0.65-0.90（沒區辨力）⇒ t183 取 0.75 砍雜訊，對
  新 bge-m3          ：尺度整體下移（相關 0.5-0.85、雜訊 0.4 上下）⇒ 0.75 砍掉的是正解
leo 看到的「舊檔中、新檔不中」由此而來——「人力媒合系統規劃書」拿 0.842 僥倖存活，
其餘全被門檻掃掉。08-05 換 bge-m3 的「四處同步」清單（embed.ts／deploy.ts／
deploy-all.mjs／worker.js）**漏了這第五處**，因為它不在 kbdb 而在 portal 呼叫端。

## 改動
· kbdb/src/embed.ts：新增 DEFAULT_MIN_SCORE=0.5，**緊鄰 DEFAULT_EMBED_MODEL**
    ——門檻是模型的性質，放模型旁邊，下次換模型的人一定會看到
· cypher-executor/src/routes/portal-data.ts：拿掉硬寫的 0.75，
    只在使用者顯式指定時才傳 min_score（不再各自持有一份數字＝不再漂移）
· console-ui/public/portal/os-split.test.mjs：修好被今天 fe0ee82 弄壞的自測
    （結尾標記寫死文案 ⇒ 改文案就炸「抽不到函式區塊」；改成錨定結構）
    ＋斷言同步改成 Mac 給 DMG

## 0.5 怎麼來的（實測分布，不是猜的）
「閉環機」            0.638/0.603/0.588/0.552 全是目標檔 ── 斷崖 ── 0.446 才是雜訊
「火星座標 奧林帕斯山」 0.750…0.500 全對，0.475 以下才是雜訊
「人力媒合系統規劃書」   0.842 對，0.550 起是雜訊
誠實 trade-off：0.5 非每個查詢都乾淨（「AI 上課名冊」0.658 的 ax-academy 會擠進來），
但「偶有雜訊」遠優於現況「什麼都搜不到」。

## 驗
· kbdb 87/87 綠（三筆斷言隨新契約更新：預設不再是「不過濾」）
· cypher-executor 9 failed/301 passed＝**與改動前逐數相同**（git stash 前後各跑一次）⇒ 既有債
· portal os-split 自測 10/10 綠

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-05 18:00:43 +08:00
uncle6me-web fe0ee8296a portal 下載 Mac 版改給 DMG（拖進 Applications），不再給 zip 
leo 2026-08-05：「Mac 強調要包裝成 application + dmg 的格式，拖進去就會放到
application，**解決之前直接在下載資料夾啟動造成更新問題**」

## 病（實查證實）
manifest 已有 mac_dmg 欄，DMG 也上傳了，**但 portal 下載按鈕仍指 zip**：
  DAEMON_MAC = 'ArcrunRAG-mac-unsigned.zip'
用戶端實抓該 zip → 解開就是 Arcrun.app ⇒ 很可能直接在「下載」資料夾雙擊啟動，
正是 t184（Oscar）那個「更新完又跳回舊版」的病灶。

## 修
· DAEMON_MAC → 'ArcrunRAG-mac.dmg'（**固定檔名**，否則每出一版都要改 code）
· Mac 安裝提示改成 DMG 的步驟：「開啟後把 Arcrun 拖進『應用程式』，再從啟動台開啟」
  （zip 版的話術是「右鍵→打開」，步驟不同不能沿用）

## 說明：App 端的更新邏輯本來就修好了
selfupdate.go 已改成更新「正在跑的那個 .app」（runningAppBundlePath），不寫死
/Applications ⇒ 放哪都更新得了。本次補的是**入口**：讓使用者一開始就放對位置。

## ⚠️ 殘項（未送達）
bundles repo 目前**只有帶版號的 DMG**（ArcrunRAG-v0.18.4.dmg），
**沒有固定檔名 ArcrunRAG-mac.dmg**（實測 404）⇒ 這行改動要等出貨時
一併產生固定檔名副本才會生效。出貨需 D20 開閘。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-05 16:35:02 +08:00
uncle6me-web 3d21bf0725 移植 t21 溯源 scheme 相容：kb:// 不造死鏈（救自已刪分支） 
## 這條與 t195 直接相關
新 ingest 鏈（rag_ingest_card／rag_ingest_direct，就是我今天在修的收卡鏈）
寫的 metadata.source 是 **kb://<path>**，但 main 的 portal 溯源只認 gitea://
⇒ 卡片上傳成功後，**溯源連結一律失效**。

原修補在 fix/portal-source-scheme-t21（07-24），一個月沒併回 main。
該分支的檔案 console-ui/src/portal-ui.ts 已被重構搬走（UI 搬 CF Pages），
⇒ 不能直接 merge，**移植邏輯到現行的 console-ui/public/portal/index.html**。

## 三種 scheme 的正解（照原分支設計）
· gitea://<path>          舊 rag_ingest v2 → {base}/<path>，行為一字不變（不回歸）
· gitea:<org/repo>@<path> km-wiki-ingest 實形 → {base}/<org/repo>/src/branch/main/<path>
· kb://<path>             新 ingest 鏈實形 → **回空字串＝維持純文字，不造死鏈**
  （雲端沒有對應網頁；另給 srcLocalPath() 取本地相對路徑顯示）

## 實測四情境（抽出函式跑 node）
gitea://docs/a b.md#3        → https://…/base/docs/a%20b.md          ✅ 錨點捨棄+編碼
gitea:Leo/kb@notes/x.md#seg01 → https://…/base/Leo/kb/src/branch/main/notes/x.md ✅
kb://wiki/cards/policy.md    →                                     ✅ 不造死鏈
srcLocalPath(kb://…#seg02)   → wiki/cards/policy.md                  ✅

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-05 13:38:19 +08:00
uncle6me-web 6c5706ba7d 補上合併漏收的修改檔（t189/t181/CIS portal 本體） 
上一筆 5d78806 我只 add 了新增檔（favicon 三件套），四個修改檔沒收進去
⇒ 合併內容只推了一半，t189 的 tenant 比對修復其實還躺在工作區。

本次補上（實測與已刪分支 HEAD 23f2fd4 逐檔相同）：
· cypher-executor/src/routes/portal.ts      +81（t181 /portal/daemon/extract、t189 tenant）
· cypher-executor/src/routes/portal-data.ts +21
· console-ui/public/portal/index.html      +169（CIS 視覺、版本卡）
· cypher-executor/tests/portal-admin.test.ts +45

教訓：merge --no-commit 後要 git add -A，不能只 add status 裡看到的第一類。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-05 13:31:57 +08:00
uncle6me-web 5d78806806 併 fix/cis-round3-portal 進 main：CIS 視覺＋t181/t183/t189 收口 
## 為什麼現在併
leo 2026-08-05：「完工、下班，都要把所有東西整理乾淨，沒推的要推、沒合併要合併」
「至少在 gitea，我不要看到還有沒處理的 PR 或分支」。

這條是 arcrun 的**現役工作分支**（領先 main 15 筆、只落後 3 筆），
含的都是已驗過的東西：
· CIS 第三輪：portal 換色票／真向量 wordmark／favicon 三件套／裁淨版 lockup
· 底色與字形對齊 landing（Paper #FDFCFB／Canvas #F2F1ED，9 處明體→無襯線）
· portal 設定頁版本卡（落後紅點＋一鍵更新，t154 免辨識碼）
· t176 套到 CIS 版 portal（刪 AI 設定區塊）
· t181：POST /portal/daemon/extract——daemon 萃取走 Workers AI（免金鑰）
· t183：語意搜尋補 min_score=0.75
· t189：/portal/daemon/extract 拿掉 tenant 等值比對（geek6688 萃取永遠 401）
· 移除誤入版控的 cypher-executor/node_modules 自指 symlink

落後的 3 筆＝剛併進 main 的 PR#22（純文件）⇒ 自動合併零衝突。

## 測試對帳（合併前後比對，非只看合併後）
合併後：Test Files 4 failed | 22 passed；Tests 9 failed | 301 passed
合併前（純 main 同樣跑一次）：Test Files 4 failed | 22 passed
⇒ **9 fail 是既有債，非本次合併造成**（與 D36 那次 commit 記載的既有債一致）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-05 13:29:15 +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 36cdc8fba6 #10 補測試守衛＋console 兩頁同族 fallback 一併拔 
① tests/portal-admin-ai.test.ts（6 項綠）＝**route 消失就會紅**的迴歸防線。
   這條 route 以前不存在、前端卻一直在打它 ⇒ key 從來沒存進去（藍字＝假綠），
   所以最該守的就是「它還在不在」。覆蓋：未登入 401（**不是 404**＝route 真的在）／
   非 admin 403／GET 回 has_key 布林且回應不含任何金鑰欄位（D36）／
   空 body 400 不假裝成功／只改偏好不誤報 has_key／同測試內寫→讀一致。
   註：vitest-pool-workers 預設 isolatedStorage=true ⇒ 跨 it 的 KV 會還原，
   驗來回一致必須在同一個 it 內完成（我第一版寫成跨 it，測試如實抓出來了）。

② console/index.html 與 console/dashboard/index.html 也有同一個寫死
   `|| "https://cypher.arcrun.dev"` fallback（與 portal 同族）⇒ 一併拔掉。
   靜態 config.js 保留無妨：build-ui-bundle.mjs 的 SKIP 會跳過它、改由 worker 動態產生。

驗證：cypher tsc 綠、全套 248 passed（9 既有失敗未變）；
UI 產物 grep 寫死 fallback 歸 0；stage verify.sh 仍 11/3（無迴歸）。
 2026-07-31 20:57:05 +08:00
uncle6me-web 0d49989c19 修 arcrun-rag#10：補 /portal/admin/ai（key 從來沒存進去的真因）＋UI 已輸入態 
真因（不是重裝洗掉，是從來沒存進去）：前端唯一寫入路徑 POST /portal/admin/ai
**後端從來沒有這條 route** ⇒ 用戶填 key → 404 → 什麼都沒存，畫面卻像成功了（藍字＝假綠）。
產物層鐵證：bundle tier2/ui grep 'portal/admin/ai'=1、tier2/cypher=0；兩實例實打皆 404。
反證（別改不壞的東西）：走正確端點寫入 → 完整重裝 24/24 → credential 仍在、
rag_chat verdict failed→success ⇒ **重裝不洗 credential，資料層本來就是保留式的**。

① cypher 補 GET|POST /portal/admin/ai（routes/portal.ts）
   - POST 內部轉呼 credentials.ts 既有 storeCredential()＝**唯一寫入路徑**，不另造第二套
   - GET 只回 has_key 布林，**永不回傳 key 本身**（D36）
   - credential 的 api_key 欄＝租戶 slug（portalTenant），與安裝器 seedCredential 寫
     kbdb_internal_token 用的 ns 同值 ⇒ 同租戶分區，彼此查得到
   - use_claude_for_extract 存 KV（單一布林偏好，不為它開 KBDB template）
   - claude_available 目前無訊號來源（該由小幫手回報）⇒ **誠實回 false 不假綠**
   - 寫入失敗回 502 帶原因——本 bug 的教訓就是「不能讓前端以為存好了」
   - 兩者皆未提供 → 400，避免「看起來成功但什麼都沒做」

② 前端（console-ui/public/portal/index.html）
   - 拔掉寫死 `|| "https://cypher.arcrun.dev"` fallback ⇒ 缺 config.js 就顯示紅色橫幅明顯報錯。
     **寧可明顯失敗，不要靜默把用戶金鑰送去中央實例。**
     ⚠️ 更正我先前的錯誤診斷：config.js **有**正確注入（實查 leo 實例指向自己的 cypher），
     跨租戶錯置未發生；這條是未爆彈不是現行災情。
   - leo 規格：已存 → 唯讀「已輸入」＋「修改」鈕（不顯示 key）；按修改才變回輸入框；
     未存 → 一般輸入框。舊版只改 placeholder＝讀起來像臨時提示，是它像 UI bug 的原因。
   - 只有真的送了新 key 才切回「已輸入」（單純改 Claude 勾選不誤報）

tsc 綠；三個 script 區塊 node --check 全過。
卷：system-dev/docs/3-specs/journeys/gemini-key-lost-on-reinstall.md
 2026-07-31 19:56:47 +08:00
uncle6me-web 9f777ff43e t161+t162 修 leo prod 實撞兩病：庫清單靜默空白／「需要更新」假警報迴圈 
t162（假警報，實錘）：daemon cloudVersionStale() 讀 cypher /health 的 bundle_version
比對 minCloudBuilt(2026-07-28)，但 **/health 從來只回 {ok:true}、沒有這個欄位**
⇒ 恆讀到空字串 ⇒ 恆判 stale ⇒ 「知識庫需要更新」永遠不消失，重裝也沒用
（leo：「按下就跳到 install，但重新更新後並不會消失，這個訊息是幹嘛的？」）。
安裝器其實一直有注入 ARCRUN_BUNDLE_VERSION（worker.js:819），只是沒人吐出來。
修：/health 讀該 var 誠實回報（未注入則省略欄位＝老實例，daemon 判 stale 是對的）。
新 bundle 注入值 2026-07-31+<commit7> ≥ 2026-07-28 ⇒ 重裝後警報自然消失。

t161（庫清單空白）：portal 前端 guard401 → dropSession() **靜默**清 token 跳登入頁，
畫面不說任何原因 ⇒ 用戶看到的是「庫不見了」而非「請重新登入」（leo：「實際上根本
沒連上任何庫，清單空白」）。修：dropSession 帶原因寫進 #login-status——
「你的登入已過期，請重新登入（你的資料都還在，不會遺失）。」
資料側無恙（portal_library records=2 已驗），純讀側 session 過期＋靜默 UX 缺陷。

驗：cypher tsc 全綠；vitest 9 failed/187 passed＝基線不變。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 15:34:27 +08:00
uncle6me-web e744ad1f96 t160 世代債清除（leo：「如果你會搞不清楚，就把錯的東西刪掉」）——repo 只留一個 UI 世代 
事故鏈（07-31 深夜，leo 刷新撞到）：t159 重打包 staging bundle 時，build-ui-bundle
吃了 feat/step3 分支的 console-ui/public/——該分支基底早於 main d7fab7c
「拿掉登記新庫」，public 停在舊世代 ⇒ youlin 實例 UI 被打回被淘汰的
「登記新庫」人工表單典範（07-27 mistakes 已記帳的 src/public 雙世代債，
這次由「分支副本停舊代」路徑引爆——債沒還，任何一個部署路徑都會引爆它）。

刪掉的（舊世代，git rm 實體刪除）：
- console-ui/src/（console.ts/console-dashboard.ts/portal-ui.ts）＝07-22 從
  cypher-executor 搬出的 renderer 快照，自 07-27 起與 public/ 真身脫鉤、只會
  重產舊 UI
- console-ui/scripts/build.mjs＝從上述舊 renderer 重產 public 的 build 步驟
  （deploy.mjs 原自動跑它＝引爆器本體）
- cypher POST /portal/admin/libraries（人工建庫端點）＝死端點（e28e190 起 UI
  零呼叫；leo 規格「要直通 daemon，同步，沒有登記這回事」）。GET 列表／PATCH
  管理／t159 daemon 自動登記照舊

新唯一源：console-ui/public/＝手改演進的真身（本 commit 同步到 main e28e190
世代＋註解字樣改寫達成「登記新庫」全檔 0 命中）；deploy.mjs 改為直接託管
public（無 build 步）＋世代閘（缺「不需要人工新增」或含「登記新庫」拒部署）。

驗：tsc 全綠；deploy.mjs node --check 過；重打 ui bundle 242KB 過世代閘，
指紋「登記新庫」=0／「不需要人工新增」=1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 14:36:48 +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 159f0b07dc 🔴🔴 fix: portal 白畫面——t131 誤刪上一個 IIFE 的收尾 })(); 
leo：「問題是 portal 是白的」。真因：t131 合併 AI 設定時刪掉舊的 chat-key/extractor 兩區，
**連同上一個 IIFE 的收尾 })(); 一起刪掉** ⇒ 整段 JS 語法錯（Unexpected end of file）
⇒ 瀏覽器整支 script 不執行＝白畫面。
**總管失職**：t131 驗收只跑了 vitest（測後端）＋grep 字串，**從未驗過前端 JS 語法**——
portal/index.html 是純前端檔，vitest 根本測不到它。
修：補回 })();；node --check 通過；os-split/safejson 測試綠。
 2026-07-29 17:45:30 +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 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
uncle6me-web ba92d10a3f fix(t88): 拿掉庫管理頁「圖譜來源」概念——任何庫都能進總圖 
leo 裁定（2026-07-28）：「任何的庫都要進到圖譜模式」「給他選擇就是客服問題」
「不要給他選，掃到就能進總圖，也不用停用按鈕」。
移除：標為/取消圖譜來源鈕、庫停用/啟用鈕與 dialog、graph_source tag 與過濾、
說明文字「標了圖譜來源的庫決定誰能用圖譜模式」；後端 API 不動；
用戶管理的「停用」（set-status）未動。diff +6/-33。
按鈕來歷（leo 問）：5a16484 第一刀拆分引入（當時 B5 不存在，粗閘是唯一保護）；
t52(139d4c5) 補 auto 庫說明。拆的是過期鷹架非錯誤設計。
（實作＝子 CC；驗證+commit＝總管）
 2026-07-28 12:41:00 +08:00
uncle6me-web a909072dc1 feat(t87): portal 兩處顯示「去後綴的乾淨網址」＋一鍵複製——連線不再要人抄網址列 
leo 07-28 拍板：「一律用網址，把後綴拉掉，以免他貼了說我的網址錯了」。
設定頁「同步小幫手」卡＋管理頁「庫目錄管理」各一行：location.origin（無 /portal/#/ 後綴）
＋複製鈕（成功短暫顯示「已複製」，失敗 fallback 提示手動選取）。共用同一 helper。
os-split 10/10、safejson 8/8 仍綠（總管親跑）。（實作＝子 CC；審查+commit＝總管）
 2026-07-28 12:04:04 +08:00
uncle6me-web 11e772496f fix(t75 ①): portal 不再把 JSON 解析錯誤噴給使用者＋404 說人話 
leo 同事實測：存 Gemini 金鑰時畫面出現
「Unexpected non-whitespace character after JSON at position 4」。

根因兩層：
① 前端 15 處無條件 r.json()，但伺服器不一定回 JSON——404 頁/CF 錯誤頁都是 HTML。
   JSON.parse 一爆，錯誤沿 .catch 走到 friendlyErr，而 friendlyErr 最後一行是
    ＝把任何例外訊息原樣顯示 ⇒ 技術英文直接噴到畫面。
② 真正的原因是 /portal/admin/chat-key 回 404（實例的 cypher 是舊版沒這端點），
   但使用者完全看不出來，只看到一句看不懂的英文。

修：
- 新增 safeJson(r)：用 r.text() 再 try/catch parse，解析不了回 {} 不拋錯；15 處改用它
- friendlyErr 收斂：JSON 類錯誤→「伺服器回應異常，請稍後再試」；
  純英文技術訊息→「操作失敗」；我們自己寫的中文訊息才原樣顯示
- 兩處金鑰儲存加 404 專屬提示：「你的知識庫版本還沒有這個功能，請先更新知識庫」
  ——講清楚為什麼與怎麼辦，否則他只看到「儲存失敗」會反覆重試同一件事
- 順手：安裝卡片那處原本 x.d.error 在 x.d 為 undefined 時會再爆一次，補 x.d && 防護

測試 safejson.test.mjs 8/8：404 HTML 不拋錯／空回應／正常 JSON 仍解析得出／
JSON 錯誤不外洩原文且說人話／網路錯誤訊息保留／中文訊息原樣／英文技術訊息收斂。

⚠️ 這只解「不噴技術訊息」；金鑰要真的存得進去仍需實例更新 cypher（②層待辦）。
 2026-07-28 01:02:12 +08:00
uncle6me-web 53c6334fd9 fix(portal/t72): 下載頁 OS 分流——Windows 客戶不再拿到 Mac 的 .app 
leo 07-27：「客戶是用 windows 的」。此前四處寫死「下載 Mac 版」，
Windows 用戶按下去拿到 .app＝按了連到錯的東西（leo 判準：那不算友善）。

改法（施工圖 rag-wave1/windows-build-and-os-split.md §3）：
- daemonPick() 依 UA 判 OS，四處共用；判不出來＝兩個都給，不替用戶猜
- 判對了也附「不是這個系統？」另一版連結（UA 會判錯，用戶要有路走）
- 擋關話術跟著 OS 走：Mac=右鍵打開／Windows=更多資訊→仍要執行
- daemonBase 新 key，保留 daemonDownload 舊 key 相容（由檔名推目錄）
- 一律走 raw：Mac zip 21MB > jsDelivr 20MB 上限（實測回 File size exceeded）

測試 os-split.test.mjs 10/10：
⚠️ 測試抓到真 bug——iPhone 的 UA 含 'Mac OS X' 會被判成 Mac，
讓手機用戶下載裝不起來的桌面 app。已加 isMobile 排除，手機落到「兩個都給」。

未驗：真 Windows 機器的實際下載與安裝行為（需真機）。
 2026-07-27 19:28:43 +08:00
Leo d7fab7c6aa fix(portal): 拿掉登記新庫／設定頁補常駐入口（下載小幫手＋AI 金鑰） 
leo 07-27 走完安裝後三點回饋：

1) 「登記新庫」是設計錯誤 —— leo：「應該是同步小幫手抓到的庫就顯示在上面，
   沒有人工登記的選項。」人工登記只會製造對不上的空庫。
   移除表單＋對應 JS；說明改為「裝好同步小幫手並選好資料夾後，每個資料夾會自動
   成為一個庫出現在下面，不需要人工新增。下面還是空的，代表小幫手還沒裝好或還沒選資料夾。」

2) AI 金鑰與下載連結只存在一次性的「還差 N 步」卡片，按了「稍後再說」或裝完就
   再也找不到 —— 換金鑰／換電腦重新下載都沒入口。
   設定頁新增兩個常駐面板：「同步小幫手」（下載）與「AI 問答金鑰」（可隨時更換），
   共用既有 API POST /portal/admin/chat-key。

3) 修 window.ARCRUN_CFG → ARCRUN_CONFIG（與 721 行既有用法一致，原為筆誤）

驗證：ad-nl-create 殘留 0 ／ st-daemon-dl 2 ／ st-key-save 2 ／ ARCRUN_CFG 0
抽出頁面 3 個 script 區塊 node --check 語法通過
 2026-07-27 16:26:52 +08:00
uncle6me-web 139d4c5ed1 feat(t52): 資料夾＝庫端到端——kbdb 加 /entries/libraries（資料面 distinct 庫）；portal 庫目錄合併「登記簿＋蓋章自動出現」(auto)；auto 庫改安全渲染（無 record_id 不放死按鈕，改給『登記到目錄』）＋daemon/libraries 自動登記端點。leo 07-26：地端 2 個資料夾雲端就要 2 個庫 2026-07-26 01:49:43 +08:00
uncle6me-web e7fe83a872 feat(t54): 小幫手憑帳密自取設定——新端點 POST /portal/daemon/config（帳密驗證同 login，回連線設定不含知識內容）；portal 清單移除 config.json 下載（3 步→2 步）。leo 07-25：「最好的就是把它的帳密直接輸入」 2026-07-26 00:16:21 +08:00
uncle6me-web 8d19d0b2d7 fix(portal/t53): daemon 下載連結補實——zip 上鏡像（raw 路徑；jsDelivr 20MB 上限擋 21MB 檔）＋無下載點時誠實降級不放死連結（交付警察抓到 404 死連結） 2026-07-25 23:44:44 +08:00
uncle6me-web a8d246ebe9 feat(portal/t53): 進站完成安裝清單（leo 07-25：金鑰與 daemon 要在站內做，不然安裝沒完成）——常駐三項清單（下載小幫手/下載 config.json 站內生成/貼 Gemini 金鑰即時啟用）＋新端點 POST /portal/admin/chat-key（改寫 tenant rag_chat 的 x-goog-api-key，admin 閘、金鑰不落 log）＋session 回 email 供 config 生成 2026-07-25 23:26:44 +08:00
uncle6me-web 11ffd42899 fix(portal/t49): 首登頁補逃生口——『已經有帳號？改用登入』＋setup 409 自動切登入帶提示（leo 實撞死路） 2026-07-25 21:12:31 +08:00
uncle6me-web 9bbd25fdfc feat(portal/t49): 首登建帳一顆按鈕——auth-status 偵測未初始化→v-firstsetup（console/setup→portal/admin/bootstrap→自動登記預設庫 kb→portal/login 四發連鎖）＋進站一次性歡迎卡（下載小幫手/金鑰 → installer /setup）。leo 07-25：『加入的體驗要搞定』——用戶打開專屬網址第一眼就是建帳號，不再回安裝頁等 2026-07-25 20:35:33 +08:00
Claude beb0653e15 fix(console/t36): 語意搜尋改狀態列——移除按不動的假開關與 CLI 指示 
leo 2026-07-25 定案：語意搜尋預設開啟、不做開關（費用實算後屬雜訊——1 萬張卡規模
下 Vectorize 約 $0.18/月，佔 CF 帳單 3~4%；關掉省幾毛錢卻換來很爛的搜尋體驗）。

設定頁那顆「語意搜尋（vectorize）」開關其實不能按（title 自承「不能遠端改，只如實
顯示狀態」），旁邊還教用戶去部署端改 config.yaml 跑 acr update——對一鍵安裝進來的
用戶那是天書（與 t35 同一種白癡化違規），而且安裝器現在裝機時就把語意索引開好了，
那段指示本身已不成立。

改成單純狀態列：啟用時只說「已啟用，搜尋頁切語意就能用」不給任何操作指示；未啟用
才給一句人話與下一步（重跑安裝流程會補上，已建資料不重來）。

⚠️ 連帶必修：一併移除綁在該開關上的 click handler——留著會讓 $('st-vec-switch')
回 null、addEventListener 當場拋錯，把後面所有綁定（含登出）一起打斷。
驗：三個 script 區塊語法檢查通過、全檔已無 st-vec-switch/st-vec-state 殘留參照。
 2026-07-25 08:51:54 +00:00
uncle6me-web ad367e450d console-ui: 修好壞了一個月的 build + 具名部署目標（個人版/企業版） 
🔴 根因：5a16484 把 UI 搬 CF Pages 時「移出 → console-ui/」實際上只搬了
build 產物（HTML），三支 renderer 原始檔被刪且沒搬 →
`npm run build` 從那天起 ENOENT 死掉，線上 HTML 是刪檔前烤好的，
一個月來無法重建（CONSOLE_PROFILE 改了也不會生效，因為 build 跑不起來）。

修法：
- 從 git 撈回 console.ts(1623)/portal-ui.ts(1390)/console-dashboard.ts(822)
  放進 console-ui/src/——UI 原始碼跟著 UI 專案走，才是那一刀的原意
- build.mjs 加 resolveSource()：本地 src/ 優先，找不到才回退 cypher-executor

新增具名部署目標（deploy.targets.json + scripts/deploy.mjs）：
一個目標＝帳號＋profile＋apiBase 綁在一起，解決三次帶漏參數：
- demo 站漏 CONSOLE_PROFILE=rag → 顯示個人版 7 頁駕駛艙（leo「進去是 Mira 介面」的真因）
- 兩站漏 ARCRUN_API_BASE → apiBase 空 → 前端打自己 405 → 登不進去
- 兩帳號都有同名 arcrun-console-ui 專案且 wrangler OAuth 登入在 uncle6
  → 不指定帳號 deploy 會部到 demo 站（差點蓋掉，改用 API token 鎖帳號）

  npm run deploy:personal    → leo21c, profile=full(7頁), apiBase 指 leo21c worker
  npm run deploy:enterprise  → uncle6, profile=rag(4頁落地搜尋), apiBase 指 cypher.arcrun.dev

實測（用戶真的會走的路）：
- mira.uncle6.me/console/ 200，VIEWS 7 頁，apiBase 對，CORS ACAO 通
- rag-demo.arcrun.dev 4 頁落地搜尋；登入 OK、搜「藍鯨導航儀」5 筆（未受部署影響）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-22 19:09:29 +08:00
Leo 5a164843ef refactor(cypher): 第一刀拆分——UI 搬 CF Pages，ingest 從必爆變穩定 
根因（leo 2026-07-21 三個判斷全被數字證實）：
- 「cypher 展開上萬行，當時我就懷疑這樣跑得動嗎」→ 15,446 行、bundle 748KB
- 「不相信 CF 連讀文字檔都會撞牆」→ 不是 CF 的問題，是 cypher 太肥
- 「它違反了樂高化的原則」→ 零件 4KB，調度它們的 cypher 是巨石

定位錯誤（比效能更根本）：console.ts:1 自陳「Mira Console」，而 wiki 明載
「Mira 是 Arcrun 的使用者，不是開發者」→ 使用者的前端寫進了框架的執行引擎。
CLI/MCP 都已拆成獨立薄殼，唯獨 UI 沒有。責任誠實記：console.ts 標
「2026-07-04 總管派工」，是總管當初選了「就近寫在 cypher」的方便路。

本刀：
- console.ts(1623行) + portal-ui.ts(1390行) 移出 → console-ui/ CF Pages 專案
  （單檔 HTML + 原生 JS，零 build step，保持原特性）
- index.ts 移除兩個路由掛載、修 implicit any
- console-dashboard.ts 只留 API（UI 部分移出）

實測驗收（leo 指定判準：不看 /health，看真實任務）：
| 測試 | 拆分前 | 拆分後 |
|---|---|---|
| 連灌 10 張新卡（無間隔） | 從未成功 | 10 張全 create、73 條三元組 |
| 同卡連跑 6 次 | 前 2 過、後 4 全 1102 | 6 次全過 |
| Bundle | 747.9 KB | 528.0 KB（-29%） |

Pages 已上線：arcrun-console-ui.pages.dev（console/portal 皆 200）
cypher API 正常：/health、/console/dashboard-data 皆 200

未做（第二刀）：console-dashboard/portal/portal-data 尚未拆，cypher 仍 528KB。
但 ingest 已穩定，急迫性下降。

註：部署撞到三個既有 self-hosted 陷阱（KV/D1 id 是官方帳號的、arcrun.dev route
leo21c 無該 zone），用 wrangler.leo21c.toml 繞過，未改原始設定檔。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 18:55:31 +08:00