Skip to content

Commit 7ba9dd7

Browse files
zcj220zcj220
committed
docs: 上架规划+商业化架构+整体执行计划(十三/十四章) 2026-03-19
- 新增「上架行动清单.md」: 平台/收款/服务器/推广/阻塞项/行动步骤全套链接 - 项目规划第十三章: 上架平台/收款架构/一键安装/后台管理/域名安全/Docker澄清/推广渠道 - 项目规划第十四章: A-J十个阶段整体执行计划+5周时间线 - 项目规划第十四章13.8: 插件登录方案(JWT+SecretStorage+侧边栏三态) - 讨论记录第六次: 2026-03-19所有架构决策
1 parent c2b20be commit 7ba9dd7

2 files changed

Lines changed: 567 additions & 2 deletions

File tree

‎上架行动清单.md‎

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
# TestPilot AI — 上架行动清单
2+
3+
> **最后更新**：2026-03-19
4+
> **目标**：VS Code Marketplace + Open VSX (覆盖 Cursor/Windsurf) 正式上架 + 国际收款打通
5+
6+
---
7+
8+
## 一、上架平台决策
9+
10+
| 平台 | 是否上架 | 理由 | 网站 |
11+
|------|---------|------|------|
12+
| VS Code Marketplace | ✅ 首选 | 全球开发者最多、生态最开放、免费上架 | https://marketplace.visualstudio.com |
13+
| Open VSX Registry | ✅ 强烈推荐 | 一次打包同时覆盖 Cursor / Windsurf / Gitpod | https://open-vsx.org |
14+
| JetBrains Plugin Repository | ❌ 暂不考虑 | 需要用 Java/Kotlin 重新开发，不是上传.vsix那么简单 | https://plugins.jetbrains.com |
15+
| GitHub Marketplace | ⚠️ 远期考虑 | 等与 GitHub CI/CD 深度集成后再评估 | https://github.com/marketplace |
16+
17+
**结论**：先打 VS Code + Open VSX 双平台，一份.vsix包两用，覆盖 90% 目标用户。
18+
19+
---
20+
21+
## 二、收款/支付方案
22+
23+
> 你有公司主体+对公账户 → 优先走 Paddle（全托管）
24+
25+
| 工具 | 类型 | 作用 | 网站 |
26+
|------|------|------|------|
27+
| Paddle | 全球支付处理器（Merchant of Record） | 向用户收钱、自动处理全球VAT/税务、开发票 | https://www.paddle.com |
28+
| Airwallex（空中云汇） | 跨境收款账户 | Paddle 打来的外币 → 换汇 → 入国内对公账户 | https://www.airwallex.com/cn |
29+
30+
> **两者是上下游关系，搭配使用：Paddle 收钱 → Airwallex 换汇入账**
31+
> 不要选 Lemon Squeezy（面向个人开发者，企业合规支持弱）
32+
33+
**Paddle 注册需要准备：**
34+
- 营业执照（扫描件）
35+
- 对公账户信息（开户行 + 账号）
36+
- 公司官网（需要境外可访问）
37+
- 产品描述 + 定价方案
38+
39+
**审核周期：** 通常 3-7 个工作日，准备好材料再提交。
40+
41+
---
42+
43+
## 三、官网与服务器
44+
45+
| 内容 | 方案 | 现状 | 网站 |
46+
|------|------|------|------|
47+
| 静态官网 | Vercel（免费，全球CDN，Git推送自动部署） | ✅ 已上线 testpilot.xinzaoai.com | https://vercel.com |
48+
| 后端API服务器 | 境外云服务器（Paddle Webhook 回调需要此地址） | 待决策 | 见下方 |
49+
| 域名 | .com 域名，二级域名分别指向前后端 | api.testpilot.xinzaoai.com 待配置 | - |
50+
| 隐私政策 | 必须在官网提供 | ❌ 缺失，需要在上架前添加 | - |
51+
52+
**推荐境外服务器：**
53+
- **轻量首选**：Digitalocean Droplet（$6/月，美国节点，延迟低，Paddle Webhook 回调稳定）→ https://www.digitalocean.com
54+
- **备选**：Vultr（$6/月，全球节点更多）→ https://www.vultr.com
55+
- **如果已有国内阿里云/腾讯云**：开通"国际版"或另购港区节点作为 Webhook 接收端
56+
57+
---
58+
59+
## 四、国内推广渠道（不能忽视！）
60+
61+
| 渠道 | 网站 | 用途 |
62+
|------|------|------|
63+
| 掘金 | https://juejin.cn | 发技术文章，AI测试工具开发者聚集 |
64+
| V2EX | https://www.v2ex.com | /go/programmer 板块，新工具接受度高 |
65+
| 少数派 | https://sspai.com | 工具类评测，带桌面客户端时效果好 |
66+
| B站 | https://www.bilibili.com | 工具演示视频，拉新效果最强 |
67+
| GitHub | https://github.com | Star 数是信任背书，README中英双语 |
68+
69+
---
70+
71+
## 五、上架前必须完成的事（阻塞项）
72+
73+
以下任一项不完成，上架后会被拒审核或用户流失：
74+
75+
- [ ] **✂️ 降低安装门槛**：提供一键安装脚本（见项目规划 §新章节）
76+
- [ ] **🔒 隐私政策页面**：在官网 `/privacy` 路径发布英文隐私政策
77+
- [ ] **🌐 英文 Marketplace 描述**：插件简介 50-100 字英文（清晰、无机翻感）
78+
- [ ] **📛 Publisher 账号**：在 https://marketplace.visualstudio.com/manage 注册 Publisher
79+
- [ ] **💳 收款链路测试**：Paddle 收款 → Airwallex 换汇 → 对公到账，全链路验证一次
80+
81+
---
82+
83+
## 六、行动清单（按顺序执行）
84+
85+
### 阶段一：本周内（上架前置条件）
86+
87+
```
88+
□ 1. 在官网添加 Privacy Policy 页面（/privacy）
89+
□ 2. 注册 VS Code Marketplace Publisher 账号
90+
□ 3. 写好插件英文简介（displayName + description，我可帮润色）
91+
□ 4. 检查 extension/package.json 的 icon、keywords、categories 是否齐全
92+
□ 5. 解决"难安装"问题（一键脚本 or 优先推云端版，见项目规划）
93+
```
94+
95+
### 阶段二：第 2 周
96+
97+
```
98+
□ 6. 执行 vsce publish 上架 VS Code Marketplace
99+
□ 7. 执行 ovsx publish 上架 Open VSX（覆盖 Cursor/Windsurf）
100+
□ 8. 注册 Paddle + Airwallex，开始资质审核（需 3-7 天）
101+
□ 9. 发掘金文章 + V2EX 帖子（带演示视频链接）
102+
```
103+
104+
### 阶段三：第 3-4 周
105+
106+
```
107+
□ 10. Paddle 审核通过 → 配置插件 License 验证 API
108+
□ 11. 配置 api.testpilot.xinzaoai.com 二级域名（指向后端服务器）
109+
□ 12. 开通付费订阅计划（对应项目规划里的积分制方案）
110+
□ 13. GitHub README 双语化（顶部英文 + 下方中文）
111+
□ 14. 录制 B 站工具演示视频
112+
```
113+
114+
---
115+
116+
## 七、参考资源
117+
118+
| 资源 | 链接 |
119+
|------|------|
120+
| VS Code 插件发布官方文档 | https://code.visualstudio.com/api/working-with-extensions/publishing-extension |
121+
| vsce CLI 工具 | https://github.com/microsoft/vscode-vsce |
122+
| Open VSX 发布指南 | https://github.com/eclipse/openvsx/wiki/Publishing-Extensions |
123+
| Paddle 开发者文档 | https://developer.paddle.com |
124+
| Paddle License API | https://developer.paddle.com/api-reference/licenses |
125+
| Airwallex 企业注册 | https://www.airwallex.com/cn/account-opening |
126+
| Vercel 部署文档 | https://vercel.com/docs |
127+
| VS Code Marketplace 管理后台 | https://marketplace.visualstudio.com/manage |
128+
| Privacy Policy 生成器（英文） | https://www.privacypolicygenerator.info |

0 commit comments

Comments
 (0)