## 基本信息

- 类型：需求 / 缺陷 / 重构 / 文档
- 所属 Epic：# / 无
- 所属 MVP / 版本：# / 无
- 阶段：待确认 / 待实施 / 进行中 / 阻塞 / 待验收

## 依赖与并行

- 前置工单：无 / #编号
- 是否允许与前置工单并行：是 / 否
- 原因：

## 子项目影响

- 仅影响的子项目 / 交付单元：server / web / android / prototypes / shared-docs
- 是否跨子项目：是 / 否
- 是否修改共享接口或契约：是 / 否；唯一事实来源：Wiki `Android-Agent-API-Contract`
- 各子项目需要执行的验证：

## 原始需求

- 来源：用户对话 / Gitea / 其他
- 提出时间：
- 关键原话或脱敏摘要：

<!-- 只保留表达用户目的、场景和限制所需的内容；不要复制完整聊天、内部推理或敏感信息。 -->

## 要解决什么

- 当前代码事实：
- 目标契约 / 用户期望：
- 假设与未确认项：

<!-- 当前事实应能指向代码、测试、日志或可复现证据；不得把目标方案写成已有能力。缺陷另写清复现步骤、实际结果和期望结果。 -->

## 做什么 / 不做什么

- 做：
- 不做：

## 已确认方案

<!-- 写清修改范围、关键设计，以及是否影响接口、数据库和安全边界。 -->

预计修改文件：

- （填写）

## 需求变化记录

| 日期 | 变化内容 | 原因 | 用户确认 |
|---|---|---|---|
| | 无 | | 是 |

## 设计与原型门禁

- 修改类型：纯显示文案 / 小范围 UI / 新组件 / 新页面或独立用户功能 / 重大交互或导航 / 非 UI / 恢复既有行为的 Bug
- 所需设计证据：无 / 标注截图 / 低保真图 / 已确认原型 / 架构、API、数据、状态或流程设计 / 原设计或复现证据
- 可编辑设计源、线上原型链接和访问检查：
- 审核版本、revision、复制版本或确认日期及识别方式：
- 本地 HTML 导出：未要求 / 用户明确要求 / 项目规则要求
- 本地 HTML 路径、版本和资源检查（仅显式导出时填写）：
- 状态：无 / 草稿 / 已确认 / 已废弃
- 确认人、确认时间和覆盖范围：
- 无需 UI 原型或无需任何原型的原因：

<!-- 新页面、独立用户功能、重大交互或导航变化默认通过可访问且版本明确的线上原型审核；只有用户或项目规则明确要求时才导出 prototypes/<工单号>/<版本>/index.html。原型和文字需求未确认前不得编写生产代码。 -->

## 文档影响

- [ ] 不影响长期文档，原因：
- [ ] 更新项目档案或本地开发与验证 Wiki
- [ ] 更新常见修改或故障排查 Wiki
- [ ] 更新架构与代码地图 Wiki
- [ ] 更新业务规则与术语 Wiki
- [ ] 更新 API 契约 Wiki
- [ ] 更新产品需求、常见修改或故障排查 Wiki

<!-- 单次任务需求、变化、实现、测试、提交和验收只记录在本工单。只有勾选了长期文档影响才更新 Wiki，并在待验收前完成一次在线回读、sync 和 sync --check。标准流程不创建 Wiki 任务归档；archive/export 仅在用户明确要求专项快照时使用。 -->

## 交付文档影响

- [ ] 无交付文档影响，原因：
- [ ] 更新已有交付文档，受众与页面：
- [ ] 新增交付文档，受众与页面：
- [ ] 需要目标岗位或客户代表验证：是 / 否；验证方式：

## 任务记录与可选快照

- 单次任务事实来源：当前 Gitea 工单正文与评论
- [ ] 默认不创建任务快照
- [ ] 用户明确要求专项快照；用途和范围：
- [ ] 项目专用规则要求任务快照；规则入口：

<!-- 工单正文保存确认基线；重要变化、最终证据和验收结论通过评论追加。只有长期事实变化时才更新 Wiki 和同步镜像。 -->

## 验收标准

- [ ] （填写）

## 验证方式

<!-- 写出可复制命令；需要真机、生产环境或人工检查时明确说明。 -->

## 风险和回退

<!-- 普通低风险任务可简写；涉及接口、迁移、安全或不可逆操作时必填。 -->