feihu1991/dsh-kefu

README 摘要

dsh-kefu — DSH 多租户客服平台 给 DeepSeek Harness 套一层 多租户客服平台壳 ： 一台服务器集中管理多个商家，每个商家用独立账号登录，创建自己的「店员 Agent」 （可选模型服务档位，档位细节由平台屏蔽），通过控制台或 网页问答组件 接待顾客。 典型场景：淘宝智能客服 SaaS。平台方开账号 → 商家登录创建客服 Agent → 顾客在店铺网页上咨询。 目录 目录 说明 server/ DSH 插件 dsh-kefu （核心交付，挂到 web profile） console/ 商家控制台前端源码（React + Vite，构建产物进 server/public/ ） client/ 桌面客户端（Tauri 2 壳子，连接服务器地址） docs/ 详细文档（API 一览、部署、二次开发） 快速部署（服务器） 前置：Node 18+ / pnpm、DeepSeek Harness（ npm i -g @deepseek-ai/dsh ）、一个模型 API Key。 启动后： - 客服平台： http:// :3080/kefu/ （首次注册商家账号） - 平台超管：默认账号 admin ，密码在启动日志里打印（ [kefu] 已创建平台超管 ），首次登录后请修改 - 服务档位：默认创建「高级客服 / 中级客服 / 基础客服」三档（映射到 DeepSeek 模型）， 超管可在「平台管理 → 服务档位」调整或新增（provider/model 对商家不可见） 对外暴露端口时建议在前面加一层反向代理（HTTPS），并把 dsh web --trusted-host 加上你的域名（远程浏览器设置功能需要）。 核心能力 多租户与数据隔离 - 商家（merchant）是隔离单元；账号、Agent、会话、消息全部按 merchant id 隔离 - 每个商家有独立工作区目录 dataDir/merchants/ / ，Agent 的 DSH 会话 cwd 指向它 - 越权访问（跨商家读会话 / 改 Agent）一律 404 账号与权限 角色 能力 superadmin 平台管理：商家 / 账号 / 档位 / 平台设置 / 审计 merchant admin 商家管理员：建店员账号、建/改/停 Agent、网页客服凭据、接待 merchant staff 店员：仅接待会话 - 密码 scrypt 存储；登录连续失败 5 次锁定 15 分钟；会话 12 小时（Cookie + Bearer） 店员 Agent - 商家创建 Agent：名称、人设话术、 服务档位 （商家只看到档位名，如「高级客服」，看不到 provider/model） - 每轮对话由插件通过 ctx.agents.create/resume 驱动 DSH 会话： - 档位 →…

分类