@optima-chat/optima-agent 0.8.93 → 0.8.95

package/.claude/skills/browser/SKILL.md

@@ -23,60 +23,75 @@ description: "Browser automation for web interactions. Use when user needs to op
 
 1. `browser-cli scripts` — 查看已有脚本（显示名称、描述、步骤）
 2. 如果有匹配的脚本 → 直接用 `browser-cli runscript <name> --param ...`
-3. 如果没有 → 手动探索完成任务，然后生成脚本并提交
+3. 如果没有 → 手动用 browser-cli 命令完成任务
 
 脚本执行零 token 消耗，比手动操作快 10 倍以上。
 
 ## 命令
 
-### 基础命令
+### 会话管理
 
 ```bash
-# 会话管理
 browser-cli launch [--url <url>] [--force]  # 启动浏览器（--force 先关闭已有会话）
 browser-cli close                            # 关闭浏览器并释放资源
 browser-cli status                           # 查看当前会话状态
+```
+
+### 导航
 
-# 导航
+```bash
 browser-cli navigate <url>            # 跳转到 URL
 browser-cli back                      # 后退
 browser-cli refresh                   # 刷新页面
+```
+
+### 交互
 
-# 交互
+```bash
 browser-cli click <index>             # 按索引点击元素
 browser-cli input <index> <text> [--no-clear]  # 输入文本（--no-clear 追加而非替换）
 browser-cli select <index> <option>   # 选择下拉选项
 browser-cli scroll <up|down> [--pages <n>]     # 滚动页面（默认 1 页）
 browser-cli keys <key>                # 键盘操作（Enter、Tab 等）
-browser-cli upload <index> <file...> # 上传文件到 file input（路径自动转换）
+browser-cli upload <index> <file...>  # 上传文件到 file input（路径自动转换）
+```
 
-# 页面检查
+### 页面检查
+
+```bash
 browser-cli dom                       # 获取当前 DOM 状态
 browser-cli screenshot [file]         # 截图（默认：/tmp/screenshot.png）
 browser-cli search <pattern>          # 搜索页面文本
 browser-cli find <css_selector>       # 通过 CSS 选择器查询
+```
+
+### 标签页管理
 
-# 标签页管理
+```bash
 browser-cli tabs                      # 列出所有标签页
 browser-cli switch <tab_id>           # 切换标签页
 browser-cli close-tab <tab_id>        # 关闭标签页
 ```
 
-### 脚本命令
+### 脚本
 
 ```bash
-# 查看与管理
 browser-cli scripts                                        # 列出所有脚本（含描述和步骤）
 browser-cli script-code <name>                             # 查看脚本源码
-browser-cli delete-script <name>                           # 删除脚本
-
-# 提交
-browser-cli submit-script --name <name> --code-file <path> # 提交脚本（新建或覆盖）
-
-# 执行
 browser-cli runscript <name> --param key=value [...]       # 执行脚本（自动轮询到完成）
 browser-cli runscript <name> --param key=value --no-poll   # 执行但不等待
 browser-cli script-task <task-id>                          # 查询执行状态
+browser-cli submit-script --name <name> --code-file <path> # 提交新脚本（新建或覆盖）
+browser-cli delete-script <name>                           # 删除脚本
+```
+
+### Profile 管理
+
+```bash
+browser-cli profiles                   # 列出浏览器 profile
+browser-cli delete-profile <id>        # 删除 profile
+browser-cli launch --profile <id>      # 用指定 profile 启动
+browser-cli runscript <name> --profile <id> --param ...  # 用指定 profile 执行脚本
 ```
 
 ## DOM 索引格式
@@ -92,38 +107,6 @@ browser-cli script-task <task-id>                          # 查询执行状态
 - 每次操作后索引会**重新分配** — 务必使用最新的索引
 - 使用这些索引来执行 `click`、`input` 和 `select` 命令
 
