迁移并现代化到腾讯云的命令行工具

tmb 的引擎(tmb/llm.py)只按 OpenAI Chat Completions 协议说话——把 endpoint 拼上 /chat/completions,加一个 Authorization: Bearer <key> 头,没有一点腾讯官方 TokenHub 的私有逻辑。所以任何 OpenAI 兼容网关都能直接接。下面以你们自建的 th.quickpapa.com(一个 OpenAI / Claude 双协议的大模型中转站)为例,从零到跑通。

① 注册账号

1. 打开 https://th.quickpapa.com/register,填 邮箱 + 密码(至少 8 位)。
2. 提交后系统发一封验证邮件,到邮箱点验证链接(24 小时内有效)完成注册。
3. 验证后赠送 ¥10 体验金自动入账,可立即用于调用。
4. 已有账号直接在 /login 登录;忘密码走「忘记密码?」。

② 新建 API Key

1. 登录后进 「密钥 / 令牌」标签页(/api/keys),点 「新建密钥」,可填备注名(如 tmb-prod)。
2. 密钥只在创建时完整显示一次,立刻复制保存(sk-…);之后列表只显示前缀。可随时吊销。

③ 配置 tmb 指向这个网关

# 持久写入配置(推荐)
tmb config set endpoint https://th.quickpapa.com/v1
tmb config set api_key  sk-xxxxxxxx                # 上一步复制的密钥
tmb config set model    tokenhub-pro               # 见下方模型 id;也可 glm-5.3 / deepseek-v4.1-flash / kimi-k3 / qwen3.5 / minimax-m3 等
tmb config                                         # 确认三连
tmb models                                         # 拉取网关可用模型,验证连通

# 临时用(环境变量,不落盘):
#   export TMB_ENDPOINT=https://th.quickpapa.com/v1  TMB_API_KEY=sk-…  TMB_MODEL=tokenhub-pro

# 团队共享:在 tmb/config.py 的 PRESETS 里加一条,之后一句切换
#   tmb config use tokenhub-self   # 预设只带 endpoint+model,api_key 不覆盖

快速自检(不走 tmb 也能验):curl -H "Authorization: Bearer sk-…" https://th.quickpapa.com/v1/models 能正常列出模型即连通。

④ 注意点

• endpoint 必须带 /v1。tmb 会自动拼 /chat/completions 和 /models,填到 /v1 为止,不要带 /chat/completions。
• model 填网关上真实部署的 id,不是腾讯官方 TokenHub 的名字。用 tmb models 或上面的 curl 看可用列表(如 tokenhub-pro、glm-5.3、deepseek-v4.1-flash、kimi-k3、qwen3.5、minimax-m3、claude-sonnet-4-5、gpt-5 等)。
• api_key 不被预设覆盖。tmb config use <name> 只改 endpoint+model,key 保留——方便在官方 / 自建 TokenHub 之间来回切而不用重输 key。
• 计费:该中转按 token 精确计费,分忙时(09:00–18:00)/ 闲时;缓存命中部分按缓存价计费,输入成本最高省 9 成;失败请求不扣费。免费额度有限,大规模 run 前先 tmb plan 看一眼规模。
• 同一网关也能喂 Claude Code / Codex:该站同时兼容 Anthropic 协议(/v1/messages + x-api-key)与 OpenAI Responses 协议(/v1/responses),Claude Code 设 ANTHROPIC_BASE_URL=https://th.quickpapa.com + ANTHROPIC_API_KEY 即可。tmb 只用 OpenAI 协议那条路。
• 能力一视同仁:蓝/绿/红分级、verify 门禁、creates[] / services[]、Agent 自愈循环,对所有后端完全相同。

每次调用 = 共享 system(00-system.md)+ 一个阶段 user prompt。Transform 有两个 user 模板:

04-transform.md  → items[]   改写【已有】源文件(带 {{FILE_CONTENT}} 原文,原地改)
04b-create.md     → creates[] 生成【全新】文件(无原文,凭 CHANGE_SPEC 产出)

例 1 — 容器化生成 Dockerfile(containerize-tencent · kind=containerfile)

