# 安装与启用

[← 文档导航](README.md)

本指南适用于已在本机使用 DeepSeek Harness 的用户。安装后，你会获得一个“工程流程”工作台和一个“工程化开发引擎”会话预设。

## 1. 安装插件

确认 pnpm 可用，将插件添加到所用的 Web profile。以下命令使用 `web`。

```sh
dsh plugin --profile web add @godv61/dsh-task-engine
```

如果你正在 Harness 源码目录开发，使用：

```sh
pnpm dsh plugin --profile web add @godv61/dsh-task-engine@0.23.0
pnpm dsh web --no-open
```

已有 Web 进程时，先关闭该进程再启动，避免端口冲突。通过 `dsh plugin` 安装会将插件加入对应 profile；仅在任意目录执行 `npm install` 不会完成工作台挂载。

## 2. 检查安装结果

重启后检查两个位置：

- 侧边栏出现 **工程流程**，打开后可以选择工作区。
- 新建会话时，可以选择 **工程化开发引擎**。

没有看到入口时，先确认安装和启动使用的是同一个 profile，再检查启动日志中的插件加载错误。命令报找不到 pnpm 时，需要先准备好 pnpm 环境。

## 3. 配置第一个项目

1. 在工作台顶部选择工作区。
2. 进入“流程配置”，按任务复杂程度选择标准研发、敏捷轻量或纯代码。
3. 如需自己的技能或规则，在对应页面安装，再回到流程配置挂载到阶段。
4. 保存配置，在使用“工程化开发引擎”预设的会话中描述任务。

后续在“任务台账”查看阶段、实施项与验证审核记录。项目初始化会管理根目录的 `AGENTS.md`：先查看或生成草稿，再确认保存。

## 两种预设的区别

| 位置 | 决定什么 |
| :--- | :--- |
| 会话中的“工程化开发引擎” | 是否启用 `dev_task`、配套技能和工程人设。 |
| 工作台中的三个流程预设 | 任务经过哪些阶段、每一步需要满足什么条件。 |

如果切换到未挂载插件 agent 的其他会话预设，该会话不会启用这套任务工具；侧边栏工作台仍可使用。

下一步：[配置流程](configuration.md) · [安装资源](resource-install.md) · [常见问题](faq.md)