[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94849":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":9,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":8,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":13,"stars30d":13,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":16,"hasPages":16,"topics":8,"createdAt":8,"pushedAt":8,"updatedAt":18,"readmeContent":19,"aiSummary":20,"trendingCount":14,"starSnapshotCount":14,"syncStatus":13,"lastSyncTime":21,"discoverSource":22},94849,"customer_work","liulangjietou\u002Fcustomer_work","liulangjietou",null,"https:\u002F\u002Fgithub.com\u002Fliulangjietou\u002Fcustomer_work","Java",102,45,2,0,40.19,false,"main","2026-08-24 04:01:22","# customer-work · 基于 AgentScope Java 的生产级智能客服系统\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fliulangjietou\u002Fcustomer_work\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fliulangjietou\u002Fcustomer_work\u002Factions\u002Fworkflows\u002Fci.yml)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache_2.0-blue.svg)](LICENSE)\n[![Java](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJava-17%2B-orange.svg)](docs\u002F新人必读.md)\n[![AgentScope](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAgentScope-2.0.0%20GA-green.svg)](https:\u002F\u002Fgithub.com\u002Fagentscope-ai\u002Fagentscope-java)\n\n> 🚀 **新人从这里开始**：[docs\u002F新人必读.md](docs\u002F新人必读.md)（15 分钟跑起来 + 看懂结构 + 知道改哪里）\n> 📚 **功能 \u002F 配置 \u002F 接口的全部细节**：[docs\u002F功能与配置全量参考.md](docs\u002F功能与配置全量参考.md)（本 README 只讲\"是什么、长什么样\"，\"怎么用\"都在那里）\n\n## 一、这个项目是做什么的\n\n**把一张典型的客服业务流程图，落成一套可上生产的代码**：从接入与流量治理、会话恢复、意图识别与路由、\n七域业务工具执行，到人工审批 \u002F 转人工工单的人机协作闭环，再到质检反馈驱动的数据飞轮——全链路可运行、可测试、可部署。\n\n- **技术底座**：`io.agentscope:agentscope-harness:2.0.0`（GA 正式版），模型默认对接**阿里云百炼（DashScope \u002F 通义千问）**，\n  完整用上 2.0 新能力（Permission \u002F Plan Mode \u002F Compaction \u002F Sandbox \u002F Subagent \u002F 五段 Middleware）。\n- **设计原则**：**每个能力 = 一个配置开关 + 一个可替换实现**。默认内置实现保证离线开箱即用、单测全绿；\n  改一行配置或声明一个 Bean，即可切到 Redis \u002F MySQL \u002F 百炼 \u002F Nacos 等真实后端，业务代码零改动。\n- **可改造为你自己的业务 Agent**：业务工具壳只暴露 Schema，真正逻辑委托给 `tool.backend.*` SPI 接口\n  （Order \u002F AfterSales \u002F Knowledge \u002F Product \u002F Member \u002F Complaint），实现接口或覆盖 Bean 即可接入自有订单 \u002F 售后 \u002F 知识系统，\n  无需改框架代码（用法见 [全量参考 §6.9](docs\u002F功能与配置全量参考.md)）。\n- **两套完整系统**：智能客服系统（AI 对话 + 用户工单 + 坐席协作）+ 后台管理系统（模型 \u002F 提示词 \u002F MCP \u002F 渠道 \u002F\n  定时任务 \u002F 工单工作台，改配置经 Nacos 热更新到运行中的客服应用，免重启）。\n- **多租户 SaaS 就绪（默认关闭）**：共享库 + `tenant_id` 行级隔离（MyBatis-Plus 拦截器全局改写，缺上下文 fail-closed），\n  配套租户配额与 T+1 计费账单、配置版本化与按租户灰度发布、多副本水平扩展（Redis 窗口计数 \u002F 会话锁 + `deploy\u002Fk8s\u002F` 清单）。\n  不开启时单租户部署行为与升级前完全一致，设计见 [多租户架构设计](docs\u002F多租户架构设计.md)。\n\n## 二、模块结构\n\n| 模块 | 端口 | 类型 | 说明 |\n|---|---|---|---|\n| `customer-work-starter` | — | Maven | **可复用智能体基础设施**：模型 \u002F 会话 \u002F 记忆 \u002F RAG \u002F 工具 SPI \u002F Middleware \u002F 审批 \u002F 工单 \u002F 用户 \u002F 聊天记录…… `@AutoConfiguration` 自动装配，可作为依赖被任意工程引入 |\n| `customer-work-app-server` | 8080 | Maven | **可运行客服应用**：HTTP + SSE + WebSocket 接口、用户工单系统、Swagger 文档 |\n| `customer-channel` | 8081 | Maven | **多渠道接入**：官方五套前端能力演示（admin 控制台 \u002F chat-completions \u002F AG-UI \u002F Studio \u002F 钉钉·飞书·企业微信）+ 生产用渠道接入层（**钉钉 + 微信公众号**机器人 ↔ 后台工作区智能体，连接器 SPI 预留企业微信） |\n| `customer-admin-server` | 8082 | Maven | **后台管理系统后端**：Spring MVC + MyBatis-Plus + Sa-Token，独立库 `customer_admin`，含坐席工单工作台与 AI 编码助手 |\n| `customer-work-gateway` | 8888 | Maven | **统一入口网关（可选）**：Spring Cloud Gateway + Nacos 服务发现，把 8080 \u002F 8082 聚合到同一入口 |\n| `customer-admin-web` | 5174 | 前端 | **后台管理前端**：Vue3 + TS + Vite + Element Plus（非 Maven 模块） |\n| `customer-work-app` | 5175 | 前端 | **终端用户 H5**：Vue3 + TS + Vite + Vant4，登录 \u002F 聊天 \u002F 我的工单（非 Maven 模块） |\n\n模块间的依赖与数据边界（三个后端服务都只依赖 starter，两个库彻底分离）：\n\n```mermaid\nflowchart LR\n    APPFE[\"customer-work-app · 5175\u003Cbr\u002F>用户 H5\"] --> APPSRV\n    ADMINFE[\"customer-admin-web · 5174\u003Cbr\u002F>后台前端\"] --> ADMSRV\n    GW[\"customer-work-gateway · 8888\u003Cbr\u002F>SCG 统一入口（可选）\"] -.->|Nacos 服务发现| APPSRV & ADMSRV\n    APPSRV[\"customer-work-app-server · 8080\u003Cbr\u002F>客服应用\"] --> ST\n    CH[\"customer-channel · 8081\u003Cbr\u002F>多渠道接入（钉钉 \u002F 微信公众号）\"] --> ST\n    ADMSRV[\"customer-admin-server · 8082\u003Cbr\u002F>后台管理\"] --> ST\n    ST[\"customer-work-starter\u003Cbr\u002F>可复用智能体基础设施\"]\n    APPSRV --- DBA[(\"agent_scope_customer_work\u003Cbr\u002F>cw_* 业务表\")]\n    ADMSRV --- DBB[(\"customer_admin\u003Cbr\u002F>Flyway 管理\")]\n    ADMSRV -.->|\"Nacos 配置热更新：改模型 \u002F 提示词，8080 免重启生效\"| APPSRV\n```\n\n> 附属目录：`mysql\u002F` 建库脚本（业务库 \u002F admin 库 \u002F XXL-JOB 库）、`docker\u002F` 中间件编排（MinIO \u002F PaddleOCR \u002F\n> [observability](docker\u002Fobservability\u002FREADME.md) 一键监控栈：Prometheus + Grafana + Alertmanager + Tempo + 钉钉告警）、\n> [deploy\u002Fk8s\u002F](deploy\u002Fk8s\u002FREADME.md) 多副本 K8s 清单（Deployment \u002F HPA \u002F PDB \u002F 探针 \u002F 优雅停机）、\n> `Dockerfile` + `docker-compose.yml` 一键起应用与依赖、`.github\u002Fworkflows\u002Fci.yml` CI。\n> starter 的代码分层与\"作为依赖引入\"的方式见 [全量参考 §九](docs\u002F功能与配置全量参考.md)。\n\n**可观测性**：应用侧默认暴露 Prometheus 指标；开启 `customer-work.observability.otel.enabled`（starter）\u002F\n`admin.observability.otel.enabled`（admin）后接入 OpenTelemetry，按 agent\u002Fmodel\u002Ftool（starter 另加 HTTP 入口）\n三段出 span 并经 OTLP 导出。配套的一键监控栈见 [docker\u002Fobservability\u002FREADME.md](docker\u002Fobservability\u002FREADME.md)，\n预置 Prometheus + Grafana（4 张仪表盘）+ Alertmanager（13 条告警规则 + 钉钉转发）+ Tempo 链路追踪后端；\n详细配置项见 [全量参考 §6.13c](docs\u002F功能与配置全量参考.md#613c-otel-链路追踪最后一公里)，\n生产部署步骤见 [部署手册 §九](docs\u002F部署手册.md#九可观测性与告警)。\n\n## 三、架构图与核心流程\n\n### 3.1 全景架构\n\n一次用户消息从渠道进来，到 AI 回复 \u002F 人工接管 \u002F 数据沉淀的完整链路（①~⑥ 对应客服业务流程图的六个阶段）：\n\n```mermaid\nflowchart TB\n    subgraph CLIENT[\"渠道与客户端\"]\n        H5[\"用户端 H5\u003Cbr\u002F>customer-work-app · 5175\"]\n        IM[\"IM 渠道\u003Cbr\u002F>钉钉 \u002F 飞书 \u002F 企业微信\"]\n        OPEN[\"OpenAPI 调用方\u003Cbr\u002F>chat \u002F SSE \u002F AG-UI \u002F chat-completions\"]\n        ADMINWEB[\"后台管理前端\u003Cbr\u002F>customer-admin-web · 5174\"]\n    end\n\n    subgraph EDGE[\"① 接入与流量治理\"]\n        GW[\"Spring Cloud Gateway 统一路由\u003Cbr\u002F>+ Nacos 服务注册发现\"]\n        SEC[\"API Key 鉴权 · 滑动窗口限流\u003Cbr\u002F>防注入围栏 · RequestId \u002F MDC 全链路\"]\n    end\n\n    subgraph CORE[\"customer-work-app-server · 8080（能力由 customer-work-starter 自动装配）\"]\n        SVC[\"CustomerServiceService\u003Cbr\u002F>② 会话恢复 + 状态持久化\"]\n        AGENT[\"ReActAgent \u002F HarnessAgent\u003Cbr\u002F>③ 意图识别 → 工具路由 → 观察-再推理\"]\n        MAS[\"MultiAgentOrchestrator\u003Cbr\u002F>快慢车道路由 → 专家并行 → reduce 归纳\"]\n        MW[\"五段 Middleware\u003Cbr\u002F>可观测 \u002F 审计 \u002F 脱敏 \u002F 工具护栏 \u002F 人工审批 \u002F 对话阶段\"]\n    end\n\n    subgraph BRAIN[\"记忆 · 知识 · 技能\"]\n        MEM[\"三层记忆：L1 短期 + L2 长期多租户 + L3 FactLog\"]\n        RAG[\"RAG 检索：memory \u002F simple \u002F 百炼 \u002F Dify\"]\n        SKILL[\"Skill 技能库 + 自进化\"]\n    end\n\n    MODEL[\"模型层：百炼默认 \u002F OpenAI \u002F Ollama …\u003Cbr\u002F>重试 + 私有化兜底 + 成本熔断\"]\n\n    subgraph TOOLS[\"④ 七域业务工具（tool.backend SPI 可替换）\"]\n        T[\"知识库 · 订单 · 售后 · 售前导购 · 会员 · 投诉 · 转人工\"]\n        DB[(\"MySQL 业务库 cw_*\u003Cbr\u002F>或你自己的订单 \u002F 售后系统\")]\n    end\n\n    subgraph HITL[\"⑤ 人机协作闭环\"]\n        AP[\"人工审批：退款挂起 → 放行 \u002F 拒绝\u003Cbr\u002F>+ 超时巡检\"]\n        HO[\"转人工 \u002F 用户工单\u003Cbr\u002F>7 态状态机 + SLA 升级\"]\n        SEAT[\"坐席工作台 + 后台管理\u003Cbr\u002F>customer-admin-server · 8082\"]\n    end\n\n    subgraph WHEEL[\"⑥ 数据飞轮\"]\n        QC[\"会话质检 · 坐席辅助\"]\n        FB[\"消息级反馈：点赞 \u002F 点踩\"]\n        FACT[\"FactLog 事实流水 → 离线复盘 \u002F 评测集\"]\n    end\n\n    subgraph OPS[\"配置与运维面\"]\n        NACOS[\"Nacos 配置热更新\u003Cbr\u002F>后台改模型 \u002F 提示词 \u002F MCP → 8080 免重启生效\"]\n        OBS[\"Prometheus 指标 · Tracing · Grafana\"]\n        XXL[\"XXL-JOB 定时调度\"]\n    end\n\n    H5 --> GW\n    IM --> GW\n    OPEN --> GW\n    GW --> SEC --> SVC --> AGENT\n    ADMINWEB --> SEAT\n    AGENT \u003C--> MODEL\n    AGENT --- MW\n    AGENT --> MAS\n    AGENT \u003C--> BRAIN\n    AGENT --> T\n    T --> DB\n    T -->|submitRefund 挂起| AP\n    T -->|transferToHuman| HO\n    HO \u003C--> SEAT\n    AP --> SEAT\n    AGENT --> QC\n    H5 -. 点赞 \u002F 点踩 .-> FB\n    QC --> FACT\n    FB --> FACT\n    NACOS -. 热更新 .-> MODEL\n    OPS -.-> CORE\n```\n\n### 3.2 退款人工审批闭环（挂起 → 人工决策 → 生效）\n\n高风险工具不直接生效：`submitRefund` 只登记待审单，人工放行后才执行退款回调（详见 [全量参考 §6.11](docs\u002F功能与配置全量参考.md)）：\n\n```mermaid\nsequenceDiagram\n    autonumber\n    participant U as 用户\n    participant A as ReActAgent\n    participant P as ApprovalStore（SPI：内存 \u002F JDBC）\n    participant S as 坐席 \u002F 管理员\n\n    U->>A: 我要退款 500 元\n    A->>P: submitRefund 不直接打款，登记待审单（挂起）\n    A-->>U: 已提交人工审批（返回审批单号）\n    S->>P: 查看待审列表 GET \u002Fapi\u002Fcustomer\u002Fapprovals\n    alt 放行 approve\n        P->>P: 执行退款回调，终态 APPROVED\n    else 拒绝 deny\n        P->>P: 终态 DENIED（决策幂等，重复决策返回 409）\n    else 审批超时\n        P->>P: 超时巡检按配置处置：升级转人工 \u002F 自动拒绝\n    end\n```\n\n### 3.3 用户工单 7 态状态机（AI 自助 ↔ 人工坐席全生命周期）\n\n状态名与代码 `TicketStatus` 枚举一一对应，非法流转 fast-fail：\n\n```mermaid\nstateDiagram-v2\n    [*] --> AI_SERVING : 创建工单\n    AI_SERVING --> WAITING_AGENT : transferToHuman 转人工排队\n    WAITING_AGENT --> AI_SERVING : 取消转人工\n    WAITING_AGENT --> PROCESSING : 坐席接单 claim\n    PROCESSING --> ON_HOLD : 挂起（等用户补材料）\n    ON_HOLD --> PROCESSING : 恢复处理\n    PROCESSING --> WAITING_AGENT : 转回工单池\n    PROCESSING --> WAITING_CONFIRM : 处理完毕待确认\n    WAITING_CONFIRM --> RESOLVED : 用户确认解决\n    WAITING_CONFIRM --> PROCESSING : 用户不认可，退回\n    RESOLVED --> CLOSED : 结案\n    AI_SERVING --> CLOSED : AI 已解决，直接关闭\n    CLOSED --> WAITING_AGENT : reopen 重开回流\n    CLOSED --> [*]\n\n    note right of CLOSED\n        RESOLVED \u002F CLOSED 均可 reopen，\n        回人工队列或回 AI 自助；\n        forceClose 可从任意非终态强制关闭\n    end note\n```\n\n## 四、能力地图\n\n细节（配置项、curl 示例、对应测试类）全部在 [功能与配置全量参考](docs\u002F功能与配置全量参考.md)，此处只给地图：\n\n| 能力域 | 内容 | 全量参考 |\n|---|---|---|\n| 对话与编排 | 同步 \u002F SSE 流式 \u002F 结构化意图 \u002F AG-UI 协议 \u002F 多 Agent 快慢车道路由 + 并行聚合 \u002F 安全中断 | §6.1~6.3 |\n| 会话与记忆 | 会话状态持久化（memory\u002Fjson\u002Fredis\u002Fmysql）、多租户长期记忆（百炼\u002FMem0\u002FReMe）、三层记忆 + FactLog、上下文压缩 | §6.4~6.7 |\n| 知识与技能 | RAG 四后端（内存\u002F向量\u002F百炼\u002FDify）、Skill 技能库 + 自进化 + 代码执行 | §6.8、§6.10 |\n| 业务工具 | 七域工具组覆盖售前→售中→售后全旅程，`tool.backend.*` SPI 一键换成你的真实系统（jdbc 实现内置） | §6.9 |\n| 人机协作 | 退款人工审批闭环（挂起→放行）、转人工工单、多轮槽位收集、审批\u002F工单持久化 SPI + 超时\u002FSLA 巡检 | §6.11 |\n| 用户工单系统 | 终端用户 JWT 认证、7 态工单状态机、用户\u002F坐席 WebSocket 双通道、事务化工单写入 + 数据库 Outbox 可靠事件、聊天消息落库、附件解析（OCR + 文档） | §6.21~6.23 |\n| 模型层 | 多厂商（百炼\u002FOpenAI\u002FAnthropic\u002FGemini\u002FOllama）、私有化兜底、重试、成本熔断、token 告警 | §6.12~6.13b |\n| 安全与治理 | API Key 鉴权、限流（全局兜底 + 后台可维护的路径规则层）、敏感词内容风控（一次拦截\u002F打码\u002F复核 + 命中看板）、入站防注入围栏、敏感信息脱敏、Permission 三态权限、沙箱 | §6.14~6.14.2、§6.18 |\n| 可观测与运维 | Prometheus 业务指标、Outbox\u002F死信队列健康与积压告警、原生 Tracing、OTel 链路追踪（真出 span + OTLP 导出）、MDC 全链路日志、慢请求留证、合成监控、优雅停机、一键 Grafana\u002FTempo\u002FAlertmanager 监控栈 | §6.13~6.13c |\n| 配置面 | Nacos 提示词\u002F运行时配置热更新（后台 8082 改 → 客服 8080 免重启生效）、配置版本化快照 + 一键回滚 + 按租户灰度发布、MCP \u002F Higress \u002F Studio 接入 | §6.15~6.17、§6.30 |\n| 多租户 SaaS | 租户行级隔离（拦截器全局改写 + fail-closed）、租户管理与双视角权限、水平扩展（Redis 窗口计数 \u002F 会话锁 + K8s 清单）、租户 token 配额 + T+1 计费账单 | §6.27~6.29 |\n| 数据飞轮 | 会话质检、坐席辅助、消息级点赞点踩、意图自动化评测（CI 可跑） | §6.11 末、§6.20 |\n| 运营闭环 | 评测中心（触发\u002F报告\u002F与上一版对比归因）、badcase 回流（负反馈→采纳为知识条目或评测用例）、语义缓存（白名单意图，命中即省整条模型链）、提示词版本（内容指纹归因）、CSAT 满意度（邀请与回收分开记）、知识盲区 TopN、死信队列（指数退避重投，耗尽转 ABANDONED 不删） | §6.31 |\n| 后台管理系统 | RBAC 权限、模型\u002FMCP\u002FSkill\u002F智能体配置、工作区聊天 + VibeCoding、渠道、定时任务(XXL-JOB)、工单工作台、内容风控、数据字典、开发者工具箱（HTTP\u002F证书\u002Fcron\u002FJWT\u002Fdiff\u002F格式互转\u002FSQL 客户端等）、调用统计（token + 缓存命中率）、AI 编码助手 | §6.21 |\n\n## 五、快速开始\n\n```bash\n# 方式一：本地运行（示例应用默认使用本机 MySQL；纯内存宿主可按需关闭 JDBC 域与迁移）\nexport DASHSCOPE_API_KEY=你的百炼密钥      # 必填，密钥仅从环境变量读取\nmvn -pl customer-work-app-server -am spring-boot:run\n\n# 方式二：Docker Compose 一键起（app + Redis + MySQL + Nacos）\ndocker compose up -d\n\n# 发一条消息试试\ncurl -X POST http:\u002F\u002Flocalhost:8080\u002Fapi\u002Fcustomer\u002Fchat \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"sessionId\":\"u1001\",\"message\":\"帮我查一下订单 20260613001 的状态和物流\"}'\n```\n\n- 启动后打开 **http:\u002F\u002Flocalhost:8080\u002Fswagger-ui.html** 在线调试全部接口。\n- 跑测试（无需 API Key，任何环境全绿）：`mvn test` ——当前基线 **2222 个**（starter 1323 + admin-server 753 +\n  app 80 + customer-channel 65 + gateway 1），外部依赖（Redis\u002FMySQL\u002FNacos\u002F百炼\u002FOCR\u002FMinIO）不可达的用例自动跳过。\n- 环境要求、前端启动、构建坑位速查见 [新人必读](docs\u002F新人必读.md)。\n\n## 六、Roadmap\n\n```mermaid\ntimeline\n    title customer-work 演进路线\n    已完成 · 1.x 基线 : AgentScope 1.0.12 核心客服链路 : 存档于 legacy-main-1.0.12 标签\n    已完成 · 2.0 迁移 : RC4 首轮迁移（rc2.0 分支存档） : 2.0.0 GA 全量迁移 + Harness 新能力补齐\n    已完成 · 生产化 : HITL 审批闭环 + 人机切换工单 : 用户工单系统（JWT + WS 双通道 + 7 态状态机） : 后台管理系统 + Nacos 配置热更新 : 真实业务后端 jdbc + 附件解析 OCR : Nacos 注册发现 + SCG 网关 + XXL-JOB\n    已完成 · 平台化 : 内容风控（敏感词 + 限流）+ 数据字典 + 开发者工具箱 : 十项通用能力薄壳化下沉 starter : OTel 链路追踪 + 一键 Grafana \u002F Tempo 监控栈 : 登录态 Redis 持久化 + streamEvents 流式重构\n    已完成 · SaaS 化 : 多租户行级隔离 + 租户管理双视角 : 水平扩展（Redis 计数 \u002F 会话锁 + K8s 清单） : 租户配额 + T+1 计费账单 : 配置版本化 + 按租户灰度 : starter 按域拆分治理\n    已完成 · 运营闭环 : 评测中心 + badcase 回流 : 语义缓存 + 模型分级路由 : 提示词版本归因 + CSAT : 知识盲区 + 死信队列\n    规划中 · 扩展点 : 租户安全合规（审计归档 \u002F 退租数据导出） : A2A Agent Card 注册发现 : RocketMQ 异步消息 : Training 数据飞轮（RM Gallery \u002F Trinity-RFT） : 后台 AI 编码助手 P1~P3 演进\n```\n\n规划中的能力框架均已提供扩展点（保留为\"配置即用\"，不硬编入以保证开箱即用）：\n\n| 方向 | 需要 | 说明 |\n|---|---|---|\n| A2A Agent Card 注册发现 | 新版 nacos-client AI API + `io.a2a` SDK | Nacos 配置中心层已落地，待 SDK 坐标 |\n| RocketMQ 异步消息 \u002F 消息总线 | RocketMQ broker | 任务解耦 \u002F A2A over MQ |\n| Training 数据飞轮 | RM Gallery + Trinity-RFT 平台 | FactLog 数据出口已就绪，待平台对接 |\n| Anthropic \u002F Gemini 模型 | 各厂商 SDK 依赖 | 代码已就绪，补依赖即可 |\n| RAGFlow \u002F Haystack 知识库 | 对应 client | 同 Dify 模式扩展 `KnowledgeProvider` |\n| 远端云沙箱（k8s \u002F e2b 等） | `agentscope-extensions-sandbox-*` | local \u002F docker 沙箱已内置 |\n| 后台 AI 编码助手 P1~P3 | — | 交互式运行面板 \u002F 智能 Bug 修复 \u002F 多 Agent 协作编程，见[需求文档 §8](docs\u002FAI编码助手需求文档.md) |\n\n## 七、文档地图\n\n| 想解决的问题 | 去读 |\n|---|---|\n| 15 分钟跑起来、看懂结构、知道改哪里 | [docs\u002F新人必读.md](docs\u002F新人必读.md) |\n| 功能总表、配置项、接口速查、各功能用法与测试 | [docs\u002F功能与配置全量参考.md](docs\u002F功能与配置全量参考.md) |\n| 架构原理、时序图、UML 类图、扩展点 | [docs\u002F详细技术文档.md](docs\u002F详细技术文档.md) |\n| 多租户隔离模型、逐表归属、身份链路 | [docs\u002F多租户架构设计.md](docs\u002F多租户架构设计.md) |\n| 全部接口的请求 \u002F 响应示例（生产调用方视角） | [docs\u002F生产接口使用手册.md](docs\u002F生产接口使用手册.md) |\n| 生产部署步骤、环境变量、建表、灰度回滚 | [docs\u002F部署手册.md](docs\u002F部署手册.md) |\n| 1.x→2.0 API 映射、RC4→GA 变更、issue 核对 | [docs\u002FMIGRATION-2.0.md](docs\u002FMIGRATION-2.0.md) |\n| 框架 open issues 与本项目链路的交叉评估 | [docs\u002F生产就绪评估.md](docs\u002F生产就绪评估.md) |\n| 五套官方前端能力接入（8081 演示模块） | [docs\u002Fcustomer-channel操作文档.md](docs\u002Fcustomer-channel操作文档.md) |\n| 后台管理系统需求与实施路线 | [docs\u002FAI编码助手需求文档.md](docs\u002FAI编码助手需求文档.md) |\n\n## 八、重要说明\n\n- **分支策略**：`main` 有分支保护、禁止直接 push，开发从 `main` 切分支走 PR；`legacy-main-1.0.12` 标签与\n  `rc2.0` 分支为历史存档，不再更新。\n- 基于官方 GA 坐标 `io.agentscope:agentscope-harness:2.0.0`（`agentscope-bom` 统一管理版本）；框架高速迭代，\n  升级遇 API 不匹配请对照该版本源码微调。\n- API Key 支持配置项与环境变量两种来源，**生产请用环境变量注入**，勿把密钥留在仓库。\n- 客服业务库由 starter 的 Flyway 管理；存量非空库以版本 `0` 接管后顺序执行增量迁移，迁移失败会阻断启动。\n- 工单状态、事件轨迹和 Outbox 在同一本地事务中提交；消费语义为至少一次，处理器必须按稳定事件 ID 幂等。\n- CI 会扫描当前提交中的常见密钥格式。若密钥曾进入 Git 历史，删除文件内容不足以止损，仍须立即吊销并轮换。\n- 业务链路全异步（`Mono`\u002F`Flux`，无 `.block()`）；所有外部后端均为配置开关，默认实现保证离线开箱即用与单测全绿。\n- 包名按模块划分，根均为 `com.richard.fyoung`：starter `…customerwork`、app-server `…customerworkapp`、\n  channel `…customerchannel`、admin-server `…customeradmin`、gateway `…customerworkgateway`。\n\n## 关注作者\n\n如果你对 AI 及本项目感兴趣，欢迎关注我的微信公众号 **AI赛博炼丹炉**，将带来更多高质量文章和干货。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fwechat-qr.png\" alt=\"微信公众号：AI赛博炼丹炉\" width=\"420\">\n\u003C\u002Fp>\n","这是一个基于AgentScope Java框架构建的生产级智能客服系统，提供从多渠道接入、意图识别与路由、业务工具执行（订单\u002F售后\u002F知识等）、人机协作工单闭环到后台管理的全链路解决方案。核心采用模块化设计，支持配置驱动的能力开关、SPI可插拔业务后端、Nacos热更新、多租户SaaS架构及阿里云百炼模型集成，强调开箱即用与零侵入业务改造。适用于中大型企业需快速落地AI客服能力、同时兼顾可维护性、可扩展性与合规隔离要求的场景。","2026-08-17 02:30:05","trending"]