release: wiki 目錄頁專用存取庫、HASH 完整 40 碼、閘門依 CLI 分流 #48

2026-09-02T04:11:47Z

jiantw83 commented

2026-09-02 04:11:47 +00:00

把 develop 上累積的變更釋出到 master。合併之後，這些變更才會透過 marketplace 到達每一台機器。

這一版帶了什麼

一、wiki 目錄頁進專用存取庫

CONTENTS 成為第 15 種頁面類型，解析鏈是 JSC_WIKI_REPO_CONTENTS 到 JSC_WIKI_REPO，刻意不退回型別變數。14 個目錄頁從此同住一庫，內容頁仍各走自己的型別。兩者不再同庫，跨庫沒有 wiki 連結語法，所以目錄頁指向內容頁的連結一律改成 gitea.sh wiki-url 的絕對網址。

目錄頁的整列 upsert 收成一支 jsc-gitea/tools/wiki-contents.sh，取代原本 14 處只有 1 處寫成程式的手工流程。

二、wiki 頁 HASH 去除截短與 H 前綴

hash-id 只保留大寫轉換，輸出完整 40 碼。原本的 H 前綴會命中 16 個十六進位首碼裡的 13 個，還丟掉第 8 碼，把有效熵壓到 28 位元，而且全庫查不到任何理由紀錄。頁名樣式仍收 H 加 7 碼的舊頁，遷移期間讀得到舊頁。

三、SDLC 能力閘門依 CLI 分流

閘門的模型來源改成只讀屬於當前 CLI 的那一份，政策改為 fail-closed：判不出 CLI、判不出模型、模型不在能力標籤表上，三種一律擋下，每一則擋下的訊息都帶兩條逃生門。階段鎖狀態檔改成 $JSC_HOME/sessions/{CLI 代號}-{sid}.stage，舊路徑仍讀得到。

四、skill-check 加入優化與建議流程

Group 3 先讀上一輪決議，不重複掃、不重複問；建議表加上「決議」與「決議日期」兩欄；新增步驟 8 把稽核結果寫進 SKILLSET 頁。Group 1 補進三支現成但沒人呼叫過的檢查腳本。

五、順手修掉的既有缺陷

異常目錄頁那一列的連結一直都是空字串：頁名的 hash 帶時間戳、每次都是新頁，網址在寫入前就取，必然 404 又被靜默吞掉。
註解掃描的頁面編號樣式只收 8 碼純十六進位，對約八成的 H 開頭舊頁編號漏偵測。
設定規格表漏掉 JSC_WIKI_REPO_MONITOR，體檢看不到它而孤兒掃描還會誤報；另有指向不存在頁面的殘留項目。
體檢與巡檢的主機名一個由模型填、一個由程式算，短名對上 FQDN 會讓同一台機器分裂成兩張頁。
四個目錄頁拿含網址的儲存格當比對鍵，換主機或換存取庫就比對不到，每跑一次多附一列。

升級後的一次性代價

階段鎖狀態檔改名，所以每台機器第一次啟動會清一次重啟閘門——起始檔不存在，看起來像新的工作階段。只發生一次，已實測連跑三次不會再清。升級當下正好有閘門升著的話，那一次會被放下。

部署後要做的事

wiki 既有頁要用 jsc-gitea/tools/migrate-wiki.sh 搬。先部署再搬：舊版技能算的是 8 碼頁名，先搬會讓舊版找不到頁、照範本另外開一份新的。那支預設只印對照表，--apply 才真的動，而且是先寫新頁、確認寫成、才刪舊頁。

