乐享文档同步助手
将以下提示词粘贴到你的 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;再用 PythonPUT写本地文件,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 开发者需要一个端到端的脚本,串联上传、标签、索引和搜索验证