决策收件箱 ThirtySeven-3737/dsh-plugin-decision-inbox

dsh-decision-inbox

让 DeepSeek Harness 智能体在提问重要问题的同时，不中断独立工作。

dsh-decision-inbox 是 DeepSeek Harness 的非阻塞人工决策收件箱插件。当智能体遇到需要用户拍板的关键选择时，DSH Web 会显示一张决策卡片，同时智能体继续处理不依赖该答案的工作。

它补充 DSH 现有的阻塞式用户提问与审批流程，但不替代安全审批、权限提示、身份验证，也不替代破坏性操作的确认。

设计思路

如你们所见，这是一个能让 deepseek-harness 工作中在弹出选项窗口时，还能继续进行其他任务的插件（而不是一直卡在选项窗口不动，睡一觉醒来发现它卡在选项窗口后，别的任务也不进行了）。不过现在大家用 Agent 应该都是「你决定就行」这样的吧（自动审批很好用 hhh，其实我大部分时间也是这样），是不是已经很久没看到选项窗口的弹出了！但我相信不是所有使用者都希望 Agent 自动拍板（比如高安全需求的开发场景？），尽管需求窗口确实很小，我还是做了这个插件。

没有非阻塞决策收件箱时，智能体提出问题后，整个回合往往就闲置下来，一直等用户回复。

之前

| 1. 收到任务 | 2. 发现重要选择 |
| 3. 等待用户 | 4. 独立工作被搁置 |

有了 dsh-decision-inbox，智能体只把依赖决策的分支挂起，然后继续处理无关任务或安全的准备工作。

之后

| 1. 收到任务 | 2. 发现重要选择 |
| 3. 决策卡片保持挂起 | 4. 独立工作继续进行 |

流程

flowchart TD
start[User gives a task] --> analyze[Agent analyzes the work]
analyze --> choice{Consequential choice?}

choice -- No --> normal[Continue normally]

choice -- Yes, no plugin --> ask[Ask user]
ask --> stop[Whole turn stops]
stop --> idle[Independent work remains undone]
idle --> later[User replies later]
later --> resume_old[Agent resumes in a later step]

choice -- Yes, with this plugin --> request[Create non-blocking decision]
request --> card[DSH Web shows a decision card]
request --> split[Split work by answer dependency]mermaid
flowchart TD
split --> continue[Do answer-independent work now]
continue --> boundary[Stop only at the dependent boundary]
card --> answer[User answers later]
answer --> deliver[Answer returns to the owning session]
deliver --> finish[Finish answer-dependent work]
boundary --> finish

提供什么

- DSH Web 决策卡片，带可点击选项和自由文本回答。
- decision_request：创建待决问题，不阻塞工具调用。
- decision_list 和 decision_cancel：查看或取消待决决策。
- /decision 兜底命令，用于列出、回答、取消、导出和导入。
- 持久化 JSON 状态、只追加审计日志、导出/导入支持，以及面向长期集成的远程同步接口。
- 引导模型判断：什么时候某个选择足够重要、值得发问；日常可逆的细节仍用合理默认值。

快速开始

把插件安装到 DSH web 配置档： bash
dsh plugin --profile web add github:ThirtySeven-3737/dsh-plugin-decision-inbox

如果你从源码检出运行 DSH，而不是用全局可用的 dsh 命令，请用仓库自带的命令行包装器： bash
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add github:ThirtySeven-3737/dsh-plugin-decision-inbox

因为这个仓库从 GitHub 源码安装，pnpm 可能会要求你批准包构建步骤。如果首次安装失败并提示 allowBuilds，把打印出来的这个包的 key 加到该配置档的 pnpm-workspace.yaml，然后重新运行 add 命令。安装完成后，重启 DSH Web： bash
pnpm dsh web

然后打开 pnpm dsh web 打印的本地 URL，新建会话。本地开发时通常是 http://127.0.0.1:3080，但具体端口取决于你的 DSH Web 设置，不属于这个插件。

不需要斜杠命令，也不需要特殊提示词。当智能体遇到有后果的选择、同时还能做有用的独立工作时，它应该创建一个非阻塞决策，DSH Web 会显示决策卡片。

试一个带用户自主选择、且有后果的任务，例如： text I want to add a remote sync capability for pending decisions in this plugin, and other tools may integrate with it long term. Please decide the best implementation approach and build it.

预期行为：

1. 智能体识别出有后果的选择。
2. 出现 Pending decision / 待你决定 卡片。
3. 卡片打开期间，智能体继续做与回答无关的工作。
4. 用户回答后，回答送回所属会话，智能体完成依赖回答的工作。

开发

本地克隆并构建： bash
git clone https://github.com/ThirtySeven-3737/dsh-plugin-decision-inbox.git
cd dsh-plugin-decision-inbox
pnpm install
pnpm build

开发期间把本地工作副本安装到 DSH： bash
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add file:/path/to/dsh-plugin-decision-inbox

运行检查：

pnpm check
pnpm test
pnpm build

常规测试套件不需要模型 API key。可选的自主性评估可以读取 DEEPSEEK_API_KEY，或读取本地的 env.txt。

更多细节

- 完整技术参考：docs/technical-reference.md
- 真实模型测试报告：docs/reports/real-model-test-report.md
- 发布说明：CHANGELOG.md
- 贡献指南：CONTRIBUTING.md
- 安全策略：SECURITY.md