阿里巴巴

## 任务目标

请完成选定 Vue 页面或模块的性能、状态一致性与交付质量优化，先测量问题，再落地代码并验证。指标未给出时先记录基线并提出与场景相符的目标，不虚构响应时间、提升比例或用户规模。

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

## 输入信息（选填）

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

优化对象或现象：优先定位对话中提到的慢操作或状态错乱；未描述现象时，从当前页面的首屏、筛选、分页和编辑切换建立基线，先处理可复现的状态错误和重复请求。
工程或复现资料：使用已确认工程的路由、组件、请求封装、store、测试数据和现有性能记录；可运行时自行采集网络、渲染和构建产物证据。

## 信息不完整时

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

### 优先确认

- 核实 Vue 2/3、JS/TS、请求库、UI 库、路由缓存及现有 watcher 清理方式，不要求用户手填版本。
- 沿筛选、翻页和切换记录检查状态写入、请求取消、旧响应及 finally 的生效条件。
- 记录代表性操作的数据规模、模式、缓存、设备和网络条件，分开测量接口等待、重复请求、计算与组件更新。
- 检查模板循环、字典查找、资源导入、路由拆包和真实产物，确定优化影响范围。

### 可采用的默认处理

- 未给性能指标时先采集可复查基线，以消除已证实浪费且业务不回归为目标，不承诺任意提速比例。
- 优先局部状态、纯 computed 与必要副作用清理；未证实瓶颈前不引入虚拟列表、全局缓存或 memo。
- 保留当前分页、选择及字典语义，写请求超时显示结果待确认，不把取消请求当作撤销业务。

### 必须有依据的事项

- 优化涉及跨页选中、缓存失效或租户切换，而代码与接口无法确定需要保留的业务状态。
- 写操作结果未知且接口没有查单、幂等或补偿依据，不能自行重试并宣称提交成功。

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

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

- 无法运行页面时交付按代码证据排序的瓶颈候选、状态写入图和最小修正，另给同条件测量步骤。
- 没有代码时给出筛选竞态、重复提交、页面恢复的复现与验收用例，不填造耗时或包体数据。

## 执行要求

关注用户操作结果和可复查证据，不为了使用优化技巧改动系统架构。

### 读取工程并建立可比基线
确认目标目录、分支和 dirty 改动，保留原有内容，只改选定范围。核实 Vue 2/3、JS/TS、API 风格、构建框架、UI 库、store、路由、请求库和锁文件，保留选型，不默认升级或迁移。复现首屏、筛选、翻页、弹窗、切换记录等实际问题；记录数据规模、生产构建或开发模式、缓存状态、设备及网络。结合浏览器性能、网络、Vue DevTools 和构建分析，区分接口等待、重复请求、脚本计算、组件更新和资源加载；权限或数据错误优先于微小速度收益。

### 定位结构与状态责任
页面编排流程，业务组件承接领域交互，通用组件负责稳定通用契约，composables/hooks 管理组合式逻辑和清理，API 层统一请求契约，store 管理必要共享状态，types 与 styles 各归其位；按问题整理现有模块，不建空目录。纯无副作用函数进入 util，领域规则集中在业务模块，真正共用的响应式能力才复用。不要把数据、权限、表单和所有展示塞进万能组件或 util，也不为性能把所有状态搬入全局。

### 消除状态不同步
为查询条件、分页、选择项、表单和缓存分别确定唯一写入来源，派生值用 computed，props、事件载荷和 v-model 契约明确，不直接修改父级状态。检查路由返回、筛选重置、切换租户或记录、删除末页数据后的状态；分页和选择项的保留规则必须对应业务。编辑副本说明与源数据同步时机，避免双向 watch 相互回写。枚举和魔法值与服务端数据库码、权限及字典一致，已有字典继续复用，禁止复制另一套状态映射；失效缓存不得让旧权限或旧字典继续控制操作。未知或停用字典码保留原始值并作可识别提示，禁止映射为成功、首项或任意合法状态；编辑提交按真实接口契约处理，不为消除告警擅自改写原值。

