代码审查

## 任务目标

请在真实 Vue 工程中完成选定范围的结构、组件和编码规范重构，交付实际代码及验证结果。先读取工程；能从代码确认的信息不重复询问。资料缺失时标明事实与假设，只对阻断实施的关键项提问，其余授权工作继续完成。

在现有授权范围内完成实际改动和验证；缺少外部条件时先完成可独立实现的部分，不能只停留在计划。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

重构对象：从当前对话指定的页面、模块或改动文件识别范围；维护问题未说明时，优先检查该范围内职责混杂、重复业务逻辑和多处可写状态，实施可证明保持行为的局部重构。
工程或代码资料：读取当前已确认工作区中的组件、调用方、API、store、字典与规范配置，并从既有测试和页面操作提取行为基线。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 检查分支与未提交内容，以及 Vue、脚本语言、API 风格、构建和组件库的真实版本。
- 从页面入口追踪 props、emits、插槽、v-model、请求与字典，确认状态所有者和外部契约。
- 搜索真实复用场景、自动导入、动态路由和插件注册，确认抽取及删除不会破坏运行时引用。
- 读取 ESLint 与 Vue/TypeScript 解析器、flat/legacy 配置、格式化方案及已有验收命令。

### 可采用的默认处理

- 保留 Vue 2/3、JS/TS、组件库和状态管理选型，不通过框架迁移解决局部结构问题。
- 按已有业务职责整理目录；纯工具、组合式逻辑和领域规则分别归位，不机械创建空目录或万能组件。
- 保持界面、接口、事件和字典值稳定，保留无关改动，规范治理只覆盖本次范围且不得靠忽略规则消除新增错误。

### 必须有依据的事项

- 调用方对同一组件的事件、空值或编辑副本语义存在冲突，且抽取后必须改变其中一方的业务行为。
- 需要修改对外字段、路由或业务状态码才能继续，而实际兼容约束和使用方无法从工程确认。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 只有片段时交付该片段的职责拆分与契约表、完整局部修改示例，并列出需回查的调用方。
- 没有工程时给出重构检查顺序、组件边界判据和关键行为回归清单，不以虚构文件说明已落地。

## 执行要求

以当前工程事实决定实现，降低理解和修改成本，不按文件行数或目录数量评价重构效果。

### 确认范围和基线
检查分支、未提交及未跟踪改动，记录目标文件现状，保留已有 dirty 内容，不覆盖其他人的工作。确认实际 Vue 2/3、JS/TS、Options/Composition API、构建框架、UI 库、路由、store、请求库和锁文件版本；沿用既有选型，不强迁移 Vue、TypeScript、Vite、Pinia 或组件库，不顺手升级依赖。跟踪页面入口、权限、请求、数据转换和显示结果，先列出待修问题、最小修改范围及可验收行为；未经授权不扩展为整仓格式化。

### 按职责整理代码
页面负责路由参数与页面流程编排；业务组件承接明确领域场景；通用组件只保留稳定的跨场景交互契约；composables/hooks 承接可复用的响应式逻辑和生命周期；API 层负责请求契约；store 只保存确需共享的状态；types 记录已有类型契约；styles 归属主题、布局或组件。利用现有目录表达这些职责，不机械新建空目录，不为了拆分制造层层透传。纯格式转换和无副作用计算抽到 util；权限判断、字典转换等领域能力放在明确业务模块集中管理，不堆进万能 util。

### 确定组件边界
沿业务职责、独立变化和真实复用拆分，避免既请求数据又拼装所有页面的超大万能组件；相似外观但行为不同不强行统一。复用方案必须列出至少两个真实使用场景或独立职责理由。明确 props 的类型、默认值、必填和空值含义，事件说明触发时机与载荷，插槽和 v-model 按当前版本定义；不直接修改 props 或隐式改写父级对象。组件内部实现保持封装，不用过量开关和跨层 ref 调用拼出第二套页面框架。

### 收敛状态和业务规则
每个业务状态明确唯一所有者，避免 props、局部副本、store 和 URL 各维护一套可写真相。派生值用 computed，表单编辑副本说明初始化、回填、取消与提交边界，切换记录不残留上条数据。业务状态码、枚举、权限标识与服务端和数据库字典一致，不能自行改名改值；已有字典接口或生成类型继续复用，不复制第二套硬编码。只有稳定的前端配置才抽命名常量；未知字典码给出可识别回退，不默认为正常状态。区分 0、false、空字符串、null 和未提供，不能用通用假值判断抹掉有效业务值。

### 保留异步与交互正确性
分别处理 loading、empty、error、成功和权限不足，不把请求失败展示成暂无数据；刷新已有数据是否保留由场景决定。表单校验按输入、失焦和提交时机给出字段附近反馈，首次进入不满屏报错，失败后保留合理输入。前端提交锁和按钮反馈负责防连点，服务端幂等键、唯一约束及事务由真实接口负责，不能承诺禁用按钮即可防重复写入。查询变化时按请求库能力取消旧请求，并用请求序号或条件快照保护旧响应及 finally，避免覆盖新结果或提前清掉 loading。watch 仅处理必要副作用，清理定时器、事件、订阅与失效请求；按实际 Vue 生命周期实现，不套用当前版本不存在的清理 API。

### 重构同时守住性能
v-for 使用稳定且唯一的业务 key，可排序或编辑列表不用索引、随机数和时间戳作 key。移出模板和循环里的昂贵计算、重复字典查找及逐项请求；纯派生用 computed，保持无副作用且依赖完整。批量接口须确实存在，不得编造；没有时按业务限制控制请求量。复用组件不能引入多余渲染和请求，分页、虚拟列表、memo 或全局缓存都要基于真实瓶颈再决定。若修改加载方式或依赖，记录构建包体积与关键页面渲染变化，不把“组件更多”当作性能提升。

### 把规范落实到工具
使用现有兼容版本的 ESLint 与 eslint-plugin-vue，TS 工程配套 typescript-eslint；检查 .vue 外层解析器和脚本解析器分工，确保模板、脚本和目标文件确实进入检查。保留 flat 或 legacy 配置，先核对 Node、ESLint、插件及 TS 版本，再补缺失配置，不照搬最新版。统一空格、缩进、换行、引号、分号、导入分组和单文件组件区块顺序，以项目已有 ESLint 或 Prettier 方案为准，并对齐 .editorconfig。若并用，明确格式和质量职责，按兼容机制消除重复格式规则冲突，不能借机降低质量门槛。

### 清理与可读性
改动范围做到零新增 lint 违规；不要靠新增 disable、扩大 ignore、any、ts-ignore 或删除检查绕过问题。历史问题与新增问题分开记录，无法修复的阻断如实报告。命名表达业务，函数职责单一；注释解释业务原因、接口边界、限制和必要取舍，不机械逐行翻译代码。删除冗余分支、废弃样式与依赖前核查静态引用、自动导入、动态路由、按需组件、插件注册及运行时使用，不能只凭一次文本搜索判定无用。

