feat(wiki): 異常目錄頁改走專用存取庫，並修正目錄列連結恆空 #73
No Assignees
Notifications
Due Date
No due date set.
Blocks
Depends on
#74 release: wiki 目錄頁專用存取庫、HASH 完整 40 碼、閘門依 CLI 分流
plugins/hooks
#47 feat(wiki): 目錄頁專用存取庫、HASH 去除截短與 H 前綴
plugins/gitea
Reference: plugins/hooks#73
Reference in New Issue
Block a user
What：ERROR_CONTENTS 改由 wiki-repo CONTENTS 解析，ERROR_{HASH} 仍走
wiki-repo ERROR，兩者是兩個不同的存取庫。目錄列的連結改用 wiki-url 的絕對網址。
註解掃描的頁面編號樣式補上 40 碼與 H 加 7 碼兩種形狀。
Why：目錄列的網址原本在異常頁寫入之前就取，而頁名的雜湊帶時間戳、每次都是全新頁，
那時查一定是 404，又被吞掉，所以那一格一直都是空的。註解掃描原本只收 8 碼純十六進位，
舊演算法有十三個首碼會改寫成 H 開頭，等於對絕大多數舊頁編號漏偵測。
How：降級語意分兩層——異常頁的存取庫解不出來就整支安靜降級，只有目錄頁解不出來就
只寫異常頁、跳過索引，兩種都維持 exit 0。「只有 exit 4 才准建新頁、7 與 8 一律中止」
那段原樣保留，那是防止把金鑰失效讀成頁面不存在、拿範本蓋掉整頁既有列。
Who：jsc-hooks
這一批的範圍
跨 8 個存取庫的同一份異動需求：
ask、assist、cli、gitea、hooks、log、meta、sdlc。兩條規則變更：
CONTENTS成為第 15 種頁面類型，解析鏈是JSC_WIKI_REPO_CONTENTS到JSC_WIKI_REPO，刻意不退回型別變數。14 個目錄頁從此同住一庫，內容頁仍各走自己的型別。兩者不再同庫，跨庫沒有 wiki 連結語法，所以連結一律改gitea.sh wiki-url的絕對網址。hash-id只保留大寫轉換，輸出完整 40 碼。原本的 H 前綴會命中 16 個首碼裡的 13 個、還丟掉第 8 碼，把有效熵壓到 28 位元，而且全庫查不到任何理由紀錄。頁名樣式仍收H加 7 碼的舊頁，遷移期間讀得到舊頁。相依與合併順序
jsc-gitea提供三支新腳本（page-name.sh、wiki-contents.sh、migrate-wiki.sh）與wiki-delete子命令，其餘七個存取庫的流程都呼叫它們，所以jsc-gitea要先合併。驗證
八個存取庫全部通過：
lint-scripts.sh、lint-frontmatter.sh、check-behaviors.sh、ste100-lint.sh各退出 0（jsc-ask沒有tools/與hooks/，lint-scripts.sh退 3，如實記錄）。另外gitea/tools/check-wiki-rules.sh與新增的meta/tools/check-page-name.sh都退出 0，JSC_READONLY=1的wire-cli.sh smoke codex退出 0 且行數與腳本自己的斷言相符。三支稽核代理人逐項對照準則的審核檢查清單，翻出的問題都已修並重驗，其中四項會實際咬人：
H開頭的舊頁名被判為不合法、遷移腳本寫目的地前沒先讀、建新頁會把範本示範列留在正式頁上、異常目錄列的網址恆為空字串。部署前要先做的事
Gitea 上還沒有目錄頁專用的存取庫（
knowledges底下目前只有各型別的庫）。合併後要先建好那個庫、設好JSC_WIKI_REPO_CONTENTS，再用gitea/tools/migrate-wiki.sh搬既有頁。那支預設只印對照表，--apply才會動，而且是先寫新頁、確認寫成、才刪舊頁；反推不到來源鍵的頁只列成孤兒，不猜。What：ERROR_CONTENTS 改由 wiki-repo CONTENTS 解析，ERROR_{HASH} 仍走 wiki-repo ERROR，兩者是兩個不同的存取庫。目錄列的連結改用 wiki-url 的絕對網址。 註解掃描的頁面編號樣式補上 40 碼與 H 加 7 碼兩種形狀。 Why：目錄列的網址原本在異常頁寫入之前就取，而頁名的雜湊帶時間戳、每次都是全新頁， 那時查一定是 404，又被吞掉，所以那一格一直都是空的。註解掃描原本只收 8 碼純十六進位， 舊演算法有十三個首碼會改寫成 H 開頭，等於對絕大多數舊頁編號漏偵測。 How：降級語意分兩層——異常頁的存取庫解不出來就整支安靜降級，只有目錄頁解不出來就 只寫異常頁、跳過索引，兩種都維持 exit 0。「只有 exit 4 才准建新頁、7 與 8 一律中止」 那段原樣保留，那是防止把金鑰失效讀成頁面不存在、拿範本蓋掉整頁既有列。 Who：jsc-hooksd105f4c1datof4871afd19