zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/docs/内网凭据与端点.md
zizi 1a4c6970b0 docs(deploy): 记 tier2 P4 服务化部署拓扑(团队共享)——Agent Service @ mini-desktop:8200 + 真落库 MySQL/MinIO + 运行环境 
内网开发阶段、明文记端点+凭据(铁律授权)。Agent Service 起法/REST 路由/Redis 后端、BackendStore 的 MySQL 库表+MinIO 桶+key 约定、venv/worktree/装依赖法,全部落档供团队共享。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-24 07:20:13 +00:00

6.0 KiB
Raw Blame History

内网凭据与端点（authoritative · 内网阶段密钥/端点单一事实源）

创始人铁律（2026-06-18）：内网阶段,所有决策 + 密钥都进项目文档,不靠环境变量。 内网（Tailscale）地址/密钥/token 允许入仓（CLAUDE.md 已授权:"内网,地址和密码可入仓"）。需要 key 一律查本档——别再反复找创始人要。 本档 = 内网密钥/端点单一事实源。e2e / 生成产线 / 部署 / 量测 需 key 的地方都读这里。

new-api 网关（生成主线 LLM 网关）

  • NEWAPI_KEY（调网关的 token）：sk-84GAintLi0YPG92nGh3fxdIYn6sB7NuOGw0FN491qu1h8NXT
  • NEWAPI_BASE_URL：http://100.64.0.8:3000（mini-infra）
    • ⚠️ baseUrl 坑：Java（Spring AI）侧用 host 根、不带 /v1（http://100.64.0.8:3000,经 stripV1Suffix）;Python（openai）侧 base_url 要带 /v1。见 .agents/skills/saa-graph-orchestration.md §3。
  • 协议端点（同一 baseUrl、统一 NEWAPI_KEY、协议由调用方选）：
    • OpenAI 兼容：POST {baseUrl}/v1/chat/completions
    • Anthropic 原生：POST {baseUrl}/v1/messages（thinking 分离；MiniMax-M3「用对它」走这条）
    • 接入铁律（2026-06-22 纠正旧口径）：统一出口 = new-api 网关（baseUrl + NEWAPI_KEY），统一计费 / 密钥 / 审计；协议与 SDK 不锁——OpenAI 兼容 / Anthropic 原生 / 厂商 SDK 均可，只要 baseUrl 落 new-api、key 用 NEWAPI_KEY。作废「唯一 OpenAI 兼容出口 / 绝不直连厂商 SDK」旧表述（new-api 只是统一端点，不锁协议）。
  • 用途：SaaFullGraphE2eTest（-Dsaa.e2e=1）/ 生成产线 / gameDefinition 路 cutover ≥60% 量测（003-U1 第一步）都用它。
  • 上游 channel keys（new-api 配的各 provider key,非调网关 token）：game-cloud/huijing-server/src/main/resources/application.yaml 的 channels.*.api-key（行 ~207-290）。

机器（Tailscale 内网）

机器 ssh 别名 Tailscale IP 角色
6c6g（本机） — 100.64.0.9 常驻大脑（文档/计划/评审）;禁 chrome（exit 144）
mini-desktop mini-desktop 100.64.0.7 权威构建 / e2e 门（x86 同构）;staging repo /root/game-staging/repo
mini-infra mini-infra 100.64.0.8 基建（new-api:3000 / PostgreSQL / Redis / Gitea / Docker）
lili-mac lili-mac 100.64.0.10 Mac 开发执行线（非常驻,会休眠）

Git 远程

  • Aliyun Gitea：ssh://git@101.200.34.71:2222（clone/fetch/push 默认走它）

基建数据面（mini-infra 100.64.0.8 · Docker · 2026-06-24 从容器 env 抠出落档）

tier2 P4 服务化/落库要用:Agent Service 的 MessageBus/session 走 Redis;第二装载落库 manifest 进 MySQL、源文件全文进 MinIO(S3 兼容 OSS)。

