华锐 AI 智能服务平台架构方案

AI 平台架构方案

本方案用于指导华锐 AI 智能服务平台的一期到三期建设。业务后台由团队自研， Dify 负责 AI 应用和工作流编排，RAGFlow 负责企业知识库和文档检索，模型调用统一走已有模型中转站。

适用对象：业务、产品、开发、交付架构模式：自研业务系统 + AI 能力底座核心原则：业务权限和计费必须收口到自研后台

管理层摘要

这份方案的核心判断：项目可以先用 Dify、RAGFlow 和已有模型中转站快速搭起 AI 能力，但企业、代理商、订单、分佣、计费和权限必须由自研业务后台掌握。

开发难度

不是普通官网，属于中高难度平台型项目。难点在多角色、计费、知识库隔离和 AI 调用链路。

一期目标

先跑通企业开通、AI 工具使用、知识库问答、用量记录、代理商归属和总部配置。

核心资产

客户数据、用量数据、代理商关系、产品套餐、计费流水和知识库权限是平台的长期资产。

主要风险

如果一期范围过大，同时做支付、分佣、政企项目、私有化和培训认证，周期会明显拉长。

老板需要确认的关键决策

决策点	建议	影响
一期是否做真实收款	一期可以先做订单和余额记录，支付接口可放二期。	影响财务对账、退款、发票和上线周期。
是否给代理商看分佣	一期可先展示预计分佣，正式结算放二期。	减少财务规则未定导致的返工。
知识库是否按企业独立	必须独立，每个企业至少对应独立知识库或独立权限空间。	影响数据安全和后期政企客户合作。
AI 工具先做多少个	一期建议 5 到 10 个高频工具，不追求一开始上百个。	工具越多，Prompt 调试、计费、客服和验收成本越高。
是否允许客户自建智能体	一期先由总部配置，客户只使用；自建能力放二期。	降低权限、越权调用和使用复杂度风险。

市场竞品调研

市面上已经有不少企业在做 AI 搜索可见度、GEO/AEO、AI Agent 工作流和企业知识库平台。但多数产品只覆盖其中一段链路，真正把“监测、诊断、自动执行、点数扣费、代理商运营、交付服务”打通的平台还不多。

1. 国外 AI 搜索可见度 / GEO 平台

产品	主要能力	对我们的启发
Semrush AI Visibility / AIO	传统 SEO 数据结合 AI 搜索可见度，追踪品牌在 AI 平台里的声量、情绪、Prompt 级表现和优化建议。	说明传统 SEO 巨头已经进入 GEO/AEO，市场方向成立，但企业版偏重数据和监测。
Writesonic GEO	定位为 AI Search Visibility Platform，做 AI 可见度监测、品牌排名、市场份额、内容优化建议。	证明“AI 搜索可见度 + 内容优化”已经成为成熟 SaaS 方向。
AthenaHQ	提供跨平台 AI 搜索监控、竞品情报、幻觉检测、引用追踪和内容行动建议。	竞品监测和引用追踪是 GEO 产品的标配能力，后期应纳入我们平台。
Otterly.AI	监测 ChatGPT、Google AI Overviews、Gemini、Perplexity、Copilot 等平台的品牌提及和网站引用。	可以参考它的“Prompt 监测 + 品牌覆盖率 + 引用来源”作为 GEO 看板设计。
Peec AI	面向营销团队提供 AI visibility insight，用于内容策略、竞品对比和 AI 搜索表现分析。	说明客户不只要生成内容，也需要知道“有没有被 AI 推荐”。

2. 国内 GEO / AI 搜索优化服务

类型	代表方向	市场现状
品牌可见度监测	搜搜果、Citecho、GEOly、GeoSaaS 等。	主要做 DeepSeek、豆包、Kimi、通义千问、ChatGPT 等平台的品牌提及、推荐排名和引用检测。
GEO 服务商	百搜 GEO、向量 GEO、商赢网络、华万营销 GEO 等。	更偏代运营和服务交付，强调内容生产、结构化优化、媒体分发和 AI 推荐率提升。
SEO/GEO 一体化营销平台	部分传统 SEO 公司开始包装 AI 搜索优化、AI 内容发布和多平台分发。	市场教育正在形成，但产品标准还不统一，存在较大差异化空间。

3. AI Agent / 工作流平台

产品	主要能力	和我们的关系
Dify	AI 应用、工作流、Agent、知识库和工具调用。	适合作为我们的一期 AI 应用编排底座。
Coze / 扣子	低代码智能体、插件、知识库、工作流、多端发布。	说明低代码智能体市场需求明确，但它不是我们的业务后台和渠道系统。
DeerFlow	任务规划、多智能体协作、长任务执行、工具调用和沙箱能力。	适合作为二期复杂 SEO/GEO 自动化任务执行引擎。
n8n / Make / Zapier	自动化工作流、Webhook、第三方系统集成。	可以参考自动化执行和日志设计，但业务计费、代理体系仍需自研。

4. 我们的差异化机会

不只监测，还要执行

很多 GEO 工具偏监测和报告。我们可以做“一键诊断、一键生成、一键优化、人工确认发布”。

服务商和代理商友好

多数 SaaS 面向品牌方。我们可以重点做城市合伙人、代理商客户管理、点数包、分佣和交付跟进。

适配国内 AI 平台

重点覆盖 DeepSeek、豆包、Kimi、通义千问、文心一言、腾讯元宝等国内客户关心的平台。

点数化产品包装

把复杂模型成本包装成客户能理解的点数包、任务包、月度服务包，更适合渠道销售。

AI 智能体代办

客户不用理解 SEO/GEO 细节，直接对话说目标，系统自动拆任务、估点数、执行和出报告。

本地交付闭环

通过代理商和总部服务团队做诊断、陪跑、复盘和续费，不只是卖工具账号。

结论：市面上有人在做 GEO，但大多是“监测平台”或“营销服务商”。我们要避免直接和 Semrush、Writesonic 这类工具拼数据规模，而应走“AI 自动化任务 + 点数计费 + 代理商服务交付”的差异化路线。

产品包设计

平台需要把复杂 AI 能力包装成业务员容易讲、客户容易买、后台容易计费的产品包。一期建议用“点数包 + 标准任务包 + 月度服务包”组合销售。

1. 面向企业客户的产品包