-## 登录与 Profile
-
-浏览器支持命名 Profile，用于隔离不同账号的登录态（cookies、session）。
-
-**当有明确的账号身份时（如多账号运营），必须使用 `--profile`。** 省略 `--profile` 会使用默认 Profile，导致不同账号登录态互相覆盖。
-
-- **命名 Profile**：`--profile <id>` 隔离不同账号的登录态，`launch` 和 `runscript` 都支持
-- **登录态自动持久化**：Profile 数据在浏览器运行时实时保存到磁盘，不依赖 close
-- **首次登录**：需要用户提供账号和验证码
-- **后续使用**：自动恢复登录态，无需重新登录
-- **login_required 处理**：如果 `runscript` 报此错误，用 `browser-cli launch --profile <id> --url <平台URL>` 引导用户重新登录
-
-```bash
-# 登录到指定 Profile
-browser-cli launch --profile xhs-tech --url https://creator.xiaohongshu.com
-
-# 用指定 Profile 执行脚本
-browser-cli runscript xiaohongshu-image-note --profile xhs-tech --param title="..."
-```
-
-## 文件路径
-
-浏览器后端可以直接读取用户工作空间的文件（通过共享 EFS）。传文件路径时直接使用你看到的路径即可，后端会自动转换：
-
-```
-~/images/photo.jpg              → 自动转换 ✓
-/home/aiuser/images/photo.jpg   → 自动转换 ✓
-/mnt/efs/{userId}/images/...    → 自动转换 ✓
-```
-
-不需要上传文件，不需要手动转换路径。
-
 ## 操作流程
 
 ### 流程一：有脚本（常见）
@@ -131,12 +114,6 @@ browser-cli runscript xiaohongshu-image-note --profile xhs-tech --param title=".
 ```bash
 # 1. 检查脚本
 browser-cli scripts
-# 输出:
-# xiaohongshu-image-note — 在小红书创作者平台发布图文笔记
-#   [1] navigate — 打开小红书发布页
-#   [2] switch_tab — 切换到上传图文模式
-#   [3] upload — 上传图片 {images}
-#   ...
 
 # 2. 直接执行
 browser-cli runscript xiaohongshu-image-note \
@@ -145,52 +122,35 @@ browser-cli runscript xiaohongshu-image-note \
   --param 'images=["~/images/photo1.jpg", "~/images/photo2.jpg"]'
 # 输出: ✓ Script completed
 
-# 另一个例子：小红书评论
+# 小红书评论
 browser-cli runscript xiaohongshu-comment \
   --param search_keyword="辞职做跨境电商" \
   --param comment="写得好！"
-# 输出: ✓ Script completed
-# 脚本会搜索帖子 → 打开 → 激活评论框 → 输入 → 发送
+
+# 小红书数据采集
+browser-cli runscript xiaohongshu-data-collect
+
+# Instagram 发帖
+browser-cli runscript instagram-image-post \
+  --param 'images=["~/images/photo.jpg"]' \
+  --param body="Morning vibes ☕"
 ```
 
-### 流程二：无脚本（首次）
+### 流程二：无脚本（手动操作）
 
 ```bash
-# 1. 检查脚本 — 没有匹配的
-browser-cli scripts
-# 输出: No scripts registered.
-
-# 2. 手动探索
-browser-cli launch --url https://creator.xiaohongshu.com
-# → 如果需要登录，向用户询问手机号和验证码
-browser-cli input 11 "18500400810"
-browser-cli click 33   # 发送验证码
-# (用户提供验证码)
-browser-cli input 12 "123456"
-browser-cli click 38   # 登录
-# → 登录成功，继续操作...
-browser-cli dom                           # 分析页面
-browser-cli click 1880                    # 点击"上传图文"
-browser-cli dom                           # 找到 file input
-browser-cli upload 1092 ~/images/photo.jpg  # 上传图片
-browser-cli input 2905 "标题"              # 填写标题
-browser-cli input 3432 "正文内容"          # 填写正文
-browser-cli click 2814                    # 点击发布
-# → 任务完成
-
-# 3. 生成 Python 脚本
-# 根据上面的探索轨迹，生成脚本文件，必须包含：
-# - DESCRIPTION: 脚本描述
-# - STEPS: 语义步骤列表（StepDef）
-# - run(ctx): 异步执行函数
-# 写到本地文件
-
-# 4. 提交脚本
-browser-cli submit-script \
-  --name xiaohongshu-image-note \
-  --code-file /tmp/xiaohongshu_image_note.py
-
-# 5. 关闭浏览器
+# 1. 启动浏览器
+browser-cli launch --url https://example.com
+
+# 2. 查看 DOM，找到要操作的元素
+browser-cli dom
+
+# 3. 操作元素（用 DOM 返回的索引）
+browser-cli click 15
+browser-cli input 22 "内容"
+browser-cli keys Enter
+
+# 4. 完成后关闭
 browser-cli close
 ```
 
