# dsh-herdr 路线图

路线图描述产品方向，不承诺具体发布时间。优先级会根据真实用户任务、Herdr CLI 稳定性和安全风险调整。

## 当前：0.3.x 可观察性与体验

目标：让现有 24 个工具可预测、可诊断、可安全升级。

- [x] Workspace list/get/create。
- [x] Tab list/get/create。
- [x] Pane list/get/read/split/run/wait-output/send-text、layout、process-info、edges。
- [x] Agent list/get/read/start/wait/prompt、explain。
- [x] 创建默认不抢焦点。
- [x] GitHub 直接安装和编译产物发布。
- [x] 产品、架构、工具、扩展、测试和运维文档。
- [x] 自动化注册和 argv 映射测试进入仓库。
- [ ] 标准 CHANGELOG 和发布 tag。
- [x] CI 基础测试、完整 DSH checkout 构建与 package 内容检查。
- [ ] 与 Herdr 当前稳定版/预览版的兼容矩阵。

## 下一批：0.3.x 剩余可观察性与体验

### P1：更好的诊断

- [x] 独立 health/doctor 工具：检查 PATH、版本、socket、session 和基本 list。
- [x] 结构化解析 Herdr stderr JSON，而不只保留字符串。
- 返回兼容性信息，例如检测到的 Herdr version。
- 对 timeout、target-not-found、server-not-running 提供标准 error code。

### P1：更安全的工作流

- [x] `pane_process_info`：在 `pane_run`/`agent_start` 前确认目标 pane 是否空闲。
- [x] `pane_layout`：让 DSH 更可靠地理解布局。
- [x] `pane_edges`：读取 pane 边/邻接关系。
- [x] 操作 preview：R2 工具支持 `preview`，并可用 `DSH_HERDR_PREVIEW_REQUIRED` 强制先预览。
- [x] 对 R2 工具增加可配置确认策略（preview + 强制预览）。

### P2：高阶只读能力

- [x] agent explain/detection 诊断。
- [x] 创建/拆分支持 `--env` 透传。
- workspace/tab/pane 元数据读取。
- 有界批量巡检，限制最大对象数和输出量。

## 候选：0.3.x 多 session 与远程

前提：Herdr 提供稳定、明确的 named session/remote CLI 契约。

- 显式 session 参数，不继承未知焦点。
- session list/get，只读优先。
- 远程目标配置与凭据边界设计。
- 每个工具结果标明实际 session/host。

需要 ADR：默认 session 选择、凭据、远程命令和审计。

## 候选：1.0 hybrid UI

只有在真实需求证明文字工具不足时实施。

可能能力：

- DSH Web 中展示 Herdr workspace/tab/pane/agent 拓扑。
- Agent 状态、最近活动和 blocked 提示。
- 从 UI 选择明确目标后生成工具调用。
- 操作历史和用户确认。

架构要求：

- Host service 与 client UI 分离。
- 不直接把 socket 暴露给浏览器。
- UI 只展示 server 权威状态。
- 保持 toolkit API 可独立使用。

## 暂不计划

- 自动停止或重启 Herdr server。
- 绕过 Herdr/agent 权限确认。
- 默认开放 close/move/swap/send-keys。
- 解析 TUI 画面代替稳定 CLI/API。
- 在插件中实现另一套终端复用或 agent 检测引擎。
- 把 DSH 当作 Herdr 状态数据库。

## 功能进入路线图的标准

一个提案应具备：

1. 至少一个清晰用户旅程。
2. 可验证的 Herdr CLI/API 依据。
3. 风险等级和安全默认值。
4. 失败恢复设计。
5. 测试策略。
6. 文档影响。
7. 对工具目录 token 成本的考虑。