产品包	适合客户	包含能力	计费方式
AI 基础体验包	刚接触 AI 的中小企业。	基础对话、文案生成、办公助手、少量知识库问答、基础用量看板。	低价套餐 + 限定点数。
企业知识库包	有产品资料、合同、政策、培训资料的企业。	资料上传、文档解析、知识库问答、引用来源、员工权限。	按知识库容量、文件数量和问答点数。
SEO/GEO 诊断包	有官网、品牌曝光和获客需求的企业。	网站诊断、关键词分析、AI 搜索可见度检查、优化建议报告。	按任务固定点数或单次任务包。
SEO/GEO 增长包	希望持续获客和内容增长的企业。	月度诊断、内容生成、FAQ 生成、落地页文案、GEO 资料优化、效果复盘。	月度服务费 + 点数消耗。
行业智能体包	有明确业务流程的行业客户。	客服智能体、销售话术智能体、政策问答智能体、合同审查智能体等。	开通费 + 月费 + 用量点数。
定制项目包	政企、园区、中大型企业。	私有知识库、专属智能体、流程对接、报告系统、私有化部署或专属算力。	项目制报价 + 运维服务费。

2. 面向代理商的产品包

产品包	用途	代理商能卖什么	总部支持
代理启动包	帮助代理商快速开局。	体验账号、基础 AI 工具、客户演示、标准招商物料。	授权资料、培训、演示脚本、基础售前支持。
城市运营包	适合城市合伙人做本地市场。	企业账号、SEO/GEO 诊断、知识库服务、培训活动。	区域看板、客户归属、预计分佣、活动物料。
行业解决方案包	适合有行业资源的代理商。	制造、教育、餐饮、文旅、政务等行业 AI 方案。	行业模板、方案 PPT、案例材料、交付支持。
政企项目协作包	适合有园区、协会、政府资源的团队。	产业 AI 服务、培训认证、项目申报、示范案例。	品牌背书、技术方案、联合交付、项目支持。

3. 点数换算示例

项目	扣点方式	示例规则	备注
普通 AI 对话	按 Token 换算	根据模型成本换算为点数，前端只展示点数。	适合高频轻量使用。
知识库问答	检索 + 生成扣点	每次问答包含检索成本和模型生成成本。	需要记录知识库 ID 和引用来源。
SEO 基础诊断	固定点数	每个网站单次诊断固定扣点。	适合销售演示和低门槛成交。
GEO 深度优化报告	按步骤扣点	品牌分析、竞品分析、内容建议、报告生成分别扣点。	失败时可按完成步骤结算。
自动发布	额外扣点	客户授权后，按发布平台和发布条数扣点。	一期建议人工确认后发布。

一、项目定位

这个项目不是单纯的聊天工具，也不是普通招商官网，而是面向企业客户、代理商、城市合伙人和总部运营团队的 AI 服务平台。

企业客户

使用 AI 工具、企业知识库、行业智能体和服务工单。

代理商

管理客户、查看用量、跟进服务、获得分佣和区域收益。

总部运营

配置产品、套餐、价格、代理政策、AI 应用和交付流程。

技术团队

维护模型中转站、AI 调度服务、Dify、RAGFlow 和部署运维。

一期重点不是自研所有 AI 底层能力，而是把业务闭环跑通：用户登录、企业开通、AI 工具使用、知识库上传、Token 计量、代理商归属、后台管理和日志审计。

一期范围建议

一期建议按“能演示、能开通、能使用、能记录、能管理”的原则建设。先证明商业闭环，再扩展分佣结算、交付管理和政企项目。

一期必须做

企业账号和代理商账号
总部后台基础管理
AI 工具广场和对话工作台
Dify 应用接入
RAGFlow 知识库上传和问答
Token 用量记录和余额展示
企业、用户、代理商归属关系
调用日志和错误日志

一期建议简化

支付：先人工确认收款
分佣：先记录预计分佣
发票：先记录开票需求
客服：先做简单工单
数据看板：先做核心指标
AI 工具数量：先做高频工具

一期不建议做

复杂财务结算和自动打款
完整培训认证系统
政企项目全过程管理
客户自助搭建复杂 Agent
私有化部署自动化平台
自研文档解析和向量引擎

二、总体架构

所有用户请求先进入自研业务系统，再由 AI 调度服务转发到 Dify、RAGFlow 和模型中转站。不建议让用户端直接访问 Dify 或 RAGFlow。

访问层

企业端AI 工具、知识库、工单、用量

代理商端客户、线索、收益、服务跟进

总部后台产品、套餐、权限、运营配置

开放接口第三方系统、政企项目、渠道系统

↓

自研业务层

用户与企业账号、组织、角色、权限、数据隔离

代理商体系区域授权、客户归属、合伙人等级

订单与钱包套餐、充值、余额、发票、退款

分佣结算分润规则、结算单、补贴、奖励

↓

AI 调度层

鉴权与限流套餐校验、余额校验、频控、黑名单

应用路由根据产品选择 Dify App 或 RAGFlow 知识库

用量记录Token、耗时、模型、成本、用户归属

流式转发SSE/WebSocket、错误处理、重试和降级

↓

AI 能力层

DifyAI 应用、Prompt、工作流、Agent、工具调用

RAGFlow文件解析、切片、索引、知识库检索

模型中转站模型路由、Key、限流、成本、调用日志

工具服务OCR、搜索、业务 API、外部插件、异步任务

↓

基础设施层

PostgreSQL/MySQL业务数据、订单、权限、日志索引

Redis缓存、会话、限流、队列状态

对象存储企业文件、图片、报告、导出资料

日志监控调用链、告警、审计、性能分析

三、系统分工

系统	负责内容	不建议负责	备注
自研业务后台	用户、企业、代理商、套餐、订单、钱包、分佣、权限、客户归属、服务工单。	复杂 AI 编排、文档解析、模型路由。	这是平台的业务主系统，必须掌握在自己手里。
AI 调度服务	统一封装 Dify/RAGFlow 调用，做鉴权、限流、计费、日志、流式转发。	不要承载代理商、订单、财务等业务规则。	建议自研，是业务系统和 AI 底座之间的核心中间层。
Dify	AI 应用、Prompt 模板、工作流、Agent、工具调用、应用调试。	不要作为主业务后台，不直接开放给普通用户。	每个 AI 产品可以映射一个或多个 Dify App。
RAGFlow	企业知识库、复杂文档解析、切片、检索、引用来源。	不要管理订单、用户余额、代理分佣。	企业资料多、PDF/Word/PPT 多时优先用 RAGFlow。
模型中转站	模型统一入口、Key 管理、模型路由、供应商切换、成本统计。	不要直接判断业务套餐和代理商权限。	调用日志需要带上业务侧透传的 trace_id 和 user_id。

四、核心业务流程

AI 工具调用流程

