Roadmap - zuohaisu/viva GitHub Wiki
Roadmap
Status: Accepted（Haisu 2026-10-14 在 viva#100 裁决接受，按 milestone 推进）· 基线：2026-10-06，origin/main @ 871a00a
Provenance — 由 PR #64 的 evidence-driven roadmap 提案与主仓库发布/issue 记录综合而成；Wiki Roadmap 为 canonical 位置。PR #64 已于 2026-10-06 关闭、未合并（提案内容迁入本页），全文仅作背景。阶段编号不对应 npm minor 版本；现行宪章与 accepted ADR 继续约束实施。
路线目标
North Star 以 Core-Thesis 为准（本页不另写一版）。路线层面的目标是：
Haisu 从任何受支持的工作入口找到同一批长期成员；成员能换模型、换工具、换会话继续任务，在授权范围内组织其他成员，并把有来源的工作经验用于后续工作。
衡量路线的四个问题：
- 能工作吗？ 不依赖 Orca，从普通终端完成真实并行任务。
- 能接着工作吗？ 会话结束或模型更换后，目标、决定、未完成项和必要知识不蒸发。
- 能组织工作吗？ 一个协调成员受控分派、跟进、交接、核验证据，而非仅向几个窗口输入文字。
- 积累能保全吗？ 成员资产可导出、恢复，最终可跨设备使用，不绑定供应商或某一进程。
herdr 提供运行时参照，Orca 提供工作台体验参照；二者不是 Viva 的终局。记忆不是全量日志，自模型不是人格提示词，编排不是固定 Dev→QA 流水线（Core-Thesis、ADR-0008）——User-Stories Story 7 的 Dev → QA → 打回修复流转仍是目标（Haisu 2026-10-14），由协调成员按任务与 grant 动态派发来实现，而不是在代码里写死顺序（见 M3）。
Current Stage
M1 — 日常主力终端工作台（可用性收口）。基础已超过"准备从零做第一期"：成员/任务/执行/授权/恢复的 Rust 领域实现、herdr 形态常驻运行时（V14 S1–S6）、V15 工作台深化与 UI 已全部合入并随 v0.3.0 发布。当前不做新平台，收口可用性与真实使用验收。Haisu 2026-10-14：先完成 M1，然后 M3，再 M2，然后 M4（Goal-Drift-Log）。M2 的范围和退出门等 Resident 容器讨论收口后再按 ADR-0013 改写，本次不改。
Current Milestone：First-Usable-Version 的独立并行开发验收演示 —— Orca 关闭、一次 Viva 启动、≥3 个真实任务/隔离 worktree、真实 Pi + 另一已安装 Agent CLI、多终端交互、停止隔离、退出恢复。该门槛在 V12-Final-Acceptance §4 仍标注 pending；现有 sleep/PTY 采样不能代替真实 Agent 负载验收。
Current Research Focus：记忆后端受控比较（Research-Agent-Memory-Architecture：OpenViking 优先验证，Holographic 为轻量基线）——2026-10-14 Haisu 决定 Viva 记忆存储改为 Rust 原生实现、不依赖 Hermes（viva#109，未实现；Goal-Drift-Log）；self-model 容器边界与取材通道（ADR-0012 §5：受控申报已建，容器/治理/演化循环未实现）。Resident 容器方向 2026-10-13 已认可（Resident-Container / ADR-0013），未实现。
Completed
| 里程碑 | 交付 | 证据 |
|---|---|---|
| Rust 首版实现（V01–V13） | 成员/任务/执行/授权/恢复/知识/GitHub 只读、SQLite 状态层、Pi 扩展、安装发行；Python 运行时退役 | issues #10–#22（closed）；Rust-Rollout-Plan · V13-Python-Retirement |
| 后续能力（F01–F04） | 交付工作流、知识复审维护、计算机操作、Holographic 记忆接入 | issues #23–#26（closed）；F01-F04-Acceptance（含待独立复验项） |
| herdr 对齐运行时（V14 S1–S6） | 常驻 server、detach/attach、多 pane、类型二活恢复、agent 状态三层、编排 API、暂停语义 | PR #50（2026-10-01）；Research-Herdr-Runtime-Parity · ADR-0012 |
| 工作台深化（V15 系列） | 文件浏览器/diff、PR 状态与合并后清理、agent 交接、自动同步、限额定时恢复 | PR #59（2026-10-03）；发布 v0.3.0 · V15-Workbench-Deepening |
| 工作台 UI | herdr 风格 workbench chrome（19 角色 Catppuccin 配色、sidebar spaces/agents/tasks、状态栏版本徽章） | PR #61（2026-10-06） |
| 发布线修补 | PTY 控制终端 fd 修复（#70）、viva update 经 S3 live handoff 自动重启 server（#71）、项目级独立 QA 提示（#69）；GitHub Wiki 成为 canonical 文档（#68） |
PR #67/#68/#69/#70/#71（2026-10-06）；发布 v0.3.2 / v0.3.3 |
| 安装与更新 | npm 分发 @zuohaisu/viva；viva update 原子升级 |
PR #39 · PR #52；CLI-Update-Validation · Releases |
Current（进行中 / 已知缺陷）
- 发布线：当前版本（npm latest 与最新 tag）以 Releases 为准，本页不再写具体版本号；版本号 0.3.1 跳过未发布。发版由 Haisu 人工管理，PR 不改版本号（#88）。Release notes 自 2026-10-06 起在 Wiki
Releases页维护，repo 不再保留docs/releases/。 - 已知缺陷：#63
v05_terminal在 CI 负载下 flake（PTY resize EBADF，需要 fd 所有权审计）；#66 验收工具曾在 CI 上跳过 peak 场景（已随 PR #103 修复）；#101 Pi 扩展在真实 Pi 里加载即失败（registerTool等接口与真实 SDK 不符，手写类型掩盖了故障）。#66 与 #101 的修复在 PR #103（open）。 - 已修复：#86 Pi 扩展曾调用已退役的子命令命名空间（PR #93，2026-10-13）。
- 工作台 UX 跟进（PR #61 QA 轮记录）：鼠标交互、scrollbars、toast 卡片、窗口标题模板；
move_pane_focus应改用真实绘制矩形。 - 未关闭的验收票：#18（V09 真 Pi 端到端；当前被 #101 阻塞）、#19（V10 跨 harness 交接矩阵）、#21（V12 平台/负载项）、#27（V14 独立替代演示）——issue 未关代表验收未完成，不代表没有代码。
2026-10-06 已批准的 M1 工作台收口
Haisu 2026-10-06 明确批准 Workbench-Navigation 的交互与实施方案：workspace 顶部切换/组合，左上 project/worktree、左下 agent sessions 状态，右侧 terminal tabs/panes；每 worktree 独立现场，点击 agent 回到已有 pane。这一具体收口方案已批准；本页整体（含 M2–M4）于 2026-10-14 一并接受。
- #74 Workspace 打开/组合与
.code-workspace兼容。 - #75 每 worktree tabs/分屏/现场恢复。
- #76 Agent-only 状态总览与跨现场导航。
- #77 原生 agent CLI 的样式/光标/输入/resize/滚动/鼠标。
#27 为既有集成入口，#21 为最终真实使用/资源/故障验收；#63/#66 继续修复 fd 与验收工具，#18/#19/#49 保留各自范围。现有 #44/#46 的基础交付和 PR #61 的 chrome 不构成这四项已经完成的证据。各 slice 可以固定接口并行准备，真实 CLI 单 pane 验证应尽早做，避免只交付外框。当前均为未实施/未验收。
Next（M1 退出门，按 First-Usable-Version §3）
- 修复 #63/#66，复验 detach、输入/resize、stop、live handoff 竞态；不通过放宽断言掩盖产品故障。
- 走查已建 V14/V15 全链：项目→任务→worktree→Agent/测试/shell→diff/PR→handoff→恢复；只补最影响日常操作的缺口。
- 建立 harness 能力矩阵（可启动/可交互/可报告状态/可交接/原生 resume/fork，注明 tested/unsupported/unknown）；修正入口提示与实际 provider 状态不一致处。
- 执行 First-Usable-Version §3 验收演示并记录真实机器、工具版本与证据。
- 建议连续 5 个工作日真实试用，记录被迫退回 Orca 的具体原因；这是新增的用户验收，不是现有 PASS。
- Intel Mac 与 16 真实 Agent 门槛（V12-Final-Acceptance §4）保持 pending，不拿 Apple Silicon 或替身数据代替。
Later（后续里程碑）
顺序是 M1 → M3 → M2 → M4（Haisu 2026-10-14：M3 在前）。
- M3 — 有边界的 Agent 编排与协作闭环：M3a 受控委派（复用 dispatch/grant/F01 workflow 跑小闭环）；M3b 可恢复协作（协调会话中断后从 Task/Execution 与证据继续）。目标场景是 User-Stories Story 7：任务进入开发后，协调成员跟进，Dev 完成后交 QA 验收，不通过打回 Dev 修，通过后开 PR 并处理 CI 与冲突；可同时开多个任务槽位。边界：子 grant 不得放大（ADR-0007）、预算与升级给人、重要交付仍 owner 授权，合并由 owner 负责。自动调度任务的 daemon 是 AI 开发自动化的必需能力，开机自启应可配置（Haisu 2026-10-14，Goal-Drift-Log）；二者未实现，随 M3 规划，具体排期由 Haisu 定。
- M2 — 单机成员连续性与可用记忆：resume packet（Task brief + 知识选择 + 原生会话引用）；Recall→使用→修正的后端受控比较；候选→策展→生命周期。退出门：同一成员三次真实执行（新 session / 换模型 / 换 harness）仍能接续；预冻结问题集上的召回/误答/隔离对比报告。
- M4 — 可携带资产、跨设备同步与 SSH 工作面：本地仍是主副本。云端登录和云端保存是可选的同步与备份（Haisu 2026-10-14，Goal-Drift-Log），没有云时本地能力照常工作；显式加密导出/导入保留。SSH 多机为 ADR 0012 已接受的后续目标。长尾（音效/主题/国际化/kitty 图片）按 #49 跟踪。
- 研究线：self-model 仍是先定边界、再积累候选、再用真实行为检验，然后才考虑受控演化。这是研究顺序，不是里程碑顺序。没有跨情境行为证据，不先造"成长引擎"。
- Resident 容器（2026-10-13 方向已认可，ADR-0013）：Resident-Container §10 的 C0 投影、C1 会话回收、C2 成员回调接口、C3 对话状态与反思归入 M2；C4 成员技能集与技能同步、协调成员晨报归入 M3。归 M3 的 C4 因此排在归 M2 的 C0–C3 之前；切片归属不变。不改变 M1 当前门槛。实现跟踪在 #113（子 issue #114–#121），均未实现。
User Stories 对照
User-Stories 是 Haisu 的原始场景。下表把每个故事对到里程碑；"未排期"表示还没有归入任何里程碑，由 Haisu 定。
| Story | 现状 | 里程碑 |
|---|---|---|
| 1 打开 Viva 先与协调成员接触 | 未实现 | M2（成员连续性）；协调成员晨报归 M3（Resident-Container C4） |
| 2 Workspace 管理 | 部分已交付 | M1（#74） |
| 3 聊天内容分叉与重命名 | viva conversations（fork / rename / handoff）已交付；Pi 内的分叉受 Pi 能力限制 |
M1 范围内的未关闭验收票 #19（V10） |
| 4 协调成员是连续的存在，有记忆 | F04 记忆接入待独立复验；后端未裁决 | M2 |
| 5 任务安排与模型选择 | 成员的模型 / 工具绑定与 dispatch 已交付 | M3（协调成员替 Haisu 选派） |
| 6 worktree 与 git 管理 | worktree / git / PR 状态已交付（V03 / V08 / V15） | M1 收口；代管归 M3 |
| 7 任务进入开发后的流程 | 未实现 | M3（见上；依赖自动调度 daemon） |
| 8 经验复用与 skill 管理 | 未实现 | M2 / M3（Resident-Container C3 / C4） |
| 9 项目大管家（定期打扫仓库） | F02 已有人工触发的复审提案（viva maintenance review-worktrees / review-repo，经 grant 执行） |
未排期；"定期"依赖自动调度 daemon |
| 10 沙箱的使用边界 | gh 登录态属于运行环境、不进容器（ADR-0013 Decision 8） |
未排期 |
Open Questions
见 Open-Questions（记忆后端、Hermes 集成 2a、self-model 容器、F01–F04 待独立复验项等）。
历史演化
项目方向的显式变更与漂移记录在 Goal-Drift-Log（append-only）；被取代的技术选型研究在 Technology-Selection-Archive。