# 小程序同步与上传复盘（2026-02-23）

## 目标 & 结果

- **目标**：将 GitHub 仓库 `fnvtk/Mycontent` 分支 `yongpxu-soul` 下 **miniprogram** 最新版同步到本地，并上传到微信公众平台（腾讯侧小程序后台）。
- **结果**：本地已与 GitHub 最新版一致；小程序已成功上传至微信，版本号 **1.17**，描述为「从GitHub(yongpxu-soul)同步最新版」。

---

## 过程

1. **从 GitHub 拉取 miniprogram**
   - 克隆仓库：`git clone --depth 1 --branch yongpxu-soul https://github.com/fnvtk/Mycontent.git`（临时目录）。
   - 使用 `rsync -av --delete` 将 `Mycontent/miniprogram/` 覆盖到本地目录：  
     `一场soul的创业实验/miniprogram/`。
   - 同步后删除临时克隆目录。

2. **本地上传能力整理**
   - 为 `miniprogram/上传小程序.py` 增加 **Mac 微信开发者工具 CLI** 路径：  
     `/Applications/wechatwebdevtools.app/Contents/MacOS/cli`（及用户目录下的备用路径），便于在 Mac 上自动找到 CLI。
   - 执行 `python3 上传小程序.py` 时，因 **未配置 private.key**（密钥未入库、本机未放置），脚本在「检查上传密钥」步骤退出，未执行实际上传。

3. **改用微信开发者工具 CLI 直接上传**
   - 使用本机已安装的微信开发者工具 CLI，不依赖 private.key，执行：  
     `cli upload --project <miniprogram 绝对路径> --version 1.17 --desc "从GitHub(yongpxu-soul)同步最新版"`。
   - CLI 自动完成连接/启动服务、拉取 AppID 权限、打包上传；上传成功，包体积约 259.9 KB。

---

## 本次更新内容（相对你之前本地的版本）

- **来源**：GitHub `fnvtk/Mycontent` 分支 `yongpxu-soul` 的 `miniprogram` 目录（与当前本地已一致）。
- **主要结构**（与 README 一致）：
  - **入口与配置**：`app.js`、`app.json`、`app.wxss`，`project.config.json`（AppID：wxb8bbb2b10dec74aa）、`sitemap.json`。
  - **页面**：首页、目录、找伙伴、我的、阅读、关于作者、推广中心、订单、设置、搜索（见 `app.json` pages）。
  - **能力**：自定义 TabBar、阅读/付费墙、分享海报、推广佣金、支付等；后端基地址 `https://soul.quwanzhi.com`。
  - **脚本与文档**：`上传小程序.py`、`upload.js`、`小程序快速配置指南.md`、`小程序部署说明.md`、`自动部署.sh`、`编译小程序.bat/.ps1` 等。
- **脚本层面**：仅在 `上传小程序.py` 中新增 Mac 版微信开发者工具 CLI 路径，便于后续在 Mac 上一键上传（仍可选配 private.key 使用 Node/miniprogram-ci 方式）。

---

## 反思

- **private.key**：正确做法是不把密钥提交到 Git；本机若要用 `上传小程序.py` 或 `upload.js`（miniprogram-ci）上传，需在 [微信公众平台 → 开发管理 → 开发设置 → 小程序代码上传密钥] 下载密钥，重命名为 `private.key` 并放到 `miniprogram/` 目录。
- **Mac 上传方式**：在未配置 private.key 的情况下，本机通过 **微信开发者工具 CLI** 直接上传可行（CLI 会启动或连接本地 IDE 服务完成上传），适合当前「同步 GitHub 后快速上传」的流程。

---

## 总结

- 本地 **miniprogram** 已与 GitHub `yongpxu-soul` 最新版一致。
- 小程序已上传至微信公众平台，**版本 1.17**；上传方式为本次使用的微信开发者工具 CLI（未使用 private.key）。
- 后续如需继续用「脚本/CI」上传，可在 `miniprogram/` 下配置 `private.key` 后使用 `上传小程序.py` 或 `upload.js`；若仅本机上传，可继续使用 CLI 命令。

---

## 执行（后续建议）

1. **微信公众平台**  
   - 登录 [mp.weixin.qq.com](https://mp.weixin.qq.com/) → 版本管理。  
   - 确认开发版 **1.17** 已出现；如需给体验人员使用，可设为「选为体验版」；准备发正式版则「提交审核」。

2. **下次从 GitHub 同步后再上传**  
   - 同步代码（同上 rsync 或你已有的脚本）。  
   - 上传命令示例（在终端执行）：  
     ```bash
     /Applications/wechatwebdevtools.app/Contents/MacOS/cli upload \
       --project "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram" \
       --version "1.18" \
       --desc "本次更新说明"
     ```  
     将 `1.18` 和 `本次更新说明` 按实际版本与描述修改即可。

3. **可选**  
   - 若希望用 `上传小程序.py` 在 Mac 上一键上传，可将从公众平台下载的代码上传密钥重命名为 `private.key` 放入 `miniprogram/`，再运行 `python3 上传小程序.py`。