@@ -199,228 +159,35 @@ browser-cli close
 ```bash
 # 1. 执行脚本
 browser-cli runscript xiaohongshu-image-note --param ...
-# 输出:
-# ⚠ Script needs fallback
-#
-# ✓ Completed:
-#   [1] navigate — 打开小红书发布页
-#   [2] switch_tab — 切换到上传图文模式
-#
-# ✗ Failed at step [3] upload: file input not found
-#
-# → Remaining steps:
-#   [3] upload — 上传图片 ["~/photo.jpg"]
-#   [4] fill_title — 填写标题'测试'
-#   [5] fill_body — 填写正文'内容'
-#   [6] publish — 点击发布按钮
-#   [7] verify — 确认发布成功
-#
-# Session is still open — use browser-cli dom/click/input to continue
-
-# 2. 接管完成剩余步骤（Session 仍然打开，不需要重新 launch）
-browser-cli dom                    # 查看当前页面
-browser-cli click 15               # 继续操作
-browser-cli input 22 "测试"
-browser-cli click 30
-# → 任务完成
-
-# 3. (可选) 更新脚本以修复问题
-# 重新生成脚本，覆盖旧版本
-browser-cli submit-script \
-  --name xiaohongshu-image-note \
-  --code-file /tmp/xiaohongshu_image_note_v2.py
-
-# 4. 关闭浏览器
-browser-cli close
-```
-
-## 脚本代码规范
-
-### 基本结构
-
-每个脚本必须包含 `DESCRIPTION`、`STEPS` 和 `async def run(ctx)`:
-
-```python
-"""脚本描述。"""
-from __future__ import annotations
-import asyncio
-import json
-from app.scripts.base import ScriptContext, ScriptResult, StepDef, render_steps
-
-DESCRIPTION = "一句话描述脚本功能"
-
-STEPS = [
-    StepDef(id="step_id", description="步骤描述，支持 {param} 占位符"),
-]
-
-PAGE_SETTLE = 2  # 页面操作后等待秒数
-
-async def run(ctx: ScriptContext) -> ScriptResult:
-    bs = ctx.browser_session
-    steps = render_steps(STEPS, ctx.params)
-    completed: list[StepDef] = []
-
-    try:
-        # 逐步执行，每完成一步 append
-        # ...
-        return ScriptResult(status="completed", output={...}, completed_steps=completed)
-    except Exception as e:
-        remaining = [s for s in steps if s not in completed]
-        snapshot = await _capture_snapshot(bs)
-        return ScriptResult(
-            status="needs_fallback",
-            completed_steps=completed,
-            remaining_steps=remaining,
-            error=str(e),
-            snapshot=snapshot,
-        )
-
-async def _capture_snapshot(bs) -> dict:
-    try:
-        state = await bs.get_browser_state_summary(include_screenshot=False)
-        dom = state.dom_state.llm_representation() if state and state.dom_state else ""
-    except Exception:
-        dom = ""
-    return {"dom": dom}
-```
-
-### 浏览器操作 API
-
-```python
-# 导航
-action = ctx.action_model(navigate={"url": "https://example.com"})
-await ctx.controller.act(action, bs)
-await asyncio.sleep(PAGE_SETTLE)
+# 输出: ⚠ Script needs fallback
+# → 显示已完成和剩余步骤
 
-# 点击（通过 DOM index）
-action = ctx.action_model(click={"index": idx})
-await ctx.controller.act(action, bs)
+# 2. Session 仍然打开 — 用手动命令继续完成剩余步骤
+browser-cli dom
+browser-cli click 15
+browser-cli input 22 "内容"
 
-# 输入文本
-action = ctx.action_model(input={"index": idx, "text": "内容"})
-await ctx.controller.act(action, bs)
-
-# 获取当前 DOM（每步操作前刷新）
-state = await bs.get_browser_state_summary(include_screenshot=False, cached=False)
-sm = state.dom_state.selector_map or {}
-
-# 获取当前 URL
-page = await bs.get_current_page()
-url = await page.get_url()
-```
-
-### 元素查找（语义匹配，不要硬编码 index）
-
-DOM index 每次页面变化后会重新分配，脚本中**不能硬编码 index**。
-必须通过语义属性动态查找：
-
-```python
-# 按文字内容查找（如按钮、标签页）
-def _find_by_text(sm, text, tag=None):
-    for idx, node in sm.items():
-        node_tag = (getattr(node, "tag_name", "") or "").lower()
-        if tag and node_tag != tag:
-            continue
-        try:
-            node_text = node.get_all_children_text().strip() if hasattr(node, "get_all_children_text") else ""
-        except Exception:
-            node_text = ""
-        if text in node_text:
-            return idx
-    return None
-
-# 按 placeholder 查找（如输入框，支持 shadow DOM）
-def _find_by_placeholder(sm, placeholder_contains):
-    for idx, node in sm.items():
-        attrs = getattr(node, "attributes", {}) or {}
-        if placeholder_contains in attrs.get("placeholder", ""):
-            return idx
-        # Shadow DOM fallback
-        if not attrs:
-            try:
-                llm = node.llm_representation() if hasattr(node, "llm_representation") else ""
-                if placeholder_contains in llm:
-                    return idx
-            except Exception:
-                pass
-    return None
-
-# 按 role 查找（如 contenteditable 编辑器）
-def _find_by_role(sm, role, tag=None):
-    for idx, node in sm.items():
-        node_tag = (getattr(node, "tag_name", "") or "").lower()
-        if tag and node_tag != tag:
-            continue
-        attrs = getattr(node, "attributes", {}) or {}
-        if attrs.get("role") == role:
-            return idx
-        if attrs.get("contenteditable") and role == "textbox":
-            return idx
-    return None
-
-# 按文件类型查找 file input（如图片上传）
-def _find_image_file_input(bs, sm):
-    for idx, node in sm.items():
-        if not bs.is_file_input(node):
-            continue
-        attrs = getattr(node, "attributes", {}) or {}
-        accept = attrs.get("accept", "")
-        if any(ext in accept for ext in [".jpg", ".jpeg", ".png", ".webp"]):
-            return idx
-    for idx, node in sm.items():
-        if bs.is_file_input(node):
-            return idx
-    return None
+# 3. 完成后关闭
+browser-cli close
 ```
 
