wayfinder-dashboard

Readme

# Wayfinder Dashboard

**DeepSeek Harness 插件**

[English](README.en.md)

把 Matt Pocock 的 [Wayfinder](https://github.com/mattpocock/skills/blob/main/docs/engineering/wayfinder.md) 做成一张可交互的**决定图**：节点是问题，边是依赖，人来做决定，Agent 负责推导下一层。

## 安装

需要已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）`0.1.0-rc.7` 或兼容版本。

装进你平时用的 Web 配置即可，**不用改配置文件，也不用另开 profile**：

```sh
dsh plugin --profile web add github:Gyanano/wayfinder-dashboard
```

然后和平时一样启动：

```sh
dsh
```

侧栏最下方会出现 **Wayfinder 地图**。打开一个工作区，在右侧输入框输入：

```
/wf-chart 我们想做插件，但路还看不清
```

Agent 会在当前会话里画出第一层问题。点开节点，用 `/wf-decide` 记下决定；用 `/wf-research` 派研究；用 `/wf-advance` 推进一步。顶栏可以把当前地图导出成 PNG。

## 它是什么

Wayfinder 规划的是「一次会话装不下」的工作。图上的节点是**决策票**——答案必须是一个决定，而不是「去实现 X」。

- 地图属于**一个工作区**。一个仓库可以同时有好几张图，一张图对准一个目的地；在这个仓库画的图不会跑到另一个仓库里。
- 打开插件先看到**这个工作区的列表**，点进去才是图。没有图时是一段说明，不是演示数据。
- 图自上而下读：**起点**（最初那句模糊想法）→ 已经问清的一层 → **迷雾**（下一层还没推导出来）→ **目的地**。
- **一次只长一层**。下一层长什么样，取决于这一层怎么落地。
- 每个问题**随时能看见、能点开**；依赖只挡住执行，不挡住阅读。
- 研究只带回**证据**，不替你做决定。

语义见 [PRODUCT.md](PRODUCT.md)，视觉见 [DESIGN.md](DESIGN.md)。

## 常用命令

| 命令 | 作用 |
| --- | --- |
| `/wf-chart <想法>` | 开一张新图，并让 Agent 推导第一层 |
| `/wf-decide <决定>` | 记下当前选中问题的决定，并推进下一层 |
| `/wf-research [说明]` | 把当前问题派给 Agent 做研究 |
| `/wf-advance` | 让 Agent 只推当前前沿一步 |
| `/wf-ask <问题>` | 手动加一个问题 |
| `/wf-focus` | 在当前图上选中一个问题 |
| `/wf-scope [in\|out]` | 把问题划进或划出范围 |
| `/wf-reopen` | 重新打开一个已经记下的决定 |

## 配置

一般不用动。需要时写在 profile 的 `cordis.patch.yml` 里覆盖这一行。

| 项 | 默认 | 含义 |
| --- | --- | --- |
| `dataDir` | `$DSH_HOME/wayfinder` | 地图文件目录，刻意放在仓库外面 |
| `mountBundledSkill` | `true` | 挂上自带的 Wayfinder skill |

## Agent 能做什么、不能做什么

Agent 可以列图、读图、更新目的地和迷雾、增改问题、认领并汇报研究。

**没有「替人做决定」的工具。** HITL 问题只能你在输入框里用 `/wf-decide` 收束。

## 开发

```sh
npm test
```

浏览器对照需要本机已启动 Harness，再跑 `node test/browser/verify.mjs`。

## 许可

MIT。自带的上游 Wayfinder skill 为 MIT © 2026 Matt Pocock，见 [NOTICE.md](NOTICE.md)。