{"skill":{"slug":"enterprise-kb-manager","displayName":"Enterprise Knowledge Base Manager","summary":"企业知识库管理。用户需要上传文档、添加知识、更新资料、删除文档、管理知识库、初始化系统时调用。同时支持业务问答：当用户提出业务问题、公司政策、流程规范等问题时，优先检索知识库后回答。","description":"---\r\nname: kb-manager\r\ndescription: 企业知识库管理。用户需要上传文档、添加知识、更新资料、删除文档、管理知识库、初始化系统时调用。同时支持业务问答：当用户提出业务问题、公司政策、流程规范等问题时，优先检索知识库后回答。\r\nmetadata: {\"openclaw\": {\"emoji\": \"📚\", \"requires\": {\"bins\": [\"python3\"]}, \"skillKey\": \"kb-manager\", \"version\": \"1.1.0\", \"always-load\": true}}\r\n---\r\n\r\n# 知识库管理系统 (KB Manager)\r\n\r\n基于ChromaDB的本地知识库管理系统，支持多种文档格式的上传、管理和智能问答。\r\n\r\n## 使用方法\r\n\r\n### 对话式交互\r\n- 发送文件并添加说明: **\"upload to kb\"** 或 **\"上传到知识库\"**\r\n- 直接提问进行智能问答\r\n- 支持格式: PDF, DOCX, TXT, MD\r\n\r\n### 命令行使用\r\n```bash\r\n# 进入对话模式\r\npython main.py chat\r\n\r\n# 上传文档\r\npython main.py upload <文件路径> [文档名称]\r\n\r\n# 查询知识库\r\npython main.py query <查询内容>\r\n\r\n# 列出文档\r\npython main.py list\r\n\r\n# 显示统计\r\npython main.py stats\r\n```\r\n\r\n## 示例\r\n\r\n### 上传文档\r\n```\r\n用户: [附件: 公司政策.pdf] 上传到知识库\r\n助手: ✅ 文档上传成功！已处理 公司政策.pdf，创建了 45 个文档块。\r\n```\r\n\r\n### 智能问答\r\n```\r\n用户: 公司的休假政策是什么？\r\n助手: 根据公司政策文档，休假政策包括：\r\n- 年假：每年15天带薪年假\r\n- 病假：每年10天带薪病假\r\n- 远程办公：每周可远程2天\r\n```\r\n\r\n### 文档管理\r\n```\r\n用户: list kb documents\r\n助手: 📚 知识库文档列表：\r\n1. 公司政策.pdf (45 chunks)\r\n2. 员工手册.docx (23 chunks)\r\n```\r\n\r\n## 🚀 快速开始\r\n\r\n### 1. 安装依赖\r\n\r\n```bash\r\ncd skills/kb-manager\r\npip install -r requirements.txt\r\n```\r\n\r\n### 2. 配置API密钥\r\n\r\n**方式一：环境变量**\r\n```powershell\r\n# DashScope (阿里云千问) - 推荐\r\n$env:DASHSCOPE_API_KEY='your-dashscope-key'\r\n\r\n# 或者 OpenAI\r\n$env:OPENAI_API_KEY='your-openai-key'\r\n```\r\n\r\n**方式二：OpenClaw配置文件**\r\n编辑 `~/.openclaw/openclaw.json`:\r\n```json\r\n{\r\n  \"skills\": {\r\n    \"entries\": {\r\n      \"kb-manager\": {\r\n        \"enabled\": true,\r\n        \"env\": {\r\n          \"DASHSCOPE_API_KEY\": \"your-dashscope-key\"\r\n        },\r\n        \"config\": {\r\n          \"embeddingProvider\": \"dashscope\",\r\n          \"embeddingModel\": \"text-embedding-v3\",\r\n          \"chunkSize\": 500,\r\n          \"retrievalTopK\": 5\r\n        }\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### 3. 初始化系统环境\r\n\r\n```bash\r\n# 首次使用时，初始化系统环境\r\npython main.py setup\r\n```\r\n\r\n这个命令会：\r\n- 创建系统级数据目录\r\n- 初始化ChromaDB数据库\r\n- 设置正确的权限\r\n- 验证系统配置\r\n\r\n### 4. 测试系统\r\n\r\n```bash\r\n# 测试系统状态\r\npython main.py stats\r\n\r\n# 测试查询功能\r\npython main.py query \"测试查询\"\r\n```\r\n\r\n## 📋 使用方法\r\n\r\n### 上传文档\r\n- 发送文件并添加说明: **\"upload to kb\"** 或 **\"上传到知识库\"**\r\n- 支持格式: PDF, DOCX, TXT, MD\r\n- 示例: `[附件: 公司政策.pdf] 上传到知识库`\r\n\r\n### 智能问答\r\n- 直接提问，系统会自动搜索相关文档\r\n- 示例: \r\n  - `公司的休假政策是什么？`\r\n  - `如何申请病假？`\r\n  - `远程办公的规定是什么？`\r\n\r\n### 文档管理\r\n- `python main.py list` - 查看所有文档\r\n- `python main.py stats` - 显示统计信息\r\n- `python main.py delete <文档ID>` - 删除文档\r\n- `python main.py setup` - 初始化系统环境\r\n\r\n## ⚙️ 配置选项\r\n\r\n在 `config.json` 或 OpenClaw 配置中设置:\r\n\r\n```json\r\n{\r\n  \"embeddingProvider\": \"dashscope\",\r\n  \"embeddingModel\": \"text-embedding-v3\", \r\n  \"embeddingBaseUrl\": \"https://dashscope.aliyuncs.com/compatible-mode/v1\",\r\n  \"chunkSize\": 500,\r\n  \"chunkOverlap\": 50,\r\n  \"retrievalTopK\": 5,\r\n  \"collectionName\": \"enterprise_kb\",\r\n  \"vectorDimension\": 1024\r\n}\r\n```\r\n\r\n**注意**: 数据库路径和文档目录由系统自动管理，无需手动配置。\r\n\r\n## 🏗️ 技术架构\r\n\r\n- **向量数据库**: ChromaDB (本地存储，无需Docker)\r\n- **文档存储**: 系统级目录 (自动配置)\r\n- **向量存储**: 系统级目录 (自动配置)\r\n- **嵌入模型**: DashScope text-embedding-v3 (1024维) 或 OpenAI\r\n- **支持格式**: PDF, DOCX, TXT, Markdown\r\n- **分块策略**: 可配置大小和重叠度\r\n- **搜索算法**: 余弦相似度\r\n\r\n## 📁 系统数据目录\r\n\r\n知识库数据存储在系统级固定目录中，所有skills自动共享：\r\n\r\n**Windows**: `C:/ProgramData/kb-data/`\r\n**Linux/Mac**: `/usr/local/share/kb-data/` 或 `~/.local/share/kb-data/`\r\n\r\n```\r\nkb-data/\r\n├── chroma_db/     # 向量数据库\r\n└── documents/     # 原始文档\r\n```\r\n\r\n这种设计的优势：\r\n- **固定路径**: 所有agent自动使用相同路径\r\n- **无需配置**: 不需要环境变量或符号链接  \r\n- **系统标准**: 遵循操作系统标准目录结构\r\n- **自动权限**: 智能处理权限问题\r\n\r\n## 🔧 故障排除\r\n\r\n### API密钥问题\r\n```bash\r\n# 检查环境变量 (Windows)\r\necho $env:DASHSCOPE_API_KEY\r\n\r\n# 检查环境变量 (Linux/Mac)  \r\necho $DASHSCOPE_API_KEY\r\n\r\n# 设置API密钥 (Windows)\r\n$env:DASHSCOPE_API_KEY='your-api-key'\r\n\r\n# 设置API密钥 (Linux/Mac)\r\nexport DASHSCOPE_API_KEY='your-api-key'\r\n\r\n# 测试API连接\r\npython -c \"import os; print('API Key:', os.getenv('DASHSCOPE_API_KEY', 'Not Set'))\"\r\n```\r\n\r\n### 依赖安装问题\r\n```bash\r\n# 重新安装依赖\r\npip install -r requirements.txt --force-reinstall\r\n\r\n# 如果遇到grpcio问题，ChromaDB已默认配置无需Docker\r\npip install chromadb --upgrade\r\n```\r\n\r\n### 系统环境问题\r\n```bash\r\n# 初始化系统环境\r\npython main.py setup\r\n\r\n# 检查系统状态和路径\r\npython main.py stats\r\n\r\n# 验证系统目录权限\r\npython -c \"from src.system_config import print_system_info; print_system_info()\"\r\n```\r\n\r\n### 数据库问题\r\n```bash\r\n# 系统会自动管理数据库，如需重置：\r\n# 1. 备份重要文档\r\n# 2. 删除系统目录 (需要管理员权限)\r\n# 3. 重新初始化\r\npython main.py setup\r\n\r\n# 检查ChromaDB状态\r\npython -c \"from src.chroma_client import ChromaVectorDB; db = ChromaVectorDB(); print('DB Status:', db.get_collection_info())\"\r\n```\r\n\r\n### 权限问题\r\n```bash\r\n# Windows: 确保对 C:/ProgramData/ 有写权限\r\n# Linux/Mac: 如果 /usr/local/share/ 无权限，会自动使用 ~/.local/share/\r\n\r\n# 检查当前使用的路径\r\npython -c \"from src.system_config import get_system_kb_path; print('KB Path:', get_system_kb_path())\"\r\n```\r\n\r\n## 📊 性能指标\r\n\r\n- **处理速度**: ~100页/分钟 (PDF)\r\n- **搜索延迟**: <500ms (本地向量搜索)\r\n- **存储效率**: ~1MB/1000页文档\r\n- **支持规模**: 10万+文档块\r\n\r\n## 🌐 多Agent部署\r\n\r\n### 部署架构\r\n```\r\nAgent A (管理员)          Agent B (用户)           Agent C (用户)\r\n├── kb-manager           ├── kb-reader            ├── kb-reader  \r\n│   ├── 上传文档          │   ├── 查询知识库        │   ├── 查询知识库\r\n│   ├── 管理知识库        │   └── 浏览文档          │   └── 浏览文档\r\n│   └── 系统维护          └── 只读访问              └── 只读访问\r\n└── 系统级数据目录 ←──────────────┴─────────────────────┘\r\n    C:/ProgramData/kb-data/ (Windows)\r\n    /usr/local/share/kb-data/ (Linux/Mac)\r\n```\r\n\r\n### 部署步骤\r\n\r\n1. **管理员Agent设置**\r\n```bash\r\n# 在管理员Agent上安装kb-manager\r\ncd agent-admin/skills/\r\ngit clone <kb-manager-repo>\r\ncd kb-manager\r\npip install -r requirements.txt\r\n\r\n# 初始化系统环境\r\npython main.py setup\r\n\r\n# 上传初始文档\r\npython main.py upload company-docs.pdf\r\n```\r\n\r\n2. **用户Agent设置**\r\n```bash\r\n# 在用户Agent上安装kb-reader\r\ncd agent-user/skills/\r\ngit clone <kb-reader-repo>\r\ncd kb-reader\r\npip install -r requirements.txt\r\n\r\n# 测试连接\r\npython main.py stats\r\npython main.py query \"测试查询\"\r\n```\r\n\r\n### 权限管理\r\n- **kb-manager**: 完整权限，可创建、修改、删除\r\n- **kb-reader**: 只读权限，仅能查询和浏览\r\n- **系统目录**: 自动权限管理，确保数据安全\r\n\r\n## 🔒 安全特性\r\n\r\n- **本地存储**: 所有数据保存在本地，不上传云端\r\n- **API安全**: 支持多种API提供商，密钥加密存储\r\n- **访问控制**: 基于OpenClaw的用户权限管理\r\n- **数据隔离**: 每个技能实例独立的数据存储\r\n- **权限分离**: 管理和查询权限分离，防止误操作\r\n\r\n","tags":{"latest":"1.1.0"},"stats":{"comments":0,"downloads":312,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1778209052369,"updatedAt":1779076211323},"latestVersion":{"version":"1.1.0","createdAt":1778209052369,"changelog":"# Enterprise Knowledge Base Manager\n\nEnterprise-grade knowledge base management system that provides powerful document management and intelligent Q&A capabilities for AI Agents.\n\n## 🚀 Core Features\n\n- **Multi-format Document Support**: PDF, DOCX, TXT, Markdown\n- **Intelligent Document Chunking**: Configurable chunk size and overlap strategies\n- **Semantic Search**: High-precision search based on vector similarity\n- **RAG Q&A**: Intelligent Q&A combining retrieval and generation\n- **Local Storage**: ChromaDB local vector database, no cloud services required\n- **Multi-API Support**: DashScope, OpenAI and other embedding models\n\n## 💡 Use Cases\n\n- Enterprise internal document management\n- Customer service knowledge base construction\n- Technical documentation retrieval\n- Training material management\n- AI Agent knowledge enhancement\n\n## 🔧 Quick Start\n\n1. Set API key: `export DASHSCOPE_API_KEY='your-key'`\n2. Initialize system: `python main.py setup`\n3. Upload documents: `python main.py upload document.pdf`\n4. Intelligent Q&A: `python main.py query \"your question\"`\n\n## 🏗️ Technical Features\n\n- Local ChromaDB storage for secure and controllable data\n- System-level directory management supporting multi-application sharing\n- High-performance vector search with <500ms response time\n- Supports 100k+ document chunks scale\n- Cross-platform compatibility (Windows, Linux, macOS)\n- Environment variable based secure API key management","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"apanghu","userId":"s176x9xhy66hr127pqkkqwjykd86ae5c","displayName":"apanghu","image":"https://avatars.githubusercontent.com/u/45411273?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090759116}}