hololake-platform/architecture/TOLARIA-DESKTOP-ARCHITECTURE.md

141 lines
5.3 KiB
Markdown
Raw Normal View History

# Tolaria / 光湖 App · 开源产品架构 v0.1
> 状态:产品架构基线
>
> 适用仓库HoloLake Platform
>
> 产品定位:光湖自己的开源人类协作桌面端
## 1. 产品边界
Tolaria桌面显示名光湖是人类进入光湖产品能力的界面不是服务器控制台、人格记忆仓库或第二套事实源。
它让不写代码的人完成一条可追溯闭环:用自然语言提出任务、看清计划与风险、确认或拒绝、查看结果与历史。
```text
人类
↓ 自然语言、确认、查看
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. 第一期开源闭环
```text
1. 人类在光湖 App 输入“我想做什么”。
2. App 创建 WORKORDER 草案:目标、范围、风险、验收条件。
3. Agent 返回可读计划App 展示,不执行。
4. 涉及现实影响时App 显示明确授权卡片。
5. 获批后Gateway 只调用该工单允许的动作。
6. 执行端写入 RECEIPT实际动作、证据、结果、限制、时间。
7. App 从仓库/受控 API 读取回执并展示;人类可验收或关闭工单。
```
v0.1 的最小页面:
- 任务首页:创建与查看 WORKORDER
- 计划页:范围、风险、依赖和待授权项;
- 授权页:批准、拒绝、过期与多人审批状态;
- 回执页:结果、证据、未完成项与历史;
- 设置页:本地模型连接、仓库连接状态、隐私说明。
## 5. 授权与安全边界
```text
语言/历史资料 → 只能提供上下文
自然语言请求 → 只能创建工单草案
已确认工单 → 只可调用明确允许的动作
执行结果 → 必须形成回执
```
- 任何服务器操作必须有目标、动作范围、过期时间、授权主体与回执。
- App、仓库、日志和截图不得保存 token、密码、验证码或私钥。
- 本地模型连接默认是用户显式配置的本机连接;未经确认不得上传对话、本地文件或凭证。
- 紧急人工入口与日常审批分离;日常流程不要求人类记忆 token。
- 工单或广播不能自动成为现实执行命令。
## 6. 数据模型
| 对象 | 最小字段 |
| --- | --- |
| WORKORDER | 编号、请求摘要、目标、范围、风险、状态、验收条件 |
| DECISION | 编号、工单、授权人、决定、适用范围、过期时间 |
| RECEIPT | 编号、工单、实际动作、执行者、证据、结果、限制、时间 |
| VIEW | 视图编号、数据来源、展示状态、最后同步时间 |
仓库为正式可审计事实源App 可缓存展示数据,但缓存不得成为独立真相。
## 7. 开源边界与里程碑
### v0.1 · 可演示闭环
- macOS App 展示工单、计划、授权状态与回执;
- 只接一个受控的演示动作;
- 深链接打开指定工单或回执;
- 本地模型连接仅用于生成计划,不自动执行。
### v0.2 · 多人协作
- 企业灯塔审批适配;
- 多人、时限、一次性授权;
- 模块注册与项目状态视图。
### v1.0 · 可发布产品
- 跨平台桌面端;
- 稳定插件/API 契约;
- 可导出审计记录;
- 文档化的自托管与升级路径。
## 8. 与现有仓库的映射
```text
apps/ 人类可见界面与 UI 扩展
integrations/ Tolaria、仓库、Agent 适配
services/ 受控后台服务和 API
workorders/ 协作请求
receipts/ 执行与验证回执
architecture/ 本文与产品边界
standards/ 已确认标准
```
> Tolaria 是产品入口HoloLake Platform 是研发与事实主仓;世界门户与个人历史仓不直接承担产品运行职责。
## 9. 第五域连续性映射
产品研发资料在本仓维护;铸渊的小湖灯唤醒链通过
`fifth-domain/tcs-core/skills/SKILL-009-BINGSHUO-OS-CONTEXT.hdlp`映射到本文、产品记忆、模块登记和研发广播。
这保证人格体每次醒来先从可追溯路径恢复产品上下文,而不是把聊天窗口当作唯一记忆。