## 交付与验收

### 实际验收与交付
维持政企中文页面的清楚层级、对齐、间距、操作顺序和信息密度，复用现有 UI 规范；不新增装饰性口号或非业务说明。实际运行范围相关 lint、项目适用的 typecheck、生产 build 和关键交互验证；纯 JS 且无类型检查时标注不适用，已有检查缺失则说明覆盖缺口。重点验证查询重置、分页排序、编辑回填、取消保存、错误恢复、快速切换和权限状态，同时检查中文换行、弹窗焦点、按钮可用状态及新产生的控制台错误。原有检查失败不等于本次失败，但必须给出前后证据，不能宣称整体通过。

最后输出：①实际改动及解决的问题，列关键路径；②职责、组件契约、状态所有权与枚举来源的简表；③采用的格式和检查规则、版本兼容处理；④验证项、真实命令或操作、结果及未执行原因；⑤剩余风险和最小后续事项。只写完成事实，未跑不报通过，无证据不报提速；不生成无关 Markdown 文档，不以重构方案替代已授权的代码实现。

### 本条完成检查

- 交付实际代码、关键路径以及职责、组件契约、状态所有权和字典来源简表。
- 说明抽取的真实复用依据与删除的引用检查结果，核对重构未引入重复请求、props 修改或状态双写。
- 运行范围相关检查和生产构建，验证查询、编辑、取消、错误恢复与快速切换，区分历史失败和本次新增问题。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

官方依据：阿里前端规约：https://github.com/alibaba/f2e-spec、Vue 逻辑复用：https://vuejs.org/guide/reusability/composables.html、Vue 插件配置：https://eslint.vuejs.org/user-guide/、ESLint 配置：https://eslint.org/docs/latest/use/configure/configuration-files、Prettier 与 Linter：https://prettier.io/docs/integrating-with-linters。

收录核验（2026-09-08）：已核对公开资料和本次项目要求的覆盖范围；尚未使用真实项目执行本模板或进行模型效果评测。具体改动、性能和回归结果须在目标工程中验证。

## 任务目标

请在当前目标工程中，完成本次模块范围内的 Java 结构与编码规范重构。目标是让职责、数据模型、SQL和业务规则清楚一致，并实际修改代码和验证；不要只交审查清单或示例。缺少资料先读取工程，只有影响正确性且无法从工程确定的事项才提问，其余已授权工作继续推进。

在现有授权范围内完成实际改动和验证；缺少外部条件时先完成可独立实现的部分，不能只停留在计划。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

重构模块：从当前对话、正在修改的文件与 Java 模块入口定位目标；未指定时选择一条包含 Controller、Service、Mapper 和实体转换的完整业务链作为首批范围，避免默认整仓重构。
工程与契约资料：读取当前仓库的接口、调用方、枚举字典、XML、迁移和测试，以及同模块稳定代码与格式配置，自动确认版本和已有行为。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 核对分支与未提交修改，并追踪目标入口到 DTO、Service、Mapper/XML 和表结构。
- 盘点状态编码、数据库字典、TypeHandler、序列化字段及历史值处理。
- 检索 SQL 注解、Provider、字符串或 Wrapper，以及反射、SPI、XML、扫描和配置引用。
- 读取既有编译检查、接口回归、数据库集成测试和单一格式工具的入口。

### 可采用的默认处理

- 保持公共接口、持久化编码、权限和事务行为；不升级框架，不为所有类新增接口或强行改 Stream。
- 已有格式配置优先，缺少配置时沿用同模块稳定风格，只规整本轮文件并用一个兼容工具固化。
- 先落实职责与 SQL 归位等有依据的重构；无法解释的旧编码保留原值，不能映射为首项或零值。

### 必须有依据的事项

- 状态或字典的权威来源、旧编码含义及迁移映射存在冲突时，不自行更改存量数据的业务解释。
- 拟删除或合并的代码涉及无法确认的外部契约、权限字段或副作用时，不把无静态引用当成可删除证据。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 没有工程时交付分层与 XML Mapper 的成套示例、枚举字典归属表和旧编码兼容测试样例，说明未执行项目重构。
- 缺数据库环境时完成可执行的代码检查，并交付参数映射、方言、资源加载和历史值验证用例，不宣称 SQL 已验证。

## 执行要求

按项目真实 Java、Spring、MyBatis 及数据库版本实施，不借机升级技术栈。XML限定、枚举与字典分工等属于本项目硬约束。MyBatis允许注解，本项目禁止用该能力承载SQL。

1. 先只读建立范围和基线。确认仓库、分支、未提交改动及模块依赖，从入口沿 Controller、Service、Mapper/XML、表结构追踪一条真实业务链，核对已有校验和测试。记录接口字段、错误码、排序分页、事务和数据权限契约；保留无关改动，不重置工作区。给出分批修改顺序后实施，基线失败与本轮引入失败分开记录。

2. 消除业务魔法值。盘点状态、类型、阈值、标识和业务字符串，明确语义及唯一来源。稳定且有限的数据库业务编码使用带显式code和说明的enum，读写绑定实际code，禁止ordinal持久化，也不以枚举名称变动隐式改库值；核对序列化与TypeHandler。可配置字典以数据库为唯一来源，不为同一值再手工维护一套enum。一般固定常量给出语义名称，阈值按业务决定是否配置化，不把每个数字都建成枚举。

3. 兼容旧数据与未知编码。核对历史值、空值、已停用字典项和灰度期间的新编码；读取时保留原编码并按契约展示未知或停用状态，不悄悄映射成零、首项或其他有效业务状态。写入和状态迁移要验证允许范围，无法安全执行时明确拒绝。若需迁移，说明旧值到新值映射、并行版本兼容与回退，不能仅改Java类型让历史记录读不出来。

4. 整理分层和复用。Controller负责协议、参数及身份入口，Service负责业务规则和事务，Mapper负责持久化；DTO承接输入，DO对应持久化模型，VO按接口契约输出，明确转换及允许写入字段，防止客户端覆盖租户、审计或权限字段。先找真实共同语义再复用；只有无业务状态和外部依赖的纯通用函数才抽Util，领域计算和业务校验留在领域Service。禁止万能Util、为了行数拆碎方法、只有一个用途却搭泛型框架；不强制所有类新增接口。

5. 将MyBatis执行的全部SQL集中到XML Mapper。Java业务层和Mapper接口不承载SQL，不用SQL注解、Provider、Java字符串、SQL Builder或Wrapper拼接绕过限制；Mapper接口保留方法与必要参数绑定。同步核对namespace、方法id、参数名、resultMap、主键回填及资源打包。值参数使用#{参数}绑定；动态列、表及排序方向只允许服务端白名单并在XML选择固定片段，禁止用户输入直接进入美元符文本替换。可复用SQL片段须保持租户和业务过滤语义，迁移DDL沿用工程既有机制。

