Shepherd CLI命令速查表init、doctor、run、changeset、trace完整参考【免费下载链接】shepherdA runtime substrate that turns an agents execution into a reversible, Git-like trace, so meta-agents can observe, fork, replay, and revert any run. Couples agent and environments in a copy-on-write fork ~5x faster than docker commit, with ~95% KV-cache reuse on replay. Framework built for meta-agents to supervise, optimize, and train other agents项目地址: https://gitcode.com/gh_mirrors/shepherd16/shepherdShepherd 是一个面向元代理meta-agent的运行时底座它把 AI 代理的执行过程变成可回滚、可分支的 Git 式执行轨迹trace让上层代理能观察、fork、重放和撤销任意一次运行。本文是Shepherd CLI 命令速查表覆盖init初始化工作区、doctor环境体检、run检查运行、changeset只读变更集与trace执行轨迹这 5 组核心命令帮你 5 分钟上手全部日常操作。30 秒建立心智模型 先记住两条黄金规则后面所有命令都围绕它们展开读取 vs 结算读取类命令show、changeset、trace等接受--latest或运行 ID 短前缀结算类命令select/apply/release/discard要求精确的运行标识拒绝模糊选择器——一次结算后其他结算命令即拒绝consume-once。run start是围栏兼容入口正常启动走 Python 侧workspace.run(...)CLI 的start除非设置SHEPHERD_ENABLE_FENCED_RUN_START1否则默认拒绝执行fail closed。命令名为shepherd也安装为短别名sp本文两者通用。shepherd init一键初始化 Shepherd 工作区init把指定目录初始化为 Shepherd 工作区创建或复用.vcscore目录、校验工作区控制基底且不触碰普通 Git 历史。选项说明[PATH]目标目录默认当前目录--backend [auto\|clonefile\|fuse\|kernel\|copy]文件系统载体后端默认auto--adopt [none\|git-head\|worktree]把已有项目基线纳入 Shepherd 托管默认worktree--init-git / --no-init-git目录不在 Git 仓库内时是否自动git init默认开启典型流程sp init sp doctor # 体检确认就绪 sp run list # 查看运行摘要init完成后会打印 Next 步骤指引demo 脚本 运行列表。注意包脚手架请走sp package init NAME与init区分。实现见 init.py。shepherd doctor快速体检环境是否就绪doctor检查当前目录是否满足 quickstart 条件核心检查项python≥ 3.11cwd / git当前目录存在且位于 Git 仓库内vcscore存在.vcscore否则提示运行sp initworkspace工作区能否成功激活可指定--backend强制验证某个后端常用选项选项说明--json输出机器可读的就绪 JSON方便脚本判断--backend [auto\|clonefile\|fuse\|kernel\|copy]指定要验证的工作区后端claude子命令额外检查 Claude 运行通道native jail、claudeCLI、认证状态加--probe可做一次联网探测全部通过打印Ready.否则Not ready.并以退出码 1 结束——非常适合放进 CI。源码参考 doctor.py。shepherd run检查运行、查看 trace 与结算输出run是最大的命令组按用途分四类。只读检查list、show、tracesp run list --status completed --max-count 10 # 按状态/任务过滤运行列表 sp run show --latest # 查看最近一次运行的完整记录 sp run show run-id 前缀 sp run trace --latest --events # 打印物化 trace--events 附带全部事件 sp run trace-revision rev --events # 按持久 trace 修订号查看list支持--status、--task-id、--max-count过滤show展示状态、任务、provider、may 权限档、强制策略与输出清单trace输出的是已物化的执行轨迹——这正是 Shepherd 的核心卖点每次 run 都是一段可重放、可 fork、可回滚的 Git 式历史。changeset只读变更集视图changeset检查某个保留运行输出的只读变更集哪些文件被改了什么不会改动任何内容sp run changeset --latest # 查看最近一次运行的变更集摘要 sp run changeset --latest --read src/app.py # 直接打印某个变更文件的内容 sp run changeset --latest --json # 机器可读输出关键选项--output-name输出名默认workspace、--binding、--state保留输出状态过滤、--read PATH与--json互斥。结算命令select、apply、release、discard四个结算命令把保留的运行输出落定全部要求精确 run ref命令作用select选中一个保留输出并入其活动父世界apply把输出三方合并应用到可能已推进的父世界任何路径重叠即失败fail closedrelease释放保留输出但不选用discard明确丢弃记录为不应用一次结算记录结果后同一输出的其他结算命令将拒绝——这就是consume-once规则。辅助命令outputs、vcscore、repairsp run outputs --latest --state retained列出产物级运行输出sp run vcscore --latest查看运行记录携带的 vcs-core 引用sp run repair回收被 Ctrl-C / 崩溃中断的运行留下的孤儿操作引用orphaned operations避免阻塞下一次运行。shepherd task/demo/package任务库与脚手架task——管理任务库条目sp task list --status active # 任务列表 sp task show task-ref # 查看任务定义与签名/权限面 sp task register import 路径 # 注册任务为激活版本可配 --may-default sp task resolve task-ref # 解析为精确的 artifact 锁demo——输出内置 quickstart 演示脚本sp demo write quickstart quickstart_demo.pypackage——扩展包脚手架sp package init NAME。高频选项速查清单 ✅选项适用命令一句话说明--json几乎所有读取命令输出原始 JSON 载荷供脚本/CI 消费--latestrun show/trace/changeset/outputs等选择最近一次运行与显式 run ref 二选一--backendinit/doctor指定/验证工作区文件系统后端--eventsrun trace/trace-revision附带打印完整事件列表--read PATHrun changeset直接输出某个变更文件内容--placement [auto\|advisory\|jail]run start围栏启动的执行放置方式延伸阅读 CLI 完整参考逐字抓取自 0.3.0 发布版帮助文本cli.mdrun/task子命令实现源码cli.pyCLI 入口init/doctor/demo/package装配init.pyQuickstart 示例脚本examples/quickstart/掌握init → doctor → run → changeset → trace这条主线后再叠加四个结算命令与task管理你就能覆盖 Shepherd 日常运维的全部场景 【免费下载链接】shepherdA runtime substrate that turns an agents execution into a reversible, Git-like trace, so meta-agents can observe, fork, replay, and revert any run. Couples agent and environments in a copy-on-write fork ~5x faster than docker commit, with ~95% KV-cache reuse on replay. Framework built for meta-agents to supervise, optimize, and train other agents项目地址: https://gitcode.com/gh_mirrors/shepherd16/shepherd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考