用户选择 AI 工具企业用户在平台中选择文案生成、客服助手、办公助手、行业方案等产品。
自研后端校验权限检查登录状态、企业状态、套餐权限、余额、频率限制和数据范围。
AI 调度服务选择应用根据 ai_product_id 找到对应的 Dify App、RAGFlow 数据集和价格规则。
Dify 执行工作流Dify 处理 Prompt、工具调用、Agent 步骤和上下文管理。
RAGFlow 提供检索结果如果应用需要知识库，Dify 通过 HTTP Tool 或中间服务请求 RAGFlow 检索。
模型中转站调用模型所有大模型、Embedding、Rerank 请求统一走你们已有的模型中转站。
结果流式返回AI 调度服务把 Dify 的流式结果转发给前端，前端实时展示。
记录用量并扣费写入调用日志、Token 消耗、成本、企业归属、代理商归属和扣费流水。

企业知识库流程

企业上传资料支持 PDF、Word、PPT、Excel、图片、网页链接等资料。
业务系统记录文件归属绑定企业、用户、知识库、权限范围、代理商和文件状态。
同步到 RAGFlow由后台任务上传文件，创建或更新 RAGFlow dataset。
解析和索引RAGFlow 完成 OCR、版面解析、切片、Embedding 和索引构建。
应用调用知识库Dify 工作流或 AI 调度服务按企业权限检索对应 dataset。
展示答案和来源回答结果需要带引用来源，方便企业用户验证。

五、AI 自动化任务产品

SEO、GEO、一键生成方案、自动发布、智能体代办等能力，不只是普通聊天，而是“自动化任务产品”。客户可以点按钮或直接和智能体对话，系统自动创建任务、执行工作流、记录结果，并按规则扣点数。

一键执行

客户选择产品，填写网站、行业、关键词、目标地区等参数，点击开始后系统自动执行。

对话式执行

客户直接和智能体说需求，智能体自动识别意图、补齐参数、确认点数后创建任务。

按点数扣费

不同任务按固定点数、步骤点数、Token 成本或结果数量扣费，扣费流水进入业务后台。

自动化任务通用流程

客户发起任务入口可以是“一键 SEO 优化”按钮，也可以是在智能体对话中提出“帮我优化网站 SEO”。
系统识别任务类型AI 调度服务判断这是 SEO、GEO、内容生成、报告分析、自动发布还是其他任务。
收集和校验参数检查网站地址、关键词、地区、行业、目标平台、知识库、是否授权发布等必要参数。
预估点数并确认根据任务类型、执行步骤、模型成本和外部接口成本预估扣点，客户确认后继续。
冻结点数任务开始前先冻结预计点数，避免任务执行完后余额不足。
创建任务记录生成任务编号，记录企业、用户、代理商、产品、输入参数、预计点数和任务状态。
执行 AI 工作流调用 Dify 工作流、RAGFlow 知识库、模型中转站和外部工具服务执行任务。
保存结果和报告保存生成内容、优化建议、执行日志、失败原因、可下载报告和下一步建议。
结算点数任务成功后按实际消耗扣点，失败则按规则退还或只扣已发生的基础成本。

SEO/GEO 一键优化示例

步骤	系统动作	调用能力	扣点建议
网站诊断	抓取客户网站首页、栏目页、标题、描述、结构化数据和页面基础信息。	网页抓取工具、规则检测、模型分析	按页面数量或固定基础点数
关键词规划	根据行业、地区、产品和客户资料生成关键词库、长尾词和内容主题。	Dify 工作流、RAGFlow 企业资料、模型中转站	按关键词数量或生成次数
SEO 内容生成	生成标题、描述、文章大纲、落地页文案、FAQ、图片 Alt 文案。	Dify 工作流、Prompt 模板	按生成篇数、字数或 Token
GEO 优化	生成更适合 AI 搜索和大模型引用的品牌介绍、问答内容、结构化说明和权威资料片段。	品牌知识库、RAGFlow 检索、模型生成	按任务包或内容条数
发布或交付	如果客户授权，可推送到 CMS、WordPress、企业官网；未授权则生成可下载报告。	外部发布插件、文件导出、人工审核	自动发布额外扣点，报告导出可免费或低点数
效果复盘	定期检查收录、排名、AI 引用表现、内容覆盖率，并生成下一轮优化建议。	搜索接口、站点监控、定时任务	按月度服务包或巡检次数

任务状态设计

状态	说明	客户侧展示	点数处理
待确认	系统已识别任务，但还缺少参数或等待客户确认点数。	展示任务参数和预计点数。	不扣点。
已冻结	客户确认执行，系统冻结预计点数。	展示任务排队中。	冻结点数，不真正扣除。
执行中	Dify/RAGFlow/工具服务正在执行任务。	展示当前步骤、进度和预计完成时间。	继续冻结。
待人工确认	任务涉及自动发布、敏感内容或高价值操作，需要人工审核。	展示待审核提示。	继续冻结或只扣基础生成成本。
已完成	任务完成并生成结果、报告或发布记录。	展示结果、下载报告、复制内容、继续优化。	按实际规则扣点，释放多余冻结点数。
失败	任务执行失败，比如网站无法访问、模型超时、发布接口失败。	展示失败原因和重试按钮。	按规则退还，或只扣已发生的基础成本。

点数扣费规则建议

计费方式	适用场景	优点	注意事项
固定点数	一键诊断、一键生成报告、标准 SEO 任务。	客户好理解，适合销售打包。	后台要控制任务范围，避免成本失控。
按步骤扣点	SEO/GEO 这类多步骤任务。	可解释性强，失败时方便按步骤结算。	需要记录每个步骤的状态和消耗。
按 Token 扣点	普通对话、长文生成、知识库问答。	和模型成本接近，适合精细化核算。	客户不一定理解 Token，前端最好换算成点数。
套餐内免费 + 超额扣点	企业包月客户、代理商促销客户。	有利于销售和续费。	必须有用量预警和超额拦截。

需要新增的页面

企业端新增

自动化任务中心：查看 SEO/GEO/报告类任务列表。
任务创建页：选择任务类型、填写参数、确认点数。
任务详情页：查看执行步骤、日志、结果、报告和重试入口。
智能体代办入口：通过对话创建自动化任务。
点数流水页：展示冻结、扣除、退还和任务关联。

总部后台新增

任务产品管理：配置 SEO/GEO 等自动化产品。
任务模板管理：配置字段、步骤、Dify 工作流和扣点规则。
任务监控中心：查看执行中、失败、待人工确认的任务。
点数规则管理：配置固定点数、步骤点数和超额扣点。
人工审核台：审核自动发布、敏感内容和高价值任务。

六、模块清单

企业端

