Agent Skills
返回列表
文案美化助手

文案美化助手

内容创作 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @yahuixun/jb-ai-publisher。

技能介绍

它解决的问题

把 Markdown、Word 或 PDF 素材变成可发布的排版文档,通常要在「导文件—开编辑器—手动改—再导出」之间反复切换。Agent 直接改 JSON 存储很容易绕过人为审校,格式一拍脑袋也难以复现。这个技能把 AI 运行时和浏览器编辑器拆开:Agent 负责 API 层面的导入、查询、渲染和导出,人保留在编辑器里做最终放行。

核心能力与工作方式

技能控制 jb-ai-publisher 的 HTTP API,并把浏览器编辑器作为人机交接点:

  • 导入阶段:通过 scripts/import_and_open.py 上传来源文件,返回 editorUrl,提示用户到浏览器完成可视化编辑。
  • 健康与能力检查:先用 GET /api/health 确认服务可用,再用 GET /agent/manifest 了解当前后端暴露的能力。
  • 继续编辑:拿到已知 document_id 后,通过 session API 建立上下文,之后按 Document API 做轻量调整。
  • 分页模式:导出前渲染预览。layout.mode 有三档,flow 走 Paged.js 长文排页,manual 走 Craft.js 自由页面构图,hybrid 是手工页面加正文流式。
  • 升级检查:调用 POST /agent/upgrade/check 时先读管理端 Skill 升级配置,再回退到 JB_AI_PUBLISHER_SKILL_MANIFEST_URL,只检查远程元数据,不下载也不执行升级代码。

适用边界与注意点

  • 本地开发默认后端为 http://127.0.0.1:8000,前端为 http://localhost:3000;公开部署默认后端是 https://jbai-publisher.tgview.pp.ua。需要时通过 JB_AI_PUBLISHER_BASE_URL 指定目标服务。
  • 导入流程按来源类型分流:PDF 与图片按 2 MB 分块上传并跑 Smart Import;Word(.docx)、Markdown 和纯文本会立刻创建可编辑文档;旧版 .doc 等不支持格式必须在上传前拒绝。
  • 持久化由后端统一管理,storage/documents/*.json 不适合直接手改。只有在 API 不可用且用户明确同意时,才能做文件级恢复。
  • 编辑器是人工批准边界。Agent 做了材料级修改后,不要在未获预览确认前直接导出最终出版物。
  • 认证默认走 OAuth Authorization Code + S256 PKCE,凭证存到系统凭据库,令牌过期前自动刷新;无法使用 MCP 时才退化为兼容 API Token。详细接口约定见 references/api.md。

使用场景

  • 已有 Word 文档需要导入并立即编辑,可通过 API 创建文档后跳转浏览器。
  • 想让 Agent 安全续编已有文档,通过 session API 接管并修改内容。
  • 需要将 PDF 或图片分块上传触发 Smart Import,再由人工在编辑器审批。
  • 准备导出 PDF 前,先渲染分页预览确认排版无误,再执行最终发布。

适合人员

  • 开发 Agentic 工作流的工程师,需要将文档处理与人工审批结合。
  • 维护企业知识库的技术运营,负责处理批量文档导入与格式校验。
  • 构建内部发布平台的开发者,需要集成安全的 API 认证与自动化导出流程。