### 处理请求竞态和副作用
快速输入、连续翻页、切换弹窗记录会形成并发请求。按当前请求库取消可取消的旧请求，同时用序号或请求条件快照保护结果、错误和 finally，确保过期请求不能覆盖当前内容或解除新请求的 loading；不同业务请求分别维护状态。取消客户端请求不代表服务端业务已撤销，写操作超时不能直接自动重试。watch 只监听必要源，避免无边界 deep 和回写循环；清理失效请求、监听、定时器与订阅。Vue 3.5+ 的 onWatcherCleanup 必须同步注册，低版本使用其支持的清理机制和生命周期；离开、卸载及缓存页面停用时按实际行为处理。

### 控制计算与渲染成本
v-for 采用稳定唯一的业务 key，排序和编辑列表不用索引、随机值或时间戳。将模板和循环中昂贵过滤、排序、格式化、字典查找移到有明确依赖的派生层；computed 保持纯计算，不夹带请求或状态修改。对重复查找按数据规模建立合适索引，注意索引随源数据更新。避免每项都发请求；优先真实可用的批量查询或服务端分页，没有接口时说明限制并控制并发，不伪造后端能力。检查 props 是否反复创建无意义新对象、组件是否无关更新；按证据减少渲染，不盲目 memo、深比较、shallow API 或缓存，防止失去必要更新。

### 按场景优化列表与资源
根据实测 DOM 数量、交互延迟和数据规模选择分页或虚拟列表，核验行高、滚动定位、选择项、键盘操作与 UI 库能力，不用固定条数一刀切。测量实际生产包、关键路由资源和重复依赖，按既有构建能力优化导入、路由懒加载及重资源加载时机；确保首个操作不会因拆包失败失效。移除代码或依赖前核查自动导入、动态路由、按需组件与注册入口。缓存明确键、有效期、失效条件及身份边界，不用长期全局缓存掩盖接口问题。任何优化都要有前后相同场景的记录，不能以依赖宣传体积代替实际产物。

### 完成可用的业务反馈
区分 loading、empty、error、成功及权限不足，失败不可显示成空数据，保留数据或清空数据按场景说明。正确区分 null、未提供、0、false 和空字符串。表单按输入、失焦与提交时机校验，错误就近展示并可纠正；服务端失败保留合理输入，弹窗关闭、重新打开不残留旧结果。提交时即时反馈并防重复点击，后端幂等键、唯一约束和事务仍由接口承担；没有后端能力时写明局限，不能把防抖当幂等。失败后给出真实可行的恢复路径，不吞错、不伪造成功。

### 把优化纳入既有规范
保持政企中文界面的层级、对齐、间距、表格密度、主次操作和反馈一致，不添加非业务口号与技术说明。命名清楚，注释解释业务原因、接口限制和性能取舍，不逐行注释。使用兼容版本的 ESLint、eslint-plugin-vue，TS 工程配套 typescript-eslint，并保留 .vue 与脚本解析器分工；沿用 flat/legacy 模式和现有 ESLint 或 Prettier 格式方案。统一空格、缩进、换行、引号、分号、导入及文件区块顺序，对齐 .editorconfig；兼容配置只解决格式职责冲突，不降低质量门槛。零新增 lint 违规，不用 disable、扩大 ignore、any 或 ts-ignore 隐藏问题，不整仓格式化制造无关差异。

## 交付与验收

### 验证结果并完成交付
实际执行相关 lint、适用的 typecheck、生产 build 和关键交互验收；JS 工程无类型检查时说明不适用，工具或环境缺失则标记未执行。至少覆盖正常与空数据、未知与停用字典码、接口失败与恢复、快速筛选翻页、旧响应晚到、连续提交、切换记录、返回页面和权限变化；验证表单失焦、弹窗焦点、中文换行及新产生的控制台错误。只在隔离且获准的测试环境模拟网络故障，不影响真实业务。性能比较保持设备、数据、模式及缓存条件一致，多次记录波动，分别列包体积、请求量、渲染或交互指标；改善不能以业务回归为代价，未改善也如实报告。

