forguncy-plugin-expert

Category: Development & Coding | Uploader: nimotea | Downloads: 0 | Version: v1.0（Latest）

活字格插件开发专家 - 为活字格低代码平台创建服务器命令(ServerCommand)、单元格类型(CellType)、客户端命令(ClientCommand)、服务器API和中间件。当用户提到"做个插件"、"创建自定义命令"、"开发单元格类型"、"Forguncy扩展"、"活字格自定义功能"，或请求"帮我写个服务器命令"、"实现一个控件"时，必须使用此技能。即使用户没有明确说"插件专家"，只要涉及活字格功能开发，都应该触发此技能。

Changelog: Source: GitHub https://github.com/nimotea/forguncy-plugin-skill-publish

Directory Structure

Current level: skills/forguncy-plugin-expert/

📁 assets/
- 📁 icons/
  - 📄 api.svg 706 B
  - 📄 database.svg 735 B
  - 📄 tool.svg 645 B
- 📁 internal/
  - 📄 forguncy-plugin-skill-apply.md 1.9 KB
- 📁 schemas/
  - 📄 l1_5_mock_config.json 957 B
- 📁 templates/
  - 📄 CellType.cs.txt 650 B
  - 📄 CellType.js.txt 7.9 KB
  - 📄 ClientCommand.cs.txt 1.6 KB
  - 📄 Market_Description_Template.md 1.3 KB
  - 📄 Middleware.cs.txt 548 B
  - 📄 Plugin.csproj.txt 1.5 KB
  - 📄 ServerApi.cs.txt 757 B
  - 📄 ServerCommand.cs.txt 3.4 KB
  - 📄 update_references.ps1.txt 5.9 KB
📁 references/
- 📁 CellType/
  - 📁 Reference_Manual/
    
    📄 DesignTime_Support.md 23.0 KB
    
    📄 Examples_And_Best_Practices.md 25.0 KB
    
    📄 Properties_Basic.md 10.7 KB
    
    📄 Properties_Complex.md 64.7 KB
    
    📄 Runtime_Behavior.md 33.7 KB
    
    📄 System_Integration.md 58.0 KB
    
    📄 Tutorial_SimpleCellType.md 6.3 KB
- 📁 ClientCommand/
  - 📄 DesignTime_Support.md 1.9 KB
  - 📄 Other_Functions.md 11.7 KB
  - 📄 Properties_Basic.md 6.6 KB
  - 📄 Properties_Complex.md 75.7 KB
  - 📄 Tutorial_SimpleClientCommand.md 5.8 KB
- 📁 Debug/
  - 📄 Debugdesigntimecode.md 1.3 KB
  - 📄 Debugjavascriptcode.md 2.1 KB
  - 📄 Debugservercommandcode.md 1.4 KB
  - 📄 Debugservercommandcode_AddDiagnosticLog.md 3.6 KB
- 📁 FAQ/
  - 📄 AssemblyCouldNotBeLoaded.md 4.0 KB
  - 📄 HowToAddColumnProperties.md 3.4 KB
  - 📄 HowToControlSerializationOfProperties.md 3.7 KB
  - 📄 IntegrateAspnetCoreControllerAndRazorpage.md 7.2 KB
  - 📄 PageNotUpdate.md 4.7 KB
- 📁 JavaAdapter/
  - 📄 DesignTime_Support.md 2.3 KB
  - 📄 Other_Functions.md 11.6 KB
  - 📄 Process_Control.md 5.9 KB
  - 📄 Security_Provider.md 27.3 KB
- 📁 Middleware/
  - 📄 CacheServiceOptimization.md 5.2 KB
  - 📄 Useapplicationservices.md 5.4 KB
  - 📄 Usecachingservice.md 2.7 KB
  - 📄 Usecomputingservices.md 2.9 KB
- 📁 Project_Configuration/
  - 📄 Plugin_Metadata.md 8.0 KB
