# dsh-task-modes

[English README](README.md)

一个可独立安装的 DeepSeek Harness Web bundle，通过一个包含三个可组合维度的任务模式按钮工作，不修改 DeepSeek Harness core：

- 工作状态：执行或计划；
- 推理方式：标准或第一性原理；
- 质量门：关闭、对抗性审查或验收审查。

![dsh-task-modes](https://raw.githubusercontent.com/GraySilver/dsh-task-modes/main/assets/social-preview.png)

## 安装

无需全局安装 DSH，直接将固定 npm 版本安装到 Web profile：

```sh
npx -y @deepseek-ai/dsh plugin --profile web add @graysilver/dsh-task-modes@0.2.0
```

如果已经全局安装 `dsh`，可以使用：

```sh
dsh plugin --profile web add @graysilver/dsh-task-modes@0.2.0
```

安装后重启 Web profile，输入区工具旁会出现一个任务模式按钮。按钮显示当前组合，例如 `Execute · Standard · Off`；点开后可选择三个维度。bundle 会接管独立的 Plan 状态 UI seat，因此输入区只保留一个任务模式入口，同时仍复用官方 Plan service 和审批流程。该 bundle 要求标准 DSH Plan mode capability；若服务不存在，它会明确加载失败，而不会伪造一个计划模式。

需要审计源码或进行开发时，可以安装固定 Git revision：

```sh
dsh plugin --profile web add github:GraySilver/dsh-task-modes#<trusted-commit>
```

Git 安装包会执行安装期代码，请只安装可信 revision。

## 任务模式菜单

任务模式按钮会打开一个分组菜单，默认是 `Execute · Standard · Off`。三个维度彼此独立。例如，高影响决策可以选择“计划 + 第一性原理”；实现功能时可以选择“执行 + 验收审查”。

| 控制项 | 选项 | 行为 |
| --- | --- | --- |
| 工作状态 | 执行、计划 | 计划委托给官方 `@deepseek-ai/dsh-plan-mode`，复用 `/plan`、持久化 `plan/mode` 事件和 `exit_plan_mode` 的用户审批流程。 |
| 推理方式 | 标准、第一性原理 | 第一性原理向 system prompt 注入目标、事实与假设、约束、推导和验证要求。 |
| 质量门 | 关闭、对抗性审查、验收审查 | 每个完成的父回合后运行一个独立建议型 fork。对抗性与验收是互斥 profile，不会叠加运行多个审查器。 |

### 计划模式与工具

官方 Plan mode 生效时，插件通过 DSH 的 `tools/pre-execute` pipeline 真实执行工具策略。只允许 `read`、`glob`、`grep`、`read_image`、已配置的平台 shell 和 `exit_plan_mode`；所有修改工具及其它工具会收到明确拒绝。

已配置的 shell 刻意保持完整能力：macOS/Linux 默认使用 `bash`，Windows 默认使用 `pwsh`。因此 Plan mode **不是** 操作系统级只读 sandbox。模型或审查器仍可能通过 shell 发出修改命令。需要进程隔离时，应配置具备约束能力的 shell/sandbox provider 与权限策略。

Plan 审核不会延迟或阻断官方 `exit_plan_mode` 审批。启用质量 profile 后，插件会在已完成的 Plan 回合之后生成建议型报告。官方退出工具成功提交计划时，审查的候选内容是该计划本身，而不仅是周围的助手文本。

### 第一性原理证据

第一性原理 section 会进入持久化的 `request/header.system`。Trajectory 从其中投影完全相同的内容为上下文式检查行，因此历史请求能直接看到该注入。它不会追加用户消息，也不会人为增加 transcript event。关闭后续请求不再包含该 section，已有行则保留为历史证据。

### 质量 profile

对抗性审查会检查当前任务和答案中的未满足要求、缺少依据的声明、遗漏、回归、反例与安全风险，并返回包含证据和后续行动的建议型 Markdown verdict。

验收审查独立比对任务、候选答案，以及存在时的已批准计划。它按 `Met`、`Gap`、`Unverified`、`Evidence` 和 `Concrete follow-up` 输出 Markdown checklist。这是纯模型/子 Agent 审查：不会自动识别或执行项目 test、lint、build 命令，也不会重写、重试或修复父结果。

两种审查都可以使用 `read`、`glob`、`grep`、`read_image` 和已配置的平台 shell。提示词要求进行非修改性检查，但提示词限制不是操作系统 sandbox。审查失败会以不可用状态持久化，且不会阻断父答复或 Plan 审批。

Web 端会在对应 AI 回复下方以折叠 Markdown 显示审查；展开后的正文固定为 240px 高度并可滚动。

![任务模式审查面板](https://raw.githubusercontent.com/GraySilver/dsh-task-modes/main/assets/task-modes-review.png)

## 持久化与命令

bundle 使用 `graysilver_task_modes` storage domain 保存记录。工作状态不会在这里重复存储，而是由官方 Plan mode 从 session log 折叠得到。推理选择、质量选择和报告可跨服务重启、会话重新加载继续存在，同时不新增自定义 DSH session event 类型。

`0.2.0` 保持 domain descriptor 的版本为 `1`，启动时自动重写旧记录：

| 旧模式 | 推理方式 | 质量门 |
| --- | --- | --- |
| `normal` | `standard` | `off` |
| `first-principles` | `first-principles` | `off` |
| `adversarial-review` | `standard` | `general-review` |

可在 Web 输入区或命令 API 使用：

```text
/task-mode
/task-mode working execute
/task-mode working plan
/task-mode reasoning standard
/task-mode reasoning first-principles
/task-mode quality off
/task-mode quality general-review
/task-mode quality acceptance-review
/task-mode review <turn>
/task-mode reviews
```

旧的单一模式别名会在 `0.2.x` 期间继续接受：`normal`、`first-principles` 和 `adversarial-review`。它们会将工作状态重置为执行，并按上表转换。

## 配置

bundle 会自动选择平台 shell。只有目标 profile 已注册该工具时才覆盖：

```yaml
- id: dsh-task-modes
  config:
    shellTool: bash
```

质量审查要求 DSH 的 fork/subagent capability；计划模式要求官方 `planMode` service 和 tools pipeline。

## 兼容性

需要提供 Web plugin loader、client UI slots、storage domain、forked subagent、官方 Plan mode service 与 DSH tools pipeline 的 DeepSeek Harness 版本。npm 是推荐的稳定分发渠道；固定 Git revision 继续用于源码审计和开发。

## 反馈

Bug 和功能建议请提交到 [GitHub Issues](https://github.com/GraySilver/dsh-task-modes/issues)。欢迎在 [DeepSeek Harness Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions) 分享集成和使用反馈。

## 许可证

MIT