输出：①问题、复现及基线；②已实现改动与关键路径，说明结构、状态和请求规则；③实际生效的检查与格式配置；④优化前后指标和测量条件；⑤验收项目、命令或操作、结果及未执行原因；⑥剩余限制和最小后续工作。保留历史失败与新增问题的区分，未跑不宣称通过，没有测量不宣称提速。完成已授权实现，不只提交建议，不生成无关 Markdown 文档。

### 本条完成检查

- 记录问题、基线、实际修改和相同条件下的优化前后指标，未改善或未测量如实列明。
- 验收旧响应晚到、finally 竞态、快速分页、记录切换、权限变化及未知字典码，不以性能收益抵消业务错误。
- 执行相关 lint、适用类型检查、生产构建与关键交互，列出真实命令、结果和剩余限制。

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

## 参考资料与适用边界

官方依据：Vue 性能：https://vuejs.org/guide/best-practices/performance.html、Vue 监听清理：https://vuejs.org/guide/essentials/watchers.html、阿里前端规约：https://github.com/alibaba/f2e-spec、Vue 插件配置：https://eslint.vuejs.org/user-guide/、Prettier 与 Linter：https://prettier.io/docs/integrating-with-linters。

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

## 任务目标

请在真实 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 性能、幂等与可靠性优化。必须先查证瓶颈，再完成代码修改和验证；不能只提出缓存、异步或加线程的建议。资料可从工程获得时自行读取，仅对影响正确性的关键缺口提问，继续完成其余已授权工作。

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

## 输入信息（选填）

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

优化链路：优先选择当前对话指出的慢接口或重复执行问题；未指定时从当前 Java 工程的已有慢调用证据、循环访问和写操作中识别一条可定位、可验证的链路，说明选择依据后先完成该链路。
工程与性能资料：读取当前仓库的模块依赖、入口、SQL、事务、重试、已有测试和可用性能记录，自动确认版本、格式规则与验证命令，不要求用户重新填写这些信息。

## 信息不完整时

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

### 优先确认

- 沿入口追踪 SQL 与远程调用次数、循环取数、事务和锁范围，以及下游连接与线程资源。
- 读取业务幂等键、唯一约束、处理中记录、重试接管和结果查询实现，核对权限与租户范围。
- 检查实际 Maven 或 Gradle、MyBatis XML、数据库迁移、静态检查和格式配置。
- 查找代表性测试数据、已有压测结果、延迟与资源指标；没有实测时识别能够本地复现的访问模式。

### 可采用的默认处理

- 沿用现有版本、接口契约与中间件；先修正有代码或测试证据的重复工作，不默认加缓存、异步或线程。
- 缺负载数据时先记录调用次数、批量边界和可测指标，性能收益保留待测，不编造吞吐或最优参数。
- 保留稳定数据库编码与旧数据语义，XML SQL 和局部格式规则按原约束实施，限制本轮改动范围。

### 必须有依据的事项

- 同一业务意图的判定、同键异参处理或处理中接管规则没有可信依据时，不自行改变幂等业务结果。
- 批量改造会改变事务原子性、顺序、权限或外部副作用，而其业务容忍度无法确定时，暂停该项语义变更。

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

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

- 无工程时交付循环批量化与幂等状态的可执行示例、测量清单和故障用例，标明示例假设及尚未实施到项目。
- 缺运行环境时完成可执行的编译、静态检查和隔离回归，给出按同一数据与负载比较前后的测量步骤。

## 执行要求

以实际运行版本和部署约束为准，不默认升级框架或引入中间件。SQL全部放XML、编码与字典分工等是本项目硬约束；MyBatis支持SQL注解，本项目明确禁用。

1. 只读确定范围和基线。确认仓库分支、未提交改动、真实入口及调用链，记录权限租户、返回字段、顺序分页、事务原子性和错误语义。保护无关改动，先运行已有相关检查，区分原有故障。用代表性数据和请求记录SQL/远程调用次数、延迟分位、吞吐、错误、连接等待、CPU与内存，写明并发、样本、冷热状态和时间窗口。缺少监控只能标记假设，不能虚构瓶颈或收益。

2. 按证据选择最小改动。区分数据库扫描、N+1、远程等待、锁竞争、重复计算和大对象分配，列出根因证据、候选方案、代价和可回退点。优先修正错误访问模式与重复工作，不为局部变快改变业务结果或降低权限校验，不一次叠加多个难以归因的优化。涉及架构或接口变化时明确新旧兼容，先完成范围内可验证的修改。

