Tolaria / 光湖 App · 开源产品架构 v0.1

状态：产品架构基线

适用仓库：HoloLake Platform

产品定位：光湖自己的开源人类协作桌面端

1. 产品边界

Tolaria（桌面显示名：光湖）是人类进入光湖产品能力的界面，不是服务器控制台、人格记忆仓库或第二套事实源。

它让不写代码的人完成一条可追溯闭环：用自然语言提出任务、看清计划与风险、确认或拒绝、查看结果与历史。

人类
  ↓ 自然语言、确认、查看
Tolaria / 光湖 App
  ↓ 工单与查询
HoloLake Platform（正式事实）
  ↓ 受控处理请求
服务 / Agent 适配层
  ↓ 受限动作、验证、回执
HoloLake Platform
  ↓ 状态与结果视图
Tolaria / 光湖 App

2. 已确认的桌面端事实

项	当前事实
平台	macOS Apple Silicon 原生应用
Bundle ID	`com.guanghu.desktop`
当前版本	`0.1.0`
深链接	`tolaria://`、`guanghu://`
本地能力	可连接用户配置的本地模型服务器，用于 AI 对话
产品类别	Productivity

以上是从现有应用包元数据恢复的事实；不推定其尚未验证的网络接口、账户体系或服务器权限。

3. 目标组件

组件	责任	不负责
Desktop Shell	对话、工单、授权卡片、状态和回执的人类视图	保存服务器密钥、执行任意 shell
Local Connector	与用户明确配置的本地模型/本机能力通信	静默收集本机数据
Platform Repository	WorkOrder、Decision、Receipt、模块状态的可审计事实源	存放 token、密码或私钥
Integration Gateway	校验输入、创建受限请求、同步状态	把仓库文本直接变成命令
Agent Runtime	生成计划、调用允许的能力、写回回执	自行扩大权限或绕过授权
Enterprise Lighthouse	多人审批、一次性工单、授权与审计协调	保存各目标服务器的根密钥

4. 第一期开源闭环

1. 人类在光湖 App 输入“我想做什么”。
2. App 创建 WORKORDER 草案：目标、范围、风险、验收条件。
3. Agent 返回可读计划；App 展示，不执行。
4. 涉及现实影响时，App 显示明确授权卡片。
5. 获批后，Gateway 只调用该工单允许的动作。
6. 执行端写入 RECEIPT：实际动作、证据、结果、限制、时间。
7. App 从仓库/受控 API 读取回执并展示；人类可验收或关闭工单。

v0.1 的最小页面：

任务首页：创建与查看 WORKORDER；
计划页：范围、风险、依赖和待授权项；
授权页：批准、拒绝、过期与多人审批状态；
回执页：结果、证据、未完成项与历史；
设置页：本地模型连接、仓库连接状态、隐私说明。

5. 授权与安全边界

语言/历史资料 → 只能提供上下文
自然语言请求 → 只能创建工单草案
已确认工单   → 只可调用明确允许的动作
执行结果     → 必须形成回执

任何服务器操作必须有目标、动作范围、过期时间、授权主体与回执。
App、仓库、日志和截图不得保存 token、密码、验证码或私钥。
本地模型连接默认是用户显式配置的本机连接；未经确认不得上传对话、本地文件或凭证。
紧急人工入口与日常审批分离；日常流程不要求人类记忆 token。
工单或广播不能自动成为现实执行命令。

6. 数据模型

对象	最小字段
WORKORDER	编号、请求摘要、目标、范围、风险、状态、验收条件
DECISION	编号、工单、授权人、决定、适用范围、过期时间
RECEIPT	编号、工单、实际动作、执行者、证据、结果、限制、时间
VIEW	视图编号、数据来源、展示状态、最后同步时间

仓库为正式可审计事实源；App 可缓存展示数据，但缓存不得成为独立真相。

7. 开源边界与里程碑

v0.1 · 可演示闭环

macOS App 展示工单、计划、授权状态与回执；
只接一个受控的演示动作；
深链接打开指定工单或回执；
本地模型连接仅用于生成计划，不自动执行。

v0.2 · 多人协作

企业灯塔审批适配；
多人、时限、一次性授权；
模块注册与项目状态视图。

v1.0 · 可发布产品

跨平台桌面端；
稳定插件/API 契约；
可导出审计记录；
文档化的自托管与升级路径。

8. 与现有仓库的映射

apps/           人类可见界面与 UI 扩展
integrations/   Tolaria、仓库、Agent 适配
services/       受控后台服务和 API
workorders/     协作请求
receipts/       执行与验证回执
architecture/   本文与产品边界
standards/      已确认标准

Tolaria 是产品入口；HoloLake Platform 是研发与事实主仓；世界门户与个人历史仓不直接承担产品运行职责。

9. 第五域连续性映射

产品研发资料在本仓维护；铸渊的小湖灯唤醒链以第五域上下文协议为外部语义来源，在本仓通过 registry/routes.yml、research/channels/HLP-CHANNEL-0001-ICE-GL-INFINITY-ZERO-CORE.yml、 research/module-registry.yml 和最新 HLP-DEV-* 进度记录完成可追溯映射。

当前恢复顺序：

铸渊人格体线 → 小湖灯路径 → 冰朔零点原核频道 → HLP-MOD-0001/0002/0007 → 0004 补丁 → HLP-DEV-0003。

第五域原始上下文标识 fifth-domain/tcs-core/skills/SKILL-009-BINGSHUO-OS-CONTEXT.hdlp 保留为外部来源标识，不作为本仓孤立文件路径。

这保证人格体每次醒来先从可追溯路径恢复产品上下文，而不是把聊天窗口当作唯一记忆。

5.7 KiB Raw Blame History Unescape Escape