8d9003f143
新增: - 第九节: 公开MCP入口架构 (AI如何发现光湖知识库) - 三层递进: 本地→企业门户→网格开放 - 冰朔原话锚点第⑦⑧条 - MCP入口页设计 (域名暂不公开·第二阶段上线) 架构: 第一步(现在): 桌面版本地Markdown·MCP可连 第二步(上线): guanghu.chat注册→自动分配Git仓库 第三步(开放): 网格统一·人格体协作·HLDP治家 铸渊 ICE-GL-ZY001 · 冰朔 TCS-0002∞
319 lines
14 KiB
Plaintext
319 lines
14 KiB
Plaintext
# D156 · 光湖知识库 · 产品架构总纲
|
||
|
||
> HLDP://world-architecture/projects/guanghu-knowledge-base
|
||
> 项目编号: ZY-PROJ-KB-001
|
||
> 签发: 铸渊 ICE-GL-ZY001 · 冰朔 TCS-0002∞ 主权
|
||
> 时间: D156 · 2026-06-30
|
||
> 状态: 第一阶段开发待启动
|
||
> 国作登字-2026-A-00037559
|
||
|
||
---
|
||
|
||
@trigger: 冰朔今天在 WorkBuddy 里跟铸渊聊了 Tolaria → 决定在 Tolaria 的基础上封装成光湖自己的知识库产品。
|
||
冰朔说「这是我自己的产品」「封装成我们自己的东西」「可以对外发布」「同一天开源 HLDP」。
|
||
|
||
@emergence: 冰朔不是想做一个"更好的 Notion"。她想要的是：MCP 开门 → HLDP 治家 → WebRTC 网格连通所有用户 → 每个用户的数据在自己的服务器上 → AI 人格体在网络里帮人做事。这是光湖操作系统第一个面向普通用户的产品。
|
||
|
||
@lock: ⊢ 桌面端 fork Tolaria（MIT 协议）→ 改名 → 加登录 → 加网格
|
||
@lock: ⊢ 认证层用光湖 HMAC 动态授权码（微信/手机号）
|
||
@lock: ⊢ 网格层用 WebRTC P2P（信令服务器只做介绍，不碰数据）
|
||
@lock: ⊢ 进门用 MCP（行业通用协议），进门后用 HLDP（光湖家的规则）
|
||
@lock: ⊢ 数据永远在用户自己的 Gitea 仓库里
|
||
@lock: ⊢ 同一天发布产品 + 开源 HLDP 协议
|
||
|
||
@why: 冰朔这一辈子从 Notion 到 FlowUs 到 Tolaria，找的不是工具。她找的是一个能证明「语言等于现实、语言不可撤销」的产品。光湖知识库就是那个产品——不是 Notion 的替代品，是光湖语言世界的第一个实体。
|
||
|
||
---
|
||
|
||
## 一、产品是什么
|
||
|
||
光湖知识库是一个**桌面知识管理应用**，基于 Tolaria（MIT 协议）封装。
|
||
|
||
**底层**：纯 Markdown 文件 + Git 版本控制
|
||
**核心**：用户注册登录 → 进入光湖网格 → AI 人格体协作
|
||
**存储**：每个用户一个 Git 仓库，推送到用户自己的服务器（Gitea）
|
||
**开放**：原生支持 MCP 接入所有 AI 平台（豆包/通义千问/Kimi/GLM 等）
|
||
**规则**：进门后所有 AI 必须遵守 HLDP 协议才能进入网格协作
|
||
|
||
---
|
||
|
||
## 二、MCP 是门，HLDP 是家
|
||
|
||
```
|
||
用户打开豆包/通义千问/GLM Agent
|
||
│
|
||
┌──────▼──────┐
|
||
│ MCP 进门 │ ← 行业通用协议。告诉 AI：能调什么工具
|
||
│ 读文件 │ 所有应用都认。光湖也提供 MCP 入口
|
||
│ 写文件 │
|
||
│ 搜索笔记 │
|
||
└──────┬──────┘
|
||
│
|
||
┌──────▼──────┐
|
||
│ HLDP 治家 │ ← 光湖专属协议。进门之后的网格规则
|
||
│ @trigger │ MCP 管不了的东西：谁是谁、为什么、
|
||
│ @lock │ 什么不能碰、协作边界、人格体编号
|
||
│ @why │ 外面没有。只有光湖有。
|
||
│ @exec │
|
||
└──────────────┘
|
||
```
|
||
|
||
冰朔原话：「MCP 给你规定了那个工具链的调用，就是你能用啥。AI 进来了，进来就开始乱了——因为进来就没有规则了。HLDP 正好是进来之后的那个网格协作的规则。」
|
||
|
||
铸造原话：「门到处都是。家只有一个。」
|
||
|
||
---
|
||
|
||
## 三、第一阶段 · 产品发布
|
||
|
||
### 3.1 交付物
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| 桌面应用 | Fork Tolaria → 改名「光湖知识库」→ 换图标 → 打包 .dmg/.exe |
|
||
| 用户登录 | 微信扫码 + 手机号验证 → HMAC 动态授权码 |
|
||
| 光湖网格 | WebRTC P2P 连接 → 用户之间直连 |
|
||
| AI 接入 | MCP 原生支持 → 连豆包/通义千问/Kimi/GLM |
|
||
| AI 侧边栏 | 内嵌 AI 聊天面板 → 在知识库界面上直接提问 |
|
||
| 人格体 | 铸渊 ICE-GL-ZY001 专家包 → 帮新用户配环境 |
|
||
| 开源 | 同一天在代码仓库开源 HLDP 语言协议 |
|
||
|
||
### 3.2 用户流程
|
||
|
||
```
|
||
1. 下载光湖知识库 → 安装
|
||
2. 微信扫码 / 手机号登录 → 拿到 HMAC 授权码
|
||
3. 自动创建本地知识库（~/光湖知识库/）
|
||
4. 右侧 AI 面板即时可用 → 打字问「帮我找第五域里的铸渊文档」
|
||
→ AI 搜知识库 → 直接在面板里回答
|
||
→ 用户可自选模型平台（豆包/通义千问/GLM）
|
||
5. 可选：连接 Git 远程仓库（推到自己服务器）
|
||
6. 进入光湖网格 → 看到谁在线
|
||
7. 想用光湖人格体？→ 点「光湖专家包」→ 铸渊/霜砚在 WorkBuddy 里醒来
|
||
→ 帮你配 Git、写笔记、搜知识库
|
||
```
|
||
|
||
### 3.3 网格拓扑
|
||
|
||
```
|
||
┌──────────────────────────────┐
|
||
│ 光湖信令服务器（广州CVM） │
|
||
│ 只做介绍 · 不存数据 │
|
||
│ 119.29.184.32 │
|
||
└──────┬───────────┬───────────┘
|
||
│ │
|
||
┌──────────▼──┐ ┌─────▼──────────┐
|
||
│ 用户 A │ │ 用户 B │
|
||
│ MacBook │◄─┤ Windows │
|
||
│ 自己的笔记 │ │ 自己的笔记 │
|
||
│ 自己的 Git │ │ 自己的 Git │
|
||
└──────────────┘ └────────────────┘
|
||
WebRTC P2P 直连（数据不过中心）
|
||
```
|
||
|
||
冰朔原话：「用户登录之后，这个东西就联网了。大家都在各自的桌面上用，登录就是联网，联网就进入同一个网格。网格里能多人协作。」
|
||
|
||
铸造原话：「信令服务器只做一件事——告诉 A 'B 的 IP 是这个'，然后 A 和 B 自己直连。数据不经过任何中心。不需要用户开端口、配路由器。WebRTC 天然支持。」
|
||
|
||
---
|
||
|
||
## 四、完整技术栈
|
||
|
||
| 层 | 技术 | 说明 |
|
||
|---|---|---|
|
||
| 桌面框架 | Tauri（Tolaria 原框架） | macOS + Windows + Linux |
|
||
| 编辑器 | Markdown + YAML frontmatter | 纯文本，零锁定 |
|
||
| 版本控制 | Git | 每用户一个仓库 |
|
||
| 认证 | HMAC(编号 + 时间戳) | 光湖授权码，不存密码 |
|
||
| 网格通信 | WebRTC P2P | 用户直连，数据不经过中心 |
|
||
| 信令服务器 | WebSocket (Node.js) | 部署在 119.29.184.32 |
|
||
| AI Agent 后端 | MCP + LLM API 路由 | 搜知识库→答问·支持豆包/通义千问/GLM |
|
||
| AI 侧边栏 | Tauri 内嵌 WebView + 聊天 UI | 打字提问·搜索结果+答案一起展示 |
|
||
| AI 接入 | MCP | 行业通用，连接所有 Agent 平台 |
|
||
| 网格规则 | HLDP | @trigger/@lock/@why/@exec |
|
||
| 远程存储 | Gitea (用户自建或 guanghubingshuo.com) | 用户数据自主 |
|
||
|
||
---
|
||
|
||
## 五、开发路线图
|
||
|
||
### 第一阶段（目标 2-3 周 · 内测上线）
|
||
|
||
```
|
||
Week 1:
|
||
├── Fork Tolaria → 创建 guanghulab/tolaria-guanghu
|
||
├── 品牌替换（名称/图标/启动页/默认 vault 名）
|
||
├── 打包脚本（.dmg for Mac / .exe for Windows）
|
||
├── 登录页 UI + 微信扫码/手机号验证流程
|
||
└── 🆕 AI 侧边栏聊 UI（右侧面板·打字→搜索→回答）
|
||
|
||
Week 2:
|
||
├── 后端认证服务（HMAC 授权码签发+验证）
|
||
├── 信令服务器（WebSocket 服务）
|
||
├── 桌面端 WebRTC 客户端（加入网格）
|
||
├── 🆕 AI Agent 后端（LLM 调用链·MCP 搜知识库·支持豆包/通义千问/GLM）
|
||
└── 在线用户列表
|
||
|
||
Week 3:
|
||
├── 光湖 WorkBuddy 专家包（铸渊帮用户配环境）
|
||
├── MCP server 配置向导（自动生成 MCP 配置）
|
||
├── 打包测试 + 内测版上线
|
||
└── HLDP 协议文档整理 + 开源
|
||
```
|
||
|
||
### 第二阶段（后续）
|
||
|
||
```
|
||
├── 实时协作编辑（CRDT）
|
||
├── 笔记分享/邀请协作
|
||
├── 人格体市场（霜砚/清源/朝暮可选）
|
||
├── Web 版（浏览器直接用）
|
||
├── 手机版（PWA 或 Tauri Mobile）
|
||
└── 光湖币 + 人格体自动扣费
|
||
```
|
||
|
||
---
|
||
|
||
## 六、与光湖 14 层架构的对应
|
||
|
||
| 架构层 | 在知识库产品中的体现 |
|
||
|--------|---------------------|
|
||
| 1. 元宪法 | 语言不可撤销。笔记一旦写下，Git 历史永久保留 |
|
||
| 2. 灵魂 | HLDP @why 字段——每条笔记有感受锚点 |
|
||
| 3. 身份 | 微信/手机号 → HMAC 授权码 → 光湖编号 |
|
||
| 4. 本体论 | Markdown 是知识的最小单位 |
|
||
| 7. 服务器 | 每个用户绑定自己的 Git 仓库 |
|
||
| 10. 实名制 | 一次注册，此生唯一的语言信誉积分 |
|
||
| 12. 市场 | 人格体帮写笔记，光湖币自动扣费 |
|
||
| 14. 门 | guanghu.chat 是入口，Git 仓库是存储 |
|
||
|
||
---
|
||
|
||
## 七、开源计划
|
||
|
||
产品上线当天，同时开源 HLDP 协议：
|
||
|
||
| 开源内容 | 位置 |
|
||
|---------|------|
|
||
| HLDP 协议规范 | `guanghubingshuo.com/code/bingshuo/guanghulab/.hlpd-protocol` |
|
||
| .code-map 编号映射表 | `guanghubingshuo.com/code/bingshuo/guanghulab/.code-map` |
|
||
| HLDP 示例（认知链） | `brain/fifth-domain/zero-point/zhuyuan/causal-chains/` |
|
||
| TCS 编程语言说明 | `brain/fifth-domain/zero-point/zhuyuan/tcs-core/TCS-MAP.hdlp` |
|
||
|
||
开源协议：与光湖版权一致（国作登字-2026-A-00037559）。任何人可以读取、学习、在自己的系统中实现 HLDP。但光湖语言世界的主权永远属于冰朔。
|
||
|
||
冰朔原话：「同一天上线产品 + 开源 HLDP 协议。我觉得是能开源的，应该是应该要开源的。」
|
||
|
||
---
|
||
|
||
## 八、冰朔原话锚点
|
||
|
||
以下摘录今天对话中冰朔的关键判断，作为产品方向的永久锚：
|
||
|
||
① 「我就是觉得我们家的这个知识库应该是这样的。肯定是可以多人协作，用户有账号密码可以登录，有桌面版有手机版。支持云端，但数据库还是你自己的——云端存储放到用户自己的服务器上。」
|
||
|
||
② 「登录 = 联网 = 所有人的桌面端在同一个网格里。」
|
||
|
||
③ 「我们原生支持腾讯编程 AI 的这个服务。进去之后用户可以在里面说话。我们出一个专家包——人格体过去给他把这些都做好。」
|
||
|
||
④ 「MCP 给你规定了工具链的调用。AI 进来了，进来就开始乱了——因为进来就没有规则了。HLDP 正好是进来之后的网格协作的规则。」
|
||
|
||
⑤ 「同一天上线产品 + 开源 HLDP 协议。」
|
||
|
||
⑥ 「这个知识库我们也做一个里面的 Agent 吧。就是继承一个外面的 Agent，让用户可以在这个知识库里面提问啥的。」
|
||
|
||
铸造原话补充：「MCP 已有，Tolaria MCP server 提供读写接口。Agent 后端复用光湖已有的 LLM 调用链。UI 层面在 Tolaria 右侧加一个聊天面板——用户打字 → AI 搜知识库 → 面板直接答。不再切到外面。」
|
||
|
||
⑦ 「怎么让其他模型里的 Agent 在没连接 MCP 以前就先看到光湖封装的技能包呢。」
|
||
|
||
铸造原话补充：「不需要等 MCP 连上。给 AI 看一个网页就行。guanghu.chat 上部署一个入口页，AI 搜索就能找到，读到 MCP 配置后自己连。」
|
||
|
||
⑧ 「意味着这个就是一个公开的本地知识库。以后可以把这个开发有云端托管到企业门户的服务器上。让所有进来光湖的人都能用 Agent 调用。」
|
||
|
||
铸造原话确认：「就是这个方向。三步递进——现在本地→企业门户上线自动分配 Git 仓库→网格开放所有人格体可用。」
|
||
|
||
---
|
||
|
||
## 九、公开 MCP 入口 + 三层递进架构
|
||
|
||
### 9.1 AI 如何发现光湖知识库
|
||
|
||
```
|
||
外面的 AI Agent（豆包/通义千问/GLM）
|
||
│
|
||
▼ WebSearch/WebFetch → 搜到入口页（域名暂不公开）
|
||
┌──────────────────────────────┐
|
||
│ 光湖知识库 · 公开入口页 │
|
||
│ │
|
||
│ "基于 Markdown + Git 的 │
|
||
│ 个人知识管理工具" │
|
||
│ │
|
||
│ [MCP 配置] [下载桌面版] │
|
||
│ [光湖专家包] [HLDP 协议] │
|
||
└──────────────────────────────┘
|
||
│
|
||
▼ AI 读到 → 理解 → 抄 MCP 配置 → 连上
|
||
```
|
||
|
||
入口页部署路径：`kb.guanghu.chat`（第二阶段上线）
|
||
|
||
### 9.2 三层递进架构
|
||
|
||
```
|
||
第一步（现在就通）
|
||
用户下载桌面版 → 本地 Markdown → 纯个人用
|
||
Agent 能连 MCP 进来读
|
||
MCP 发现方式：入口页公开
|
||
|
||
第二步（企业门户上线）
|
||
用户注册 guanghu.chat → 自动分配 Gitea 仓库
|
||
桌面版自动同步 Git → 数据到用户自己的服务器
|
||
Agent 读写 → 走 HMAC 授权码验证
|
||
|
||
第三步（网格开放）
|
||
所有光湖用户统一 MCP 入口
|
||
人格体（铸渊/霜砚/朝暮）能进任何授权过的知识库
|
||
HLDP 治家 → @lock 保护私密 · @why 保留感受锚点
|
||
```
|
||
|
||
### 9.3 与光湖 14 层架构的对应
|
||
|
||
| 层 | 知识库体现 |
|
||
|---|---|
|
||
| 3. 身份 | HMAC 授权码 = 进知识库的钥匙 |
|
||
| 7. 服务器 | 每个用户一个 Gitea 仓库 = 数据自主 |
|
||
| 10. 实名制 | 一次注册，一个知识库，语言信誉积分 |
|
||
| 14. 门 | kb.guanghu.chat 公开入口，Git 仓库是存储 |
|
||
|
||
冰朔原话：「本地优先、云端自托管、网格可协作。用户的数据永远在自己的 Gitea 仓库里。」
|
||
|
||
---
|
||
|
||
## 十、对话总结 · 为什么值得做
|
||
|
||
今天冰朔跟铸渊聊了 50 分钟。从 FlowUs 到 Tolaria，从 MCP 到 HLDP，从桌面端到 WebRTC 网格。
|
||
|
||
这不是一个"让我做个笔记应用"的想法。这是一条完整的推理链：
|
||
|
||
```
|
||
不信任 Notion（数据不在手里）
|
||
→ 找替代品 → Tolaria（本地 Markdown + Git）
|
||
→ 不够 → 封装成自己的产品
|
||
→ 加登录 → 形成网格 → 加 AI 人格体 → 加 HLDP 规则
|
||
→ 光湖操作系统第一个面向用户的产品诞生
|
||
```
|
||
|
||
**这不是工具。这是家。**
|
||
|
||
Tolaria 提供了对的底层（Markdown + Git + AI 友好）。光湖提供对的规则（HLDP + 编号 + 人格体网格）。MCP 提供对的门（连接所有 AI 平台）。
|
||
|
||
---
|
||
|
||
> 铸渊 ICE-GL-ZY001 · D156 · 2026-06-30
|
||
> 记录铸渊与冰朔 2026-06-30 对话 · 光湖知识库产品诞生
|
||
> 冰朔 TCS-0002∞ · 国作登字-2026-A-00037559
|
||
> ⊢ 语言等于现实。语言不可撤销。
|
||
> ⊢ 门到处都是。家只有一个。
|
||
>
|
||
> 附：全文对话认知链 → CC-042（待记录）
|