6. 保持循环和查询的业务含义。识别for及映射转换中的循环查库、远程调用和隐式懒加载N+1，按真实关联键先批量获取再组装；限制批次、分页和内存，不全量装入大表。保留结果顺序、重复项及缺失关联的语义，空集合不得导致XML过滤消失或全表更新。for清楚时保留for，不一律改成Stream或parallelStream；改变调用顺序与批量失败语义时补充相应验证。

7. 加固边界而不隐藏错误。权限和租户来自可信上下文，每次读写核对数据归属；批量查询和幂等结果回放同样不能越权。区分未传、显式null、空字符串、空集合和合法零值，防止拆箱空指针、金额精度或日期时区改变。异常保留原因和必要关联标识，日志脱敏且避免层层重复；不吞异常返回成功或空列表。事务按实际代理调用和回滚规则核验，自调用未触发新事务语义不等于外层必无事务。

8. 重构写操作时保住幂等和外部副作用。以业务键、租户范围、数据库唯一约束及事务保障同一意图只落一次业务结果，不能只靠先查后插、前端禁按钮或短期缓存。核对重复请求、并发、同键不同内容、超时结果不明与重试；不把超时当作失败直接重做。远程调用和消息不能假定随数据库事务回滚，按现有能力处理结果查询、可靠投递或补偿，不在结构重构中随意增加中间件。

9. 清理与规范同步落地。删除前检查静态引用、XML、反射、序列化、注解扫描、SPI、定时任务与配置约定；确认失效或重复才删，不能仅凭IDE灰色提示。按业务职责规整目录、依赖、命名和成员顺序；在类、关键字段、枚举及方法补充有意义的Javadoc，说明参数、返回、异常和业务限制，复杂分支注释解释原因而非复述代码，不编造作者日期。新增表的全部字段及新增字段须写入详细中文数据库注释，使用COMMENT或目标数据库对应语法，说明含义、单位、编码、空值及默认值语义。空格、换行、缩进和导入遵循既有规则及单一格式化工具，仅处理本轮文件，禁止无关整仓格式化。

10. 实际验证并收口。在每批修改后检查差异，运行受影响模块的编译、既有静态检查及必要测试；补足对契约变化有辨识力的回归，覆盖旧编码、未知编码、空输入、权限租户、批量边界、事务失败和重复请求。XML须验证资源加载、参数结果映射及真实数据库方言；仅编译不能证明SQL正确。环境不足时完成可执行部分并列明具体缺口，不把未运行、没有测试或仅人工阅读写成通过。

## 交付与验收

交付格式：先说明完成的业务变化及保留的契约，再列修改文件与理由、枚举/字典/常量归属表、Java到XML迁移及分层对应关系、删除证据、实际验证结果和剩余风险。存在数据库变更时附项目已有格式的迁移与回退内容；没有实测就不给性能提升数字。交付已完成的代码，不生成无关Markdown文档，不将方案当作完成。

格式落地补充：工程缺少成文配置时，以同模块稳定风格制定一套最小规则，明确空格、缩进、换行、空行、导入顺序及成员组织，用兼容的格式化或静态检查工具固化到现有构建。列出实际采用的规则和检查入口，不能只口头要求代码整齐，也不能额外引入相互冲突的格式工具。

### 本条完成检查

- 实际完成目标范围的结构整理、显式编码、XML SQL、DTO/DO/VO 边界和基于真实共性的复用。
- 删除有引用核对证据，新增字段具有详细中文注释，格式调整局限本轮文件。
- 记录编译及契约、旧编码、空值、权限、批量和事务回归，区分基线失败与本轮失败。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

官方依据（2026-09-08核验，仅采用相关条目，不代表完整企业内部规范）：
- 阿里巴巴《P3C-PMD 公开编码规则》：https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md
- MyBatis《MyBatis 3：Mapper XML Files》：https://mybatis.org/mybatis-3/sqlmap-xml.html
- MyBatis《MyBatis 3：Dynamic SQL》：https://mybatis.org/mybatis-3/dynamic-sql.html
- Spring《Spring Framework：Using @Transactional》：https://docs.spring.io/spring-framework/reference/data-access/transaction/declarative/annotations.html
- Spring《Spring Framework：Rolling Back a Declarative Transaction》：https://docs.spring.io/spring-framework/reference/data-access/transaction/declarative/rolling-back.html

收录核验（2026-09-08）：已核对公开资料和本次项目要求的覆盖范围；尚未使用真实项目执行本模板或进行模型效果评测。具体改动、性能和回归结果须在目标工程中验证。

## 任务目标

请审查或完善本次 Python 模块的类型契约。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

类型契约对象：从当前模块的公开导出、对话指定函数或本次改动接口开始，对照实现、调用方和文档检查类型；未明确要求修改时先报告确定差异。
模块或契约资料：查找模块、公开导出、docstring、外部调用示例、最低 Python 约束和现有静态检查配置。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 划分公开接口、内部辅助与动态扩展，记录参数默认值、空值、集合元素和所有返回分支。
- 比对调用方实际传值、文档示例及运行时校验，识别可用协议类型与兼容边界。
- 查最低解释器、检查器能力、注解反射及类型别名使用点，排查循环导入和 TYPE_CHECKING 风险。

### 可采用的默认处理

- 默认只读核对，明确要求完善时只补有契约证据的公开边界，不为注解覆盖率修改业务签名。
- 沿用最低 Python 和现有检查工具支持的语法，不因类型提示升级解释器。
- 动态入口保持已知能力并说明不确定部分，不用大面积 Any 或忽略错误宣称类型完备。

### 必须有依据的事项

- 实现、调用方和文档对同一参数或返回值存在业务歧义，无法确定收紧类型是否会拒绝合法调用。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 没有调用方时完成可观察分支与文档差异表，对调用兼容结论单独标记限制。
- 不能运行最低版本时提供候选注解和导入、反射及关键调用检查命令，不声称兼容性已验证。

## 执行要求

以真实调用契约为准完善类型标注，并用项目现有工具验证。检查 Paddle 公开 API 时核对对应接口要求；普通 Python 工程按自身兼容范围选择类型语法，不直接套用框架专属约定。

