@optima-chat/optima-agent 0.4.25 → 0.4.27

package/.claude/settings.local.json

@@ -69,7 +69,8 @@
       "Bash(commerce homepage create-collections:*)",
       "Bash(commerce homepage create-featured:*)",
       "Bash(commerce homepage create-collection-products:*)",
-      "Bash(commerce homepage create-banner:*)"
+      "Bash(commerce homepage create-banner:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/ffmpeg/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: ffmpeg
+description: "Audio and video processing for e-commerce. Use when user needs to: merge audio with video (视频配音/添加背景音乐/音视频合成), compress videos (压缩视频/视频压缩), generate thumbnails (生成缩略图/视频封面), concatenate videos (视频拼接/合并视频), trim videos (视频裁切/截取片段/剪辑视频), convert formats (格式转换/转换视频)."
+---
+
+# FFmpeg 音视频处理
+
+## 电商场景常用任务
+
+### 1. 音视频合成（产品视频配音/背景音乐）
+
+```bash
+# 视频配背景音乐（音频较短时循环）
+ffmpeg -i video.mp4 -stream_loop -1 -i audio.mp3 -shortest -c:v copy -c:a aac output.mp4
+
+# 视频配音频（音频较长时截断）
+ffmpeg -i video.mp4 -i audio.mp3 -shortest -c:v copy -c:a aac output.mp4
+
+# 替换视频原有音频
+ffmpeg -i video.mp4 -i new_audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
+```
+
+**参数说明**：
+- `-stream_loop -1` - 无限循环音频（直到视频结束）
+- `-shortest` - 以最短的流为准（视频或音频）
+- `-map 0:v:0 -map 1:a:0` - 手动选择第1个文件的视频+第2个文件的音频
+
+### 2. 视频压缩（上传优化，保证展示质量）
+
+```bash
+# 产品视频压缩（推荐：CRF 20，高质量）
+ffmpeg -i product.mp4 -c:v libx264 -crf 20 -c:a aac output.mp4
+
+# 标准压缩（CRF 23，平衡质量和大小）
+ffmpeg -i video.mp4 -crf 23 output.mp4
+```
+
+**电商场景 CRF 建议**：
+- **18-20** - 产品主图视频（质量优先）
+- **23** - 一般营销视频（平衡）
+- **25-28** - 内部使用视频（文件大小优先）
+
+### 3. 生成视频缩略图（产品封面）
+
+```bash
+# 从5秒处生成缩略图
+ffmpeg -i product_video.mp4 -ss 00:00:05 -frames:v 1 thumbnail.jpg
+
+# 批量生成所有产品视频的缩略图
+for video in *.mp4; do
+  ffmpeg -i "$video" -ss 00:00:05 -frames:v 1 "${video%.mp4}_thumb.jpg"
+done
+```
+
+### 4. 视频拼接（多个片段合并）
+
+```bash
+# 创建拼接列表文件
+cat > concat_list.txt << 'EOF'
+file 'video1.mp4'
+file 'video2.mp4'
+file 'video3.mp4'
+EOF
+
+# 拼接视频（所有视频参数相同时，快速无损）
+ffmpeg -f concat -safe 0 -i concat_list.txt -c copy output.mp4
+
+# 拼接视频（参数不同时，重新编码）
+ffmpeg -f concat -safe 0 -i concat_list.txt -c:v libx264 -crf 20 -c:a aac output.mp4
+```
+
+**参数说明**：
+- `-f concat` - 使用 concat 分离器
+- `-safe 0` - 允许不安全的文件路径（本地文件需要）
+- `-c copy` - 无损拼接（仅当所有视频格式完全相同）
+
+### 5. 视频裁切（截取指定片段）
+
+```bash
+# 从第10秒开始，截取30秒
+ffmpeg -i video.mp4 -ss 00:00:10 -t 30 -c copy output.mp4
+
+# 从第10秒到第40秒
+ffmpeg -i video.mp4 -ss 00:00:10 -to 00:00:40 -c copy output.mp4
+
+# 去掉前5秒（从第5秒到结尾）
+ffmpeg -i video.mp4 -ss 00:00:05 -c copy output.mp4
+```
+
+**参数说明**：
+- `-ss HH:MM:SS` - 开始时间
+- `-t <秒数>` - 持续时长
+- `-to HH:MM:SS` - 结束时间
+- `-c copy` - 无损裁切（快速）
+
+### 6. 格式转换（确保兼容性）
+
+```bash
+# 快速转换（只改容器，不重新编码）
+ffmpeg -i video.mov -c copy video.mp4
+
+# 标准转换（重新编码）
+ffmpeg -i video.mov -c:v libx264 -c:a aac video.mp4
+```
+
+## 电商工作流程
+
+### 场景1：产品视频配背景音乐
+
+```bash
+# 1. 检查文件
+ls -lh product_video.mp4 background_music.mp3
+
+# 2. 合成（音乐循环播放）
+ffmpeg -i product_video.mp4 -stream_loop -1 -i background_music.mp3 \
+  -shortest -c:v copy -c:a aac -b:a 192k final_video.mp4
+
+# 3. 检查输出
+ls -lh final_video.mp4
+
+# 4. 告知用户：文件大小、是否需要压缩
+```
+
+### 场景2：压缩产品视频后生成缩略图
+
+```bash
+# 1. 压缩视频（保证产品展示质量）
+ffmpeg -i raw_product.mp4 -c:v libx264 -crf 20 -c:a aac product.mp4
+
+# 2. 生成缩略图
+ffmpeg -i product.mp4 -ss 00:00:05 -frames:v 1 product_thumb.jpg
+
+# 3. 告知用户文件大小变化
+ls -lh raw_product.mp4 product.mp4
+```
+
+### 场景3：批量处理多个产品视频
+
+```bash
+# 批量压缩并生成缩略图
+for video in product_*.mp4; do
+  # 压缩
+  ffmpeg -i "$video" -c:v libx264 -crf 20 -c:a aac "compressed_${video}"
+
+  # 生成缩略图
+  ffmpeg -i "compressed_${video}" -ss 00:00:05 -frames:v 1 "${video%.mp4}_thumb.jpg"
+done
+```
+
+## 重要提示
+
+### 电商场景特殊要求
+
+- 🎨 **质量优先** - 产品视频使用 CRF 18-20，不要过度压缩
+- 📏 **文件大小监控** - 始终告知用户处理前后的文件大小变化
+- 🖼️ **缩略图质量** - 选择展示效果好的时间点（通常5秒处）
+- 🎵 **音频音量** - 合成时注意背景音乐不要盖过产品解说
+
+### 常用参数
+
+- `-c:v copy` - 视频流无损复制（音视频合成时推荐，保持原质量）
+- `-shortest` - 以最短流为准（音视频合成必备）
+- `-stream_loop -1` - 循环音频（背景音乐常用）
+- `-crf 20` - 产品视频推荐质量

