init: mipu-open 对外开放项目统一管理仓库

- 添加 mipu-api 作为 git submodule (Claude Code Skill)
- 迁移 API 文档源文件到 docs/ 目录统一维护
- 添加 Gitea Actions 工作流:tag推送自动打包docs并发布Release
- Skill 运行时自动从 mipu-open Release 下载最新文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
杨柳杰
2026-05-04 12:16:08 +08:00
commit b450b512a2
38 changed files with 5473 additions and 0 deletions

View File

@@ -0,0 +1,55 @@
<!-- mipuyun-api-doc: 11_proxy-conventions -->
# Proxy约定说明
用户可在luban系统(my.mipuyun.com)管理我们提供的高质量住宅代理。
为了更有效的使用代理对于Proxy字段的发送提供以下约定
---
## 1. 指定代理地区/国家
在proxy名后拼接 `-国家码(地区码)`myproxy是代理命名举例如下
| 地区(国家) | 码 | Proxy命名举例 |
|-----------|---|--------------|
| 美国 | us | myproxy-us |
| 法国 | fr | myproxy-fr |
| 英国 | uk | myproxy-uk |
| **欧洲** | **eu** | **myproxy-eu** |
---
## 2. 利用多个代理提升agent质量
为提升agent对接的质量支持在proxy字段输入多个代理并提供串行和并发来满足各种场景
### 拼接符号介绍
| 符号 | 说明 |
|------|------|
| **竖线 \|** | 多个代理随机选择 |
| **逗号 ,** | 多个代理串行选择,希望提升成功率,但可以接受响应速度略慢的场景 |
| **加号 +** | 多个代理并发执行,应用于有较高成功率&较低响应速度的场景 |
### 代理使用示例
| 代理举例 | 适合场景 | 效果 |
|----------|---------|------|
| myproxy-us | 所有场景 | 指定US地区进行agent执行 |
| myproxy-us\|myproxy-uk | 所有场景 | 从US, UK两个地区随机选择一个进行agent执行 |
| myproxy-us\|myproxy-uk,myproxy-us\|myproxy-eu | **shopping/search** | 仅对shpping/search生效可接受较大的响应时长等待第一轮采用myproxy-us\|myproxy-uk进行对接。如果成功立即返回结束业务。如果失败采用myproxy-us\|myproxy-eu启动第二轮对接。 |
| myproxy-us + myproxy-uk | **shopping/select**<br>**shopping/baggage**<br>**shopping/seat** | 采用多线程并发模式线程a采用myproxy-us,线程b采用myproxy-uk, 同时向航司发起业务请求。 |
| myproxy-us\|myproxy-eu + myproxy-uk\|myproxy-uk | **shopping/select**<br>**shopping/baggage**<br>**shopping/seat** | 采用多线程并发模式线程a采用myproxy-us\|myproxy-eu,线程b采用myproxy-uk\|myproxy-uk, 同时向航司发起业务请求。 |
---
## 3. 异常处理
### 如果将符号用在了不支持的场景怎么办?
系统会最大限度接受异常的代理串输入,但会选择最保守的执行方式,我们会采集最小的代理信息进行执行。
**示例**
- 并发场景(select/baggage/seat)收到逗号:`myproxy-us,myproxy-uk`
- 那么执行层会变成:`myproxy-us`