前言¶
在使用 DeepSeek Harness (DSH) 或類似 AI 開發工具時，上下文窗口的限制和會話的中斷常導致 AI 忘記之前的約束或決策，重複討論已知方案，或在開發中途推翻已定下的技術選型。dsh-decision-log 插件旨在解決這一問題，爲 AI 工作流提供一個持久、可追溯的決策記錄機制。
插件介紹¶
該插件由開發者 yuyolin 維護，遵循 MIT 許可證。它並非任務清單或聊天記錄，而是項目的“決策記憶”。通過將關鍵決策記錄到本地 Markdown 文件中，確保在任何新對話中都能追溯“爲什麼這麼做”。
安裝與啓用¶
安裝插件需要指定 web profile。
dsh plugin --profile web add github:yuyolin/dsh-decision-log
安裝完成後，必須重啓 Web UI 才能使插件生效。啓動命令需包含 --patch 參數。
npx @deepseek-ai/dsh web --patch
核心功能與用法¶
1. 記錄決策¶
插件支持兩種調用方式：
- 自然語言召喚：直接描述決策。
> 記一下：登錄用 JWT 不用 session cookie - 命令行調用：使用
/log-decision命令，並支持參數。
> /log-decision 用 Redis 不用 Memcached –context 緩存層選型 –reason 持久化更強
支持的狀態包括 accepted（已接受）、pending（待確認）和 superseded（已被推翻）。
2. 自動注入摘要¶
每次新對話開始時，插件會自動將已記錄的決策摘要注入給 AI。這能防止 AI 在新會話中重複討論已定方案，或隨意推翻之前的決定。
3. 數據管理¶
- 存儲位置：決策記錄保存在項目根目錄的
.dsh/DECISIONS.md文件中。 - 格式：純 Markdown 格式，任何支持 Markdown 的 AI 工具（如 Claude、Cursor）均可讀取。
- 狀態管理：AI 自動記錄的決策默認爲
pending（待確認）狀態，需要用戶手動確認或拒絕；通過命令行記錄的決策默認爲accepted狀態。
注意事項¶
- 隱身運行：插件默認處於隱身模式，只有在通過指令或命令調用時纔會執行記錄操作。
- 本地存儲：數據僅存儲在本地，不上雲，不經過任何服務器，僅對當前工作區具有讀寫權限。
- 手動確認：由於安全設計，AI 自動生成的決策記錄默認爲“待確認”狀態，用戶需要介入確認後，該決策纔會真正生效。
總結¶
該插件通過本地化的決策日誌和自動注入機制，幫助開發者在 AI 開發流中建立可追溯的決策歷史，適合需要長期維護項目或頻繁切換 AI 工具的場景。
