@ks-dbdev/template-field-plugin

@ks-dbdev/template-field-plugin

字段插件开发模板合集，包含多种字段插件类型的开发模板。

📦 包含模板

1. 公式类字段插件 (Formula)

位于 templates/formula/，用于创建自定义公式字段。

特点：

• ✅ 支持复杂公式逻辑
• ✅ 多字段联动计算
• ✅ 完整的UI配置支持
• ✅ 多语言支持（中/英/日）

示例：平均分计算、加权求和、条件计算等

2. API类字段插件 (API)

位于 templates/api/，用于创建调用外部API的字段。

特点：

• ✅ Python环境支持
• ✅ HTTP请求封装
• ✅ 标准返回格式
• ✅ 异步处理能力

示例：HTTP测试、数据获取、第三方服务集成等

🚀 快速开始

使用 CLI 创建项目（推荐）

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

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

选择 "字段插件" → 选择 "公式类" 或 "API类"

📁 项目结构

@ks-dbdev/template-field-plugin/
├── package.json
├── README.md
└── templates/
    ├── formula/              # 公式类模板
    │   ├── src/
    │   │   ├── assets/
    │   │   │   └── icon.svg
    │   │   └── meta.json    # 配置文件
    │   ├── scripts/
    │   │   └── build.js     # 打包脚本
    │   ├── package.json
    │   └── README.md
    │
    └── api/                 # API类模板
        ├── src/
        │   ├── assets/
        │   │   └── icon_bda25b14.svg
        │   ├── meta.json    # 配置文件
        │   └── main.py      # Python入口
        ├── scripts/
        │   └── build.js     # 打包脚本
        ├── package.json
        └── README.md

🛠️ 开发流程

公式类插件开发

• 安装依赖

  cd your-project
  npm install
  

• 编辑配置

  # 修改 src/meta.json
  # - 设置字段名称、图标
  # - 配置公式模板
  # - 定义UI交互
  

• 打包发布

  npm run build
  # 生成 dist/plugin.zip
  

API类插件开发

• 安装依赖

  cd your-project
  npm install
  

• 编辑配置和代码

  # 修改 src/meta.json - 配置字段
  # 修改 src/main.py - 实现API逻辑
  

• 打包发布

  npm run build
  # 生成 dist/plugin.zip
  

📚 文档链接

• WPS多维表格字段插件开发者指南