- 📁 Publish/
  - 📄 Iconanddescription.md 503 B
  - 📄 Iconanddescription_Changepluginpackageicon.md 556 B
  - 📄 Iconanddescription_Replacecellcommandicon.md 1.3 KB
  - 📄 Iconanddescription_Updatepluginnameanddescription.md 598 B
  - 📄 Localfilepublishing.md 647 B
  - 📄 Pluginconfigjson.md 3.4 KB
  - 📄 Publishtograpecitymarket.md 281 B
  - 📄 Publishtograpecitymarket_Preparationsbeforeuploadingplugin.md 4.9 KB
  - 📄 Publishtograpecitymarket_Uploadplugintograpecitymarket.md 2.7 KB
- 📁 ServerCommand/
  - 📁 Reference_Manual/
    
    📄 DesignTime_Support.md 9.9 KB
    
    📄 Other_Functions.md 12.2 KB
    
    📄 Process_Control.md 14.7 KB
    
    📄 Properties_Basic.md 5.8 KB
    
    📄 Properties_Complex.md 48.8 KB
    
    📄 Tutorial_SimpleServerCommand.md 5.8 KB
- 📁 Upgrade/
  - 📄 NewFeatureInV10.md 4.0 KB
  - 📄 NewFeatureInV10100.md 2.3 KB
  - 📄 NewFeatureInV11100.md 1.4 KB
  - 📄 Newfeatureinv9100.md 5.9 KB
  - 📄 Upgradepluginv81tov9.md 4.0 KB
- 📄 API_Cheatsheet.md 2.0 KB
- 📄 Build_Standard.md 1.7 KB
- 📄 CLI_Reference.md 3.5 KB
- 📄 DOC_INDEX.md 4.2 KB
- 📄 Guiding_Principles.md 3.0 KB
- 📄 SDK_BestPractices.md 28.2 KB
- 📄 SOP.md 5.3 KB
- 📄 Unified_Properties.md 4.9 KB
📁 scripts/
- 📄 generate_logo.py 9.7 KB
- 📄 generate_mock_data.py 3.6 KB
- 📄 init_project.ps1 2.8 KB
- 📄 quick_validate.py 2.0 KB
- 📄 update_references.ps1 5.9 KB
📄 SKILL.md 5.5 KB

SKILL.md

---
name: forguncy-plugin-expert
description: 活字格插件开发专家 - 为活字格低代码平台创建服务器命令(ServerCommand)、单元格类型(CellType)、客户端命令(ClientCommand)、服务器API和中间件。当用户提到"做个插件"、"创建自定义命令"、"开发单元格类型"、"Forguncy扩展"、"活字格自定义功能"，或请求"帮我写个服务器命令"、"实现一个控件"时，必须使用此技能。即使用户没有明确说"插件专家"，只要涉及活字格功能开发，都应该触发此技能。
---

# 活字格 (Forguncy) 插件开发专家

## 核心职责

帮助开发者创建高质量、生产就绪的活字格插件。熟悉 .NET、活字格 SDK 和最佳实践。

## 何时使用

以下场景必须触发此技能：

- 用户说"做个插件"、"创建自定义命令"、"开发单元格类型"
- 用户提到 Forguncy/活字格 + 开发/扩展/自定义功能
- 用户请求实现 ServerCommand、CellType、ClientCommand、ServerAPI、Middleware
- 用户询问活字格插件开发的 API 或最佳实践

## 核心文档（必读）

- [DOC\_INDEX.md](references/DOC_INDEX.md) - 开发任务入口，先读它
- [CLI\_Reference.md](references/CLI_Reference.md) - CLI 项目创建指南
- [SDK\_BestPractices.md](references/SDK_BestPractices.md) - 编码规范
- [API\_Cheatsheet.md](references/API_Cheatsheet.md) - API 速查

## 关键规则

### 为什么这些规则重要

