釋出：到期清單的路徑一律由呼叫端餵進來，並拒跑過舊的清單 #37

2026-09-07T01:24:26Z

jiantw83 commented

2026-09-07 01:24:26 +00:00

摘要

需求描述：把 develop 累積的變更釋出到 master。執行到期內建項那一支從上線到現在，每一輪讀的都是一份放了 67 小時的舊清單，其中一輪還跑了一筆已經被移除的待辦。
計畫名稱：無
計畫頁：無
分析頁：無

這一批的內容

變更	為什麼
巡檢那一步轉出機器可讀的到期清單路徑	本來只轉出給人看的那個檔案，機器可讀的那一份被吞掉了
執行那一支拿掉清單路徑的預設值	預設指向的位置跟判到期那一支的實際輸出不是同一個地方
清單比心跳門檻還舊就拒跑	判到期與執行之間隔著呼叫端，那一段有可能斷掉

版號 0.2.7 到 0.2.8。

兩邊各自預設了不同位置

判到期與執行是兩支腳本，中間靠一個檔案交棒：

誰	位置
巡檢叫判到期，用 `--out`	那一輪自己的暫存目錄
執行那一支的預設	助理狀態目錄底下那一份

不是同一個地方。所以執行那一支每一輪讀的都是「上一次有人手動跑判定留下的那一份」。

為什麼 67 小時都沒被發現

那份舊清單產生的當下是對的，內容剛好沒變，所以每一輪的報告都合理：到期 15 筆、跑 2 筆、代不出目標 1 筆，數字都對得上。

顯形是因為手動跑了一次重新種入，那一筆的識別碼跟著換了。下一輪的報告仍然報著舊識別碼——它跑了一筆已經不存在的待辦，那才看得出讀的不是同一份資料。

拿掉預設值，不留退路

少帶那個選項就回用法錯誤。吵一次總比安靜地對舊資料動手好——而且預設值指向的位置在單機手動跑過一次之後就會有檔案，那個檔案讀起來跟新的一模一樣。

門檻取心跳的過期門檻：那是這台機器認定「一輪跑完的紀錄還算新鮮」的長度，一份比它還舊的到期清單本來就不可能是這一輪產生的。讀不到門檻就退回 300 秒，跟心跳那一支的預設一致。

測試結果

情況	結束碼
不帶那個選項	6，訊息說明為什麼不猜
清單不存在	2
兩小時前的清單	2，訊息帶出實際秒數與門檻
新的空清單	0

拿真機那份 67 小時前的舊清單餵進去，確實被擋下，訊息印出 241795 秒與門檻 2100 秒。
門檻正確讀到這台機器實際生效的 2100 秒，不是寫死的預設。
時效檢查那一段的位置改過一次：第一版排在必要變數與工具搜尋函式定義之前，set -u 之下會直接炸。移到兩者之後才通過。
四支檢核腳本都回結束碼 0。

前置 Push Request

無

## 摘要 - 需求描述：把 develop 累積的變更釋出到 master。執行到期內建項那一支從上線到現在，每一輪讀的都是一份放了 67 小時的舊清單，其中一輪還跑了一筆已經被移除的待辦。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 這一批的內容 | 變更 | 為什麼 | | --- | --- | | 巡檢那一步轉出機器可讀的到期清單路徑 | 本來只轉出給人看的那個檔案，機器可讀的那一份被吞掉了 | | 執行那一支拿掉清單路徑的預設值 | 預設指向的位置跟判到期那一支的實際輸出不是同一個地方 | | 清單比心跳門檻還舊就拒跑 | 判到期與執行之間隔著呼叫端，那一段有可能斷掉 | 版號 0.2.7 到 0.2.8。 ## 兩邊各自預設了不同位置判到期與執行是兩支腳本，中間靠一個檔案交棒： | 誰 | 位置 | | --- | --- | | 巡檢叫判到期，用 `--out` | 那一輪自己的暫存目錄 | | 執行那一支的預設 | 助理狀態目錄底下那一份 | 不是同一個地方。所以執行那一支每一輪讀的都是「上一次有人手動跑判定留下的那一份」。 ## 為什麼 67 小時都沒被發現那份舊清單**產生的當下是對的**，內容剛好沒變，所以每一輪的報告都合理：到期 15 筆、跑 2 筆、代不出目標 1 筆，數字都對得上。顯形是因為手動跑了一次重新種入，那一筆的識別碼跟著換了。下一輪的報告仍然報著舊識別碼——**它跑了一筆已經不存在的待辦**，那才看得出讀的不是同一份資料。 ## 拿掉預設值，不留退路少帶那個選項就回用法錯誤。**吵一次總比安靜地對舊資料動手好**——而且預設值指向的位置在單機手動跑過一次之後就會有檔案，那個檔案讀起來跟新的一模一樣。門檻取心跳的過期門檻：那是這台機器認定「一輪跑完的紀錄還算新鮮」的長度，一份比它還舊的到期清單本來就不可能是這一輪產生的。讀不到門檻就退回 300 秒，跟心跳那一支的預設一致。 ## 測試結果 | 情況 | 結束碼 | | --- | --- | | 不帶那個選項 | 6，訊息說明為什麼不猜 | | 清單不存在 | 2 | | 兩小時前的清單 | 2，訊息帶出實際秒數與門檻 | | 新的空清單 | 0 | - **拿真機那份 67 小時前的舊清單餵進去，確實被擋下**，訊息印出 241795 秒與門檻 2100 秒。 - 門檻正確讀到這台機器實際生效的 2100 秒，不是寫死的預設。 - 時效檢查那一段的位置改過一次：第一版排在必要變數與工具搜尋函式定義之前，`set -u` 之下會直接炸。移到兩者之後才通過。 - 四支檢核腳本都回結束碼 0。 ## 前置 Push Request - 無

