前言¶
在 DeepSeek Harness 的开发流程中，智能体的探索往往伴随信息的发散，而执行阶段则常因缺乏结构化路径而中断。Ariadne 旨在弥合这一断层，将抽象的对话转化为可视化的决策与执行地图。
插件定位¶
引线 / Ariadne 是一个为 DeepSeek Harness 设计的可视化决策工作台。它由 Zayzz-pixel 维护，采用 MIT 开源许可证。插件的核心价值在于帮助用户探索想法、聚焦分支，并将最终的选择转化为可执行的流程图。
安装与启用¶
在 Web profile 下安装固定版本：
dsh plugin --profile web add github:Zayzz-pixel/dsh-ariadne#v0.3.0
dsh web
安装完成后，新会话顶部会出现“对话 · 轨迹 · 引线”标签页。进入“引线”并打开工具栏开关，当前 Session 的 Agent 才会获得 Ariadne 的工具权限。
核心功能¶
插件主要解决结构维护、决策定案与执行推进三个环节的问题。
地图与项目管理¶
- 增量维护地图：对对话中的方向进行持续的结构化记录。
- 外化结构：将 Topic、一级方向与纵深关系转化为可操作的结构。
- 项目总图：从持久 Session Map 刷新项目总图，聚合同一工作区的会话。
决策与执行图¶
- 定案池：将“值得做”从“已经聊过”中分离，提供搜索与筛选功能。
- 执行图生成：根据定案池生成 Final Plan v2 执行图，用显式依赖表达执行顺序。
- 节点类型：支持 Task（任务）、Decision（判断）、Checkpoint（检查点）三种节点类型，以及成功边、失败边与路线边。
工作流控制¶
- 固定目标：固定本轮目标与组织口径。
- 结构导航：围绕当前节点保留结构导航，支持拖拽、缩放、折叠、聚焦、编辑与导出。
- 逐节点执行：执行由用户逐节点触发，Agent 只处理当前节点，结果和证据写回同一个 Run。
执行状态与恢复¶
执行图支持无环控制流，建议 5-20 个节点，上限为 30 个。
节点推进逻辑¶
- Task：独立验收的工作包，成功沿
success边进入下一节点。 - Decision：返回允许列表中的精确
routeKey，决定后续路线。 - Checkpoint：需用户审阅或批准，批准后推进。
状态与恢复¶
- 状态流转：支持 Ready、Running、Waiting（用户批准）、Blocked（失败/阻塞）等状态。
- 历史恢复：旧会话地图、项目、Final Plan 与 Execution Run 可以直接恢复。
- 版本兼容：旧 Final Plan v1 在读取时会自动转换为线性 Task 图。
导出与数据¶
插件提供标准的导出格式，便于外部工具使用。
- 导出地图：
brainstorm-map.md（Markdown）与brainstorm-map.canvas（JSON Canvas 1.0）。 - 导出执行图：
brainstorm-execution.json与brainstorm-execution.md（附带 Mermaid 流程图）。
地图导出包含个人笔记；执行图仅包含共享记录。
注意事项¶
- 环境要求：兼容 DeepSeek Harness
0.1.1-rc.2与 Web profile，需 Node.js 18 及以上。 - 权限与维护：DH 升级后，需要重新检查工具、队列、持久化和客户端加载接口。
- 资源清理：关闭当前 Session 的引线后，相关工具会从该 Session 的模型工具目录移除。
- 运行锁定：活动 Run 处于特定状态时，引线开关保持锁定。
