Update "QUESTION_CONTENTS"

2026-09-02 09:12:17 +00:00
parent f76c94e3a1
commit 4640323991
1 changed files with 64 additions and 12 deletions
@@ -1,15 +1,67 @@
 # 問詢目錄

-> 由 `jsc-ask:ask` 維護。每個存取庫一列；`QUESTION_{HASH}` 的 `{HASH}` 為 `{owner}/{repo}` 的 SHA-1 前 8 碼（大寫）。
+> 由 `jsc-ask:ask` 維護。這是問詢目錄頁 `QUESTION_CONTENTS`，落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，和問詢紀錄頁不同庫。每個存取庫一個區塊；`QUESTION_{HASH}` 的 `{HASH}` 執行 `jsc-gitea/tools/hash-id {owner}/{repo}` 取得，原樣採用它印出的完整 40 碼大寫十六進位，不截短、不加前綴（共用 wiki hash 規則，演算法見 `jsc-meta` 的 `references/guidelines.md`）。
+>
+> 版面：H1 頁名、這段 `>` 引言，然後每個存取庫一個 H2 區塊。H2 標題就是該存取庫的問詢紀錄頁頁名 `QUESTION_{HASH}`，標題不放連結、不放網址、不加前後綴。欄位一條一行，格式 `- {欄位名}：{值}`，全形冒號，順序是存取庫名稱、問詢紀錄、最後更新。標題與第一條之間空一行，區塊之間空一行。頁面上不留 markdown 表格。
+>
+> 寫入語意：一個區塊代表一個存取庫。一律用 `jsc-gitea/tools/wiki-contents.sh upsert` 寫入：它讀回整頁，該存取庫已經有區塊就整塊換掉，沒有才在文末附加一個區塊，最後整頁寫回。只動自己那個區塊，禁止整頁覆蓋，也不得改動別人的區塊。
+>
+> 參數語意：`upsert QUESTION 2 {key} {區塊檔} {範本}`。第二個參數是 `{key-col}`，指舊表格裡持有內容頁連結那一欄的欄位序號（1 起算）；本頁舊表格的欄序是存取庫名稱、問詢紀錄、最後更新，帶連結的是第 2 欄「問詢紀錄」，所以這裡固定帶 `2`。它只在舊頁還是 markdown 表格、要自動轉成條列時才用得到，頁面已經是條列格式就完全忽略它；但它不是死參數，也不能隨便填：轉檔時工具會拿那一欄的連結產生 H2 標題，填成 `1` 就取到純文字的 `{owner}/{repo}`，標題變成 `## plugins/meta`，比不到鍵 `QUESTION_{HASH}`，既有那一筆會被當成新的附加上去，同一個存取庫在頁面上出現兩次，舊區塊從此再也更新不到。`{key}` 是 H2 標題文字，也就是內容頁頁名 `QUESTION_{HASH}`，用來找既有區塊。第四個參數是區塊檔，內容是整個 H2 區塊的 markdown，不是單列。
+>
+> 連結寫法：問詢紀錄那一條一律寫成 `[{文字}]({連結})`，連結取自 `jsc-gitea/tools/gitea.sh wiki-url` 印出的絕對網址，不自行組路徑。兩頁分屬不同存取庫，只有絕對網址連得過去。
+>
+> 連結驗證：這個區塊寫進頁面前，先把區塊裡的每一個連結交給 `jsc-gitea/tools/link-check.sh`，結束碼 0 才寫入。有任一筆 DEAD 就整個區塊不寫，把連不到的清單回報給呼叫端。結束碼 3 代表 `GITEA_HOST` 沒設定，先設定再驗證，不得跳過；結束碼 7 代表金鑰失效，停下來回報，別把還在的頁當成死連結。

