# 可用工具清单

> 更新：2026-05-28 | codex

## AI 编码引擎（exec-bridge 调度）

### Codex Pro（WS 版）
- 服务：app-server
- 连接方式：WebSocket (:3460) → Codex Desktop App
- 特点：最长上下文，适合重构/新功能/多文件/UI/React
- 会话：dev / trade / learn / research
- 代理：桌面 App 自带独立代理
- 订阅：$20/月 OAuth 登录
- 登录指南：workspace/references/codex-login-guide.md

### app-server (:3460)
- 路径：~/Desktop/codex-projects/app-server.mjs
- 职责：Codex WS 代码生成引擎入口，承接 exec-bridge 的 WebSocket 任务
- 连接：本地 WebSocket，供 exec-bridge 调度 Codex Desktop App

### Claude CLI（DeepSeek 后端）
- 连接方式：spawn stdin pipe
- 特点：轻量，适合读/查看/搜索/解释/小改/git操作
- 后端：DeepSeek V4 Pro (api.deepseek.com)
- 会话：共享 session 管理
- 并发：2
- 注意：Anthropic 官方账号已封，目前用 DeepSeek API 做 provider

### Codex CLI
- 连接方式：spawn stdin pipe
- 特点：无GUI，适合自动化脚本调用
- 共享 OpenAI 后端

### Cursor Agent
- 连接方式：spawn stdin pipe（cursor agent 终端模式）
- 特点：轻量启动快，适合简单编辑/文本处理
- 单槽全局，无会话管理

## 图像生成

### ComfyUI（本地）
- 路径：~/Desktop/codex-projects/ComfyUI/
- Python：venv/bin/python（v3.14）
- 启动：main.py --listen 127.0.0.1 --port 8188
- API：POST http://127.0.0.1:8188/prompt
- 推理加速：MPS（Mac Silicon）
- 输出目录：~/Desktop/codex-projects/ComfyUI/output/
- 启动方式：cd 目录 && nohup python3 main.py > /tmp/comfyui.log 2>&1 &
- 模型下载代理：ALL_PROXY=http://127.0.0.1:19999（HuggingFace）；国内镜像优先用 hf-mirror.com

#### Checkpoints（大模型）
| 模型 | 大小 | 文件 | 路径 | 风格/用途 |
|:----:|:----:|:----:|:----:|:----:|
| DreamShaperXL | 6.4GB | DreamShaperXL.safetensors | models/checkpoints/ | 全能/幻想/像素风（XL） |
| Counterfeit-V3.0 | 4.0GB | counterfeit-v3.0.safetensors | models/checkpoints/ | 二次元动漫（SD1.5） |
| realisticVisionV51 | 4.0GB | realisticVisionV51_v51VAE.safetensors | models/checkpoints/ | 写实照片（SD1.5） |
| SVD XT | 9.6GB | svd_xt.safetensors | models/checkpoints/ | Stable Video Diffusion img2vid-xt |

#### 视频 / 动画模型
| 类型 | 文件/目录 | 大小 | 路径 |
|:----:|:----:|:----:|:----:|
| Wan2.1 I2V-14B | diffusion_pytorch_model-00001-of-00007.safetensors 至 00007 | 7 shards，约25GB | models/diffusion_models/Wan2.1-I2V-14B-720P/ |
| Wan2.1 CLIP | models_clip_open-clip-xlm-roberta-large-vit-huge-14.pth | 4.1GB | models/diffusion_models/Wan2.1-I2V-14B-720P/ |
| Wan2.1 T5 | models_t5_umt5-xxl-enc-bf16.pth | 下载中/需校验 | models/text_encoders/ |
| AnimateDiff | mm_sd_v15_v2.ckpt | - | models/animatediff_models/ |
| SDXL CLIP Vision | CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors | 2.4GB | models/clip_vision/ |

#### ControlNet / LoRA
| 类型 | 文件 | 大小 | 路径 |
|:----:|:----:|:----:|:----:|
| ControlNet Canny | control_v11p_sd15_canny.pth | 1.3GB | models/controlnet/ |
| OpenPose ControlNet | control_v11p_sd15_openpose.pth | 1.5GB | models/controlnet/ |
| SDXL Canny ControlNet | controlnet-canny-sdxl-1.0.safetensors | 4.7GB | models/controlnet/ |
| SDXL Union ControlNet | controlnet-union-sdxl-1.0.safetensors | 2.3GB | models/controlnet/ |
| LoRA | game-style-lora.safetensors | - | models/loras/ |

#### Custom Nodes（已装）
- ComfyUI-Advanced-ControlNet（ControlNet 控制）
- ComfyUI-AnimateDiff-Evolved（动画生成）
- ComfyUI-Manager（节点管理）
- ComfyUI_IPAdapter_plus（参考图引导）
- websocket_image_save（WS 图片保存）

#### 工作模式
1. **文生图** — Prompt → Checkpoint → VAE → KSampler → 图片输出
2. **图生图** — 输入参考图重绘，适合角色迭代优化
3. **AnimateDiff 动画** — 参考图 → IP-Adapter → AnimateDiff → GIF（MPS: ~4min/8帧）
4. **SVD 图生视频** — 参考图 → SVD XT → 视频帧/GIF
5. **OpenPose 控制动画** — 角色图 → 骨架序列 → ControlNet OpenPose → 动作帧
6. **API 调用（curl）** — POST /prompt 提交 workflow JSON