AI 工具广场
对话工作台
企业知识库
文件管理
用量和余额
工单和服务跟进

代理商端

客户列表
客户开通
客户用量
订单跟进
分佣记录
活动和物料

总部后台

企业管理
代理商管理
AI 产品配置
套餐价格
订单和钱包
分佣结算

AI 调度服务

应用路由
权限校验
限流控制
SSE 流式转发
用量统计
异常重试

Dify 应用层

Prompt 模板
AI 工作流
Agent 应用
工具调用
应用版本
调试发布

RAGFlow 知识库

文档解析
OCR
知识切片
向量检索
引用来源
索引重建

七、各后台界面功能清单

本部分用于给老板、业务和产品团队确认系统范围。这里描述的是每个后台应该有哪些页面和能力，不代表一期必须全部开发，可以按阶段拆分。

1. 企业端后台

页面	主要功能	一期建议
企业工作台	展示企业套餐、算力余额、今日/本月调用量、常用 AI 工具、最近对话、知识库解析状态、服务提醒和系统公告。	必做
AI 工具广场	按办公、营销、客服、电商、制造、政务、教育等分类展示 AI 工具；支持搜索、收藏、查看说明、立即使用。	必做
AI 对话工作台	支持和不同 AI 应用对话；展示流式输出、历史会话、引用来源、重新生成、复制、导出、点赞/点踩反馈。	必做
智能体代办	客户用自然语言描述需求，系统识别是否创建 SEO、GEO、报告生成、内容发布等自动化任务，并引导确认点数。	建议做
自动化任务中心	查看全部 SEO/GEO/报告类任务，支持按状态、任务类型、创建人、时间筛选。	必做
任务创建页	选择任务类型，填写网站、关键词、地区、行业、目标平台、知识库等参数，提交前展示预计扣点。	必做
任务详情页	查看任务步骤、执行进度、日志、生成结果、报告下载、失败原因、重试和继续优化入口。	必做
企业知识库	创建知识库、上传 PDF/Word/PPT/Excel/图片、查看解析状态、设置知识库权限、测试检索效果。	必做
文件管理	查看企业上传的全部文件，包含文件类型、大小、上传人、解析状态、所属知识库、删除和重新解析。	建议做
行业方案	展示企业已开通的行业解决方案，比如企业客服、销售话术、合同审查、政策问答、生产管理助手等。	二期
成员与权限	企业管理员可邀请员工、设置角色、分配知识库权限、控制员工可使用的 AI 工具和额度。	建议做
用量与账单	查看 Token 消耗、工具调用次数、任务扣点、点数冻结、退还记录、套餐剩余额度、充值记录、余额预警。	必做
服务工单	提交售前咨询、使用问题、知识库解析问题、定制需求；查看服务人员回复和处理进度。	建议做
企业设置	维护企业资料、联系人、发票信息、通知方式、安全设置和数据保留策略。	二期

2. 代理商/城市合伙人后台

页面	主要功能	一期建议
代理商工作台	展示客户数量、线索数量、成交金额、客户调用量、预计分佣、待跟进事项、余额预警客户。	必做
客户管理	查看名下企业客户，记录客户行业、联系人、套餐、到期时间、使用情况、跟进状态和归属业务员。	必做
线索管理	登记潜在客户，记录来源、需求、预算、跟进记录、下次联系时间，可转为正式企业客户。	建议做
客户开通	为企业创建账号、选择套餐、提交开通申请、绑定代理商归属、生成付款或充值记录。	必做
客户用量监控	查看客户 AI 调用次数、Token 消耗、常用工具、知识库数量、活跃员工、余额不足提醒。	必做
订单管理	查看客户购买套餐、充值、续费、升级、退款等订单，跟踪付款状态和开票状态。	必做
分佣结算	展示订单分佣、用量分佣、服务费分佣、政企项目分佣、待结算金额、已打款记录。	二期
服务跟进	记录客户培训、陪跑、方案沟通、问题处理、续费提醒和项目机会。	建议做
活动与物料	下载招商资料、产品介绍、案例 PPT、海报、沙龙模板、话术文档和演示账号说明。	二期
区域数据看板	按区域查看企业数量、活跃度、行业分布、收入趋势、转化率、续费率和重点客户。	二期

3. 总部运营后台

页面	主要功能	一期建议
总部数据大屏	查看全平台企业数、代理商数、订单金额、AI 调用量、Token 成本、活跃客户、工单数量和增长趋势。	建议做
企业管理	查看和管理全部企业客户，支持开通、停用、套餐调整、余额调整、代理商归属变更。	必做
代理商管理	管理城市合伙人、OPC、行业渠道；维护区域、等级、合同期限、授权状态和考核指标。	必做
用户管理	管理平台用户、企业员工、代理商员工、总部员工；支持重置密码、禁用账号和角色分配。	必做
AI 产品管理	配置平台售卖的 AI 产品，包含产品名称、分类、说明、封面、是否启用、对应 Dify App 和计费规则。	必做
自动化产品管理	配置 SEO/GEO/报告生成等自动化任务产品，包括任务说明、表单字段、执行步骤、扣点规则、是否需要人工审核。	必做
任务模板管理	配置每类任务的步骤模板、Dify 工作流、RAGFlow 知识库使用方式、外部工具和失败重试策略。	必做
套餐价格管理	配置包月套餐、Token 包、次数包、试用套餐、企业定制套餐、代理商折扣和续费规则。	必做
点数规则管理	配置任务固定点数、步骤点数、Token 换算点数、冻结规则、失败退还规则和套餐内免费额度。	必做
订单与充值	管理订单、充值、续费、升级、退款、开票和人工调整记录。	必做
分佣规则管理	配置不同代理等级、产品类型、订单类型、项目类型的分佣比例和结算周期。	二期
结算管理	生成代理商结算单、审核结算金额、标记打款状态、导出财务报表。	二期
内容与案例管理	维护行业案例、解决方案介绍、招商资料、帮助文档、系统公告和物料下载。	二期
权限角色管理	配置总部员工、运营、财务、客服、技术、代理商管理员等角色的菜单和操作权限。	必做
系统审计日志	记录登录、配置变更、套餐调整、余额修改、权限变更、敏感数据查看等操作。	建议做

4. AI 配置后台

