50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# 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
|
||
|
||
## 运行命令
|
||
|
||
```bash
|
||
cd /data/guanghulab/repo
|
||
npm install isomorphic-git
|
||
node scripts/experiments/isomorphic-git-poc/poc.js
|
||
```
|
||
|
||
---
|
||
*实验日期: 2026-05-27 · D115 · 铸渊 ICE-GL-ZY001*
|