Hermes 操作者可以把經過審查的 skill 附加至週期工作,讓每次執行從相同程序開始。真正有用的檢查是:一次排程執行是否讀取獲准的輸入、產生合格的本機報告,並記錄實際使用的模型與主機。本指南適用於能掌控 Hermes 設定環境、供應商帳戶及閘道主機的操作者。BIG CHANGE 於 2026 年 10 月 19 日查閱了官方 cron 手冊與相關文件;我們沒有安裝 Hermes,也沒有執行工作。

關鍵變化

  • 有何改變: Hermes 能在排程提示之前載入經審查的 skill,在選定工作區執行,並把結果儲存在本機。操作者可以建立暫停中的工作,檢查後再以同一工作 ID 恢復執行。
  • 為何重要: 可重複的資訊工作能採用同一套經審查程序。不過,操作者仍須把一次到期執行與獲准輸入核對;已儲存的排程無法證明實際執行的 skill 版本或模型,也不能證明報告正確。
  • 應注意什麼: 能否繼續使用,取決於閘道主機是否保持可用,以及首次執行是否符合報告標準。讓工作維持啟用前,請檢查該次嘗試、輸出及可取得的供應商與模型證據;發生任何中斷後,都要重新檢查確切狀態。

開始排程之前

選擇一個小型且獲准使用的輸入檔案,以及現有、隔離的工作區。定義一份正確的簡短報告應包含什麼、如何引用輸入,以及缺少哪些資料時必須停止。首次工作只處理資訊:不得對外發布、變更紀錄,或在輸出中包含機密。另行取得週期執行的授權。您也需要已設定的 Hermes、可用的模型與供應商連線及憑證,以及能在排程執行期間保持可用的閘道主機。檢查已安裝版本與 hermes cron create --help,因為公開手冊沒有逐項註明選項的版本。快速入門指南介紹初始設定;供應商指南介紹推論途徑。可先透過一次無風險的單次對話檢查這條途徑,再設定週期工作,但這不能證明排程執行成功。

一項 skill 是經過審查的 SKILL.md 程序,而不是權限邊界。請將 skills/local-input-report/SKILL.md 放在實際所屬設定環境的 HERMES_HOME 之下;~/.hermes/skills/local-input-report/SKILL.md 是預設設定環境的範例。使用前,先依獲准輸入與報告標準調整以下最小程序:

Markdown
---
name: local-input-report
description: Report checked facts from one approved local input.
---

Read only <absolute-permitted-input-path> in the job workspace. In a short report, name that file, state only facts supported by it, and cite the relevant part. Flag missing data and stop. Do not send messages or change files or external records.

檢查實際檔案,並在同一設定環境中使用 hermes skills list 確認 Hermes 能找到它。如果改用專案本機的 skill,skills 手冊規定,非互動式 cron 執行前必須先進行互動式信任與掃描決定;cron 本身不會授予信任。另行審查已啟用工具與實際檔案存取權。記錄 skill 內容或版本,不能只憑名稱代替審查。

建立一項工作,再進行檢查

  1. 每個命令都必須針對同一所屬設定環境執行:以下範例使用預設環境;具名環境則須在每個命令使用其選擇器,例如 hermes -p NAME。使用 hermes model 檢查該環境的目前模型,並使用 hermes cron status 檢查閘道與定時觸發器的健康狀態。決定要明確固定供應商與模型,還是固定目前主模型。個別工作的固定選擇優先於 cron.model 與 cron.model_provider;這兩個共用工作設定又優先於目前主模型。因此,未固定選擇的工作可能隨適用預設值的改變而更換模型。已儲存的設定仍不能證明實際執行使用哪個模型。
  2. 取得週期執行授權後,請把以下 POSIX shell 命令列範例調整為已審查的 skill,以及現有工作區的絕對路徑。先在已安裝的說明中確認每個參數。範例以反斜線接續各行,屬於 POSIX shell 語法;其他平台請使用相應 shell 的語法。提示刻意限制範圍,而本機交付會把首次輸出保存在所屬設定環境:
Terminal
   hermes cron create "every 1h" \
     "Use the attached reviewed skill to read only the permitted input. Return a short local report with its source and missing-data note. Do not send or change external records." \
     --skill local-input-report \
     --name "Local input report" \
     --workdir "/absolute/existing/workspace" \
     --pin \
     --paused --paused-reason "Awaiting owner review"