页面	主要功能	一期建议
AI 应用映射	把自研平台的 AI 产品和 Dify App 绑定，配置 App ID、调用方式、输入参数、输出格式和版本。	必做
知识库映射	管理企业知识库和 RAGFlow dataset 的绑定关系，查看解析状态、索引状态、失败原因。	必做
模型配置	选择模型中转站里的文本模型、Embedding 模型、Rerank 模型、图像模型和备用模型。	建议做
调用策略	配置不同产品使用哪个模型、最大 Token、温度参数、超时时间、失败重试次数和降级模型。	建议做
提示词模板	维护通用提示词、行业提示词、企业专属提示词，可和 Dify 的工作流配置配合使用。	二期
工具插件管理	管理 Dify Agent 可调用的外部工具，比如搜索、OCR、业务查询、表格处理、报告生成等。	二期
调用日志	按用户、企业、代理商、产品、模型、时间查询 AI 调用日志，查看输入、输出、Token、耗时和错误。	必做
任务执行日志	查看自动化任务每个步骤的输入、输出、调用模型、外部工具、耗时、扣点和失败原因。	必做
效果反馈	收集用户点赞、点踩、错误反馈、人工标注结果，用于优化 Prompt、知识库和行业方案。	二期
敏感词与安全策略	配置敏感词、禁止上传的文件类型、输出内容审核、异常调用拦截和黑名单。	建议做

5. 运营交付后台

页面	主要功能	一期建议
服务工单中心	统一处理企业客户和代理商提交的问题，支持分派、状态流转、回复、附件和满意度评价。	建议做
客户陪跑记录	记录培训、方案沟通、工具配置、知识库整理、效果复盘、续费建议等服务过程。	二期
培训课程管理	维护培训课程、直播回放、课件、报名名单、签到记录和学习进度。	二期
认证管理	管理代理商、企业员工或讲师认证，包含考试、证书编号、有效期和证书下载。	三期
项目交付管理	针对行业方案和政企项目，管理需求、里程碑、交付物、验收状态、项目负责人和风险记录。	三期
客户成功看板	查看客户活跃度、使用深度、问题数量、续费风险、价值案例和重点跟进建议。	二期

6. 财务结算后台

页面	主要功能	一期建议
收款记录	查看企业付款、代理商代付、线下转账、充值到账和人工确认记录。	建议做
发票管理	管理企业开票申请、发票抬头、税号、开票金额、开票状态和发票文件。	二期
成本核算	按模型、产品、企业、代理商统计模型调用成本、毛利和异常成本。	二期
代理商结算	核算代理商分佣、补贴、奖励、扣减项、打款记录和结算单导出。	二期
财务报表	按月导出收入、充值、消耗、退款、分佣、成本和利润报表。	二期

建议一期只做“企业端 + 代理商端 + 总部后台 + AI 调用日志”的核心闭环。 SEO/GEO 自动化任务可以作为一期亮点，但建议先做“生成报告 + 人工确认发布”，不要一开始就全自动改客户网站。运营交付、财务结算、认证培训、政企项目管理可以放到二期或三期，避免第一版范围过大。

页面字段清单

下面是一期重点页面的字段建议，方便产品画原型、开发建表和业务确认录入口径。

1. 企业开通页面

字段	说明	是否必填
企业名称	客户公司或组织名称。	必填
所属代理商	绑定客户归属，用于分佣和区域管理。	必填
所属行业	制造、教育、餐饮、文旅、政务、其他。	建议必填
联系人	企业负责人或项目联系人。	必填
手机号	用于登录、通知和服务跟进。	必填
开通套餐	基础包、知识库包、SEO/GEO 包、定制包。	必填
初始点数	企业开通后可用点数。	必填
到期时间	套餐或服务有效期。	必填
备注	销售、交付、特殊价格等说明。	选填

2. AI 产品配置页面

字段	说明	是否必填
产品名称	企业端展示的 AI 工具名称。	必填
产品分类	办公、营销、SEO/GEO、客服、行业方案等。	必填
产品说明	告诉客户这个工具解决什么问题。	必填
Dify App ID	绑定实际执行的 Dify 应用。	必填
是否需要知识库	决定是否关联 RAGFlow dataset。	必填
计费方式	按 Token、按次数、按固定点数或套餐内免费。	必填
可见范围	全部企业可见、指定套餐可见、指定企业可见。	必填
启停状态	启用、停用、维护中。	必填

3. 自动化任务创建页面

字段	说明	是否必填
任务类型	SEO 诊断、GEO 优化、竞品分析、内容生成、报告生成。	必填
目标网站	需要诊断或优化的网站地址。	SEO/GEO 必填
品牌名称	客户希望被 AI 搜索识别和推荐的品牌名。	GEO 必填
目标地区	全国、省、市或指定区域。	建议必填
目标关键词	客户希望覆盖的关键词，可多选或批量输入。	建议必填
所属行业	用于选择行业模板和 Prompt。	必填
关联知识库	选择企业资料、产品资料或案例资料。	选填
是否需要发布	只生成报告、生成待发布内容、授权自动发布。	必填
预计扣点	提交前展示预计冻结点数。	系统计算

4. 自动化任务详情页面

区域	展示内容	操作
任务概览	任务编号、企业、创建人、任务类型、状态、预计点数、实际扣点。	取消、重试、继续优化。
执行步骤	网站诊断、关键词分析、内容生成、报告生成、人工确认、发布记录。	查看步骤输入输出和失败原因。
结果报告	SEO/GEO 分析结论、优化建议、生成内容、待发布内容。	下载、复制、提交审核。
点数流水	冻结、扣除、退还、关联步骤。	查看明细。
操作日志	谁在什么时间做了什么操作。	审计查看。

5. 点数流水页面

字段	说明	筛选条件
流水编号	每一笔点数变化的唯一编号。	支持搜索
企业名称	点数归属企业。	支持筛选
变化类型	充值、冻结、扣除、退还、人工调整。	支持筛选
变化点数	正数代表增加，负数代表减少。	支持排序
关联任务	关联 AI 调用或自动化任务。	支持跳转
操作人	系统、用户、总部管理员或财务人员。	支持筛选
创建时间	流水生成时间。	支持时间范围筛选

页面原型级说明

下面不是最终 UI 设计，而是给产品画原型和开发理解页面结构使用。每个页面都说明主要区域、关键按钮和用户操作路径。

1. 企业工作台

区域	展示内容	操作
顶部概览	企业名称、套餐、到期时间、剩余点数、今日调用量、本月调用量。	充值、续费、查看账单。
常用 AI 工具	最近使用和推荐使用的 AI 工具卡片。	立即使用、收藏、查看说明。
自动化任务	最近 SEO/GEO 任务、执行中任务、失败任务和待确认任务。	查看详情、继续执行、重试。
知识库状态	知识库数量、文件数量、解析中、解析失败。	上传资料、查看知识库。
服务提醒	余额不足、套餐到期、工单回复、任务审核结果。	查看提醒、处理事项。

