用途:TanStack Devtools Marketplace 是 devtools 外壳内置的插件注册表,用户从 Marketplace 标签页浏览插件并一键安装。开发者通过向 TanStack/devtools 仓库的 packages/devtools/src/tabs/plugin-registry.ts 提交 PR 来上架插件。前提是已用 devtools-plugin-panel 技能构建出可用插件,并已发布到 npm 的公开包,导出 JSX 面板组件或函数式插件。
主要能力:每个条目遵循 PluginMetadata 接口,字段包括 packageName、title、description、logoUrl、requires(packageName、minVersion、maxVersion)、pluginImport(importName、type)、pluginId、docsUrl、author、repoUrl、framework、featured、isNew、tags。接口严格必填的是 packageName、title、framework,但实际应始终提供 requires、pluginImport 和 description,否则无法自动安装。pluginImport.type 为 'function' 时注入 ImportName(),为 'jsx' 时注入 { name, render: <ImportName /> }。多框架包需按框架分别添加条目,市场会扫描 package.json 依赖自动识别框架并只显示匹配项,framework 为 'other' 的插件对所有框架可见。
使用方式:先发布 npm 包,再 fork 并克隆 TanStack/devtools 仓库,在 plugin-registry.ts 的 PLUGIN_REGISTRY 对象中 THIRD-PARTY PLUGINS 注释区添加条目,向 main 分支提 PR,标题格式为 feat(marketplace): add <your-plugin-name>。自动安装流程位于 packages/devtools-vite/src/inject-plugin.ts:安装包、检测含 <TanStackDevtools /> 的文件、用 oxc-parser 解析并经 MagicString 修改 plugins 属性、插入 import、按 type 注入插件。
限制:featured 字段保留给官方 TanStack 合作伙伴,PR 中自行设置会被拒绝,需邮件申请。pluginId 用于匹配已注册插件,默认将包名小写并把非字母数字字符替换为 -。常见错误包括缺少 pluginImport 导致装包后无法注入、未指定 requires.minVersion 导致旧版本运行时错误、framework 误填 'other'。市场用 semver 比较判断版本是否满足,不满足时显示 Bump Version 而非 Install。