hdjshsshsjjssj/deepseek-harness-cairn

DeepSeek Harness · Cairn 探索模式

一个 DeepSeek Harness 的 agent preset（探索模式），在 DeepSeek Harness 中模拟 Cairn 项目的 Fact-Intent-Hint 黑板架构与 OODA 探索循环。

模式逻辑（提取自 Cairn）

Cairn 是通用问题求解引擎：不定义角色、不定义工作流。给定 Origin（起点）与 Goal（目标），它在未知状态空间中搜索一条从 Origin 到 Goal 的路径。其核心是黑板架构上显式的 fact-intent 图，只需三个原语：

| 概念 | 含义 |
| --- | --- |
| Fact | 已确认、客观的发现，写回黑板 |
| Intent | 声明但尚未执行的探索方向，必须源自一个或多个已有 Fact |
| Hint | 人类随时注入的判断，下次读黑板时吸收 |

Worker 运行 OODA 环 —— Observe（读全图）→ Orient（理解态势）→ Decide（决定下一步意图）→ Act（执行探索）—— 并把发现写回新的 Fact。Worker 没有固定角色，任务由图的当前状态实时生成；Agent 仅通过共享黑板协调（Stigmergy），无直接通信、无信息孤岛。

三类任务（由同一 Worker 执行）：

| 任务 | 做什么 | 输出 |
| --- | --- | --- |
| Bootstrap | 项目初始时直接尝试整体求解 | Fact + 可能的 Complete |
| Reason | 读全图：Goal 是否已满足？接下来应探索什么？ | Complete / 新 Intent / no-op |
| Explore | 认领一个 Intent，执行探索，汇报结论 | 一条 Fact |

本 preset 把这套逻辑放进 DSH 的 agent persona 中：Agent 在会话工作区维护共享黑板文件 CAIRN_BOARD.md，记录 origin / goal / facts / intents / hints / complete，每一轮用户交互都是一次 OODA 迭代。

安装

1. 把整个 cairn-explore/ 目录复制到 DSH 的用户 preset 根目录：

- Windows：C:\Users\\.dsh\.agent-presets\（即 $env:USERPROFILE\.dsh\.agent-presets\；目录不存在则先创建）
- macOS / Linux：~/.dsh/.agent-presets/（若设置了 $DSH_HOME，则使用 $DSH_HOME/.agent-presets/）

2. 刷新 DeepSeek Harness Web 页面，新建会话时在模式选择器中即可看到 「Cairn 探索模式」（若未出现，重启 profile：dsh web）。

使用

1. 新建会话并选择 Cairn 探索模式。
2. 给出 Origin（起点）与 Goal（目标）；可附带若干 Hint（人类判断）。
3. 每一轮交互：
- Agent 先读取黑板、吸收新 Hint（Observe）；
- 判断当前状态与差距（Orient）；
- 决定继续某条 open intent / 提出新 intent / 宣告完成（Decide）；
- 执行探索并把客观发现写回为新 Fact（Act）。
4. 当 Facts 足以证明 Goal 达成时，Agent 写入 complete 并停止探索。

Agent 会在工作区自动创建黑板文件，例如：

CAIRN_BOARD
origin: ...
goal: ...

facts
- f001 | 已确认的客观发现 | from:  | by: ...

intents
- i001 | from: [f001] | 探索方向描述 | status: open

hints
- h001 | 人类判断内容

文件说明

- cairn-explore/agent.cordis.yml — preset 组成：完整的标准编码 Agent 工具集 + Cairn 探索 persona。
- cairn-explore/preset.yml — preset 元数据（名称与描述）。

说明

模式逻辑提取自开源项目 Cairn（GNU AGPL-3.0）：仅复刻其 Fact / Intent / Hint 探索模式与 prompt 契约，不包含其服务器 / 调度器实现。