4.5 KiB
4.5 KiB
项目经验库：知己与类似项目（卡若AI 全栈开发参考）
知己项目在开发过程中沉淀的核心代码结构、分销机制、管理机制、AI 向量化及 Skill 开发经验，供卡若AI 开发类似项目时直接参考。
主责吸收：火炬（全栈开发）；协同：水泉（项目管理）、金盾（存客宝）、土基（分销）。
一、分配与协同
| 亮点 | 主责 | 协同 | 已落地 |
|---|---|---|---|
| 开发文档 10 目录制 | 火炬 | 水泉 | ✅ 项目开发能力_来自知己 |
| 项目截图自动化 | 火炬 | - | ✅ 全栈开发、项目开发能力 |
| 多 Agent 板块拆分 | 水泉 | 火炬 | ✅ 多Agent与板块拆分 |
| 存客宝获客整合 | 金盾 | 火炬 | ✅ 项目开发中整合存客宝获客功能 |
| 分销机制 | 火炬 | 土基 | 本 reference |
| 管理机制 | 水泉 | 火炬 | ✅ 项目开发能力 |
| AI 向量化 / RAG | 火炬 | - | 本 reference + 全栈开发 SKILL |
全栈开发 Skill：
04_卡火（火）/_团队成员/火炬/全栈开发/SKILL.md— 开发类似项目时自动激活。
二、核心代码结构（知己）
知己开发/
├── app/ # Next.js App Router
│ ├── page.tsx # SPA 主入口（activeTab 管理）
│ ├── api/ # API Routes
│ │ ├── booking/ # 预约订单（手机号+支付+存客宝触发）
│ │ ├── cunkebao/ # 存客宝任务、回调
│ │ ├── chat/ # AI 对话（RAG）
│ │ ├── distribution/ # 分销注册、佣金、提现
│ │ └── admin/ # 管理后台 API
│ └── admin/ # 管理后台页面
├── components/ # 页面组件
│ ├── home-page, chat-page, consultant-page, profile-page
│ ├── distribution-page # 分销中心
│ └── bottom-nav # 底部导航
├── lib/
│ ├── mongodb.ts # MongoDB 连接
│ ├── rag.ts # RAG 检索引擎（向量化+检索）
│ ├── cunkebao.ts # 存客宝线索上报
│ ├── distribution/ # 分销服务（绑定、佣金、提现）
│ ├── profit-sharing/ # 空中分账
│ └── payment/ # 支付模块
└── scripts/
├── screenshot-ui.mjs # UI 全量截图
└── vectorize-knowledge.mjs # 知识库向量化
三、分销机制（知己实现）
- 规则：一级 20%、二级 10%；30 天绑定；7 天后结算；最低提现 10 元。
- 核心：
lib/distribution/service.ts（申请分销员、绑定推荐、佣金计算、提现）。 - 空中分账：
lib/profit-sharing/service.ts（按商品类型分账：咨询师 60%、平台 40% 等）。 - API：
app/api/distribution/、app/api/referral/bind/。 - 类似项目：复制 distribution + profit-sharing 目录，改比例与集合名即可。
四、管理机制（已沉淀）
- 端口管理：启动前
lsof -i :端口检查，占用则清理。 - 附件管理：截图/设计稿 →
开发文档/10、项目管理/附件/并登记索引。 - 经验沉淀：踩坑/方案 →
references/experience-log.md。 - 复盘格式：目标&结果、过程、反思、总结、下一步。
→ 见项目开发能力_来自知己
五、AI 向量化 / RAG（知己实现）
- RAG 检索引擎：
lib/rag.ts- OpenAI Embeddings（text-embedding-3-small，1536 维）
- MongoDB 存储向量；余弦相似度检索；未配置 Key 时用占位向量（开发可跑通）
- 知识库管理：
app/admin/knowledge/（导入、向量化、检索）。 - 向量化脚本：
scripts/vectorize-knowledge.mjs（批量生成 embedding 写回库）。 - 类似项目：复制 rag.ts + 知识库 API + vectorize 脚本，改集合名与分类即可。
六、已吸收的 reference 一览
| 文档 | 用途 |
|---|---|
| 项目开发能力_来自知己 | 10 目录、端口、附件、截图、经验、复盘 |
| 项目开发中整合存客宝获客功能 | 获客型项目：指定 Key、线索上报、添加好友 |
| 十目录与五行界定 | 十目录界定、五行映射、多 Agent 拆分输入 |
| 本 reference | 知己核心代码、分销、AI 向量化、经验分配 |
主责：火炬（全栈开发）；协同：水泉、金盾、土基。开发类似项目时优先读本 reference + 上表文档。