前言¶
在使用 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 工具的场景。
