# 插件开发调试与发布

## 本地调试方法

开发过程中可通过 Joplin 桌面版的"开发选项"加载插件：

1. 执行 `npm run dist` 打包插件为 JPL 文件
2. 打开 Joplin 设置 → 插件 → 点击齿轮图标 → "从文件安装"
3. 选择生成的 `.jpl` 文件，重启应用生效

## 发布到插件市场

当插件开发完成后，可提交到官方插件仓库：

1. 完善 README 文档，说明功能和使用方法
2. 确保 `manifest.json` 包含正确的仓库 URL 和作者信息
3. 提交 PR 到 [joplin/plugins](https://github.com/joplin/plugins) 仓库

推荐插件会被标记金色皇冠图标，如 `readme/apps/plugins.md` 所述，这些插件经过官方团队审核，具有更高的可靠性。

## 进阶开发资源

[官方插件开发学习文档](https://joplinapp.org/help/api/get_started/plugins/)

完整的 API 参考可查阅：

- [插件 API 参考](https://joplinapp.org/api/references/plugin_api/)
- [数据 API 参考](https://joplinapp.org/help/api/references/rest_api)
- [TypeScript 类型定义](api/)
- [社区插件示例](https://github.com/joplin/plugins)
- [Markdown with Front Matter Exporter/Importer](https://joplinapp.org/help/dev/spec/interop_with_frontmatter/)

以下社区插件提供了更多高级用法参考：

- 表格增强插件
- 思维导图插件
- 代码块高亮插件

## 常见问题解决

开发中遇到的问题可通过以下途径解决：

- 查阅[插件开发 FAQ](https://joplinapp.org/help/api/references/plugin_api/)
- 在[插件开发论坛](https://discourse.joplinapp.org/)提问
- 查看官方示例的 Webpack 配置

## 总结与扩展思路

Joplin 插件 API 为个性化工作流提供了无限可能。从简单的按钮添加到复杂的编辑器扩展，开发者可以根据需求定制各种功能。建议从简单功能入手，逐步探索高级接口，例如：

- 创建 Markdown 语法扩展
- 实现与第三方服务的集成
- 开发自定义数据导入导出模块

通过插件生态，Joplin 正逐渐成为一个可无限扩展的笔记平台。立即使用 `generator-joplin` 创建项目，开始你的插件开发之旅吧！