Roadmap

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 从任何受支持的工作入口找到同一批长期成员；成员能换模型、换工具、换会话继续任务，在授权范围内组织其他成员，并把有来源的工作经验用于后续工作。

衡量路线的四个问题：

1. 能工作吗？ 不依赖 Orca，从普通终端完成真实并行任务。
2. 能接着工作吗？ 会话结束或模型更换后，目标、决定、未完成项和必要知识不蒸发。
3. 能组织工作吗？ 一个协调成员受控分派、跟进、交接、核验证据，而非仅向几个窗口输入文字。
4. 积累能保全吗？ 成员资产可导出、恢复，最终可跨设备使用，不绑定供应商或某一进程。

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 工作台深化已合入并随 v0.3.0 发布，后续 UI / herdr 交互修复也已有交付。当前不做新平台，收口可用性与真实使用验收。Haisu 2026-10-14：先完成 M1，然后 M3，再 M2，然后 M4（Goal-Drift-Log）。M2 的范围和退出门等 Resident 容器讨论收口后再按 ADR-0013 改写，本次不改。

Current Milestone（状态修正 2026-10-18）：仍为 M1 可用性收口，不因版本已发布而宣布退出。旧 First-Usable-Version / #27 人工验收已按失败结束；成功打开 .code-workspace 的证据保留，后续 herdr 交互替换与工作台人工验收转入 #156。0.3.8、0.3.9 均已发布但未通过 Haisu 人工验收（#156 最新结论）。#21 的 Intel / 16 真实 Agent / 故障负载项继续保留，旧三路 Codex 部分记录不能替代它们。

Research / implementation boundary：Rust 原生记忆存储已通过 #109、PR #132 / #135 交付；不再把 Hermes / OpenViking 选择写成当前实现前置。后端比较与是否自动启用仍是研究问题，见 Open-Questions。Resident 容器是同一产品的成员连续性能力，部分实现已交付，见 Resident-Container 的状态表；self-model 自动演化与完整调度 daemon 仍未交付。

Completed

里程碑	交付	证据
Rust 首版实现（V01–V13）	成员/任务/执行/授权/恢复/知识/GitHub 只读、SQLite 状态层、Pi 扩展、安装发行；Python 运行时退役	Rust 基础已交付；#18 / #19 / #21 的真实验收仍开放；Rust-Rollout-Plan · V13-Python-Retirement
后续能力（F01–F04）	交付工作流、知识复审维护、计算机操作、历史 Holographic 接入（现行记忆已改为 Rust 原生）	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（2026-10-18 状态核对）

• 发布与验收分开：最新 tag / npm latest 是 0.3.9（Releases）；该版本人工验收未通过。main 后续合入的改动不自动包含在发布包内。
• 启动缺陷：#133、#134 仍开放，报告基线为 0.3.7 / 252a543；先在当前 main 复现，适合同一个 agent 处理共享的启动 / socket 路径。这里没有宣称已派发或已复现当前版本。
• 已修复，不重复派发：#63 / #77（PR #126）、#66 / #101（PR #103）、#86（PR #93）已交付关闭；#74–#76 同样已关闭。旧文把 #103 标作 open、把四个工作台切片标作未实施的说法作废。
• 已合并，仍有验收收口：#174 / #175（绘制）、#176 / #177（弹层 / 滚动条）、#178 / #179（键鼠 / 选词）、#180 / #181（手动 npm 工作流）、#182 / #185（PR 状态与整份 PR 文件）均已合入 main。各合并提交 CI success 只证明 CI；最终 head 的 QA、真实 PTY / 工作台、真实手动发布等未验项以各 issue 为准，不重复实现。#185 于 2026-10-18 合并；核对时没有开放 PR，这不证明没有本地工作。
• 真实环境安装：#172 的 README 已随 PR #173 合并，独立 QA 对 95f36c0 无阻塞；Tailscale + 真实二进制安装仍待已授权环境验收。
• 历史 V15：#53–#58 已按原单全部勾选的验收记录、Haisu 合并 PR #59 与合并后 CI 归档关闭；没有为归档增加当前版本重验要求。旧单键不是当前键位。#55 的 merged 清理入口已存在；#185 没有留下“再实现清理那一半”的任务。见 V15-Workbench-Deepening。
• 仍开放的验收 / 决策：#18 真实 Pi、#19 分叉 / 跨 harness 交接、#21 平台与负载、#156 当前人工验收；#112 仍需 owner 决定配置文件形态。未验与待决定不能作为整套功能未实现的依据。

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/滚动/鼠标。

四项已由 PR #106 / #111 / #125 / #126 交付并关闭；不再执行原来的并行开工计划。#63 / #66 的修复也已完成。#18 / #19 / #21 保留各自真实验收，#27 的旧人工验收失败与后续 #156 收口见上文；切片交付不代表整体人工验收通过。

Next（M1 可用性与证据收口）

1. #133 / #134 在当前 main 复现、修复并做同场景对照；单活宿主和 socket 权限边界保持。
2. 按 #156 核验当前工作台 / 双 TUI / workspace 行为，把实际失败项交给实现，避免重开已交付切片；#182 单独补真实 gh 的 PR 面板走查。
3. #172 的 Tailscale 安装、#18 / #19 的真实 harness、#21 的平台 / 负载项分别留证据；缺工具或授权时保持 pending。
4. 近期已合并 issue 按各自未验项补齐验收 / QA 记录后再决定关闭，不因 Refs 或绿色 CI 自动关闭；历史 V15 已按既有完成证据收口。
5. 连续试用、Intel Mac、16 真实 Agent 等原有证据缺口保留；本次状态清理不重新定义退出门、不启动发布或新产品线。

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 多机已有 PR #159 的实现，真实远端走查仍待证据；不能把它重新派成从零实现。长尾（音效/主题/国际化/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（完整子单见该 epic）。#115 / #116 / #121 / #139 / #140 / #141 已交付关闭，#118 已合并待 QA / 集成收口；#114 / #117 / #119 / #120 / #142 与 #143 的退出证据仍待完成。

User Stories 对照

User-Stories 是 Haisu 的原始场景。下表把每个故事对到里程碑；"未排期"表示还没有归入任何里程碑，由 Haisu 定。

Story	现状	里程碑
1 打开 Viva 先与协调成员接触	未实现	M2（成员连续性）；协调成员晨报归 M3（Resident-Container C4）
2 Workspace 管理	#74 已交付；当前工作台人工验收未通过	M1（#74）
3 聊天内容分叉与重命名	viva conversations（fork / rename / handoff）已交付；Pi 内的分叉受 Pi 能力限制	M1 范围内的未关闭验收票 #19（V10）
4 协调成员是连续的存在，有记忆	原生记忆、回收与策展已有交付；跨 harness 连续性仍待 #143 证据	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 可选互通、self-model、F01–F04 待独立复验项等）。

历史演化

项目方向的显式变更与漂移记录在 Goal-Drift-Log（append-only）；被取代的技术选型研究在 Technology-Selection-Archive。

状态维护（2026-10-18，#186）：依据实时 issue / PR / 合并与既有验收记录修正过期状态；本轮未运行产品测试或真实验收，历史证据不升级为当前 PASS。