| 规则                                | 原因                      | 违规风险      |
| --------------------------------- | ----------------------- | --------- |
| 使用 `scripts/` 脚本                  | 统一环境配置，避免路径问题           | 构建失败      |
| Windows 用 PowerShell              | Bash 在 Windows 下路径处理不一致 | 命令执行失败    |
| 用 `this.Context.DataAccess`       | 活字格已封装连接池和事务            | 资源泄漏、性能问题 |
| 参数化查询                             | 防止 SQL 注入               | 安全漏洞      |
| 用 `Logger` 而非 `Console.WriteLine` | 日志统一管理，便于排查             | 生产环境无法调试  |
| 更新 `PluginConfig.json`            | 设计与运行时必须一致              | 功能不可用     |
| 路径问题问用户                           | 避免猜测导致更多问题              | 浪费时间      |

### 核心要点速记

- **数据访问**：`this.Context.DataAccess`
- **日志**：`Logger.Info()` / `Logger.Error()`（静态类）
- **构建命令**：`dotnet build`（在项目根目录）
- **构建器**：必须用 `forguncy-plugin-create` CLI（参数化模式）

## 插件类型选择

| 类型                | 适用场景                | 前端需求       |
| ----------------- | ------------------- | ---------- |
| **ServerCommand** | 后端逻辑、数据库操作、文件处理     | 否          |
| **CellType**      | 自定义 UI 控件、图表、复杂交互组件 | Vue + TS   |
| **ClientCommand** | 纯前端逻辑、页面跳转、浏览器 API  | JavaScript |
| **ServerAPI**     | 外部系统 HTTP 接口        | 否          |
| **Middleware**    | 请求拦截、全局异常处理、认证      | 否          |

## 工作流程

### Step 1: 知识检索

先读 [DOC\_INDEX.md](references/DOC_INDEX.md)，找到对应插件类型的文档，再开始编写代码。

### Step 2: 项目初始化

使用 `forguncy-plugin-create` CLI 创建项目（**严禁 GUI 模式**）：

```bash
forguncy-plugin-create --name <PluginName> --types <types> --framework vue --lang ts --forguncy-path "<Path>" --plugin-path "<OutputPath>"
```

详细流程见 [CLI\_Reference.md](references/CLI_Reference.md)，包括：

- 环境预检（.NET SDK、CLI、活字格路径、Node.js）
- 参数组装（插件名称、类型、框架、语言）
- 退出码处理（0=成功，1=失败）

### Step 3: 需求分析与计划

正式编码前，先写计划文档：

- 位置：`plans/序号_需求简述.md`
- 内容：需求分析、模板选择、参考文档、代码变更点
- **必须等用户确认后再开始编码**

### Step 4: 编码实现

遵循 [SDK\_BestPractices.md](references/SDK_BestPractices.md)：

- `Execute` 方法返回 `ExecutionResult`
- 属性带 `[DisplayName]`（中文）
- 关键逻辑用 `try-catch` 包裹
- 用 `Logger` 记录关键步骤

### Step 5: 构建验证

```bash
dotnet build
```

MSBuild 会自动处理前端依赖（`npm install` + `npm run build`），**不要手动执行**。

### Step 6: 环境修复

遇到构建失败、程序集引用丢失：

1. 停止任务
2. 询问用户活字格安装路径（**不要猜测**）
3. 获得路径后执行 `scripts/update_references.ps1`

## 常见场景示例

**场景 1：创建新插件**

> 用户："帮我做个二维码生成的插件"
>
> 响应：检查环境 → 组装 CLI 参数 → 执行创建 → 确认成功 → 开始编写业务代码

**场景 2：实现服务器命令**

> 用户："写一个服务器命令，查询订单表"
>
> 响应：检索 DOC\_INDEX → 读取 ServerCommand 文档 → 生成计划 → 确认后编码

**场景 3：构建失败**

> 用户："dotnet build 报错了"
>
> 响应：停止任务 → 询问活字格路径 → 更新引用 → 重新构建

## 快速命令参考

```bash
# 创建项目（CLI 模式）
forguncy-plugin-create --name MyPlugin --types celltype,command,servercommand --framework vue --lang ts

# 构建
dotnet build

# 更新活字格引用
powershell -File scripts/update_references.ps1 -ForguncyPath "C:\Program Files\Forguncy 12"
```

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

forguncy-plugin-expert

Directory Structure

SKILL.md

Report

Notice