From 7621b8f53db9fa0fb1d3968d74d335b1aa8fb189 Mon Sep 17 00:00:00 2001 From: karuo Date: Sun, 15 Mar 2026 23:31:07 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=84=20=E5=8D=A1=E8=8B=A5AI=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=202026-03-15=2023:31=20|=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=EF=BC=9A=E9=87=91=E7=9B=BE=E3=80=81=E6=80=BB=E7=B4=A2=E5=BC=95?= =?UTF-8?q?=E4=B8=8E=E5=85=A5=E5=8F=A3=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD?= =?UTF-8?q?=E6=9E=A2=E5=B7=A5=E4=BD=9C=E5=8F=B0=20|=20=E6=8E=92=E9=99=A4?= =?UTF-8?q?=20>20MB:=2011=20=E4=B8=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 01_卡资（金）/金盾_数据安全/存客宝/SKILL.md | 253 ++++++++- .../存客宝/参考资料/存客宝API完整索引.md | 488 ++++++++++++++++++ SKILL_REGISTRY.md | 2 +- 运营中枢/工作台/gitea_push_log.md | 1 + 运营中枢/工作台/代码管理.md | 1 + 5 files changed, 719 insertions(+), 26 deletions(-) create mode 100644 01_卡资（金）/金盾_数据安全/存客宝/参考资料/存客宝API完整索引.md diff --git a/01_卡资（金）/金盾_数据安全/存客宝/SKILL.md b/01_卡资（金）/金盾_数据安全/存客宝/SKILL.md index 4df6acdb..8096fb20 100644 --- a/01_卡资（金）/金盾_数据安全/存客宝/SKILL.md +++ b/01_卡资（金）/金盾_数据安全/存客宝/SKILL.md @@ -1,40 +1,243 @@ --- name: 存客宝 -description: 存客宝私域系统开发与运维。触发词：存客宝、cunkebao、私域、获客、工作手机、场景获客、流量池。关联存客宝文档、v2/v3源码、部署与架构。 -group: 金 -triggers: 存客宝、cunkebao、客户管理 +description: 存客宝私域系统全栈管理——API调用、数据库操作、设备管理、微信自动化、AI数字员工、触客宝、场景获客、流量池、分销渠道。 +triggers: 存客宝、cunkebao、私域、获客、工作手机、场景获客、流量池、触客宝、touchkebao、AI数字员工、分销渠道、微信管理、存客宝API、存客宝数据库 owner: 金盾 -version: "1.0" -updated: "2026-02-16" +group: 金 +version: "2.0" +updated: "2026-03-15" --- -# 存客宝 +# 存客宝（CunKeBao） -卡若私域银行核心产品，负责存客宝系统的开发、部署与运维。 +卡若私域银行核心产品。负责存客宝全栈系统的 API 调用、数据库操作、开发部署与运维。 -## 关联路径 +--- -| 项目 | 路径 | +## 能做什么（Capabilities） + +1. **API 调用**：200+ 接口，覆盖登录、设备、微信、工作台、内容库、好友、群、场景获客、数据统计、流量池、AI、算力、触客宝、门店、分销渠道、Coze 集成 +2. **数据库操作**：MySQL（用户/设备/订单/流量池）+ MongoDB（好友/消息/朋友圈/内容/日志）+ Redis（缓存/队列） +3. **WebSocket 实时通信**：设备控制、消息收发、朋友圈操作、添加好友、建群 +4. **自动化任务**：自动点赞、朋友圈同步、群消息推送、自动建群、入群欢迎语、通讯录导入、流量分发 +5. **AI 能力**：AI 改写、AI 对话、AI 群公告、AI 智能推送、知识库管理、Coze 集成 +6. **触客宝（客服端）**：聊天、好友管理、快捷回复、问答库、违禁词、关键词、自动问候、分组管理 +7. **门店 & 分销**：门店账号管理、流量采购、供应链采购、算力管理、分销渠道、渠道收益 +8. **部署运维**：宝塔管理、Nginx 配置、SSL、服务器安全、磁盘清理、数据库备份 + +--- + +## 怎么用（Usage） + +**触发词**：存客宝、cunkebao、私域、获客、工作手机、场景获客、流量池、触客宝、AI数字员工、分销渠道、微信管理、存客宝API、存客宝数据库 + +**典型场景**： +- "调用存客宝 API 获取设备列表" → 查 API 索引 → 调用接口 +- "存客宝数据库有哪些表" → 查数据库架构 +- "帮我用存客宝 API 上报一条线索" → 生成签名 → 调用 /v1/api/scenarios +- "触客宝 AI 配置怎么设置" → 查触客宝 AI 配置接口 +- "存客宝服务器出问题了" → 查服务器管理脚本 + +--- + +## 执行步骤（Steps） + +### 1. 确认需求类型 + +| 类型 | 动作 | |:---|:---| -| 存客宝备份（文档+源码） | `01_卡资（金）/_团队成员/金盾/存客宝备份/` | -| 文档 cunkebao_doc | 需求、架构、接口、部署 | -| 源码 cunkebao_v2 | Next.js 版本 | -| 源码 cunkebao_v3 | PHP 版本 | +| API 调用 | 查 `参考资料/存客宝API完整索引.md` 找到接口 → 构造请求 | +| 数据库查询 | 查下方数据库表索引 → 构造 SQL/MongoDB 查询 | +| 部署运维 | 查 `金仓_存储备份/服务器管理/` 相关脚本 | +| 开发相关 | 查 `存客宝备份/cunkebao_doc/` 相关文档 | +| AI / 触客宝 | 查 API 索引第四节（触客宝）或第二节（AI 知识库） | -## 核心能力 +### 2. API 调用流程 -1. **开发**：与火炬全栈开发协同，整合存客宝获客能力 -2. **部署**：Vercel、宝塔、GitHub Webhook（见 Vercel与v0部署流水线） -3. **运维**：数据库清理（见 数据库管理）、服务器管理 +``` +1. 登录获取 Token + POST /v1/auth/login { account, password, typeId: 1 } + → 拿到 data.token -## 抖音发布 +2. 后续请求带 Authorization: Bearer {token} -存客宝当前**无抖音登录/发布 SDK**。若需将视频发布到抖音，使用「抖音发布」Skill（抖音开放平台 OAuth + 上传/创建视频）；若后续存客宝或腕推提供抖音发布能力，可在 `03_卡木（木）/木叶_视频内容/抖音发布/SKILL.md` 中补充对接方式。 +3. 对外接口（/v1/api/scenarios）需要 apiKey + sign 签名 + 签名算法见 `存客宝对接规范.md` +``` -## 参考 +### 3. 验证结果 -- `开发文档/00_汇总索引.md`：开发文档、功能迭代、需求 -- `开发文档/功能迭代记录.md`：开发流程与版本 -- `开发文档/需求文档.md`：需求与架构 -- `运营中枢/参考资料/项目经验库_知己与类似项目.md`：存客宝获客整合 -- `存客宝备份/cunkebao_doc/`：完整需求与架构 +- HTTP 200 + `code: 200` = 成功 +- 其它 code 查错误码表（见 API 索引） + +--- + +## 系统架构速览 + +``` +客户端（5端） +├── Cunkebao（React 18） — 主管理后台 +├── Touchkebao（React 18）— 客服聊天 +├── SuperAdmin（Next.js 14）— 超管后台 +├── Store（UniApp）— 门店端 +└── aiApp/ckApp（UniApp）— 移动端 + +后端（3服务） +├── Server（ThinkPHP 5.1）— 主业务 API +├── Moncter（Webman/PHP 8.1）— 监控/数据/MCP +└── WebSocket（GatewayWorker）— 实时通信 + +数据层 +├── MySQL（用户/设备/订单/流量池/配置） +├── MongoDB（好友/消息/朋友圈/内容/日志） +└── Redis（缓存/任务队列） +``` + +**API 基地址**：`https://ckbapi.quwanzhi.com` +**WebSocket**：`wss://s2.siyuguanli.com:9993` + +--- + +## 数据库表索引 + +### MySQL 核心表 + +| 表名 | 说明 | 关键字段 | +|:---|:---|:---| +| `users` | 系统用户 | id, username, account, password, isAdmin, companyId, typeId | +| `devices` | 设备 | id, name, device_id, status, online_status, group_id | +| `wechats` | 微信账号 | id, wxid, nickname, device_id, health_score | +| `orders` | 订单 | id, user_id, amount, status, type | +| `traffic_pools` | 流量池 | id, name, rules | +| `traffic_tags` | 流量标签 | id, name, pool_id | +| `traffic_pool`（用户） | 流量池用户 | id, trafficPoolId, phone, wechatId, portrait | +| `scenarios` | 获客场景 | id, apiKey, name, config | +| `workbench_tasks` | 工作台任务 | id, type, status, config, wechat_id | +| `content_categories` | 内容分类 | id, name | +| `distribution_channels` | 分销渠道 | id, name, qrcode, status | +| `computing_packages` | 算力套餐 | id, name, tokens, price | +| `system_config` | 系统配置 | key, value（含 oss_config 等） | +| `departments` | 部门 | id, name, company_id | +| `permissions` | 权限 | id, role_id, resource | + +### MongoDB 核心集合 + +| 集合 | 说明 | +|:---|:---| +| `wechat_friends` | 微信好友信息（头像、昵称、标签、备注） | +| `wechat_messages` | 聊天消息记录 | +| `wechat_moments` | 朋友圈内容 | +| `wechat_chatrooms` | 群聊信息 | +| `content_library` | 内容库素材 | +| `task_logs` | 任务执行日志 | +| `portrait_data` | 用户画像数据 | + +### KR 数据库（Moncter 管辖） + +共 25 个库，关键库：`KR_存客宝`、`KR_存客宝_四表重构KR_KR版`、`KR_卡套私域`。 +完整列表见 `存客宝备份/cunkebao_v3/Moncter/数据库列表.md`。 + +--- + +## 功能模块清单 + +| 模块 | 核心功能 | API 分类 | +|:---|:---|:---| +| **登录认证** | 账密登录、短信登录、JWT Token | 登录相关 | +| **设备管理** | 设备增删改查、状态刷新、微信绑定 | 设备 | +| **微信管理** | 微信号列表、好友管理、健康分、朋友圈 | 微信相关 | +| **工作台** | 自动点赞、朋友圈同步、群发、自动建群、流量分发 | 工作台 | +| **内容库** | 素材管理、AI 改写、Excel 导入 | 内容库 | +| **好友 & 群** | 好友列表/转移、群列表/成员 | 好友 / 群 | +| **场景获客** | 小程序码、获客计划、线索上报（对外 API） | 场景获客 | +| **数据统计** | 今日数据、趋势图、获客场景统计 | 数据统计 | +| **流量池** | 用户管理、标签、旅程、池管理 | 流量池 | +| **AI** | 文本生成、图片生成、AI 知识库、Coze | AI / AI知识库 / Coze | +| **算力** | 套餐购买、Token 分配、明细统计 | 算力 | +| **触客宝** | 客服聊天、快捷回复、问答库、AI 推送、自动问候 | 触客宝 | +| **门店端** | 门店登录、Agent、流量/供应链/算力采购 | 门店端 | +| **分销渠道** | 渠道管理、二维码、收益、提现 | 分销渠道 | +| **底层通信** | WebSocket 设备控制、好友/群/消息同步 | 底层接口 | + +--- + +## 定时任务 + +| 命令 | 说明 | +|:---|:---| +| `sync:wechatData` | 同步微信数据 | +| `sync:allFriends` | 同步所有好友 | +| `workbench:autoLike` | 自动点赞 | +| `workbench:moments` | 朋友圈同步 | +| `workbench:groupPush` | 群消息推送 | +| `workbench:groupCreate` | 自动建群 | +| `workbench:groupWelcome` | 入群欢迎语 | +| `content:collect` | 内容采集 | +| `moments:collect` | 朋友圈采集 | +| `wechat:calculate-score` | 健康分计算 | +| `wechat:update-score` | 健康分更新 | +| `scheduler:run` | 多进程并发调度器 | + +--- + +## 风控机制 + +- **消息间隔**：3-8 秒随机 +- **每日上限**：200 条/微信号 +- **同好友间隔**：≥60 秒 +- **健康分**：基础 100 分，扣分（失败-2、删除-5、举报-20、异常-50）加分（互动+1/天、增长+2/10人、活跃+5/周） +- **健康分 < 60 预警**，< 40 限制，< 20 停用 + +--- + +## 相关文件（Files） + +| 文件 | 路径 | 说明 | +|:---|:---|:---| +| **API 完整索引** | `参考资料/存客宝API完整索引.md` | 200+ 接口按模块分类速查 | +| **文档索引** | `参考资料/存客宝文档索引.md` | cunkebao_doc 结构导航 | +| **对接规范** | `04_卡火/火炬/全栈开发/开发模板/5、接口/存客宝对接规范.md` | 签名算法 + SDK 封装 | +| **技术架构** | `03_卡木/木根/网站逆向分析/参考资料/存客宝技术架构.md` | WebSocket/风控/分发算法 | +| **系统架构** | `存客宝备份/cunkebao_doc/2、架构/系统架构.md` | 5端+3服务架构图 | +| **核心业务链路** | `存客宝备份/cunkebao_doc/2、架构/核心业务链路.md` | 建群/群发/朋友圈流程 | +| **数据库** | `存客宝备份/cunkebao_doc/2、架构/数据库.md` | 数据库连接信息 | +| **对外 API 文档** | `存客宝备份/cunkebao_v3/Server/public/doc/api_v1.md` | 线索上报接口完整文档 | +| **数据库列表** | `存客宝备份/cunkebao_v3/Moncter/数据库列表.md` | 25 个 KR 数据库清单 | +| **服务器脚本** | `金仓_存储备份/服务器管理/scripts/存客宝_*.sh/.py` | 部署/安全/清理/诊断脚本 | +| **Apifox 在线文档** | [链接](https://s.apifox.cn/5989e076-dca9-4345-9025-f6f9a698d1f3) | Apifox 项目 #6037107 | + +--- + +## 依赖（Dependencies） + +- **前置技能**：服务器管理（G07）、数据库管理（G13/G17） +- **联动技能**：全栈开发（F01）、Vercel 部署（G19）、代码修复（F05） +- **外部工具**：php、composer、node、nginx、mysql、mongodb、redis +- **服务器**：存客宝腾讯云服务器（宝塔面板管理） + +--- + +## 快速调用示例 + +### 登录获取 Token + +```bash +curl -X POST https://ckbapi.quwanzhi.com/v1/auth/login \ + -H "Content-Type: application/json" \ + -d '{"account":"13800138000","password":"123456","typeId":1}' +``` + +### 获取设备列表 + +```bash +curl -X GET "https://ckbapi.quwanzhi.com/v1/devices?page=1&limit=20" \ + -H "Authorization: Bearer {token}" +``` + +### 上报线索（对外接口） + +```python +from ckb_client import CunKeBaoClient # 见对接规范 +ckb = CunKeBaoClient(api_key='YOUR_KEY') +ckb.report_lead(phone='13800000000', name='张三', source='抖音') +``` diff --git a/01_卡资（金）/金盾_数据安全/存客宝/参考资料/存客宝API完整索引.md b/01_卡资（金）/金盾_数据安全/存客宝/参考资料/存客宝API完整索引.md new file mode 100644 index 00000000..658047c1 --- /dev/null +++ b/01_卡资（金）/金盾_数据安全/存客宝/参考资料/存客宝API完整索引.md @@ -0,0 +1,488 @@ +# 存客宝 API 完整索引 + +> **来源**：Apifox 项目 #6037107（[在线文档](https://s.apifox.cn/5989e076-dca9-4345-9025-f6f9a698d1f3)） +> **基地址**：`https://ckbapi.quwanzhi.com` +> **认证**：JWT Bearer Token（登录后获取） +> **响应格式**：`{ code: 200, msg: "success", data: {} }` +> **更新**：2026-03-15 + +--- + +## 一、私域操盘手端 + +### 1.1 登录相关 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 用户名密码登录 | POST | `/v1/auth/login` | account + password + typeId，返回 JWT token + member 信息 | +| 获取短信验证码 | POST | `/v1/auth/sms` | 发送手机短信验证码 | +| 手机号登录 | POST | `/v1/auth/mobile` | 手机号 + 验证码登录 | + +### 1.2 设备管理 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 获取设备列表 | GET | `/v1/devices` | 分页，支持状态/关键词筛选 | +| 统计设备数量 | GET | `/v1/devices/count` | 返回设备总数 | +| 设备详情 | GET | `/v1/devices/{id}` | 单台设备信息 | +| 添加设备 | POST | `/v1/devices` | name + device_id + group_id | +| 删除设备 | DELETE | `/v1/devices/{id}` | 删除单台设备 | +| 刷新设备 | POST | `/v1/devices/{id}/refresh` | 刷新设备在线状态 | +| 设备关联微信账号 | POST | `/v1/devices/{id}/bindWechat` | 设备↔微信绑定 | +| 设备配置 | POST | `/v1/devices/{id}/config` | 配置设备参数 | +| 设备操作记录 | GET | `/v1/devices/{id}/logs` | 操作审计日志 | +| 检查设备是否更换微信 | GET | `/v1/devices/{id}/checkWechat` | 检测微信变更 | + +### 1.3 微信相关 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 在线微信号数量 | GET | `/v1/wechats/online/count` | 统计在线数 | +| 微信号数量 | GET | `/v1/wechats/count` | 统计总数 | +| 在线微信号列表 | GET | `/v1/wechats/online` | 在线列表 | +| 刷新微信状态 | POST | `/v1/wechats/{id}/refresh` | 刷新在线状态 | +| 微信客服号详情 | GET | `/v1/wechats/{id}` | 详情 + 关联设备 | +| 好友转移 | POST | `/v1/wechats/friends/transfer` | from → to 批量转移 | +| 概览数据 + 健康分 | GET | `/v1/wechats/{id}/overview` | 好友数/群数/健康分/活跃度 | +| 微信朋友圈 | GET | `/v1/wechats/{id}/moments` | 该账号发布的朋友圈 | +| 朋友圈导出 | GET | `/v1/wechats/{id}/moments/export` | 导出朋友圈数据 | + +### 1.4 工作台 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 创建任务 | POST | `/v1/workbench/tasks` | 群发/点赞/建群/朋友圈等任务 | +| 任务列表 | GET | `/v1/workbench/tasks` | 分页查询工作台任务 | +| 任务详情 | GET | `/v1/workbench/tasks/{id}` | 单个任务详情 | +| 更新任务 | PUT | `/v1/workbench/tasks/{id}` | 修改任务内容 | +| 更新任务状态 | PUT | `/v1/workbench/tasks/{id}/status` | 启用/暂停/完成 | +| 拷贝任务 | POST | `/v1/workbench/tasks/{id}/copy` | 复制任务 | +| 删除任务 | DELETE | `/v1/workbench/tasks/{id}` | 删除任务 | +| 点赞记录 | GET | `/v1/workbench/like-records` | 自动点赞执行记录 | +| 朋友圈发布记录 | GET | `/v1/workbench/moments-records` | 朋友圈发布记录 | +| 获取设备标签 | GET | `/v1/workbench/device-tags` | 当前设备标签 | +| 京东联盟导购媒体 | GET | `/v1/workbench/jd/media` | 京东联盟媒体列表 | +| 京东联盟广告位 | GET | `/v1/workbench/jd/adzone` | 京东联盟广告位 | +| 流量分发记录 | GET | `/v1/workbench/traffic-records` | 流量分发日志 | +| 通讯录导入记录 | GET | `/v1/workbench/contact-import` | 通讯录导入日志 | +| 群发统计 | GET | `/v1/workbench/mass-send/stats` | 群发汇总数据 | +| 群发记录 | GET | `/v1/workbench/mass-send/records` | 群发详细记录 | +| 常用功能列表 | GET | `/v1/workbench/common-features` | 常用功能快捷入口 | + +### 1.5 内容库 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 创建内容库 | POST | `/v1/contents` | title + content + type + images | +| 内容库列表 | GET | `/v1/contents` | 分页 + 分类筛选 | +| 内容库详情 | GET | `/v1/contents/{id}` | 单条内容 | +| 素材列表 | GET | `/v1/contents/{id}/materials` | 库下素材 | +| 素材删除 | DELETE | `/v1/contents/materials/{id}` | 删除素材 | +| AI 改写 | POST | `/v1/contents/ai-rewrite` | AI 改写内容 | +| AI 改写保存 | POST | `/v1/contents/ai-rewrite/save` | 保存改写结果 | +| 导入 Excel（含图片） | POST | `/v1/contents/import-excel` | multipart | + +### 1.6 好友 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 好友列表 | GET | `/v1/friends` | 分页 + tag + keyword | +| 好友转移 | POST | `/v1/friends/transfer` | 批量转移好友 | + +### 1.7 群 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 群列表 | GET | `/v1/groups` | 分页查询群聊 | +| 群好友列表 | GET | `/v1/groups/{id}/members` | 群成员列表 | + +### 1.8 场景获客 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 获取小程序码 | GET | `/v1/scenarios/qrcode` | 生成获客小程序码 | +| 已获客/已添加用户 | GET | `/v1/scenarios/users` | 获客用户列表 | +| 计划任务列表 | GET | `/v1/scenarios/plans` | 获客计划管理 | + +**对外线索上报接口**（第三方调用）： + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 线索上报 | POST | `/v1/api/scenarios` | apiKey + sign 签名鉴权，上报线索+画像 | + +### 1.9 数据统计 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 今日数据 | GET | `/v1/statistics/today` | 今日获客/好友/消息数 | +| 基础信息统计 | GET | `/v1/statistics/overview` | 综合数据概览 | +| 获客场景统计 | GET | `/v1/statistics/scenarios` | 各渠道获客数据 | +| 折线统计图 | GET | `/v1/statistics/trends` | 时间序列趋势 | +| 添加好友折线图 | GET | `/v1/statistics/friend-trends` | 好友增长趋势 | +| 用户数据统计 | GET | `/v1/statistics/users` | 用户维度统计 | + +### 1.10 流量池 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 用户列表 | GET | `/v1/traffic-pool/users` | 流量池内用户列表 | +| 用户旅程 | GET | `/v1/traffic-pool/users/{id}/journey` | 用户行为轨迹 | +| 用户标签 | GET | `/v1/traffic-pool/users/{id}/tags` | 用户标签 | +| 用户详情 | GET | `/v1/traffic-pool/users/{id}` | 用户完整信息 | +| 流量池列表 | GET | `/v1/traffic-pool/pools` | 流量池管理 | +| 流量池添加 | POST | `/v1/traffic-pool/pools` | 创建流量池 | +| 流量池编辑 | PUT | `/v1/traffic-pool/pools/{id}` | 编辑流量池 | +| 流量池删除 | DELETE | `/v1/traffic-pool/pools/{id}` | 删除流量池 | +| 用户加入流量池 | POST | `/v1/traffic-pool/users/add` | 批量加入 | + +### 1.11 用户相关 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 编辑用户信息 | PUT | `/v1/users/profile` | 修改个人资料 | +| 修改密码 | PUT | `/v1/users/password` | 修改登录密码 | + +### 1.12 AI + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| OpenAI 文本生成 | POST | `/v1/ai/openai/text` | 调用 OpenAI 生成文本 | +| 文本生成 | POST | `/v1/ai/text` | 通用文本生成 | +| 豆包图片生成 | POST | `/v1/ai/doubao/image` | 豆包模型图片→文本 | +| 图片生成 | POST | `/v1/ai/image` | AI 图片生成 | + +### 1.13 算力 + +| 接口 | 方法 | 路径 | 说明 | +|:---|:---|:---|:---| +| 套餐列表 | GET | `/v1/computing/packages` | 算力套餐 | +| 购买套餐 | POST | `/v1/computing/purchase` | 购买算力 | +| 订单详情 | GET | `/v1/computing/orders/{id}` | 查询订单 | +| 算力明细 | GET | `/v1/computing/details` | 消耗明细 | +| 订单列表 | GET | `/v1/computing/orders` | 全部订单 | +| 算力统计 | GET | `/v1/computing/stats` | 汇总统计 | +| 分配 Token | POST | `/v1/computing/allocate` | 管理员分配 Token | + +--- + +## 二、AI 知识库 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 保存统一提示词 | POST | 设置全局 AI 系统提示词 | +| 初始化 AI 功能 | POST | 每次启用 AI 需先调用 | +| 发布并应用 AI 工具 | POST | 发布 AI 配置到生产 | +| 知识库类型 - 列表 | GET | CRUD 知识库分类 | +| 知识库类型 - 添加 | POST | | +| 知识库类型 - 编辑 | PUT | | +| 知识库类型 - 删除 | DELETE | | +| 知识库类型 - 修改状态 | PUT | 启用/禁用 | +| 知识库 - 列表 | GET | CRUD 知识库条目 | +| 知识库 - 添加 | POST | | +| 知识库 - 删除 | DELETE | | + +--- + +## 三、门店相关 & 分销渠道 + +### 3.1 门店账号管理 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 获取账号列表 | GET | 门店账号列表 | +| 创建账号 | POST | 新增门店账号 | +| 编辑账号 | PUT | 修改门店信息 | +| 删除账号 | DELETE | 删除门店账号 | +| 禁用/启用账号 | PUT | 状态切换 | + +### 3.2 分销渠道 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 渠道列表 | GET | 分销渠道列表 | +| 渠道添加 | POST | 新增渠道 | +| 编辑渠道 | PUT | 修改渠道 | +| 删除渠道 | DELETE | | +| 禁用/启用 | PUT | 状态切换 | +| 生成渠道二维码 | POST | 生成渠道专属二维码 | +| 渠道统计 | GET | 渠道业绩数据 | +| 渠道收益统计（全局） | GET | 全局收益汇总 | +| 渠道收益明细列表 | GET | 收益明细 | +| 审核提现申请 | POST | 管理员审核 | +| 标记已打款 | PUT | 打款确认 | +| 验证 Token | POST | 渠道端 Token 校验 | +| 创建提现申请 | POST | 渠道方提现 | +| 修改密码 | PUT | 渠道用户改密 | + +--- + +## 四、触客宝（Touchkebao） + +### 4.1 登录 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 用户名密码登录 | POST | 触客宝端登录 | + +### 4.2 好友/群/聊天 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 好友列表 | GET | 触客宝好友列表 | +| 好友详情 | GET | 好友详细信息 | +| 群列表 | GET | 群聊列表 | +| 群详情 | GET | 群信息 | +| 群好友 | GET | 群成员 | +| 聊天记录列表 | GET | 群/好友聊天记录 | +| 标记已读 | PUT | 消息已读 | +| 聊天记录详情 | GET | 单条聊天详情 | +| 单条消息发送状态 | GET | 消息送达状态 | +| AI 群公告 | POST | AI 生成群公告 | +| 修改用户信息 | PUT | 编辑好友备注/标签 | +| 添加好友任务记录 | GET | 添加好友日志 | + +### 4.3 客服 & 待办 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 客服列表 | GET | 客服账号列表 | +| 待办事项列表 | GET | 待办项管理 | +| 待办事项添加 | POST | | +| 待办事项处理 | PUT | 标记完成 | +| 跟进提醒列表 | GET | 跟进提醒 | +| 跟进提醒添加 | POST | | +| 跟进提醒处理 | PUT | | + +### 4.4 AI 配置 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| AI 全局配置设置 | POST | 设置全局 AI 参数 | +| AI 全局配置列表 | GET | 获取 AI 配置 | +| AI 好友配置批量设置 | POST | 批量配置好友 AI | +| AI 好友配置获取 | GET | 获取好友 AI 配置 | +| AI 好友配置设置 | POST | 单好友 AI 配置 | +| AI 对话 | POST | 触发 AI 对话 | +| 获取用户 tokens | GET | Token 余额 | + +### 4.5 内容管理 + +#### 问答库 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表/添加/详情/删除/更新 | CRUD | 问答库管理 | + +#### 素材管理 v1 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表/获取所有/添加/详情/删除/更新 | CRUD | 素材管理 | + +#### 违禁词管理 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表/添加/详情/删除/更新/修改状态 | CRUD | 违禁词过滤 | + +#### 关键词管理 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表/添加/详情/删除/更新/修改状态 | CRUD | 关键词回复 | + +#### 内容管理 v2 — 朋友圈定时发布 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表/添加/编辑/删除 | CRUD | 朋友圈定时发布 | + +### 4.6 快捷聊天 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 快捷语列表 | GET | 快捷回复语 | +| 快捷语分组 - 添加/编辑/删除 | CRUD | 分组管理 | +| 快捷语 - 添加/编辑/删除 | CRUD | 快捷语管理 | + +### 4.7 消息中心 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 列表 | GET | 系统消息列表 | +| 单条标记已读 | PUT | | +| 全部标记已读 | PUT | | + +### 4.8 自动问候 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 获取规则列表 | GET | 自动问候规则 | +| 创建规则 | POST | | +| 规则详情 | GET | | +| 删除规则 | DELETE | | +| 修改启用状态 | PUT | | +| 更新规则 | PUT | | +| 复制规则 | POST | | + +### 4.9 AI 智能推送 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 推送列表 | GET | AI 推送任务 | +| 添加推送 | POST | | +| 推送详情 | GET | | +| 更新推送 | PUT | | +| 删除推送 | DELETE | | +| 修改推送状态 | PUT | | +| 统计概览 | GET | 推送效果统计 | + +### 4.10 分组 & 信息修改 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 分组列表/新增/更新/删除 | CRUD | 好友/群分组 | +| 移动好友或群的分组 | PUT | 批量移动 | +| 修改用户备注 | PUT | 备注修改 | +| 修改用户标签 | PUT | 标签修改 | +| 用户迁移 | POST | 跨账号迁移 | +| 记录聊天消息 | POST | WSS 消息落库 | +| 更新发送状态 | PUT | 消息送达状态 | +| 置顶 | PUT | 置顶聊天 | + +--- + +## 五、底层接口（代理服务器通信层） + +### 5.1 微信群 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 获取微信群成员列表 | GET | 底层群成员同步 | +| 获取微信群聊列表 | GET | 底层群列表同步 | +| 发送群消息 | POST | WebSocket 下发群消息 | + +### 5.2 微信好友 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 获取微信好友列表 | GET | 底层好友同步 | +| 添加好友 | POST | WebSocket 添加好友 | +| 添加好友任务列表 | GET | 添加好友任务日志 | +| 发送消息 | POST | WebSocket 发送私聊 | + +### 5.3 朋友圈 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 朋友圈发布记录 | GET | 底层发布记录 | +| 获取朋友圈 | GET | 抓取好友朋友圈 | +| 获取朋友圈素材地址 | GET | 朋友圈图片/视频 URL | +| 获取微信客服 | GET | 微信客服列表 | + +### 5.4 登录 & 聊天记录 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 登录 | POST | 底层代理登录 | +| 重新获取 Token | POST | Token 刷新 | +| 获取商户基本信息 | GET | 商户数据 | +| 退出登录 | POST | | +| 获取验证码 | GET | | +| 获取微信消息 | GET | 聊天记录同步 | +| 获取微信群消息 | GET | 群聊记录同步 | + +### 5.5 设备 & 部门 & 账号 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 添加/获取设备列表 | POST/GET | 底层设备 | +| 设备分组 CRUD | POST/GET/PUT | | +| 更新设备通讯录 | PUT | 同步通讯录 | +| 创建/修改/获取/删除部门 | CRUD | 公司部门 | +| 设置权限 | POST | 权限分配 | +| 获取公司账号列表 | GET | 账号管理 | +| 创建账号（+部门） | POST | | + +### 5.6 分配规则 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 获取/新增/删除/编辑分配规则 | CRUD | 流量分发规则 | +| 自动创建分配规则 | POST | 系统自动生成 | + +--- + +## 六、门店端（新版） + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 账号密码登录 | POST | 门店登录 | +| 免密登录（设备 ID） | POST | 设备绑定免密 | +| 发送短信验证码 | POST | | +| 手机验证码登录 | POST | | +| Agent 模块列表 | GET | 获取 Agent 模块 | +| 更新模块状态 | PUT | 启停 Agent | +| 流量套餐 CRUD | GET/POST | 流量采购 | +| 供应链套餐 CRUD | GET/POST/PUT | 供应商采购 | +| 算力套餐 CRUD | GET/POST | 算力管理 | +| 获取/更新用户资料 | GET/PUT | 个人中心 | +| 获取设备和微信信息 | GET | | +| 获取动态记录 | GET | | +| 客户列表/详情/更新 | GET/PUT | 客户管理 | + +--- + +## 七、Coze 集成 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 查看会话列表 | GET | Coze 会话管理 | +| 创建会话 | POST | | +| 创建对话 | POST | 发送消息给 Coze | +| 查看对话详情 | GET | | +| 查看对话明细 | GET | | +| 查看空间列表 | GET | Coze 工作空间 | +| 获取智能体列表 | GET | Coze Agents | +| 对话列表 | GET | | + +--- + +## 八、其它 + +| 接口 | 方法 | 说明 | +|:---|:---|:---| +| 文件上传 | POST | 通用文件/图片上传 | +| 测试支付 | POST | 支付测试 | +| 检测 APP 更新 | GET | 版本检测 | +| 对外接口生成 TOKEN | POST | 第三方调用 Token | + +--- + +## WebSocket 命令类型（实时通信） + +通过 WSS 连接到 `wss://s2.siyuguanli.com:9993`。 + +| 命令 | 说明 | +|:---|:---| +| `CmdSignIn` | 登录认证（accessToken + accountId） | +| `CmdHeartbeat` | 心跳保活（30s 间隔） | +| `CmdFetchMoment` | 获取朋友圈 | +| `CmdSendMsg` | 发送消息 | +| `CmdCreateChatroom` | 创建群聊 | +| `CmdAddFriend` | 添加好友 | + +--- + +## 签名算法（对外接口） + +用于 `/v1/api/scenarios` 等对外接口： + +1. 移除 `sign`、`apiKey`、`portrait` +2. 移除 null/空字符串 +3. 按键名 ASCII 升序 +4. 只取值拼接（无分隔符） +5. 第一次 MD5 +6. `sign = MD5(firstMd5 + apiKey)` + +详见 `存客宝对接规范.md`。 diff --git a/SKILL_REGISTRY.md b/SKILL_REGISTRY.md index 5ce82bf9..9c2d8a2f 100644 --- a/SKILL_REGISTRY.md +++ b/SKILL_REGISTRY.md @@ -68,7 +68,7 @@ | G12 | 微信管理 | 金仓 | 微信分析、RFM | `01_卡资（金）/金仓_存储备份/微信管理/SKILL.md` | 微信数据分析、标签管理 | | G13 | 数据库管理 | 金仓 | MySQL、清理数据库 | `01_卡资（金）/金仓_存储备份/数据库管理/SKILL.md` | 数据库维护与优化 | | G14 | 文件整理 | 金仓 | 整理文件、外置硬盘 | `01_卡资（金）/金仓_存储备份/文件整理/SKILL.md` | 大规模文件分类与整理 | -| G15 | 存客宝 | 金盾 | 存客宝、cunkebao | `01_卡资（金）/金盾_数据安全/存客宝/SKILL.md` | 存客宝系统维护 | +| G15 | 存客宝 | 金盾 | **存客宝、cunkebao、私域、获客、工作手机、场景获客、流量池、触客宝、touchkebao、AI数字员工、分销渠道、微信管理、存客宝API、存客宝数据库** | `01_卡资（金）/金盾_数据安全/存客宝/SKILL.md` | 存客宝全栈管理：200+API、数据库、设备、微信、AI、触客宝、门店、分销 | | G16 | 远程环境一键部署 | 金盾 | 远程部署、装Clash | `01_卡资（金）/金盾_数据安全/远程环境一键部署/SKILL.md` | 远程服务器环境配置 | | G17 | 数据库管理(安全) | 金盾 | 数据库、备份数据 | `01_卡资（金）/金盾_数据安全/数据库管理/SKILL.md` | 数据库安全与备份 | | G18 | 微信管理(安全) | 金盾 | 微信数据库解析 | `01_卡资（金）/金盾_数据安全/微信管理/SKILL.md` | 微信数据库解密与分析 | diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index d16de28a..562717bb 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -364,3 +364,4 @@ | 2026-03-15 19:47:40 | 🔄 卡若AI 同步 2026-03-15 19:47 | 更新：水溪整理归档、卡木、火炬、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-15 20:28:48 | 🔄 卡若AI 同步 2026-03-15 20:28 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | | 2026-03-15 23:02:37 | 🔄 卡若AI 同步 2026-03-15 23:02 | 更新：水溪整理归档、卡木、运营中枢、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 11 个 | +| 2026-03-15 23:20:14 | 🔄 卡若AI 同步 2026-03-15 23:20 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index 3dd28c1a..2d4f08d3 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -367,3 +367,4 @@ | 2026-03-15 19:47:40 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-15 19:47 | 更新：水溪整理归档、卡木、火炬、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-15 20:28:48 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-15 20:28 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-15 23:02:37 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-15 23:02 | 更新：水溪整理归档、卡木、运营中枢、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | +| 2026-03-15 23:20:14 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-15 23:20 | 更新：运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |