@ks-dbdev/template-react-db-dashboard-plugin

@ks-dbdev/template-react-db-dashboard-plugin

多维表格仪表盘插件开发模板

🚀 快速开始

使用 CLI 创建项目（推荐）

# 使用 dbdev CLI 工具
npx @ks-dbdev/cli create template

# 或全局安装后使用
npm install -g @ks-dbdev/cli
dbdev create template

选择 "仪表盘插件" 模板

🛠️ 开发流程

1. 安装依赖

npm install

2. 本地调试

启动本地开发服务

打开项目目录终端，执行以下命令启动本地开发服务：

npm dev

命令执行后，终端会显示本地服务端口号（PORT），例如：5173

打开目标多维表页面

打开需要调试的多维表页面，并在 URL 后增加查询参数：?plugin_debug=PORT

示例如下：

• 基础模式：https://www.kdocs.cn/l/XXXXXXXXX?plugin_debug=5173
• 已含其他参数模式：https://www.kdocs.cn/l/XXXXXXXXX?R=XXXXXXXX&plugin_debug=5173

验证本地调试效果

页面刷新后，所有插件都会被代理到本地开发环境（如 http://localhost:5173），即可在浏览器中实时查看插件效果。

💡 请确保本地开发服务（npm dev）处于运行状态，否则无法加载本地插件。

3. 打包插件

执行以下命令打包插件：

npm build

打包完成后，将 dist 文件夹压缩为 zip 包，即可上传到 WPS 开放平台。

📚 相关文档

• WPS多维表格仪表盘插件开发指南