Nishare 快速分享

这个技能解决什么问题

当你用 AI Agent 生成了一段页面、文档或图片，接下来往往是把它发到某个地方：贴进聊天窗口太长，传到网盘又没法直接预览。Nishare 快速分享面向的正是这个环节：Agent 通过 HTTP API 把生成内容发布出去，拿到一个可以分享的 shareUrl，不需要用户手动保存、复制或上传。

它如何工作

技能的核心是一组 Nishare 接口调用约定，按固定顺序组装即可：

• 选择 Base URL：生产环境用 https://nishare.com，本地联调用 http://localhost:4173。
• 选择端点：新建分享走 POST /api/ai/publish，更新已有项目走 POST /api/ai/update。
• 选择内容类型：支持整份 HTML 文档、Markdown 纯文本，以及图片（imageDataUrl、imageBase64 或 imageUrl）。
• 按需鉴权：只有发布到指定账号或工作区、或执行更新时，才需要带 X-Nishare-Key 或 Authorization: Bearer nsk_xxx。
• 返回结果：成功后把 shareUrl 交给用户；失败时回显错误信息与匹配项。

SKILL.md 里还提供了可直接复制的 Agent 提示词，以及发布 HTML、带密钥发布、更新项目等示例。需要更完整的信息时，可以查阅 references/api.md，其中覆盖了请求字段、请求头、响应结构、校验限制与常见错误。

适用边界与注意点

• 这套流程只负责“发布”这一步，不涉及内容的渲染优化或分发渠道管理。
• 未指定账号的发布可以不带密钥，但一旦需要归属到某个工作区，鉴权信息就必须配置正确。
• 请求体字段、类型与校验规则以 references/api.md 为准，动手前建议先对照一遍。
• 更新操作要求已有项目 ID，不适合只适合新建的场景。