tdesign-uniapp
Skill4 starsChanged 5 months agoMITView on GitHub
当项目使用 tdesign-uniapp,或用户提到 TDesign uni-app 组件怎么用、示例代码、easycom 引入、`@event` 事件、`v-model:value`、props 或代码落地时使用。
In this repository14 other files it gives its agents.
- skillsSkill
- tdesign-changelogSkill
- tdesign-compositionSkill
- tdesign-design-specSkill
- tdesign-docsSkill
- tdesign-iconsSkill
- tdesign-miniprogramSkill
- tdesign-mobile-reactSkill
- tdesign-mobile-vueSkill
- tdesign-reactSkill
- tdesign-skillsSkill
- tdesign-usage-guideSkill
- tdesign-vue2Skill
- tdesign-vue-nextSkill
The file
Files
TDesign UniApp API
本 skill 只服务 tdesign-uniapp。tdesign-uniapp 基于 TDesign 小程序组件适配 uni-app,使用 Vue 风格的 @event 事件绑定,组件通过 easycom 自动引入或手动 import,属性使用短横线(kebab-case)命名。如果同目录存在 ../tdesign-skills/references/constraints.md,可参考它获取更详细的跨 skill 约束。
使用协议
- 必须通过
load_skill加载本 skill,不要绕过 skill 系统直接 grep、find 或 readreferences/下的内部文件。load_skill返回的 SKILL.md 包含查阅顺序、写法边界和约束上下文,直接读文件会丢失这些关键指导,导致跳步、跨栈误判或凭记忆编造 API。 - 严格按下方「查阅顺序」执行,不跳步、不凭经验猜路径。先确认依赖和组件覆盖,再查 API,最后才查示例。
- 需要交接到其他 skill 时,对目标 skill 再次
load_skill,不要直接读目标 skill 的references/文件。 references/下的文件只在 SKILL.md 指引下按需读取,它们是 skill 的内部资料,不是独立文档。
查阅顺序
前置条件:组件 API 依赖
tdesign-mcp-server的get-component-docs/get-component-list。查询前先确认当前环境已安装并配置tdesign-mcp-server;若不可用,不要凭记忆编造 API,先明确告知用户缺少tdesign-mcp-server并引导其安装后再继续(详见../tdesign-docs/references/api/README.md的「降级处理」)。
- 先确认项目安装或引入
tdesign-uniapp,并查看已有.vue文件中的写法。 - 组件是否存在:已安装
tdesign-docs时查../tdesign-docs/references/meta/stack-matrix-miniprogram.json的coverage.byStack.uniapp(uni-app 组件范围与小程序一致);未安装tdesign-docs时,用tdesign-mcp-server的get-component-list确认组件是否存在,不从记忆推断。 - 具体组件 API:调用
tdesign-mcp-server的get-component-docs,传framework: "uniapp"、names: ["<组件名>"],以返回的 API(属性、@event事件、插槽、子组件)为权威依据,不凭记忆编造。 - 需要确认更精确的类型或复合成员(如
Table.columns/BaseTableCol)时,结合get-component-docs返回的 API 表与 demo,必要时再读同栈references/examples/对应组件的最小示例与类型线索。 - 用户在问“怎么用/给示例”时,再查
references/examples/README.md,命中组件目录后按需读base/或组件目录下最小示例文件。 - 涉及跨端语义或端差异时:已安装
tdesign-docs时先看../tdesign-docs/references/api/shared/index.md;未安装时按tdesign-mcp-server返回的当前栈 API 落实,不确定的差异明确告知用户需人工确认,建议补装tdesign-docs获得跨端共享契约。 - 移动端页面骨架与组合:已安装
tdesign-composition时查../tdesign-composition/references/scenarios/mobile-pages.md;未安装时只用本栈组件按移动端惯例(导航 + Cell/Form/List + 反馈)组织,不照搬 Web 中后台骨架,建议补装tdesign-composition获得标准场景卡。版本能力先tdesign-changelog,未安装时跳过,查完仍用get-component-docs返回的当前栈 API 落实写法。
UniApp 写法边界
- 使用
t-*组件标签,属性使用短横线(kebab-case),事件使用@event语法(非小程序bind:event)。 - 所有受控组件统一使用
value作为双向绑定属性名,不使用 Vue 3 默认的modelValue;使用v-model时必须写成v-model:value,不要写裸v-model或v-model:modelValue,因为tdesign-uniapp基于小程序适配,Vue 3 默认的modelValue在 uni-app 中不生效。 - 组件通过
easycom自动引入,无需手动usingComponents;也可手动import后注册。 - 样式使用
<style>或<style scoped>,不使用小程序的@importWXSS 路径。 - 不把 React 点语法、Vue Web 裸
v-model约定、小程序bind事件或 WXML 模板语法套到 uni-app,因为 uni-app 使用 Vue template 而非 WXML。 - 不凭经验编造 props、事件、插槽或组件名,应通过
tdesign-mcp-server查uniapp栈该组件的 API 确认。 - 不凭经验编造子组件标签;例如 uni-app
Table先查columns、BaseTableCol类型和真实 slots,不要直接生成t-table-column一类未在当前栈 API 中确认的标签。 - 用户要求“怎么用”或“给个示例”时,先用
get-component-docs拿当前组件 API 与 demo,必要时补读同栈references/examples/最小示例,再组织 uni-app 代码;不要跳过 API 直接给经验写法。
与小程序的关键差异
| 特性 | 小程序 (tdesign-miniprogram) | uni-app (tdesign-uniapp) |
| 组件引入 | JSON usingComponents | easycom 自动引入 / import |
| 事件绑定 | bind:event / bindevent | @event |
| 属性传递 | kebab-case | kebab-case(相同) |
| 模板语法 | WXML | Vue template |
| 样式 | WXSS | CSS / SCSS / Less |
| 数据绑定 | {{ }} | {{ }}(相同) |
| 条件/循环 | wx:if / wx:for | v-if / v-for |
| 组件标签 | <t-button> | <t-button>(相同) |
约束
- 只按当前任务查询需要的单个组件,不一次性批量拉取整库 API,因为会浪费大量 token 且信息过载。
- 优先用 TDesign UniApp 组件和 props 解决问题,最后才补最小 CSS,因为 TDesign uni-app 组件经过多端兼容测试。
- UniApp 组件 API 参考小程序组件文档,但事件写法必须使用
@eventVue 语法。 - UniApp 受控组件双向绑定必须使用
v-model:value,与 React 版和原生小程序版的value命名保持一致,因为modelValue在 uni-app 中不生效。 - 不引入其他组件库,因为混用会导致样式冲突、包体积膨胀和视觉不一致;不用
div/ul > li/window.confirm()重复实现 TDesign 已有能力,因为重复实现会绕过 TDesign 的多端兼容和主题适配。 - 当前栈组件不存在或能力不足:已安装
tdesign-usage-guide时查../tdesign-usage-guide/references/decisions/fallback-policy.md;未安装时优先换相似 TDesign 组件,再考虑 uni-app 原生能力 + 最小 CSS,并在回复中说明这是非 TDesign 官方能力,建议补装tdesign-usage-guide获得完整降级策略。 - 路由交接:选型→
tdesign-usage-guide、页面组合→tdesign-composition、图标→tdesign-icons、版本→tdesign-changelog;查完线索用get-component-docs返回的当前栈 API 落实写法。 - 完整 collection 模式下,详细职责表、跨栈隔离细则和强制约束可参考
../tdesign-skills/references/constraints.md;未安装时按本文件内联规则执行。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

