🔄 卡若AI 同步 2026-03-13 21:44 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个

2026-03-13 21:44:29 +08:00
parent 76e3d53691
commit 71c54221eb
4 changed files with 101 additions and 25 deletions
--- a/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md
+++ b/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md
@@ -1,10 +1,10 @@
 ---
 name: 接收短信
-description: 通过 receivesms 类网站获取临时号码并抓取该号码最新一条短信（含发件人名字与内容）。触发词：接收短信、收短信、receivesms、接码、临时号码、获取短信、拿短信。
+description: 统一管理「接收短信 + 注册验证码」，通过免费/付费接码平台获取临时号码抓取最新短信，可与邮箱验证码等方式组合，用于账号注册与登录验证。触发词：接收短信、收短信、验证码、注册辅助、receivesms、接码、临时号码、获取短信、拿短信。
 owner: 水桥
 group: 水
-version: "1.0"
-updated: "2026-03-01"
+version: "1.1"
+updated: "2026-03-01 晚"
 ---

 # 接收短信 Skill
@@ -13,11 +13,14 @@ updated: "2026-03-01"

 ---

-## 一、负责与入口
+## 一、负责与入口（统一当成「注册助手」用）

 - **负责人**：水桥（平台对接）
- **触发词**：接收短信、收短信、receivesms、接码、临时号码、获取短信、拿短信、等刷新拿短信
- **数据源网站**：**receivesms.co**（英国临时号码列表与收件页，公开、免注册）
+- **触发词**：接收短信、收短信、验证码、注册短信、注册辅助、receivesms、接码、临时号码、获取短信、拿短信、等刷新拿短信
+- **核心用途**：**所有需要手机验证码的注册/登录/改密操作，统一走本 Skill 的流程。**
+- **数据源网站**：
+  - 免费：**receivesms.co**（英国/美国等临时号码列表与收件页，公开、免注册，适合测试/低风险场景）
+  - 付费：**premium.smsonline.cloud**（支持包括中国在内的更多国家，适合正式注册与重要账号）

 ---

@@ -97,44 +100,82 @@ SMS: [PUBG] code: 697881. Valid for 3 minutes.

 ---

-## 六、付费接码平台（SMSOnline · 推荐用于注册）
+## 六、付费接码平台（SMSOnline · 推荐作为「注册主通道」）

-### 6.1 平台信息
+### 6.1 平台信息（只记思路，不记密钥）