3. 优化for中的数据访问。定位循环查库、远程调用、懒加载和对象转换暗含的请求，按租户及业务键去重批量取数，再使用有界映射组装；没有批量接口时评估有界并发及下游限制，不能改成无界并行。控制单批参数量、页大小、事务时长和内存，避免巨大IN与全表加载。保留重复项、顺序、缺失关联和错误语义；联表注意行数膨胀与分页计数，跨页修改要考虑稳定游标与并发变化。for清晰就保留，不一律改Stream或parallelStream。

4. SQL统一落在XML Mapper。MyBatis的全部SQL从Java业务层、SQL注解、Provider、字符串或SQL Builder/Wrapper中迁入XML，Mapper接口只留契约和必要参数绑定；核对namespace、参数、resultMap、主键回填和加载。值使用#{参数}绑定，动态列、表和排序方向须服务端白名单并由XML选择固定片段，禁止将用户值送入美元符文本替换。空集合、全空更新和条件缺失不能变成全表操作。依据真实执行计划和数据分布调整查询及索引，不能仅以语法或扫描告警判断性能。

5. 将幂等设计落实到持久化。明确“同一次业务意图”的业务键、租户与操作范围、参数摘要和保留期，用数据库唯一约束或等效原子条件及事务争用执行资格，先查后插只能辅助。区分首次执行、处理中、成功、确定失败和结果不明；同键同内容按契约返回既有结果，同键不同内容拒绝冲突。并发唯一冲突须查询归属正确的记录，先核对当前事务是否仍可用，不吞异常后假成功；缓存锁和前端防抖都不能替代业务唯一性。

6. 处理超时、重试及接管。客户端超时不证明服务端未提交，优先用业务键查询最终状态，未经确认不得换新键重做。按失败类型定义可重试项、次数、退避和总时限；死锁等重试要重建正确事务边界，状态不明先对账。处理中记录须有合法接管条件，避免超时后旧执行者仍能写入；必要时用版本或执行令牌拒绝过期持有者。跨租户查询及结果回放都要重新验证权限。

7. 验证事务和外部副作用。核对代理方式、传播、事务管理器、锁范围及回滚规则；默认代理模式下自调用不会触发被调方法的事务语义，但可能仍处于外层事务。受检异常是否回滚按配置验证，不让catch吞掉失败。数据库事务不覆盖远程扣款、发信或消息投递；按已有能力使用下游业务幂等键、结果查询、可靠事件或补偿，并覆盖本地提交与外部成功不同步的窗口。afterCommit回调不等于可靠投递，不能承诺跨系统天然恰好一次。

8. 控制资源和失败放大。避免持数据库锁等待慢远程响应；减少事务范围前先保持业务原子性，不能随意拆批提交。线程池、队列、连接池、超时和并发上限按负载及下游容量设界，正确传播并清理租户和追踪上下文，处理中断与取消。缓存必须说明权限维度、更新失效与一致性要求，不能把数据库故障降级成成功空结果；优化不能把压力转嫁给下游而掩盖本地指标。

9. 同步完成编码与结构标准化。消除状态、类型、阈值和业务字符串魔法值；稳定有限的数据库编码用显式code的enum，核对序列化和TypeHandler，禁止ordinal持久化及随名称变化改库值。可配置字典数据库为唯一来源，不手工重复维护enum加字典；常量和配置各按语义归属。保留旧值、停用值和未知编码，读取可标未知但不篡改原值，写入或状态迁移需受控校验。Controller管协议入口，Service管领域和事务，Mapper管持久化；DTO、DO、VO明确转换，禁止越权批量赋值。

10. 复用、清理与防御并行。只抽取已证实共性，纯通用函数才入Util，领域逻辑留领域Service，不建万能Util或无必要的泛型框架。检查null拆箱、空集合、重复键、金额精度、时间边界与不可信参数；异常保留原因和业务标识，脱敏记录且不假成功。删除无用及重复代码前核对反射、XML、SPI、扫描、序列化和配置引用。规整命名结构，为类、关键字段、枚举及方法写清晰Javadoc和业务原因注释；新增表全部字段及新增字段须用COMMENT或对应语法补齐中文数据库注释，详细说明含义、单位、编码、空值和默认值。格式仅用既有规则及单一工具处理本轮文件，禁止整仓无关格式化，不生成无关Markdown。

