focusany-plugin-dev 技能

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

技能用途

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

• 🆕 从零开发插件：创建插件目录、config.json、入口页面、图标
• ⚙️ 配置插件能力：插件动作、匹配规则、权限、窗口设置、开发环境配置
• 🔌 接入高级能力：preload.cjs、backend.cjs、focusany API、MCP 工具、.fadata 文件编辑器
• 💰 接入付费能力：插件商品创建、支付、服务端验签回调
• 🛠️ CLI 自动化：用 focusany CLI 安装/卸载/启动插件，适合自动化测试与 CI
• 🚀 打包与发布：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、实名认证、上传审核发布
focusany CLI	plugin list / info / install / run / uninstall，本地 HTTP API 自动化
示例工程	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
• 官方 SDK：modstart-lib/focusany（/sdk 目录）
• 官网 / 开发者中心：https://focusany.com
• config Schema：https://focusany.com/sdk/config.schema.json