執行此命令前,請替換工作區路徑、選擇唯一工作名稱,並替換 skill 檔案內的輸入預留位置。命令列預設採用本機交付。cron 手冊也記載了用來明確固定選擇的 --model 與 --provider。若採用這條途徑,請使用實際安裝環境的供應商與模型識別碼。不要把憑證放入提示或 shell 歷程。--workdir 會讓 Hermes 找到工作區指示;未設定時,cron 會脫離程式碼儲存庫執行。新建且暫停的工作在恢復前不會有 next_run_at。

本機交付只決定最終報告儲存在哪裡。提示與用於推論的任何輸入內容,仍依選定模型與供應商的途徑處理;恢復工作前,須先核准這條資料流。

  1. 保留傳回的工作 ID。使用 hermes cron list 讀回 skill、工作區、交付方式及暫停狀態;使用 hermes cron status 檢查排程器健康狀態。目前的官方 CLI 原始碼不會在清單列顯示已儲存的模型或供應商欄位。請在所屬設定環境中,針對 cron/jobs.json 僅以唯讀方式檢查確切 ID 的紀錄,以核對已儲存的固定選擇、模型、供應商及推論覆寫設定;也可使用已安裝版本確實支援的工作詳細資訊檢視。不要印出憑證。將已儲存設定與獲准檔案、報告標準及範圍核對。必要時,使用 hermes cron edit <job_id> ... 修正同一工作,無須建立第二份。
  2. 準備好觀察到期執行時,請使用 hermes cron resume <job_id>。讀回實際下次執行時刻及閘道最近一次成功觸發時間。閘道大約每分鐘檢查一次;在前景執行的閘道需要主機保持開機。hermes cron tick 不會為代理工作啟動閘道。服務或可跨重啟運作的工作程序各有主機需求,請檢查選定主機,不要假定筆記型電腦關機或重啟後仍保證運作。
  3. 在一個預定時刻到期後,請檢查 hermes cron runs <job_id> --limit 20 及所屬設定環境下 cron/output/<job_id>/ 中的對應檔案。將報告與實際輸入及驗收標準比較。檢查該次嘗試的排程時間、領取時間、最終狀態,以及可取得的逐字紀錄或執行遙測,以確認實際供應商與模型。如果安裝環境的紀錄沒有顯示其身分,請記為未知。排程器的一次觸發、獲准開始的執行,或 completed 狀態,都不能單獨證明報告合格。
  4. 使用 hermes cron pause <job_id> 暫停確切工作,再於 hermes cron list 讀回狀態。這會停止未來的自動排程,但不會終止進行中的嘗試。即使工作已暫停,明確的手動執行仍屬操作者覆寫。保留歷程與本機輸出,再決定工作是否符合驗收標準。

失敗時,復原同一工作

先閱讀確切嘗試及其輸出,再檢查工作的 last_error、last_fire_error 與 last_delivery_error(若有)。hermes cron status 能區分觸發器停止、cron 儲存區無法寫入,以及工作已執行但失敗。改變供應商設定前,先檢查所屬設定環境及閘道主機:互動式 shell 與服務可能讀取不同憑證。只修正受影響設定,再次驗證狀態,並且僅在範圍仍獲核准時恢復同一 ID。若交付結果不明,重試前先檢查預定目的地;介面卡可能已接受傳送,之後才發生逾時。

該 cron 手冊的准入復原章節指出,中斷的執行或找不到的預備觸發會維持暫停以供審查;執行歷程章節則說明,未知嘗試從不自動重跑。重新啟動後,決定如何復原前,先檢查安裝工作之暫停狀態與確切嘗試身分。不要重複觸發活躍嘗試來測試重疊。Hermes 有排程觸發鎖、防止同一工作再次准入的執行中保護,以及可設定的整體並行上限。這些控制不能保證外部系統的效果恰好發生一次。

供應商用量及持續在線的主機都可能產生費用。先處理一份有界輸入,在到期執行後檢查供應商用量,再選擇持續執行的頻率。文件所述執行前的指令碼逾時不會限制 skill 驅動的一輪模型處理或其帳單;清理與閒置限制是另外的控制。提示裡的截止時間只是指示,不是強制支出上限。如果無法容忍沒有明確上限的模型處理或不確定副作用,請保持工作暫停,直到具備適當控制。本指南說明文件記載的行為,並非實測執行、價格、可靠性結果或節省承諾。