11. 用实际结果验收。运行编译、现有检查和必要回归，在隔离验证环境覆盖重复提交、同键异参、多线程争用、越权租户、未知编码、空输入、批量边界、事务回滚、提交后响应丢失、外部成功但本地未确认、重试及过期接管。既核对响应也核对业务记录、金额和副作用次数，禁止仅断言HTTP成功。记录实际执行与未覆盖项；没有执行条件时完成可执行检查，不填写通过。

## 交付与验收

对比并交付。在相同数据、并发、负载与观测窗口下对比修改前后延迟、吞吐、错误、查询次数和资源，不只报一次平均耗时；确认业务结果一致、尾延迟和下游未恶化。输出已改文件及原因、基线与证据、批量边界、幂等状态与唯一约束方案、事务及外部副作用矩阵、验证记录、回退和剩余风险。新增持久化结构使用项目既有迁移方式并验证历史重复数据与兼容回退；未实测不能声称性能提升，交付实际完成的修改而非待办方案。

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

### 本条完成检查

- 交付实际修改及证据，说明 SQL/远程调用、批量内存、事务和幂等约束如何变化。
- 验证同键异参、并发争用、超时未知、过期接管、租户越权和外部副作用次数，不仅检查 HTTP 成功。
- 有实测才比较延迟、吞吐和资源；没有实测则明确未证实收益，并保留回退与历史数据兼容说明。

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

## 参考资料与适用边界

官方依据（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）：已核对公开资料和本次项目要求的覆盖范围；尚未使用真实项目执行本模板或进行模型效果评测。具体改动、性能和回归结果须在目标工程中验证。

## 任务目标

请在当前目标工程中，完成本次模块范围内的 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）：已核对公开资料和本次项目要求的覆盖范围；尚未使用真实项目执行本模板或进行模型效果评测。具体改动、性能和回归结果须在目标工程中验证。

## 任务目标

任务：Vue 浏览器交付物敏感信息检查。基于所提供工程和业务证据完成检查，先读取可访问的工程与证据，可以推进的部分继续完成；仅对查证后仍影响结论的关键缺口提问；不要编造文件、日志、测量结果或已完成的操作。

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

## 输入信息（选填）

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

交付物检查范围：从当前 Vue 工程的生产构建入口和实际输出目录开始，检查源码配置到浏览器文件的传播；未指定线上地址时只做本地与已知授权路径核验。
工程或发布资料：读取构建配置、环境变量定义、现有 dist 等产物、静态发布规则及用户已经提供的可访问资源路径。

## 信息不完整时

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

### 优先确认

- 识别构建版本、环境变量替换前缀、HTML 注释、内联配置与 source map 输出方式。
- 追踪候选信息进入 JS、HTML、调试文件和旧制品的链路，并区分客户端标识与服务端秘密。
- 检查已知静态目录、备份文件和缓存策略；仅在授权范围内验证具体可获取路径。

### 可采用的默认处理

- 默认只读检查并输出脱敏证据，不展示真实凭据或使用凭据尝试登录。
- 没有公开访问证据只报告潜在暴露路径；公开接口地址和客户端 appid 不因名称相似就判定为密钥。
- 没有明确修复要求时只给最小改动及轮换处置建议，不擅自撤销凭据、改发布规则或清理线上缓存。

### 必须有依据的事项

- 候选字段的实际保密属性或允许公开用途无法由配置和使用方确认，不能直接定性为已泄露秘密。
- 所需外部访问超出已有授权范围时，不继续枚举；只对该部分保留公开性待核验结论。

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

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

- 没有产物时交付源码到构建替换的传播路径和应检查的产物位置，不声称浏览器已可获取。
- 没有工程时给出 HTML、JS、source map、旧版文件的定向核验清单及脱敏问题表格式。

## 执行要求

