引线 / Ariadne

把复杂讨论里的方向、取舍与执行，接成一条可回看、可推进、可恢复的线。

A visual decision workbench for DeepSeek Harness.

安装 · 核心闭环 · 功能 · 架构 · 验证 · v0.3.0

[!NOTE] “引线”来自阿里阿德涅交给忒修斯的线。 Ariadne 让探索保有广度，也让最终选择拥有一条明确的执行路径。

一眼看懂

Ariadne 工作在 DSH 会话里。Agent 负责维护结构，用户始终掌握聚焦、暂缓、定案和执行节奏。

一条完整的线

flowchart LR
  A["保留可能性<br/>Explore"] --> B["聚焦分支<br/>Focus"]
  B --> C["用户定案<br/>Decide"]
  C --> D["执行图<br/>Plan"]
  D --> E["逐节点推进<br/>Run"]
  E --> F["结果与证据<br/>Evidence"]
  F -. 新信息回流 .-> A

这条闭环是 Ariadne 的产品边界：

1. 对话中持续保留真实出现的方向。
2. 用户主动选择当前焦点，Agent 维护工作摘要。
3. 候选方向进入定案池，由用户确认执行范围。
4. Agent 生成显式的 Task / Decision / Checkpoint 图。
5. 用户按节点触发执行，结果和证据写回同一个 Run。

60 秒安装

安装固定版本：

dsh plugin --profile web add github:Zayzz-pixel/dsh-ariadne#v0.3.0
dsh web

安装完成后，新会话顶部会出现：

对话  ·  轨迹  ·  引线

进入 引线，打开工具栏开关，当前 Session 的 Agent 才会获得 Ariadne 的四个工具。

本地开发链接：

dsh plugin --profile web add "link:$(pwd)"
dsh web

卸载：

dsh plugin --profile web remove dsh-ariadne

工作台由什么组成

探索与定案

1. 空地图提供 展开一个想法 与 整理已有内容 两个入口。
2. 新想法先确定目标与拆解口径，再生成 4–7 个暂定一级方向。
3. 已有长对话只提取真实出现的层级、未解决问题和暂缓方向。
4. 点选地图节点后，Focus Dock 保存“当前理解 / 待解决 / 下一步”。
5. 小范围自动探索 最多补充 5 个直接子节点，只展开下一层。
6. 在执行视图调整定案池，再让 Agent 生成执行图。

我的笔记

userNote 与 Agent 共享的 note 分开保存：

• 输入过程不反复追加 Session Event。
• 点击保存或按 ⌘/Ctrl + Enter 时提交一次。
• 只有点击 带入本轮，个人笔记才进入 Agent 当前上下文。
• Agent 更新共享摘要时保留个人笔记原文。

三种执行节点

Final Plan v2 只保存一份 graph。列表视图和图视图都从这份权威结构派生。

执行图采用单节点、无环控制流，建议 5–20 个节点，硬上限 30 个。每个定案方向都要被工作包引用，或在 uncovered 中记录缺口与原因。

Execution Run

stateDiagram-v2
  [*] --> ready: 确认并开始
  ready --> running: 运行当前节点
  running --> ready: Task 完成
  running --> waiting: 到达 Checkpoint
  running --> blocked: failed / blocked
  blocked --> ready: 重试当前节点
  waiting --> ready: 用户批准
  ready --> completed: 到达终点
  completed --> [*]

Run 会保存当前节点、状态、执行次数、摘要、证据和产物引用。刷新页面后，同一 Run 会从持久会话事件中恢复。

Agent 工具

关闭当前 Session 的引线后，这四个工具会从该 Session 的模型工具目录移除。活动 Run 中的 Agent 只处理当前节点。

架构与数据

flowchart TB
  User[用户操作] --> Client[Ariadne Client Workbench]
  Agent[Agent tools] --> Host[Ariadne Host]
  Client -->|Direct Ops| Host
  Host --> Engine[Map / Plan / Run state engine]
  Engine --> Events["brainstorm/map Session Events"]
  Events --> Projection[Session Projection]
  Projection --> Client
  Host --> Projects["brainstorm_projects Storage Domain"]
  Projects --> Overview[Project Overview]
  Client --> Exports[Markdown / JSON / Canvas]

改名兼容

0.3.0 起，产品名和安装包名统一为 引线 / Ariadne 与 dsh-ariadne。现有数据协议继续使用以下稳定标识：

• brainstorm/map、brainstorm/project
• brainstorm_* Agent 工具
• brainstorm-map 设置命名空间
• brainstorm-map.md、brainstorm-map.canvas、brainstorm-execution.* 默认导出名

旧会话地图、项目、Final Plan 与 Execution Run 可以直接恢复。旧 Final Plan v1 会在读取时转换为线性 Task 图，历史事件保持原值。

导出

地图导出包含个人笔记；执行图只包含共享记录。执行 Markdown 附带 Mermaid 流程图，JSON 保存 Graph、来源上下文、Frame、未覆盖事项以及 Run 结果。

验证记录

v0.3.0 发布前完成了以下检查：

发布资产：dsh-ariadne-0.3.0.tgz
SHA-256：47f39acdde4f140787e76046806ab114e98752a3207d49c72e48c341316a38a9

当前边界

• 兼容 DeepSeek Harness 0.1.1-rc.2 与 Web profile。
• Node.js 18 及以上。
• 执行由用户逐节点触发。
• 执行图支持 Task、Decision、Checkpoint、成功边、失败边与路线边。
• 图内并行、循环、子图和多 Agent 路由留给后续版本。
• DSH 升级后需要重新检查工具、队列、持久化和客户端加载接口。

常见问题

开发

npm run check
DSH_SESSION_JSONL=/absolute/path/session.jsonl.zstd npm run validate:map
node scripts/benchmark.mjs

• npm run check：语法检查与完整 Node 测试。
• validate:map：读取最新持久地图并验证状态不变量。
• benchmark.mjs：覆盖 20/30 节点执行图、31/100/200 节点地图与 50 Session 场景。

版本变化见 CHANGELOG.md。发布记录见 Releases。

dsh plugin --profile web add github:Zayzz-pixel/dsh-ariadne#v0.3.0

License

MIT © zhouzhizhe