自动播放
自动播放将工单排队等待 自托管运行器 安装在您自己的计算机或 VPS 上。执行器领取作业，复用已配置的本地检出目录（默认使用 git worktree）或克隆存储库，运行编码工具（默认为 Claude Code），并创建拉取请求供您审查。Autoplay 不会自行合并；由您决定发布哪些改动。
它是如何运作的
- 您在某个工单上启动自动播放（从工单页面、AI 聊天或 GitHub）
- SprintFlint 创建 Autoplay 作业并通知您的在线执行器
- 已连接的执行器领取作业
- 运行程序重用配置的项目路径/工作树，或者如果未设置路径则克隆存储库
- 它针对该工单运行您选择的可替换编码工具（首个支持的是 Claude Code）
- 编码工具完成后，执行器会创建拉取请求；它不会自行合并
- 作业运行时进度和日志流回 SprintFlint
按设计自行托管 - 执行器是开源的 vps-agent 您在您控制的硬件上运行的 CLI。在项目上配置本地项目路径（或运行程序覆盖），以便作业使用 git worktree add 来自您现有的结帐 - 包括本地秘密，例如 master.key。 SprintFlint 从不复制、记录或存储这些文件；它仅发送作业负载中的路径。当未配置路径时，从头开始克隆仍然是后备方案。
结账方式
在项目中（也可以选择作为每个运行者的覆盖），您可以告诉 Autoplay 如何获取工作树。作业负载包括 source_mode, project_path, worktree_base, 和 use_worktree 因此执行器不必从头开始克隆。
- Git 工作树 （设置项目路径时的默认值）—
git worktree add从现有的结帐中，因此作业共享对象存储并可以查看本地配置，例如master.key - 现有本地路径 — 直接在检出目录中运行编码工具
- 克隆 — 当前后备；当未配置路径或明确选择路径时使用
SprintFlint仅存储和发送路径字符串。它从不复制、同步或记录机密。签出执行（工作树添加/删除、脏树处理）位于 vps-agent.
可替换的编码工具
Harness 是执行器调用来实现工单的编码工具。执行器内置两种：
- Claude Code (
claude) - 默认值；针对克隆的存储库驱动 Anthropic 的 Claude Code CLI - 无操作 (
noop) - 一个空运行工具，无需更改代码即可克隆并打开 PR，对于验证连接性和 git auth 很有用
您在配置执行器时选择编码工具。参见 设置执行器 用于选择编码工具和权限模式。
连接执行器
在使用自动播放之前，请安装并注册运行器：
- 安装 CLI：
npm install -g vps-agent - 使用 SprintFlint 中的运行器设置页面中的令牌进行注册
- 启动它：
vps-agent start（或--daemon在后台运行） - 确认显示在线；现在它会为您的组织挑选自动播放作业
完整的说明，包括先决条件、git 设置和故障排除，位于 设置执行器 页。
开始自动播放
- 工单页面 - 点击 自动播放 在任何工单上
- 人工智能聊天 - 要求在特定工单上运行自动播放（与按钮相同的队列）
- GitHub - 评论
@sprintflint implement关于链接的工单或 PR
以编程方式处理工单
运行者实现工单并打开拉取请求；它不会对工单本身发表评论。要从您自己的工具或 AI 代理中读取或更改工单 - 添加评论、移动工单的状态、创建工单或冲刺 - 使用 SprintFlint MCP 服务器。将一个 JSON 块放入 Claude Code、Cursor、Claude Desktop 或 Zed 中，您的代理将与 SprintFlint 进行本地对话。参见 人工智能整合 对于 MCP 设置和底层 REST API。
故障排除
自动播放按钮不执行任何操作/保持排队状态
- 检查至少有一个执行器 在线;跑
vps-agent status在主机上 - 验证 GitHub 已连接并且项目存储库已配置
- 确认您的组织有有效的订阅
- 运行
vps-agent doctor检查先决条件和连接性
运行已激活
- 从运行器作业日志中取消当前运行，或注释
@sprintflint cancel上 GitHub - 或者使用AI聊天来取消该工单的自动播放
PR已打开，但代码看起来不对
- Autoplay 会准确地打开 PR 进行审核，以便您可以捕捉到这一点；像任何其他 PR 一样关闭或修改它
- 尝试更具体的工单描述；该工具根据工单标题、正文和评论进行工作
- 检查运行日志以查看编码工具执行的操作