TDesign

请为桌面管理端与小程序建立一致而可实现的组件使用约定。输入：现有技术栈及版本、已选组件库、品牌和视觉规范、业务页面及组件、桌面与小程序任务差异。目标是减少同类页面的视觉和交互偏差。

主题、设计变量和组件 API 均以项目安装版本为准；跨端统一的是业务含义和使用约定，不能假定不同组件库的 API 相同。

执行步骤：
1. 盘点项目实际使用的组件库、版本、定制组件和样式覆盖，区分已经存在与建议新增。先确认项目选择，优先复用已有组件库。
2. 建立业务组件清单，将查询区、审批状态、附件区、成员选择、操作栏等映射到基础组件或组合组件，注明适用场景和不适用场景。名字应能让设计与研发直接对应。
3. 整理颜色语义、文字层级、间距、边框、圆角与控件密度，优先使用当前库的可配置变量。必须自定义时解释业务原因，变量值来源未知的标为建议。
4. 定义组件的默认、悬浮、聚焦、禁用、加载、错误和只读状态，明确哪些状态适用于触屏。不能把鼠标悬浮作为小程序读取重要内容的唯一方式。
5. 逐项区分跨端保持一致的业务含义与需要因终端改变的呈现，例如审批结果名称一致，但桌面表格与手机记录卡可不同。明确点击、触摸、返回和输入法下的行为。
6. 形成设计到研发的对照与验收样例，列出长中文、空值、大数值、无权限、弱网等内容条件。核验组件 API 应基于安装版本文档，不能凭名称推断支持属性。

输出：现有组件盘点、业务组件映射、视觉变量建议、状态矩阵、跨端差异表、设计交付与验收清单。涉及代码时仅使用已核实版本支持的能力。

验收：相同业务状态名称与含义一致；视觉变量有来源；终端差异有任务依据；不存在组件库混用造成的重复样式；小程序任务不依赖桌面专有交互。

信息边界：未读取实现或未运行终端时不得声称完成兼容验证；官方仓库说明只能证明其公开能力，不能作为对本项目质量或合规性的品牌背书。

