109 lines
4.0 KiB
Markdown
109 lines
4.0 KiB
Markdown
## 基本信息
|
||
|
||
- 类型：需求 / 缺陷 / 重构 / 文档
|
||
- 所属 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 和同步镜像。 -->
|
||
|
||
## 验收标准
|
||
|
||
- [ ] （填写）
|
||
|
||
## 验证方式
|
||
|
||
<!-- 写出可复制命令；需要真机、生产环境或人工检查时明确说明。 -->
|
||
|
||
## 风险和回退
|
||
|
||
<!-- 普通低风险任务可简写；涉及接口、迁移、安全或不可逆操作时必填。 -->
|