脚手架创建扩展项目：npx 一条命令起步

写扩展不用从零搭工程。官方脚手架一条命令生成完整项目模板，开发期还能热编译。

生成项目

npx create-gopeed-ext@latest

交互式问答里填项目名、选模板（Webpack 或无构建的纯 JS 模板），完成后得到一个带构建配置的项目目录。

项目里预置的命令

• npm install：装依赖；
• npm run dev：开发模式，改代码自动编译（Webpack 模板）；
• npm run build：产出最终脚本到 dist 目录。

本地调试四步

1. 开启开发者模式：扩展页面里连续点击 5 次安装按钮——这是官方设计的隐藏开关（仅桌面平台有效）；
2. 点安装按钮选择扩展项目目录，装进客户端；
3. Webpack 模板跑 npm run dev 挂着自动编译；
4. 创建一个匹配规则内的任务，观察扩展是否按预期解析。

不想用脚手架也可以手动建项目——最小可用扩展只要两个文件：index.js 与 manifest.json，结构讲解并入manifest.json 清单详解。

调试利器：扩展日志

gopeed.logger 输出的日志写在安装目录 logs 文件夹的 extension.log 文件里，debug 级别日志仅开发者模式安装的扩展生效——tail 一下这个文件，解析过程一目了然。

相关阅读

• 运行时能力边界：goja 运行环境与存储 API。