# 项目与端口注册表

> 本地运行的项目与端口绑定。**部署端口**（Docker/生产）与 **开发端口**（pnpm dev / next dev）**分离登记**，避免多项目开发时都挤在 3000 冲突。
> 维护：火炬（本地项目启动 Skill）；更新后同步 SKILL 内说明。**玩值AI** 与卡若AI 共用本表；端口冲突时见下「端口冲突处理」。
> **本机全部端口统一登记**（防 Docker/其他服务重复）：见 **`运营中枢/工作台/端口登记/SKILL.md`**（卡若AI 底下，不放在 Cursor）。部署前先查该 Skill。

**强制约定**：每次**项目、端口、启动命令或部署流程**有更新/变更时，须**同步更新本表**（含「注册项目列表」与「版本记录」），使本 doc 始终保持最新。

---

## 部署端口 vs 开发端口（隔离说明）

- **部署端口**：Docker / 生产环境对外端口，固定不变；见「注册项目列表」部署端口列。
- **开发端口**：本地 `pnpm dev`、`next dev` 等开发时使用的端口；**每个项目登记唯一开发端口**，不要多个项目都用 3000，避免同时跑多个项目时冲突。
- **本地运行某项目时**：优先用该项目的**开发端口**启动（如 `next dev -p 3102`、`pnpm dev -- -p 3102`）；若项目未写死端口，在启动命令里带 `-p 开发端口`。

---

## 端口分配与冲突处理

- **原则**：什么项目只占什么项目的端口；卡若AI / 玩值AI 登记的网站地址与端口以本表为准。
- **若登记端口被占用**：先**结束占用该端口的进程**，再**重新部署到该端口**（不改为其他端口）。  
  - 示例（玩值电竞网站 3001 被占）：`lsof -i :3001` 查 PID → `kill <PID>` 结束 → 再在神射手目录执行 `docker compose up -d`。

---

## 注册项目列表

| 项目名 | 项目路径 | 部署端口 | 开发端口 | 启动命令 | 备注 |
|:---|:---|:--:|:--:|:---|:---|
| 玩值电竞App | `/Users/karuo/Documents/开发/3、自营项目/玩值电竞App` | **3001** | **3001** | `pnpm dev` | 本机开发 package.json 固定 3001；部署用 Docker |
| 玩值电竞App（Docker 网站） | 已并入 **website** 编排 | **3001** | — | 神射手目录 `docker compose up -d --build` | web 为 `website-wanzhi-web`；唯一 MongoDB 见《唯一MongoDB约定.md》 |
| 卡若ai网站 | `/Users/karuo/Documents/开发/3、自营项目/卡若ai网站/site` | **3102** | **3102** | 开发：`pnpm dev -- -p 3102`；部署：项目根目录 `docker compose up -d --build` | 开发/部署端口隔离；**数据一律用唯一 MongoDB 27017，库名 karuo_site**，见唯一MongoDB约定、开发文档 7、数据库/全量MongoDB设计 |
| 神射手 | `开发/2、私域银行/神射手` | **3117** | **3117** | 开发按项目内脚本；部署：神射手目录 `docker compose up -d` | 与玩值电竞同编排 |
| 存客宝 Web | `开发/2、私域银行/cunkebao_v3` | **3100** | **3100** | 部署：cunkebao_v3 目录 `docker compose up -d` | 同编排含触客宝+后端+MySQL+Redis |
| 触客宝 Web | 同上 | **3101** | **3101** | 同上 | 同上 |
| 玩值大屏 | `开发/3、自营项目/玩值大屏` | **3034** | **3034** | 项目目录 `docker compose up -d` | name: website |
| Soul 创业实验 | `开发/3、自营项目/一场soul的创业实验-react` | **3000** | **3002** | 开发：`pnpm dev -- -p 3002`（避免与其它占 3000 的冲突）；部署：项目目录 `docker compose up -d` | 部署用 3000 时注意仅此项目；开发建议 3002 |
| OpenClaw 网关 | 已并入 **website** 编排 | **18789** / **18790** | — | 神射手目录 `docker compose up -d`（镜像需在 OpenClaw 项目内先 build：`openclaw:local`） | 容器名 `website-openclaw-gateway`；配置见 `开发/8、小工具/Docker项目/OpenClaw/openclaw/.env` |
| n8n | 已并入 **website** 编排 | **5678** | — | 神射手目录 `docker compose up -d` | 容器名 `website-n8n`；工作流自动化，访问 http://localhost:5678 |
| 艾叶 IM Bridge | `卡若AI/运营中枢/scripts/aiye_im_bridge` | **18900** | **18900** | `bash start.sh` 或 `python main.py` | 多平台 IM 网关（微信/企业微信/飞书/WhatsApp/网页→卡若AI） |
| 卡若AI 网关 | `卡若AI/运营中枢/scripts/karuo_ai_gateway` | **18080** | **18080** | `bash start_local_gateway.sh` | 卡若AI HTTP API 网关 |

