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 · 活跃维护(最新 release 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 个值得优先安装的插件,覆盖各个分类。
