乐享文档写入
基础知识:数据模型、URL 规则、写入安全规则完整版见
base/SKILL.md。 前置条件:本 skill 需要已配置乐享 MCP 连接。如未配置,请先读取setup/SKILL.md。 遇到 401 错误:不要重试,读取setup/SKILL.md引导用户续期(点击续期按钮即可恢复,无需重新配置)。 安全规则(完整版见base/SKILL.md):禁止遍历猜测写入目标;必须有明确 URL/ID/确认,或whoami返回个人知识库时可直接写入个人知识库
工具概览
📚 知识库管理
entry_create_entry— 创建文档/文件夹entry_import_content— 导入 Markdown/HTML 创建新文档(⚠️ 仅新建)entry_import_content_to_entry— 导入内容到已有页面(支持覆盖/追加)entry_rename_entry— 重命名条目
👤 用户与身份
whoami— 获取当前用户信息(包括用户姓名、企业信息、个人知识库等)
🔗 外部内容导入
file_create_hyperlink— 导入公众号文章等外部链接
常见操作流程
⚠️ 前置检查:确认产品版本
每次执行写入操作前,先调用 whoami() 检查 sub_server_type:
v2→ 继续使用本 skillv1→ 停止,提示用户加载lexiang-v1-docsskill(本 skill 不适用于 v1)v1v2→ 如果用户明确说了「乐享社区」→ 提示切换lexiang-v1-docs;否则继续使用本 skill
从知识库链接写入文档
⚠️ 仅在用户主动提供了知识库链接时执行。
核心步骤:提取 space_id → space_describe_space 获取 root_entry_id → entry_import_content 写入 → 按「结果链接生成」规则拼接访问链接返回给用户。
{domain}为whoami()返回的company.company_domain。
未指定知识库时写入个人知识库
当用户要求保存内容到知识库或个人知识库,但未指定具体目标知识库时:
- 调用
whoami()获取当前用户信息 - 检查返回结果中是否包含个人知识库信息(如
personal_space_id等字段) - 如果存在个人知识库:
- 使用
space_describe_space获取个人知识库的root_entry_id - 使用
entry_import_content写入内容(space_id和parent_id同时传) - 写入完成后拼接访问链接返回给用户:
{domain}=whoami()返回的company.company_domain- 若
{domain}为顶级域名(如lexiangla.com),则追加?company_from=<whoami返回的company.code> - 示例:
https://lexiangla.com/pages/{entry_id}?company_from=csig
- 使用
- 如果
whoami返回中不包含个人知识库信息:- 回退到标准写入安全规则,要求用户提供具体的写入目标(URL / ID / 名称)
注意:此规则仅适用于用户明确表达"保存到知识库""保存到个人知识库""存到我的知识库"等意图且未指定具体目标的场景。如果用户指定了具体知识库,仍以用户指定的为准。
微信公众号导入
当用户提供 mp.weixin.qq.com 链接且意图是"导入/收藏/保存到乐享"时,使用 file_create_hyperlink。
如果用户只是想阅读或总结内容,不要默认导入。
🔗 结果链接生成
写入操作成功后,按以下步骤拼接访问链接:
{domain}=whoami()返回的company.company_domain- 判断
{domain}是否为顶级域名(不含三级前缀,如lexiangla.com):- 是:追加
?company_from={company_from}{company_from}优先取 mcp.jsonurl中的company_from参数- 若 mcp.json 中无此参数,取
whoami()返回的company.code
- 否(如
csig.lexiangla.com):直接使用{domain}/pages/{entry_id},不追加参数
- 是:追加
- 最终链接:
{domain}/pages/{entry_id}或{domain}/pages/{entry_id}?company_from=xxx
禁止使用 MCP 端点域名拼接用户访问链接。
⚠️ 核心注意事项
entry_import_content的parent_id通常用root_entry_id(通过space_describe_space获取)space_id和parent_id要同时传- 支持的
content_type:markdown、html - 参数不确定时以
get_tool_schema(tool_name="xxx")返回为准
参考文档
| 文档 | 说明 |
|---|---|
references/markdown-import.md |
Markdown 导入详解 |
references/doc-templates.md |
文档类型与大纲模板(推广/技术/操作指南) |
references/common-errors.md |
常见错误排查 |
base/SKILL.md |
数据模型、写入安全规则完整版 |