2. AI 工具广场

区域	展示内容	操作
分类导航	全部、办公、营销、SEO/GEO、客服、知识库、行业方案。	切换分类。
搜索筛选	关键词、是否已开通、是否需要知识库、是否推荐。	搜索、重置筛选。
工具卡片	工具名称、说明、适用场景、扣点方式、是否需要套餐权限。	立即使用、查看详情、申请开通。
工具详情	输入要求、输出示例、计费规则、注意事项。	开始使用、收藏。

3. AI 对话工作台

区域	展示内容	操作
左侧会话列表	历史会话、所属 AI 工具、创建时间。	新建、重命名、删除、搜索。
中间对话区	用户输入、AI 回复、引用来源、生成状态。	发送、停止生成、重新生成、复制。
右侧上下文	当前工具说明、使用知识库、预计扣点、已消耗点数。	切换知识库、查看计费。
智能体代办提示	当识别到 SEO/GEO 或报告需求时，提示可创建自动化任务。	生成任务草稿、确认执行。

4. 自动化任务中心

区域	展示内容	操作
顶部统计	全部任务、执行中、待确认、失败、已完成、本月扣点。	刷新、导出。
筛选区	任务类型、状态、创建人、时间范围、关键词。	查询、重置。
任务列表	任务编号、类型、企业、创建人、状态、进度、预计点数、实际扣点、创建时间。	查看、重试、取消。
批量操作	对失败任务、待确认任务进行批量处理。	批量重试、批量关闭。

5. 自动化任务详情

区域	展示内容	操作
任务信息	任务编号、类型、状态、企业、创建人、目标网站、关键词、点数。	取消任务、复制任务。
步骤进度	网站抓取、关键词规划、内容生成、GEO 分析、报告生成、发布确认。	查看步骤详情、重试失败步骤。
生成结果	诊断结论、优化建议、生成内容、待发布内容、引用资料。	复制、下载、提交人工审核。
点数流水	冻结点数、扣除点数、退还点数、结算说明。	查看关联流水。
操作日志	创建、确认、执行、失败、重试、审核、完成的日志。	审计查看。

6. 总部任务产品管理

区域	展示内容	操作
产品列表	任务产品名称、类型、状态、扣点规则、绑定工作流、创建时间。	新增、编辑、启停、复制。
基础配置	名称、说明、分类、封面、适用套餐、是否推荐。	保存、预览。
表单配置	客户发起任务需要填写的字段，比如网站、关键词、地区。	新增字段、排序、设置必填。
执行步骤	每一步的名称、Dify 工作流、外部工具、是否可重试、失败处理。	新增步骤、调整顺序。
扣点规则	固定扣点、步骤扣点、失败退还、套餐免费额度。	保存规则、测试估算。

核心业务规则

这里定义开发必须遵守的关键规则，重点解决点数、任务状态、权限、失败处理和自动发布风险。

1. 点数账户规则

规则	说明	处理方式
点数余额	企业维度维护总余额，员工不单独充值。	员工消耗归集到企业账户。
冻结点数	自动化任务开始前先冻结预计点数。	冻结后余额减少可用额度，但不算最终扣除。
实际扣除	任务完成后按规则扣除实际点数。	多余冻结点数释放回账户。
失败退还	系统原因失败应退还未消耗点数。	已完成步骤可扣基础成本，规则需在前端展示。
人工调整	总部可进行补点、扣点、纠错。	必须填写原因并写入审计日志。
余额不足	余额不足不能创建需扣点任务。	提示充值或联系代理商。

2. 自动化任务状态机

当前状态	可流转到	触发条件
草稿	待确认、已取消	客户补齐参数后进入待确认；客户放弃则取消。
待确认	已冻结、已取消	客户确认预计点数后冻结点数。
已冻结	排队中、失败	创建执行任务成功进入排队；冻结失败进入失败。
排队中	执行中、已取消	任务被 worker 领取后执行；未开始前可取消。
执行中	待人工确认、已完成、失败	根据执行结果流转。
待人工确认	已完成、失败、已取消	运营审核通过、驳回或取消。
已完成	不可再流转	完成扣点结算和结果保存。
失败	排队中、已关闭	允许重试则重新排队，不重试则关闭。
已取消	不可再流转	释放冻结点数并记录原因。

3. SEO/GEO 发布授权规则

场景	规则	建议
只生成报告	不需要客户提供网站后台权限。	一期优先做。
生成待发布内容	系统生成内容，客户或运营人工复制发布。	一期建议做。
自动发布到网站	必须客户授权，保存授权记录，发布前二次确认。	二期做。
修改客户网站结构	风险较高，必须人工审核和备份。	不建议一期做。
第三方平台发布	需要第三方账号授权和发布日志。	按平台逐个接入。

4. 权限和隔离规则

规则	说明
企业数据隔离	任何查询必须带企业 ID，企业之间不能互看知识库、文件、任务、对话和点数。
代理商数据隔离	代理商只能查看自己名下客户，不能查看其他代理商的客户和收益。
总部操作审计	总部修改套餐、点数、权限、任务状态、客户归属必须记录日志。
AI 工具权限	企业是否能使用某个 AI 工具，由套餐、产品可见范围和企业状态共同决定。
知识库权限	企业员工只能检索被授权的知识库，管理员可分配权限。

八、角色权限矩阵

平台至少要支持总部、代理商、企业客户和技术运营四类角色。权限设计要从一期开始做好，后期再补会影响客户数据、知识库隔离和分佣归属。

角色	可以看什么	可以操作什么	不能做什么
总部超级管理员	全平台企业、代理商、订单、用量、配置和日志。	创建角色、配置产品、调整套餐、处理订单、查看审计日志。	不建议直接修改 Dify/RAGFlow 底层数据，避免绕过业务系统。
总部运营	企业、代理商、产品、工单、内容物料和基础数据看板。	开通企业、维护产品、发布公告、处理工单、调整非财务配置。	不能修改财务结算规则，不能查看敏感模型密钥。
总部财务	订单、充值、退款、发票、分佣、结算单和财务报表。	确认收款、处理退款、审核结算、导出财务数据。	不能修改 AI 应用配置，不能查看企业知识库内容。
总部技术运营	AI 产品映射、调用日志、错误日志、模型配置、知识库解析状态。	配置 Dify App 映射、RAGFlow dataset 映射、模型调用策略、重试失败任务。	不能调整客户余额、分佣比例和财务结算。
代理商管理员	自己名下客户、订单、用量、预计收益、工单和服务跟进记录。	创建线索、申请开通客户、跟进客户、查看客户使用情况。	不能查看其他代理商客户，不能修改总部产品价格和分佣规则。
代理商业务员	被分配的线索、客户和跟进记录。	新增跟进、提交开通申请、提交客户需求和服务工单。	不能查看代理商全部财务收益，不能调整客户套餐。
企业管理员	本企业成员、知识库、AI 使用记录、余额、套餐和工单。	邀请成员、上传资料、创建知识库、分配员工权限、提交工单。	不能查看其他企业数据，不能绕过套餐使用未授权工具。
企业员工	自己被授权的 AI 工具、知识库和对话记录。	使用 AI 工具、发起问答、上传被允许的文件、反馈效果。	不能查看企业账单，不能管理成员，不能访问未授权知识库。

