智叟云集系统的技术架构与双入口服务设计
关键词 智叟云集系统，GEO监测，AI品牌监测，React，Node.js，多租户
智叟云集系统技术系列 | 2026年10月
智叟云集系统是一套面向品牌与服务商的 AI 回答监测系统。品牌用户可以通过浏览器客户端独立访问，配置问题、发起监控并查看结果；服务商则可以通过 API 将相同的监测能力接入自己的业务系统。两种入口共用任务、采集和结果服务，避免形成两套彼此独立的数据。
本文从架构角度介绍这套系统如何组织前后端、如何处理耗时采集，以及为什么商业交付需要同时考虑结果质量和权限边界。本文所述能力以 2026 年 10 月版本为范围，客户端指 Web 客户端。
从品牌搜索问题到可追踪的监测任务
当用户向 AI 提问“某类产品怎么选”时，品牌关心的不只是有没有出现自己的名字，还包括出现在哪种回答中、引用了哪些来源，以及不同时间和平台的回答是否发生变化。智叟云集系统将这类问题转化为可重复执行的监测对象。
一个品牌可以配置多个问题。每次任务选择问题、平台与采样次数，后台进一步拆分为采集单元。一个问题在一个平台的一次采样，构成一个可记录状态、结果和错误的执行单元。这个粒度既支持排查局部失败，也便于服务商解释交付数量。
例如，五个问题、三个平台、每个平台采样一次，需要十五个采集单元。这个例子仅用于说明任务拆分，不代表真实客户数据。只记录“任务失败”会掩盖部分成功的价值，因此系统保留单元状态及回答证据。
前后端分层为何影响持续开发
前端使用 React 与 Vite，负责品牌总览、问题管理、监控任务、来源、趋势、报告和服务商接口管理。后端使用 Node.js 与 Fastify，负责参数校验、身份鉴权、业务规则和任务调度。SQLite 保存品牌、任务、回答、租户与 API 相关数据。
模块划分的目的，是让页面展示、业务规则和平台适配可以独立调整。例如，更换采集通道不应要求重写任务列表；增加客户余额规则，也不应把计费逻辑塞进每个平台的浏览器操作中。
geo-monitoring/
web/src/ # Web client and components
web/dist/ # Production web assets
src/api/ # HTTP routes and validation
src/services/ # Business services
src/security/ # Identity and API authorization
src/worker/ # Monitoring execution
src/infrastructure/ # Collector integrations
src/db/ # SQLite schema and migrations
shared/ # Platform and API contracts
上述结构对应系统的实际模块划分，已省略部署机器路径。完整项目还包括测试与部署脚本。共享配置目录尤其重要，它让前端选择的平台与后端验证的平台使用同一份定义。
双入口如何复用同一套业务能力
Web 客户端解决“人如何操作”的问题。用户在租户和品牌范围内管理监测配置，进入任务结果后查看回答与来源。服务商 API 解决“外部系统如何调用”的问题，采用 Bearer API Key，并通过授权品牌、客户关系和操作权限限定访问范围。
两类入口可以调用相同的业务服务，但不能混用认证方式。浏览器登录会话不应被复制给服务商，服务商密钥也不应放进公开网页的前端代码。下面是分层思路的脱敏示意，并非可独立启动的完整服务。
async function createMonitoringTask(context, input) {
await authorizeBrand(context, input.brandId);
const command = validateMonitoringInput(input);
const result = await monitoringService.create(context, command);
return { id: result.id, status: result.status };
}
// Web route builds context from the user session.
// Provider route builds context from an authorized API key.
将上下文和输入分开，可以防止调用方通过请求体随意指定身份。业务层仍需再次核验资源归属，而不是仅相信页面选择器或请求参数。
为什么采集任务必须异步执行
AI 平台的页面加载、回答生成和证据提取都有不确定耗时。接口不适合一直等待到所有平台完成。智叟云集系统将创建任务与查询结果分离：创建请求返回任务标识，后台执行采集，客户端或服务商随后查询任务状态。
后台队列还需要处理平台串行、任务取消、执行间隔及服务重启后的状态恢复。系统已具备相关模块，但当前部署不能据此被描述为分布式高可用集群。若后续任务规模显著扩大，应结合实测瓶颈评估外部队列、独立采集节点与数据库升级。
架构给客户和服务商带来的价值
品牌团队可以直接在客户端开展监测，不必先建设接口中台；服务商可以把采集结果接入已有报表、客户工作台或内容运营流程。两种方式共享数据模型，使产品更容易从单客户试用发展到多个客户的持续交付。
这种价值来自流程复用和证据可追溯，不应被包装为保证 AI 推荐、保证搜索排名或保证销售增长。监测系统提供观察和复盘的依据，内容改进及最终商业效果仍需要独立验证。
常见问题
智叟云集系统需要安装桌面客户端吗
当前可以通过浏览器访问 Web 客户端。客户端独立访问不代表已经提供原生 Windows、iOS 或 Android 应用。
服务商能直接读取全部品牌吗
服务商的访问范围由授权密钥及资源归属决定，不能因为拥有一个有效密钥就默认读取所有租户的数据。
系统是否全部由单一文件构成
不是。前端、路由、业务服务、采集器、权限和数据库已经拆分。后续开发应继续沿用模块边界，而不是把新增逻辑集中到一个入口文件。
结语
智叟云集系统的架构重点，是把品牌监测组织成可授权、可执行、可追踪的业务流程。Web 客户端降低使用门槛，服务商 API 提供集成空间，两者共同构成同一套监测服务的交付方式。
