# focusany-plugin-dev-skill

**Repository Path**: modstart-lib/focusany-plugin-dev-skill

## Basic Information

- **Project Name**: focusany-plugin-dev-skill
- **Description**: FocusAny 插件开发技能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# focusany-plugin-dev 技能

FocusAny 插件开发技能，用于引导用户从零开始开发 FocusAny 桌面应用插件。

## 技能用途

当用户需要以下能力时，加载本技能：

- 🆕 **从零开发插件**：创建插件目录、`config.json`、入口页面、图标
- ⚙️ **配置插件能力**：插件动作、匹配规则、权限、窗口设置、开发环境配置
- 🔌 **接入高级能力**：`preload.cjs`、`backend.cjs`、`focusany` API、MCP 工具、`.fadata` 文件编辑器
- 💰 **接入付费能力**：插件商品创建、支付、服务端验签回调
- 🚀 **打包与发布**：`release-prepare` 生产配置切换、ZIP 打包、官网开发者中心上架

## 覆盖内容

| 模块 | 说明 |
|------|------|
| 最小插件结构 | `config.json` + `index.html` + `logo.png` 三步完成第一个插件 |
| config.json 完整配置 | schema、name/title/version、platform、setting、permissions、development |
| 插件动作 | web / code / backend / command / view / editor 六种动作类型 |
| 匹配规则 | text / key / regex / image / file / window / editor |
| 预加载脚本 | `preload.cjs` 获取渲染进程本地能力 |
| 后台脚本 | `backend.cjs` 钩子、事件、后台动作 |
| focusany API | 70+ 全局 API 速查表（窗口、剪贴板、文件、系统、LLM、数据库等） |
| MCP 工具 | 插件注册 MCP 工具开放给 AI 客户端 |
| 文件编辑器 | `.fadata` 文件格式与编辑器插件开发 |
| 付费能力 | 简化流程 + 服务端完整流程（AccessToken、签名、回调验签） |
| 打包发布 | 本地验证、`release-prepare`、实名认证、上传审核发布 |
| 示例工程 | Bare / BasicExample / FileEditorExample / VueExample / ReactExample / WebRemoteExample |

## 文件结构

```
focusany-plugin-dev/
├── SKILL.md   # 技能核心指令：开发流程、配置参考、API 速查、最佳实践
└── README.md  # 本文件：技能说明
```

## 使用方法

在会话中描述插件开发需求，AI 将按 SKILL.md 中的「开发流程模板」引导：

1. 明确插件需求（类型、技术栈、所需能力）
2. 创建工程骨架（推荐官方示例工程起步）
3. 配置 `config.json`（动作、匹配规则、权限、开发环境）
4. 开发联调（本地目录加载、输入关键字唤起、调试窗口与日志）
5. 打包发布（构建产物 → `release-prepare` → ZIP 上传 → 审核上架）

## 关联资源

- 官方示例工程：[focusany-plugin-example](https://github.com/modstart-lib/focusany-plugin-example)
- 官方 SDK：[modstart-lib/focusany](https://github.com/modstart-lib/focusany)（`/sdk` 目录）
- 官网 / 开发者中心：https://focusany.com
- config Schema：https://focusany.com/sdk/config.schema.json