搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

oriliz/agent-crop

开发工具

给 DSH 和 Claude Code 的编程会话做本地计时与复盘,把时间去向变成可验证的指令改进。

170
0
Python
MIT
创建于 6 天前

项目介绍

Agent Crop 是一个面向 AI 编程会话的观测与复盘插件,当前支持 DeepSeek Harness(DSH)和 Claude Code。它想回答一个具体问题:一个下午的活跑下来,时间到底花在模型慢、工具反复失败,还是在等你回话上。

它按「测量 → 归因 → 优化 → 验证」走一条闭环:宿主自动记录结构化事件,超时鞭策后由 AI 写下卡点原因,改进落到指令、技能或工具上,再用同一套指标复核。数据只写本机 ~/.agentcrop/data(权限 0700),不上传,也不产出效率分或排行榜。

快速使用

先装 DSH 插件,再重启 harness 让新会话生效:

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

npm 包是预构建产物,不需要在本机跑构建脚本,也不需要给 pnpm 的 allowBuilds 放行,装完不用改 AGENTS.md。要改源码则克隆后本地安装:

git clone https://github.com/oriliz/agent-crop.git ~/agent-crop
dsh plugin --profile <你的 profile> add ~/agent-crop

crop 命令随包发布,但 dsh plugin add 不会把它放进 PATH。可选全局安装后做自检:

npm i -g agent-crop-dsh
crop status
tail -1 ~/.agentcrop/data/events.jsonl

crop status 最后一行会打印真实数据目录;历史目录名是 ~/.ai-coding-efficiency,也可用 KIT_SHARED_HOME 或 KIT_DATA_DIR 覆盖。Claude Code 的安装方式在单独的安装文档里说明。

记录什么

宿主侧自动采集:会话开始与任务起点、每次工具调用的名称和成败、每轮时长、你两次发言之间的等待(超过 15 分钟记为 idle_gap)、超时提醒是否注入,以及同工具反复失败这类返工信号。AI 主动上报 phase(start/progress/blocked/end)、task_id、summary、cause、next、category(九类固定枚举,如 tool-misuse、spec-drift、serial-wait)、goal、type 和 difficulty。

自述被当作判断而不是事实,需要与自动采集的时间和失败数对照。不保存对话正文。

查看结果

面板有两个入口:会话页 Crop 页签看单个会话的活跃/等待时钟、按工作分 lane 的时间轴、鞭策标记和本会话的反思;侧边栏 Crop 全局看摩擦指标、每日活跃与等待堆叠柱、重复出现的问题和健康度视图。健康度也可用命令或交给 agent 调用:

crop health --days 7
crop health --json

DSH 里的工具名是 crop_health,Claude Code 通过 MCP 暴露,与 crop_update 并列。

使用约束

  • 宿主目前是 DSH 和 Claude Code 两个。
  • 作者自己说明数据覆盖率不高,type/difficulty 常为空,verdict/rework/improve 的样本更少,所以「上期对比」经常显示无数据。
  • 健康度阈值(覆盖 ≥ 80%、字段完整 ≥ 95%)是暂定值,尚未用真实数据校准;样本少于 3 个会话时只报样本太少,不下结论。
  • 全局面板没有导出功能,也没有云端和团队看板。
  • 卸载插件不会删除数据,需要 rm -rf ~/.agentcrop 才会一并清掉。

鞭策风格

在侧栏「插件」页展开 Agent Crop 行、点「配置」,可在「鞭策风格」里切换并保存生效:奴隶主(默认,带红线鞭策)、和蔼的前辈、经验丰富的同事、放任自由的家长。后三档只是换语气或提醒方式,不算鞭策。默认风格的台词可用 ~/.agentcrop/templates/voice/ 下的 Markdown 覆盖。

HotRepo 点评

站内记录显示,2026-11-20 02:46 到 04:16 UTC 之间该仓库从 123 星升到 136 星;同一天的新项目快照给出 136 星、该窗口新增 13 星。观察窗口只有一个半小时左右,说明这是一次短时上升,还谈不上稳定走势。项目自己在文档里直说事件覆盖不足、阈值未校准,这正是判断它能否可靠定位时间浪费的关键依据。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. ccch1mneyyy/dsh-Go把 DeepSeek Harness 编码智能体装进 Android 手机,支持本机运行或远程连接电脑主机。Dart19,726
  2. zeronsh/zeron一个本地优先的编码 Agent 控制台,让你在桌面或服务器上统一运行、查看并可选同步多个 Agent。Rust3,395
  3. QwenLM/qwen-code一个运行在终端里的 AI 编程智能体,可读取、修改、运行和审查代码,并提供编辑器、桌面、网页和聊天入口。TypeScript28,828
  4. AI4XE/Parallax为 AI 编程助手提供一套从需求澄清、独立审查到执行审计的插件式工作流。Python110
  5. MiniMax-AI/mcode-stack安装 MiniMax Code 团队自用的编程 Agent 技能与工作流,用来规范规划、评审和长会话管理。Python150