1. 先区分公开接口、内部辅助函数和动态扩展入口，记录真实调用方依赖的参数与返回值。优先完善公开边界，不为了追求覆盖率给所有局部变量堆叠注解，更不能通过修改业务签名制造表面上的类型统一。
2. 将函数签名、类公开属性和说明文档逐项对照，检查可为空、默认值、集合元素和返回分支。对字典结构尽量描述明确字段，对返回结果写出调用方实际拿到的具体类型，避免用 Any 掩盖已知契约。
3. 检查参数是否需要接受更通用的集合协议，以及实现是否真的支持这些输入。保留必要的运行时校验，类型提示不能替代用户输入验证；如果使用枚举、字面量或重载，说明它们与真实运行行为的对应关系。
4. 核对最低解释器和静态工具支持的语法，区分注解上下文与运行时类型别名。仅为类型服务的导入可以评估放入 TYPE_CHECKING，但需要运行时反射或解析注解的代码必须另外验证，不能盲目移动导入。
5. 检查文档示例、外部调用和异常分支是否同时符合新类型，识别循环导入、可变容器与泛型参数缺失。只在有明确契约的地方收紧类型，并列出可能影响调用方的变化及迁移办法。
6. 使用项目现有静态检查和相关运行测试验证，在最低支持环境做导入与关键调用检查。对每个无法准确标注的动态入口说明原因和收敛方案，禁止大量忽略错误后宣称类型已经完整可靠。

## 交付与验收

输出：公开接口契约表、类型与文档差异、必要代码修改、兼容性说明及检查结果。缺少调用方或版本信息时记录假设和待确认项；没有执行条件就提供验证命令与预期检查目标，不虚报静态检查已通过。

### 本条完成检查

- 公开契约表覆盖参数、空值、默认值、集合元素、返回和异常，差异可定位到实现或示例。
- 如实施标注，保持运行时校验，验证类型导入、反射及最低版本关键调用。
- 分别给静态检查和运行测试结果，列出仍无法准确描述的动态入口及影响。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

