Skip to content

Latest commit

 

History

History
714 lines (510 loc) · 15.6 KB

PUBLISH.md

File metadata and controls

714 lines (510 loc) · 15.6 KB

发布指南

🌟 推荐方案：Microsoft Edge Add-ons（免费！）

好消息！Microsoft Edge Add-ons 商店完全免费，无需支付任何费用！

为什么选择 Edge？

特性 Edge Add-ons Chrome Web Store
注册费用 ✅ 完全免费 ❌ $5 美元
审核速度 1-3 天 1-3 天
自动更新 ✅ 支持 ✅ 支持
兼容性 ✅ 无需修改代码 -

建议：优先发布到 Edge，未来有条件再扩展到 Chrome！

👉 点击跳转到 Edge 发布教程

💰 Chrome Web Store 说明

Chrome Web Store 需要支付 $5 美元一次性注册费。

如果你暂时无法支付这笔费用，可以选择：

  • ✅ 发布到 Edge Add-ons（免费，推荐）
  • ✅ GitHub Release 分发（免费，见文档末尾）

📦 发布 Chrome 插件到 Chrome Web Store（需要 $5）

第一步：准备发布资源

1. 构建项目

npm run build

构建完成后，dist/ 文件夹就是你的插件包。

2. 准备宣传图片（必需）

图标（已准备）：

  • ✅ public/icons/icon16.png (16x16)
  • ✅ public/icons/icon32.png (32x32)
  • ✅ public/icons/icon48.png (48x48)
  • ✅ public/icons/icon128.png (128x128)

商店展示图片（需要准备）：

  1. 宣传图片（小） - 440x280 像素（必需）

    • 展示在 Chrome Web Store 的搜索结果中
    • 建议：插件界面截图 + 文字说明

  2. 宣传图片（大） - 920x680 像素（推荐）

    • 展示在插件详情页顶部
    • 建议：展示核心功能的精美图片

  3. 宣传图片（Marquee） - 1400x560 像素（可选）

    • 如果提供，会在精选区域展示

  4. 截图 - 1280x800 或 640x400 像素（推荐至少3张）

    • 展示插件的主要功能界面
    • 建议截图：
      • 图片检测界面
      • 设置界面
      • 格式转换界面
      • FAQ 模态框

3. 准备商店描述文字

简短描述（132字符以内）：

智能抓取网页图片（12种来源），支持JPEG/PNG/WebP/GIF/AVIF/SVG互转，可调质量，批量下载，防盗链突破，精准定位

详细描述： 可以使用 README.md 的内容，但需要调整格式

第二步：打包插件

方法1：直接使用 dist 文件夹（推荐）

# 1. 确保已构建
npm run build

# 2. 将 dist 文件夹打包为 ZIP
# Windows: 右键 dist 文件夹 → 发送到 → 压缩(zipped)文件夹
# 重命名为: image-hawk-v1.0.0.zip

# Mac/Linux:
cd dist
zip -r ../image-hawk-v1.0.0.zip .
cd ..

方法2：使用命令行

# Windows PowerShell
Compress-Archive -Path dist\* -DestinationPath image-hawk-v1.0.0.zip

