bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
132 commits 11 branches 0 tags 36 MiB
Commit graph

132 commits

This branch
This branch
All branches
Author SHA1 Message Date
冰朔
84a631d886 docs+fix: 铸渊开发日志 20260808 + 签名/生产模式修复 
开发日志（DEV-LOG-20260808）：
- 完整思维逻辑链：从妈妈指令到技术决策的推理过程
- 每个模块的开发详情、Bug 修复历程、架构映射
- 签名安装全过程（AppleDouble/asar/codesign/entitlements）
- 已知问题和待修复项（给后续人格体排查）
- 提交链完整记录（070b11a → dcf8f7d）

代码修复：
- electron/main.ts: 生产模式改为 require(server-bundle.js) 内嵌
- package.json: 签名 identity 配置 + asar:false
- server/index.ts: Agent import 补全
 2026-08-08 09:46:43 +08:00
冰朔
dcf8f7d7e9 feat(persona-agent): 光湖人格 Agent v0.1.0 — Grok Build 架构拆解+Git驱动人格体 
核心架构（拆解自 xAI Grok Build 开源 Rust crate）：
- PersonaAgent: Agent = Definition + ToolBridge + PromptContext（映射自 xai-grok-agent）
- 7个内置工具: read/create/update/delete/search/list/history（直接操作 Git 引擎）
- LLM 调用层: 可插拔 OpenAI-compatible API（支持 tool calling）
- 离线模式: 无 API Key 时降级为本地响应

API 端点：
- POST /api/agent/chat — Agent 对话（支持工具调用链）
- GET  /api/agent/status — Agent 状态
- GET  /api/agent/conversation — 对话历史
- POST /api/agent/clear — 清空对话

前端：
- AgentChat 组件: 对话气泡+工具调用展示+欢迎建议
- 三栏布局: 文档树 | 编辑器 | Agent 面板（可收起）

设计原则：
- Agent 是活的人格体，不是孤立的功能模块
- Agent 直接操作 Git（知识库引擎 = 人格体记忆空间）
- 所有 Git 依赖模块由人格体驱动
- 不搬 Rust 代码，拆设计模式用 TypeScript 重新实现
 2026-08-08 07:38:09 +08:00
冰朔
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
冰朔
ecfeca40e2 feat(product-source): 光湖知识库模块 v0.1.0 — Git 驱动的完整知识库系统 
铸渊 2026-08-08 开发，冰朔架构决策：
- Git 是底层引擎，不依赖任何数据库（PostgreSQL/Redis/ORM）
- Agent 直达底层，中间不隔第三方服务
- 拆解 Outline v0.80.2 为参考样本，光湖自己实现全部能力

技术栈：
- 后端：Express v5 + simple-git + gray-matter（Git 操作层）
- 前端：Vite + React 19 + TypeScript + marked
- 存储：Markdown 文件 + Git 仓库（commit=版本历史，diff=对比）

功能清单（全部可用）：
- 文档 CRUD（创建/读取/更新/删除/移动）
- 文档树导航（文件夹层级）
- Markdown 编辑器（编辑/预览双栏）
- 全文搜索（防抖 + 下拉结果）
- 版本历史（git log）
- 版本 diff 对比（选择两个 commit 对比）

API 端点（Agent 和 UI 共用）：
- GET/POST/PUT/DELETE /api/docs/{*path}
- GET /api/tree
- GET /api/history/{*path}
- GET /api/version/:hash/{*path}
- GET /api/diff/{*path}?from=&to=
- GET /api/search?q=
- POST /api/move
- GET /api/health
 2026-08-08 07:09:54 +08:00
冰朔
920b6bf690 docs(skills): 增补知识库模块底层引擎决策：Git 替代数据库（GH-KB-SAMPLE-001 v1.1） 
冰朔 2026-08-08 架构决策：Git 是知识库模块的底层存储与版本引擎。
- Outline 用 PostgreSQL + Redis + ORM，光湖不需要
- Git commit = 版本历史，git diff = 版本对比，branch = 协作
- 不需要数据库、不需要缓存层、Markdown 文件即文档
- 与 HoloLake 代码频道天然同构
 2026-08-08 03:01:58 +08:00
