chendelian
3f1cde1f99
All checks were successful
技能自动化发布 / release (push) Successful in 6s
Co-authored-by: Cursor <cursoragent@cursor.com>
109 lines
5.5 KiB
Markdown
109 lines
5.5 KiB
Markdown
# 平台与别名（account-manager）
|
||
|
||
**权威来源**：`scripts/util/platforms.py` 中的 `PLATFORMS`（当前 **31** 条）。若本文与代码不一致，**以代码为准**。
|
||
|
||
解析：
|
||
|
||
- **引用**（`add-web` / `ensure-web` / `pick-web` / `platform get`）：`resolve_platform_key_dynamic` — 已有键精确匹配；已有键可大小写折叠（`DeepSeek` → `deepseek`）；展示名/别名仅在**唯一**对应一个键时通过。未注册键**拒绝写入**，不会自动 `INSERT`。
|
||
- **登记**（仅 `platform ensure`）：键必须符合 `^[a-z0-9][a-z0-9_-]{1,63}$` 且**本身已是小写**（`HaoKan` 非法）；`--display-name` 必填；别名不得抢其它平台已占用的展示名/别名。
|
||
|
||
`resolve_platform_key(name)` 仍是内置表的静态别名映射（无 DB、冲突别名后写覆盖），新代码请走动态解析。
|
||
|
||
---
|
||
|
||
## 物流平台（`domain = logistics`，9）
|
||
|
||
| 英文键 | 展示名 | 供应商代码 | 别名（节选） | 默认 URL |
|
||
|---|---|---|---|---|
|
||
| `maersk` | Maersk | maersk | 马士基 | https://www.maersk.com |
|
||
| `cosco` | COSCO | cosco | 中远海运 | （空） |
|
||
| `msc` | MSC | msc | 地中海航运 | （空） |
|
||
| `cma_cgm` | CMA CGM | cma_cgm | 达飞 | （空） |
|
||
| `evergreen` | Evergreen | evergreen | 长荣 | （空） |
|
||
| `cargo_wise` | CargoWise | cargo_wise | CargoWise, Cargo Wise | （空） |
|
||
| `freightos` | Freightos | freightos | Freightos | （空） |
|
||
| `webcargo` | WebCargo | webcargo | WebCargo, web cargo | （空） |
|
||
| `sinotrans` | Sinotrans | sinotrans | 中外运 | （空） |
|
||
|
||
---
|
||
|
||
## LLM / AI 平台（`domain = llm`，10）
|
||
|
||
其中 `openai`、`anthropic` 在注册表中 **`capabilities.web = false`**，以 API Key 场景为主；其余条目多为 Web + API。
|
||
|
||
| 英文键 | 展示名 | 别名（节选） | 默认 URL |
|
||
|---|---|---|---|
|
||
| `deepseek` | DeepSeek | DeepSeek | https://chat.deepseek.com |
|
||
| `doubao` | Doubao | 豆包 | https://www.doubao.com |
|
||
| `kimi` | Kimi | 月之暗面 | https://kimi.moonshot.cn |
|
||
| `qianwen` | Qianwen | 通义千问、通义、千问 | https://tongyi.aliyun.com |
|
||
| `yiyan` | YiYan | 文心一言、文心、一言 | https://yiyan.baidu.com |
|
||
| `yuanbao` | Yuanbao | 腾讯元宝、元宝 | https://yuanbao.tencent.com |
|
||
| `gemini` | Gemini | Gemini、谷歌Gemini、Google Gemini、Bard | https://gemini.google.com |
|
||
| `minimax` | MiniMax | MiniMax | （空） |
|
||
| `openai` | OpenAI API | OpenAI、GPT、ChatGPT API | https://platform.openai.com |
|
||
| `anthropic` | Anthropic | Anthropic、Claude API | https://console.anthropic.com |
|
||
|
||
---
|
||
|
||
## 内容平台（`domain = content`，8）
|
||
|
||
| 英文键 | 展示名 | 别名（节选） | 默认 URL |
|
||
|---|---|---|---|
|
||
| `sohu` | 搜狐号 | 搜狐、搜狐号 | https://mp.sohu.com |
|
||
| `toutiao` | 头条号 | 头条、头条号 | https://mp.toutiao.com/ |
|
||
| `zhihu` | 知乎 | 知乎、知乎号 | https://www.zhihu.com |
|
||
| `wechat` | 微信公众号 | 公众号、微信、微信公众号 | https://mp.weixin.qq.com |
|
||
| `douyin` | 抖音 | 抖音、Douyin | https://www.douyin.com |
|
||
| `wechat_mp` | 微信公众号 | 微信公众号、公众号、WeChat MP | https://mp.weixin.qq.com |
|
||
| `xiaohongshu` | 小红书 | 小红书、Xiaohongshu、RED | https://www.xiaohongshu.com |
|
||
| `bilibili` | 哔哩哔哩 | B站、哔哩哔哩、Bilibili | https://www.bilibili.com |
|
||
|
||
---
|
||
|
||
## 开发控制台（`domain = dev`，3）
|
||
|
||
| 英文键 | 展示名 | 别名（节选） | 默认 URL |
|
||
|---|---|---|---|
|
||
| `github` | GitHub | GitHub、github | https://github.com/login |
|
||
| `aws` | AWS | AWS、Amazon Web Services、亚马逊云 | https://console.aws.amazon.com |
|
||
| `gcp` | GCP | GCP、Google Cloud、谷歌云 | https://console.cloud.google.com |
|
||
|
||
---
|
||
|
||
## 仿真平台（`domain = sim`，1）
|
||
|
||
| 英文键 | 展示名 | 别名（节选） | 默认 URL |
|
||
|---|---|---|---|
|
||
| `icbc_sim` | 工行仿真 | 工行仿真、ICBC Simulator、ICBC SIM | http://localhost:5180 |
|
||
|
||
---
|
||
|
||
## `platform list --domain` 说明
|
||
|
||
CLI `platform list --domain` **仅接受** `logistics | llm | content`（见 `cmd_platform_list`）。`dev` / `sim` 域平台请 **省略 `--domain`** 获取完整列表后在 JSON 中筛选，或直接 `platform get <key>`。
|
||
|
||
---
|
||
|
||
## 内置默认 `auth_strategy`
|
||
|
||
`db/platform_defaults.py` 中的 `PLATFORM_DEFAULT_AUTH_STRATEGY` 提供 **17** 个平台的初始映射（迁移时写入 `platforms.default_auth_strategy`，可被数据库手工覆盖）：
|
||
|
||
| 平台键 | 默认 `auth_strategy` |
|
||
|---|---|
|
||
| `maersk`, `cosco`, `msc` | `qr_code_manual` |
|
||
| `douyin`, `wechat_mp`, `xiaohongshu`, `bilibili`, `toutiao`, `sohu` | `qr_code_manual` |
|
||
| `github`, `aws`, `gcp` | `password_plus_2fa` |
|
||
| `icbc_sim` | `password_auto` |
|
||
| `openai`, `anthropic`, `deepseek`, `doubao` | `api_token` |
|
||
|
||
其余注册平台若 DB 中 `default_auth_strategy` 为空，则在创建账号时回落到 `resolve_auth_strategy_for_platform`（内置映射 → 否则 `password_auto`）。业务可在 `add-web` 显式传入 `--auth-strategy`。
|
||
|
||
---
|
||
|
||
## 平台注册到数据库
|
||
|
||
`seed_platforms(conn)` 在业务流程中随 `init_db()` 触发，将 `PLATFORMS` upsert 进 `platforms` 表（仅覆盖定义字段；**不会**自动清空用户自定义的 `default_auth_strategy`，除非迁移逻辑另行更新——详见 [`SCHEMA.md`](SCHEMA.md)）。
|
||
|
||
业务 skill 要加新平台：先 `platform ensure --key <小写键> --display-name <展示名> [--url …]`，再 `add-web` / `ensure-web`。不要把中文名或 `HaoKan` 这种大小写混写当成键；也不要指望 `--platform-display-name` 自动建行。
|