核心用法
auteng-docs-curl-publish 是一个基于 curl 的轻量级 Markdown 发布工具，面向开发者和技术写作者设计。核心功能是将本地或生成的 Markdown 内容通过 HTTP POST 请求提交至 https://auteng.ai/api/tools/docs/publish-markdown/，即时获取带渲染效果的共享链接。
请求参数：
| 字段 | 类型 | 必填 | 说明 |
|:---|:---|:---|:---|
| `markdown` | string | ✓ | Markdown 原文，支持 Mermaid 图表（组件图、流程图、时序图）、KaTex 数学公式、代码块等 |
| `title` | string | ✗ | 文档标题 |
| `expires_hours` | number | ✗ | 链接有效期（小时），默认由服务端控制 |
三种典型用法：
1. 基础发布 — 直接嵌入多行 JSON 的 heredoc 方式，适合交互式终端
2. 纯 URL 提取 — 配合 jq -r '.share_url' 实现静默式链接获取，便于脚本集成
3. 结构化输出 — 使用 jq 提取 {title, share_url, expires_at} 三元组，便于日志记录
错误处理机制明确：任何不含 share_url 的响应均视为失败，需完整展示 JSON 体以辅助调试。
显著优点
- 零依赖发布：仅需 curl + jq，无需安装客户端或配置复杂环境
- 富文本原生支持：服务端自动渲染 Mermaid、KaTex，解决 Markdown 图表与公式的分享痛点
- 命令行友好：标准输入重定向与管道设计，完美融入 Unix 工具链和 CI/CD 流水线
- 灵活过期控制：可设置链接有效期，兼顾便利性与数据安全
- 即时可访问：返回 HTTPS 短链，跨平台、跨设备秒级分享
潜在缺点与局限性
- 网络依赖：必须能访问
auteng.ai域名，内网或离线环境不可用 - 无版本管理：服务端不保留历史版本，覆盖发布需重新生成链接
- 隐私不可控：内容上传至第三方服务器，敏感文档存在泄露风险
- 自定义受限：主题样式、域名绑定等企业级需求无法满足
- API 稳定性未知：文档未标注 SLA，存在服务变更或下线可能
适合人群
- 技术博主、开发者文档撰写者：快速分享含图表的技术方案
- DevOps/运维工程师：在 CI 日志中生成可点击的部署报告链接
- 教育从业者：分发含数学公式与流程图的教学材料
- 需要临时、轻量、免部署 Markdown 托管的任何场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|:---|:---|:---|
| **数据泄露** | 内容明文传输并存储于第三方 | 避免上传含密钥、PII 的文档；启用 HTTPS 验证证书 |
| **链接失效** | 过期或服务商策略变更导致无法访问 | 关键内容本地备份；设置合理过期时间 |
| **注入风险** | Markdown 支持 HTML，可能存在 XSS payload | 仅发布可信来源内容；服务端应已做净化处理 |
| **依赖单点故障** | 服务不可用则功能完全瘫痪 | 关键流程准备 fallback 方案 |