文案美化助手
将以下提示词粘贴到你的 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 认证与自动化导出流程。