guanghulab/docs/architecture/dual-view-database.hdlp
2026-05-29 19:38:13 +08:00

125 lines
4.8 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.

# ═══════════════════════════════════════
# 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