Shepherd快速开始教程从pip install到跑通第一个Agent任务5分钟上手指南【免费下载链接】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 快速开始只需三步pip install shepherd-ai、初始化工作区、跑通第一个Agent 任务。Shepherd 是一个可逆执行底座runtime substrate它把每一次 Agent 运行记录成 Git 风格的持久执行轨迹trace让元 Agent 可以观察、分叉、重放、回滚任何一次运行——而且 Agent 的产物会先以保留输出retained output形式安全暂存在你确认之前绝不碰你的文件。本教程带你从零完成 Shepherd 安装与首次运行全程约 5 分钟。1️⃣ 环境要求与安装命令先确认环境一条命令完成安装项目要求Python3.11 及以上操作系统macOS / LinuxWindows 不支持请用 WSL凭据离线路径无需任何 API Keypip install shepherd-ai 安装的是发行包shepherd-ai导入时写import shepherd as sp两者名字不同是正常现象。安装细节参见官方文档 docs/shepherd/start/install.md。2️⃣ 一键初始化工作区Shepherd 必须在初始化过的工作区内运行一条命令搞定mkdir shepherd-demo cd shepherd-demo shepherd initshepherd init会把当前目录变成一个 Shepherd 工作区。之后所有任务运行、产物审查、回滚都发生在这个受管边界里。3️⃣ 跑通第一个 Agent 任务免 Key 离线版这是最快的上手路径无需 API Key、确定性、可重复。仓库自带一份可对照的示例脚本 examples/quickstart/offline_task.py核心写法只有几行import shepherd as sp sp.task def draft_release_note(component: str, change: str) - str: Return a deterministic release-note line. return f{component}: {change}注意这个任务的精髓函数签名即契约。sp.task声明任务参数类型是输入返回类型是输出契约docstring 就是给模型的指令——你甚至不用手写 prompt。在已初始化的工作区中运行一个任务产物会以保留输出形式暂存等待你审查shepherd demo write quickstart quickstart_demo.py python quickstart_demo.py运行结束后用 CLI 查看结果shepherd run list # 查看运行记录与状态 shepherd run changeset --latest # 查看这次运行写了什么 shepherd run show --latest # 查看完整持久化记录4️⃣ 进阶让真 Agent 干活Live 版想要真正的 Claude Agent 来写代码只需满足一个前提本机装有并登录了claudeCLI或用ANTHROPIC_API_KEY。shepherd doctor claude # 检查 claude CLI、登录状态、沙箱是否就绪然后把 examples/quickstart/agent_task.py 里的PROMPT改成任何你想要的任务运行python agent_task.py。Agent 在沙箱隔离中工作产物依旧落为保留输出例如# 直接从保留输出中运行 Agent 写的程序无需先落盘 shepherd run changeset --latest --read donut.py | python3 -5️⃣ 关键机制先审查、后落盘3 条命令定去留Shepherd 最独特的设计是Agent 的任何改动都不直接写入你的文件而是作为一份提案保留在旁边你可以先运行、先审查最后用一条命令定去留shepherd run select run-ref # ✅ 保留合并到你的工作区 shepherd run apply run-ref # 三方合并到已前进的工作区 shepherd run discard run-ref # 丢弃轨迹中仍有完整记录权限方面签名即权限面repo: sp.GitRepo表示授予该仓库可写句柄若任务只需检查不改文件用May[GitRepo, ReadOnly]声明只读——写入会在操作系统层面macOS Seatbelt / Linux Landlock直接拒绝。详见 README.md 的 Permissions 一节。6️⃣ 遇到问题时查这里现象原因与解决WorkspaceControlError目录未初始化先执行shepherd init同目录重复跑同一脚本工作区已带有上次select的状态二次结算会 fail closed——换新目录重来claudeCLI 报错/挂起先跑shepherd doctor claude --probe做真实鉴权探测订阅用户建议export CLAUDE_CODE_OAUTH_TOKEN$(claude setup-token)7️⃣ 下一步从 5 分钟到进阶玩法 官方入门文档docs/shepherd/start/index.md含完整可复现的 quickstart 转录 概念模型任务、效果、权限、轨迹docs/shepherd/concepts/index.md 更多上手示例examples/quickstart/离线任务、Live Agent、world channel 等 可视化用例 Notebook变体工作室、模型选型、管线恢复examples/notebooks/visual_artifact/make notebooks一键启动从一条pip install到可审查、可回滚的 Agent 运行轨迹——这就是 Shepherd 给你的 5 分钟上手体验。现在去初始化你的第一个工作区吧 【免费下载链接】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），仅供参考