useAiWork开发者文档
AI 开发

AI 架构与数据流

定位模型、提示词、业务工作流、输出校验与计费模块。

分层关系

代码片段
功能页面与 Hook
  → 功能 API:认证与输入校验
  → ModelSelection:平台 / 用户自定义
  → 请求级 provider + 提示词
  → AI SDK / 图片 provider
  → 输出校验与状态转换
  → 结果保存、额度结算或退款

src/ai 提供底层能力;src/features 决定业务流程。不要在 UI 内直接维护供应商认证、扣费或数据库写入。

功能地图

场景业务目录输出与保存方式
编辑器经历改写
features/resume/api/rewrite-*
HTML 建议;对话在组件内存
简历诊断与模拟面试
features/career/api
结构化对象;会话在 D1
通用聊天
features/chat/api
流式 UI 消息;历史在浏览器
图片生成
features/ai-image/api
平台图片或异步任务;历史在 D1
模型与提示词设置
features/ai-settings
本地连接配置、数据库提示词
平台计费
features/subscriptions、credits
Token 预留、结算或积分账本

关键约束

  • 请求级创建自定义 provider,不把用户 API Key 写入共享注册表。
  • 输入资料与系统指令分开,AI 举例不能成为用户经历事实。
  • 结构化生成通过 Schema 后,还要验证证据与原文匹配。
  • 保存失败、取消和上游异常进入对应退款路径。
  • 平台不可用或用户配置失效时明确提示,不静默切换到收费模型。

阅读顺序

先看模型接入与提示词,再按功能阅读改写、求职工作流、聊天或生图。计费变更先读额度与结算。

本页目录