Agent Skills
返回列表
乐享文档同步助手

乐享文档同步助手

知识管理 更新于 2026.08.29

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

安装文档同步知识库技能:请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8ee7bfb9/lexiangv1。

技能介绍

它解决的具体问题

当团队把一批本地 .docx 操作文档手工搬进腾讯乐享知识库时,常见痛点是:截图和格式在多次转存中丢失;文档分散在不同文件夹,检索靠记忆;已有文档改版后找不到对应条目,只能重新上传一份,最终同一主题出现多个副本;命名里的多空格和尾部空格让上传脚本突然 exit 26。这个技能把「上传到乐享并保持可检索」变成一条可重复执行的流水线,而不是一次性手工搬运。

核心能力与关键步骤

技能把 plan.json 当作唯一数据源,保存每篇文档的 entry_id、size 和 done;导入映射表.md 只给人看,负责说明命名、标签和归类。同步前必须先确认乐享 MCP(lexiang connector)已连接,并准备好 space_id 与六个模块文件夹的 entry_id。整体顺序不能乱:

  • Step 0 校验状态:读 plan.json,用 entry_list_children 核对六个文件夹内的 entry_id,不一致时以乐享实际返回为准回写。
  • Step 1 识别变更:用 Python glob 读取源目录真实文件名,避免多空格/尾部空格;再比较 size/mtime,分别走新增、更新或跳过。
  • Step 2 新增上传:每批不超过 8 篇,先并行 file_apply_upload 申请预签名 URL;再用 Python PUT 写本地文件,Content-Type 必须是 OOXML;最后并行 file_commit_upload 拿 entry_id,并用 knowledge_tag_set_entry_tags 打模块/平台/角色多维标签。
  • Step 3 增量更新:对已有文档,entry_describe_entry 的 target_id 就是 file_id;file_apply_upload 必须带 file_id,parent_entry_id 要填该 entry 自己,乐盛会追加新版本而不变 entry_id,所以索引页链接无需改。
  • Step 4 刷新导航索引页:用 entry_import_content(markdown)重写文件夹内的索引页,文件/文件夹/页面链接统一走 lexiangla.com,并统一使用一个 company_from;这里的正确值是 5c91b7b071db11f1b8814ab2ae8917c1。
  • Step 5 检索验证:用 search_kb_search 跑 2–4 个关键词,确认命中和置顶,而不是把「能上传」当成同步完成。

适用边界与必记的坑

它只解决「Word 操作文档进乐享知识库」的问题,不覆盖 Excel、PPT、PDF,也不会替你建新知识库:MCP 只提供已有空间下的入库能力,必须先确认目标空间和六类文件夹的 entry_id。几个真实坑值得单独强调:申请到预签名 URL 后应在 1 小时内 PUT,大文件也一样;不要在 bash 里用 curl --data-binary "@/多空格/中文.docx",Python urllib 读绝对路径更稳;apply → PUT → commit → tag 的铁律不能破,commit 前没有 entry_id;大文件 processing 只是服务端预览图生成,不是失败;.doc 老格式必须用 application/msword,不能套 OOXML;重复文档上传不会自动清理旧位置副本,乐享未暴露 entry 级删除工具时需要人工确认。最后,company_from 对 file 文档严格校验,填错会反复跳登录,不要凭 entry_describe_entry 返回值臆测。

使用场景

  • 新学期前要把一批 .docx 操作手册原样导入腾讯乐享知识库,保留全部截图与格式
  • 已有乐享文档修改后,按 plan.json 中的 entry_id 做增量更新,不重复建副本
  • 某模块文件夹内容增删后,重写该目录下的 Markdown 导航索引页,让新文档直达

适合人员

  • 学校教务老师需要把阅卷、成绩复核等 Word 流程文档统一归档到乐享知识库
  • 知识库管理员需要定期上传新版本文档并在原条目上做增量同步
  • MCP 开发者需要一个端到端的脚本,串联上传、标签、索引和搜索验证