核心能力概述
RAGFlow Skill 是面向 RAGFlow v0.25.6 的完整运维工具集，通过捆绑的 Node.js CLI 封装底层 REST API，实现从数据摄入到生产部署的全链路管理。
核心用法
知识库生命周期管理：create-dataset 创建知识库并指定分块策略（naive/manual/qa等），upload-documents 支持批量上传与原始文件名保留，start-parsing/wait-parsing 显式控制解析流程，区别于自动解析的竞品设计，给予精细调参空间。retrieve 支持多数据集联合检索，配合 --json 输出便于管道化加工。
对话系统：create-chat 绑定 LLM 与知识库，create-session 建立隔离会话上下文，chat-session 调用 v0.25.6 新路由 /api/v1/chat/completions。v0.25.6 默认仅追加最新消息，需 --pass-all-history 替换完整历史。内置流式/非流式切换（--stream false 获取完整 JSON）。
Agent 编排：支持完整 DSL 定义的 Agent（create-agent --dsl），包含组件、变量、检索、图结构等复杂配置。agent-chat 调用独立路由 /api/v1/agents/chat/completions，Iteration 代理支持列表循环（items_ref 指向结构化输出）。update-agent-tags 管理标签分类。
生产集成：embed-code 生成 iframe/全屏/组件嵌入代码，embed-chat/embed-agent-chat 自动处理 beta token 与会话启动。系统 token 与 auth 参数按敏感信息处理，默认脱敏展示。
显著优点
1. API 覆盖完整：v0.25.6 全部端点（数据集、文档、分块、检索、对话、Agent、Connector、RAPTOR、系统设置）均有 CLI 映射
2. 工程化设计：强制分离上传-解析步骤、支持分块删除重试（RAGFLOW_DELETE_CHUNK_RETRIES）、可配置超时与诊断脚本
3. 安全实践内置：HTTPS 生产强制、最小权限 API Key 建议、敏感输出脱敏规则、.env 隔离配置
4. 版本对齐严谨：参考文档（AGENT_GUIDE.md/COMMANDS.md/API.md/TROUBLESHOOTING.md）与 v0.25.6 路由形状精确匹配
局限与风险
- 版本锁定严格：仅保证 v0.25.6 兼容，RAGFlow 快速迭代可能导致后续版本适配滞后
- Node 运行时依赖：需本地 Node.js 环境，非纯 Shell 方案增加部署复杂度
- 分块删除偶现延迟：文档存储刷新 lag 可能导致删除校验失败，需自动重试机制兜底
- Agent DSL 门槛：复杂代理需手写 JSON DSL，调试周期较长，需参考 AGENT_GUIDE.md
- 嵌入式安全：
betatoken 与auth=参数属运维密钥，误泄可导致未授权访问
适合人群
企业 MLOps 工程师、RAG 系统架构师、需自建知识库问答平台的开发团队，以及需要将 RAGFlow 集成至现有工作流（CI/CD、数据管道）的技术组织。
常规风险提示
- 删除操作不可逆，CLI 未内置交互确认，脚本化执行前需人工复核
- 生产环境必须配置 HTTPS，明文传输 API Key 存在截获风险
- 嵌入代码含敏感凭证，分享演示链接时应剥离
auth参数或使用短期 token