项目结构

完整规格见 00-product-spec.md。

1. Rust Workspace

members = [
    "crates/yzos-core",
    "crates/yzos-runtime",
    "crates/yzos-cli",
    "crates/yzos-mcp",
    "crates/yzos-mcp-harness",
    "src-tauri",
]

Crate	产物	职责
yzos-core	lib	领域逻辑、PostgreSQL、OKF、实体、观察、推理、平台能力
yzos-runtime	lib	HTTP server、MCP、observe 循环、crystallize 循环、sidecar 管理
yzos-cli	bin yzos	本机 HTTP client
yzos-mcp	bin yzos-mcp	MCP adapter
yzos-mcp-harness	test harness	MCP 集成测试
src-tauri	bin yzos-desktop	Tauri host，链接 runtime

2. crates/yzos-core

crates/yzos-core/src/
  -> activity/
  -> apps/
  -> bootstrap/
  -> crystallize/
  -> db/
  -> entity/
  -> inference/
  -> maintain/
  -> models/
  -> observe/
  -> platform/
  -> privacy/
  -> supply/
  -> sync/

目录	职责
activity	activity session 存储、recorder
observe	剪贴板、AI 工具、OCR、屏幕捕获
crystallize	triage、OKF、场景路由、embedding
entity	实体引擎、信号、搜索、OKF writer
inference	调度器、LLM sidecar client、VLM profile
maintain	cron、jobs、调度
platform	macOS 权限、辅助功能、捕获能力
supply	API handlers、pipeline

3. crates/yzos-runtime

crates/yzos-runtime/src/
  -> lib.rs
  -> server.rs
  -> mcp.rs
  -> llama_sidecar.rs
  -> state_file.rs

yzos-runtime 是运行时库，链接进 src-tauri。

4. src-tauri

src-tauri/
  -> Cargo.toml
  -> tauri.conf.json
  -> Entitlements.plist
  -> Info.plist
  -> src/
       -> main.rs
       -> lib.rs

Tauri host 负责窗口、菜单栏图标、权限请求、前端 bridge，并启动 runtime。

5. Migrations

migrations/
  -> 001_activity.sql
  -> 002_okf.sql
  -> 003_p1.sql
  -> 004_entities.sql
  -> 005_search_vector.sql
  -> 006_pgvector.sql
  -> 007_clipboard.sql
  -> 008_activity_screen_segments.sql
  -> 009_screen_segments_ocr_text.sql
  -> 010_voice_segments.sql
  -> 011_entity_metadata_indexes.sql
  -> 012_embed_dims_1024.sql
  -> 013_cron_jobs.sql

UI State Engine 的目标迁移会新增 ui_snapshots、ui_nodes、ui_regions、ui_text_boxes、ui_behavior_events。

6. 脚本

脚本	职责
scripts/dev-install.sh	构建并部署 /Applications/YZOS.app
scripts/install-autostart.sh	安装登录自启动
scripts/uninstall-autostart.sh	卸载登录自启动
scripts/fetch-models.sh	下载模型
scripts/fetch-sidecars.sh	下载 sidecars
scripts/verify-supply.sh	验证供料接口
scripts/verify-goal-e2e.sh	验证端到端目标完成情况

7. 生成文件

.stdai/standards 是 AI 助手规则的真源。修改后运行：

stdagent sync --target claude-code --target codex

不要手动编辑 AGENTS.md、CLAUDE.md、.claude/rules/、.codex/memories/，它们都是生成产物。