这篇翻译之后英文原文有更新,内容可能已过时。
使用你的编程智能体
首先为你的编程智能体安装 Data Client 的 skill。没有它们,智能体能把基础部分做对,但会遗漏其余部分,例如实时 manager 和测试 fixture。
- Claude Code plugin
- Cursor plugin
- Codex plugin
- Installed packages
- Skills CLI
- OpenSkills
claude plugin marketplace add reactive/data-client
claude plugin install data-client@data-client
codex plugin marketplace add reactive/data-client \
--sparse .claude-plugin --sparse .agents/skills
codex plugin add data-client@data-client
# after installing Data Client: links the skills its packages ship
npx --no data-client-skills
npx skills add reactive/data-client \
--skill data-client \
--skill data-client-setup \
--skill data-client-manager \
--skill data-client-schema \
--skill data-client-v0.18-migration \
--skill data-client-rest \
--skill path-to-regexp-v8-migration \
--skill data-client-vue \
--skill data-client-vue-testing \
--skill data-client-rest-setup \
--skill data-client-graphql-setup \
--skill data-client-endpoint-setup
npx openskills install reactive/data-client/.agents/skills/data-client
npx openskills install reactive/data-client/.agents/skills/data-client-setup
npx openskills install reactive/data-client/.agents/skills/data-client-manager
npx openskills install reactive/data-client/.agents/skills/data-client-schema
npx openskills install reactive/data-client/.agents/skills/data-client-v0.18-migration
npx openskills install reactive/data-client/.agents/skills/data-client-rest
npx openskills install reactive/data-client/.agents/skills/path-to-regexp-v8-migration
npx openskills install reactive/data-client/.agents/skills/data-client-vue
npx openskills install reactive/data-client/.agents/skills/data-client-vue-testing
npx openskills install reactive/data-client/.agents/skills/data-client-rest-setup
npx openskills install reactive/data-client/.agents/skills/data-client-graphql-setup
npx openskills install reactive/data-client/.agents/skills/data-client-endpoint-setup
然后告诉你的智能体:
安装插件
在创建应用时安装 Vue 插件。
npm install --save @data-client/vue @data-client/rest
import { createApp } from 'vue';
import { DataClientPlugin } from '@data-client/vue';
import App from './App.vue';
const app = createApp(App);
app.use(DataClientPlugin);
app.mount('#app');
app.use(DataClientPlugin, options) 可以选择性地覆盖 managers、initialState、Controller 和 gcPolicy。全部选项请参阅 DataClientPlugin。
你的编程智能体也可以通过 TanStack Intent 加载这些包附带的 skill,并与你安装的版本相匹配:
npm install -D @tanstack/intent
npx intent install
示例
探索 vue-todo-app 示例
支持的工具
TypeScript 4.0+
TypeScript 是可选的,但要获得完整的类型约束,至少需要 4.0 版本并开启 strictNullChecks。
@data-client/vue 需要 TypeScript 4.5 或更高版本,因为 Vue 自身的类型也有此要求。
旧版浏览器支持
如果你的应用面向较旧的浏览器(几年甚至更久之前的),请务必加载 polyfill。通常的做法是使用 @babel/preset-env useBuiltIns: 'entry',并在应用入口处导入 core-js。
这样可以确保应用的打包产物中只包含目标浏览器所需的 polyfill。
例如 TypeError: Object.hasOwn is not a function
Internet Explorer 支持
如果你看到 Uncaught TypeError: Class constructor Resource cannot be invoked without 'new',请按照说明为包添加旧版浏览器支持
Vue 3
@data-client/vue 支持 Vue 3,并基于组合式 API 构建。