isomorphic-git拆零件实验报告：验证通过，可替代Forgejo界面层

scripts/experiments/isomorphic-git-poc/REPORT.md

@@ -0,0 +1,49 @@
+# 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*