Skip to content

oil-oil/see-skill / see

使用外部视觉服务或本地 OCR 分析本地图片、截图、视频及明确提供的媒体 URL,输出 Markdown。用户明确要求 see,或当前主模型缺少完成媒体分析所需的视觉能力时使用。不拦截普通文本、任意 URL 或已有原生视觉可以直接完成的任务;不用于生图、编辑图片或自动操作屏幕。使用外部服务前说明发送的媒体与服务范围,无法识别时如实说明限制。

FileKindSize
SKILL.mdskill md4.8 KB
agents/openai.yamlconfig368 B
references/api-key-setup.mdmarkdown4.0 KB
scripts/credential-ui/README.mdmarkdown8.0 KB
scripts/credential-ui/component.jsonconfig2.2 KB
scripts/credential-ui/manifests/bailian.jsonconfig227 B
scripts/credential-ui/manifests/default.jsonconfig226 B
scripts/credential-ui/manifests/openrouter.jsonconfig230 B
scripts/credential-ui/manifests/profiles.jsonconfig494 B
scripts/credential-ui/manifests/tokendance.jsonconfig230 B
scripts/credential-ui/package-lock.jsonmanifest8.5 KB
scripts/credential-ui/package.jsonmanifest656 B
scripts/credential-ui/public/app.jsscript6.3 KB
scripts/credential-ui/public/favicon.svgother315 B
scripts/credential-ui/public/index.htmlother1.2 KB
scripts/credential-ui/public/style.cssother3.1 KB
scripts/credential-ui/src/cli.tsscript6.3 KB
scripts/credential-ui/src/config.tsscript5.7 KB
scripts/credential-ui/src/page.tsscript1.7 KB
scripts/credential-ui/src/profile.tsscript4.7 KB
scripts/credential-ui/src/run.tsscript3.3 KB
scripts/credential-ui/src/server.tsscript11.3 KB
scripts/credential-ui/tests/configure.test.tsscript2.5 KB
scripts/credential-ui/tests/credentials.test.tsscript6.4 KB
scripts/credential-ui/tests/multi-key.test.tsscript9.7 KB
scripts/credential-ui/tests/native-smoke.tsscript4.1 KB
scripts/credential-ui/tests/page.test.tsscript2.0 KB
scripts/credential-ui/tests/profile.test.tsscript4.1 KB
scripts/credential-ui/tests/run.test.tsscript2.7 KB
scripts/credential-ui/tests/ui.test.tsscript5.0 KB
scripts/credential-ui/tsconfig.jsonconfig353 B
scripts/credential-ui/tsconfig.web.jsonconfig237 B
scripts/credential-ui/web/app.tsscript6.3 KB
scripts/ocr_macos.jsscript2.5 KB
scripts/ocr_macos.swiftscript5.7 KB
scripts/ocr_windows.ps1script3.3 KB
scripts/onboard.pyexecutablescript12.0 KB
scripts/parse_media.pyexecutablescript47.0 KB
scripts/requirements-credentials.txtmarkdown73 B
scripts/secure_credentials.pyscript1.8 KB
scripts/see.shexecutablescript146 B

references/api-key-setup.md

View on GitHub
# API Key 配置与业务读取

已有宿主安全配置或可信运行环境注入时直接复用。首次在桌面填写或更换 Key 时使用随附统一页面,不能用“已支持环境变量”或终端隐藏输入代替页面接入。只为用户选择的外部服务配置;内置能力、离线处理和已有官方登录不要求额外 Key。

## 首次配置

将当前 SKILL.md 所在绝对目录记为 `SKILL_DIR`。页面需要 Node.js 22.18+,首次在组件目录安装锁定依赖:

```bash
npm --prefix "$SKILL_DIR/scripts/credential-ui" ci --ignore-scripts
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" status default
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" setup default
```

先查 status:退出码 0 表示当前业务凭据可读取,2 表示缺失,1 表示配置或系统后端失败。缺失或用户要求更换时才启动 setup,把返回的本机链接展示给用户,由用户亲自填写保存。不要自动操作真实 Key 页面,不让用户贴进聊天。

页面不回填原值;已有项留空保留,替换需要用户确认。只把 `saved` 当作全部保存成功;`partial`、超时和中断后先重新查状态,再补未完成项。配置成功仅证明保存和可读取,实际 API 可用性以业务调用为准。

## 服务与用途绑定

| 配置名 | 业务环境变量 | 系统凭据引用 |
| --- | --- | --- |
| default | `ZENMUX_API_KEY` | `see/zenmux/default` |
| bailian | `DASHSCOPE_API_KEY` | `see/bailian/default` |
| openrouter | `OPENROUTER_API_KEY` | `see/openrouter/default` |
| tokendance | `TOKENDANCE_API_KEY` | `see/tokendance/default` |

`default` 是脚本已有默认适配器,并不授权调用收费服务。用户选另一适配器时,同时选择对应配置名与业务参数,不能只换 Key。服务真实名称、接口和数据范围见原有依赖说明;以上变量名保留程序兼容。

一个服务的图片和视频共用同一 Key,不重复创建。多个服务各用独立声明;需要同页填写时用组件的 `configure-page` 组合所选声明,见[组件说明](../scripts/credential-ui/README.md)。不要求填写用户没有使用的服务。

## 运行业务

通过以下入口运行本 Skill 的真实脚本,`--` 后保留原业务参数:

```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$SKILL_DIR/scripts/parse_media.py" "/path/to/image.png" --provider zenmux
```

环境变量优先;缺失时仅从系统库读取当前配置所需的 Key,并只注入可信业务子进程。参数、普通文件和状态输出都不含 Key。使用页面保存的凭据后,后续云端业务命令同样经 run 入口执行,不能只启动配置页后直接运行一个仍仅读环境变量的程序。`--help` 示例只检查业务用法,不表示已调用服务。

系统后端分别为 macOS 钥匙串、Windows 凭据管理器、Linux Secret Service。Linux 需要 secret-tool、用户 D-Bus 和已解锁的桌面凭据服务;缺少后端时停止,不自动安装、解锁或降级明文。当前 macOS 组件有原生假凭据验证;Windows/Linux 适配仍需实机验收。CI、容器与远程服务器使用已有 Secret 注入,不把本机页面开放到网络。

原配置不自动迁移或删除;页面保存不代表旧明文文件已经清理。已有程序专用配置、账号或不同凭据引用按其原流程保留,不跨账号覆盖。凭据属于当前系统用户;正常流程不将其传入对话,不代表对同用户任意代码执行的强隔离。

## 验证

```bash
npm --prefix "$SKILL_DIR/scripts/credential-ui" run check
npm --prefix "$SKILL_DIR/scripts/credential-ui" run build
npm --prefix "$SKILL_DIR/scripts/credential-ui" test
```

测试使用假后端覆盖正式页面、同页 HTTP 保存、业务变量读取、部分失败恢复和脱敏;不操作用户真实页面。原生测试 `npm run test:native` 仅创建随机测试引用并清理,不验证实际服务额度或业务效果。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall