cj66666/closer
1
0
Fork 0
Code Issues 8 Pull requests Projects Releases Packages Wiki Activity Actions

【交叉评测】对 closer 的反馈：闭环完整、护栏设计是亮点，建议补 Quick Start 与数据来源 #1

New issue
Open
opened 2026-06-05 13:42:48 +08:00 by Starry · 1 comment
Starry commented 2026-06-05 13:42:48 +08:00
Copy link

交叉评测意见

1. 项目理解

我理解 closer 面向的是跨境 B2B 中小卖家的销售团队，要解决的核心问题是询盘处理链路的低效与失控：高价值询盘被多渠道信息淹没、报价慢且易算错、底价/敏感条款靠人记忆导致风控薄弱、报价后跟进断链。项目用一个 AI 工作台把"多渠道询盘进入 → 客户建档 → 询盘评分 → 产品匹配 → 报价/PI → 风险审批 → 投递跟进 → 复盘运维"这条链路串成闭环。

2. 项目亮点

  • 闭环设计完整且贴合真实业务：八步流程不是凭空设计，而是对应了外贸销售的真实动作链，"A 级询盘晚回 12-24h 成交率下降"这种假设说明作者懂业务。
  • "AI 辅助但不越权"的护栏设计是亮点：底价、敏感承诺、大额合同必须走服务端审批，这是把 AI 用在 B2B 成交场景里最关键的安全边界，比单纯"AI 自动报价"成熟得多。
  • 工程完成度高：FastAPI + React/Vite + SQLAlchemy + PydanticAI 状态机，169 个后端测试 + 12 个前端 E2E 全通过，有真实可操作的工作台，不是纸上方案。

3. 当前问题

  • LLM 选型未说明：README 只说"用真实 LLM key 评估"，但没指明用的是 Claude / GPT-4 还是其他，不同模型在多语言询盘解析和报价生成上的表现差异很大，评审无法判断稳定性。
  • 知识库/产品价格数据的来源与导入方式不清：报价引擎依赖产品库和底价表，但 README 没说这些数据怎么录入、怎么维护，这恰恰是整个系统能不能落地的关键。
  • 多渠道接入停留在描述层：表单 / Email / WhatsApp 的实际对接（IMAP、Webhook、API 凭证）只列了名字，没有对接细节，难以判断"多渠道"是否真正打通。
  • ROI 假设缺依据："年增毛利 7.2 万"基于"3 个百分点提升"，但这个百分点从何而来没有说明，建议补一句测算口径。

4. 建议

  • 在 README 顶部补一个**「Quick Start / 本地跑通」**段落：依赖版本、环境变量模板（LLM key、SMTP/IMAP、汇率 API）、一条命令启动，让评审能复现。
  • 补一张数据流/状态机架构图，把八步 Skill 和审批护栏的触发点画出来，比纯文字更能体现设计。
  • 把"AI 不越权"做成一个显式的演示场景（如触碰底价时被审批拦截的截图/录屏），这是你最强的差异点，值得重点展示。
  • 知识库部分补一个最小可用的数据导入示例（哪怕是一个 CSV 模板），证明落地路径成立。

5. 综合评价

从当前材料看，closer 是本批项目里业务理解和工程完成度都偏上的一个：方向清晰、闭环完整、测试扎实，"AI 辅助不越权"的护栏思路尤其值得肯定。主要短板在文档侧——LLM 选型、数据来源、渠道对接、ROI 口径这几处补齐后，说服力会再上一个台阶。

## 交叉评测意见 ### 1. 项目理解 我理解 closer 面向的是**跨境 B2B 中小卖家的销售团队**，要解决的核心问题是询盘处理链路的低效与失控：高价值询盘被多渠道信息淹没、报价慢且易算错、底价/敏感条款靠人记忆导致风控薄弱、报价后跟进断链。项目用一个 AI 工作台把"多渠道询盘进入 → 客户建档 → 询盘评分 → 产品匹配 → 报价/PI → 风险审批 → 投递跟进 → 复盘运维"这条链路串成闭环。 ### 2. 项目亮点 - **闭环设计完整且贴合真实业务**：八步流程不是凭空设计，而是对应了外贸销售的真实动作链，"A 级询盘晚回 12-24h 成交率下降"这种假设说明作者懂业务。 - **"AI 辅助但不越权"的护栏设计是亮点**：底价、敏感承诺、大额合同必须走服务端审批，这是把 AI 用在 B2B 成交场景里最关键的安全边界，比单纯"AI 自动报价"成熟得多。 - **工程完成度高**：FastAPI + React/Vite + SQLAlchemy + PydanticAI 状态机，169 个后端测试 + 12 个前端 E2E 全通过，有真实可操作的工作台，不是纸上方案。 ### 3. 当前问题 - **LLM 选型未说明**：README 只说"用真实 LLM key 评估"，但没指明用的是 Claude / GPT-4 还是其他，不同模型在多语言询盘解析和报价生成上的表现差异很大，评审无法判断稳定性。 - **知识库/产品价格数据的来源与导入方式不清**：报价引擎依赖产品库和底价表，但 README 没说这些数据怎么录入、怎么维护，这恰恰是整个系统能不能落地的关键。 - **多渠道接入停留在描述层**：表单 / Email / WhatsApp 的实际对接（IMAP、Webhook、API 凭证）只列了名字，没有对接细节，难以判断"多渠道"是否真正打通。 - **ROI 假设缺依据**："年增毛利 7.2 万"基于"3 个百分点提升"，但这个百分点从何而来没有说明，建议补一句测算口径。 ### 4. 建议 - 在 README 顶部补一个**「Quick Start / 本地跑通」**段落：依赖版本、环境变量模板（LLM key、SMTP/IMAP、汇率 API）、一条命令启动，让评审能复现。 - 补一张**数据流/状态机架构图**，把八步 Skill 和审批护栏的触发点画出来，比纯文字更能体现设计。 - 把"AI 不越权"做成一个**显式的演示场景**（如触碰底价时被审批拦截的截图/录屏），这是你最强的差异点，值得重点展示。 - 知识库部分补一个**最小可用的数据导入示例**（哪怕是一个 CSV 模板），证明落地路径成立。 ### 5. 综合评价 从当前材料看，closer 是本批项目里**业务理解和工程完成度都偏上**的一个：方向清晰、闭环完整、测试扎实，"AI 辅助不越权"的护栏思路尤其值得肯定。主要短板在文档侧——LLM 选型、数据来源、渠道对接、ROI 口径这几处补齐后，说服力会再上一个台阶。
cj66666 commented 2026-06-15 00:38:55 +08:00
Owner
Copy link

