 jiantw83
|
02bfc70f4e
|
fix(assistant): 讓執行路徑走錯與警示原因都看得見
兩支腳本開跑就檢查自己的執行路徑，監控頁的摘要表與最新一輪那一塊補上
「警示來源」。
兩件都是實測之後補的。用全新的 CLI 行程跑，代理人會把工具路徑解回外掛
快取那一份，不是指定的工作樹那一份。原本的對策只在技能說明書裡寫明禁
止，那是文件約束，擋不住真的走錯的那一輪。權限閘門只放行 current 那一
組確切路徑，走錯就被靜靜擋掉，那一輪不寫心跳，外面只看得到心跳過期。
另一頭，沙箱跑出來的摘要列是「警示、四項全過、待人處理 0」，讀的人看
不出警示哪來。查過不是缺陷：四項來源都讀得到，是讀到的內容有警示。摘
要表的用途本來就是一眼看出從哪一輪開始壞，少了原因那一欄就做不到。
巡檢與排程兩支腳本開跑時先比對自己是不是從 current 底下被叫起來的，不
是就往 stderr 印一行警告，點名實際路徑、應該用的路徑與理由。刻意只警告
不中止：從工作樹直接跑腳本是開發時的正當用法，中止會把那條路擋掉，真
正的失敗本來就發生在權限閘門那裡。摘要表從四欄加到五欄，最新一輪那一
塊也補一列，值取每一處設警示時收下來的短理由，多個用頓號串，沒有就寫
「無」。腳本裡每一處把判定改成警示的地方，一律改走同一支函式順手收下
理由，collect 的輸出多印一行 warn_sources。技能主文、行為清單與監控頁
範本跟著寫明這兩件事。
功能範圍是助理的一輪巡檢與系統排程安裝。
|
2026-09-01 18:54:05 +08:00 |
|
|
jiantw83
|
3b86674d1b
|
fix(schedule): 讓排程那一輪自己帶齊環境與權限
排程條目改成自己帶齊執行環境，install 完也印出那一輪要開的權限規則。
背景助理在無人值守的輪次連續失敗，查出四道關卡。cron 給的 PATH 很短，
不含使用者的 bin 目錄，裸的指令名每一輪都是找不到執行檔。cron 也不讀
殼的設定檔，那一輪沒有 Gitea 主機位址與 wiki 存放庫變數，連不上 wiki。
寫入確認只認 tty，排程沒有 tty，寫監控頁一定被擋。工具權限沒開，巡檢
腳本連跑都跑不起來，而那一輪沒有人可以按同意。四關任何一關沒過，那一
輪就不寫心跳，排程裝著卻永遠空轉，外面只看得到心跳過期。
CLI 改用 command -v 解成絕對路徑再寫進條目，解不到就停下，不猜路徑。
install 當下把主機位址、金鑰、狀態根目錄、心跳門檻與所有已設定的 wiki
存放庫變數就地快照，以名稱等於值的前綴寫進條目，值裡的單引號照 POSIX
寫法跳脫。條目自帶寫入確認旗標，無人值守的那一輪本來就沒有人可以按同
意。install 完印出四支腳本各三種呼叫形式的 allow 規則，路徑一律取
current 那一組不帶版本的連結，並順手檢查連結在不在，不在只警告、不代
建。腳本內部找心跳腳本也改成 current 優先，避免同一輪跑到混版的工具。
條目裡帶著金鑰快照，所以印條目時一律把金鑰遮成星號，遮到下一個空白為
止；crontab 檔案要保持只有本人讀得到，這幾個變數改過就要重跑一次
install。功能範圍是助理的系統排程安裝、移除與查現況。
|
2026-09-01 18:28:04 +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
|
7343def16e
|
feat(schedule): 助理的系統排程接線
What：
- 新增 tools/schedule.sh，三個子命令：install 安裝、remove 移除、status 查現況。兩筆工作分別是每分鐘的心跳與每十五分鐘的巡檢。
- 助理主體的 start 接上安裝、stop 接上移除，行為清單與 README 跟著更新。
Why：
- 心跳要有人定時寫，不然啟動之後過幾分鐘就自己過期，助理看起來像沒在跑。
- 排程這件事有標準的輸入與輸出，準則要求下放腳本，技能只描述何時呼叫。
How：
- 條目行尾帶固定標記，安裝先濾掉自己的舊條目再追加。絕不覆寫整份排程，別人的條目一行都不碰；寫完回讀驗證，出現兩筆或別人的行數對不上就報錯。
- 裝完檢查排程服務在不在跑。這台機器是 WSL，預設不啟動 cron，裝了條目卻一次都不會執行——不檢查就會宣稱一件沒發生的事。
- 條目一律帶 </dev/null。排程是非互動環境，任何等輸入的東西都會把整筆卡死。
- 輸出寫到 JSC_HOME 底下，不寫進任何專案目錄，免得多出未追蹤檔污染別人的變更盤點。
- 巡檢那一筆預設不裝，要明著指定才會裝。巡檢本體還沒實作，裝了只會每十五分鐘失敗一次；巡檢指令也不猜 CLI，判不出來就停下，猜錯的代價是每十五分鐘跑一支不存在的執行檔。
- stop 先移除排程再清心跳，順序不能反。反過來的話清完下一分鐘排程就補寫一次，stop 等於騙人。
Who：
助理落地的第三塊。這裡留下一個要在巡檢那一輪解掉的問題：心跳目前由排程直接寫，所以心跳新鮮只證明排程活著，不證明助理做了事。往後應該改由巡檢跑完那一輪去寫，心跳才等於工作訊號。限制已寫進技能內文與說明文件。
|
2026-09-01 14:34:12 +08:00 |
|