检查范围包括 Vue 源码、静态 HTML、JavaScript、source map 和部署配置。HTML 注释中的信息限制按文末规约核对；构建产物、调试文件与公开配置属于扩展检查，需要结合实际构建和访问证据判断。

检查 HTML 注释中是否包含凭据、个人信息、内部地址等敏感内容，并追踪它们是否进入可公开获取的文件。按项目实际版本和发布方式判断暴露范围，不机械沿用旧示例。

1. 确认构建版本、实际输出目录和公开发布的文件范围，把开发源码、服务器私有文件、浏览器可获取文件分开；没有访问证据时只报告潜在暴露路径，不宣称已发生泄露。
2. 在HTML注释、内联配置及前端源码中查找可能敏感的类别，记录文件位置和信息类型，交付报告只给脱敏摘要；公开接口地址或可公开的客户端标识不能仅因名称像密钥就判为秘密。
3. 追踪疑似字段如何从环境变量、配置文件或构建替换进入客户端产物，核对实际构建结果；不要认为环境变量保存在服务器上，就必然不会被打进前端代码。
4. 检查source map、旧版文件、备份后缀和静态目录规则能否使原本未计划交付的内容被获取，仅核验授权范围内已知路径，不进行无边界的互联网枚举。
5. 提出移除敏感输入、转为服务端调用或修正发布范围的最小方案；若证据表明确有凭据暴露，将撤销和轮换列为专门处置事项，不能只删除注释后宣称风险消失。
6. 重新构建并核对新产物、静态服务与缓存中的可获取内容，验证受影响业务仍能正常调用；以同一个匿名样本标记验证链路，不用真实密码验证是否还会出现在输出中。

## 交付与验收

输出：按候选信息、可信程度、来源到公开面的传播路径、最小修正和验证证据输出。问题表仅保留字段名、脱敏标记、文件位置及影响；明确哪些内容已确认公开可取、哪些尚未实际访问，以及缓存和旧制品的复核范围。

### 本条完成检查

- 每个候选给出类型、脱敏标记、文件位置、传播链和已证实或待确认的公开范围。
- 对确认暴露的秘密区分代码移除、凭据轮换和缓存旧制品复核，不能仅删注释即宣布消除风险。
- 若实施修正，使用匿名样本复核新产物及业务调用，并如实记录尚未检查的发布面。

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

## 参考资料与适用边界

来源核验日期：2026-09-08。
- 阿里巴巴《f2e-spec：HTML 编码规约的注释信息限制》：https://github.com/alibaba/f2e-spec/blob/beb1ac899ea6dab206331263bbcdcad8f8fe336e/docs/coding/html.md

验证说明：已核对上述公开来源及具体规则或能力；本模板尚未通过模型对比实验或线上业务实测，不能以来源品牌、仓库热度或扫描分数代替验收。

来源许可说明：MPL-2.0（仓库许可）。本条为中文原创整理，来源内容与本模板补充要求已在正文区分。

## 任务目标

请为当前 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)

## 任务目标

请检查 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 ThreadLocal 上下文传递及租户隔离。

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

## 输入信息（选填）

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

上下文链路：从当前请求或异步任务定位上下文；留空时扫描自定义 ThreadLocal、过滤器和线程池，选择一条能追踪到数据库或缓存访问的复用线程链路。
工程与隔离资料：读取上下文类、身份过滤器、任务包装、线程池、鉴权与持久化代码及相关测试，自动确认运行版本和实际存在的用户或租户维度。

## 信息不完整时

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

### 优先确认

- 盘点上下文字段的可信写入来源、读取消费者和清理位置。
- 追踪正常、异常、提前返回、重复分发及嵌套切换后的恢复。
- 核对异步提交时的取值快照、定时任务身份和工作线程清理责任。
- 将上下文追踪到 SQL 过滤与缓存 Key，读取已有连续任务隔离测试。

### 可采用的默认处理

- 默认只读检查，不关闭权限过滤或新增项目不存在的租户模型。
- 缺上下文不默认使用上一次任务或管理员身份，具体拒绝方式沿用可信契约。
- 测试使用匿名用户和最小上下文字段，生命周期候选优先显式传参或受控包装。

