From b1bbcb52920a4aa190f2ca24fadecefeac1e0270 Mon Sep 17 00:00:00 2001 From: jesxion Date: Mon, 13 Apr 2026 10:33:36 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0001=E7=BA=A6=E6=9D=9F?= =?UTF-8?q?=E6=9D=A1=E4=BB=B6=20+=20004=E5=BF=AB=E6=89=8BAPI=E4=BF=A1?= =?UTF-8?q?=E6=81=AF=E6=94=B6=E9=9B=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tasks/001-openviking-knowledge-base.md | 55 +++++++++++++------- tasks/004-kuaishou-cli.md | 70 +++++++++++++++----------- 2 files changed, 77 insertions(+), 48 deletions(-) diff --git a/tasks/001-openviking-knowledge-base.md b/tasks/001-openviking-knowledge-base.md index 9a09888..a824697 100644 --- a/tasks/001-openviking-knowledge-base.md +++ b/tasks/001-openviking-knowledge-base.md @@ -5,41 +5,58 @@ - **任务名称**: OpenViking 知识库底层建设 - **负责人**: jesxion - **创建日期**: 2026-04-13 -- **预计工期**: 待定（深度打磨中） +- **预计工期**: 待定 - **状态**: 深度打磨中 ## 目标 -在新的云服务器上构建知识库系统，实现以下资源的存储与检索： +在新的**弹性云服务器**上构建知识库系统，实现以下资源的存储与检索： - PDF 文档 - Word 文档 - 视频文件 - 语音文件 ## 核心定位 -**整个系统的数据基础**，被002（Windows客户端）、004（快手CLI）等其他任务依赖。 +整个系统的**数据基础**，被002（Windows客户端）、004（快手CLI）等其他任务依赖。 + +## 关键约束（已确认） + +### 服务器 +- **新购云服务器**，弹性伸缩（根据使用量调整规格） +- **与L_SER无关**（L_SER是本地开发/测试用途） + +### 架构要求 +- **多租户隔离**：不同客户/项目的数据完全隔离 +- **多Agent调用**：支持多个Agent并发查询和写入 +- **高性能**：支持向量检索和全文检索 ## 待深度打磨的关键问题 -### 1. 新云服务器规划 -- [ ] 服务器规格选型（CPU/GPU/内存/存储） -- [ ] 预算评估 -- [ ] 与现有L_SER的关系：扩展还是独立新建？ +### 1. 云服务器规格规划 +- [ ] 初始规格选型（最小化成本起步） +- [ ] 弹性扩缩策略（何时扩容/缩容） +- [ ] 预算上限 -### 2. 知识库存储架构 +### 2. 多租户隔离方案 +- [ ] 数据库层面隔离（schema per tenant / database per tenant） +- [ ] 向量数据库 namespace 设计 +- [ ] 文件存储隔离（目录结构 + 权限） +- [ ] API层面的租户认证 + +### 3. 知识库存储架构 - [ ] 多模态资源的存储schema设计 -- [ ] 向量数据库选型（Chroma / Milvus / Qdrant） -- [ ] 原生文件存储 vs 对象存储方案 -- [ ] 视频/语音的预处理方案（转码/切片/提取音频） +- [ ] 向量数据库选型（Milvus / Qdrant / Chroma with namespace） +- [ ] 原生文件存储 vs 对象存储（OSS/MinIO） +- [ ] 视频/语音的预处理（转码/切片/提取音频 → 向量化） -### 3. 多Agent调用协议 -- [ ] 接口设计（REST / gRPC / 内部消息） -- [ ] 认证机制 -- [ ] 查询语义 vs 关键词的平衡 +### 4. 多Agent调用协议 +- [ ] 接口设计（REST / gRPC） +- [ ] 认证机制（API Key / JWT） +- [ ] 并发控制 +- [ ] 缓存策略（减少重复查询） -### 4. 与现有OpenViking的关系 -- [ ] 现有L_SER部署的OpenViking用途？ -- [ ] 新知识库是扩展还是独立服务？ -- [ ] 数据是否互通？ +### 5. 与现有系统的关系 +- [ ] 与L_SER完全独立 +- [ ] 新云服务器自建，不复用现有资源 ## 依赖关系 - 是002（Windows客户端）的数据基础 diff --git a/tasks/004-kuaishou-cli.md b/tasks/004-kuaishou-cli.md index 631663c..8797b98 100644 --- a/tasks/004-kuaishou-cli.md +++ b/tasks/004-kuaishou-cli.md @@ -11,16 +11,49 @@ ## 目标 封装一套 CLI 工具和 Hermes Skills，使 Agent 能够调用 CLI 获取快手店铺信息。 -## 应用场景 -- Agent 自动化运营快手店铺 -- 数据获取（店铺信息、订单、粉丝等） +## 已收集信息 -## 前置条件 -- [ ] 获取快手开放平台 API 文档 -- [ ] 申请快手开发者账号 -- [ ] 了解相关接口权限 +### 快手电商开放平台 +- **地址**: https://open.kwaixiaodian.com/ +- **文档**: https://open.kwaixiaodian.com/zone/new/docs/dev + +### 已开放的 API 类别 +根据官网首页展示，快手电商开放平台提供以下 API： + +| 类别 | 功能 | +|-----|------| +| 商品管理 | 管理商品信息/SKU、上下架商品、更新库存 | +| 订单管理 | 查看/管理订单、快速发货、更新物流信息 | +| 退款管理 | 查看/处理退款信息 | +| 物流管理 | 新增/管理运费模板 | +| 分销管理 | 管理推广位、管理分销计划/商品 | +| 客服管理 | 发送客服信息、订单/商品卡片 | + +### 接入流程 +1. 注册认证 → 2. 创建应用 → 3. 开发测试 → 4. 开发上线 + +### 注意事项 +- API文档需要**登录后才能访问完整内容** +- 应用类型：自用型应用（供自己店铺使用）/ 第三方应用（在服务市场售卖） + +## 待确认 + +### 需要获取的信息 +- [ ] **账号**：是否有快手电商开放平台的开发者账号？ +- [ ] **具体接口**：店铺信息相关接口（店铺基本信息、资质信息等） +- [ ] **认证方式**：API Key / OAuth +- [ ] **权限申请**：需要哪些权限才能访问店铺信息 + +### Agent 需要获取的店铺信息（推测） +- [ ] 店铺基本信息（名称、Logo、简介） +- [ ] 店铺资质信息 +- [ ] 店铺评分/等级 +- [ ] 商品列表 +- [ ] 订单数据 +- [ ] 客服消息 ## 技术方案（待设计） + ### CLI 设计 - [ ] CLI 命令结构设计 - [ ] API 接口封装 @@ -30,26 +63,5 @@ - [ ] skill 结构设计 - [ ] 与 Agent 集成方式 -## 任务分解 -### 阶段一：信息收集 -- [ ] 获取快手开放平台 API 文档 -- [ ] 了解店铺信息相关接口 -- [ ] 确认认证方式（API Key / OAuth） - -### 阶段二：CLI 开发 -- [ ] 项目结构搭建 -- [ ] 核心 API 接口封装 -- [ ] CLI 命令实现 -- [ ] 认证模块 - -### 阶段三：Hermes Skill 封装 -- [ ] skill 结构设计 -- [ ] 文档编写 -- [ ] 测试验证 - -## 快手开放平台参考 -- **官网**: https://open.kuaishou.com/ -- **文档中心**: https://open.kuaishou.com/docs - ## 备注 -需要确认是否有现成的快手 API 可用，部分能力可能需要商务洽谈 +快手电商开放平台是主流电商平台中开放程度较高的，API覆盖商品、订单、物流、分销、客服等核心场景。需要先获取开发者账号才能测试接口。