# 明道云合并单元格视图插件

**Repository Path**: shen-zhonghao/cellView

## Basic Information

- **Project Name**: 明道云合并单元格视图插件
- **Description**: 明道云平台合并单元格视图插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-29
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# cellView

明道云视图插件开发模板项目

## 项目简介

cellView 是一个基于 Vue 3 + Vite 构建的明道云视图插件开发模板项目。该项目提供了一套完整的视图插件开发框架，包含数据获取、操作、交互等功能 API，帮助开发者快速构建明道云视图插件。

## 技术栈

- **前端框架**: Vue 3
- **构建工具**: Vite
- **打包工具**: esbuild
- **CSS 预处理器**: Less

## 功能特性

### 数据获取 API
- `getFilterRows` - 获取筛选后的行数据
- `getRowDetail` - 获取单行记录详情
- `getFilterRowsTotalNum` - 获取筛选后的数据总数
- `getRowRelationRows` - 获取关联记录行数据

### 数据操作 API
- `addWorksheetRow` - 新增工作表行数据
- `updateWorksheetRow` - 更新工作表行数据
- `deleteWorksheetRow` - 删除工作表行数据

### 交互类 API
- `openRecordInfo` - 打开记录详情页
- `openNewRecord` - 新建记录

### 选择类 API
- `selectUsers` - 选择用户
- `selectDepartments` - 选择部门
- `selectOrgRole` - 选择组织角色
- `selectLocation` - 选择地理位置
- `selectRecord` - 选择记录

### 事件监听
支持多种事件监听机制

## 快速开始

### 环境要求

- Node.js >= 16.0.0
- npm >= 7.0.0

### 安装依赖

```bash
npm install
```

### 开发调试

启动本地开发服务器：

```bash
npm run dev
```

### 构建插件

构建生产版本：

```bash
npm run build
```

## 项目结构

```
cellView/
├── src/                  # 源代码目录
├── dist/                 # 构建输出目录
├── node_modules/         # 依赖包
├── .config/              # 配置文件
│   └── params-config.json
├── .Traerules/           # 开发规范文档
│   └── mdye-traerules.md
├── mdye.json             # 插件配置
├── package.json          # 项目配置
└── vite.config.js        # Vite 配置
```

## 开发规范

### 字段类型处理

项目支持多种字段类型的处理：
- 单选字段
- 多选字段
- 关联记录字段
- 成员字段
- 部门字段
- 附件字段
- 定位字段

### 数据结构

#### 工作表数据返回值结构

插件获取的工作表数据遵循统一的结构规范。

#### config 配置核心结构

插件配置信息包含核心的结构定义。

#### env 环境变量结构

环境变量提供了插件运行时的上下文信息。

## mdye-cli 命令行工具

### 安装

```bash
npm install -g mdye-cli
```

### 验证安装

```bash
mdye --version
```

### 基本用法

#### 查看帮助

```bash
mdye --help
```

#### 初始化项目

```bash
mdye init
```

#### 启动本地开发服务

```bash
mdye dev
```

#### 构建项目

```bash
mdye build
```

#### 提交插件

```bash
mdye submit
```

## 本地项目开发流程

1. 进入项目文件夹
2. 安装项目依赖
3. 启动本地调试
4. 构建与提交

## 相关文档

- [明道云视图插件开发规范](./.Traerules/mdye-traerules.md)
- [API 参考文档](./.Traerules/API.md)

## 许可证

MIT License