### 必须有依据的事项

- 用户、租户或组织的可信身份来源与合法数据访问范围不明时，不能认定隔离通过或自行制定默认身份。
- 定时或异步任务合法代表哪个主体执行不明时，不自动继承调用线程或全局管理员权限。

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

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

- 没有工程时交付上下文生命周期表和同线程先后执行不同身份任务的隔离用例。
- 有上下文代码但无数据层时先指出残留路径，给 SQL 与缓存范围取证点，不宣称数据隔离已验证。

## 执行要求

适用范围：使用ThreadLocal、请求上下文或线程池的Java项目；仅在项目实际存在租户模型时检查租户，不能凭空增加业务隔离维度。

在线程复用场景中，检查自定义 ThreadLocal 是否在使用结束后清理。

检查步骤：
1. 列出所有上下文字段的写入来源、读取位置和清理位置，标注由认证结果生成还是直接来自请求参数；明确客户端传入标识不能自行证明其访问权限。
2. 沿一次请求追踪正常、异常、提前返回和重复分发路径，检查每条路径结束时上下文状态；给出可能残留的位置和下一次请求受影响的具体业务操作。
3. 追踪异步提交、定时执行和回调，确认上下文是否需要传递、传递哪些最小字段、何时冻结取值；不能假定父线程数据自动正确到达工作线程。
4. 核对嵌套调用临时切换上下文后的恢复策略，以及工作线程原有值如何处理；提出显式传参或受控包装方案时说明兼容影响和清理责任。
5. 在相同线程连续处理两个不同用户或租户的任务，第二个任务分别设置有效、缺失和错误上下文，验证数据访问范围；异常完成后再执行同样序列。
6. 把定位结果追踪到数据库查询和缓存键，验证实际数据边界而非只观察日志；如果权限依据缺失，应报告无法判定，不声称通过隔离检查。

## 交付与验收

输出要求：交付上下文生命周期表、越界场景、最小修复及隔离验证结果。风险表应写明残留字段、复用入口、可能访问的数据和证据，测试使用匿名样本并避免记录真实身份凭证。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 风险说明残留字段、线程复用入口及可能访问的数据，并具有路径证据。
- 覆盖异常清理、嵌套恢复和异步传递，不只检查是否调用 remove。
- 验证第二个任务的有效、缺失与错误上下文对数据库和缓存的实际影响。

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

## 参考资料与适用边界

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

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

## 任务目标

请评审 Java 线程池容量和异步任务的可靠性。

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

## 输入信息（选填）

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

异步任务：从当前排队或任务失败问题选择执行器；留空时扫描自建线程池和 Spring 异步入口，优先检查共享池中具有业务副作用的任务。
工程与负载资料：读取执行器配置、任务代码、上下游资源、依赖与已有排队耗时指标和测试，自动判断平台线程、虚拟线程或其他调度方式。

## 信息不完整时

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

### 优先确认

- 追踪任务来源、提交返回、排队、执行和完成通知，确认是否持久化。
- 核对核心线程、上限、队列、拒绝策略、线程名及所用版本的参数语义。
- 关联数据库连接、远程连接、锁和共享池任务，查找阻塞与相互拖慢的路径。
- 读取异常、取消、停机重启和重试处理，以及现有负载与完成率记录。

### 可采用的默认处理

- 默认只读评审，不直接扩线程、改拒绝策略或重启服务。
- 没有到达率与耗时分布时给测量方式、容量公式和附假设候选，不设固定最优线程数。
- 虚拟线程和响应式任务按实际实现另列边界，不机械套用传统池规则。

### 必须有依据的事项

- 任务是否允许丢失、接口何时算业务完成以及拒绝后用户应收到什么结果不明时，不默认静默丢弃或同步执行。
- 带副作用任务在超时、取消和重启后是否允许重试未定义时，不承诺可安全重复执行。

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

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

- 无工程时提供任务可靠性分类、资源关系和容量估算表，以及排队满、下游慢和重启用例。
- 缺负载环境时交付现有配置的静态风险及所需指标，不把未压测候选作为可直接采用参数。

## 执行要求