---

## 使用方式

- **启动某项目**：说「本地运行 玩值电竞App」「本地运行 卡若ai网站」等 → 走「本地项目启动」Skill，按上表**开发端口**与启动命令执行（避免都用 3000）。
- **新增/修改绑定**：在本表增改一行，**部署端口**与**开发端口**都填；开发端口与其它项目错开，dev 脚本用 `-p 开发端口`（如 Next.js：`next dev -p 3102`），再在 Skill 中补一句说明即可。
- **Docker 网站**：玩值电竞 web、OpenClaw 网关已并入 **website** 编排（与神射手同组），容器名分别为 `website-wanzhi-web`、`website-openclaw-gateway`，端口 **3001**、**18789/18790**；**唯一 MongoDB** 为 datacenter_mongodb（27017），见工作台 **`唯一MongoDB约定.md`**。**所有归入 website 的 Docker 网站项目**（神射手、玩值电竞、OpenClaw、卡若ai网站、玩值大屏、Soul 创业实验等）见 **`website分组清单.md`**。
- **Docker 部署时**：须遵守「唯一 MongoDB」与「容器分组」约定，执行前见 **本地项目启动** Skill 内「Docker 部署约定」一节。
- **Docker 跑本地最新**：每次本地更新代码/内容后，要让 Docker 内跑的是最新文件，须在对应编排目录执行 **`docker compose up -d --build`**（如 website 在神射手目录）。否则容器内仍是旧镜像。**所有项目一律如此**。
- **玩值电竞 部署/运行/访问**：**一律用 Docker 访问，不用 pnpm dev**。访问用 **http://localhost:3001**，数据库用唯一 **wanzhi_esports**（datacenter_mongodb 27017）；启动、部署在神射手目录 `docker compose up -d --build`（更新后须带 `--build` 以同步本地最新）。回答此类问题时**须用卡若复盘格式**回复。
- **玩值电竞 专注清单与番茄钟**：卡若AI 参与玩值电竞开发或文档管理时，须将本次工作时间以**番茄钟**形式记入本机专注清单（`/Applications/WebPomodoro.app`，轻松清单）的「玩值电竞」任务下对应板块，并更新项目内 **玩值开发文档/10、项目管理/玩值电竞_专注清单与番茄钟配置.md** 的番茄钟汇总；任务结构见该文档。

---

## 版本记录

| 日期 | 变更 |
|:---|:---|
| 2026-02-26 | 初始版本；玩值电竞App 绑定 3001 |
| 2026-02-26 | 玩值电竞 专注清单与番茄钟约定：卡若AI 开发时把工作时间以番茄钟记入 WebPomodoro |
| 2026-02-26 | Docker 跑本地最新：更新后须 up -d --build；所有项目一致；注册表与 Skill 同步 |
| 2026-02-26 | **约定**：每次项目/端口/启动或部署有变更时，须同步更新本表，保持本 doc 最新 |
| 2026-02-27 | Docker 网站项目统一归入 website 分组，全量清单见 `website分组清单.md` |
| 2026-03-01 | 部署端口与开发端口隔离：表头拆为部署端口/开发端口，各项目登记开发端口，避免多项目同用 3000 冲突；卡若ai网站/Soul 等开发用登记端口 |
| 2026-03-01 | 卡若ai网站：数据一律用唯一 MongoDB 27017、库名 karuo_site，不再单独起 27018；全量库设计见项目内 开发文档/7、数据库/全量MongoDB设计_官网与控制台.md |
| 2026-03-01 | OpenClaw 网关迁入 website 编排，容器名 website-openclaw-gateway，端口 18789/18790；启动同神射手目录 |
| 2026-03-04 | n8n 归入 website 编排，容器名 website-n8n，端口 5678；神射手目录启动 |
| 2026-03-13 | 新增 艾叶 IM Bridge（端口 18900）：多平台 IM 网关；卡若AI网关（端口 18080）补登记 |