参考来源（核验于 2026-09-08）：
- [Arco Design 官方仓库中文说明](https://github.com/arco-design/arco-design/blob/main/README.zh-CN.md)
- [TDesign 官方仓库](https://github.com/Tencent/tdesign)

请对 系统名称 做中文界面和组件默认文案一致性检查。输入：页面清单或代码、TDesign版本、业务词汇、日期金额规则、目标用户、现有设计约定。

在使用 TDesign 的 Vue 后台中，按当前版本的 ConfigProvider 能力检查全局文案与局部覆盖。中文业务命名和政企页面表达遵循本项目约定，不由组件默认配置代替业务判断。

1. 先统计表单、分页、日期选择、对话框、选择器和空状态使用位置，识别全局配置与页面局部覆盖。查明运行时真实显示的语言，不能只看系统菜单中文就判断基础控件已全部中文化。
2. 对照当前版本的 globalConfig 接口统一常用组件文案。把通用词放到统一配置，把“提交审批”“停用设备”等业务动作留在对应场景；不猜语言包路径或配置字段，不修改组件库的自动生成接口文件。
3. 核对月份、星期、日期占位、确认取消、表单必填和分页数量表达。逐项区分展示格式与接口传输格式，确认时区、日期范围两端是否包含、金额单位及小数位，避免为了统一外观改变实际业务含义。
4. 统一相同业务对象的称呼和状态词，检查列表、详情、编辑与结果提示是否一致。占位提示用于说明输入方法，不能代替字段标签；错误文字需要告诉用户哪一项有问题和如何修正。
5. 检查页面层级、筛选区、表格区和主要操作的位置。保持标签对齐、主次按钮清楚、中文换行自然和信息密度稳定，删除不帮助完成业务的宣传口号、虚构成绩及冗余装饰，保留必要状态和业务说明。
6. 实际打开不同业务页面，操作日期选择、无结果查询、必填校验、分页和弹窗。检查全局修改是否误伤特殊场景，重点验证较长机构名称、低分辨率窗口和加载失败状态，记录截图或可复现路径。

输出：统一词汇表、全局配置及局部覆盖表、需调整的页面清单、验收结果。每项修改说明它改善的具体业务理解或操作；没有页面运行条件时给出待验证清单，不能把静态代码检索结果当作完整视觉验收。

官方来源（2026-09-08 核验）：
- [腾讯 TDesign《TDesign Vue Next ConfigProvider 类型与接口说明》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/config-provider/type.ts)

请核查 弹窗业务场景，使用户能明确完成操作并在失败后继续处理。输入：弹窗代码、接口约定、成功后页面变化、草稿保留要求、TDesign版本。

按当前版本的 TDesign Dialog 能力处理显示、加载和关闭事件。业务操作的幂等、授权以及是否允许取消，需要依照项目事实实现。

1. 列出弹窗承担的唯一主要任务、操作对象和完成条件。区分确认删除、编辑保存、结果提示等场景，按钮直接写业务动作；需要说明影响范围时描述真实后果，不使用笼统的“温馨提示”掩盖关键内容。
2. 设计未操作、输入中、提交中、成功、失败等状态，确定谁控制 visible。把确认按钮加载与真实请求周期绑定，避免请求尚未结束弹窗就关闭，或请求失败后按钮一直处于不可用状态。
3. 分别处理取消按钮、关闭按钮、遮罩点击和 Escape。存在未保存修改时按业务约定保留、确认放弃或阻止关闭；不要把返回 void 的动画前回调误当成支持异步拦截的关闭守卫，应检查该版本真实接口能力。
4. 核对回车确认与内部表单提交是否可能同时触发请求。对连续点击、键盘触发和慢请求期间再次操作进行限制；前端限制只减少重复触发，涉及不可重复业务操作时同时核查服务端约定。
5. 明确关闭时是否销毁子内容以及重新打开时如何初始化。编辑另一条记录时清理旧对象、错误提示与异步回调，成功后根据接口实际结果刷新列表或详情；不得把本地假定值直接当成服务器保存结果。
6. 验收焦点进入与返回、键盘操作、长内容滚动、遮罩遮挡和中文按钮长度。模拟业务校验失败、网络中断、延迟响应、重复触发及用户切换记录，检查能否继续编辑或安全返回原页面。

输出：弹窗状态表、每种关闭来源的处理、必要代码修改和验收记录。对接口已受理但客户端未收到结果的情况单独说明确认结果的办法，避免直接再次提交。缺少版本或源码时先给处理方案和待核实 API，不声称组件天然保证全部业务安全。

官方来源（2026-09-08 核验）：
- [腾讯 TDesign《TDesign Vue Next Dialog 类型与接口说明》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/dialog/type.ts)

请开发或检查 业务列表名称。输入：页面代码、接口协议、字段与列定义、筛选条件、批量操作规则、TDesign版本、预计数据规模。

按当前版本的 TDesign Table 能力实现业务表格。服务器分页、统计口径及权限以本项目约定为准，不把组件默认行为视为业务需求。

1. 先明确列表记录的稳定主键、总数含义、筛选字段、排序范围与分页方式。区分当前页数据、全部查询结果及统计卡片口径，检查页面是否对服务器已经分页的数据再次进行本地分页。
2. 为行指定可靠标识，核对列配置与真实数据类型。日期、金额、状态分别按业务含义展示；长文本提供查看方式，关键标识和主要操作不得被无解释地截断，也不要用彩色标签代替完整状态文字。
3. 将分页、排序、过滤事件映射到接口参数，说明筛选变化后是否回到第一页。处理快速连续查询产生的响应顺序，避免先发后到的旧数据覆盖新条件；查询失败时不得把旧结果伪装成新条件的有效结果。
4. 明确勾选是当前页有效、跨页保留还是针对全部查询结果。使用受控选中值保持组件与业务一致，核对分页保留选中配置；筛选变化、权限变化和数据删除后及时处理失效记录，提交前显示实际操作对象范围。
5. 为首次加载、刷新、空结果、网络失败、无权限和部分操作失败设计可理解的反馈。批量动作完成后同步行状态、数量及选中项，部分失败时给出失败对象与原因，不能只显示一个含糊的“操作成功”。
6. 在实际业务数据长度下验收表头、固定列、横向滚动、列宽和窄窗口。验证分页末页删除、跨页勾选、全部取消、重复点击、排序后勾选保持及筛选后批量操作，同时查看真实请求和服务端返回。

输出：数据口径与参数映射表、表格核心实现、选中规则、状态设计及验收记录。每个缺陷写清触发操作、实际结果、期望结果和修改位置。缺少后端协议时先列出待补充字段，并提供有明确假设的前端方案，不虚构总数或批量执行结果。

官方来源（2026-09-08 核验）：
- [腾讯 TDesign《TDesign Vue Next Table 类型与接口说明》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/table/type.ts)

请根据 业务流程 和 字段清单 开发或审查 页面名称 的 Vue 业务表单。输入补充：现有代码、TDesign版本、接口请求与响应、权限及状态规则、新增编辑默认值。

按当前版本的 TDesign Form 能力实现表单，字段权限、数据提交和重复操作处理须与本项目业务规则一致，不能只依赖组件默认行为。

1. 先把每个字段的业务含义、类型、必填条件、默认值、长度或范围、只读条件及提交名称整理成表。区分空字符串、零、false 和未提供，尤其说明编辑时哪些字段允许清空，不能凭视觉上的必填星号推断规则。
2. 对照实际版本配置 Form 数据、FormItem 字段名称和校验规则。需要跨字段判断时明确关联关系；条件隐藏字段要明确是否保留旧值、是否参与校验和提交，不能让看不见的字段持续阻止保存。
3. 设计校验触发时机，区分输入变化、失焦和提交。正确处理 validate 或提交事件的校验结果，只在明确通过时调用保存接口；远程唯一性校验需要识别过期响应，不能把网络超时当成字段已经可用。
4. 区分新增、编辑、详情状态，确定“重置”是清空还是恢复初始数据，并使用对应能力。异步加载编辑数据后核对初始值快照，再次打开表单时不得出现上一条记录的值或错误提示。
5. 完成保存中的按钮状态、重复触发处理、成功反馈和接口失败反馈。字段错误落在对应输入项，整体失败保留已填写内容并给出恢复方法；前端状态限制需要与服务端业务校验一致，不能代替服务端授权。
6. 逐项验收正常提交、缺失必填、边界值、非法格式、动态条件切换、远程校验失败、重复点击、回车提交及重置。验证日期、金额和枚举转换后的实际请求数据，禁止只看页面显示就断言数据正确。

输出：字段规则表、状态与交互表、核心组件代码、请求示例、验收记录。代码缺失时说明推断范围；规则不明确时列出影响保存的待确认项，先完成不依赖这些项的结构，不自行编造业务枚举和接口字段。

官方来源（2026-09-08 核验）：
- [腾讯 TDesign《TDesign Vue Next Form 类型与接口说明》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/components/form/type.ts)

请为 业务系统名称 完成 TDesign Vue Next 接入方案或现有接入复核。输入：项目代码、Vue与构建工具版本、依赖锁文件、目标浏览器、常用组件清单、体积与加载目标。

接入范围限定为桌面端 Vue 3 与 TDesign Vue Next。项目使用 Vue 2、其他组件库或小程序时，先指出不适用部分，不直接替换工程依赖。

1. 确认真实入口、路由、样式加载顺序、组件使用比例和目标浏览器。列出已有组件库及重复能力，判断采用 TDesign 是新增统一组件还是局部接入，避免同一业务控件在不同页面出现多套行为。
2. 按实际使用范围选择全量注册、显式按需引入或自动导入。说明选择依据与维护成本，不把按需引入当成无条件要求；只有产物分析能证明收益时，才为体积目标增加相关插件。
3. 核对包版本、解析器和构建插件，使用项目锁文件固定可复现依赖。检查生产构建是否依赖未固定版本的外部脚本或样式；需要外部资源时列明来源、版本和不可用时的业务影响。
4. 确认基础全局样式已加载，检查自动导入是否同时处理组件和函数式调用。对输入框、选择器、表格、弹窗各做一个真实页面引用，识别缺样式、重复样式、组件未注册及编辑器提示失效等问题。
5. 复核样式重置与现有布局的关系，特别检查盒模型、弹层、滚动区域和中文标签。使用有业务含义的页面内容，不增加装饰性标语、虚构统计数据或大面积炫光；布局保持对齐、层级清楚、操作集中。
6. 通过项目既有构建命令生成产物，检查包体、资源请求和相关浏览器中的真实页面。分别记录首屏正常、路由切换、按需弹窗首次打开及刷新后直达页面的结果，失败时保留具体报错和复现路径。

输出：接入方式及理由、涉及文件与配置、依赖版本、产物对比、页面验收结果。性能结论必须包含实测条件；缺少基线只给采集方法。无法运行时，标记所有待验证项并提供最小接入代码，不虚报浏览器兼容或上线完成。

官方来源（2026-09-08 核验）：
- [腾讯 TDesign《TDesign Vue Next 安装与使用》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/tdesign-vue-next/site/docs/getting-started.md)