服务 端点(Tailscale) 凭据 用途
Redis 100.64.0.8:6379 requirepass = 9ea28f5d28d68b09bfd7ccfc31216a52 tier2 Agent Service MessageBus / session 状态(create_app)
MySQL 100.64.0.8:3306 root / ZRH3jwYLOrntBcTAw29MW9BP tier2 落库源工程版本表(manifest);game-cloud 业务库
MinIO(S3 兼容 OSS) 100.64.0.8:9000(控制台 9001) ragflow / 6c4b77b2f055c8a66e00e3c38ef3d818c166951d478cc7cc tier2 落库源文件全文(key=tier2-src/<game_id>/<version_id>/<相对路径>)
PostgreSQL 100.64.0.8:5433(外)→5432(内) (按需补;new-api/ragflow 用) —

Redis 需 AUTH(NOAUTH 已实证);MinIO root 即 ragflow(与 ragflow 共用实例,tier2 另开 bucket 如 tier2-src 隔离)。这些是内网 Tailscale 凭据、按铁律入仓。

tier2 P4 服务化部署拓扑（2026-06-24 首次部署成功落档 · 团队共享）

内部开发阶段 · 内网环境;为开发方便,端点 + 凭据明文记录(铁律授权)。下面是「服务跑在哪、怎么起、连什么」。

Agent Service（agentscope 2.0.2 create_app）—— 跑在 mini-desktop

  • 端点:http://100.64.0.7:8200(Tailscale;本机 127.0.0.1:8200)。/docs、/openapi.json 返 200。
  • 起服务:ssh mini-desktop → cd /root/tier2-run/tier2/gen-worker && NEWAPI_KEY=<见 new-api 段> NO_PROXY=100.64.0.8 /root/.venvs/agentscope-tier2/bin/python -m service.app(无 CLI serve 命令,模块自调 uvicorn;默认 0.0.0.0:8200,TIER2_SERVICE_PORT 可改)。
  • REST 路由:/credential /agent /sessions /chat /sessions/{id}/stream(SSE 收事件)/workspace/mcp /workspace/skill /model /schedule。
  • 后端:Redis(mini-infra:6379)做 session 状态 storage(db0)+ MessageBus(db1)——见上「基建数据面」。
  • 代码:dev/2.0.0 tier2/gen-worker/service/{app,infra_config,bootstrap}.py;基建配置 tier2/config/infra.yaml(运行时读)。

第二装载落库 BackendStore(TIER2_STORE=backend 切换)

  • manifest → MySQL tier2 库 · 表 tier2_source_project_version(幂等键 (game_id, source_hash);表首次 save 自建,建库 SQL tier2/config/schema/tier2_source_project_version.sql)。
  • 源文件全文 → MinIO 桶 tier2-src · key tier2-src/<game_id>/<version_id>/<工程内相对路径>。
  • 已验:save→fetch 往返、main.js 内容字节一致(2026-06-24)。

运行环境(mini-desktop · 权威运行机)

  • venv:/root/.venvs/agentscope-tier2(agentscope[full]==2.0.2 + redis/pymysql/minio/httpx/esbuild/ws/phaser)。
  • 部署 worktree:/root/tier2-run(detached @ dev/2.0.0)。
  • 装依赖:/root/.venvs/agentscope-tier2/bin/pip install -r tier2/gen-worker/requirements.txt(含 pymysql/minio)+ redis httpx。
  • 纪律:真玩门(run_gates / chrome / esbuild)只在 mini-desktop;6c6g 禁 chrome、只做静态校验。

历史 demo 服务:feie-005 富游戏静态服务在 mini-desktop:4180(python -m http.server 4180 --directory /root/tier2-run),供创始人亲玩;非生产、可随时关。

其余基建密钥（Gitea 等）按需补入本档,别散落 env var 或只留在对话。决策同理——拍板进对应 plan / 本档,不留口头。