-### 文件上传
-
-上传文件需要 `FileSystem` 和 `available_file_paths`：
-
-```python
-from browser_use.filesystem.file_system import FileSystem
-from app.services.file_upload import UPLOAD_TEMP_BASE
-import secrets as _secrets
+## 文件路径
 
-# 创建临时目录
-fs_dir = UPLOAD_TEMP_BASE / f"script_{_secrets.token_hex(4)}"
-fs_dir.mkdir(parents=True, exist_ok=True)
-file_system = FileSystem(base_dir=str(fs_dir), create_default_files=False)
+浏览器后端可以直接读取用户工作空间的文件。传文件路径时直接使用你看到的路径即可，后端会自动转换：
 
-# 上传每个文件
-images = json.loads(ctx.params.get("images", "[]"))
-file_idx = _find_image_file_input(bs, sm)
-for img_path in images:
-    action = ctx.action_model(upload_file={"index": file_idx, "path": img_path})
-    await ctx.controller.act(action, bs, available_file_paths=images, file_system=file_system)
+```
+~/images/photo.jpg              → 自动转换 ✓
+/home/aiuser/images/photo.jpg   → 自动转换 ✓
+/mnt/efs/{userId}/images/...    → 自动转换 ✓
 ```
 
-文件路径由引擎自动转换（~/xxx → /mnt/workspaces/{userId}/xxx），脚本直接用 `ctx.params` 中的路径即可。
-
-### 等待页面变化
-
-页面操作后（导航、上传、点击）需要等待，用轮询模式：
-
-```python
-# 简单等待
-await asyncio.sleep(PAGE_SETTLE)
+## 需要用户登录态的任务
 
