Aialra Forgejo

日常使用手册

这里是你现在统一管理项目的入口。仓库、历史、Issue、PR、Actions 都在 https://forgejo.aialra.online 里看，真正开发仍然继续在原来的 /opt/... 和 /aialra/... 路径里进行。

看项目

登录后先看左侧仓库列表和组织区，再进仓库看 README、提交历史、Issue 和 PR。

改代码

仍然直接改原来的项目路径；这些路径已经映射到 volume 上的唯一真实工作树。

发版本

照常 git add、git commit、git push 到 Forgejo 即可。

1. 仓库怎么找

登录 Forgejo 后，首页左侧就是你的仓库列表和 MyProjects 组织。
点进仓库后，可以看文件、提交记录、Issue、PR、Releases 和 Actions。
如果只想快速搜项目，直接用顶部搜索框。

2. 现在怎么开发

继续在原来的路径开发，例如 /opt/aialra-home、/opt/openclaw、/aialra/wikiflow。
这些路径现在仍是统一入口，但底层真实目录已经在新 volume 上，不需要你改工作习惯。
提交后把代码推到 Forgejo；如果某个仓库保留了外部上游，它会显示成 upstream，Forgejo 是主 origin。

3. 推荐的日常节奏

先在本地改代码并自测。
提交前用 Forgejo 看 diff 是否干净。
重要改动开一个 PR 给自己做一次自审。
需要记录想法、Bug、待办时直接开 Issue。

4. 自动感知是怎么工作的

系统每 10 秒扫描一次受管仓库。
如果某个仓库的改动稳定了大约 15 秒，就会自动生成一条 snapshot commit 并 push 到 Forgejo。
所以你继续直接改 /opt/... 或 /aialra/... 就行，Forgejo 通常会在十几秒到几十秒内看到最新状态。

5. 常用命令

git remote -v：查看当前仓库是否已经以 Forgejo 为 origin
git status：看改动是否准备好提交
git push：推送到 Forgejo
/opt/forgejo/scripts/create-admin-token.sh --rotate：重新生成管理员 PAT
/opt/forgejo/scripts/backup.sh：备份 Forgejo
/opt/forgejo/scripts/upgrade.sh：升级 Forgejo 与 runner

6. 当前规则

唯一工作树：每个项目现在最终只有一份真实可编辑目录，原路径只是它的固定入口。

Forgejo 是主远端：新的提交默认推到 Forgejo；旧 GitHub/Gitee 远端如果还在，会作为 upstream 保留。

不要直接在 volume 深路径里开发：继续只用 /opt/... 和 /aialra/...，这样最稳。