jiantw83 added 3 commits 2026-09-07 01:24:27 +00:00

fix(執行): 到期清單的路徑一律由呼叫端餵進來，並拒跑過舊的清單 ccb28e2bb3

判到期與執行是兩支腳本，中間靠一個檔案交棒。判到期那一支是被巡檢用 --out
叫的，輸出寫進那一輪自己的暫存目錄；而執行那一支留了一個預設路徑，指向助理
狀態目錄底下那一份。兩邊不是同一個位置。

於是執行那一支從上線到現在，每一輪讀的都是「上一次有人手動跑判定留下的那一
份」。實測那份清單在機器上放了 67 小時，每一輪都被拿去動手，其中一輪還跑了
一筆已經被移除的待辦——那一筆的識別碼在重新種入時換過了。

而它看起來完全正常。那份舊清單產生的當下是對的，內容剛好沒變，所以每一輪的
報告都合理。錯了 67 小時才顯形。

兩處改動。判到期那一步本來只把給人看的那個檔案轉出去，機器可讀的那一份被
吞掉了，現在一起印成 due_rows_file=。執行那一支拿掉預設值：少帶那個選項就
回用法錯誤，吵一次總比安靜地對舊資料動手好。

另外加一道時效保護。判到期與執行之間隔著呼叫端，那一段有可能斷掉——判定失敗
了而那一輪照樣往下走，或呼叫端餵進上一輪的路徑。門檻取心跳的過期門檻：那是
這台機器認定「一輪跑完的紀錄還算新鮮」的長度，一份比它還舊的到期清單本來就
不可能是這一輪產生的。讀不到門檻就退回 300 秒，跟心跳那一支的預設一致。

實測：不帶選項回 6，清單不存在回 2，兩小時前的清單回 2 且訊息帶出實際秒數與
門檻，新的空清單回 0；拿真機那份 67 小時前的舊清單餵進去，確實被擋下。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs(assistant): 執行那一步要把同一輪的到期清單路徑餵進去 4562da2bea

巡檢步驟五改成帶 --rows，值取步驟一印的那個新欄位，並寫明那不是選用的、
也沒有預設值。步驟一的記錄清單跟著補上那個欄位，並註明它是空的時候代表判到期
那一步沒有產出清單，步驟五就沒有東西可動，要照實說而不是退回任何預設。

會把「為什麼不能有預設」寫進本文，是因為這個缺陷的形狀值得留下來：預設值指向
的位置在單機手動跑過一次之後就會有檔案，而那個檔案讀起來跟新的一模一樣。

三份 manifest 版號 0.2.7 升到 0.2.8。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Merge pull request '到期清單的路徑一律由呼叫端餵進來，並拒跑過舊的清單' (#36 ) from fix/run-due-rows-path-must-be-passed-in into develop 0df1605a20

Reviewed-on: #36

admin approved these changes 2026-09-07 01:25:44 +00:00

admin merged commit 00ace7bead into master

2026-09-07 01:25:47 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/assist#37