-# 轮询等待某个元素出现（如上传后等编辑模式）
-target_idx = None
-for attempt in range(10):
-    await asyncio.sleep(PAGE_SETTLE)
-    state = await bs.get_browser_state_summary(include_screenshot=False, cached=False)
-    sm = state.dom_state.selector_map or {}
-    target_idx = _find_by_placeholder(sm, "填写标题")
-    if target_idx is not None:
-        break
-if target_idx is None:
-    raise RuntimeError("等待超时：目标元素未出现")
-```
+当用户要求操作需要登录的平台（小红书、Instagram、微博、淘宝等社交/电商平台），在开始执行前先引导用户安装扩展：
 
-### 完整示例
+"这个任务需要用到你在 [平台名] 的登录态。请安装 Optima Browser Operator Chrome 扩展，这样我可以直接用你已登录的浏览器来操作，不需要你提供密码。"
 
-参考系统内置脚本 `xiaohongshu-image-note`（通过 `browser-cli script-code xiaohongshu-image-note` 查看完整源码）。
+安装后用户回到聊天页面，扩展自动连接，直接执行任务。如果用户在该平台未登录，提示用户先在自己的 Chrome 里登录。
 
 ## 注意事项
 
@@ -428,9 +195,7 @@ if target_idx is None:
 - **DOM 自动返回**：每个操作会自动返回 DOM 状态 — 无需单独调用 `browser-cli dom`
 - **避免不必要的截图**：截图消耗 token，日常导航用 DOM 输出即可
 - **5 分钟超时**：无操作 5 分钟后会话自动关闭
-- **登录自动保持**：登录一次后自动持久化，无需重复登录
-- **文件路径自动转换**：直接传你看到的路径（~/xxx），后端自动处理
 - **务必关闭**：操作完成后运行 `browser-cli close` 释放资源
-- **login_required 处理**：如果 runscript 返回 `login_required` 错误，说明该平台未登录。先 `browser-cli launch --url <平台URL>` 手动登录（问用户要验证码），登录后 `browser-cli close` 保存登录态，再重新 `runscript`
+- **login_required 处理**：如果 runscript 返回 `login_required` 错误，说明该平台未登录。如果用户已安装 Extension 且 Extension 已连接，用户的 Chrome 通常已经登录了——让用户在自己的 Chrome 里手动登录该平台，然后重新 `runscript`。如果没有 Extension（走 Chromium），用 `browser-cli launch --url <平台URL>` 引导用户登录
 - **Fallback 后更新脚本**：如果脚本频繁失败，重新生成并 submit-script 覆盖
 - **Extension 模式**：标记了 `REQUIRES_USER_SESSION=True` 的脚本会自动使用用户的真实 Chrome（通过 Optima Browser Operator 扩展），未标记的脚本走 Chromium。这由后端自动判断，无需手动指定

package/.claude/skills/homepage/SKILL.md

@@ -58,6 +58,12 @@ description: 店铺首页配置。管理首页区块（Banner、集合列表、
 | 调整背景叠加颜色 | `commerce homepage update-page-settings --overlay-color "#f5f5f5"` |
 | 移除背景图 | `commerce homepage update-page-settings --remove-background` |
 
+### 品牌色
+
+| 用户说 | 命令 |
+|-------|------|
+| "修改品牌色" / "设置主题色" | **merchant skill**：`commerce merchant update --primary-color "#xxx"` |
+
 ### 通用操作
 
 | 用户说 | 命令 |

package/.claude/skills/i18n/SKILL.md

@@ -177,6 +177,26 @@ commerce i18n homepage set \
 commerce i18n homepage list --section-id section_123
 ```
 