File: Dockerfile   Kind: containerfile
CHANGE_SPEC: Multi-stage: builder FROM maven:3.9-eclipse-temurin-21
  mvn -q -o package -DskipTests; runtime FROM eclipse-temurin:21-jre
  COPY target/*.jar; ENTRYPOINT java -jar; EXPOSE 8080;
  HEALTHCHECK /actuator/health; USER 1000
GLOBAL_CONVENTIONS: 镜像→TCR; 凭据仅 Secret/env 不得字面量;
  /actuator/health 探针; 12-factor(PORT/DB_URL 外置)
DOMAIN_GUIDE: domains/container.md(base only)
→ 输出完整 Dockerfile,无注释 / 围栏

例 2 — 微服务拆分生成 OpenAPI 契约(monolith-to-microservices · kind=contract)

File: contracts/order-svc.openapi.yaml   Kind: contract
CHANGE_SPEC: OpenAPI 3: POST /orders, GET /orders/{id};
  schemas; auth; idempotency-key header
GLOBAL_CONVENTIONS: 每服务自包含; 跨服务不得 in-process import;
  各自 DB/schema; 共享代码放 common-lib
DOMAIN_GUIDE: domains/microservice.md(base only)

对照 —— 改写已有 OrderService.java(billingService.charge() → 对 billing-svc /charge 的 HTTP 调用)走 04-transform.md,额外注入 {{FILE_CONTENT}} 原文,原地改而非凭空生成。

# 现状 test/py-aws-multi/app.py
import boto3
s3  = boto3.client("s3",       region_name="us-east-1")
sqs = boto3.client("sqs",      region_name="us-east-1")
dyn = boto3.client("dynamodb", region_name="us-east-1")

源云=AWS、应用代码 → aws-sdk-to-tencent。S3→COS、SQS→CKafka/CMQ、DynamoDB→TencentDB。DB 是 NoSQL,无 SQL 方言迁移 —— 一个配方搞定。门禁:残留 boto3=0。

tmb run ./py-aws-multi -r aws-sdk-to-tencent

# 现状 test/java-aws-s3/S3Uploader.java
static AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion("us-east-1").build();
Class.forName("oracle.jdbc.OracleDriver");
DriverManager.getConnection("jdbc:oracle:thin:@dbhost:1521:ORCL", "u", "p");

要点:应用 SDK 迁移(S3→COS)用 aws-sdk-to-tencent;但 Oracle 库是 SQL 迁移,不在此配方范围。嵌入式 SQL 在应用内转;存储过程 / 包要单独跑 oracle-to-tdsql-pg-ora。DB 不同方言就要拆成「应用 + SQL」两步。

tmb run ./java-aws-s3 -r aws-sdk-to-tencent      # 应用 + 嵌入式 SQL
tmb run ./db        -r oracle-to-tdsql-pg-ora    # PL/SQL 包

# 现状 test/onprem-py-app/app.py
DB_URL = "mysql+pymysql://app:secret@127.0.0.1:3306/orders"
r = redis.Redis(host="localhost", port=6379, db=0)
producer = KafkaProducer(bootstrap_servers="localhost:9092")
minio_client = Minio("localhost:9000", access_key="miniokey", secret_key="miniosecret")
celery_app = Celery("worker", broker="redis://localhost:6379/1", ...)

自建中间件 → 托管 → onprem-to-tencent。MySQL→TencentDB for MySQL、Redis→TencentDB for Redis、Kafka→CKafka、ES→腾讯云 ES、MinIO→COS、Celery 保留(broker→Redis/CKafka)。多数数据面库不变,只换连接配置;MinIO→COS 换 SDK。门禁:不得残留 127.0.0.1 / localhost 自建端点。

tmb run ./onprem-py-app -r onprem-to-tencent

同是 Oracle,目标不同配方不同:TDSQL PG Oracle 兼容模式 → oracle-to-tdsql-pg-ora(轻改,大量 PL/SQL 保持);纯 PG / 社区 PG → oracle-to-tdsql-pg-pure(严格 PL/pgSQL);TDSQL-C → oracle-to-tdsql-c。UTL_FILE 等不可移植 → 红,保留 + tmb-uncertain。门禁:sqlfluff + pglast。

tmb run ./db -r oracle-to-tdsql-pg-ora

# 现状 test/java-springboot/application.yml
server:
  port: 8080
spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/orders
    password: changeme

这是打包,不是 SDK 迁移 → containerize-tencent。产出全新 creates[]:多阶段 Dockerfile、k8s/deployment.yaml + service.yaml、Secret;并把配置外置(port→${PORT:8080}、url→${DB_URL}、password→${DB_PASS})。镜像→TCR,探针打 /actuator/health。--build/--test 校验新构件。

tmb run ./java-springboot -r containerize-tencent \
  --build "docker build -t v ." --test "kubectl apply --dry-run=client -f k8s/"

# 现状 test/java-monolith/OrderService.java —— 进程内跨边界调用
private final BillingService billingService = new BillingService();
private final InventoryService inventoryService = new InventoryService();
public String placeOrder(String order) {
    inventoryService.check(order);
    billingService.charge(order);
    return "ok";
}

结构改造 → monolith-to-microservices(按 orders/billing/inventory 有界上下文拆)。creates[]:每服务 pom+入口、OpenAPI 契约、common-lib;items[]:billingService.charge() → 对 billing-svc /charge 的 HTTP 调用(超时 / 重试 / 幂等);services[] 是分解图。跨上下文 @Transactional → 红(saga/outbox)。拆完每个服务再跑 containerize-tencent。

tmb run ./java-monolith -r monolith-to-microservices --apply --yes
tmb run ./java-monolith/services/order-svc -r containerize-tencent

要三步,每步吃上一步输出:① lang-modernize(javax→jakarta,8→21)② aws-sdk-to-tencent(SDK 迁云)③ containerize-tencent(打包上 TKE)。

tmb run ./app -r lang-modernize        --apply --yes   # 1. 语言
tmb run ./app -r aws-sdk-to-tencent    --apply --yes   # 2. 云
tmb run ./app -r containerize-tencent  --apply --yes   # 3. 打包