把 develop 上累積的變更釋出到 master。合併之後，這些變更才會透過 marketplace 到達每一台機器。 ## 這一版帶了什麼 ### 一、wiki 目錄頁進專用存取庫 `CONTENTS` 成為第 15 種頁面類型，解析鏈是 `JSC_WIKI_REPO_CONTENTS` 到 `JSC_WIKI_REPO`，刻意不退回型別變數。14 個目錄頁從此同住一庫，內容頁仍各走自己的型別。兩者不再同庫，跨庫沒有 wiki 連結語法，所以目錄頁指向內容頁的連結一律改成 `gitea.sh wiki-url` 的絕對網址。目錄頁的整列 upsert 收成一支 `jsc-gitea/tools/wiki-contents.sh`，取代原本 14 處只有 1 處寫成程式的手工流程。 ### 二、wiki 頁 HASH 去除截短與 H 前綴 `hash-id` 只保留大寫轉換，輸出完整 40 碼。原本的 `H` 前綴會命中 16 個十六進位首碼裡的 13 個，還丟掉第 8 碼，把有效熵壓到 28 位元，而且全庫查不到任何理由紀錄。頁名樣式仍收 `H` 加 7 碼的舊頁，遷移期間讀得到舊頁。 ### 三、SDLC 能力閘門依 CLI 分流閘門的模型來源改成只讀屬於當前 CLI 的那一份，政策改為 fail-closed：判不出 CLI、判不出模型、模型不在能力標籤表上，三種一律擋下，每一則擋下的訊息都帶兩條逃生門。階段鎖狀態檔改成 `$JSC_HOME/sessions/{CLI 代號}-{sid}.stage`，舊路徑仍讀得到。 ### 四、skill-check 加入優化與建議流程 Group 3 先讀上一輪決議，不重複掃、不重複問；建議表加上「決議」與「決議日期」兩欄；新增步驟 8 把稽核結果寫進 SKILLSET 頁。Group 1 補進三支現成但沒人呼叫過的檢查腳本。 ### 五、順手修掉的既有缺陷 - 異常目錄頁那一列的連結**一直都是空字串**：頁名的 hash 帶時間戳、每次都是新頁，網址在寫入前就取，必然 404 又被靜默吞掉。 - 註解掃描的頁面編號樣式只收 8 碼純十六進位，對約八成的 `H` 開頭舊頁編號漏偵測。 - 設定規格表漏掉 `JSC_WIKI_REPO_MONITOR`，體檢看不到它而孤兒掃描還會誤報；另有指向不存在頁面的殘留項目。 - 體檢與巡檢的主機名一個由模型填、一個由程式算，短名對上 FQDN 會讓同一台機器分裂成兩張頁。 - 四個目錄頁拿含網址的儲存格當比對鍵，換主機或換存取庫就比對不到，每跑一次多附一列。 ## 升級後的一次性代價階段鎖狀態檔改名，所以每台機器第一次啟動會清一次重啟閘門——起始檔不存在，看起來像新的工作階段。只發生一次，已實測連跑三次不會再清。升級當下正好有閘門升著的話，那一次會被放下。 ## 部署後要做的事 wiki 既有頁要用 `jsc-gitea/tools/migrate-wiki.sh` 搬。**先部署再搬**：舊版技能算的是 8 碼頁名，先搬會讓舊版找不到頁、照範本另外開一份新的。那支預設只印對照表，`--apply` 才真的動，而且是先寫新頁、確認寫成、才刪舊頁。

jiantw83 added 2 commits 2026-09-02 04:11:47 +00:00

feat(wiki): 目錄頁專用存取庫、HASH 去除截短與 H 前綴 c40b561589

What：CONTENTS 成為第 15 種頁面類型，解析鏈為 JSC_WIKI_REPO_CONTENTS 到
JSC_WIKI_REPO，刻意不退回型別變數。hash-id 拿掉 8 碼截短與 H 前綴改寫，只留大寫
轉換，輸出完整 40 碼；空輸入改成用法錯誤。新增 page-name.sh、wiki-contents.sh、
migrate-wiki.sh 與 wiki-delete 子命令。

Why：H 前綴會命中 16 個首碼裡的 13 個，還丟掉第 8 碼，把有效熵壓到 28 位元，而且
全庫查不到任何理由紀錄。目錄頁的整列 upsert 原本 14 處只有一處寫成程式，同一段判斷
做 14 次，錯一次就少一筆紀錄。

How：頁名樣式仍收 H 加 7 碼的舊頁，遷移期間讀得到舊頁。wiki-contents.sh 建新頁時
剝掉範本的示範列，否則每個目錄頁第一次建立都會留一列佔位死連結。migrate-wiki.sh
預設只印對照表，--apply 先寫新頁、確認寫成、才刪舊頁；孤兒頁只列不猜，因為 SHA-1
不可逆，新頁名只能靠候選鍵正推。

Who：jsc-gitea

Merge pull request 'feat(wiki): 目錄頁專用存取庫、HASH 去除截短與 H 前綴' (#47 ) from feat/wiki-contents-repo/main into develop 803e7ed598

Reviewed-on: #47

jiantw83 added a new dependency 2026-09-02 04:17:18 +00:00

#49 fix(migrate-wiki): 正推比對涵蓋兩代頁名規則

admin added 2 commits 2026-09-02 04:18:43 +00:00

fix(migrate-wiki): 正推比對涵蓋兩代頁名規則 b53cfeaf34

What：候選鍵的舊 HASH 改成兩種都算——第一代只取 SHA-1 前 8 碼大寫，第二代在其上
把首碼落在 0-9ABC 的改寫成 H 加前 7 碼。兩種都進對照表，任一種配得上就算配對成功。

Why：原本只算第二代，所以第一代那些首碼落在 0-9ABC 的頁一律配不到，被誤判成孤兒
留在原地。實測同一個鍵在第一代是 1C516D85、第二代是 H1C516D8，兩張頁至今並存，
只算第二代就會漏掉第一代那一張。

How：實地重跑對照表，可搬頁數從 35 增為 48，孤兒從 14 減為 2。剩下兩頁一頁是更早的
{型別}_{日期}_{HASH} 命名、頁名不符任何已知樣式，一頁反推不到候選鍵，兩頁都照原則
只列不猜。首碼落在 D、E、F 的鍵兩代同值，只印一行，不會重複。

Who：jsc-gitea

Merge pull request 'fix(migrate-wiki): 正推比對涵蓋兩代頁名規則' (#49 ) from fix/migrate-two-hash-generations into develop f3e6933942

Reviewed-on: #49

admin approved these changes 2026-09-02 04:20:24 +00:00

admin merged commit 9c9d912292 into master

2026-09-02 04:20:27 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Depends on

#49 fix(migrate-wiki): 正推比對涵蓋兩代頁名規則

plugins/gitea

Reference: plugins/gitea#48