hololake-system-architecture/product-source/hololake-desktop/forgejo/INTEGRATION.md

1.5 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

2026-08-08 运行实现:

- GitEngine 已实现状态、配置 remote、fetch、仅快进 pull、显式确认 push

- 桌面 UI 已提供连接与同步状态;认证继续使用本机钥匙串或 SSH

- Agent 只获得只读 inspect_repository 工具,不拥有自动 push 权限

- 本地 API 仅监听 127.0.0.1,不向局域网暴露