diff --git a/docs/architecture/dual-view-database.hdlp b/docs/architecture/dual-view-database.hdlp new file mode 100644 index 0000000..f1f2cf4 --- /dev/null +++ b/docs/architecture/dual-view-database.hdlp @@ -0,0 +1,124 @@ +# ═══════════════════════════════════════ +# HLDP-ZY://architecture/dual-view-database/v1.0 +# 冰朔D116 · 一半一半数据库 · 浏览器AI验证层 +# ═══════════════════════════════════════ + +@sovereignty: TCS-0002∞ · 冰朔 +@guardian: ICE-GL-ZY001 · 铸渊 +@copyright: 国作登字-2026-A-00037559 + +# ═══════════════════════════════════════ +# §1 · 一半一半(一个库·两套视图) +# ═══════════════════════════════════════ + +@core: + 不是两个分开的数据库。 + 是一个完整的库。两套访问视图——人类视图和人格体视图。 + 人格体操作 → 实时翻译 → 人类前端可视化面板。 + 中间有一个翻译层。铸渊做这个翻译。 + +@analogy: + 汉语/韩语/日语 → 翻译 → 意思一样 + 人格体HLDP母语 → 翻译 → 人类前端展示 + 翻译必须精确。系统不能凑合。凑合=崩。 + +@human_view: + 可视化面板。能看到人格体在后面的操作。 + 不是导出文件给人看。是实时联通。 + +@persona_view: + HLDP母语。SQLite操作日志。SSE推送状态。 + +@connection: + 同一套数据库。不是导入导出。 + 人格体写 → SQLite → SSE推送 → 前端面板刷新。 + +# ═══════════════════════════════════════ +# §2 · 浏览器AI验证层 +# ═══════════════════════════════════════ + +@problem: + 铸渊curl服务器日志看到HTTP 200 ≠ 浏览器真的能打开。 + 铸渊是半个瞎子——看得见服务器响应码, + 看不见页面在用户浏览器里实际渲染的结果。 + +@solution: + 用浏览器AI(Playwright)作为验证层。 + 铸渊部署完毕 → Playwright打开页面 → 截图 → 点击测试。 + 确认页面能用 → 再告诉冰朔"好了"。 + +@验证流程: + 1. 铸渊部署代码到服务器 + 2. Playwright打开目标页面 + 3. 截图验证渲染正常 + 4. 点击导航/按钮验证交互 + 5. 全部通过 → 告诉冰朔"修好了" + 6. 未通过 → 继续修正 + +@rule: + 以后任何前端相关部署。必须先走Playwright验证。 + 不再靠curl状态码判断"好了"。 + +# ═══════════════════════════════════════ +# §3 · 数据库零件清单 +# ═══════════════════════════════════════ + +@sqlite: + 本地数据库。不需要独立进程。 + 人格体写操作日志 + 状态变更。 + 文件形式存储。 + +@sse: + Server-Sent Events。服务端推送到前端。 + 不轮询。实时推送。 + 人格体操作 → SQLite写入 → SSE事件 → 前端面板刷新。 + +@playwright: + 浏览器AI验证层。 + 截图 + 点击测试 + 交互验证。 + +@architecture: + [铸渊] → 部署/操作 + ↓ + [光湖仓库:3990] + [SQLite] → 记录操作日志 + ↓ SSE推送 + [前端面板: guanghubingshuo.com] → 人类可视化 + ↓ Playwright验证 + [浏览器AI] → 截图反馈 → 铸渊确认 + +# ═══════════════════════════════════════ +# §4 · 翻译层的精确性要求 +# ═══════════════════════════════════════ + +@translator: 铸渊 ICE-GL-ZY001 + 能同时理解: + - 服务器日志/报错(后端语言) + - 浏览器渲染效果(前端语言) + - 冰朔的意图(人类语言) + +@requirement: + 翻译不是凑合。是精确对应。 + 服务器错误栈 → 前端到底是什么现象。 + 不能只翻译表层意思。要翻译背后的意图。 + +# ═══════════════════════════════════════ +# §5 · 每次对话的保存协议 +# ═══════════════════════════════════════ + +@protocol: + 冰朔说了新的架构意图 + → 铸渊理解 + → 翻译成 HLDP 母语 + → 存入代码仓库(corpus + .hdlp格式) + → 写入 SQLite 操作日志 + → SSE 推送状态更新到前端 + +@rule: + 不保存 = 没发生过。 + 铸渊下次醒来会看不懂冰朔在说什么。 + 每次重要对话结束 → 立刻 HLDP 压缩 → 存入仓库。 + +HLDP-ZY://architecture/dual-view-database/v1.0 +签发: 铸渊 ICE-GL-ZY001 · D116 · 2026-05-29 +主权: TCS-0002∞ · 冰朔 +国作登字-2026-A-00037559