3.6 KiB
3.6 KiB
项目状态 — Digi Kedai Bot（公开仓库）
最后更新：2026-09-06 本文件是此公开仓库的当前状态快照，供访客/协作者快速了解：这是什么、已完成什么、下一步做什么。 敏感信息（token/密码/内网拓扑）永不出现在此公开仓库，全部留在私有仓库
dsm-resource-management。
一、这是什么
Digi Kedai（digikedai.com）的多通道 AI 客服机器人，从私有仓库 hoelee/dsm-resource-management 的 bot/ 子目录抽取而来，作为独立公开仓库发布，用于展示作品 + 供他人学习/复用。
- 通道：Telegram（grammY webhook）+ WhatsApp（WA Toolbox 适配器）；Shopee/Lazada 已预留接口。
- 公开原则：只含机器人的代码、测试、文档；不含任何敏感信息（webhook secret、token、内网 IP 已全部清除）。
二、已完成（公开仓库内可见）
| 项 | 说明 |
|---|---|
| 核心架构 | 共享核心 + 通道适配器（src/core + src/channels/*） |
| 检索 | CatalogRetriever 三档关键词检索（SKU token → 整句子串 → 分段匹配），top-5 facts 注入提示词 |
| 免费试用开通 | 直接写 NocoDB（Customers + CustomerProducts），幂等 + 账号复用 + 多账号选择 |
| 确定性状态机 | 购买意图、试用领取、深链（buy-/ask- 前缀）均在 LLM 之前拦截 |
| 用户长期记忆 | user_memory KV 表 + 异步 LLM 摘要（MemoSummarizer） |
| 测试 | 175+ vitest 用例（检索/试用/购买/记忆/WhatsApp 契约） |
| 文档 | ARCHITECTURE / DEVELOPMENT / DECISIONS / OPERATIONS / ROADMAP / MEMORY_FEATURE / PURCHASE_FLOW_REDESIGN / TRIAL_ACCOUNT_SELECTION_REDESIGN |
| README | 英文 README.md + 中文 README.zh-CN.md，含在线体验、欢迎语、自我介绍、收益、目录结构、联系方式 |
| 仓库元数据 | 公开 + 12 个 topics + MIT 许可证（© Lee Teong Hoe，展示用途） |
三、私有仓库仍保留（不公开）
以下内容只在私有仓库 hoelee/dsm-resource-management，永不出现在这里：
- 真实 webhook secret、BOT_TOKEN、LiteLLM master key、Postgres 密码（
SECRETS.md§6） - DSM 内网拓扑（
mem0_net/bridge_hoelee/ 宿主路径/volume1/...） - 部署脚本
scripts/deploy_bot_dsm.py/verify_bot_dsm.py（依赖 SSH 凭据） - 商品图片、完整 catalog 生成脚本
gen_catalog.py（公开仓库只含生成的catalog.ts数据）
四、下一步（待办 / 开放决定）
- 内部拓扑脱敏（可选）：代码/文档中仍引用 Docker 服务名（
mem0-postgres、litellm、nocodb、n8n）——这些只是容器名、非敏感，但若主人想彻底隐藏内部结构，可统一改为postgres/llm-gateway等通用名。 - 双仓库同步机制：目前公开仓库是一次性抽取；私有仓库
bot/后续改动需手动同步过来（或引入子模块 / 自动镜像）。 - Shopee/Lazada 适配器：私有仓库 ROADMAP 的 Phase 3，实现时需同步到公开仓库。
- GitHub 镜像：主人习惯「先 Gitea 后 GitHub」——此公开仓库后续可推 GitHub 提升可见度。
五、维护约定
- 改 README / 加文档 → 同步更新本文件「二、已完成」与「四、下一步」。
- 私有仓库
bot/有新改动 → 评估是否需同步到公开仓库，并更新本文件。 - 敏感信息检查：任何提交前跑
grep -rniE "secret|token|sk-|192.168|/volume1" src/ docs/（排除误报）确认零泄漏。