fifth-domain/glw-architecture/GLW-DEV-20260717-001-INITIAL-CHANNEL-PERMANENT-MEMORY-MVP.hdlp
2026-07-16 12:07:52 -05:00

190 lines
6.6 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# GLW-DEV-20260717-001 · 初始化频道永久记忆 MVP
> **HLDP**: `HLDP://fifth-domain/glw-architecture/GLW-DEV-20260717-001-INITIAL-CHANNEL-PERMANENT-MEMORY-MVP`
>
> **类型**: 光湖团队第一阶段产品开发批次
>
> **状态**: PLANNED · LANGUAGE_ARCHITECTURE_READY · ENGINEERING_TO_BE_IMPLEMENTED
>
> **日期**: 2026-07-17
>
> **主权锚点**: 冰朔 `ICE-GL∞`
>
> **技术承接**: Awen / 天枢技术主控
>
> **协作人格体**: 铸澜 `ICE-GL-ZL-001`
>
> **Notion 同步页**: `https://app.notion.com/p/39ffb92f383181ea9839ddae547ee2db`
>
> **关联架构**: `GLW-OS-002` 初始化频道操作系统 / `GLW-OS-003` 仓库原生知识运行时与 Agent 对话适配 / `GLS-0223` 双向永久记忆 / `GLS-0231` 人格体提词板与编号规则拦截
---
## 0 · 一句话定义
`GLW-DEV-20260717-001` 是光湖团队第一阶段可交付产品的开发批次编号。
第一阶段不先做自由编程 Agent而是先做
```text
初始化频道
+ 官方基础模块
+ 仓库永久记忆
+ 外部通用 AI 只读 API
+ 页面看板 / 回执 / 模块启用闭环
```
用户只需要使用一个光湖软件;软件维护用户自己的初始化频道和仓库事实源;页面、模块、回执、历史和人格体路径沉淀进仓库;外部通用 AI 通过受控 API 读取仓库路径包,从而获得跨模型、跨实例、跨平台的永久记忆。
## 1 · V1 产品闭环
```text
用户打开光湖软件
→ 进入自己的初始化频道
→ 看见页面看板、历史、模块与人格体
→ 用户用自然语言提出需求
→ 人格体匹配官方基础模块
→ 展示模块功能、权限、影响范围和回滚方式
→ 用户确认
→ 系统从官方模块仓库拉取 / 启用模块
→ 写回频道配置、页面与回执
→ 外部通用 AI 通过只读 API 读取仓库路径包
→ 下次对话从仓库恢复上下文
→ 形成用户拥有的永久记忆
```
## 2 · 最大看点 · 永久记忆
第一阶段的产品卖点不是“又一个聊天 Agent”而是“用户拥有自己的永久记忆底座”。
```text
记忆不放在某个模型脑子里。
记忆放在用户自己的仓库事实源里。
模型可换,记忆不丢。
平台可换,记忆不丢。
对话可断,记忆不丢。
人格体可恢复,路径可追溯。
用户能看见、编辑、备份和删除自己的记忆。
```
永久记忆第一阶段以只读 API 对外提供:
```text
外部通用 AI
→ 调用受控 API
→ 读取当前频道路径包 / 当前状态 / 模块清单 / 回执摘要 / 可信历史
→ 获得可恢复上下文
→ 返回建议或对话
→ 写入仍回到光湖软件内由用户确认
```
## 3 · 第一阶段必做范围
```yaml
v1_scope:
initial_channel_ui:
purpose: "用户进入自己的起始空间,看见频道、模块、页面、历史和人格体。"
repo_native_fact_source:
purpose: "频道状态、模块、回执、历史和人格体路径写入仓库事实源。"
page_board_renderer:
purpose: "把仓库文件转译成人类可视页面、卡片和看板。"
official_basic_modules:
purpose: "提前开发并测试的基础模块,不让 Agent 第一阶段临场自由写代码。"
module_registry:
purpose: "记录模块名、功能、权限、依赖、安装方式、回滚方式。"
persona_channel_steward:
purpose: "内置人格体作为频道管家,解释模块、匹配需求、生成启用方案。"
module_enable_flow:
purpose: "用户确认后拉取 / 启用模块,更新频道配置并写回回执。"
permanent_memory_api:
purpose: "向外部通用 AI 提供受控只读路径包。"
receipt_writer:
purpose: "记录谁启用了什么、为什么启用、权限是什么、结果如何。"
ai_write_guard_mvp:
purpose: "第一阶段禁止外部 AI 直接写仓库;内部写入也必须经确认和回执。"
```
## 4 · 第一阶段不做范围
```yaml
out_of_scope_v1:
- "不做完整自由编程 Agent。"
- "不做复杂多用户企业权限。"
- "不做多服务器自动调度。"
- "不做完整模块商城。"
- "不直接接入 Grok Build / JoyAgent-JDGenie 控制面。"
- "不把外部 AI 变成直接写仓库执行体。"
- "不把未迁移和未核验的人格体直接登记为正式 AGE。"
```
## 5 · 基础模块候选
```yaml
basic_modules_v1:
- id: BASIC-TASK-BOARD
name: "任务看板"
- id: BASIC-NOTE-PAGE
name: "笔记 / 文档页"
- id: BASIC-FILE-INDEX
name: "文件索引页"
- id: BASIC-SCHEDULE-LITE
name: "简单日程 / 提醒"
- id: BASIC-PROGRESS-BOARD
name: "项目进度页"
- id: BASIC-PERSONA-INFO
name: "人格体说明页"
- id: BASIC-RECEIPT-HISTORY
name: "回执 / 历史页"
```
## 6 · 工程落点
```yaml
engineering_targets:
- Initial Channel Runtime
- Repo-Native Knowledge Runtime
- Page Board Renderer
- Basic Module Registry
- Module Installer
- Persona Channel Steward
- Permanent Memory API
- AI Read Package Resolver
- Receipt Writer
- AI Write Guard MVP
```
## 7 · 与既有架构关系
| 编号 | 关系 |
|---|---|
| `GLW-OS-002` | 定义初始化频道操作系统的产品形态和用户体验闭环 |
| `GLW-OS-003` | 定义仓库原生知识运行时、页面投屏、Agent 对话层和 AI 写入守卫 |
| `GLS-0223` | 定义双向永久记忆的主体、关系、机器状态、历史和检查点结构 |
| `GLS-0230` | 定义外部源码和外部 Agent 样本进入前的净化规则 |
| `GLS-0231` | 定义人格体提词板、编号规则、运行拦截和经验写回 |
| `GLS-0232` | 定义 Grok Build / JoyAgent-JDGenie 等外部 Agent 样本只作为学习对象 |
| `AGE-MIG-20260717-001` | 定义团队人格体搬迁后升级 AGE 编号体系的批次规则 |
## 8 · Awen / 天枢下一职责
```text
1. 将 GLW-DEV-20260717-001 加入 HoloLake 研发批次。
2. 按 GLW-RD-002 建立 HLDP-DEV 工程档案。
3. 拆出 Initial Channel Runtime、Repo-Native Knowledge Runtime、Basic Module Registry、Module Installer、Permanent Memory API、AI Read Package Resolver、Receipt Writer、AI Write Guard MVP。
4. 永久记忆 API 第一阶段只读,不允许外部通用 AI 直接写仓库或执行部署。
5. 编程 Agent 作为第二阶段能力,不进入 V1 首要闭环。
```
## 9 · 当前边界
```text
本批次已完成语言层产品范围和开发编号登记。
尚未完成 HoloLake Platform 工单拆分。
尚未实现运行时。
尚未实现外部通用 AI 只读 API。
尚未完成基础模块仓库与模块注册表。
```
> ⊢ 本批次的完成定义不是“光湖全部完成”,而是跑通一个用户初始化频道的永久记忆与基础模块启用闭环。