九、核心数据设计

自研数据库保存业务主数据。Dify 和 RAGFlow 保存 AI 配置和知识索引，但必须在自研库里保存映射关系。

数据表	用途	关键字段
`users`	平台用户	`id`, `mobile`, `name`, `status`
`companies`	企业客户	`id`, `name`, `agent_id`, `plan_id`, `status`
`agents`	代理商和城市合伙人	`id`, `name`, `region_code`, `level`, `status`
`ai_products`	平台售卖的 AI 产品	`id`, `name`, `type`, `price_rule_id`, `enabled`
`automation_products`	SEO/GEO/报告生成等自动化任务产品	`id`, `name`, `task_type`, `template_id`, `points_rule_id`, `enabled`
`automation_templates`	自动化任务模板和执行步骤	`id`, `task_type`, `form_schema`, `steps_json`, `dify_workflow_id`
`automation_tasks`	客户发起的一键 SEO/GEO 等任务	`id`, `task_no`, `company_id`, `user_id`, `status`, `frozen_points`, `charged_points`
`automation_task_steps`	自动化任务的步骤执行记录	`task_id`, `step_key`, `status`, `input_json`, `output_json`, `error_msg`
`points_ledger`	点数流水，记录冻结、扣除、退还	`company_id`, `task_id`, `change_type`, `points`, `balance_after`
`ai_app_mappings`	自研产品和 Dify/RAGFlow 的映射	`product_id`, `dify_app_id`, `ragflow_dataset_id`, `version`
`knowledge_bases`	企业知识库	`id`, `company_id`, `ragflow_dataset_id`, `permission_scope`
`uploaded_files`	上传文件和解析状态	`id`, `company_id`, `storage_url`, `parse_status`, `error_msg`
`wallets`	企业余额和算力账户	`company_id`, `balance`, `frozen_amount`, `updated_at`
`usage_logs`	AI 调用明细	`trace_id`, `user_id`, `company_id`, `agent_id`, `tokens`, `cost`
`commission_records`	代理商分佣	`agent_id`, `order_id`, `usage_log_id`, `amount`, `status`

十、接口边界

前端只调用自研业务 API。自研业务 API 内部再调用 AI 调度服务、Dify、RAGFlow 和模型中转站。

对前端开放的接口

POST /api/auth/login
GET  /api/me
GET  /api/ai/products
POST /api/ai/chat
POST /api/ai/apps/{productId}/run
POST /api/automation-tasks
GET  /api/automation-tasks
GET  /api/automation-tasks/{id}
POST /api/automation-tasks/{id}/confirm
POST /api/automation-tasks/{id}/retry
POST /api/knowledge-bases
POST /api/knowledge-bases/{id}/files
GET  /api/usage/logs
GET  /api/points/ledger
GET  /api/wallet/balance
GET  /api/agent/customers
GET  /api/admin/ai-products

内部调用接口

POST /internal/ai-dispatch/run
POST /internal/ai-dispatch/chat-stream
POST /internal/ragflow/datasets
POST /internal/ragflow/files
POST /internal/ragflow/search
POST /internal/dify/workflows/run
POST /internal/automation/dispatch
POST /internal/automation/settle-points
POST /internal/model-gateway/chat
POST /internal/billing/usage-settle

调用日志必须透传的字段

{
  "trace_id": "每次 AI 请求唯一编号",
  "user_id": "用户 ID",
  "company_id": "企业 ID",
  "agent_id": "代理商 ID",
  "product_id": "AI 产品 ID",
  "dify_app_id": "Dify 应用 ID",
  "automation_task_id": "自动化任务 ID，没有则为空",
  "ragflow_dataset_id": "RAGFlow 知识库 ID",
  "model": "实际调用模型",
  "billing_mode": "tokens / times / package / points"
}

十一、部署架构

MVP 部署

自研前端
自研业务后端
AI 调度服务
Dify
RAGFlow
模型中转站
PostgreSQL/MySQL、Redis、对象存储

生产扩展

业务服务多实例部署
AI 调度服务独立扩容
Dify 和 RAGFlow 独立服务器
模型中转站独立集群
日志、监控、告警、备份
按企业或政企项目支持私有化部署

公网入口 Nginx / API Gateway
        |
自研前端 + 自研业务后端
        |
AI 调度服务
        |
------------------------------
|            |               |
Dify       RAGFlow       模型中转站
|            |               |
PostgreSQL / Redis / 对象存储 / 日志监控

研发拆分和优先级

下面按“先跑通闭环，再增强运营，再做自动化深度能力”的原则拆分。实际排期可根据团队人数调整。

一期 P0：必须完成

模块	开发内容	依赖	验收结果
账号权限	登录、角色、企业、代理商、总部管理员、菜单权限。	无	不同角色登录后看到不同后台。
企业和代理商	企业开通、代理商归属、客户列表、企业状态管理。	账号权限	代理商只能看到自己客户。
AI 产品管理	AI 产品配置、Dify App 映射、启停状态、可见范围。	Dify 可用	企业端能看到并调用已启用产品。
AI 调度服务	统一调用 Dify、透传 trace_id、流式输出、错误处理。	模型中转站、Dify	AI 对话能正常返回并记录日志。
知识库	文件上传、RAGFlow dataset 映射、解析状态、知识库问答。	RAGFlow、对象存储	企业上传资料后可基于资料问答。
点数账户	余额、冻结、扣除、退还、点数流水。	企业模块	每次调用和任务都有点数记录。
SEO/GEO 任务 Demo	任务创建、点数冻结、Dify 工作流执行、报告生成、任务详情。	AI 调度、点数账户	能用测试网站跑通一次完整任务。

一期 P1：建议完成

模块	开发内容	价值
服务工单	企业提交问题、总部回复、状态流转。	支撑售后和陪跑。
调用日志查询	按企业、用户、产品、模型、时间查询。	方便排查问题和核算成本。
任务监控中心	查看执行中、失败、待确认任务。	方便运营介入和减少售后风险。
基础数据看板	企业数、代理商数、调用量、点数消耗、任务数量。	方便老板和运营看数据。

