---
title: SolutionModel
description: 题解模型，用于管理题目题解、回复和投票
source: packages/hydrooj/src/model/solution.ts
source_url: https://github.com/hydro-dev/Hydro/blob/master/packages/hydrooj/src/model/solution.ts
import: "import { SolutionModel } from 'hydrooj'"
---
# SolutionModel

题解模型，用于管理题目题解、回复和投票。

`SolutionModel` 是一个纯静态类。所有方法直接在类上调用（如 `SolutionModel.add(...)`）。

所有方法委托给通用的 `document` 子系统，使用 `document.TYPE_PROBLEM_SOLUTION` 作为文档类型。

---

## 方法

### 增删改查

#### `add(domainId: string, pid: number, owner: number, content: string): Promise<ObjectId>`

为题目 `pid` 创建一条新题解。初始化时 `reply` 数组为空，`vote: 0`。返回插入文档的 `_id`。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `pid` | `number` | — | 题目 ID |
| `owner` | `number` | — | 创建者 UID |
| `content` | `string` | — | 题解内容 |
| **返回值** | `Promise<ObjectId>` | | 新文档 ID |

#### `get(domainId: string, psid: ObjectId): Promise<Document>`

通过 ID 获取单条题解。未找到则抛出 `SolutionNotFoundError`。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| **返回值** | `Promise<Document>` | | |

#### `getMany(domainId: string, query: any, sort: any, page: number, limit: number): Promise<Document[]>`

分页获取匹配 `query` 的题解列表，按 `sort` 排序。使用 `skip`/`limit` 进行分页。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `query` | `any` | — | 查询条件 |
| `sort` | `any` | — | 排序条件 |
| `page` | `number` | — | 页码（从 1 开始） |
| `limit` | `number` | — | 每页数量 |
| **返回值** | `Promise<Document[]>` | | |

#### `edit(domainId: string, psid: ObjectId, content: string): Promise<void>`

更新已有题解的内容。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `content` | `string` | — | 新内容 |
| **返回值** | `Promise<void>` | | |

#### `del(domainId: string, psid: ObjectId): Promise<[void, void]>`

并行删除题解及其所有关联的状态记录（投票）。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| **返回值** | `Promise<[void, void]>` | | |

#### `count(domainId: string, query: any): Promise<number>`

统计匹配给定查询的题解数量。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `query` | `any` | — | 查询条件 |
| **返回值** | `Promise<number>` | | |

### 列表

#### `getMulti(domainId: string, pid: number, query?: any): Cursor<Document>`

获取指定题目的所有题解。结果按 `vote` 降序排列（最高票优先）。可传入额外的查询过滤条件。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `pid` | `number` | — | 题目 ID |
| `query` | `any` | — | 额外过滤条件 |
| **返回值** | `Cursor<Document>` | | |

#### `getByUser(domainId: string, uid: number): Cursor<Document>`

获取指定用户的所有题解。结果按 `_id` 降序排列（最新优先）。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `uid` | `number` | — | 用户 UID |
| **返回值** | `Cursor<Document>` | | |

### 回复

#### `reply(domainId: string, psid: ObjectId, owner: number, content: string): Promise<void>`

为题解添加一条回复。追加到 `reply` 子文档数组中。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `owner` | `number` | — | 回复者 UID |
| `content` | `string` | — | 回复内容 |
| **返回值** | `Promise<void>` | | |

#### `getReply(domainId: string, psid: ObjectId, psrid: ObjectId): Promise<Document>`

通过 ID 获取题解中的特定回复。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `psrid` | `ObjectId` | — | 回复 ID |
| **返回值** | `Promise<Document>` | | |

#### `editReply(domainId: string, psid: ObjectId, psrid: ObjectId, content: string): Promise<void>`

更新已有回复的内容。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `psrid` | `ObjectId` | — | 回复 ID |
| `content` | `string` | — | 新内容 |
| **返回值** | `Promise<void>` | | |

#### `delReply(domainId: string, psid: ObjectId, psrid: ObjectId): Promise<void>`

删除题解中的特定回复。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `psrid` | `ObjectId` | — | 回复 ID |
| **返回值** | `Promise<void>` | | |

### 投票

#### `vote(domainId: string, psid: ObjectId, uid: number, value: number): Promise<Document>`

对题解进行投票或更新投票。跟踪每用户的投票状态——若用户已投票，则调整投票差值（不重复计数）。若新投票与现有投票相同则为空操作。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psid` | `ObjectId` | — | 题解 ID |
| `uid` | `number` | — | 投票者 UID |
| `value` | `number` | — | 投票值（正/负） |
| **返回值** | `Promise<Document>` | | |

#### `getListStatus(domainId: string, psids: ObjectId[], uid: number): Promise<Record<string, { docId: ObjectId, vote: number }>>`

批量获取当前用户对多条题解的投票状态。返回以题解 ID 字符串为键的映射。

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `domainId` | `string` | — | 域上下文 |
| `psids` | `ObjectId[]` | — | 题解 ID 数组 |
| `uid` | `number` | — | 用户 UID |
| **返回值** | `Promise<Record<string, { docId: ObjectId, vote: number }>>` | | |

---

## 事件

| 事件 | 参数 | 说明 |
|------|------|------|
| `problem/delete` | `domainId, pid` | 删除被删除题目的所有题解及其状态记录 |

---

## 备注

- 题解使用通用 `document` 子系统，文档类型为 `TYPE_PROBLEM_SOLUTION`，父类型为 `TYPE_PROBLEM`。
- `vote` 使用 `document.setStatus` 配合 `'before'` 策略检测先前的投票，然后通过 `document.inc` 调整题解的 `vote` 计数——防止重复计数。
- `del` 执行两个并行删除：文档本身和所有关联的状态记录。