重构为Monorepo:拆分xhs/xhh应用与core包并完成双服务部署改造

This commit is contained in:
2026-03-03 16:06:16 +08:00
parent ed7fbdd5c2
commit 2cbd6b28b2
84 changed files with 6332 additions and 7678 deletions
+63
View File
@@ -0,0 +1,63 @@
# 小黑盒 MCP 实施计划(Monorepo 执行版)
## 1. 目标
在不改变对外协议的前提下,把项目迁移为可视化 monorepo:
- `apps/xhh-mcp` 承载小黑盒服务
- `apps/xhs-mcp` 承载小红书服务
- `packages/core` 承载共享基础设施
## 2. 小黑盒工具范围
已落地工具:
1. `xhh_check_login`
2. `xhh_get_login_qrcode`
3. `xhh_delete_cookies`
4. `xhh_list_feeds`
5. `xhh_search`
6. `xhh_get_feed_detail`
7. `xhh_get_sub_comments`
8. `xhh_get_user_profile`
9. `xhh_list_my_posts`
10. `xhh_post_comment`
11. `xhh_reply_comment`
12. `xhh_set_like_state`
13. `xhh_set_favorite_state`
统一 MCP 响应:`{ success, data, meta }`
## 3. 代码位置
- 小黑盒实现:`apps/xhh-mcp/src/platforms/xiaoheihe/*`
- 共享依赖:`packages/core/src/*`
- 小红书实现:`apps/xhs-mcp/src/platforms/xiaohongshu/*`
## 4. 构建与运行
- workspace`pnpm-workspace.yaml`
- 构建:`pnpm build`
- 启动 xhh`pnpm start:xhh`
- 启动 xhs`pnpm start:xhs`
## 5. 测试
- `apps/xhh-mcp/test/*`
- `apps/xhs-mcp/test/*`
- `packages/core/test/*`
验收命令:
1. `pnpm lint`
2. `pnpm test`
3. `pnpm build`
## 6. 部署
单 Dockerfile 双目标:
- `APP_NAME=xhs-mcp`
- `APP_NAME=xhh-mcp`
compose 与 Jenkins 已改为双服务部署(9527/9528)。