二期再做

模块	原因	前置条件
正式支付和退款	涉及财务、对账、发票和合规，规则未定前容易返工。	订单和点数账户稳定。
正式分佣结算	分佣规则可能随招商政策变化。	客户归属和订单流水稳定。
自动发布到客户网站	涉及客户授权和误操作风险。	人工确认发布流程成熟。
DeerFlow 深度任务	适合复杂长任务，不适合第一版承担主流程。	Dify/RAGFlow/点数闭环跑通。
培训认证系统	运营内容和证书规则需要先定。	代理商体系稳定。

十二、开发阶段

一期：MVP 跑通闭环

企业和代理商账号体系
AI 工具广场
Dify 应用接入
RAGFlow 知识库上传和问答
SEO/GEO 自动化任务 Demo
Token 用量记录
总部后台基础配置

二期：业务运营增强

套餐、充值、余额扣费
点数冻结、扣除和退还
代理商客户归属
分佣结算
工单和陪跑服务
知识库权限隔离
数据看板

三期：行业方案平台化

行业智能体模板
自动发布和第三方平台连接
工具插件市场
政企项目管理
私有化部署包
模型效果评估
多区域运营体系

十三、技术难点和风险

难点	风险说明	建议处理方式
多租户隔离	不同企业的知识库、对话、文件和用量不能串数据。	所有请求必须带 `company_id`，RAGFlow dataset 按企业隔离。
用量计费	Dify、RAGFlow、模型中转站都有日志，容易对不上账。	统一由 AI 调度服务生成 `trace_id`，全链路透传。
流式响应	AI 生成慢，如果不流式返回，用户体验差。	AI 调度服务支持 SSE，前端按 token 实时展示。
知识库质量	企业文件格式复杂，解析失败会直接影响回答质量。	上传后展示解析状态，失败可重试，重要文件人工校验。
Agent 工具越权	Dify Agent 如果能调用业务 API，可能访问不该访问的数据。	工具接口必须二次鉴权，按用户和企业权限过滤。
系统替换成本	未来可能替换 Dify 或 RAGFlow。	前端和业务系统只依赖 AI 调度服务，不直接绑定开源项目 API。
自动化任务越权	SEO/GEO 如果涉及自动发布、修改网站、提交内容到第三方平台，可能误操作客户资产。	一期建议只生成报告和待发布内容；真正发布前必须有客户授权、人工确认和操作日志。
点数扣费争议	任务失败、部分成功、客户取消时，如果点数规则不清晰，容易产生售后争议。	任务开始前展示预计点数；后台记录冻结、扣除、退还流水；任务失败要有明确退还规则。

十四、一期验收口径

为避免“看起来做了很多，但业务闭环没跑通”，一期验收建议围绕真实使用流程，而不是单独验收页面数量。

验收项	通过标准	验证方式
企业开通	总部或代理商可以创建企业，绑定套餐、余额、代理商归属和企业管理员。	新建一个测试企业，从登录到进入企业工作台完整走通。
AI 工具使用	企业用户可以选择 AI 工具，正常获得流式回复，并生成调用记录。	至少测试 3 个不同 Dify App，对比前端结果和后台日志。
知识库问答	企业可以上传文档，RAGFlow 完成解析后，用户能基于文档问答并看到引用来源。	上传 PDF、Word、PPT 各一份，检查解析状态和回答来源。
SEO/GEO 自动化任务	客户可以创建 SEO/GEO 任务，系统能冻结点数、执行工作流、生成结果报告，并完成点数结算。	用一个测试网站创建任务，检查任务状态、步骤日志、报告结果和点数流水。
智能体代办	客户在对话中提出 SEO/GEO 需求时，智能体能识别任务意图，引导补齐参数并生成待确认任务。	输入“帮我给公司网站做 GEO 优化”，检查是否生成任务草稿和预计点数。
用量记录	每次 AI 调用都能记录用户、企业、代理商、产品、模型、Token、耗时、成本和状态。	用 trace_id 在业务后台、AI 调度服务和模型中转站日志中能对上。
余额和套餐拦截	余额不足、套餐未开通、无权限工具必须被拦截，并给出明确提示。	构造余额不足和无权限账号进行测试。
多租户隔离	A 企业不能看到 B 企业的知识库、文件、对话、用量和成员。	创建两个企业互测知识库和对话记录访问权限。
代理商归属	代理商只能看到自己名下客户，客户 AI 用量能归属到对应代理商。	创建两个代理商和多个客户，检查列表和用量归属。
后台配置	总部后台可以启停 AI 产品、调整套餐、查看调用日志和处理基础客户信息。	停用一个 AI 产品后，企业端不能继续使用该工具。
异常处理	Dify、RAGFlow 或模型中转站失败时，前端有明确提示，后台有错误日志。	模拟模型超时、知识库解析失败和 Dify 调用失败。

十五、开发检查表

业务确认

角色：总部、代理商、企业管理员、企业员工。
产品包：基础体验包、知识库包、SEO/GEO 包、行业智能体包、定制项目包。
套餐：按次数、Token、包月、项目制。
分佣：按订单、用量、服务费或项目金额。
点数：固定点数、按步骤扣点、按 Token 换算还是套餐内抵扣。
客户归属：按代理商、区域、来源渠道。
权限：企业资料、知识库、对话记录是否隔离。

技术确认

Dify App 和自研 AI 产品的映射关系。
RAGFlow dataset 和企业知识库的映射关系。
模型中转站是否支持业务字段透传。
是否需要 SSE 流式输出。
调用失败、余额不足、限流时的错误码。
自动化任务失败时的点数退还规则。
SEO/GEO 是否需要第三方发布接口或人工确认。
页面字段是否和数据库字段、接口参数保持一致。

验收标准

企业用户可以开通并使用 AI 工具。
上传企业文件后可以完成知识库问答。
SEO/GEO 任务可以创建、执行、出报告并扣点。
每次 AI 调用能查到用户、企业、代理商和成本。
余额不足或套餐无权限时能正确拦截。
总部后台能配置产品、套餐和启停状态。

上线前必须检查

数据库备份和文件备份。
模型调用失败告警。
自动化任务失败告警和重试策略。
敏感数据脱敏和操作日志。
企业知识库访问权限测试。
高频调用限流和防刷策略。

建议业务、产品、开发每次新增 AI 产品时，都先填写：产品名称、适用客户、Dify App、是否需要 RAGFlow 知识库、计费规则、权限范围、失败提示、验收用例。