前言¶

在使用 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 通過追加式決策日誌和自動派生設計文檔，解決了智能體開發中文檔維護滯後的問題。它讓設計文檔始終保持與當前決策同步，減少幻覺風險。

查看目錄頁
查看源碼