Skip to content

tasks.md

Latest commit

 

History

History
50 lines (35 loc) · 2.28 KB

tasks.md

File metadata and controls

50 lines (35 loc) · 2.28 KB
Raw

任务、Agent 与控制后台

当前CoCo版本使用一个本地Runner执行持久任务。任务状态和结果保存在~/.coco/agent/tasks.json，编码任务默认使用独立Git worktree。

coco task create "实现并测试这个功能"
coco task list --json
coco task active
coco task cancel <id>
coco task stop-all

active会显示Runner和所有运行中Agent的PID。已发布的0.6.1中，stop-all会终止经过身份验证的原始进程组，从SIGTERM升级到SIGKILL，并停止Runner以避免定时任务立即重启。创建新session的后代可以逃离原进程组，因此0.6.1不承诺完整后代containment；0.6.2计划要求Linux cgroup v2完成后才能报告完全终止。

触发器

coco task create "执行维护检查" --schedule 6h
coco task create "检查收到的数据" --webhook
coco task create "检查 push" --github-event push

Webhook 和 GitHub 任务在端点收到有效 Bearer 令牌或 X-Hub-Signature-256 HMAC 前保持阻塞。错过的定时任务不会集中补跑。

控制后台

coco control start
coco control token
coco control status

打开返回的本机地址并输入令牌。后台可以创建需要审批的worktree任务、查看历史和活跃Agent、取消单个任务，或请求终止所有已跟踪任务进程组。0.6.1不承诺完整后代终止，仍受0.6.2 cgroup门禁约束。后台不会暴露原始RPC、Provider凭据、任意会话路径或直接Shell接口。

控制服务只接受 loopback 监听。远程访问时保持监听 127.0.0.1，并使用经过认证的 SSH 隧道或保持源站私有的 TLS 终止隧道。内置服务使用 HTTP，不负责 TLS 终止。

MCP

coco mcp add filesystem -- node /absolute/path/to/server.mjs
coco mcp approve filesystem
coco mcp list
coco mcp remove filesystem

MCP stdio 服务使用官方 SDK 和受限的继承环境。新服务默认需要交互审批，在无界面会话中会被拒绝，直到执行 coco mcp approve <name> 明确修改策略。可用 ask 或 deny 再次收紧策略。

VS Code

随包提供的 vscode/ 扩展连接同一个控制 API。它可以附加当前 selection 和 open tabs、创建立即运行或等待审批的任务、浏览任务历史，并打开 VS Code 原生 Git diff。