#### ComfyUI 动画脚本清单
| 脚本 | 位置 | 用途 |
|:----:|:----:|------|
| svd_archer_gen.py | ~/Desktop/codex-projects/rougelike-pixel-rpg/scripts/ | SVD 弓箭手图生视频实验 |
| pose_anim_pipeline.py | ~/Desktop/codex-projects/rougelike-pixel-rpg/scripts/ | OpenPose + IPAdapter + AnimateDiff 全自动动作帧管线 |
| animation_test_framework.py | ~/Desktop/codex-projects/rougelike-pixel-rpg/scripts/ | 动画帧测试、关键帧提取、循环检测、后处理 |
| animatediff_ipadapter_archer.py | ~/Desktop/codex-projects/rougelike-pixel-rpg/scripts/ | AnimateDiff + IPAdapter 弓箭手动画 |
| i2v_archer_pipeline.py | ~/Desktop/codex-projects/rougelike-pixel-rpg/scripts/ | I2V 弓箭手动画管线 |
| auto-download-models.sh | ~/Desktop/codex-projects/ComfyUI/ | SVD + Wan2.1 T5 + CLIP Vision 自动补齐脚本 |

#### 生成输出示例（output/ 目录）
| 前缀 | 用途 |
|:----:|:----:|
| cursor_gen_* | Cursor 调用生成 |
| gen_anim_* | AnimateDiff 动画 |
| pika_anim_* | 皮卡丘动画 |
| frame-* | 精灵动作帧 |
| i2i_* | 图生图 |
| pose_anim_pipeline/* | OpenPose 动画管线输出 |
| animation_test/* | 动画测试框架输出 |

### 硅基流动 SiliconFlow（云API）
- BASE_URL: https://api.siliconflow.cn/v1
- API_KEY: {{ SILICONFLOW_API_KEY }}
- 模型：Qwen/Qwen-Image（动漫风最适合）
- 国内直连，不需代理
- 文生图：POST /v1/images/generations
- 图生图：传 reference_image + image 参数

### Canvas API
- Node.js canvas 手绘 pixel art
- 适合生成精确的 sprite sheet

## 基础设施 — 双机架构

### 腾讯云广州（主服务器）
- IP: 106.53.70.187 | 用户: ubuntu | 密钥登录
- 域名: ssjsuperai.xyz（HTTPS，Certbot SSL）
- 角色: 所有面向用户的服务 + 业务逻辑
- PM2: buy-sell-signals(:3022)、learning-notes、p2-hot-trend、password-app(:3012)、search-proxy、topic-summary(:3007)、info-gap(:3016)、tunnel-hk-search
- Nginx: /etc/nginx/conf.d/web.conf
- 静态页面: /var/www/html/

### 阿里云香港（网络中转代理）
- IP: 8.217.216.15 | 用户: root | 密码登录
- 角色: 境外代理中继 + 运维救援入口
- PM2: english-game、rescue-api(:3097)、private-chat-topic
- 代理服务: Decodo 美国住宅 IP(:19999)、SSH 反向隧道(:19922)、SSH SOCKS5(:13389)
- Nginx: 代理路由

### 本地服务
- OpenClaw 网关：飞书集成
- DeepSeek：api.deepseek.com，国内直连
- task-monitor (:3455)：任务卡片唯一发送源 + 实时监控
- exec-bridge (:3461)：任务队列 + 4 引擎调度
- callback-agent (:3463)：用户身份唤醒 + AgentFlow 自动推进

## 端口映射
| 端口 | 服务 | 机器 | 说明 |
|:----:|------|:----:|------|
| 80/443 | Nginx | 腾讯云 | ssjsuperai.xyz，Certbot SSL |
| 3001 | funds | 腾讯云 | 资金统计看板 |
| 3007 | topic-summary | 腾讯云 | 话题摘要 |
| 3012 | password-app | 腾讯云 | 密码管理 |
| 3016 | info-gap | 腾讯云 | 信息差分析 |
| 3022 | buy-sell-signals | 腾讯云 | 买卖点直通车 |
| 13456 | Claude 桥 | 腾讯云 | 飞书→Claude 消息桥 |
| 3097 | rescue-api | 阿里云 HK | 一键救援 |
| 19922 | SSH 反向隧道 | 阿里云 HK | HK→Mac |
| 19999 | Decodo 代理 | 阿里云 HK | HK→Decodo→美国出口 |
| 13389 | SOCKS5 隧道 | 阿里云 HK | SSH SOCKS5 代理 |
| 3455 | task-monitor | 本地 Mac | SSH → ssjsuperai.xyz/task-monitor/ |
| 3460 | Codex WS app-server | 本地 Mac | Codex Desktop 引擎入口 |
| 3461 | exec-bridge | 本地 Mac | 任务队列 + 4 引擎调度 |
| 3463 | callback-agent | 本地 Mac | 用户唤醒 + AgentFlow |
| 8188 | ComfyUI | 本地 Mac | 图像/动画生成 |