返回目錄

agent-crop

精選清單收錄維護狀態: 活躍

oriliz/agent-crop

給 AI 程式設計助手一根馬鞭:本地記錄時間去向,把復盤寫回 agent 指令/技能/工具;改沒改好,用資料說話。 | A whip for coding agents: local timing, red-line nudges, and an evidence-backed, auditable self-improvement loop. DSH / Claude Code / Codex.

前往 GitHub
$ dsh plugin --profile <你的 profile> add agent-crop-dsh

171

星數

0

Fork

Python

語言

MIT

授權條款

2026-11-14

建立於

2026-11-20

最近推送

MIT 授權、以本機為優先的 agent 觀測外掛,執行於 DeepSeek Harness(也支援 Claude Code):量測工作階段時間去向、偏離時鞭策、把檢討寫回指令與技能,資料只存本機 JSONL,不上傳、不打分。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-20

授權條款

MIT

01它能幫你完成什麼?

  • 釐清一次 agent 工作階段的時間到底花在哪

    本機時間軸:每次工具的名稱與成敗、每一輪的停止時點 `stop`、你發下一句時的 `prompt` 與 `user_wait` / `idle_gap`、返工訊號,在工作階段頁 Crop 頁籤與跨工作階段 Crop 全域檢視裡看

    長時間跑 agent、分不清是它慢還是自己在想的開發者

  • 把每次工作階段變成一條可驗證的小改動,落到指令、技能或工具上

    一次 `crop_update` 自述(階段、任務、`cause` / `category`、下一步)加一份工作總結,`crop ledger` 用事件日誌記住改了什麼、憑什麼改、有沒有用

    做 harness engineering、把「讓 agent 變好」當成可量測的閉環而不是感覺的人

  • 判斷採集器本身是不是啞了

    `crop health --days 7`(人讀:結論 + 問題 + 每個工具一行)或 `crop health --json`(完整 `health_summary`),也有外掛工具 `crop_health`(參數 `days` / `host`)

    懷疑資料不可信的人——README 就是讓你在這時候呼叫它

02如何將外掛接入 DeepSeek Harness?

安裝步驟

  1. 01

    安裝外掛:`dsh plugin --profile <你的 profile> add agent-crop-dsh`

    $ dsh plugin --profile <你的 profile> add agent-crop-dsh

  2. 02

    重新啟動 dsh,新工作階段生效

  3. 03

    選用:`npm i -g agent-crop-dsh` 讓 `crop` 指令進 `PATH`,或用 `npx --yes --package=agent-crop-dsh -- crop status` 臨時執行

    $ npm i -g agent-crop-dsh

  4. 04

    要改原始碼就先複製再 link:`git clone https://github.com/oriliz/agent-crop.git ~/agent-crop`,然後 `dsh plugin --profile <你的 profile> add ~/agent-crop`

    $ git clone https://github.com/oriliz/agent-crop.git ~/agent-crop

驗證整合成功

  • `crop status` 能執行,最後一行印出真實資料目錄
  • `tail -1 ~/.agentcrop/data/events.jsonl` 裡出現 `"host":"dsh"`
  • `crop health --days 7`(或工作階段裡的 `crop_health` 工具)能回傳健康度摘要

復原

  • 解除安裝外掛:`dsh plugin --profile <你的 profile> remove agent-crop-dsh`
  • 解除安裝不會動到資料;要一起清掉就執行 `rm -rf ~/.agentcrop`

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

以 `agent-crop-dsh` DSH 外掛安裝:把採集協定註冊進系統提示,並在工作階段提供 `crop_update` / `crop_health` 工具與 Crop 面板

  • 被動時間軸採集

    工作階段裡的每次工具回傳、每輪結束、你發的下一句→`tool` 事件(名稱、成功或失敗)、`stop` 停止時點(這一輪的活躍分鐘)、`prompt` 回覆時點(`user_wait` / `idle_gap`)

    每回合注入 100–300 字元往 `~/.agentcrop/data` 追加 JSONL(權限 0700)
  • 鞭策與 AI 主動上報

    長時間沒回話,或越過黃線 / 紅線的工作階段→一句鞭策,接著一次 `crop_update` 上報:`phase`、`cause`、`category`、下一步

    `category` 是鎖死的九類列舉,填錯直接失敗卡住時自述約 50–100 token
  • 兩塊面板

    單一工作階段或多工作階段的事件紀錄→工作階段頁 Crop:工作階段時鐘(活躍 / 等待)、依工作分 lane 的時間軸、鞭策貼紙與次數、檢討與改進;側邊欄 Crop 全域:5 個摩擦指標、每日活躍 / 等待堆疊長條、改進與重複的坑、工作清單

  • 採集器健康度自檢

    `crop health --days 7`、`crop health --json`,或帶 `days` / `host` 參數的 `crop_health` 工具→有效工作階段、收尾比、必採達標、異常工具、依事件類型的覆蓋率,以及一份診斷清單

  • 可量測的自改進閉環

    先前工作階段留下的事件→量測 → 歸因 → 改指令 / 技能 / 工具 → 再量測,每次檢討落成一條可驗證的小改動,記在 `crop ledger` 裡