+### 场景7: 店铺政策翻译
+
+```bash
+# 翻译退货政策
+commerce i18n shop-policy set --policy-type returns --lang zh-CN --title "退货政策" --content "# 退货政策\n\n..."
+
+# 翻译隐私政策
+commerce i18n shop-policy set --policy-type privacy --lang ja-JP --title "プライバシーポリシー" --content "# ..."
+```
+
+### 场景8: 店铺关于页面翻译
+
+```bash
+# 翻译关于页面
+commerce i18n shop-about set --lang zh-CN --about-content "# 我们的故事\n\n..."
+
+# 翻译联系页面补充内容
+commerce i18n shop-about set --lang ja-JP --contact-content "# お問い合わせ\n\n..."
+```
+
 ## 卓越标准 (Excellence Standards)
 
 ### 翻译质量维度
@@ -354,6 +374,8 @@ commerce i18n variant create --variant-id var_2 --lang ja-JP \
 - "翻译集合信息" → `commerce i18n collection create --collection-id XX --lang YY`
 - "设置商户多语言信息" → `commerce i18n merchant create --lang XX`
 - "翻译首页区块" → `commerce i18n homepage set --section-id XX --lang YY`
+- "翻译店铺政策" → `commerce i18n shop-policy set --policy-type XX --lang YY`
+- "翻译关于页面" → `commerce i18n shop-about set --lang XX`
 
 ### 商品翻译
 
@@ -390,6 +412,14 @@ commerce i18n variant create --variant-id var_2 --lang ja-JP \
 - `commerce i18n homepage list` - 查看首页翻译
 - `commerce i18n homepage delete` - 删除首页翻译
 
+### 店铺政策翻译
+
+- `commerce i18n shop-policy set` - 设置店铺政策翻译
+
+### 店铺关于页面翻译
+
+- `commerce i18n shop-about set` - 设置店铺关于页面翻译
+
 ## 详细示例 (Detailed Examples)
 
 ### 商品翻译示例
@@ -477,7 +507,7 @@ commerce i18n product create --product-id prod_2 --lang ja-JP --name "..."
 
 ## 重要提示 (Important Notes)
 
-- **支持的语言**：en-US, es-ES, ja-JP, vi-VN, zh-CN
+- **支持的语言**：en-US, es-ES, ja-JP, vi-VN, zh-CN, zh-HK, zh-TW
 - **语言代码格式**：必须使用BCP 47格式（如 en-US），不能使用短代码（如 en）
 - **变体翻译参数**：使用 `--variant-id`（不是 `--product-id`）
 - **变体规格翻译**：`variant-attributes-translations` 格式需要同时翻译规格键和值

package/.claude/skills/merchant/SKILL.md

@@ -13,6 +13,7 @@ description: "店铺基础信息管理。使用场景：查看店铺信息、更
 | "修改店铺名称" / "更新店铺描述" | `commerce merchant update --name/--description` |
 | "设置联系方式" | `commerce merchant update --contact-*` |
 | "更新发货地址" | `commerce merchant update --origin-*` |
+| "设置品牌色" / "修改主题色" / "换个颜色" | `commerce merchant update --primary-color "#1a3a5c"` |
 
 ## 不在此模块（重要）
 
@@ -51,6 +52,7 @@ commerce merchant update [选项]
 | `--description` | 店铺描述 |
 | `--default-currency` | 默认货币（USD, CNY 等） |
 | `--google-ads-customer-id` | Google Ads 客户 ID（10位数字） |
+| `--primary-color` | 品牌主色（hex 格式，如 #FF5A5F） |
 
 ### 联系方式
 | 选项 | 说明 |
@@ -91,6 +93,9 @@ commerce merchant update \
   --origin-postal-code 518000 \
   --origin-line-1 "科技园路1号" \
   --origin-state 广东
