cv-cat
dc078b248b
10 个平台的 web 端全部用 TypeScript 移植自 cv-cat 的开源项目，请求与上游逐字节对拍。 统一的命令语法与 JSON 输出、按 平台 × 端 × 账号 隔离的登录态、给 AI Agent 用的技能与 llms.txt。
3.3 KiB
用 Docker 运行
不想在本机装 Node 时，可以用仓库里的 Dockerfile 构建镜像。镜像的打包方式和 npm 发布完全一样：先打出 catbus-cli、@cv-cat/catbus-assets-jd、@cv-cat/catbus-assets-ocr 三个包，再在 node:24-bookworm-slim 里全局安装，镜像里没有源码和开发依赖。
构建
git clone https://github.com/cv-cat/catbus.git && cd catbus
docker build -t catbus .
docker run --rm catbus doctor
构建时要联网：安装 npm 依赖，取回两个验证码模型（京东模型来自 GitHub 上的 cv-cat/JdApis，OCR 模型来自 PyPI 上的 ddddocr wheel，都校验 sha256）。本机已经跑过 npm run assets:jd / npm run assets:ocr 时，构建直接用已有的模型文件。镜像约 1.1 GB，其中两个模型约 115 MB。
登录态与数据
| 容器里的路径 | 用途 |
|---|---|
/data |
CATBUS_HOME：登录态、配置、二维码（对应本机的 ~/.catbus/，见 配置与数据目录） |
/work |
工作目录：item download 等命令默认写到这里 |
用一个命名卷保存登录态，下次运行还在：
docker run --rm -it -v catbus-data:/data catbus bilibili auth login # 二维码画在终端里
docker run --rm -v catbus-data:/data catbus bilibili item search 猫 --limit 20
docker run --rm -v catbus-data:/data -v "$PWD:/work" catbus xhs item download "<笔记 URL>"
-
扫码登录要加
-it，二维码才能画在终端里；PNG 也会存到卷里的cache/<平台>/qrcode.png。 -
导入 cookie 时从 stdin 读取，不用把 cookie 写进命令行：
docker run --rm -i -v catbus-data:/data catbus weibo auth login --cookie - < weibo-cookie.txt -
镜像默认以 root 运行，挂进来的任何目录都能写。Linux 上想让文件归自己所有，加
--user "$(id -u):$(id -g)"，同时把/data换成自己的目录，例如-v ~/.catbus:/data（和本机的 catbus 共用登录态）。
代理与时区
catbus 不读取 HTTP(S)_PROXY（见 配置），代理要写进卷里的 config.toml：
docker run --rm -v catbus-data:/data catbus config set proxy http://host.docker.internal:7890
镜像的时区默认是 Asia/Shanghai，可以用 -e TZ=... 覆盖。
Docker Compose
仓库根目录的 compose.yaml 提供两个服务，登录态放在命名卷 catbus-data，下载的文件落在 ./downloads：
docker compose build
docker compose run --rm catbus bilibili auth login
docker compose run --rm catbus bilibili item search 猫 --limit 20
docker compose run --rm -T catbus weibo auth login --cookie - < weibo-cookie.txt
长时间监听直播弹幕，追加写到 ./downloads/live.jsonl（每行一个 Event）：
ROOM=<直播间> docker compose --profile listen up live-listen
ROOM=<直播间> PLATFORM=douyin DURATION=2h docker compose --profile listen up live-listen
开发者
make docker构建镜像，make docker-doctor在镜像里跑catbus doctor（见 Makefile）。- CI 的 docker.yml 在 x64 与 arm64 上构建镜像并跑
version/doctor，只构建，不推送到任何镜像仓库。