釋出：三支技能的目錄頁改版、收尾事件回報、連結驗證與暫存區孤兒掃描 #37

2026-09-04T05:00:49Z

jiantw83 commented

2026-09-04 05:00:49 +00:00

摘要

需求描述：develop 壓著十五筆沒釋出，這台機器上一筆都沒生效。deploy.sh clone 的是預設分支，沒進 master 的東西部署不到。三支技能的目錄頁改版、收尾事件回報、連結驗證、暫存區孤兒掃描，全在裡面。
計畫名稱：無
計畫頁：無
分析頁：無

這一批的內容

變更	為什麼
三支技能的目錄頁改成大標題區塊	日誌、教訓、報表三個目錄頁不再是 markdown 表格，一個內容頁一個 H2 區塊
收尾寫一筆 `skill-end` 事件	執行狀態要回報得到助理，助理才看得出一支技能中途斷掉
連結一律寫成絕對網址並先驗證	wiki 的雙中括號寫法只在同一個 wiki 內解得開，跨庫寫就是死連結而且不會報錯
工作日誌暫存收編舊名目錄，並掃出定址不到的孤兒	舊的雜湊規則留下的暫存內容本來會孤在那裡，誰都併不進來

版號 0.1.5 到 0.1.9。

為什麼現在要送

今天寫工作日誌時實際踩到：這台機器跑的是 0.1.5，技能本文還寫著表格版的寫入呼叫，而線上的目錄頁與 wiki-contents.sh 都早就是區塊版。寫的人得先拿真實舊頁乾跑一次、確認別人的區塊不會被動，才敢照實際格式寫入。

修正早就做好了，只是壓在這裡。 同一天巡檢報出「jsc-log 的技能沒有寫收尾事件」，那個功能也在這十五筆裡。

這一批的邊界

程式碼與文件都是既有的，這張只做釋出，一個字都沒改。

前置 Push Request

無

## 摘要 - 需求描述：develop 壓著十五筆沒釋出，這台機器上一筆都沒生效。`deploy.sh` clone 的是預設分支，沒進 master 的東西部署不到。三支技能的目錄頁改版、收尾事件回報、連結驗證、暫存區孤兒掃描，全在裡面。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 這一批的內容 | 變更 | 為什麼 | | --- | --- | | 三支技能的目錄頁改成大標題區塊 | 日誌、教訓、報表三個目錄頁不再是 markdown 表格，一個內容頁一個 H2 區塊 | | 收尾寫一筆 `skill-end` 事件 | 執行狀態要回報得到助理，助理才看得出一支技能中途斷掉 | | 連結一律寫成絕對網址並先驗證 | wiki 的雙中括號寫法只在同一個 wiki 內解得開，跨庫寫就是死連結而且不會報錯 | | 工作日誌暫存收編舊名目錄，並掃出定址不到的孤兒 | 舊的雜湊規則留下的暫存內容本來會孤在那裡，誰都併不進來 | 版號 0.1.5 到 0.1.9。 ## 為什麼現在要送今天寫工作日誌時實際踩到：這台機器跑的是 0.1.5，技能本文還寫著表格版的寫入呼叫，而線上的目錄頁與 `wiki-contents.sh` 都早就是區塊版。寫的人得先拿真實舊頁乾跑一次、確認別人的區塊不會被動，才敢照實際格式寫入。 **修正早就做好了，只是壓在這裡。** 同一天巡檢報出「`jsc-log` 的技能沒有寫收尾事件」，那個功能也在這十五筆裡。 ## 這一批的邊界程式碼與文件都是既有的，這張只做釋出，一個字都沒改。 ## 前置 Push Request - 無

jiantw83 added 15 commits 2026-09-04 05:00:49 +00:00

feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 2c085d68ef

取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。

chore(plugin 版本): 三份 manifest 升版至 0.1.6 c5f92ea51c

