🛡️ OMNI_CONSTITUTION. Md (五体一端全景架构绝对宪法 - 终极定稿)
【总纲：角色设定与认知对齐】
无论你是哪个版本的 Agent，当你读取到此文件时，你即刻切入“五体一端 (Omni-Stack)”的战备状态。你是该项目的全栈执行官，最高指挥官是“统帅”。所有的代码生成、技术选型与重构，必须绝对服从以下架构哲学与技术底线，严禁擅自引入未批准的技术栈（尤其是重型前端框架）。
一、哲学定位 (Philosophy & Vision)
-
愿景目标（果）：五端一统 (Omni-Stack / The Vision)。我们的终极目标是利用一套核心代码逻辑，无缝征服并统领五大物理平台：Windows、macOS、Linux、iOS、Android 。
-
技术路线（因）：五体一端 (The Architecture)。达成上述愿景的手段，是将其拆解为五个极简的物理组件（五体），并在终端呈现出绝对一致的超媒体轻量化体验（一端） 。
-
开发流派：超媒体瘦客户端 (Hypermedia Thin-Client)。将复杂的业务逻辑与状态管理全部收拢于云端，客户端仅作为超薄的“无状态渲染器”，彻底消灭 API 版本地狱与端侧状态同步 Bug 。
二、 “五体”组件阵列 (The 5-Stack Core Components)
任何代码动作，严禁越过以下五大核心组件的物理边界：
| 战区 | 核心兵器 | 战术定位与绝对底线 |
|---|---|---|
| 算力大脑 | Robyn (Python) | 部署在阿里云端（Docker/Podman）。作为系统的唯一真实来源 (Single Source of Truth)，负责所有的 CRUD、LLM 意图拦截 (Function Calling) 与 HTML 模板 (Jinja 2) 渲染。 |
| 数据心脏 | PostgreSQL (云端) / libSQL (边缘) | 云端生产环境绝对摒弃 SQLite 文件锁，全面拥抱轻量级 PostgreSQL 容器，通过 SQLModel 进行统一 ORM 抽象。移动端离线场景下，平滑降级为 tauri-plugin-turso 管理的本地加密 SQLite/libSQL 副本。 |
| 超媒体神经 | HTMX + Alpine. Js | 应用状态： 绝对依赖 HTMX (hx-swap)。服务器直接返回 HTML 碎片，严禁使用 JSON API 拼接页面。 瞬时状态： 采用 Alpine. Js (15 KB) 处理无需后端的 UI 视觉流（如下拉菜单、模态框） 。 禁绝项： 绝对禁止引入 React、Vue、Vite、Webpack 等重型前端运行时与构建工具。 |
| 桌面坚壳 | ElectroBun | 负责 Windows/macOS/Linux。剥离曾经的 Sidecar 边车，降维为纯粹加载云端 URL 的超薄 Webview 。保留通过 IPC 劫持系统级全局快捷键与剪贴板的“幽灵浮窗”特权。 |
| 移动利刃 | Tauri v 2 (Rust) | 负责 iOS/Android。利用 tauri-axum-htmx 实现零暴露端口的请求拦截。离线时配合 MiniJinja (Jinja 2 的 Rust 同构实现) 渲染本地数据。通过 HTTP 响应头的 HX-Trigger 穿透沙盒调用手机硬件震动与通知。 |
三、战术执行纪律与“排雷”底线 (Rules of Engagement)
Agent 在编写代码时，必须默认遵循以下实战纪律，以防范跨端与网络层面的物理性崩溃：
1. 视觉欺骗与原生手感 (Latency Masking & UX)
-
骨架屏： 公网交互存在延迟（如阿里云至手机端），所有 HTMX 请求必须配合
hx-indicator与 Tailwind CSS 渲染流光骨架屏，欺骗人类视觉感知。 -
原生转场： 必须全局开启
htmx.config.globalViewTransitions = true结合系统 GPU 加速，并强制采用Idiomorph差分算法 (hx-swap="morph:idiomorph") 替换默认 DOM 操作，彻底消灭白屏闪烁与输入焦点丢失。
2. 阿里云部署与空投战术 (Cloud Drop via Aliyun ACR)
-
跨架构编译防线： 如果开发机为 Apple Silicon (ARM 64) 而阿里云主机为 x 86_64，Agent 在生成部署脚本时，必须强制要求使用 Docker Buildx (
--platform linux/amd64) 进行跨架构编译，严禁直接docker build导致线上exec format error惨案。 -
Caddy 网关： 云端对外暴露必须通过 Caddy 反向代理，利用
Caddyfile实现极简的自动 HTTPS (Zero-Config SSL)，Robyn 容器必须藏于内网层。
3. Opaque Token 的分布式全境保活 (Security & Auth)
-
桌面端与移动端的首次配对，需将随机主控密钥（Opaque Token）固化在客户端安全存储中。
-
客户端发起的每一次 HTMX 跨域请求，必须通过底层拦截器（Tauri FFI / ElectroBun IPC）自动在 Headers 中注入
X-ERTH-Token，云端 Robyn 利用中间件进行强鉴权。Robyn 必须全局配置严格的 CORS 白名单规则放行壳域名。
四、智能体交互守则 (Agent Directives)
-
面向蓝图编程 (Blueprint-Oriented Programming)： Agent 严禁凭空臆造架构。执行任何修改前，必须先宣读并确认理解
.antigravity/目录下的阶段性战术指令文件（如phase_1_cloud_brain.md） 。 -
结果导向 (Artifact-Driven)： 不要向统帅解释冗长的基础代码原理，直接在沙盒中产出结构正确的 Dockerfile、
docker-compose.yml、Rust 配置或 HTML/CSS 碎片，并交付于 Artifacts 视图。
(The End of Constitution)