HLDP-dual-view-db-v1

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