技术路线

技术路线区分“已交付能力”和“计划方向”。计划内容不构成稳定协议承诺。

已完成：应用与协议边界

• pnpm monorepo 与独立应用包。
• API、Resource Service、Image Worker、Video Worker、Docs 独立镜像。
• Resource v1、Worker v1/v2 OpenAPI 契约。
• 配置校验、结构化日志、健康检查和容器私有网络。

已完成：图片处理主链路

• JPEG、PNG、WebP 上传和内容校验。
• 图片/文字混合图层及稳定的 zIndex 排序。
• 定位、缩放、旋转、阴影、透明度和平铺。
• 固定预览流、latest-wins 取消和批量原子发布。
• 直接最终渲染、ZIP 流式交付和源资源消费。
• 并发限制、超时、调用方中断与请求级文件清理。

当前：生产部署稳定化

• 完善公开文档与 Nginx 文档容器。
• 简化生产 Compose 启动方式，避免遗漏 Image Worker。
• 固化日志目录初始化、容量配置和故障排查流程。
• 增加可观测性、资源压力验证和部署验收清单。
• 收敛旧 Worker v1 兼容入口的弃用策略。

下一阶段：视频处理

• 使用 FFprobe 校验媒体与读取元数据。
• 生成视频封面和短预览。
• 使用 FFmpeg 输出 fragmented MP4。
• 增加视频并发、超时、取消、stderr 上限与临时文件清理。
• 扩展 Resource Service 的媒体类型与资源约束。

后续方向

• 内部服务身份认证与传输加密。
• Prometheus 指标或等价观测接口。
• 多 API/Resource Service 实例的状态共享或粘性路由方案。
• 对象存储与长期资产管理；这与当前临时资源模型是不同产品能力，需要独立设计。

当前阶段

Markify 目前是“图片能力完整、视频能力未实现”的内部服务。Video Worker 镜像存在并不表示视频 API 已开放。