+
+# 设置品牌色
+commerce merchant update --primary-color "#1a3a5c"
 ```
 
 ---

package/.claude/skills/shop-content/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: shop-content
+description: "店铺内容管理。使用场景：更新关于我们、设置联系信息、管理退货/隐私/条款/配送政策、设置社交链接。注意：翻译用 i18n skill。"
+---
+
+# 店铺内容管理
+
+## 典型场景
+
+| 用户说 | 命令 |
+|--------|------|
+| "更新关于我们" / "写关于页面" | `commerce shop-about update --about-content "# Our Story..."` |
+| "设置联系方式" | `commerce shop-about update --contact-email "..." --contact-phone "..."` |
+| "添加联系页面内容" | `commerce shop-about update --contact-content "# Contact..."` |
+| "查看关于信息" | `commerce shop-about get` |
+| "设置 Instagram" / "添加社交链接" | `commerce shop-about update --social-instagram "https://..."` |
+| "设置退货政策" / "更新退货政策" | `commerce shop-policy set --type returns --title "退货政策" --content "# ..."` |
+| "设置隐私政策" | `commerce shop-policy set --type privacy --title "隐私政策" --content "# ..."` |
+| "设置服务条款" | `commerce shop-policy set --type terms --title "服务条款" --content "# ..."` |
+| "设置配送政策" | `commerce shop-policy set --type shipping --title "配送政策" --content "# ..."` |
+| "查看所有政策" | `commerce shop-policy list` |
+| "查看退货政策" | `commerce shop-policy get --type returns` |
+
+## 不在此模块（重要）
+
+| 用户说 | 正确位置 |
+|--------|----------|
+| "翻译退货政策" / "政策日语版" | **i18n skill**：`commerce i18n shop-policy set` |
+| "翻译关于我们" | **i18n skill**：`commerce i18n shop-about set` |
+| "首页设置" / "首页区块" | **homepage skill** |
+| "修改品牌色" / "主题色" | **merchant skill**：`commerce merchant update --primary-color` |
+
+---
+
+## 关于页面内容
+
+```bash
+# 查看当前内容
+commerce shop-about get
+
+# 更新关于页面（Markdown 格式）
+commerce shop-about update --about-content "# Our Story\n\nWe started in 2020..."
+
+# 更新联系页面补充内容
+commerce shop-about update --contact-content "## 批发合作\n\n请联系..."
+```
+
+## 联系信息
+
+```bash
+commerce shop-about update \
+  --contact-email "hello@store.com" \
+  --contact-phone "+86 138xxxx" \
+  --business-address "深圳市南山区..." \
+  --business-hours "Mon-Fri 9:00-18:00"
+```
+
+## 社交链接
+
+```bash
+# 设置单个
+commerce shop-about update --social-instagram "https://instagram.com/mystore"
+
+# 设置多个
+commerce shop-about update \
+  --social-instagram "https://instagram.com/mystore" \
+  --social-tiktok "https://tiktok.com/@mystore" \
+  --social-youtube "https://youtube.com/@mystore"
+```
+
+支持：`--social-instagram`, `--social-facebook`, `--social-twitter`, `--social-tiktok`, `--social-youtube`
+
+## 店铺政策
+
+```bash
+# 查看所有政策
+commerce shop-policy list
+
+# 查看特定政策
+commerce shop-policy get --type returns
+
+# 设置/更新政策（Markdown 格式）
+commerce shop-policy set --type returns --title "退货政策" --content "# 退货政策\n\n..."
+commerce shop-policy set --type privacy --title "隐私政策" --content "# 隐私政策\n\n..."
+commerce shop-policy set --type terms --title "服务条款" --content "# 服务条款\n\n..."
+commerce shop-policy set --type shipping --title "配送政策" --content "# 配送政策\n\n..."
+```
+
+**注意**：政策类型只能是 `terms`、`privacy`、`returns`、`shipping`。
+
+## 内容格式
+
+所有内容字段（about_content、contact_content、policy content）使用 **Markdown 格式**，支持标题、列表、粗体、链接等。
+
+## 命令参考
+
+- `commerce shop-about get` - 查看关于/联系信息
+- `commerce shop-about update` - 更新关于/联系/社交链接
+- `commerce shop-policy list` - 查看所有政策
+- `commerce shop-policy get --type <type>` - 查看特定政策
+- `commerce shop-policy set --type <type> --title <title> --content <content>` - 设置政策

package/package.json

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