-| 存取庫名稱 | 問詢紀錄 | 最後更新 |
-| --- | --- | --- |
-| plugins/meta | [QUESTION_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_FB8DF0B5646689B45747957081FDFA56503E19A2) | 2026-08-31 |
-| plugins/ask | [QUESTION_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13) | 2026-08-21 09:33 |
-| jiantw83/CLIProxy+Worker | [QUESTION_104F0709D5C9E33B5086248A821FDA014CC82593](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_104F0709D5C9E33B5086248A821FDA014CC82593) | 2026-08-21 23:40 |
-| jiantw83/Kokorone | [QUESTION_8927820DAAD2096CA1410879E12652CCB87CB028](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_8927820DAAD2096CA1410879E12652CCB87CB028) | 2026-08-24 17:23 |
-| plugins/hooks | [QUESTION_D79F03B5433CB4635656AC7AC44004C002A6A47A](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_D79F03B5433CB4635656AC7AC44004C002A6A47A) | 2026-08-25 17:46 |
-| plugins/sdlc | [QUESTION_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39) | 2026-08-25 18:45 |
-| jiantw83/CLIProxy | [QUESTION_87095D0516385877D3F9602AD8405565DB7D104B](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_87095D0516385877D3F9602AD8405565DB7D104B) | 2026-08-26 07:10 |
-| jiantw83/CLIProxyWorker | [QUESTION_156A9FE06F2CEDA7A7C5006752057F92940FBBDA](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_156A9FE06F2CEDA7A7C5006752057F92940FBBDA) | 2026-08-26 18:55 |
-| plugins/assist | [QUESTION_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_E0494A8CA74F9D21AF51BC724B66D313C784A31E) | 2026-09-01 17:56 |
+## QUESTION_FB8DF0B5646689B45747957081FDFA56503E19A2
+
+- 存取庫名稱：plugins/meta
+- 問詢紀錄：[QUESTION_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_FB8DF0B5646689B45747957081FDFA56503E19A2)
+- 最後更新：2026-09-02 16:23
+
+## QUESTION_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13
+
+- 存取庫名稱：plugins/ask
+- 問詢紀錄：[QUESTION_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13)
+- 最後更新：2026-08-21 09:33
+
+## QUESTION_104F0709D5C9E33B5086248A821FDA014CC82593
+
+- 存取庫名稱：jiantw83/CLIProxy+Worker
+- 問詢紀錄：[QUESTION_104F0709D5C9E33B5086248A821FDA014CC82593](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_104F0709D5C9E33B5086248A821FDA014CC82593)
+- 最後更新：2026-08-21 23:40
+
+## QUESTION_8927820DAAD2096CA1410879E12652CCB87CB028
+
+- 存取庫名稱：jiantw83/Kokorone
+- 問詢紀錄：[QUESTION_8927820DAAD2096CA1410879E12652CCB87CB028](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_8927820DAAD2096CA1410879E12652CCB87CB028)
+- 最後更新：2026-08-24 17:23
+
+## QUESTION_D79F03B5433CB4635656AC7AC44004C002A6A47A
+
+- 存取庫名稱：plugins/hooks
+- 問詢紀錄：[QUESTION_D79F03B5433CB4635656AC7AC44004C002A6A47A](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_D79F03B5433CB4635656AC7AC44004C002A6A47A)
+- 最後更新：2026-08-25 17:46
+
+## QUESTION_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39
+
+- 存取庫名稱：plugins/sdlc
+- 問詢紀錄：[QUESTION_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39)
+- 最後更新：2026-08-25 18:45
+
+## QUESTION_87095D0516385877D3F9602AD8405565DB7D104B
+
+- 存取庫名稱：jiantw83/CLIProxy
+- 問詢紀錄：[QUESTION_87095D0516385877D3F9602AD8405565DB7D104B](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_87095D0516385877D3F9602AD8405565DB7D104B)
+- 最後更新：2026-08-26 07:10
+
+## QUESTION_156A9FE06F2CEDA7A7C5006752057F92940FBBDA
+
+- 存取庫名稱：jiantw83/CLIProxyWorker
+- 問詢紀錄：[QUESTION_156A9FE06F2CEDA7A7C5006752057F92940FBBDA](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_156A9FE06F2CEDA7A7C5006752057F92940FBBDA)
+- 最後更新：2026-08-26 18:55
+
+## QUESTION_E0494A8CA74F9D21AF51BC724B66D313C784A31E
+
+- 存取庫名稱：plugins/assist
+- 問詢紀錄：[QUESTION_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/QUESTION/wiki/QUESTION_E0494A8CA74F9D21AF51BC724B66D313C784A31E)
+- 最後更新：2026-09-01 17:56