Merge pull request '連結一律寫成 [文字](絕對網址)，並在寫入前驗證連得到' (#33 ) from feat/link-verification/main into develop 7ff79005c2

Reviewed-on: #33

fix(工作日誌暫存): 收編舊名目錄，並掃出定址不到的孤兒 e762cf986e

雜湊規則從 8 碼改成完整 40 碼那一刻，還沒寫進 wiki 的暫存留在舊名底下。
現行程式拿 40 碼去查，查不到那些目錄，裡面的條目就再也寫不出去。

沒人發現是因為兩種狀態長得一樣：「真的沒有待寫」與「待寫卡在舊名底下」
對呼叫端都是成功。技能於是照常回報完成，日誌卻一筆都沒有。

兩道處置。推得出對映的（舊名等於 H 加新名前 7 碼）由 list、cat、merge
一併收編，clear 與 commit 也連舊目錄一起清——commit 不放行的話，已經寫進
wiki 的暫存清不掉，下一輪會整批重複寫一次。推不出對映的交給新的 orphans
子命令掃出來回報，要有人看到才處理得掉。

chore(plugin 版本): 三份 manifest 升版至 0.1.7 afeb0a0e7c

Merge pull request '工作日誌暫存收編舊名目錄，並掃出定址不到的孤兒' (#34 ) from fix/pending-legacy-dir-and-orphan-scan into develop 277a8f1b88

Reviewed-on: #34

feat(狀態回報): 收尾寫一筆 skill-end 事件 aeb3f467e2

現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。

chore(plugin 版本): 三份 manifest 升版至 0.1.8 277e6df960

Merge pull request '收尾寫一筆 skill-end 事件，執行狀態才回報得到助理' (#35 ) from feat/status-report into develop dd64c0350e

Reviewed-on: #35

feat(worklog): 日誌目錄頁改成一個日誌頁一個大標題區塊 fbfe424c39

日誌目錄頁的版面從 markdown 表格換成「大標題加條列」：一個日誌頁一個大標題
區塊，標題就是那個日誌頁的實際頁名，週五日期、條目數這些欄位改成標題底下的
一層條列。範本與 worklog 技能的寫入敘述、完成條件、退出碼說明一起跟上。

表格的欄位組合是整頁共用的，一頁上卻有很多存取庫各自的紀錄，每一輪只重寫
自己那一列。欄位一增減，舊列的格數與表頭就對不上，而目錄頁不能整頁覆蓋——
覆蓋等於刪掉別人的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只動到自己
那一個區塊。

比對鍵從裸雜湊那一格改成大標題本身，標題寫成日誌頁的實際頁名。頁名只由
存取庫的擁有者與名稱決定，換主機位址、把日誌頁移到別的存取庫，或頁名編碼
有差，都動不到它；含網址的那一條連結照樣留著給人點，但不當鍵——拿它當鍵，
上面任一件事一變，這一輪的文字就跟上一輪不一樣，比不到既有那一筆就走附加，
同一個日誌頁多出第二個區塊，舊區塊從此再也更新不到。欄號那個參數只在舊
表格頁轉檔時用得到，頁面已經是條列就完全忽略它。

範圍是工作日誌的目錄頁與 worklog 技能。

feat(learn): 教訓目錄頁改成一個存取庫一個大標題區塊 cce75e2f45

教訓目錄頁的版面從 markdown 表格換成「大標題加條列」：一個存取庫一個大標題
區塊，標題就是那個存取庫教訓頁的實際頁名，存取庫名稱、教訓紀錄連結、最後
更新時間改成標題底下的一層條列。範本與 learn 技能的寫入敘述一起跟上。

表格的欄位組合是整頁共用的，一頁上卻有很多存取庫各自的紀錄，每一輪只重寫
自己那一列。欄位一增減，舊列的格數與表頭就對不上，而目錄頁不能整頁覆蓋——
覆蓋等於刪掉別人的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只動到自己
那一個區塊。

比對鍵從存取庫名稱那一格改成大標題本身，標題寫成教訓頁的實際頁名。頁名只由
存取庫的擁有者與名稱決定，換主機位址、改存取庫或頁名編碼有差都動不到它。
欄號那個參數配合線上實際欄位改成教訓紀錄那一欄：轉檔時取那一格的文字當
標題，格子寫成連結就只取顯示文字。欄號填錯的話，轉出來的標題跟鍵對不上，
既有那一筆會被當成新的附加上去，同一個存取庫變兩個區塊。

範圍是教訓紀錄的目錄頁與 learn 技能。

feat(report): 報表目錄頁改成一個報表頁一個大標題區塊 369b327a4f

報表目錄頁的版面從 markdown 表格換成「大標題加條列」：一個報表頁一個大標題
區塊，也就是一個存取庫的一種期間一個區塊，標題就是那個報表頁的實際頁名，
期間、最新一期、期數這些欄位改成標題底下的一層條列。範本與 report 技能的
寫入敘述與退出碼說明一起跟上。

表格的欄位組合是整頁共用的，一頁上卻有很多報表頁各自的紀錄，每一輪只重寫
自己那一列。欄位一增減，舊列的格數與表頭就對不上，而目錄頁不能整頁覆蓋——
覆蓋等於刪掉別人的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只動到自己
那一個區塊。

比對鍵從裸雜湊那一格改成大標題本身，標題寫成報表頁的實際頁名。頁名只由
存取庫的擁有者、名稱與期間決定，換主機位址或頁名編碼有差都動不到它；含
網址的那一條連結照樣留著給人點，但不當鍵。把報表存取庫改指別的庫是另一回
事：雜湊本身就取自那個庫，換庫等於換頁，四種期間會各多一個區塊，那是換庫
的本意，不是鍵失準，舊區塊請人工清掉。

範圍是工作報表的目錄頁與 report 技能。

docs(behaviors): 說明文件與行為清單跟上目錄頁的條列版面 18d12bbbe2

存取庫說明與技能行為清單裡講到目錄頁的段落一律改口：一筆一個大標題區塊、
標題就是內容頁頁名也就是鍵、欄位是標題底下的一層條列，頁上不留表格。

三個目錄頁的範本與三支技能的敘述都換了版面，說明文件卻還寫著「一列」與
「表格」。文件與範本各說一套，照文件手工補紀錄的人會補出一列表格，那一列
在條列頁上讀不成一筆紀錄，而且下一輪工具重寫時也不會被當成既有那一筆換掉。

只改敘述，行為與呼叫參數都不動；欄位語意與寫入語意的正本仍在各自的範本
引言裡，這裡只指向它，不重述細節。

範圍是說明文件與技能行為清單裡的目錄頁敘述。

chore(manifest): 三份 manifest 升版至 0.1.9 fda0fca304

三份外掛清單的版號一起往上推一版。

三個目錄頁的版面與寫入參數都變了，呼叫端要靠版號才判得出手上這一份是新的
還是舊的。版號不動，版本閘門就不會提示更新，機器上會留著舊版敘述去寫新版
目錄頁。

三份清單各自被不同的 CLI 讀，值必須一致，所以一起改、一起提交。

範圍是外掛清單的版號宣告。

Merge pull request '工作日誌三個目錄頁改成大標題加條列，三支技能的呼叫與敘述同步' (#36 ) from feat/contents-list/main into develop 4c7b63d43a

Reviewed-on: #36

admin approved these changes 2026-09-04 05:01:58 +00:00

admin merged commit ee32bfd2ec into master

2026-09-04 05:02:01 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/log#37