更新001约束条件 + 004快手API信息收集

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客户端）的数据基础

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覆盖商品、订单、物流、分销、客服等核心场景。需要先获取开发者账号才能测试接口。