open-index/open-npm huggingface dataset:
npm package: @ks-dbdev/template-field-plugin
Description: 字段插件开发模板合集 - 包含公式类和API类模板
Author: @dbdev-team
Latest version: 1.0.2

# @ks-dbdev/template-field-plugin

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

[![npm version](https://img.shields.io/npm/v/@ks-dbdev/template-field-plugin.svg)](https://www.npmjs.com/package/@ks-dbdev/template-field-plugin)
[![license](https://img.shields.io/npm/l/@ks-dbdev/template-field-plugin.svg)](https://github.com/your-org/db-open-platform/blob/main/LICENSE)

## 📦 包含模板

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

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

**特点**：

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

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

### 2. API类字段插件 (API)

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

**特点**：
- ✅ Python环境支持
- ✅ HTTP请求封装
- ✅ 标准返回格式
- ✅ 异步处理能力

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

## 🚀 快速开始

### 使用 CLI 创建项目（推荐）

```bash
# 使用 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
```

## 🛠️ 开发流程

### 公式类插件开发

1. **安装依赖**
   
   ```bash
   cd your-project
   npm install
   ```
   
2. **编辑配置**
   
   ```bash
   # 修改 src/meta.json
   # - 设置字段名称、图标
   # - 配置公式模板
   # - 定义UI交互
   ```
   
3. **打包发布**
   ```bash
   npm run build
   # 生成 dist/plugin.zip
   ```

### API类插件开发

1. **安装依赖**
   ```bash
   cd your-project
   npm install
   ```

2. **编辑配置和代码**
   ```bash
   # 修改 src/meta.json - 配置字段
   # 修改 src/main.py - 实现API逻辑
   ```

3. **打包发布**
   
   ```bash
   npm run build
   # 生成 dist/plugin.zip
   ```

## 📚 文档链接

- [WPS多维表格字段插件开发者指南](https://365.kdocs.cn/wiki/l/0lchFqtEWm9uDd)