用途
TDesign 小程序组件库（tdesign-miniprogram）是腾讯提供的企业级设计系统，专门用于微信小程序开发。当使用 TDesign 组件库开发微信小程序、使用 TDesign UI 组件、按照 TDesign 设计规范实现界面、配置 TDesign 主题与样式定制、构建 AI 聊天界面或实现暗黑模式适配时，可启用本技能。
主要能力
该组件库提供 60 多个高质量组件，并支持暗黑模式与主题定制。组件按类别划分如下：
- 基础组件（6 个）：Button、Divider、Fab、Icon、Layout、Link。
- 导航组件（8 个）：BackTop、Drawer、Indexes、Navbar、SideBar、Steps、TabBar、Tabs。
- 输入组件（16 个）：Calendar、Cascader、CheckBox、DateTimePicker、Input、Picker、Radio、Rate、Search、Slider、Stepper、Switch、Textarea、TreeSelect、Upload、Form。
- 数据展示组件（18 个）：Avatar、Badge、Cell、Collapse、CountDown、Empty、Footer、Grid、Image、ImageViewer、Progress、Result、Skeleton、Sticky、Swiper、Table、Tag、List。
- 反馈组件（12 个）：ActionSheet、Dialog、DropdownMenu、Guide、Loading、Message、NoticeBar、Overlay、Popup、PullDownRefresh、SwipeCell、Toast。
- AI 聊天组件（9 个）：ChatList、ChatMessage、ChatSender、ChatContent、ChatActionbar、ChatLoading、ChatMarkdown、ChatThinking、Attachments。
使用方式
安装
npm i tdesign-miniprogram -S --production
配置
- 修改 app.json：移除 "style": "v2" 以避免样式冲突。
- 修改 project.config.json：在 setting 部分添加 packNpmManually 与 packNpmRelationList 配置。
- TypeScript 项目修改 tsconfig.json：添加 paths 映射，指向 ./miniprogram/miniprogram_npm/tdesign-miniprogram/*。
- 修改 project.config.json 后，在微信开发者工具中构建 npm：工具 - 构建 npm。
- 构建成功后，勾选“编译 JS 为 ES5”。
使用组件
在页面或组件的 JSON 文件中引入，例如： { "usingComponents": { "t-button": "tdesign-miniprogram/button/button" } } 在 WXML 中使用： <t-button theme="primary">Button</t-button>
样式定制
支持四种方式：
- 使用 style 或 custom-style 属性。
- 禁用样式隔离，直接在页面中覆盖样式；自定义组件中可设置 styleIsolation: 'shared'。
- 使用外部样式类 t-class，配合 !important 覆盖。
- 使用 CSS 变量，例如 --td-button-primary-bg-color、--td-button-border-radius。
暗黑模式
- 在 app.json 中设置 "darkmode": true。
- 在 app.wxss 中导入设计令牌：@import 'miniprogram_npm/tdesign-miniprogram/common/style/theme/_index.wxss'。
- 使用 CSS 变量，如 var(--td-text-color-secondary)。
- 对于 custom-tab-bar 或 root-portal 包裹的组件，添加 .page 类。
AI 聊天界面
引入 t-chat-list、t-chat-message、t-chat-sender 等组件，在 WXML 中组合使用，并通过 bind:send 处理发送事件。
参考文件
技能包含 references/ 目录下的文档：基础文档（getting-started.md、overview.md、custom-style.md、custom-theme.md、dark-mode.md），组件文档（miniprogram/components/），以及 AI 聊天组件文档（miniprogram-chat/）。需要详细 API 信息时可使用 Read 工具访问。
适用场景
- 使用 TDesign 组件库开发微信小程序。
- 使用 TDesign UI 组件（Button、Input、Dialog 等）。
- 按照 TDesign 设计规范实现界面。
- 配置 TDesign 主题和样式定制。
- 构建 AI 聊天界面（使用 TDesign Chat 组件）。
- 实现暗黑模式适配。
限制
- 最低基础库版本要求：^2.12.0。
- 必须在微信开发者工具中构建 npm。
- 必须从 app.json 中移除 "style": "v2"。
- 本技能由 TDesign 官方文档自动生成，参考文件保留源文档的结构和示例，部分参考内容仍为中文。
- 关于收费、价格、平台支持范围等具体信息暂未提供。