感谢这条评审，指出的几个点都很具体。我们这轮按你的建议做了对应补齐：

  1. Quick Start / 本地跑通：README 已把评审入口前移，补了后端启动、前端启动、pytest、前端 build 和 E2E 命令；同时保留完整 FastAPI/PydanticAI 后端本地验证路径。
  2. LLM 选型与边界：docs/ENVIRONMENT.md 已列出 CLOSER_AGENT_MODEL、OPENAI_BASE_URL、CLOSER_GRAPH_DECISION_MODEL 等配置。当前线上 Demo 走静态 mock，本地默认 deterministic/rule_based，生产可接 OpenAI-compatible 模型，包括 MiniMax 这类兼容接口。
  3. 数据来源与导入：新增 docs/DATA_OPERATIONS.md，补了产品 CSV 模板、价格规则 JSON 模板、维护频率和责任人；其中 floor_price 是人工审批软底线，hard_min_price 是后端硬熔断线。
  4. 多渠道接入：README 和 readiness 文档明确了 site form、Email/IMAP、WhatsApp adapter 的边界；/api/v1/ops/readiness 与 /api/v1/ops/alerts 会暴露凭证缺失、token 过期/临期和通道异常。
  5. ROI 口径：docs/DATA_OPERATIONS.md 已补 “年增毛利约 7.2 万” 的假设和不成立条件，避免只给一个无法追问的数字。
  6. 护栏演示：在线 Demo 已上线，打开 https://cj66666.github.io/chengjiaoguan/ 后点击 Demo Seed，可在询盘收件箱和审批页看到底价/敏感承诺被拦截的主链路。

仍需说明的是：真实 WhatsApp/IMAP 心跳和真实 LLM 线上效果评估属于生产接线项，仓库已提供配置边界与 readiness 诊断，但没有把真实第三方账号凭证放进公开仓库。

感谢这条评审，指出的几个点都很具体。我们这轮按你的建议做了对应补齐： 1. Quick Start / 本地跑通：README 已把评审入口前移，补了后端启动、前端启动、pytest、前端 build 和 E2E 命令；同时保留完整 FastAPI/PydanticAI 后端本地验证路径。 2. LLM 选型与边界：`docs/ENVIRONMENT.md` 已列出 `CLOSER_AGENT_MODEL`、`OPENAI_BASE_URL`、`CLOSER_GRAPH_DECISION_MODEL` 等配置。当前线上 Demo 走静态 mock，本地默认 deterministic/rule_based，生产可接 OpenAI-compatible 模型，包括 MiniMax 这类兼容接口。 3. 数据来源与导入：新增 `docs/DATA_OPERATIONS.md`，补了产品 CSV 模板、价格规则 JSON 模板、维护频率和责任人；其中 `floor_price` 是人工审批软底线，`hard_min_price` 是后端硬熔断线。 4. 多渠道接入：README 和 readiness 文档明确了 site form、Email/IMAP、WhatsApp adapter 的边界；`/api/v1/ops/readiness` 与 `/api/v1/ops/alerts` 会暴露凭证缺失、token 过期/临期和通道异常。 5. ROI 口径：`docs/DATA_OPERATIONS.md` 已补 “年增毛利约 7.2 万” 的假设和不成立条件，避免只给一个无法追问的数字。 6. 护栏演示：在线 Demo 已上线，打开 `https://cj66666.github.io/chengjiaoguan/` 后点击 Demo Seed，可在询盘收件箱和审批页看到底价/敏感承诺被拦截的主链路。 仍需说明的是：真实 WhatsApp/IMAP 心跳和真实 LLM 线上效果评估属于生产接线项，仓库已提供配置边界与 readiness 诊断，但没有把真实第三方账号凭证放进公开仓库。
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
codex/eric
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cj66666/closer#1
No description provided.