04適合誰?何時不該用?

適合

  • 長時間跑 agent、分不清是它慢還是自己在想的開發者
  • 做 harness engineering、把「讓 agent 變好」當成可量測的閉環而不是感覺的人
  • 懷疑資料不可信的人——README 就是讓你在這時候呼叫它

不適合

  • 作者自己說這工具還在開發中,README 也點出短處:資料覆蓋率不高(`type` / `difficulty` 經常空著,「上期對比」常常顯示「上期無資料」),健康度門檻(覆蓋 ≥ 80%、欄位完整 ≥ 95%)是先抓的、還沒用真實資料校準,樣本少於 3 個工作階段只回報「樣本太少」。
  • AI 自己填的欄位是判斷,不是事實。README 明確說自述永遠不單獨當結論,要和自動採集的時間、失敗數對照著看。

05相容性、維護與安全提醒

  • 作者自己說這工具還在開發中,README 也點出短處:資料覆蓋率不高(`type` / `difficulty` 經常空著,「上期對比」常常顯示「上期無資料」),健康度門檻(覆蓋 ≥ 80%、欄位完整 ≥ 95%)是先抓的、還沒用真實資料校準,樣本少於 3 個工作階段只回報「樣本太少」。
  • AI 自己填的欄位是判斷,不是事實。README 明確說自述永遠不單獨當結論,要和自動採集的時間、失敗數對照著看。
  • 有成本但很小:每回合注入 100–300 字元,卡住時上報一次約 50–100 token。README 估計一個 20 回合的工作合計約 2k token。
  • 本頁只涵蓋 DeepSeek Harness 的外掛安裝方式。README 把 Claude Code 的安裝指向 `docs/INSTALL.md`,那邊走 MCP(`crop_health` 與 `crop_update` 並列暴露);健康度檢視的主機下拉依 dsh / claude-code 分開看,`crop_health` 工具也接受 `host` 參數。
2026-11-142026-11-17v0.8.4

MIT · 活躍維護中(最新版本 v0.8.4,2026-11-18)

06常見問題

在 DSH 裡怎麼安裝?

執行 `dsh plugin --profile <你的 profile> add agent-crop-dsh`,然後重新啟動 dsh,新工作階段生效。從 npm 裝的是預先建置的產物:不需要在你的機器上跑建置腳本,也不用放行 pnpm 的 `allowBuilds`。

需要改 AGENTS.md 或設定嗎?

不用。README 說協定透過外掛註冊進系統提示,解除安裝時會自動移除,所以既沒有要改的設定,也沒有要補進 `AGENTS.md` 的內容。

怎麼確認它真的在記錄?

執行 `crop status`,最後一行會印出真實的資料目錄;再看 `tail -1 ~/.agentcrop/data/events.jsonl`,應該出現 `"host":"dsh"`。`crop` 指令隨 npm 套件發布,但 `dsh plugin add` 不會把它放進 `PATH`:可以 `npm i -g agent-crop-dsh`,或用 `npx --yes --package=agent-crop-dsh -- crop status`。

資料存在哪裡?

只在這台機器上:`~/.agentcrop/data`,權限 0700,可用 `KIT_DATA_DIR` 覆寫,不存對話正文。舊的資料目錄名稱是 `~/.ai-coding-efficiency`,如果本機還沒有 `~/.agentcrop`,以 `crop status` 最後一行印出的真實路徑為準。

可以調它催得多兇嗎?

可以。在側邊欄「外掛」頁展開 Agent Crop 那一列、點「設定」,在「鞭策風格」裡切換,儲存即生效、不用重新啟動。只有預設的「奴隸主」是真的鞭策,和藹的前輩、經驗豐富的同事、放任自由的家長這三檔只是提醒;想改提醒裡的台詞,把 Markdown 放進 `~/.agentcrop/templates/voice/*.md`,但這個覆寫只對預設風格有效。

08資料與來源

  • 作者聲明github.com57330c355cfc…

    dsh plugin --profile <你的 profile> add agent-crop-dsh

  • 作者聲明github.com57330c355cfc…

    被抽完,AI 要**反思与上报**——调 `crop_update` 写下 `cause` / `verdict` / `category`,这是整条链上唯一由 AI 主动补的动作。

  • 作者聲明github.com57330c355cfc…

    DSH 插件:工具 `crop_health`(参数 `days` / `host`),怀疑数据不可信时直接调。

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。