  jiantw83andClaude Opus 5
|
3784cb51be
|
fix(schedule): 補印執行那一支的允許規則，並回頭比對本文叫得到的每一支
巡檢多了執行到期內建項那一步，而印允許規則的清單是寫死的、沒跟著加。少一條
的代價不是報錯：那一輪停在權限詢問，鎖已經握在手上，接下來每一輪都讓開到鎖
逾時為止，而外面只看得到「心跳過期」。
補上那一條之後順手做掉根因。清單寫死，技能本文哪天多叫一支腳本這裡不會自己
知道，所以印完回頭掃一次本文，把它叫的每一支跟印過的比對，缺的逐支點名。
三個實作決定都是被自己踩出來的：
只掃 patrol 那一節，不掃整份。start 與 status 兩個操作都有人在現場，它們叫的
腳本跳一次權限詢問有人按得掉。整份掃會讓那幾支每次都被報成缺規則，而一份
每次都有雜訊的警告，看的人第二次就會跳過它——那時候真的漏一支就沒有人看得到。
技能本文的目錄名兩種版面都找：安裝版面帶 jsc- 前綴，開發用的並排工作目錄
版面不帶。原本只認一種，於是在另一種版面底下這道檢核被檔案存在檢查靜靜跳過
——一道「找不到就當通過」的檢核，跟沒有那道檢核是同一件事。找不到就明說這
一次沒有比對過，不要不出聲。
只警告不中止。比對規則有可能跟不上本文的寫法，那時候不該連排程都裝不起來。
三份 manifest 版號 0.2.3 升到 0.2.4。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 14:15:43 +08:00 |
|
|
jiantw83andClaude Opus 5
|
c76e8489a6
|
fix(schedule): 排程條目不再寫死工作階段代號，CLI 判定跟上共用函式
兩個坑，都在同一支腳本，都讓無人值守那一輪看起來正常卻不正常。
一、條目寫死了工作階段代號。那一輪的兩半因此落在不同的值上：start 由 hook
寫，它從 hook 的標準輸入 JSON 讀得到 CLI 真正的代號；end 由工具腳本寫，沒有
那份 JSON，只能讀環境變數，於是讀到寫死的那個字串。配對的判準是工作階段
代號加技能名，兩半的代號不同就永遠配不起來。
這台機器上實測累積了 91 筆假的「只有 start 沒有 end」，其中 90 筆是同一支
每輪都會被叫用的技能。逐個工作階段數下來：92 個是一個 start 零個 end，另有
一個工作階段收著 29 個 end 卻一個 start 都沒有——那一個就是寫死的代號。
代價不只是數字難看。那一節存在的理由正是「只有 start 沒有 end 是一支技能
中止的唯一證據」，而這批假訊號只增不減，遲早把真的中止蓋掉。不設這個變數，
兩半就都落在 CLI 自己給的代號上，實測驗過確實配得起來。
二、CLI 判定抄了一份較窄的。共用函式認三個環境標記，這一份只認第一個，而
工具腳本被叫用時那一個不會設。於是每一次不帶 --cli 的安裝都回用法錯誤——
技能本文的啟動步驟叫的正是不帶 --cli 那一種，這台機器上一定裝不起來。同一個
判斷寫兩份就是這樣漂走的：共用函式後來補了兩個標記，這一份沒跟上，而漂移
的代價是一個看起來像「這台機器沒裝 CLI」的錯誤。
殘留的那 91 筆不必手動清，那一支本來就會把開超過一天的丟掉，一天內收斂。
三份 manifest 版號 0.2.1 升到 0.2.2。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-09-04 12:29:20 +08:00 |
|
|
jiantw83
|
fb8b9baedd
|
fix(assistant): 巡檢改用字面絕對路徑，根目錄由排程條目帶進來
無人看管的排程輪次在第一支腳本就被權限層擋下。心跳因此寫不出來，助理斷了兩個多小時，沒有人發現。
2026-09-02 到 09-03 用非互動模式比照排程環境實測七種寫法，歸納出兩條判準。一、無人值守時只有允許清單上的完整字面指令跑得動，沒有「預設安全的唯讀指令」這回事，連 readlink 與 ls 都要有自己的規則。二、路徑中段的萬用字元不匹配，規則與指令都必須是完整字面，所以帶版本號的快取路徑放不進允許清單。「先解路徑再用」因此不成立：解路徑的指令自己就過不了，而路徑能寫成字面就不必解。
助理技能新增路徑守則與 Step 0。守則寫明權限層比對的是指令還沒展開的字面字串，帶未展開變數或波浪號的路徑一律要核准，並附上七列實測佐證表。Step 0 從「自己跑 readlink 解路徑」改成「從叫用文字的『工具根目錄=』取字面絕對路徑」，排程那一輪一個解析指令都不跑；人在現場叫用才用 readlink 解一次，那一次有人可以按同意。取不到根目錄就停下回報，收尾狀態取 aborted，不猜也不退回帶變數的路徑。全篇 46 處腳本呼叫改成字面絕對路徑。
排程工具在安裝時把解好的字面根目錄寫進條目的提示文字，並印成 patrol_root=。條目與允許規則共用同一個值，兩邊各算各的就會差開，而差開的那一輪是被靜靜擋掉。允許規則的提示改成完整字面路徑，不寫變數、波浪號與萬用字元。JSC_HOME 解不出絕對路徑時回結束碼 6，不讓相對路徑寫進條目。自訂巡檢指令沒帶那一段只警告、不中止。
行為契約四列與說明文件兩處敘述一併跟上。
|
2026-09-03 10:10:01 +08:00 |
|
|
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
|
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 |
|