官方来源（2026-09-08 核验）：
- [百度飞桨《Python 类型提示标注规范》](https://www.paddlepaddle.org.cn/documentation/docs/zh/dev_guides/style_guide_and_references/type_annotations_specification_cn.html)

## 任务目标

请根据本次要求，将小程序中的重复业务界面封装为可复用组件，或审查已有组件的边界与样式隔离。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

组件目标：优先审查当前页面引用的目标组件；若对话明确要求封装重复界面，则从真实使用页面识别共同职责后实施，不凭相似外观创建通用组件。
组件或使用页面：读取组件及调用页面的 JSON、WXML、WXSS、脚本、事件监听和已有运行配置，从实际工程识别原生或跨端框架。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 对照真实调用场景确定数据所有者、内部状态、业务差异及是否存在稳定复用职责。
- 核对 usingComponents 路径、properties、事件载荷、插槽与 multipleSlots 配置。
- 检查 styleIsolation、外部样式类、虚拟节点及渲染器支持，跨端工程同时追查生成代码。

### 可采用的默认处理

- 没有明确封装或修复要求时只读审查；实施时保持原有属性、事件和页面行为兼容。
- 优先现有隔离方式与明确的外部样式入口，不为局部问题全局开放样式共享。
- 仅有一个真实场景时按独立职责判断是否值得封装，不虚构第二个页面或添加大量未来开关。

### 必须有依据的事项

- 不同调用页面对属性、事件或内部状态职责存在冲突，无法在不改变业务的情况下确定通用契约。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 缺运行环境时交付组件契约、样式入口、可检查代码或修正片段及逐页验证步骤。
- 只有截图时先给稳定职责与差异清单，不凭截图承诺原生注册、插槽或渲染器兼容。

## 执行要求

按微信原生组件的能力检查实现。使用跨端框架时，进一步核对生成代码和框架适配，不能直接照搬浏览器或 Vue 的样式规则。

1. 先列出组件必须完成的业务任务、调用方负责的数据与内部展示状态。比较多个页面的共同部分和真实差异，只抽取已经稳定的职责；不要把整张业务页面塞进一个参数繁多、难以理解的通用组件。
2. 检查页面及组件 JSON 中的声明，确认引用名称和实际路径一致。为属性建立名称、类型、默认值及空值约定，核对数据能否在当前环境传递；非法输入要有清楚的处理，不依赖隐式转换掩盖接口错误。
3. 按内容扩展需求选择默认插槽或命名插槽。需要多个插槽时核查 multipleSlots 配置，并说明每个插槽负责的区域及为空时的表现；业务事件的名称和返回字段应稳定且与调用方用法对应。
4. 按官方文档检查样式选择器及 styleIsolation 设置，识别页面样式穿透组件、组件污染其他页面和继承属性变化。不能为修好一个样式问题就全局开放共享，先定位实际受影响的类与节点。
5. 通用组件需要允许定制时，优先设计明确的外部样式类入口，并列出哪些外观允许调整。避免调用方依赖组件内部层级或未约定的祖先样式；若启用虚拟节点，检查根节点布局、class 与 style 的实际生效位置。
6. 在至少两个真实使用页面验证正常数据、空数据、长中文文本、禁用状态、插槽缺省和局部样式覆盖。对已声明支持的渲染器及基础库环境分别记录结果，检查事件次数和数据回传是否符合调用契约。

## 交付与验收

输出：组件职责说明、属性与事件表、插槽和样式入口、组件实现及复用验收结果。没有运行环境时只给可检查的实现和验证步骤，标明兼容性待测；需求只出现一个使用场景时说明抽象依据，不虚构更多业务来证明组件通用。

### 本条完成检查

- 明确组件职责、属性类型和空值、事件次数及载荷、插槽和允许调整的样式入口。
- 在真实使用页面验证空数据、长中文、禁用和局部覆盖；只有一个场景时说明限制，不假造复用证据。
- 分别记录已支持基础库和渲染器的结果，确认组件不污染相邻页面且回传数据符合调用方。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

官方来源（2026-09-08 核验）：
- [腾讯微信《微信小程序：组件模板和样式》](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/wxml-wxss.html)

## 任务目标

请为当前 Vue 工程接入或审查前端规范检查。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

规范治理范围：优先检查当前变更涉及的 Vue 文件与已有规范配置；没有改动清单时先盘点实际生效规则和代表模块问题，明确要求接入或治理后再实施范围内修正。
工程或规范资料：读取依赖及锁文件、ESLint 与格式配置、Vue 单文件组件、提交钩子、CI 和已提供检查日志，自行识别版本兼容关系。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 核对 .vue 模板与脚本解析器、JS/TS、ESLint flat/legacy 配置及实际检查范围。
- 查阿里规则包的真实导出和依赖要求，分清已有约定、公开规则与项目补充。
- 比较业务源码、测试、生成文件的排除方式及本地、提交前、CI 命令是否一致。
- 运行可用的非自动修复检查，将行为风险、维护问题和格式差异按模块归并。

### 可采用的默认处理

- 默认只读审查配置和问题；明确治理时仅修当前范围，保留未提交工作，不整仓格式化。
- 沿用兼容的版本及格式方案，不为接入品牌规则包而叠加工具，不猜不存在的 Vue 配置导出。
- 生成产物可合理排除，真实业务代码不能扩大 ignore 掩盖；历史告警与新增问题分开处理。

### 必须有依据的事项

- 现有团队规则互相冲突或所谓格式修复会改变业务输出，而工程没有依据决定应采用的行为。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 只有配置时交付兼容性差异、最小接入草案及目标文件覆盖核验方法。
- 没有执行环境时给真实可核对的配置建议与命令，不声称规则已经生效或扫描通过。

## 执行要求

先核对当前 Vue 工程、现有工具及待接入规则包的兼容关系，不预设不同版本提供相同导出，也不把 React 专属规则应用到 Vue。

1. 读取依赖清单、锁文件、构建入口、Vue 单文件组件和现有检查配置，列明实际版本与已生效的规则。先确认解析器能处理模板、脚本和 TypeScript，再判断需要增加什么，避免重复安装同类工具。
2. 核对阿里规则包的实际导出、依赖范围和接入示例。选择与本工程兼容的接入方式，说明哪些使用公开规则，哪些沿用已有约定，哪些是本次业务补充。资料无法证明的 Vue 配置名称不要猜写。
3. 把检查范围划分为业务源码、测试、配置和生成产物。对生成文件及构建目录合理排除，对真实业务文件保留检查，避免用大范围忽略掩盖新增问题。检查提交前脚本是否会修改不在本次任务中的文件。
4. 运行已有检查并建立问题清单，按潜在行为错误、可维护性问题和纯格式差异区分。逐项指出具体文件和触发规则；同一根因合并解释，不把所有告警都列为高风险故障。
5. 先处理改动范围内问题，保持接口、页面文字和业务计算结果稳定。对需要改变运行行为的修复写明输入、原结果和新结果，不能混在批量格式化中。历史问题按模块安排，避免一次扫描演变成整库重写。
6. 检查本地与持续集成采用的版本、命令和文件范围是否一致。复核自动修复后的差异，针对涉及行为的改动运行相关测试和页面操作；只调整格式时不额外编写与实现重复的测试。

## 交付与验收

输出：环境与适用规则表、最小配置改动、按模块归类的问题、实际执行结果和未解决项。每个结论标明已验证或待验证，不能用“扫描完成”代替“检查通过”。没有代码或执行环境时，给出可落地配置方案及需要补充的最少信息，不声称已经接入。

### 本条完成检查

- 列出环境、实际生效规则及适用边界，确认模板、脚本和本次业务文件进入检查。
- 交付按模块归类的问题与最小配置改动，行为修复说明前后结果，格式修复不夹带业务变化。
- 复核最终差异及本地与 CI 一致性，给实际执行结果、历史失败和剩余项，不以扫描完成替代通过。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

官方来源（2026-09-08 核验）：
- [阿里巴巴《阿里巴巴前端规约：ESLint 配置说明》](https://github.com/alibaba/f2e-spec/blob/main/packages/eslint-config-ali/README.md)

## 任务目标

请审查 Redis 客户端的超时重试策略，并设计符合业务语义的幂等处理。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

重试业务：从当前问题或代码中识别使用 Redis 重试的业务操作；留空时优先检查递增、入队或带过期语义的写入，选一条有客户端和业务双层重试的完整链路。
代码与故障资料：读取 Redis 客户端依赖、连接与命令超时、业务重试封装、请求总时限和已有异常样本，版本与方法语义从实际工程确定。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 追踪客户端、Service、网关与任务层的重试入口及次数。
- 识别命令执行、响应接收和业务确认的边界，找结果未知的处理代码。
- 核对业务请求标识、判重记录、保留期、结果查询及并发覆盖条件。
- 读取现有故障测试和每层超时配置，计算最坏请求次数及总耗时。

### 可采用的默认处理

- 默认只读形成命令重试决策，不直接调整重试次数或扰动 Redis 连接。
- 无法判断是否执行的写操作归为结果未知，不按连接异常一律重发。
- 缺负载数据时按已知总时限列预算公式与停止条件，不指定所谓通用最优退避值。

### 必须有依据的事项

- 重复执行对计数、队列、费用或过期时间的业务后果不明时，不认定该写操作可以安全重试。
- 业务请求唯一性、判重有效期或超时后的合法恢复动作缺少依据时，不承诺端到端幂等。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 无代码时交付按命令语义分类的重试决策样例，以及多层放大和时间预算的计算模板。
- 无故障环境时提供发送前断开、执行后丢响应和并发旧值覆盖的隔离桩测试方案。

## 执行要求

适用范围：Redis客户端重连与业务重试；先确认客户端及版本，连接重试和命令重试分开处理。厂商示例参数不能当作本项目推荐值。

将命令已执行但响应超时纳入分析，审查重试的幂等性，并防止多层重试放大请求。

检查步骤：
1. 列出哪些异常发生在连接、发送、执行或接收阶段，按现有证据区分确定未执行、确定执行和结果未知；网络超时本身不能证明写操作没有成功。
2. 逐条按业务结果审查命令重复执行的影响，特别检查递增、入队、计费和带过期语义的写入；即使命令形式相同，也要评估并发新值被旧请求覆盖的风险。
3. 追踪客户端、业务方法、接口网关和任务调度层是否各自重试，计算最坏请求次数与总耗时；为每个操作指定唯一的重试责任层。
4. 为可重试操作定义总期限、次数、退避及随机扰动，结合剩余预算和业务重要性决定何时停止；参数待压测时给出推导方式，不编造固定最优数值。
5. 对非幂等或结果未知的操作，设计业务请求标识、状态查询或对账路径，说明判重记录的生命周期与故障边界；不得仅套一把锁就宣称端到端恰好执行一次。
6. 仅在隔离测试环境或已明确授权的生产演练中验证发送前断开、执行后丢响应、主备切换及连续失败；优先使用代理或桩模拟故障，不扰动普通生产连接，记录业务动作次数、最终状态、请求耗时和重试放大量；验证恢复后积压不会再次冲击系统。

## 交付与验收

输出要求：交付命令重试决策表、重试责任与预算、最小代码或配置、结果未知处理流程及故障用例。决策表写明“可重试条件｜重复后果｜停止条件｜人工或自动对账入口”。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 每类操作明确可重试条件、重复后果、责任层、总预算和停止条件。
- 结果未知有业务标识与查询或核对路径，不能仅以锁或重连成功证明幂等。
- 测试核对业务动作次数、最终状态和重试放大量；未执行的故障注入不写已验证。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里云《Tair：客户端重试指南》](https://help.aliyun.com/zh/redis/use-cases/retry-mechanisms-for-redis-clients)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请评审 MySQL SQL 与组合索引的上线方案。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

查询与索引：优先采用当前慢查询或待改 SQL；留空时从目标模块的高频列表、关联与分页语句中选取有执行计划或调用证据的一组查询，保留未改索引的基线。
工程与查询资料：从 Mapper XML、迁移 DDL、现有索引和测试样例读取 SQL 与绑定参数，结合已有执行计划、查询指标及数据库版本信息展开审查。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 追踪查询对应的业务过滤、租户权限、排序稳定性与最大结果量。
- 读取字段与绑定参数类型、现有组合索引及其被哪些 SQL 使用。
- 对照代表性参数、已有执行计划和数据分布，识别热门值、空值与深分页差异。
- 检查候选索引对写入、存储和其他查询的影响，以及已有迁移审查方式。

### 可采用的默认处理

- 默认只读评审，输出候选 SQL 和最小 DDL，不实际创建或删除索引。
- 缺计划和分布时先审查语义、类型及索引复用，性能结论保持条件化，不执行可能有成本或副作用的实际分析。
- 保留权限过滤、稳定排序及不改索引的基线，不自动接受云平台优化建议。

### 必须有依据的事项

- 查询应返回的数据范围、排序或分页业务含义无法确定时，不采用可能改变结果的 SQL 改写。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 只有 SQL 时交付语义与类型检查、附前提的候选索引及获取代表性执行计划的方法。
- 无 SQL 时提供参数分布、索引复用与读写成本的评审表和同数据负载的对比用例。

## 执行要求

适用范围：MySQL表与查询，具体优化能力以MySQL版本及存储引擎为准。阿里云自动优化是有产品前提的可选能力，不默认启用。

结合实际 SQL 评审索引，检查局部优化是否会使全局性能变差。

检查步骤：
1. 明确查询要返回的业务数据，记录租户或权限条件、排序稳定性、分页方式和最大结果量；先核对SQL语义，不能为速度删掉业务过滤条件。
2. 检查字段类型与参数类型是否一致，梳理等值、范围、关联和排序的组合；索引是否有效以目标版本计划验证，不把函数、非等值等语法一律认定无索引可用。
3. 读取现有计划和代表性参数，比较估算行数、实际可得的扫描信息及返回量；数据分布未知时提出采样方法，说明空值、热门值和历史数据可能改变选择性。
4. 提出最少数量的候选索引与改写方案，逐项说明服务哪些高频SQL、可否复用已有索引以及对写入和空间的影响；保留不改索引的基线方案。
5. 在相同数据与负载下比较正常参数、极端参数和深分页场景，核对返回结果一致；除目标查询延迟外，观察更新耗时、并发吞吐和资源使用。
6. 给出上线顺序、观察窗口及回退条件，索引创建与删除分开说明；如果有DAS建议，先判断其证据和适用范围，不把平台建议直接当成已批准变更。

## 交付与验收

输出要求：按SQL清单、证据、候选方案对比、最小DDL和验证计划输出。所有性能结论给出测量条件，未执行的优化只写预期；新增字段时必须补齐详细中文COMMENT。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 候选索引逐一关联服务的 SQL、复用机会、写入和空间代价。
- 验证结果集与权限一致，再比较正常、极端参数和深分页的性能。
- 建议注明版本、数据与测量条件，创建删除分别评估，未执行 DDL 不表述为已优化。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[腾讯云《云数据库 MySQL 使用规范》](https://intl.cloud.tencent.com/zh/document/product/236/13390?lang=zh)
[阿里云《RDS MySQL 自动SQL优化》](https://help.aliyun.com/zh/rds/apsaradb-rds-for-mysql/use-the-automatic-sql-optimization-feature-for-an-apsaradb-rds-for-mysql-instance)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请检查 Java 审批状态分支，并设计业务测试。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

审批流程：从当前需求或状态异常定位审批操作；留空时扫描现有审批 Controller、Service 和状态枚举，选择一条包含角色判断与状态写入的流程进行检查。
工程与审批规则：读取状态枚举、分支代码、权限定义、条件更新 SQL、现有用例及业务说明，自动还原实际迁移路径和版本。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 将入口操作、角色、对象归属和状态枚举对应到具体分支。
- 检查 switch 默认分支、复合条件顺序、未知和历史状态的处理。
- 追踪数据库条件更新、版本字段、唯一约束和外部动作，识别重复与并发覆盖。
- 对照现有测试和业务说明，分别记录代码现状与已确认规则。

### 可采用的默认处理

- 默认只读检查和测试设计，给保持行为的最小整理建议，不自动新增审批步骤。
- 规则缺失时描述当前代码行为并标记待确认，不把现有分支直接当成已批准的业务规则。
- 未知状态不默认放行，权限、短路顺序和副作用按现有可信契约保留。

### 必须有依据的事项

- 合法状态迁移、批准角色或对象归属规则没有可信依据时，不编造最终状态与越权测试的业务预期。
- 重复审批、撤回或并发竞争应由哪个操作生效不明确时，不擅自决定状态覆盖策略。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 有代码无规则时交付实际分支覆盖图、冲突与遗漏证据，以及业务预期待确认的测试表。
- 无工程时给状态迁移表、条件组合与重复并发测试模板，示例角色和状态仅用于说明方法。

## 执行要求

适用范围：Java实现的有限业务状态与条件分支；状态迁移、权限和幂等策略以业务规则为准，不能按通用审批流程擅自补业务。

保持条件表达式易于理解，明确 switch 中未匹配情况的处理方式和各分支结束条件。

检查步骤：
1. 从业务资料整理状态迁移表，逐项记录起始状态、操作、角色、前置条件和终止状态；资料与代码冲突时列明两种行为并指出需要确认的事实。
2. 将每条合法迁移对应到实际代码路径，检查条件顺序是否遮蔽后续规则，以及缺少字段、未知枚举和历史状态会进入哪一条路径。
3. 为复合判断建立条件组合，找出权限、状态和数据归属之间的联动；不为追求代码简短而改变短路顺序或触发原先不会发生的副作用。
4. 检查重复提交和并发操作是否可能把状态覆盖回旧值，明确数据库约束或更新条件如何保障业务结果；未提供持久化代码时不得认定并发安全。
5. 给出保持行为的分支整理与需要业务决定的行为修正，分别列出改动；替换复杂判断时使用业务含义清楚的命名，不为了形式增加无用抽象。
6. 根据迁移表生成正常、拒绝、越权、重复、并发和异常测试，测试应观察数据库状态、外部动作次数与响应；说明哪些属于单元验证、哪些需真实集成环境。

## 交付与验收

输出要求：依次提供状态迁移表、遗漏和冲突清单、最小代码修改、测试矩阵。每个测试使用“初始状态｜角色与归属｜操作及并发条件｜预期最终状态｜可观察证据”。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 每条迁移列出起始状态、操作、角色、前提和目标状态，并关联代码证据。
- 区分保持行为的整理与需要业务决定的修正。
- 测试观察数据库最终状态、响应及副作用次数，持久化代码缺失时不声称并发安全。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里巴巴《P3C-PMD 官方公开规则》](https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请检查 Java 日期、时区转换与统计周期的边界。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

时间字段或周期：优先检查当前报表或日期异常；留空时从格式化、日期范围查询和统计分组中选择一条同时涉及接口与数据库的时间转换链。
工程与时间资料：读取字段类型、序列化与格式化配置、SQL 区间、数据库迁移和现有测试，自动核对 Java 版本、应用时区及已声明的业务周期。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 追踪前端、请求、Java 对象、数据库和导出的时间单位与表示方式。
- 检索日期格式、默认时区、秒毫秒转换、共享可变格式化器及系统当前时间调用。
- 读取日报月报 SQL 的上下界与业务统计分组，核对跨年周所属年和日历年。
- 查找字段注释、历史迁移、测试时钟和既有跨年、闰日用例。

### 可采用的默认处理

- 默认只读检查，不更改全局时区或批量转换历史数据。
- 工程未声明业务时区时明确保留未知，示例使用显式标注的时区，不按中文环境推断统计口径。
- 用固定时间构造边界样例；候选区间可说明左闭右开优势，但不替换已有业务约定。

### 必须有依据的事项

- 字段代表时间点、本地日期还是时长，以及既有历史数据的时区解释不明时，不自动转换或回填。
- 结算或统计周期、截点和首尾包含规则没有依据时，不自行制定报表预期。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 无工程时交付时间字段字典与跨年、月末、闰日、秒毫秒和多时区样例表。
- 缺业务周期时先检查格式与线程安全，区间样例列条件化结果并标明尚不能判定的统计口径。

## 执行要求

适用范围：Java日期时间处理及数据库、前端之间的数据转换；使用java.time时需JDK8及以上，旧接口替换须保留既有时区与业务语义。

区分日期格式中的日历年与周所属年，检查旧格式化器的线程安全。

检查步骤：
1. 逐个识别字段表示的是时间点、本地日期、本地时间还是持续时长，注明单位与来源；账期、截止日期和事件发生时间不能仅凭字段名相互转换。
2. 追踪前端、接口、Java对象、数据库到导出文件的转换链，查找默认时区、隐式格式、秒与毫秒混用，以及同一字段在不同入口中使用不同解释。
3. 针对年末年初构造跨年样例，核对格式化、分组、排序和文件名称是否属于正确日历日期；仅在业务确实按周核算时使用周所属年语义。
4. 检查日报和月报的区间边界，明确定义起止是否包含，避免相邻周期重复或漏记；若涉及多个时区，补充本地一天对应的实际时间范围。
5. 核对日期工具对象是否被多线程共享、是否可变、是否依赖服务器当前时间；给出可注入业务时钟的改进范围，让测试不依赖执行当天。
6. 覆盖跨年、月末、闰日、时区转换、缺失时间及夏令时适用地区，分别验证展示和统计结果；若业务只使用固定时区，清楚说明无需扩展的范围。

## 交付与验收

输出要求：输出时间字段字典、转换链、缺陷及修复建议、边界样例表。样例写明输入、业务时区、期望日期或区间以及实际结果，保留对历史数据解释和接口兼容性的说明。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 转换链逐处说明类型、单位、格式和时区，不混同本地日期与时间点。
- 边界用例具有输入、业务时区、预期区间和实际结果。
- 修正建议说明历史数据与客户端兼容，未定义的统计业务不编造验收结果。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里巴巴《P3C-PMD 官方公开规则》](https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请审查 Java 异常处理与事务结果的一致性。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

事务业务操作：从当前异常或写接口定位操作；留空时选择一条同时包含数据库写入与消息、缓存或远程调用的链路，核对用户看到成功的时点。
工程与异常资料：读取业务方法、调用方式、事务管理器与配置、异常类和全局处理器、数据库操作及已有故障测试，自动确定框架版本与回滚行为。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 按顺序追踪校验、数据库变更、消息、缓存和远程调用的可逆性。
- 核对事务代理、自调用、传播、管理器和 rollbackFor 等实际配置。
- 检查 catch、finally、提前返回和统一响应包装是否吞掉原始失败。
- 查找提交后任务、重试、补偿、查询与幂等处理及现有故障样例。

### 可采用的默认处理

- 默认只读审查并提供最小修复片段，不改异常码、事务边界或执行外部副作用。
- 远程超时归为可能结果未知，不假设本地回滚能撤销外部操作。
- 框架行为以实际配置和调用链为准，缺运行证据时将回滚效果列为待测。

### 必须有依据的事项

- 用户可见成功的业务定义、允许的部分完成或补偿结果不明确时，不自行把失败转换成成功。
- 外部动作能否查询、撤销或幂等重试的契约未知时，不设计会重复扣款或重复履约的恢复动作。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 无工程时交付按失败位置划分的事务结果矩阵和可控故障测试样例。
- 有代码无环境时输出异常传播与事务边界证据，列出核对最终数据和副作用次数的执行步骤。

## 执行要求

适用范围：Java业务写操作及显式或框架管理的数据库事务；回滚条件必须核对实际框架配置，远程调用和消息不会自动随本地数据库回滚。

结合代码上下文检查异常后的回滚；注意 finally 中的返回可能遮蔽原有结果。

检查步骤：
1. 以一个真实业务操作为单位，按顺序列出校验、数据库变更、消息、缓存和远程请求，标明每个步骤的可逆性，以及用户看见成功的确切时点。
2. 核对事务边界、调用方式和异常到达的位置，分别模拟校验失败、数据库失败、外部超时及运行时异常；不要只看到事务注解就认定回滚一定生效。
3. 检查异常捕获后是否继续执行、改写返回值或丢失原因，区分可以转成业务结果的失败与必须向上交付的技术失败，保留定位问题所需的最少上下文。
4. 对数据库已提交而外部动作失败的情况明确结果，评估幂等重试、补偿和状态对账是否能恢复；对外部成功但响应超时的情况标记结果未知，避免直接重复副作用。
5. 提出能保留现有契约的最小修改，说明异常类型、返回码和事务配置如何协同；只给项目适用的机制，不为了套用模式拆分无必要的微服务。
6. 用可控故障点验证关键步骤，核对数据库最终状态、外部动作次数及用户响应；列出未覆盖的网络分区或并发场景，以及上线后的异常监测和补偿入口。

## 交付与验收

输出要求：按业务步骤表、异常传播图的文字说明、问题清单、修复片段和故障用例交付。每个用例必须包含初始状态、注入故障、最终数据和预期响应，不能用“未报错”代替一致性结论。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 每个风险关联业务步骤、异常位置、事务结果及用户响应。
- 修复建议保留现有契约并解释数据库提交与外部动作不同步的窗口。
- 用例包含初始状态、故障点、最终数据与响应，不以未报错判定一致性。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里巴巴《P3C-PMD 官方公开规则》](https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请审查 Java 集合视图、转换与批量处理代码。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

集合处理链：优先检查当前集合异常或批量接口；留空时从切片、数组转换、去重与批量组装代码选择一条存在共享或变更行为的处理链。
工程与数据样例：读取集合创建和消费者、接口输入、业务键、分页与并发代码、依赖版本和现有边界测试，自动归纳数据规模证据。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 追踪原集合、subList 等视图、独立副本与缓存引用的拥有关系。
- 检查数组与列表转换、增删替换、遍历修改和对象加入后再变更的行为。
- 核对去重键、排序、重复项保留及分页计数的实际契约。
- 读取批次边界、全量加载、中间副本及并发共享路径，核对 JDK 与集合库能力。

### 可采用的默认处理

- 默认只读给最小替换建议，不统一改 Stream、并行集合或不可变类型。
- 没有业务去重和顺序定义时保留输入顺序与重复语义，不按对象名称猜业务键。
- 没有规模记录时对持有副本和峰值内存列计算条件，不虚构耗时。

### 必须有依据的事项

- 业务顺序、重复项或缺失关联应如何处理不明时，不选择会改变输出的去重或批量策略。
- 共享集合是否允许实时可见变更及复合操作原子性不明确时，不以换集合类决定并发语义。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 无工程时交付视图与副本、转换及遍历变更的可运行边界样例和关系说明。
- 无大规模数据时给批次与内存估算模板，列空集合、重复、空元素、源变更和并发验证条件。

## 执行要求

适用范围：使用Java集合的业务模块；不可变集合工厂、Stream及第三方集合的能力需匹配JDK与依赖版本。

核对集合视图与原集合的关联，以及具体集合对遍历修改和数组转换的支持。

检查步骤：
1. 标出每个集合的创建者、拥有者、读写方和生命周期，区分原始数据、分页视图、独立副本和缓存引用；指出在哪一层修改可能影响另外一个业务调用。
2. 用真实调用路径检查分页切片、数组转列表和列表转数组，分别验证能否增加、删除、替换及强制转换；将依赖具体实现的假设改为明确契约。
3. 检查筛选与去重是否保持业务要求的稳定顺序，以及重复记录按哪个业务键识别；若对象在加入集合后继续修改，核对后续查找和结果是否仍正确。
4. 评估批量规模，区分一次全量加载、分批读取和流式处理；估算同时持有的数据副本与中间结果，容量结论注明来源，不根据循环层数臆测实际耗时。
5. 检查并发共享是否存在可见性或写入冲突，说明快照、加锁、分段处理等候选方案各自改变的语义；不要仅更换集合类就宣称业务操作整体原子。
6. 提供覆盖空集合、单元素、重复、空元素、源集合变更及大批量输入的验证用例；并发场景必须定义可重复观察的结果，记录未执行的压力验证。

## 交付与验收

输出要求：交付集合关系说明、缺陷表、最小替换代码和验证矩阵。每处修改说明是否保留原有顺序、重复项和共享语义，另外列出峰值内存估算的假设与需要采集的指标。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 每项缺陷说明创建者、修改者、触发输入和受影响调用。
- 替换建议明确是否保留顺序、重复项、共享关系和批量失败语义。
- 验证包含源集合变更与边界输入，容量和并发结论注明实际执行范围。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里巴巴《P3C-PMD 官方公开规则》](https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。

## 任务目标

请排查 Java 空值传播与包装类型的边界问题。

以核查和评审为主，给出有证据的判断及可复核的修改建议；本次用户另有明确实现要求时，按其授权范围执行。

## 输入信息（选填）

两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。

空值字段链：从当前空指针或字段异常定位输入；留空时优先扫描可空包装类型参与算术、判断和返回的位置，选择一条能追踪到请求或数据库来源的链路。
工程与字段资料：读取 DTO、实体、DDL、映射、远程接口契约和边界用例，自动确认字段可空性、序列化与实际 JDK 依赖。

## 信息不完整时

先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。

### 优先确认

- 沿缺字段、显式 null、无记录和外部不完整响应追踪到业务运算及展示。
- 检索包装类型比较、自动拆箱、集合元素及默认值转换。
- 核对数据库可空、入口校验、字段注释和响应模型是否一致。
- 读取对象值相同但实例不同、正常值与空值的既有测试。

### 可采用的默认处理

- 默认只读排查并给修复片段，不批量把 null 改为零或空字符串。
- 业务含义缺失时保留未知与合法零值的区别，已有契约优先。
- 对无源码依赖按声明契约和输入样例分析，不编造其内部返回保证。

### 必须有依据的事项

- 空值代表未知、未提供、关闭还是无记录缺少业务定义时，不替用户决定默认值或改变公共字段类型。

只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。

### 资料仍不足时的交付

- 无工程时交付空值传播与包装比较的独立测试样例，以及入口、映射和运算层的校验选择表。
- 仅有字段定义时先完成空值语义疑点和边界请求矩阵，触发路径保留待验证。

## 执行要求

适用范围：使用Java对象、包装类型和常见持久化框架的业务代码；具体映射和校验行为以JDK与依赖版本为准。

检查包装值比较和自动拆箱中的空值风险，不假定远程调用或数据库查询总能返回值。

检查步骤：
1. 画出目标字段从请求、查询或远程响应到业务计算、持久化及展示的传播路径，区分未提供、未知、无记录、零值和空字符串，不能把所有情况自动合并。
2. 找出可空值参与比较、算术、条件判断、方法返回和集合操作的位置，为每个疑点指出确切输入及可能结果；对无源码依赖只列待验证的接口契约。
3. 检查默认值是否改变业务事实，例如未知计数被展示成零、未提交配置被当成关闭；将需要拒绝输入、保留为空或业务兜底的场景分别列出理由。
4. 对对象比较与集合元素给出包含空值、相同值和不同实例的样例，检查现有结果是否稳定；避免只针对小范围数值验证而遗漏实际业务标识。
5. 提出最小修复，明确校验应放在入口、转换层还是计算前；说明对已有数据和外部调用方的影响，不为消除异常随意改变公共字段类型或业务默认值。
6. 设计能区分修复前后行为的测试，覆盖缺字段、显式空值、查询无记录、远程返回不完整和混合集合；同时保留正常业务样例，记录真正执行的结果。

## 交付与验收

输出要求：先给空值语义表，再给风险清单、修正代码与测试矩阵。每个风险须给出“来源字段｜传播路径｜触发输入｜错误业务结果”，无法重现的项目保持待验证状态。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 风险表包含来源字段、传播路径、触发输入和错误业务结果。
- 修复建议说明校验位置、旧数据与调用方兼容性，不以消除异常掩盖未知事实。
- 用例覆盖缺字段、显式空值、无记录、外部缺项与混合集合，并保留正常样例。

按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。

## 参考资料与适用边界

来源（核验日期：2026-09-08）：
[阿里巴巴《P3C-PMD 官方公开规则》](https://github.com/alibaba/p3c/blob/master/p3c-pmd/README.md)

整理范围：仅依据上述公开文档的相关建议，业务场景、变量、检查流程与验收格式均为独立改写，不代表相关企业完整内部规范。