Jimeng Skills

核心用法

jimeng-skills 是一个面向企业即时通讯场景（飞书、企微、钉钉）的 AI 多媒体生成工具封装。它通过调用火山引擎即梦（Jimeng）AI 服务，将用户的文本描述转化为图片或视频内容，并以多种格式输出结果，确保在企业 IM 环境中可查看、可分享。

调用方式：

• 图片生成：npx ts-node scripts/openclaw-jimeng.ts image "描述文本"
• 视频生成：npx ts-node scripts/openclaw-jimeng.ts video "描述文本" --wait

输出结构：

• text：纯文本摘要，使用简单换行和编号，兼容所有企业 IM
• remoteUrls：火山引擎返回的原始远程地址
• publicUrls：可选的公开分享链接（需配置 JIMENG_PUBLIC_BASE_URL）
• localFiles：本地文件路径，便于调试和二次处理
• status：任务状态标识（pending 时支持重试）

显著优点

1. 企业 IM 原生适配：优先返回纯文本而非富文本卡片，避免平台协议差异导致的显示问题，确保飞书、企微、钉钉全兼容
2. 多维度输出策略：同时提供远程直链、本地路径和可选的公开 URL，满足不同场景需求（即时预览、下载归档、跨设备分享）
3. 灵活的配置体系：支持临时凭证（VOLCENGINE_TOKEN）和永久凭证（VOLCENGINE_SK）双模式，适应企业安全策略
4. 可扩展的分享能力：通过 JIMENG_PUBLIC_BASE_URL 环境变量，可将本地输出映射到自定义静态文件服务，实现企业内部直接访问

潜在缺点与局限性

1. 依赖外部服务：核心能力完全依赖火山引擎即梦 AI 的可用性和响应速度，存在单点故障风险
2. 凭证管理复杂度：需手动配置 VOLCENGINE_AK 及 VOLCENGINE_SK/VOLCENGINE_TOKEN，在多人协作环境中密钥分发和轮换成本较高
3. 公开分享需额外基础设施：JIMENG_PUBLIC_BASE_URL 功能要求用户自行部署和维护静态文件服务，增加了使用门槛
4. 无内置重试机制：文档未提及失败自动重试，需用户根据 pending 状态手动处理
5. 输出格式受限：明确避免 Markdown 表格，复杂信息展示能力有限

适合人群

• 需要在内网环境或企业 IM 中快速生成和分享 AI 图片/视频的团队成员
• 已将火山引擎作为主力云服务商的企业开发者
• 有运维能力维护静态文件服务、追求可定制分享链路的中小技术团队
• 对平台兼容性要求极高、不希望处理富文本卡片协议差异的集成开发者

常规风险

1. 密钥泄露风险：VOLCENGINE_AK/SK 以环境变量形式配置，若日志打印或误提交至代码仓库，可能导致云服务资源被滥用
2. 内容合规风险：AI 生成内容的版权归属和合规性由火山引擎即梦服务决定，企业需自行建立内容审核机制
3. 公开链接安全隐患：通过 JIMENG_PUBLIC_BASE_URL 生成的分享 URL 若未配合访问控制，可能导致内部生成内容外泄
4. 成本不可控：即梦 AI 按调用量计费，高频场景缺乏内置配额限制或告警机制
5. 本地路径信任问题：localFiles 返回绝对路径，跨系统或容器化部署时可能因路径映射问题导致调试困难