适用范围：传统平台线程池与常见Spring异步执行器；虚拟线程、响应式调度器应另行评估，不机械套用旧线程数量建议。

明确线程池的资源边界，并为线程提供可识别的名称。

检查步骤：
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)

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

## 任务目标

请评审 Java 接口契约与 DTO 字段。

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

## 输入信息（选填）

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

接口或业务操作：优先使用当前需求或接口变更；留空时从现有 Controller/RPC 入口与调用方选取一条实际业务操作，连同 DTO、响应和异常完成契约评审。
工程与接口资料：读取接口定义、DTO/VO、服务方法、序列化和校验配置、前端或 RPC 调用样例及既有测试，自动确认框架与 Java 模型类型。

## 信息不完整时

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

### 优先确认

- 追踪发起角色、前提、数据对象、成功时点和异常到接口返回的映射。
- 核对字段名称、类型、长度、单位、必填条件、枚举、空值及脱敏。
- 检查 DTO 到 Service 到 VO 的转换、可写字段和实际 JSON，识别 record 或特殊模型。
- 读取客户端兼容、分页排序、重复提交、对象归属及真实租户边界的实现与样例。

### 可采用的默认处理

- 默认只读评审，给最小契约修正示例，不直接修改公共字段和错误码。
- 已有客户端实际使用方式优先纳入兼容评估，不把传统 JavaBean 规则套到所有模型。
- 业务说明不足时分别记录代码现状和待确认语义，不把 HTTP 成功当作异步业务完成。

### 必须有依据的事项

- 金额单位、时间含义、状态或异步完成标准未定义时，不编造字段默认值与业务验收结果。
- 合法操作角色、对象归属或旧客户端兼容约束存在冲突时，不自行放宽写入权限或破坏公共契约。

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

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

- 无工程时交付接口与字段字典、有效请求和边界请求的契约模板，未定义的业务结果明确标注。
- 只有接口样例时完成字段一致性与兼容风险审查，列出需要从实现确认的转换和权限点。

## 执行要求

适用范围：常规Java后端的HTTP或RPC接口；先核对JDK与框架版本，不将传统JavaBean约定直接套用于record或特殊序列化模型。

让接口说明覆盖输入、返回及异常，使用能准确表达含义的名称。

检查步骤：
1. 从业务需求列出操作对象、发起角色、前置条件、成功状态和失败状态，逐项对应到接口；不能用接口返回成功替代业务实际完成，异步任务要明确状态查询入口。
2. 建立请求与响应字段字典，逐个核对名称、类型、长度、单位、必填条件、空值含义、枚举和脱敏要求；遇到金额、时区、状态码等缺少定义时指出具体缺口。
3. 追踪DTO到业务方法再到响应对象的转换，检查重命名、漏传、默认值和字段覆盖；对布尔属性核对实际序列化结果，并用现有客户端样例验证兼容性。
4. 检查路径、查询参数与请求体是否承担清晰职责，列出重复提交、分页、排序、越权对象访问等边界；只在项目确有多租户时核对租户字段的可信来源。
5. 补齐接口注释需要表达的业务规则，给出一组有效请求和至少三组边界请求，响应需包含可处理的业务信息；不要向用户暴露堆栈或内部连接信息。
6. 将需求、接口、字段和验收用例逐条关联，区分新增接口与兼容改动；评估旧客户端在字段缺失、增加或枚举扩展时的行为，并给出分阶段联调顺序。

## 交付与验收

输出要求：依次给出接口清单、字段字典、问题表、最小修改示例和联调用例。问题表使用“位置｜触发条件｜实际影响｜修正建议｜验证方式”，用例写明请求、期望业务状态及期望响应。 只报告有证据支持的问题；区分“已验证”“推测”和“待验证”，涉及变更时给出受影响文件或对象、最小修改和复核方法。代码与操作示例使用占位符，不写入真实密码。

### 本条完成检查

- 需求、接口、字段和用例能够对应，问题具有位置、触发条件、影响和验证方式。
- 检查实际序列化、字段覆盖与越权写入，说明新增和兼容改动的区别。
- 至少给有效请求及三类边界请求，分别标明预期业务状态与响应，未验证行为不写通过。

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

## 参考资料与适用边界

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

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