 jiantw83
|
311cdc611a
|
feat(wiki): 巡檢目錄頁改成一台機器一個大標題區塊
巡檢目錄頁的版面從 markdown 表格換成「大標題加條列」：一台機器一個大標題
區塊，標題就是那一台機器監控頁的實際頁名，欄位改成標題底下的一層條列。
範本、技能敘述、行為清單與說明文件一併跟上，目錄頁上不再留任何表格。
表格的欄位組合是整頁共用的，表頭跟著建頁那一台機器走，之後每一台只改自己
那一列。欄位一增減，只有跑到新版的機器寫得出新的格數，同一張表就混著兩種
格數，多出來的那一格對不到任何欄名，而目錄頁又沒有整頁改寫的路可以走——
整頁覆蓋等於刪掉別台機器的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只
動到自己那一個區塊。
比對鍵從裸雜湊那一格改成大標題本身，標題寫成監控頁的實際頁名。頁名只由
主機名與登入帳號決定，換主機位址、換專用存取庫或換一種頁名編碼都動不到
它；含網址的那一條連結照樣留著給人點，但不當鍵。呼叫改成拿頁名當鍵，欄號
那個參數只在舊表格頁轉檔時用得到。範本原本用二階標題寫的說明區段全部搬進
引言，否則轉檔後會被當成一筆真紀錄讀進去。
範圍是助理的巡檢目錄頁與 assistant 技能的敘述。
|
2026-09-02 17:21:12 +08:00 |
|
|
jiantw83
|
3dac1475df
|
feat(狀態回報): 收尾寫一筆 skill-end 事件
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。
start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。
status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
|
2026-09-02 16:01:13 +08:00 |
|
|
jiantw83
|
9ea83da38b
|
feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。
連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
|
2026-09-02 14:27:18 +08:00 |
|
|
jiantw83
|
4bf99dde76
|
feat(wiki): 監控目錄頁改走專用存取庫，比對鍵改用裸 HASH
What：MONITOR_CONTENTS 改由 wiki-repo CONTENTS 解析並透過 wiki-contents.sh
upsert 寫入，MONITOR_{HASH} 仍走 wiki-repo MONITOR。目錄頁新增一欄裸 HASH 當
比對鍵，第一欄的絕對網址連結留給人看。主機名一律取短名。
Why：目錄頁集中之後兩頁不再同庫，[[...]] 只在同一個 wiki 內解析，連結必須改絕對
網址。比對鍵原本是含網址的儲存格，換主機、換存取庫或 URL 編碼有差就比對不到，
巡檢每 15 分鐘寫一次，重複列會累積得很快。
How：目錄頁解不出存取庫時不再中止巡檢——那一頁只是索引，內容頁寫成就照樣寫心跳。
內容頁寫不成仍然中止且不寫心跳，自咬環的前提沒有鬆動。
Who：jsc-assist
|
2026-09-02 11:01:51 +08:00 |
|
|
jiantw83
|
2b7176a644
|
feat(patrol): 一輪巡檢落地，心跳改由巡檢跑完才寫
What：
- 新增 tools/patrol.sh，三個子命令：collect 收集、finish 收尾、abort 中止。這一輪的巡檢項目是四項純讀取：使用統計、版本落差與重啟閘門、階段鎖與工作包鎖、心跳自述。
- 心跳的寫入從排程移到巡檢收尾。排程只呼叫巡檢，不再直接寫心跳。
- 排程週期由心跳門檻推導，不再寫死。install heartbeat 這個工作代號改為拒絕。
Why：
- 排程直接寫心跳的話，心跳新鮮只證明排程活著。巡檢整個壞掉、每輪都失敗，心跳照樣新鮮，閘門照樣放行，而且沒有任何錯誤訊息——這是無聲失效，是最難發現的一種。
- 改成巡檢寫，心跳新鮮才等於上一輪真的跑完了。閘門判的才是工作訊號，不是行程存活訊號。
- 門檻是讀取端的設定，心跳檔裡不存它。所以週期與門檻各寫死一個數字一定會撞：門檻五分鐘、巡檢十五分鐘，心跳永遠是過期的。
How：
- 週期取「滿足漏掉一輪還算新鮮、漏掉兩輪才過期」的最大值，並且要能整除一小時。要拉長巡檢週期就調大門檻，週期自動跟著長，兩個數字不會各走各的。
- 心跳只看「這一輪有沒有把結果記下來」，不看四項的成敗。四項有失敗但監控頁寫成了就寫心跳，頁上判定標警示；頁寫不成就中止，一定不寫，讓心跳自己過期。頁每輪都寫失敗卻照樣寫心跳，等於把這次要修掉的缺陷原封不動搬過去。
- 整輪拿一把目錄鎖，搶不到就讓開，不排隊也不並行。並行兩輪會在同一頁附兩節，還會互相蓋掉用量快照。鎖逾時可被下一輪搶走，被搶走的那一輪收尾時對不上就不寫心跳——它沒跑到底，不該蓋章。
- 任一項失敗不影響其餘項目。失敗要在監控頁上看得出來是失敗，不是沒資料；來源是空的則明寫「那是零次，不是故障」。
- 版本盤點照抄腳本原字。抄到查詢失敗就寫查詢失敗，不改寫成相符、也不自己補查遠端版本——查不到是沒有證據，不是版本沒問題。
Who：
助理落地的第四塊。排程那一輪留下的問題在這裡解掉了。
|
2026-09-01 15:06:10 +08:00 |
|
|
jiantw83
|
e7e9b8ce18
|
feat(templates): 新增監控頁的目錄頁與內容頁範本
What：
- 新增 templates/monitor-contents.md 與 templates/monitor-page.md。
- README 的「參考與工具」表補上這兩份範本，說明欄寫出兩者相反的寫入語意。
- 三份 manifest 的版本一起提升。
Why：
- 監控頁是助理巡檢結果的落點。沒有範本，每次巡檢寫出來的格式都不一樣，累積久了看不出趨勢，也對不起來。
- 兩份範本的寫入語意剛好相反，必須各自寫明白。目錄頁是共用的，一列代表一台機器，整頁覆蓋會刪掉別台機器的紀錄；內容頁只屬於一台機器，記的是歷次巡檢的軌跡，所以附加不覆寫。
How：
- 目錄頁範本帶欄位說明與寫入規則：比對主機與帳號兩欄，只更新自己那一列，讀不到舊內容就中止，不硬寫。
- 內容頁範本一次巡檢附加一節，節標題帶時間戳，涵蓋心跳與閘門、使用統計、hook 錯誤、版本落差、階段鎖與工作包鎖、待辦簿到期與逾期六類結果。
- 連續失敗的項目一定要標「已連續失敗 N 次」。待辦簿的項目失敗不會自動暫停，會每輪重試，不標出來就是一個壞掉的項目一直重試而沒人知道。
- 內容以圖表優先，流程用 mermaid、結果用表格，純文字每節最多三句。
Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。
|
2026-09-01 12:11:26 +08:00 |
|