前言¶

在使用 DeepSeek Harness (DSH) 开发项目时，想法会快速演变，手动的文档往往会滞后。volens 通过维护一个追加式决策日志，并自动派生和刷新设计文档来解决这一问题。

是什么¶

volens 是一个工作流插件，由 funcpn 维护。它的核心价值是保持项目的设计文档与决策同步，避免文档因后续决策而失效。

核心功能¶

1. 追加式决策日志：维护一个只追加不修改的日志文件 (docs/DECISION-LOG.md)，记录每次设计决策。
2. 派生设计文档：根据决策日志自动生成或更新设计文档 (docs/DESIGN.md)，保持文档与决策一致。
3. 自动同步机制：在 DSH 的每一回合开始时自动运行，将新决策同步到设计文档中。
4. 指令合约模块：在项目的指令文件中添加合约模块，定义文档模型和协作规范。
5. 语言偏好配置：创建项目级语言偏好文件 (docs/.volens/lang)，用于指定文档语言。
6. 同步游标管理：创建同步游标文件 (docs/.volens-cursor)，记录设计文档已同步到的日志行数。

安装与启用¶

在 DSH 中安装此插件需要执行以下步骤：

# 1. 添加插件市场
/plugin marketplace add

# 2. 安装插件
/plugin install volens

典型用法¶

1. 初始化：在项目根目录运行一次命令：

    /volens

2. 记录决策：每次做出设计决策时，在 docs/DECISION-LOG.md 中追加条目。条目结构通常包含背景、决策和后果。
3. 自动同步：无需手动操作，同步机制会在 DSH 的每一回合开始时自动运行，将新决策注入上下文并更新 docs/DESIGN.md。

适用场景与注意¶

• 运行环境：DSH 在插件所在的进程内运行，无需 bash 环境。
• 数据安全：插件不会发起网络请求，不包含遥测或分析功能，数据不会离开本地机器。
• 文件权限：插件只会在 docs/ 目录内读写文件，不会执行项目内的任何代码。
• 阻塞行为：在 DSH 中，该插件返回空决策，不会阻塞当前回合。
• 子代理隔离：DSH 不会将同步机制注入到子代理会话中。

总结¶

volens 通过追加式决策日志和自动派生设计文档，解决了智能体开发中文档维护滞后的问题。它让设计文档始终保持与当前决策同步，减少幻觉风险。

查看目录页
查看源码