diff --git a/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md b/02_卡人（水）/水桥_平台对接/接收短信/SKILL.md index ad1cbedd..8e144786 100644 --- 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 验证码）。 + - 也可以增加「根据服务名自动选择免费/付费平台」的路由策略，把「接码 + 注册辅助」做成更完整的一键流程。 diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index 37746f26..509d7693 100644 --- 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 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index d1bc5c6b..983c448c 100644 --- 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) | diff --git a/运营中枢/工作台/平台集成配置.md b/运营中枢/工作台/平台集成配置.md new file mode 100644 index 00000000..b074f70c --- /dev/null +++ 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/通知策略关联。 +