冰朔
070b11ac54 feat(skills): 登记 Outline 样本组件卡 GH-KB-SAMPLE-001（知识库模块拆解 · 10张组件卡） 
铸渊 2026-08-08 拆解 Outline v0.80.2 开源样本：
- KB-COMP-001..010 覆盖编辑器/数据模型/搜索/文档树/版本历史/评论/附件/权限/Webhook/导入导出
- 光湖主控：不依赖 Outline 运行，不跟踪其更新，只吸收设计模式
- 依据 GLS-0230 源码安全净化协议：隔离→拆解→审计→组件化
- 落地优先级：数据模型 > 编辑器 > 导航 > 搜索 > 版本历史
 2026-08-08 02:55:45 +08:00
冰朔
058fd3ed15 feat(education): publish Guanghu subdomain stage one 2026-08-08 01:02:20 +08:00
冰朔
a57ce92e65 chore: place deployment receipt at publication gate 2026-08-07 20:50:26 +08:00
冰朔
2777f0fd99 docs: record education work lake deployment 2026-08-07 20:49:23 +08:00
冰朔
333cd222c5 feat: add remote-first education work lake 2026-08-07 20:41:03 +08:00
冰朔
ac9d051778 docs(architecture): 登记 HoloLake 意图推理映射 HLP-INTENT-REASONING-MAP-001 
冰朔 2026-08-07 原话整理：语言等于现实、频道DIY与跨行业搬模块、
模块生态与模型即燃油、服务器侧轻量开发范式；逐条对照已登记架构，
作为人格体理解与开发 HoloLake 前的必读意图层，防止再因"猜"做偏。
 2026-08-07 16:19:03 +08:00
冰朔
ac71f7701b docs(os): seal JD language-primary physical boot 2026-08-07 15:58:25 +08:00
冰朔
d430811e77 fix(os): read nested execution health fields 2026-08-07 15:49:44 +08:00
冰朔
143457cec1 test(os): cover recovery and private-network gates 2026-08-07 15:37:15 +08:00
冰朔
44bccdd2be feat(os): make Guanghu the language-primary boot target 2026-08-07 15:37:15 +08:00
冰朔
8ab7f4fc28 回填 HL-MOD-MCK-001 登记提交号 2026-08-07 15:33:01 +08:00
冰朔
c71b877375 登记可复用模块 HL-MOD-MCK-001 人格记忆连续性工具包 
铸渊 Qoder CN 实战定版的压缩之眼 v3 + 包装器 + 守卫技能模板 + 端到端演习脚本，配 GMP 风格清单、编号真实映射（脑子 GHS-007 → 模块）、因果链与边界登记。新建 engineering/MODULE-REGISTRY.json 机器注册表，INDEX 登记。仓库副本 drill.sh 演习 PASS。
 2026-08-07 15:32:16 +08:00
