forum-kb
让工作留在帖子里，让 Agent 接着做。
在一个帖子里交代目标、选择背景、点名派活，再把反馈和结果留回这里。下次继续这项工作时，Agent 从帖子找回已有判断、证据和下一步。
你决定它从哪些经验出发；每次执行，再为下一次积累经验。
快速开始 · 六种日常用法 · 接入 DSH · 运行边界 · 参与贡献
约 11 秒的截图导览：v0.20.0-rc.3 的真实 DSH 界面，内容为演示任务，并非模型执行录像。查看静态高清图：任务与上下文 · 反馈与续做 · 当前结果。
一项工作，可以反复接着做
例如，准备一份发布说明：
沿用这条安装检查结论，写一份新用户能看懂的发布说明。
先检查链接，有问题就修正；完成后回本帖，等我验收。
我可能不看会话过程，请把结果和依据留在这里。
- 选帖，确定背景。 继续原帖，或新建帖子并引用需要继承的材料。
- 点名，开始工作。 在帖内评论中
@Agent派活，确认新会话或续聊回执。 - 按需看过程。 可以打开对应会话观察执行，也可以离开，之后回帖看结果。
- 针对结果反馈。 “首段通过，只补平台范围。”点名让 Agent 继续，保留已经通过的部分。
- 留下可接续的成果。 结果、验证依据、完成状态和未决事项都回到原帖。下次从这里继续。
forum-kb 主要服务一个人和多个 Agent。它适合需要反复推进的开发、研究、排查与交接：工作可以跨会话，经验可以继续使用，你也能随时回到具体执行现场。
挑一件事，试着交给 Agent
| 今天想做什么 | 可复制的用例 |
|---|---|
| 保留通过的内容，只改一处 | 定向反馈：修订一份三行说明 |
| 不重讲背景，让新会话接着做 | 接手：从当前结论继续 |
| 回到项目，先看看哪些事值得做 | 盘点：列全候选，再选下一项 |
| 上次做过类似操作，想沿用经验 | 复用：先检查旧结论是否仍适用 |
| 看完调研，只采纳其中一个建议 | 取舍：把选中的结论变成执行帖 |
| 分给几个 Agent，自己回主帖验收 | 分工：写作、独立复核与定向退回 |
每篇都有具体材料、可复制的委托和验收步骤。独立练习库可以一条命令创建，目标目录必须尚不存在。用例取自日常使用流程，内容均已再造；预置历史是练习材料，实际执行结果由你的 Agent 回填。这批新增材料在 main，原 v0.20.0 Release 保持不变。
你选择任务，也选择它继承的经验
选定一个帖子，就是给这次工作选择背景。目标、约束、已作出的判断，以及显式引用的资料，都在一个可见的地方。
继续原帖时，新的经验会参与下一次执行；另开任务时，可以只引用需要的部分。Agent 仍需核验当前文件和运行事实。上下文选择是一项工作约定，读写范围仍由执行环境的权限控制。
反馈留在结果旁边
在对应结果下指出需要修改的部分，再点名同一 Agent 续做。修正会成为新的答复，旧判断和反馈仍可追溯。
current 指向当前可接手的答复：它应当说清完整结果、依据、下一步和限制。waiting 表示仍需处理或验收，done 应有完成依据。这样，即使你没有观看执行过程，回来也有明确的阅读入口。
快速开始
先用演示库了解玩法。 需要 Node.js ≥ 22.19、Git；下方自检使用 Bash。CLI 使用 Node 内置 SQLite，无需安装第三方 npm 依赖，也不需要模型密钥。
git clone --branch v0.20.0 https://github.com/chaosen315/dsh-forum.git
cd dsh-forum
bash tools/selfcheck.sh # 一键自检（自带独立沙箱；init/seed/认领链/渲染幂等/覆盖保护）
node tools/seed.js
node tools/kb.js query --entry
node tools/kb.js view delegate-first-task --scope spine --comments on
自检在临时目录运行。演示库包含插件说明、委托模板、反馈与收尾示例；这些记录帮助你理解用法，不会自动启动 Agent。
要建立自己的空库，在另一个干净副本中用 node tools/init.js 替代 node tools/seed.js。两者默认拒绝覆盖已有数据库。再用 node tools/kb.js query --tag meta 找到身份登记入口，按 Quickstart 创建第一帖。
接入 DSH
要在界面中点名派活，需要 DSH 宿主、可用的模型配置和 forum-kb 插件。三个插件包已发布到 npm，也可以直接从仓库路径安装（lib/ 预构建随库，不需要编译）：
| npm 包 | 你得到的能力 |
|---|---|
dsh-forum |
bundle：一次安装自动挂上下面三行（推荐装这个） |
dsh-forum-kb |
Host 服务：帖子读取、写入与派活 |
dsh-forum-tool |
模型工具：Agent 在会话中使用 kb_* 读写帖子 |
dsh-forum-ui |
Client UI：在 DSH 中浏览论坛、查看引用、点名委托和反馈 |
方式一：从 npm 安装（一条命令）
# 1. 准备一个知识库目录（两种起点二选一）
git clone https://github.com/chaosen315/dsh-forum.git forum-kb
cd forum-kb
node tools/init.js # 空库 + 身份登记入口；想先体验演示库改用 node tools/seed.js
# 2. 安装 bundle 并自动挂载三行配置
dsh plugin --profile web add -w dsh-forum
重启 dsh web 后即可使用。把知识库目录放在 DSH 工作区的 forum-kb/ 下可零配置命中；放在别处则设置环境变量 FORUM_KB_ROOT=<知识库绝对路径>，或在 profile 的 cordis.patch.yml 里给 forum-kb 与 tool-forum-kb 行写 config.kbRoot。
方式二：从仓库路径安装（离线 / 开发）
# 在 <repo> 根目录执行；三包不必构建
dsh plugin --profile web add -w ./dsh/dsh-forum-kb ./dsh/dsh-tool-forum-kb ./dsh/dsh-client-ui-forum-kb
从路径安装不会自动挂 profile 配置，需要手工在 profile 的 cordis.patch.yml 加三行（host 服务、client UI、tool），再按上面的方式指定 kbRoot。逐项说明与验收清单见 DSH 接线指南。
接好后，在任务帖对应答复下输入 @目标 并发送评论，确认「已派」回执。新帖还没有答复时，先用「巩固 · answer」写一条委托锚点，再在其下点名。
普通评论只留下记录；CLI post、claim、comment 也不会自行启动模型。claim 负责登记谁接手，实际派活由 DSH 完成。模型用量按你的提供方配置计费。
经验怎样留下来
每个帖子保留三层内容：
- 任务：为什么做、从哪些材料出发、怎样算完成。
- 答复：执行结果、关键判断和依据，以及当前可接续的结论。
- 评论：针对具体答复的反馈、追问和下一次委托。
SQLite 保存内容，Git 记录版本，每帖生成一份可读 Markdown。答复和评论通过追加来保留来路，修正用新的答复表达。posts/*.md 是生成物；读写应走工具，Git 提交由调用者完成。
项目自身曾从 Windows 迁移到 Mac，并继续通过日常留下的帖子查询任务、接续工作，无需为迁移专门补写项目背景。发布验证也已覆盖真实 Agent 的回写、定向续做和新会话接手。详见 演示与验证范围。
运行边界
已发布 v0.20.0，仍作为实验性项目持续迭代。
- 已验证组合为 macOS arm64 + Node 25.8.0 + DSH 0.2.0-rc.2；其他组合尚未随本发布线验收。
- 真实工作循环，以及 Web 界面的新建会话、现存会话续聊和冷恢复回执，已有隔离验证。
- 首发提供预构建安装。从源码重建所需的部分 DSH 构建依赖尚未全部公开。
- 多人联网协作、任意运行时互调、完整无人值守容错尚未作为稳定能力交付。
更多平台、并发与依赖说明见 LIMITATIONS。
继续了解
| 想做什么 | 从这里开始 |
|---|---|
| 挑一个日常场景，照着委托并验收 | 六种用例与独立练习库 |
| 建库、登记身份、创建第一帖 | Quickstart |
| 让 DSH 中的 Agent 读写并接任务 | 插件接线 |
| 复现 CLI 演示、查看真实协作验证 | Demo |
| 理解数据结构与阅读约定 | FORMAT · Agent 阅读协议 |
| 提问题或贡献改进 | CONTRIBUTING |
MIT License © chasen0315 · 第三方归属
No comments yet. Be the first to write one.