omm-push

omm-push — 云端推送工作流

目的

自动完成将 .omm/ 架构文档推送到 oh-my-mermaid 云服务的完整工作流。

前置条件

确保 omm CLI 可用：

command -v omm || npm install -g oh-my-mermaid

如果安装命令失败（权限被拒绝），请告知用户： "请在终端中运行 npm install -g oh-my-mermaid，然后重试。"

工作流

步骤 1：检查登录状态

通过 Bash 运行 omm share。如果报错提示 "not logged in"：

• 告知用户："你需要先登录。"
• 运行 omm login — 这会打开浏览器进行 GitHub OAuth
• 等待用户完成登录

步骤 2：检查项目关联

通过 Bash 运行 omm share。如果报错提示 "no project slug"：

• 运行 omm link — 这会根据目录名称设置云端项目 slug
• 确认："已关联到 {slug}"

步骤 3：推送

通过 Bash 运行 omm push。

处理错误：

• 401 Unauthorized："登录已过期。请重新运行 omm login。"
• 403 Free plan limit："免费计划仅允许 1 个项目。请在 https://ohmymermaid.com/pricing 升级"
• Network error："无法连接到服务器。请检查网络连接。"

步骤 4：报告

成功后，输出：

• 上传的文件数量
• 查看 URL：https://ohmymermaid.com/p/{slug}
• 分享 URL（如果是 Pro）："运行 omm share 获取可分享链接"

规则

• 推送前务必检查登录状态
• 推送前务必检查项目关联
• 不要跳过步骤 — 每一步都依赖前一步
• 如果任何步骤失败，请停止并提供错误及解决指引