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?
安裝步驟
- 01
安裝外掛:`dsh plugin --profile <你的 profile> add agent-crop-dsh`
$ dsh plugin --profile <你的 profile> add agent-crop-dsh
- 02
重新啟動 dsh,新工作階段生效
- 03
選用:`npm i -g agent-crop-dsh` 讓 `crop` 指令進 `PATH`,或用 `npx --yes --package=agent-crop-dsh -- crop status` 臨時執行
$ npm i -g agent-crop-dsh
- 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 整合程度與能力邊界
以 `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` 參數。
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`,但這個覆寫只對預設風格有效。
07相關的 DSH 工作流程
dsh-our-free-model
作者 ebony-vinyl
在 dsh 裡裝上這個外掛即可,無需登入、註冊或填 API Key,就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在內的前沿模型——完全免費,不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness(dsh)路由套件:先裝執行時注入器,再載入任務感知的推理模式路由預設(已實測 P1-P23)。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底層操作工具外掛,旨在減少 Token 消耗與任務耗時
dsh-connect-workbuddy
作者 dingminhua
將本地登入的 WorkBuddy 模型接入 DeepSeek Harness,並提供只讀額度概覽與模型管理。
08資料與來源
dsh plugin --profile <你的 profile> add agent-crop-dsh
被抽完,AI 要**反思与上报**——调 `crop_update` 写下 `cause` / `verdict` / `category`,这是整条链上唯一由 AI 主动补的动作。
DSH 插件:工具 `crop_health`(参数 `days` / `host`),怀疑数据不可信时直接调。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
