Agent Skills
返回列表
战云知识库

战云知识库

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e40cf8bf/xzy。

技能介绍

解决什么问题

工程师维护知识库时,常见痛点包括:上传不同类型内容(文件、网页、笔记)需切换流程,批量上传易出现重名冲突;仅知知识库名称却不知ID,文件夹层级跳转繁琐;查看或导出原文时,网页与文件的请求方式不统一。

如何工作

写入类工作流

  • 文件上传安全门:仅针对上传文件到知识库的流程,包含重名检查(check_repeated_names,支持最多2000个文件名)、创建媒体、COS上传(需传入实际MIME类型)、添加知识四步,批量上传时可一次性检查所有文件名。
  • 网页/URL导入:通过import_urls添加1-10个网页或微信文章;若URL指向PDF/Word等文件,会先检测文件类型,流程转为先下载再走文件上传逻辑,文件名优先级为Content-Disposition header → URL path → last URL segment + Content-Type extension。
  • 笔记添加:调用add_knowledge,设置media_type=11并传入note_info.content_id。
  • 未指定知识库时:用get_addable_knowledge_base_list列出有权限的知识库,禁止猜测,需让用户选择。

文件夹与查询操作

  • 文件夹以folder_前缀标识,操作根目录时省略folder_id,get_knowledge_list的current_path字段可作为面包屑导航。
  • 查询流程无安全门:搜索内容用search_knowledge(含文件和文件夹);按名称搜索知识库用search_knowledge_base,空query返回所有知识库;浏览内容用get_knowledge_list,游标分页且limit范围1~50。
  • 获取原文:通过get_media_info获取链接,网页类直接请求,笔记类需传入notebook_id调用get_doc_content;下载时在URL追加response-content-type和response-content-disposition参数指定文件名。

注意事项

  • 隐藏内部ID:面向用户展示时,永远不暴露knowledge_base_id、media_id,用知识库名称或文件标题替代。
  • 分页逻辑:所有列表/搜索接口用游标分页,首次cursor:"",根据is_end判断停止,next_cursor翻页。
  • 响应处理:统一结构{code:0,msg:"...",data:{...}},code≠0时直接展示msg。
  • 媒体类型限制:文件扩展名需准确用于media_type检测,COS上传时--content-type传实际MIME类型而非application/octet-stream。

使用场景

  • 产品经理需要把调研报告 PDF 上传到产品文档库的指定文件夹,并重名检查避免覆盖现有文件。
  • 内容运营想在资料库中检索某关键词对应的历史文档和文件夹,快速定位并导出原文。
  • 技术支持需要把刚刚整理的一篇微信排障文章链接添加到知识库根目录,作为团队参考资料。

适合人员

  • 知识库管理员,需要批量上传规章制度到指定文件夹并保持整体结构统一。
  • 研发工程师,想把官方文档链接和排障笔记归档到内部知识库中随时检索。
  • 资料整理员,每天要把多份行业报告汇总进知识库并按目录分类管理。