| name | lexiang-writer |
| description | 乐享知识库文档创建与写入。当用户提到「乐享」「知识库」「lexiang」并包含创建/写入/新建/导入意图时使用。典型触发：「写到乐享」「创建一个文档」「帮我新建一个页面」「把这段内容发到乐享」「保存到知识库」「导入到乐享」「帮我在 XX 知识库下建个文档」「把这篇文章存到乐享」。也适用于用户提供 lexiangla.com 链接并要求写入新内容、导入公众号文章到知识库的场景。支持 Markdown/HTML 导入创建文档、创建页面与文件夹、外部链接导入。注意：上传 PDF/Word/图片等文件请使用 files/SKILL.md。 |
乐享文档写入
基础知识：数据模型、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-docs skill（本 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.json url 中的 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 | 数据模型、写入安全规则完整版 |
