lexiang-writer

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 → 继续使用本 skill
• v1 → 停止，提示用户加载 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。

未指定知识库时写入个人知识库

当用户要求保存内容到知识库或个人知识库，但未指定具体目标知识库时：

1. 调用 whoami() 获取当前用户信息
2. 检查返回结果中是否包含个人知识库信息（如 personal_space_id 等字段）
3. 如果存在个人知识库：
   • 使用 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
4. 如果 whoami 返回中不包含个人知识库信息：
   • 回退到标准写入安全规则，要求用户提供具体的写入目标（URL / ID / 名称）

注意：此规则仅适用于用户明确表达"保存到知识库""保存到个人知识库""存到我的知识库"等意图且未指定具体目标的场景。如果用户指定了具体知识库，仍以用户指定的为准。

微信公众号导入

当用户提供 mp.weixin.qq.com 链接且意图是"导入/收藏/保存到乐享"时，使用 file_create_hyperlink。

如果用户只是想阅读或总结内容，不要默认导入。

---

🔗 结果链接生成

写入操作成功后，按以下步骤拼接访问链接：

1. {domain} = whoami() 返回的 company.company_domain
2. 判断 {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}，不追加参数
3. 最终链接：{domain}/pages/{entry_id} 或 {domain}/pages/{entry_id}?company_from=xxx

禁止使用 MCP 端点域名拼接用户访问链接。

---

⚠️ 核心注意事项

1. entry_import_content 的 parent_id 通常用 root_entry_id（通过 space_describe_space 获取）
2. space_id 和 parent_id 要同时传
3. 支持的 content_type：markdown、html
4. 参数不确定时以 get_tool_schema(tool_name="xxx") 返回为准

---

参考文档

文档	说明
references/markdown-import.md	Markdown 导入详解
references/doc-templates.md	文档类型与大纲模板（推广/技术/操作指南）
references/common-errors.md	常见错误排查
base/SKILL.md	数据模型、写入安全规则完整版