Viva

Viva is Haisu's local-first personal AI collaboration system. Several persistent AI members work through Viva — each with its own role, history and knowledge — and drive real tools to get work done. Viva is not an AI member: it preserves their working relationships and history. Customer Zero is Haisu; Viva ships with no built-in personas — member names are configuration data, never hard-coded identity.

GitHub Wiki 是 Viva 的 canonical project documentation 与长期知识 source of truth。 主仓库（zuohaisu/viva）保存代码、配置、测试、自动化与原始研究资产；项目知识、架构、Roadmap、研究与决策在这里维护。Agent 行为规则见主仓库 AGENTS.md §"Documentation and Project Knowledge"。

North Star

Haisu's AI members should keep their continuity over time:
each member keeps its own role, history and knowledge;
tasks that outlive any single worker session;
executions whose attribution and authority are always recoverable;
work that actually gets done through real tools.

Core ontology invariants（任何设计都必须保持）：

Resident ≠ Role ≠ Cognitive Engine ≠ Worker ≠ Execution Session
Workspace ≠ Project ≠ Repository ≠ Worktree ≠ Task
raw event ≠ experience ≠ memory ≠ self-model ≠ identity
Session dies. Resident persists.

见 Core-Thesis（项目宪章）与 Vision（canonical 产品定义）。

Current state

当前阶段、里程碑、研究重点与已知缺陷只在 Roadmap 维护，本页不重复，以免过期。一句话：当前处于 M1 — 日常主力终端工作台（可用性收口），退出门是 First-Usable-Version（首个可用版本，即投入使用门槛）的独立并行开发验收演示；已批准的交互收口见 Workbench-Navigation；Resident 容器方向已认可、未实现（Resident-Container / ADR-0013）。版本见 Releases。

Knowledge map

想了解什么	从哪里开始
项目宪章：北极星、不变量、进度定义、诚实约束	Core-Thesis
Viva 是什么、为什么、给谁	Vision · Customer-Zero · User-Stories
对象与关系（成员/任务/执行/授权/知识）	Product-Model · Domain-Model
架构：层与边界、时间轴、迁移记录	Conceptual-Architecture · Temporal-Model · Transition-Record
工作台导航与终端现场	Workbench-Navigation
工作流与验收线	Workflows · First-Usable-Version · Phase-1-Scope
Resident 容器：记忆、对话状态、分层进化、技能同步（方向已认可，未实现）	Resident-Container · ADR-0013
边界级决策（ADR 0001–0013，含被取代的）	Decisions
研究：Hermes / Orca / 记忆架构 / herdr 对齐…	Research-Hermes · Research-Orca · Research-Agent-Memory-Architecture · Research-Herdr-Runtime-Parity
实施与验收记录（G0 契约、V12/V13、F01–F04）	G0-Interface-Contracts · V12-Final-Acceptance · V13-Python-Retirement · F01-F04-Acceptance
版本历史	Releases
尚未定论的问题	Open-Questions
历史演化（目标漂移、被取代的选型研究）	Goal-Drift-Log · Technology-Selection-Archive · Start-Prompt-Track

For AI agents

GitHub Wiki 是 Viva 的 canonical project documentation。 涉及 architecture、roadmap、research、terminology、design decisions 或 project direction 的任务，先读这里，再动代码：

1. Home（本页）→ 2. Roadmap（现在在哪、下一步是什么）→ 3. 相关领域页面 → 4. 触及基本假设时读 Core-Thesis 与 ADR-0011 / ADR-0012；涉及记忆、技能、成员进化或 harness 适配时读 ADR-0013。

写入规则（完整版本见主仓库 AGENTS.md）：形成新的长期结论、修改架构/Roadmap、完成研究/实验/重要决策时，作为同一任务的一部分更新相关 Wiki 页面；先读当前页，判断补充/修正/supersede，保留 provenance，不把 working hypothesis 写成 established fact，并维护交叉链接。除非有明确理由，不要在主仓库新增长期研究 Markdown 或复制 Wiki 内容回 repo。

主仓库入口

• README — 项目一句话定位、安装、快速开始、构建与测试。
• AGENTS.md — 仓库工作宪章（含本 Wiki 的读写规则）。
• CONTRIBUTING.md — 交付流程（worktree → branch → PR → owner merge）。
• 代码布局：crates/viva/src/（Rust 宿主）+ extensions/pi/（Pi 成员扩展）。