See

先检查已有附件、可读媒体路径和当前宿主的视觉能力。原生视觉足够时直接完成；需要外部视觉时，说明将发送哪些媒体给哪个服务，并继承当前任务已经给出的授权。缺少可读输入时才索取路径或 URL。

将当前 Skill 目录解析为绝对路径后调用 scripts/see.sh。外部服务或 OCR 均不可用时如实说明，不隐瞒限制，不把 OCR 文字结果称为完整视觉理解。

安装 Skill 不会更换当前主模型；界面继续显示原来的文本模型是正常的。拖拽或粘贴图片若被拒绝，说明附件在 Skill 启动前已被拦截。不要反复尝试直接读取附件。

首次使用，或用户反馈模型说了「不支持视觉」却没有调用 see 时，先运行：

python3 scripts/onboard.py --status

仅用户明确要求修改全局规则时，才使用 onboard.py --install-agents；它是可选的宿主适配，不是媒体分析的前置步骤。缺少配置时由安全入口收集凭据，不让用户把密钥发到对话。

# 单图
scripts/see.sh image.png

# 视频
scripts/see.sh video.mp4

# 多图并行
scripts/see.sh a.png b.png c.png

# 多图比较或联合判断
scripts/see.sh --together before.png after.png --task "比较界面变化"

# 可选关注点
scripts/see.sh screenshot.png --task "重点识别界面文字"

成功后读取 stdout 中 output_path=<path> 指向的 Markdown。

脚本自动完成：识别图片或视频 → 选择供应商 → 失败时切换供应商。图片无云端时降级到本地视觉；视频自动压缩后原生输入模型，不自行抽帧。多文件默认并行。

图片原图直传。视频按所选服务的模型配置处理；自动保留清晰度、音频和完整时间线。--task 原样发送；没有特殊问题时不要添加。

新配置按上述 API Key 配置说明打开本机页面，由用户亲自保存；选择的配置名、业务 --provider 必须对应。通过 run 包装云端分析命令，不能绕过包装器读取页面凭据。原 onboard 只用于兼容配置、状态或用户明确选择的终端方式。

供应商：zenmux、bailian、openrouter、tokendance、local。图片默认 Qwen3.7 Plus；视频在 ZenMux/OpenRouter 默认 Gemini 3.1 Flash-Lite，其余平台默认 Qwen3.7 Plus。覆盖视频模型用 SEE_VIDEO_MODEL。

也兼容厂商变量：ZENMUX_API_KEY、DASHSCOPE_API_KEY、OPENROUTER_API_KEY、TOKENDANCE_API_KEY。配置读取顺序为环境变量 → .env.local → 用户私有配置。

Windows 私有配置位于 %APPDATA%\see\config.env；macOS/Linux 位于 ~/.config/see/config.env。配置文件权限仅限当前用户，不得复制进 Skill 或项目仓库。

本地降级：

• macOS：系统 Vision OCR；有 Swift 时增加场景/人物/人脸/条码/图形结构 → Tesseract
• Windows：Windows OCR → Tesseract
• Linux：Tesseract

本地后端报错时先运行 python3 scripts/onboard.py --status。macOS 10.15+ 不需要 Xcode；Windows 需要安装系统 OCR 语言；Linux 需要安装 Tesseract。

可选参数只在需要时使用：--together、--provider、--model、--task、--jobs、--ocr-backend。本地视觉结果不等同于多模态模型的完整语义理解。

视频需要任一云端 Key；同一个 Key 同时用于图片和视频。主 Agent 只传路径并读取 output_path，不要自行调用 ffmpeg、抽帧或上传。

API Key 配置入口

需要外部服务凭据时先读API Key 配置与业务读取：复用已有安全入口；本机缺少 Key 时使用随附固定页面，保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。

凭据与数据边界

云端分析会把选定媒体发给所选供应商，可能计费；本地 OCR 不等于完整视觉理解。新密钥通过固定本机页面存入系统凭据库，普通配置只保存引用。先用任务 Python 环境安装 see/scripts/requirements-credentials.txt（Skill 内相对路径为 scripts/requirements-credentials.txt）。不把 Key 发到聊天、命令参数或日志。旧明文配置不会自动迁移或覆盖：入口会先停止，提示备份后重新配置。状态检查只确认来源，API 验证成功才代表可用。全局指令写入仅在明确调用 --install-agents 时发生。