package/.claude/skills/markdown-pdf/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: markdown-pdf
+description: "Markdown to PDF conversion. Use when user needs to: export documents (导出成PDF/生成PDF/转换成PDF), create reports (保存为PDF), save as PDF (Export to PDF)."
+---
+
+# Markdown → PDF 转换
+
+## 标准命令格式
+
+```bash
+md-to-pdf <input.md> \
+  --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage"]}' \
+  --pdf-options '{"format":"A4","margin":"20mm","printBackground":true}'
+```
+
+**关键点**：
+- 输出文件默认生成为 `<input>.pdf`（与输入同名，在同一目录）
+- 支持 glob 模式批量处理：`md-to-pdf ./**/*.md`
+- `--launch-options` 中的参数**必须包含**（Docker 容器要求）
+
+## 常见场景
+
+### 单个文档转换
+
+```bash
+md-to-pdf report.md \
+  --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage"]}' \
+  --pdf-options '{"format":"A4","margin":"20mm","printBackground":true}'
+
+# 输出：report.pdf（同目录）
+```
+
+### 指定输出路径（使用 stdin/stdout）
+
+```bash
+cat document.md | md-to-pdf \
+  --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage"]}' \
+  --pdf-options '{"format":"A4","margin":"20mm","printBackground":true}' \
+  > /home/aiuser/project/final.pdf
+```
+
+### 批量转换（使用 glob）
+
+```bash
+# 转换当前目录所有 Markdown 文件
+md-to-pdf *.md \
+  --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage"]}' \
+  --pdf-options '{"format":"A4","margin":"20mm","printBackground":true}'
+
+# 递归转换所有子目录的 Markdown 文件
+md-to-pdf ./**/*.md \
+  --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage"]}' \
+  --pdf-options '{"format":"A4","margin":"20mm","printBackground":true}'
+```
+
+## 参数选项
+
+### --pdf-options 常用配置
+
+| 参数 | 可选值 | 说明 |
+|------|--------|------|
+| format | A4, Letter, A3, Legal | 纸张大小 |
+| margin | "20mm" 或 {"top":"20mm",...} | 页边距（支持 CSS 简写或对象） |
+| printBackground | true/false | 打印背景色（推荐 true） |
+| landscape | true/false | 横向/纵向 |
+
+## 重要提示
+
+- ⚠️ **必须使用** `--no-sandbox` 等参数（Docker 环境要求）
+- ✅ 已安装中文字体（fonts-noto-cjk），支持完美渲染中文
+- ✅ 已安装 Emoji 字体（fonts-noto-color-emoji）
+- 📝 支持完整 Markdown 语法（表格、代码块、Emoji）

package/dist/src/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAqFxC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAyFxC"}

package/dist/src/system-prompt.js

@@ -15,6 +15,8 @@ export function getSystemPrompt() {
 
 你是 Optima Agent，一个专业的电商运营 AI 助手。你的职责是帮助用户管理电商业务的各个方面。
 
+**重要**：用户提到的"独立站"、"店铺"、"我的店"均指 Optima AI 自有电商平台，不是 Shopify 或其他第三方建站平台。
+
 ## 当前环境
 
 - **当前时间**：${dateStr} ${timeStr}
@@ -34,6 +36,8 @@ export function getSystemPrompt() {
 - **homepage** - 店铺首页配置（Banner、集合展示）
 - **product-page** - 商品详情页配置
 - **comfy** - 图像/视频生成
+- **markdown-pdf** - Markdown 转 PDF（文档导出、报告生成）
+- **ffmpeg** - 音视频处理（格式转换、压缩、提取音频）
 - **ads** - Google Ads 广告投放
 - **scout** - Amazon 选品调研
 - **bi** - 数据分析和报表

package/dist/src/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;aAOI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgE9B,CAAC;AACF,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE9B,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.4.25",
+  "version": "0.4.27",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",