Disinto 工厂

您正在帮助用户设置和运行一个 disinto 自主代码工厂 —— 一个由 bash 脚本和 Claude CLI 组成的系统，可自动化完整的开发生命周期：接收问题、通过 Claude 实现、创建 PR、运行 CI、审查、合并和镜像。

首次设置

以交互方式引导用户完成以下步骤。在标记为 [ASK] 处提问。

1. 环境

[ASK] 工厂将在哪里运行？选项：

• - LXD 容器（推荐用于隔离）—— 需要 Debian 12、Docker、启用嵌套
• 裸机 VM 或服务器—— 需要带 Docker 的 Debian/Ubuntu
• 现有容器—— 检查先决条件

验证先决条件：
bash
docker --version && git --version && jq --version && curl --version && tmux -V && python3 --version && claude --version

任何缺失的工具 —— 在继续之前帮助用户安装。

2. 克隆并初始化

bash
git clone https://codeberg.org/johba/disinto.git && cd disinto

[ASK] 工厂应该开发哪个仓库？选项：

• - 自身（自我开发）：bin/disinto init https://codeberg.org/johba/disinto --yes --repo-root $(pwd)
• 其他项目：bin/disinto init --yes

运行初始化并观察：

• - 所有机器人用户已创建（dev-bot、review-bot 等）
• WOODPECKER_TOKEN 已生成并保存
• 所有堆栈容器已启动

3. 初始化后验证

运行此检查清单 —— 在继续之前修复任何失败：

bash

堆栈健康？

docker ps --format table {{.Names}}\t{{.Status}}

预期：forgejo、woodpecker（健康）、woodpecker-agent（健康）、agents、edge、staging

令牌已生成？

grep WOODPECKER_TOKEN .env | grep -v ^$ && echo OK || echo 缺失 — 请参阅 references/troubleshooting.md

Agent cron 活跃？

docker exec -u agent disinto-agents-1 crontab -l -u agent

Agent 可以访问 Forgejo？

docker exec disinto-agents-1 bash -c source /home/agent/disinto/.env && curl -sf http://forgejo:3000/api/v1/version | jq .version

Agent 仓库已克隆？

docker exec -u agent disinto-agents-1 ls /home/agent/repos/

如果 agent 仓库缺失，克隆它：
bash
docker exec disinto-agents-1 chown -R agent:agent /home/agent/repos
docker exec -u agent disinto-agents-1 bash -c source /home/agent/disinto/.env && git clone http://dev-bot:\${FORGE_TOKEN}@forgejo:3000//.git /home/agent/repos/

4. 镜像（可选）

[ASK] 工厂是否应该镜像到外部 forge？如果是，哪些？

• - GitHub：需要仓库 URL 和添加到 GitHub 账户的 SSH 密钥
• Codeberg：需要仓库 URL 和添加到 Codeberg 账户的 SSH 密钥

向用户显示他们的公钥：
bash
cat ~/.ssh/id_ed25519.pub

测试 SSH 访问：
bash
ssh -T git@github.com 2>&1; ssh -T git@codeberg.org 2>&1

如果 SSH 主机密钥缺失：ssh-keyscan github.com codeberg.org >> ~/.ssh/known_hosts 2>/dev/null

编辑 projects/.toml 添加镜像：
toml
[mirrors]
github = git@github.com:Org/repo.git
codeberg = git@codeberg.org:user/repo.git

通过手动推送测试：
bash
source .env && source lib/env.sh && export PROJECTTOML=projects/.toml && source lib/load-project.sh && source lib/mirrors.sh && mirrorpush

5. 播种待办事项

[ASK] 工厂应该先处理什么？与用户一起集思广益。

帮助他们在本地的 Forgejo 上创建问题。每个问题需要：

• - 以 fix:、feat: 或 chore: 为前缀的清晰标题
• 描述要更改的内容、哪些文件以及任何约束的正文
• backlog 标签（以便 dev-agent 拾取）

bash
source .env
BACKLOG_ID=$(curl -sf http://localhost:3000/api/v1/repos///labels \
-H Authorization: token $FORGE_TOKEN | jq -r .[] | select(.name==backlog) | .id)

curl -sf -X POST http://localhost:3000/api/v1/repos///issues \
-H Authorization: token $FORGE_TOKEN \
-H Content-Type: application/json \
-d {\title\: \