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 配置)
This commit is contained in:
冰朔 2026-08-08 07:21:04 +08:00
commit 047f37e87e
10 changed files with 7617 additions and 0 deletions

View file

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