返回目录

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 · 活跃维护(最新 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`,但这个覆盖只对默认风格有效。

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 插件,绝不滥发。