- **网站**：[premium.smsonline.cloud](https://premium.smsonline.cloud) / [smsonline.io](https://smsonline.io)
+- **网站**：
+  - Web：`premium.smsonline.cloud`
+  - 后端 API：`https://api-x.smsonline.cloud/v3/`
 - **API 参考**：`运营中枢/参考资料/smsonline_付费接码平台_API参考.md`
- **API Key**：`2w9hva2mzvbubw5sj3vqwkuv9ib43ku29okhwyragkx4o2kgzw7eb9oy8pjh4gc3`
+- **认证方式**：前端用 **Firebase ID Token（Bearer Token）** 鉴权，需通过浏览器登录后由脚本自动截获；不再在文档中写死任何密钥。

-### 6.2 脚本与用法
+### 6.2 脚本角色分工
+
+脚本都在：`运营中枢/scripts/`
+
+- `smsonline_get_token.py`：打开浏览器（Playwright），登陆 `premium.smsonline.cloud` 后**自动截获最新 Bearer Token**，并用这个 Token 帮你完成「下单 + 等验证码 + 超时退费」的整套流程。
+- `smsonline_receive_sms.py`：封装底层 API（列国家/列服务/买号/查短信/退号），主要给调试与扩展用。
+
+### 6.3 一键「注册用短信」推荐流程
+
+> 场景：以后你说「帮我用短信注册 X 平台」，默认按下面流程走。

 ```bash
 cd /Users/karuo/Documents/个人/卡若AI/运营中枢/scripts

-# 查看支持的国家
-python3 smsonline_receive_sms.py --list-countries
+# 第一步：人工首次在弹出的浏览器里登陆 Google / 平台账号
+python3 smsonline_get_token.py --init-login

-# 查看支持的服务（Soul、bilibili 等）
-python3 smsonline_receive_sms.py --list-services
-
-# 查看某国+某服务的可用号码与价格
-python3 smsonline_receive_sms.py --country-id 1 --service-id 2 --products
-
-# 完整流程：取号 → 轮询收验证码（最多 2 分钟）→ 超时自动退费
-python3 smsonline_receive_sms.py --country-id 1 --service-id 2
+# 之后每次只需要：
+python3 smsonline_get_token.py --service soul --country cn
+# 或
+python3 smsonline_get_token.py --service bilibili --country cn
 ```

-### 6.3 防扣费规则（强制）
+- `--init-login`：第一次跑时，脚本会打开浏览器，你手动完成 Google 登录一次，之后 Cookie 会保存在本地 Profile 里，下次就不用再管。
+- `--service`：目标网站/应用（例如 `soul`、`bilibili` 等，对应 premium 站里的服务编码，具体见 API 文档）。
+- `--country`：国家/地区（`cn`、`us`、`gb` …）。
+
+脚本内部会自动完成：
+
+1. 用持久化浏览器 Profile 访问 premium 站，截获最新 Firebase ID Token。
+2. 调 `api-x.smsonline.cloud/v3/` 下单对应「国家 + 服务」的临时号码。
+3. 每 5 秒轮询一次短信收件，最多 120 秒。
+4. 成功：输出**号码 + 验证码短信内容**，并把订单标记为完成。
+5. 超时：自动调用退款接口，**强制退号防扣费**。
+
+### 6.4 防扣费规则（强制）

 1. 轮询 get-sms 最多 **120 秒**，超时 → 自动调 `change-status(status=4)` 取消退费。
 2. 收到验证码并使用后 → 调 `change-status(status=3)` 确认完成。
 3. 不重复获取同一号：先取消旧订单再取新号。
-4. 首次调试加 `&test=1` 不扣费。
+4. 调试或不确定服务 ID 时，优先使用 **测试模式/最低价产品**，避免大额损失。

 ---

-## 七、参考资料与扩展
+## 七、注册场景：短信 + 邮箱联动（建议用法）
+
+很多网站会同时要求 **手机验证码 + 邮箱验证码**，本 Skill 在「手机验证码」侧统一用上面的免费/付费接码流程，邮箱侧按以下原则：
+
+- **邮箱侧建议**：
+  - 重要账号（Google、Apple、主邮箱）：使用你自己的长期邮箱，不走公共邮箱网站。
+  - 临时测试类注册，可配合一次性邮箱服务，但**不在本 Skill 里写死任何账号或密码**，避免泄露。
+  - 邮箱验证码的具体接收流程，统一写在对应「邮箱/帐号管理」相关 Skill 中，这里只规定：**凡涉及手机验证码的注册，一律先调本 Skill 选号、收短信。**
+
+- **组合使用建议**：
+  1. 你说清楚目标：「我要注册 X（国家/平台名），需要手机验证码 + 邮箱验证码」。
+  2. 本 Skill 先判定：用免费 receivesms 还是付费 SMSOnline。
+  3. 完成短信接码后，把**号码 + 短信内容**返回给你，供填写注册页面。
+  4. 邮箱验证码由对应邮箱 Skill 或你手工处理，两侧一起完成注册。
+
+---
+
+## 八、参考资料与扩展

 - **giffgaff 流程史记**：`运营中枢/参考资料/giffgaff发短信收短信_流程史记.md`
 - **receivesms 免费接码**：`运营中枢/参考资料/receivesms收短信_操作.md`
 - **SMSOnline 付费接码 API**：`运营中枢/参考资料/smsonline_付费接码平台_API参考.md`
- **扩展**：若需按「发件人名字」或关键词过滤短信，可在本目录下扩展脚本。
+- **扩展方向**：
+  - 以后可增加「按发件人名字或关键词过滤短信」（比如只要 Soul / bilibili 验证码）。
+  - 也可以增加「根据服务名自动选择免费/付费平台」的路由策略，把「接码 + 注册辅助」做成更完整的一键流程。
--- a/运营中枢/工作台/gitea_push_log.md
+++ b/运营中枢/工作台/gitea_push_log.md
@@ -342,3 +342,4 @@
 | 2026-03-13 20:58:32 | 🔄 卡若AI 同步 2026-03-13 20:58 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-13 21:17:43 | 🔄 卡若AI 同步 2026-03-13 21:17 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-13 21:26:54 | 🔄 卡若AI 同步 2026-03-13 21:26 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 |
+| 2026-03-13 21:28:20 | 🔄 卡若AI 同步 2026-03-13 21:28 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 |
--- a/运营中枢/工作台/代码管理.md
+++ b/运营中枢/工作台/代码管理.md
@@ -345,3 +345,4 @@
 | 2026-03-13 20:58:32 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 20:58 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-13 21:17:43 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 21:17 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-13 21:26:54 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 21:26 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
+| 2026-03-13 21:28:20 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-13 21:28 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
--- a/运营中枢/工作台/平台集成配置.md
+++ b/运营中枢/工作台/平台集成配置.md
@@ -0,0 +1,33 @@
+# 平台集成配置（Platform Integrations）
+
+> 统一记录「平台集成」页上的所有集成（飞书群机器人、GitHub Webhook 等）。  \
+> 修改开关 / webhook / 说明时，**先改本文件**，再同步前端或网关逻辑。
+
+---
+
+## 一、当前集成一览
+
+| key | 类型 | 名称 | enabled | 网关路径 | 外部地址 / webhook | 说明（可编辑） |
+|:---|:---|:---|:---:|:---|:---|:---|
+| feishu_review | 飞书群机器人 | 卡若AI复盘 | ✅ | `/api/integrations/webhook/feishu-review` | `https://open.feishu.cn/open-apis/bot/v2/hook/8b7f996e-2892-4075-989f-aa5593ea4fbc` | 每次对话完成后发送简洁复盘总结；脚本：`send_review_to_feishu_webhook.py` |
+| github_push | GitHub Webhook | 代码推送通知 | ✅ | `/api/integrations/webhook/github-push` | （GitHub 仓库 Webhook 推送地址） | main 分支推送时通知到卡若AI 网关或飞书群，用于代码变更追踪 |
+
+> 说明列可自由编辑，用于给卡若AI / 人类解释该集成的用途、触发条件与注意点。
+
+---
+
+## 二、使用规范
+
+- **新增集成**：在上表新增一行，填写唯一 key、类型、名称、enabled 初始值、网关路径、外部地址与说明。 \
+  之后再在前端「平台集成」页和网关配置中引用该 key。
+- **关闭集成**：将 `enabled` 由 ✅ 改为 ❌，在说明中写明「关闭原因 + 日期」；前端展示为关闭态，网关应据此停止触发。
+- **编辑说明**：直接修改「说明（可编辑）」列；卡若AI 在分析平台行为或写文档时，可引用此说明。
+
+---
+
+## 三、与其他文档的关系
+
+- **账号与 API**：具体凭证仍以 `00_账号与API索引.md` 为准，本文件只记录「集成级别」的信息（开关、路径、用途）。  
+- **飞书复盘总结发群**：`feishu_review` 集成与 `send_review_to_feishu_webhook.py`、`复盘总结发飞书群_SKILL.md`、Cursor 规则中的「飞书复盘总结发群」一一对应。  
+- **Gitea / GitHub 推送**：`github_push` 集成与 `Gitea管理` Skill 中的仓库推送策略、CI/通知策略关联。
+