dsh-interval-injector

interval-injector

定期把一段文字注入對話歷史的通用注入器（DSH / Cordis agent plugin）。

為什麼需要它

system prompt 每輪都重送，但它永遠在整串對話的最前面；對話一長，指示就被後面的內容稀釋。

這支外掛每隔 N 個步驟、或每隔 N 分鐘（哪個先到算哪個），把 config.text 當成一則 user-role 訊息插進對話中間——最靠近模型回答的位置。內容不綁用途，換 text 就是換用途。

安裝（DSH 0.2 以上）

dsh plugin --profile web add github:rainfishs/dsh-interval-injector

--profile 後面換成你要掛的 profile 名。也可以直接在 GUI 的插件頁貼 https://github.com/rainfishs/dsh-interval-injector 或本機的絕對路徑。

本套件宣告 dsh.bundle.patch，安裝後是 profile 的一層組合包： cordis.patch.yml 會插一行 interval-injector，所有 session 都會生效。

0.1 的舊用法是把它掛在 agent preset 的 row；0.2 起它自己就是組合包， 安裝完就生效，不必再手改 preset。

設定欄位

插進來的 row 沒有任何 config，文字屬於部署而不屬於套件， 所以在 profile 自己的 cordis.patch.yml 覆蓋同一行：

- id: interval-injector
  name: interval-injector
  config:
    everyNSteps: 20
    refreshIntervalMs: 1800000
    text: |
      （想定期重貼的內容）

config 是整塊取代，不是深度合併 —— 覆蓋時要把需要的欄位全部寫出來。

設定

欄位	預設	說明
text	（必填）	每次要注入的文字。空字串＝外掛不作用。
everyNSteps	12	每隔幾個「進入步驟」注入一次。0 = 關掉這個條件。
refreshIntervalMs	600000	距上次注入超過幾毫秒就注入。0 = 關掉這個條件。
summary	定期注入	收合在對話列上的單行說明。

everyNSteps 與 refreshIntervalMs 是「哪個先到就先注入一次」；兩個都設 0 等於關掉整支外掛。

實作注意

• 監聽 agent/pre-step（waterfall），next() 之後才把訊息接在尾端，並以 { prepend: true } 註冊，排在最靠近模型回答的位置。
• 空回合與被拒絕的回合都不注入，免得無中生有一個請求。
• 每個 agent 各自用 WeakMap 計數，session 結束就回收；外掛停用時監聽隨 fiber 一起移除。
• 零依賴：訊息結構自行建立（randomUUID + 遞迴凍結），純 JS 即可執行，不需要 build。
• 訊息 source 用自己的 kind：{ kind: 'interval-injector', form: 'notice', summary }（0.2 已沒有共通的 plugin kind）。

License

MIT