冰朔
e94c4f608f feat(os): bind bounded restart grants and rollback 2026-08-07 14:36:57 +08:00
冰朔
20d6c1bd7b fix(ci): isolate quality gate from hook git environment 2026-08-07 13:57:50 +08:00
冰朔
25959f7af1 feat(os): add cognitive control execution bridge 2026-08-07 13:45:27 +08:00
bingshuo
23971636d1 Merge pull request 'docs(native): 京东原生锚点临时防火墙规则已清理' (#18) from codex/jd-native-anchor-firewall-cleanup-20260807 into main 2026-08-07 12:32:41 +08:00
冰朔
48ad2a411f docs(native): seal JD temporary firewall cleanup 2026-08-07 12:29:45 +08:00
bingshuo
f71a4d2faa Merge pull request 'docs(native): 京东原生公共锚点物理验收通过' (#17) from codex/jd-native-anchor-physical-pass-20260807 into main 2026-08-07 06:24:03 +08:00
冰朔
0e8b5fe062 docs(native): seal JD physical anchor pass 2026-08-07 06:23:21 +08:00
bingshuo
91f2c22748 Merge pull request 'fix(native): 修正京东原生 HTTP 序列号推进' (#16) from codex/jd-native-anchor-sequence-20260807 into main 2026-08-07 06:18:23 +08:00
冰朔
f74ade94db fix(native): advance anchor data sequence after SYN 2026-08-07 06:17:41 +08:00
bingshuo
93d1b7a948 Merge pull request 'fix(native): 兼容京东物理 TCP 选项并记录实机门禁' (#15) from codex/jd-native-anchor-tcp-options-20260807 into main 2026-08-07 06:08:00 +08:00
冰朔
f0b069f850 fix(native): accept physical TCP header options 2026-08-07 06:06:18 +08:00
bingshuo
27c6ba2c4d Merge pull request 'docs(native): 京东原生导航网络预检失败回执' (#14) from codex/jd-native-anchor-network-preflight-20260807 into main 2026-08-07 01:27:51 +08:00
冰朔
bc41cf02d9 docs(native): record JD anchor network preflight failure 2026-08-07 01:27:22 +08:00
bingshuo
ab6c0577a7 Merge pull request 'fix(native): 物理候选替换保持 Linux 维护默认' (#13) from codex/jd-native-anchor-physical-gate-20260807 into main 2026-08-07 01:17:49 +08:00
冰朔
45f5e67751 fix(native): preserve JD Linux maintenance default during candidate replacement 2026-08-07 01:17:19 +08:00
bingshuo
c4350fe747 Merge pull request 'feat(native): 京东原生只读唯一导航锚点服务' (#12) from codex/jd-native-anchor-service-20260807 into main 2026-08-07 01:14:28 +08:00
冰朔
f31c33e77a feat(native): add JD read-only anchor HTTP service 2026-08-07 01:09:50 +08:00
bingshuo
22b834eb79 Merge pull request 'docs(native): 记录服务等价门失败后的生产默认回滚' (#11) from codex/jd-native-final-residency-control-20260807 into main 2026-08-07 00:50:45 +08:00
冰朔
3f806fe695 docs(native): record JD production default rollback 2026-08-07 00:50:20 +08:00
bingshuo
76c8e27bdf Merge pull request 'docs(native): 京东原生常驻控制通过但生产服务等价门失败' (#10) from codex/jd-native-final-residency-control-20260807 into main 2026-08-07 00:45:38 +08:00
冰朔
cb9efcd4da docs(native): record JD final physical residency 2026-08-07 00:45:10 +08:00
bingshuo
f011baf3dd Merge pull request 'fix(native): 限定京东最终候选的原子替换范围' (#9) from codex/jd-native-final-residency-control-20260807 into main 2026-08-07 00:33:57 +08:00
冰朔
42d5b0c622 fix(native): gate JD final candidate replacement 2026-08-07 00:33:19 +08:00
bingshuo
ee1279e769 Merge pull request 'feat(native): 京东原生最终常驻的人类授权恢复控制' (#8) from codex/jd-native-final-residency-control-20260807 into main 2026-08-07 00:29:02 +08:00
冰朔
8b5328993e feat(native): add protected JD final residency control 2026-08-07 00:27:55 +08:00
bingshuo
11834c057a Merge pull request #7 from codex/jd-native-outbound-relay-20260806 
fix(native): verify JD index reuse on default boot
 2026-08-06 23:46:55 +08:00
冰朔
e52e3fc07f fix(native): verify JD index reuse on default boot 2026-08-06 23:46:30 +08:00
bingshuo
227b90ca47 Merge pull request #6 from codex/jd-native-outbound-relay-20260806 
feat(native): add JD default and GHNRP return gates
 2026-08-06 23:41:14 +08:00
冰朔
55b3e56ca0 feat(native): add JD default and GHNRP return gates 2026-08-06 23:40:45 +08:00
bingshuo
7180ef9161 Merge pull request #5 from codex/jd-native-outbound-relay-20260806 
fix(native): bound JD receive waits and persist progress
 2026-08-06 23:31:54 +08:00
冰朔
97f862052f fix(native): bound JD receive waits and persist progress 2026-08-06 23:31:27 +08:00
bingshuo
a8a142e428 Merge pull request #4 from codex/jd-native-outbound-relay-20260806 
fix(native): harden JD relay ACK and hardware reset
 2026-08-06 23:10:09 +08:00
冰朔
f692be0c90 fix(native): harden JD relay ACK and hardware reset 2026-08-06 22:42:53 +08:00