📋 nbAPI 未完成事项（品牌重塑 + 部署 + 官网）— Claude Code Review (2026-03-03)

[wwbluechip]

nbAPI 项目未完成事项（品牌重塑 + 部署 + 官网视角）

一、品牌重塑（~70% 完成）

已完成：README、前端 title/package.json、Dockerfile、.goreleaser.yaml、config.example.yaml

未完成：

优先级	文件/位置	残留旧品牌
严重	backend/go.mod:1	模块路径仍为 github.com/Wei-Shaw/sub2api
严重	deploy/install.sh (70+ 处)	GITHUB_REPO、INSTALL_DIR、SERVICE_NAME 等全部是 sub2api
严重	deploy/docker-deploy.sh	GitHub raw URL 指向 Wei-Shaw/sub2api
高	deploy/sub2api.service	服务名、用户名、路径全是 sub2api
高	deploy/sub2api-datamanagementd.service	同上
高	deploy/install-datamanagementd.sh	安装路径、socket 路径都是 sub2api
高	deploy/.env.example	LOG_SERVICE_NAME=sub2api、ADMIN_EMAIL=admin@sub2api.local、POSTGRES_USER/DB=sub2api
高	Dockerfile.goreleaser	注释、LABEL、用户组、二进制名全是 sub2api
中	deploy/Caddyfile	域名写的 api.sub2api.com
中	build_image.sh	Docker tag sub2api:latest
中	.gitignore:14	backend/sub2api
中	.dockerignore	注释和文件引用仍为 sub2api
低	gateway_service.go	环境变量 SUB2API_DEBUG_MODEL_ROUTING / SUB2API_DEBUG_CLAUDE_MIMIC
低	数据库迁移 SQL 注释	038、052 号迁移有 sub2api 注释（不影响功能）

二、官网（website/）

• 是一个单页 HTML 落地页（36KB），品牌已改为 nbAPI
• 链接指向 github.com/ai-yl/nbapi、demo.nbapi.org、tls.nbapi.org
• 未被 git 追踪（需要 git add 或决定是否另建仓库）
• 内容基本完整，但目前只是静态单文件，没有独立的构建/部署流程

三、部署体系

• install.sh 和 docker-deploy.sh 完全未改品牌，线上用户安装会拉到 sub2api 的资源
• systemd 服务文件名本身就叫 sub2api.service，需要重命名为 nbapi.service
• Caddyfile 域名是 api.sub2api.com，需要改为实际域名

四、建议行动计划

1. 批量替换部署脚本中的品牌名 — install.sh、docker-deploy.sh、systemd 服务文件（工作量最大，影响最直接）
2. go.mod 模块路径 — 如果不打算改（因为会导致所有 import 路径变更），可以保持跟上游一致，但要明确这个决策
3. website/ 纳入版本控制 — git add 并决定部署方式（GitHub Pages / Vercel / 自托管）
4. 重命名 systemd 文件 — sub2api.service → nbapi.service
5. 更新 Caddyfile 域名 和 .env.example 中的默认值

[wwbluechip]

品牌重塑完成 ✅

PR #741 已提交，覆盖所有剩余的 sub2api → nbapi 替换：

变更范围

• deploy/install.sh — 70+ 处替换（安装目录、服务名、用户名、二进制路径、systemd 单元、journalctl 命令等）
• deploy/docker-deploy.sh — GitHub URL、脚本标题、docker-compose 日志目标
• deploy/install-datamanagementd.sh — 安装目录、数据目录、服务文件名、用户创建、socket/db 路径
• sub2api.service → nbapi.service — 重命名 + 内容更新
• sub2api-datamanagementd.service → nbapi-datamanagementd.service — 重命名 + 内容更新
• deploy/.env.example — LOG_SERVICE_NAME、POSTGRES_USER/DB、ADMIN_EMAIL
• deploy/Caddyfile — 域名 + 日志路径
• deploy/docker-compose.override.yml.example — 服务名、DB 名、socket 路径
• build_image.sh（根目录 + deploy/）— docker 镜像标签
• .gitignore / .dockerignore — 路径引用
• gateway_service.go — SUB2API_* 环境变量 → NBAPI_*
• website/ — 纳入版本控制

验证

grep -r "sub2api\|SUB2API" . --include="*.go" --include="*.sh" --include="*.service" --include="*.yaml" --include="*.yml" --include="*.env*" --include="*.md"
# Exit code 1 — 零残留

未改项

• go.mod 模块路径暂不改（会导致所有 import 路径变更，风险太大）