 jiantw83
|
a229964dfe
|
chore(plugin): 三份 manifest 升版至 0.2.5
三份 plugin manifest 的版本號同步升到 0.2.5。
目錄頁格式改動了工具的對外行為，其餘七個 domain 的範本要對上這一版才組得
出正確的區塊。版本號沒動，版本守衛就看不出機器上裝的是舊版工具。
三份一起改，維持既有的同版策略。
功能範圍：目錄頁版面改版的版本標記。
|
2026-09-02 17:22:35 +08:00 |
|
|
jiantw83
|
89463cd263
|
docs(wiki): 同步目錄頁條列格式的敘述與工具用法
README 的工具用法、技能行為清單、連結規則與 wiki 技能本文，全部改寫成
目錄頁的區塊格式：參數名從整列改成整個區塊、key-col 的用途縮回只給轉檔
用、補上取標題與換引言的判準，並登錄新增的驗證腳本。
文件與工具講的不是同一件事，呼叫端就會照舊敘述傳整列的表格文字進去，寫出
半表格半條列的頁面。key-col 的語意變動最容易誤解——它從「要換掉哪一欄」
變成「轉檔時哪一欄持有身分」，敘述不改就會被填成別的欄位。
目錄頁條列、內容頁維持圖表優先，這個區分在每一份文件裡都寫明，避免把改版
範圍誤讀成整個 wiki。結束碼說明一併對回工具現況。
功能範圍：目錄頁版面改版的文件同步。
|
2026-09-02 17:22:29 +08:00 |
|
|
jiantw83
|
9942cf2506
|
fix(migrate-wiki): 候選鍵兼收條列與表格兩種目錄頁形狀
搬頁時蒐集候選鍵的那一段，原本只讀目錄頁表格的存取庫、主機、帳號、工具、
期間五欄。現在改成 H2 區塊底下的「- {欄位名}：{值}」也照樣讀，表格的欄位
維持原樣收下，兩種形狀都認得。
目錄頁已經改成條列，還沒轉檔的線上舊頁卻仍是表格，同一輪搬頁會同時遇到
兩種。只讀表格的話，條列頁一個候選鍵都收不到，那些頁的舊頁名就對不到新
頁名，搬頁會把它們當成沒有對應而漏掉。
讀取改成逐行判斷：碰到「## 」就把上一個區塊收掉並開新的一筆，區塊內的
條列按欄位名對照收值。欄位值各自算一個候選鍵，再依固定欄位順序串一個組合
鍵，跟表格那一路的產出規則完全一致。條列的冒號正本寫全形，半形也一併收，
舊頁手寫的那幾條才不會整條漏掉。
功能範圍：目錄頁版面改版的搬頁相容。
|
2026-09-02 17:22:24 +08:00 |
|
|
jiantw83
|
c7c14445e6
|
test(check-contents-format): 新增目錄頁區塊格式的離線驗證
新增一支只讀寫暫存檔的驗證腳本，全程走 format 子命令，涵蓋五種舊頁狀態：
純表格、已是條列且鍵命中、已是條列且鍵未命中、表格與區塊混合、用範本建
新頁。另外驗身分欄取標題的四種情形與引言的五種情形。
轉檔與 upsert 的錯法都是靜默的：標題取錯只會多長一個區塊，引言沒換掉只是
說明過期，兩種都不會報錯，要等到線上頁面壞掉才看得出來。手動打 API 驗又
會在正式頁上留下試出來的垃圾紀錄。
驗證只比對輸入與輸出檔，不碰網路，任何機器上都跑得完。除了正常流程還特別
釘住三件事：表格取不出鍵那一列要擋下來不猜標題、轉檔後拿結果重跑同一筆
必須一字不變、區塊檔沒帶標題也照樣補上。任一項不符就印出期望值與實際值
之後立刻停住，不續跑其餘項目。
功能範圍：目錄頁版面改版的迴歸防護。
|
2026-09-02 17:22:18 +08:00 |
|
|
jiantw83
|
2e8712126f
|
refactor(wiki-contents): 目錄頁改成 H2 區塊 upsert，舊表格自動轉檔
目錄頁的一筆紀錄從 markdown 表格的一列，改成一個 H2 區塊：標題就是這一筆
對應內容頁的頁名，欄位變成標題底下一層的條列「- {欄位名}：{值}」。upsert
換掉標題相同那一塊，找不到就附加到頁尾。
表格一列擠著所有欄位，欄位一多就超出可讀寬度，得橫向捲才看得完；換行之後
也分不出哪幾格屬於同一筆。條列沒有寬度上限，一筆看得完整。
讀到的舊頁還是表格，就先整頁轉成區塊再在轉好的頁面上做 upsert，一頁同時
有表格與區塊也照樣接得起來。轉檔取標題只看持有身分那一欄：有連結取網址
最後一段路徑並解掉百分號編碼，沒連結取純文字——連結的顯示文字常常是計畫
或工作包名稱而不是頁名，拿它當標題會跟呼叫端傳進來的鍵對不上，同一筆長出
第二個區塊，舊的那塊從此再也更新不到。那一欄取不出鍵就整支擋下來，不猜
標題。轉檔那一次有給範本，就連 H1 與引言一起換成範本那一份，舊引言否則
會一直講「一列一筆」；頁面已是條列時只更新自己那一筆，不動引言。組頁邏輯
另外拆出 format 子命令，離線驗證才叫得到，不必打 API。
功能範圍：目錄頁版面改版，涵蓋所有以 _CONTENTS 結尾的頁面與每一支寫目錄
頁的技能。
|
2026-09-02 17:22:06 +08:00 |
|