# Mac/Linux
zip -r image-hawk-v1.0.0.zip dist/*

第三步：注册开发者账号

  1. 访问 Chrome Web Store 开发者控制台

  2. 注册开发者（需要支付 $5 一次性费用）

    • 使用 Google 账号登录
    • 支付 $5 注册费（终身有效）
    • 填写开发者信息

第四步：上传插件

  1. 点击"新增项"按钮

  2. 上传 ZIP 文件

    • 选择刚才打包的 image-hawk-v1.0.0.zip
    • 等待上传完成

  3. 填写商店信息

基本信息：

  • 名称： Image Hawk - 图片抓取与转换工具
  • 简短描述： 上面准备的简短描述
  • 详细描述： 可以参考 README
  • 类别： 生产工具（Productivity）
  • 语言： 中文（简体）、英语

图片资源：

  • 上传准备好的图标、宣传图、截图

隐私政策：

  • 如果不收集用户数据，可以写： 
    本插件不收集、存储或传输任何用户个人数据。
所有操作均在本地完成，不涉及服务器通信。

分发设置：

  • 可见性： 公开
  • 地区： 所有地区
  • 定价： 免费
  1. 提交审核
    • 检查所有信息
    • 点击"提交审核"
    • 等待审核（通常1-3天）

第五步：审核与发布

  • 审核状态： 可以在控制台查看
  • 审核通过： 插件自动发布到 Chrome Web Store
  • 审核失败： 会收到邮件说明原因，修改后重新提交

🔄 更新插件

当你需要发布新版本时：

  1. 修改版本号
// public/manifest.json
{
  "version": "1.0.1"  // 增加版本号
}
  1. 重新构建和打包
npm run build
# 打包 dist 为新的 ZIP
  1. 上传新版本
  • 在开发者控制台选择你的插件
  • 点击"上传新软件包"
  • 上传新的 ZIP 文件
  • 填写更新说明
  • 提交审核

💡 审核通过技巧

✅ 容易通过：

  • 清晰的描述和截图
  • 正确的权限声明
  • 无广告、无恶意代码
  • 隐私政策明确
  • 功能正常运行

❌ 容易被拒：

  • 权限声明过多（超出实际需要）
  • 描述不清或误导
  • 存在功能性 bug
  • 违反 Google 政策
  • 侵犯版权

你的插件优势：

  • ✅ 功能明确，无过度权限
  • ✅ 代码质量高
  • ✅ 不收集用户数据
  • ✅ 无广告、无恶意行为

通过率应该很高！ 🎉

🚀 发布后

  1. 获取插件链接

    • 发布后会获得唯一的 ID
    • 链接格式：https://chrome.google.com/webstore/detail/[插件ID]

  2. 推广插件

    • 在 GitHub 添加 Chrome Web Store 徽章
    • 社交媒体分享
    • 写博客介绍

  3. 收集反馈

    • 查看用户评论
    • 收集功能建议
    • 修复 bug

📝 注意事项

  1. manifest.json 的 version 必须递增

    • 格式：主版本.次版本.修订号（如 1.0.0 → 1.0.1）

  2. 不要泄露敏感信息

    • 检查代码中没有 API keys
    • 检查没有个人信息

  3. 保留源代码

    • Google 可能要求提供源代码审查
    • 使用 Git 版本控制

  4. 响应用户反馈

    • 及时回复用户评论
    • 提高评分和信任度

🆘 常见问题

Q: 审核要多久？ A: 通常 1-3 个工作日，首次可能需要 3-7 天

Q: 审核失败怎么办？ A: 根据邮件反馈修改，重新提交即可

Q: 可以修改已发布的插件吗？ A: 可以，但需要重新审核

Q: 用户如何获取更新？ A: Chrome 会自动更新，通常在 24-48 小时内

Q: 可以删除已发布的插件吗？ A: 可以，但会影响已安装的用户

📊 监控与分析

发布后可以在开发者控制台查看：

  • 📈 安装量
  • ⭐ 用户评分
  • 💬 用户评论
  • 📉 卸载量
  • 🌍 地区分布

持续优化插件，提升用户体验！ 🚀

🌟 发布到 Edge Add-ons 商店（免费）

Microsoft Edge Add-ons 完全免费，是最佳选择！

第一步：注册开发者账号

  1. 访问合作伙伴中心

  2. 使用 Microsoft 账号登录

    • 如果没有，可以免费注册一个

  3. 完成开发者注册

    • ✅ 完全免费！ 无需支付任何费用
    • 填写基本信息即可

第二步：准备发布资源

1. 构建项目

npm run build

2. 打包扩展

# Windows PowerShell
Compress-Archive -Path dist\* -DestinationPath image-hawk-v1.0.0.zip

# Mac/Linux
cd dist
zip -r ../image-hawk-v1.0.0.zip .
cd ..

3. 准备商店资源

必需资源：

图标（已准备好）：

  • ✅ 128x128 像素（public/icons/icon128.png）

宣传图片：

  • 小图：440x280 像素（必需）
  • 大图：1400x560 像素（推荐）

截图（推荐至少 3 张）：

  • 1280x800 或 640x400 像素

描述文字：

简短描述（132字符以内）：

智能抓取网页图片（12种来源），支持JPEG/PNG/WebP/GIF/AVIF/SVG互转，可调质量，批量下载，防盗链突破，精准定位

第三步：提交扩展

  1. 登录合作伙伴中心

  2. 创建新提交

    • 点击"新建提交"按钮

  3. 上传扩展包

    • 上传 image-hawk-v1.0.0.zip
    • 系统会自动验证

  4. 填写商店信息

基本信息：

名称：Image Hawk - 图片抓取与转换工具
类别：生产工具 / 实用工具
语言：中文（简体）、英语

详细描述：

可以使用 README.md 的内容，重点突出：

  • 12种图片来源检测
  • 6种格式转换
  • 防盗链处理
  • 精准定位功能

隐私政策：

本扩展不收集、存储或传输任何用户个人数据。
所有操作均在本地完成，不涉及服务器通信。

上传图片：

  • 上传准备好的图标、宣传图、截图
  1. 提交审核
    • 检查所有信息
    • 点击"提交审核"
    • 等待审核结果

第四步：审核与发布

审核时间

  • 通常 1-3 个工作日
  • 首次可能需要 3-5 天

审核状态

  • 可以在合作伙伴中心查看进度
  • 会收到邮件通知

审核通过

  • 自动发布到 Edge Add-ons 商店
  • 用户可以搜索并安装

审核失败

  • 会收到详细的拒绝原因
  • 修改后重新提交即可

第五步：更新扩展

当需要发布新版本时：

  1. 修改版本号
// public/manifest.json
{
  "version": "1.0.1"  // 增加版本号
}
  1. 重新构建和打包
npm run build
# 打包为新的 ZIP
  1. 提交更新
  • 在合作伙伴中心选择你的扩展
  • 点击"更新"
  • 上传新的 ZIP 文件
  • 填写更新说明
  • 提交审核

💡 Edge 发布技巧

✅ 容易通过审核：

  • 清晰的功能描述
  • 高质量的截图
  • 无过度权限请求
  • 正常运行无 bug
  • 符合 Microsoft 政策

❌ 容易被拒：

  • 描述不清或误导
  • 功能与描述不符
  • 存在恶意代码
  • 侵犯版权
  • 违反隐私政策

你的扩展优势：

  • ✅ 功能明确实用
  • ✅ 权限合理
  • ✅ 不收集数据
  • ✅ 代码质量高
  • ✅ 无广告无恶意行为

通过率应该很高！ 🎉

🔗 发布后操作

1. 获取扩展链接

  • 发布后会获得唯一的商店链接
  • 格式：https://microsoftedge.microsoft.com/addons/detail/[扩展ID]

2. 更新 README

将商店链接添加到 README.md：

## 📦 安装方法

### 🌟 Edge 用户（推荐）

1. 访问 [Edge Add-ons 商店](你的扩展链接)
2. 点击"获取"按钮
3. ✅ 自动安装完成！

3. 推广扩展

  • 在 GitHub 添加 Edge 商店徽章
  • 社交媒体分享
  • 技术社区介绍

4. 监控数据

在合作伙伴中心可以查看：

  • 📈 安装量
  • ⭐ 用户评分
  • 💬 用户评论
  • 📊 使用统计

🆘 Edge 常见问题

Q: Edge 商店审核严格吗？ A: 和 Chrome 类似，你的扩展应该很容易通过

Q: 可以同时上架 Edge 和 Chrome 吗？ A: 可以！同一份代码可以提交到两个商店

Q: 需要单独维护吗？ A: 不需要！一份代码同时兼容

Q: Edge 用户多吗？ A: Edge 市场份额约 5-10%，企业用户很多

Q: 审核失败怎么办？ A: 根据反馈修改，重新提交即可

Q: 发布后可以修改吗？ A: 可以，提交更新即可

🎯 总结

Edge Add-ons 是完美的起点！

  • ✅ 完全免费
  • ✅ 官方商店
  • ✅ 自动更新
  • ✅ 审核合理
  • ✅ 无需修改代码

建议立即发布到 Edge，积累用户和反馈！ 🚀

🎉 免费分发方案（Chrome 用户）

如果你无法支付 $5 注册费，完全可以使用以下免费方案！

✅ 方案1：GitHub Release 分发（强烈推荐）

这是最常见的开源插件分发方式，很多知名插件都这样做！

步骤：

1. 构建插件

npm run build

2. 打包 dist 文件夹

# Windows PowerShell
Compress-Archive -Path dist\* -DestinationPath image-hawk-v1.0.0.zip

# Mac/Linux
cd dist
zip -r ../image-hawk-v1.0.0.zip .
cd ..

3. 创建 GitHub Release

  1. 访问你的 GitHub 仓库
  2. 点击 "Releases" → "Create a new release"
  3. Tag: v1.0.0
  4. Title: v1.0.0 - 首次发布
  5. 描述：
## ✨ 首次发布

### 核心功能
- 🔍 支持 12 种图片来源检测
- 🔄 支持 6 种格式转换（JPEG/PNG/WebP/GIF/AVIF/SVG）
- 🛡️ 防盗链图片下载
- 📍 精准图片定位
- ⚙️ 丰富的过滤设置

### 安装方法
1. 下载下方的 `image-hawk-v1.0.0.zip`
2. 解压到本地文件夹
3. 打开 Chrome，访问 `chrome://extensions/`
4. 开启"开发者模式"
5. 点击"加载已解压的扩展程序"，选择解压后的文件夹
  1. 上传 image-hawk-v1.0.0.zip 作为 release asset
  2. 点击 "Publish release"

4. 用户安装

用户只需：

  1. 下载 ZIP
  2. 解压
  3. 在 Chrome 中加载解压后的文件夹

优点：

  • ✅ 完全免费
  • ✅ 不需要 Google 账号
  • ✅ 代码开源透明
  • ✅ 用户可以审查代码
  • ✅ 适合技术社区

缺点：

  • ⚠️ 用户需要手动更新
  • ⚠️ Chrome 启动时会提示"开发者模式"（可忽略）

✅ 方案2：自己使用（开发者模式）

如果只是自己用或给少数朋友用：

步骤：

  1. 构建项目：npm run build
  2. 打开 Chrome：chrome://extensions/
  3. 开启"开发者模式"
  4. 点击"加载已解压的扩展程序"
  5. 选择 dist 文件夹
  6. ✅ 完成！

优点：

  • ✅ 完全免费
  • ✅ 即时可用
  • ✅ 可以随时修改代码

缺点：

  • ⚠️ Chrome 每次启动会提示（点"取消"即可）
  • ⚠️ 只能手动分享给朋友

✅ 方案3：打包为 .crx 文件

步骤：

  1. 在 Chrome 中用开发者模式加载插件
  2. 点击扩展卡片上的"打包扩展程序"
  3. 生成 .crx 文件和 .pem 密钥文件
  4. 分享 .crx 文件给其他人

注意： Chrome 默认会阻止安装非商店的 .crx 文件，所以不推荐这个方法。

📊 方案对比

方案 费用 适用场景 优点 缺点
Chrome Web Store $5 面向大众用户 自动更新、官方认证、易安装 需要付费、审核慢
GitHub Release 免费 开源项目、技术用户 免费、透明、信任度高 手动更新、有提示
开发者模式 免费 个人使用、小范围分享 即时可用、方便修改 仅限本地、有提示

💡 推荐策略

现在（免费阶段）

  1. ✅ 上传到 GitHub（开源分享）
  2. ✅ 创建 Release（提供下载）
  3. ✅ 在 README 写明安装方法
  4. ✅ 自己和朋友免费使用

未来（有收入后）

  • 如果插件获得大量用户反馈
  • 如果你有了稳定收入
  • 那时再考虑支付 $5 上架商店

🌟 成功案例

很多知名的开源 Chrome 插件都采用 GitHub Release 方式分发：

  • Tampermonkey 早期版本
  • Violentmonkey
  • 各种小众但实用的技术工具

你的插件功能很强大，完全值得开源分享！ 🚀

🆘 常见问题

Q: 用户安装后会有安全提示吗？ A: 会有"以开发者模式运行"的提示，但这是正常的，点"取消"即可

Q: 功能会有区别吗？ A: 完全没有！功能100%一致

Q: 如何更新插件？ A: 用户需要下载新版本 ZIP，删除旧版本，重新加载新版本

Q: 可以统计用户数量吗？ A: 可以通过 GitHub Release 的下载次数大致估算

Q: 未来可以转到 Chrome Web Store 吗？ A: 可以！随时都可以支付 $5 上架

🎯 总结

免费方案完全可行！不要因为 $5 而放弃分享你的作品！

  • ✅ GitHub Release 是正规且常见的分发方式
  • ✅ 技术社区更喜欢开源透明的项目
  • ✅ 你的插件值得被更多人使用

开始行动吧！ 🚀