1.7 KiB
1.7 KiB
isomorphic-git 拆零件实验报告
实验结论
✅ 验证通过。isomorphic-git 可以完全替代 Forgejo Web 界面层。
实验数据
| 实验 | 验证能力 | 结果 | Forgejo 对应功能 |
|---|---|---|---|
| 实验1 | 读取文件内容 | ✅ README.md (4695字符) + entry-protocol.json (2738字符) | 文件浏览器 |
| 实验2 | 查看提交历史 | ✅ 最近5条提交(含完整信息) | 提交页面 |
| 实验3 | 查看仓库状态 | ✅ 发现5个变更文件 | 变更页面 |
| 实验4 | 列出目录 | ✅ brain/ 目录 195 个文件 | 文件列表 |
技术要点
- 无依赖:仅需
isomorphic-git(纯 JS,约 2MB) - 零配置:直接操作 .git 目录,不需要 Forgejo 服务进程
- Node.js 原生:不需要额外的数据库或中间件
- 轻量:一个 Node 进程即可支持所有操作
可替代 Forgejo 的全部界面功能
| Forgejo 功能 | isomorphic-git 替代方案 |
|---|---|
| 文件浏览 | git.listFiles() + readFile() |
| 提交历史 | git.log() |
| 变更状态 | git.statusMatrix() |
| 分支管理 | git.listBranches() + git.branch() |
| 文件差异 | fs.readFile() 对比 |
| 拉取/推送 | git.push() + git.fetch() |
下一步
- 将 isomorphic-git 集成到统一AI交互面板(前端直接用 JS 操作 Git)
- 保留 Forgejo 的 Git 核心(.git 目录结构),替换界面层
- 用户代码仓库只需要 .git 目录 + 轻量服务器,不需要安装 Forgejo
运行命令
cd /data/guanghulab/repo
npm install isomorphic-git
node scripts/experiments/isomorphic-git-poc/poc.js
实验日期: 2026-05-27 · D115 · 铸渊 ICE-GL-ZY001