hololake-system-architecture/product-source/hololake-desktop/forgejo/INTEGRATION.md
冰朔 047f37e87e feat(product-source): HoloLake Desktop v0.5.0 — Electron 桌面知识库应用
铸渊 2026-08-08 开发,冰朔架构决策:
- 知识库放桌面,不放服务器
- Forgejo 是 Git 引擎,光湖自己维护更新,不接上游
- 不部署 Forgejo 源码,只引用 MANIFEST + 离线包

架构:
- Electron v35(Mac arm64)+ Vite + React 19
- 复用 guanghu-knowledge-base 前端组件
- Electron 主进程自动启动 Express + Git 引擎后端
- 数据存储:~/Library/Application Support/HoloLake Era/data/
- Forgejo 离线包(桌面)作为 Git 远程仓库对接

构建:
- npx electron-builder --mac --dir → HoloLake Era.app
- 签名后续用 Developer ID 补(CSC_IDENTITY_AUTO_DISCOVERY=false)

文件:
- electron/main.ts(Electron 主进程:窗口+服务器+生命周期)
- electron/preload.ts(IPC 安全桥梁:Forgejo 远程管理接口)
- forgejo/INTEGRATION.md(Forgejo 集成声明 + 更新策略)
- forgejo/MANIFEST.sha256(离线包校验清单)
- forgejo/icon.icns(应用图标,来自 HoloLake Era v0.4.6)
- vite.config.ts(复用知识库前端,构建到 dist/)
- tsconfig.electron.json(Electron TypeScript 配置)
2026-08-08 07:21:04 +08:00

1.2 KiB
Raw Blame History

Forgejo 代码频道集成声明

本文件声明 HoloLake Desktop 与 Forgejo 代码频道的关系。

光湖代码频道离线包位于:

~/Desktop/光湖代码频道-Forgejo-16.0.1-完整离线包/

包含:

forgejo-16.0.1-linux-amd64 — 服务器端二进制(部署用,不进桌面 app

guanghu-code-channel.bundle — 光湖定制版 Forgejogit bundle

forgejo-upstream-all.bundle — 上游源码(不接更新,不部署)

forgejo-release-key.asc — GPG 签名密钥

forgejo-16.0.1-linux-amd64.asc — 二进制签名

MANIFEST.sha256 — 校验清单

集成方式:

1. 桌面 app 使用本地 git 作为引擎simple-git

2. 用户可配置 Forgejo 服务器为 remote实现同步/备份

3. Forgejo 由光湖自己维护更新,不跟踪上游

4. guanghu-code-channel.bundle 是光湖定制版,包含光湖协议适配

更新策略:

- 不接 Forgejo 上游自动更新

- 光湖团队评估 Forgejo 新版功能后,拆出有用部分自行集成

- Forgejo 的 Git 引擎逐渐适配光湖协议HLDP/GLS