{
  "markdown": "# zrong/skills\n\n我的 AI Agent Skills 集合。\n\n## 安装\n\n```bash\n# 安装所有 skills（全局）\nnpx skills add zrong/skills -g\n\n# 安装到特定 agent\nnpx skills add zrong/skills --agent claude-code cursor openclaw\n\n# 只安装特定 skill\nnpx skills add zrong/skills --skill git-commit\n```\n\n## Skills\n\n### git-commit\n\nGit 提交并打 CalVer 标签。\n\n- 当用户说\"提交\"、\"commit\"、\"打标签\"、\"tag\"、\"发版\"时自动激活\n- 自动计算 CalVer 版本号（YY.WW.MICRO 格式）\n- 自动更新 README.md 记录变更\n\n### mcp-deploy\n\nMCP 服务器自动部署工具。\n\n- 当用户说\"部署 MCP\"、\"安装 MCP\"、\"配置 MCP\"时自动激活\n- 支持智谱 MCP、Minimax MCP、Gitea MCP 等平台的自动配置\n- 提供常用 MCP 的配置参考和部署流程\n\n### email\n\n邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。\n\n- 当用户需要查看、搜索、管理邮件、下载附件、移动归档邮件时自动激活\n- 支持 IMAP 协议，提供完整的邮件管理能力\n- 内置配置初始化工具，支持多账户管理\n- 密码加密存储在本地 .env 文件中\n\n### feishu-image\n\n通过飞书 (Lark) API 发送图片和截图。\n\n- 当用户要求\"截图发给我\"或发送图片到飞书时自动激活\n- 支持在 OpenClaw 中自动读取飞书配置\n- 支持独立使用（通过环境变量配置）\n- 提供 CLI 工具和 Node.js SDK\n\n### media-use\n\n媒体处理工具集，基于 ffmpeg 提供视频转码、目标体积压缩、Logo 水印、片尾拼接、裁剪、合并和修复等功能。\n\n- 当用户需要视频转码、格式转换、指定大小压缩、添加水印/Logo、追加片头片尾、音频处理、视频裁剪/剪辑、视频合并或修复 m3u 下载的损坏视频时自动激活\n- ffmpeg_batch：批量视频转码（H.264、H.265/HEVC、AV1、VP9，支持 GPU 硬件加速）\n- ffmpeg_cut：按起止时间无损裁剪视频片段（-c copy，支持 HH:MM:SS.ms / 秒数）\n- ffmpeg_merge：合并编码一致的视频文件（concat demuxer + -c copy，自动一致性校验）\n- ffmpeg_fix：修复 m3u 下载的 mp4（faststart，moov atom 前置，支持文件 / 文件夹批量）\n- 支持 AAC、MP3、Opus、FLAC、AC3 等音频编码\n\n### video-downloader\n\n统一视频下载工具，整合 `douyin-downloader`、`wx_channels_download` 与 `yt-dlp` 三种 backend。\n\n- 当用户发来视频链接并要求下载，或提到 `yt-dlp` / `douyin-downloader` / 微信视频号 / 抖音短链时自动激活\n- 支持抖音、微信视频号 SPH 分享链接，以及 yt-dlp 支持的网站视频下载\n- 支持抖音热搜榜、搜索作品、刷新 Cookie\n- 视频号认证失效时使用专用浏览器自动刷新腾讯元宝 Cookie，下载结果按视频号昵称归档\n- `douyin-downloader` 已集成到 `.runtime/douyin-downloader`，无需外部安装\n\n### video-analyzer\n\n使用视觉/视频大模型分析视频内容。\n\n- 当用户说\"分析视频\"、\"视频理解\"、\"看看这个视频\"时自动激活\n- 支持本地视频文件和互联网视频（直接 URL 及 YouTube/Bilibili 等站点）\n- 支持抽帧分析和原生视频输入两种模式\n- 多模型配置（豆包、GPT-4o 等 OpenAI 兼容 API）\n\n### seedance-2-video\n\n为 Sorb 的 Seedance 2.0 视频生成提供提示词、素材分析和分镜方法。\n\n- 当用户明确提出 Seedance 2.0、图生视频、参考视频复刻、运镜、分镜、视频延长或长视频规划时激活\n- 支持图片与视频抽帧分析、四维运镜、美学约束、首帧设计和多镜头生产流程\n- 使用 Sorb 模型 schema、`@图像N` 引用语义和 Canvas Agent 工具，不包含外部执行脚本\n\n### image-generation\n\nAI 图片生成与编辑工具，通过独立 OpenAI、Gemini 原生和 Seedream adapter 调用图片 API。\n\n- 当用户说\"生成图片\"、\"改图\"、\"参考图编辑\"、\"封面图\"、\"Gemini 生图\"、\"Seedream\"时自动激活\n- endpoint 独立配置 adapter/base_url/key，并用精确模型 allowlist 与 capability policy 在请求前拦截越权调用\n- 支持生成、mask/多参考图编辑、JSONL 并发、downscale、去背景和防覆盖输出\n- 支持 Seedream 5.0 Pro 点选/框选坐标协议与可恢复的连续编辑 session\n- 内置 API易聚合网关示例配置（gpt-image-2-vip、Grok Imagine、Nano Banana）；官方 gpt-image-2 支持原生透明背景，未声明该能力的模型统一走 `remove-background` 后处理\n- 去背景时优先调用独立 matting skill；配置缺失或服务不可用时明确回退现有 chroma-key\n\n### matting\n\n独立 matting-api 抠图工具，为本地图片自动选择算法并输出透明 PNG。\n\n- 每次执行前读取服务状态、队列、实时 methods/models 与可证明兼容的组合\n- 检查已有 alpha、边框颜色/均匀度、绿蓝幕和亮度分布，自动选择 BiRefNet、InSPyReNet、Luma 或 CorridorKey 组合\n- 支持显式算法/模型、dry-run、异步任务轮询、透明 PNG 验证、原子写入和防覆盖\n- 可由 image-generation 的 `remove-background` 统一入口调用\n\n### upscale\n\n独立 upscale-api 图片与视频超分工具，支持本地文件和 FileBrowser 远端文件。\n\n- 每次执行前读取服务健康、GPU/队列状态、实时模型能力与提交合同\n- 内置最快（Real-CUGAN Pro x2）、标准（Real-ESRGAN x2plus）、高质量（SeedVR2 3B）三档，也支持精确模型名与实时能力建议\n- 本地文件通过 multipart 上传，轮询任务终态，并返回 API 下载地址；可选下载并验证 PNG/MP4\n- FileBrowser 文件复用独立 filebrowser skill 的 `get`/`put`，默认把按实际输出信息命名的结果回传到原目录\n- 支持显式模型、upscale/enhance/resize 模式、图片倍率、视频倍率或目标尺寸、contain/cover 适配、RIFE 24→60 等精确补帧、视频时间范围、dry-run 和默认防覆盖\n- 默认输出名包含实际尺寸、帧率和模型ID；视频使用`输入名_1080p_60fps_模型.mp4`，图像使用`输入名_WxH_模型.png`\n\n### object-storage\n\n独立的 S3 兼容对象存储与 CDN 管理工具。\n\n- 支持多个命名 target，以及 AWS S3、腾讯云 COS、阿里云 OSS、火山 TOS、MinIO 等兼容端点\n- 上传单个本地文件或通过 `upload-tree` 递归上传目录，提供 dry-run、相对路径映射、\n  文件级并发、默认拒绝覆盖与上传后大小校验\n- 支持 `download` 单对象下载和 `download-tree` 递归下载：默认防覆盖、临时文件原子落盘，\n  校验远端大小及可用的 SHA-256 metadata\n- 支持 `head` 只读查询对象存在性及大小、类型、缓存策略、版本和摘要 metadata，无需下载正文\n- 目录上传复用单对象传输实现和 target 客户端，批次完成后合并执行目录/通配符 CDN 刷新\n- 支持显式设置 `Cache-Control`，覆盖对象时默认保留旧值，并在上传结果中回报实际对象头\n- 使用 `content-sha256` metadata 实现条件覆盖，并明确报告内容相同的文件列表\n- 支持腾讯云 CDN URL/目录刷新、预热和上传后自动刷新\n- 支持 Amazon CloudFront 文件/目录失效刷新与任务状态查询\n- 支持火山引擎 CDN 文件/目录刷新、预热与任务状态查询\n\n### filebrowser\n\nFileBrowser Quantum 文件管理与传输工具。\n\n- 支持多个 FileBrowser source、远程文件管理，以及 FileBrowser 与本地之间的 get/put\n- `upload` 把远端文件流式暂存后委托给独立 object-storage，S3/CDN 配置不再重复维护\n- 保留原有 target、覆盖、内容去重、CDN 和 JSON 命令接口，便于下游 Skill 平滑迁移\n- 纯 FileBrowser 命令不依赖 object-storage\n\n### joplin\n\n用于调用 Joplin REST API 读写笔记、查询笔记本、搜索内容等。\n\n- 当用户需要查看、搜索、保存内容到 Joplin 时自动激活\n- 支持通过命令行读写 Joplin 笔记（需要开启 Joplin Clipper 服务）\n- 支持笔记搜索、内容获取、创建、列出笔记本等操作\n- 自动读取 `.env` 中的 API Token\n\n### immich\n\n将图像和视频上传到 Immich 服务器。\n\n- 当用户说\"上传到 Immich\"、\"上传图片\"、\"备份照片\"、\"上传视频\"、\"下载视频并上传 Immich\"时自动激活\n- 只负责本地文件上传；网络资源先由 video-downloader 下载，再将本地路径交给 immich\n- 支持批量上传、Album 管理、完整描述写入，并默认按本次上传时间排列资源\n- 提供 Python SDK 和 CLI 工具\n\n### jellyfin\n\nJellyfin 媒体库命名与服务器维护工具。按 Jellyfin 标准重命名电影/剧集，并修复错误刮削。\n\n- 当用户需要整理 Jellyfin 媒体库、重命名媒体文件夹、获取/校验 IMDB ID、修复海报不更新、纠正错误刮削时自动激活\n- 支持解析 BT/字幕组命名风格（点分隔、中英混合、质量标记如 `1080P.X264.AAC`）\n- `clean`：批量去除文件名中的空格，图片重命名为 poster 格式\n- `rename-folder`：查询 OMDb API 获取 IMDB ID，重命名为 `Movie (year) [imdbid-ttXXXX]` 格式，支持电影和剧集；`--imdb-id` 先经 OMDb 反查验证防手填错\n- `rename-flat`：平铺目录（多部电影共用一个目录，如 TopNNN. 前缀合集）批量重命名，带终审清单与 OMDb 缓存\n- `verify` / `retag`：批量校验文件名中的 IMDB ID 并只替换标签修复错绑\n- `server refresh/images/identify/check`：调用 Jellyfin API 刷新媒体库、诊断海报来源、重新识别错误刮削、比对 DB 元数据与文件名\n- `de-localart`：清理本地旧海报/.nfo 让位在线刮削，可自动刷新库\n\n### vikunja\n\nVikunja 任务管理工具，将已完成任务同步到 Joplin weekly 笔记。\n\n- 当用户需要查看 Vikunja 项目/任务、同步任务到 Joplin 时自动激活\n- 支持列出项目和任务（按项目、完成状态、周过滤）\n- 支持将指定周的已完成任务同步到 Joplin GTD 笔记本的 weekly 笔记\n- 自动去重，带 `[x]` 标记已完成任务\n\n### spritesheet\n\n从视频中提取帧生成 spritesheet 和独立透明 PNG。\n\n- 当用户说\"制作 spritesheet\"、\"视频转精灵图\"、\"提取动画帧\"、\"sprite sheet\"、\"循环动画\"时自动激活\n- 支持自动检测背景色（绿幕/蓝幕/白幕/黑幕）并抠图\n- 默认主体感知全局接缝检测（主体 mask 内全局搜索最优循环接缝），支持 `--analyze` 诊断与 `--repack-dir` 删帧重打包\n- 输出独立透明 PNG、合并 spritesheet 和可交互的动画播放器\n\n### ui-extractor\n\n从静态图片中提取前景元素并分离 UI 组件。\n\n- 当用户说\"提取 UI 元素\"、\"分离组件\"、\"去除背景\"、\"棋盘格背景\"、\"绿幕抠图\"、\"checkerboard 抠图\"时自动激活\n- 支持棋盘格背景去除（自动检测 + 透视校正）和关键色抠图（绿/蓝/白/黑）\n- chroma 算法直接复用 spritesheet skill 的核心（保持一致性）\n- 输出透明背景 PNG、分离的 UI 元素 PNG、元数据 JSON\n\n### dns-manager\n\nDNS 解析记录管理工具（腾讯云 DNSPod，可扩展多服务商）。\n\n- 当用户说\"DNS\"、\"域名解析\"、\"A 记录\"、\"CNAME\"、\"添加/删除解析\"、\"把域名指向某 IP\"、\"DNSPod\"时自动激活\n- 幂等的 list / upsert / delete（unchanged / skipped 明确区分，重复执行无副作用），写操作支持 `--dry-run`\n- 纯标准库实现 TC3-HMAC-SHA256 签名直连腾讯云 OpenAPI，无第三方依赖\n- Provider 抽象 + registry，后续新增 aliyun/cloudflare 只需实现 `DnsProvider` 子类并注册\n- 凭据优先从环境变量读取（`TENCENTCLOUD_SECRET_ID/KEY`），复用 `shared/agent-config` 模板\n\n## 共享开发资源\n\n- [`shared/agent-config`](shared/agent-config/README.md)：`agent_config.toml` 的跨平台查找、全局兜底、显式路径、配置示例和测试模板。创建新 skill 时复制实现，运行时不依赖仓库共享目录。\n\n## 更新记录\n\n### 2026-10-02\n\n- 升级 immich skill：适配服务器 v3.0.2 并新增管理能力。上传清理 v3 已移除的 `deviceAssetId`/`deviceId` 死字段（checksum 预检实测服务器仅忽略不报错），修复 `init` 用同步 `with` 包异步客户端的存量 bug。新增 CLI：`scan`（外部图库重扫+等待，NAS 无 inotify 场景）、`folders`（服务器端文件夹浏览）、`album-plan`/`album-sync`（文件夹→相簿批量规划与幂等同步：`YYYYMMDD-MMDD地点` 命名、名称>真 EXIF（众数±30 天聚簇去离群）>文件日期众数的日期推导、含子文件夹资产、已存在相簿只校验补漏）、`album-share`/`album-delete`。`references/api-pitfalls-and-debugging.md` 新增 v3 破坏性变更清单（search 分页 nextPage 为字符串、相簿内容改走 search/metadata、共享 payload 不得带 owner、真实 EXIF 在 exifInfo 子对象、granular API key 权限清单）与外部图库扫描语义。全部命令在 Immich v3.0.2 实测（39 相簿/5751 资产同步幂等验证），新增 29 个单测。\n\n### 2026-09-27\n\n- 升级 jellyfin skill：新增 `lookup`（即席查号：imdbid 反查 / tmdbid 补全 / OMDb+RemoteSearch 双通道标题搜索）、`dupes`（跨目录查重，采样哈希秒级确认同一文件，ffprobe 画质对比给出保留建议）、`move`（电影整组搬移：视频+旁挂文件，与 dupes 联动做隔离）；RemoteSearch 裸调用收敛为 `_jellyfin_search_raw`；CJK 噪声词按长度降序剥离（修「西班牙语→牙语」类残留）并补「双字幕」；平铺分组与对账排除 `._` AppleDouble 元数据文件。全部命令在 Jellyfin 12.1 上实测通过（鉴权头 / RemoteSearch / Refresh / Apply 均无 API 破坏性变更）。\n\n### 2026-09-26\n\n- 升级 jellyfin skill：从单一重命名工具扩展为命名与服务器维护工具集。`rename` 更名 `rename-folder`，`--imdb-id` 新增 OMDb 反查验证（防人工记错 ID）与 `--force-imdb` 兜底；新增 `rename-flat`（平铺目录批量重命名，含 omdb_cache.json 缓存与 OMDb 脏数据过滤）、`verify`/`retag`（存量错绑体检与只换标签修复）、`server refresh/images/identify/check`（Jellyfin API 刷新、海报诊断、重新识别、DB 对账）与 `de-localart`（清理本地旧图/.nfo 让位在线刮削）；配置支持 `[jellyfin]` 根段与 `~/.agents/agent_config.toml` 兜底，补充 `agent_config.example.toml`，SKILL.md 重写并收录实战教训。\n- jellyfin 实战加固：OMDb 配额耗尽/网络故障时不再整批退出，自动降级 Jellyfin RemoteSearch（TMDb 支持中文标题）并按标题/年份可信度校验命中，复用文件名已有的 `[imdbid-]`/`[tmdbid-]` 标签；BT 命名解析强化（中文质量词/英文分辨率编码噪声清洗、括号与粘连年份、国家/地区/复制副本标记剥除）并支持多 CD/多碟电影 `- cdN` 堆叠命名；`verify` 跳过 SMB 8.3 短文件名与 `._` AppleDouble 元数据防止误判孤儿文件。\n\n### 2026-09-22\n\n- object-storage 新增 `download`、`download-tree` 与 `head`：支持单对象和递归下载、\n  本地覆盖保护、临时文件原子落盘、大小及可用 SHA-256 校验，以及不下载正文的对象元数据查询。\n\n### 2026-09-20\n\n- object-storage 新增 `upload-tree`：默认递归上传目录、保留相对路径、复用单对象上传实现和\n  target 客户端，支持文件级并发、批量覆盖预检、结果汇总及目录优先的合并 CDN 刷新。\n- object-storage 上传支持 `--cache-control`，覆盖时默认保留已有缓存策略，防止入口文件的\n  `no-cache,max-age=0,must-revalidate` 被覆盖清除，并回报上传后实际对象头。\n- object-storage 接入火山引擎 CDN：支持文件与目录刷新、预热、任务状态查询，并可复用 TOS target 的 AK/SK。\n- object-storage 主说明补充 Amazon CloudFront 与火山引擎 CDN 的刷新、预热和任务查询能力。\n- 明确项目版本记录规则：以 Git CalVer tag 为唯一正式版本，按 Git 历史推导单 Skill 版本，不在 `SKILL.md` 重复维护版本号。\n\n### 2026-09-18\n- 升级 upscale skill：支持视频 upscale/enhance/resize 明确处理模式、1080p 原尺寸增强、Lanczos 缩放，以及 RIFE 4.25/4.25 Lite 目标帧率补帧；按实时输入帧率校验120fps和4倍上限，并同步hc88的20秒人物样本速度与显存基线\n- 统一 upscale 默认结果命名：本地运行和FileBrowser回传均根据实际输出尺寸、实际帧率和模型ID生成文件名，显式指定输出路径时仍保留调用方名称\n- 增加 upscale CLI 的 `cancel <task-id>`：支持取消排队或运行中的任务，并可用 `--wait` 等待取消、完成或失败终态\n\n### 2026-09-17\n\n- 新增 upscale skill：直连 upscale-api 对本地或 FileBrowser 图片/视频执行超分，内置最快/标准/高质量三档并支持精确模型与实时能力建议；视频可按 2×/4× 或目标尺寸输出，并支持 contain/cover 适配；FileBrowser 结果默认回传至源文件同目录。\n\n### 2026-09-15\n- 新增 dns-manager skill：腾讯云 DNSPod 解析记录的幂等管理（list/upsert/delete + dry-run），纯标准库 TC3 签名，Provider 抽象预留多服务商扩展；已通过单元测试与真实 API 全路径验证\n- git-commit 明确提交与历史整理的授权边界、部分步骤受阻时的处理方式，以及原子提交的实际文件树验证要求。\n- object-storage 统一 AWS/腾讯云优先目录刷新策略，补充 CloudFront 每月 1000 个失效路径免费规则、跨分配合计与通配符计数，并区分腾讯云目录刷新额度。\n- object-storage 新增 AWS CloudFront 配置、文件/目录刷新和任务状态查询，复用 S3 凭据；修复 CDN `--paths` 参数未传入适配器的问题。\n\n### 2026-09-08\n\n- 修正 image-generation 官方 `gpt-image-2` 示例配置：移除不支持的 `input_fidelity`，改用尺寸规则放行合法 2K/4K 分辨率；新增直接读取示例配置的参数与尺寸边界回归测试。\n- 升级 image-generation skill v26.37.59：接入 API易兼容网关图片编辑（gpt-image-2-vip 多图融合/30 档锁尺寸、Grok Imagine 1–4 张参考图编辑、Nano Banana Gemini 原生协议编辑），示例配置新增 `apiyi` provider 与官方 `gpt-image-2` 模型条目；gpt-image-2 原生透明背景（preview）通过 `background` capability 声明，未声明该能力的模型（vip/Grok/Nano Banana/Seedream）由 policy 在请求前拦截 `--background` 并走 `remove-background`；adapter 新增 `send_n=false` 模型选项（vip 拒绝 n 参数）、`b64_json` 带 `data:` 前缀兼容，Gemini parts 调整为 text 优先以符合官方契约，`--background transparent` 不再强制要求显式 `--output-format`（API 默认 png）。\n- 升级 filebrowser skill v26.37.58：新增 `duration` 子命令，通过 `GET /api/media/metadata` 读取服务端媒体索引中的时长（整数秒），无需下载视频即可统计目录内视频总时长；支持 `--pattern`（fnmatch）按文件名过滤，如 `filebrowser duration --path /某项目/成片/480p/ --pattern '99*'`。索引可能滞后于新上传/覆盖文件，亚秒精度仍须下载后用 ffprobe 实测。\n\n### 2026-09-03\n\n- 新增 matting skill：直连 matting-api，实时读取状态与算法/模型能力，按输入图技术特征自动选择兼容组合并输出经验证的透明 PNG。\n- 升级 image-generation v26.36.56：新增 `remove-background`，matting 配置可用时优先调用独立 skill；配置缺失或服务不可用时明确回退现有 chroma-key，已探测可用后的任务失败不静默回退。\n- 修正更新记录时间排序：filebrowser v26.36.55（2026-09-01）条目此前误置于列表末尾，已按日期归位。\n\n### 2026-09-01\n- 升级 filebrowser skill v26.36.55：修复对 FileBrowser Quantum 服务端的 API 调用错误——`move` 改为 JSON body（items 携带 fromSource/fromPath/toSource/toPath）并增加客户端覆盖预检，`search` 迁移到 `/api/tools/search`（sources/scope 新格式），`preview` 迁移到 `/api/resources/preview` 并补 source 参数，`list-dir` 合并 folders/files 两个子项键；SKILL.md 新增\"服务端：FileBrowser Quantum\"章节明确 API 差异\n\n### 2026-08-30\n- 修复 jellyfin 多图片统一改名 poster 互相覆盖的问题：首图作 poster，其余移入 `extrafanart/fanartN.jpg`（rename 与 clean 均修复）\n- jellyfin rename 批量模式新增 `--exclude` 参数，可重复传递以跳过指定子目录\n- jellyfin 字幕文件在文件名与视频一致（或仅多语言标签）时跟随视频重命名，便于 Jellyfin 挂载\n- jellyfin SKILL.md 补充典型工作流注意事项：清理广告噪声文件夹名、`--imdb-id` 配合 `--title/--year` 防 OMDb 超时回退\n\n### 2026-08-14\n- 新增独立 object-storage skill：统一管理多个 S3 兼容 target、本地文件上传、SHA-256 条件覆盖与腾讯云 CDN；filebrowser 移除 boto3/CDN SDK 和 target 配置，改用稳定 CLI/JSON 接口委托 object-storage。\n\n### 2026-08-08\n- 新增 filebrowser skill 的腾讯云 CDN 缓存管理能力：支持刷新 URL（PurgeUrlsCache）、刷新目录（PurgePathCache）和预热（PushUrlsCache）三个独立功能，提供 `cdn purge-url`/`purge-path`/`prefetch` 子命令，可选在 upload 成功后自动刷新（`purge_on_upload`，失败不阻断上传）；凭据复用 target 的 AK/SK（需 CAM 授权），新增 `tencentcloud-sdk-python-cdn` 依赖（lazy import）\n\n### 2026-08-06\n- 修复 media-use 的 `ffmpeg_brand` 在 Windows 使用 `--target-mb` 时将两遍编码第一遍输出写入 `/dev/null` 的问题，改用 Python 跨平台空设备。\n- 调整 media-use 的 `ffmpeg_brand` 默认 Logo 尺寸：自动取输出画面短边的 30%，并保留 `--watermark-width` 显式覆盖。\n\n### 2026-08-03\n- 新增 filebrowser skill：将 FileBrowser Quantum 文件安全转存到多个 S3 兼容 bucket，支持环境变量凭据、覆盖保护、临时文件清理和新旧下载接口兼容\n\n### 2026-07-28\n- 统一视频下载到 Immich 的元数据交接：video-downloader 为抖音、微信视频号和 yt-dlp 视频生成公开字段白名单侧车，Immich 自动将标题、作者、平台、发布时间、时长、视频 ID、原始文案、话题和来源页写入 Description\n\n### 2026-07-20\n- 升级 media-use 至 v0.3.0：新增 `ffmpeg_brand`，支持图片水印、片尾拼接、统一分辨率与帧率、目标体积两遍编码、缺失音轨补静音及超限自动降码率重试\n\n### 2026-07-19\n- 新增 seedance-2-video：适配 Seedance 2.0 提示词、图生视频、参考视频、分镜和长视频方法论，统一使用 Sorb 模型 schema 与 Canvas Agent 工具\n- 修正 seedance-2-video 的 Canvas 参数约束：使用 `canvas_form` 的精确字段与 `select`/`aspect_ratio` 映射，避免把 Provider schema 结构键写入生成节点\n- 升级 image-generation 至 v26.29.14：移植系统 imagegen CLI 能力，拆分 OpenAI/Gemini/Seedream adapter，新增严格 endpoint 模型 allowlist、Gemini/Seedream 生成与编辑、Seedream 5.0 Pro 坐标交互会话、批量/重试/downscale/chroma-key 及离线与 live smoke 验证\n\n### 2026-07-16\n- 统一 video-downloader 输出目录：yt-dlp 下载默认按作者名或账号名建立子目录，与抖音、微信视频号保持一致；作者字段缺失时使用 `unknown-author`\n\n### 2026-07-15\n- 新增 `shared/agent-config`：统一 `agent_config.toml` 的四级查找顺序、显式路径、软硬缺失策略、配置示例及接入文档，供新 skill 复制复用\n- 优化微信视频号下载命名：文件名保留中文原始标题，移除话题、非法字符和符号字符，标题限制 30 字符；下载结果同时输出完整原始描述供 Immich 保存\n- 升级 immich skill：新增 `asset_time_source` 和 `--asset-time`，默认在元数据提取后将时间线时间修正为本次上传时间；单文件上传支持 `--description` 保存完整标题与话题\n\n### 2026-07-14\n- 升级 video-downloader skill：新增微信视频号 SPH 分享链接下载，通过本地 `wx_channels_download` API 解析；认证缺失或过期时使用专用 Playwright 浏览器自动刷新腾讯元宝 Cookie、重启服务并重试，下载文件按视频号昵称建立目录，兼容迁移旧根目录文件\n- 拆分下载与上传职责：immich 移除 `upload-url`、`yt-dlp` 和未使用的 `aiohttp` 依赖，只处理本地资源；网络下载统一由 video-downloader 完成并通过本地文件路径衔接\n- 升级 immich skill：为默认公开相册增加 `public_album_url` 配置，资源成功加入相册后返回并显示可匿名访问的资源链接；覆盖本地、批量和重复资源上传场景\n\n### 2026-07-12\n- 修复 immich skill：配置查找新增 `~/.agents/agent_config.toml` 最终兜底；统一约定 `base_url` 不含 `/api` 并由客户端自动追加，兼容旧配置且避免生成 `/api/api/assets`\n- 修复 video-downloader 的 `douyin_downloader_home` 配置，使检测、安装和运行统一使用该目录；路径支持 `~`、环境变量及相对 skill 目录的写法，并移除代码和说明中的机器相关绝对路径\n\n### 2026-07-04\n- 升级 media-use `ffmpeg_cut`：`-s/--start` 与 `-e/--end` 改为可选（二者至少传一个），省略 `-s` 表示从开头开始，省略 `-e` 表示裁剪到末尾，支持单端裁剪场景\n\n### 2026-07-04\n- 维护：从 git 索引移除 `.serena/`（`.gitignore` 早已有 `.serena/` 规则，但因 `.serena/.gitignore`、`.serena/project.yml` 仍被跟踪而失效），本地文件保留，后续 `.serena/` 修改不再进入版本控制\n- 修复 media-use `common.py`：ffmpeg 调用显式传入 `-y`，并新增对「Not overwriting / Error opening output file」的防御性检查，规避 ffmpeg 8.x 在非交互 stdin 下退出码为 0 却未写出文件的隐患\n\n### 2026-07-04\n- 升级 media-use skill：重构为统一 `media_use` 包结构，新增 3 个 ffmpeg 工具\n  - 新增 `ffmpeg_cut`：按起止时间无损裁剪视频片段（-c copy，支持 HH:MM:SS.ms / MM:SS / 秒数）\n  - 新增 `ffmpeg_merge`：合并编码一致的视频文件（concat demuxer + -c copy，ffprobe 自动一致性校验）\n  - 新增 `ffmpeg_fix`：修复 m3u 下载的 mp4（-c copy -movflags +faststart，支持文件 / 文件夹批量）\n  - `ffmpeg_batch` 迁移至 `media_use/convert.py`，命令行接口与行为完全不变\n  - 公共逻辑下沉到 `media_use/common.py`（ffprobe 探测、ffmpeg 封装、时间解析、目录安全检查）\n\n### 2026-07-01\n- 升级 video-downloader skill：整合 douyin-downloader 到内部（`.runtime/douyin-downloader`），新增 refresh-cookies、hot-board、search 命令\n- 移除 tencent-docs skill（不再维护）\n\n### 2026-06-16\n- 重构 spritesheet skill 抠图与裁剪流程：统一步骤编号，删除已废弃的 `--canvas-size` 参数\n- 新增抠图与裁剪流程参考文档 `references/pipeline.md`，详细记录 9 步流水线和抠图算法实现\n- 集成循环分析能力：新增主体感知全局接缝检测 `find_loop_point_global` 作为默认循环检测，突破旧 CV 法\"循环从第 0 帧开始\"与\"背景稀释 MSE\"两个局限\n- 新增 `--analyze` 诊断模式（输出 MSE 曲线/周期候选/质心轨迹/主体大小趋势报告）与 `--repack-dir` 删帧重打包模式\n- 代码拆分为 5 个子模块（`chroma`/`subject`/`loopdetect`/`analyze`/`repack`），旧 CV 帧差法保留为 `--from-frame-zero`\n- 新增 ui-extractor skill：从静态图片中提取 UI 元素，支持棋盘格 + chroma 两种背景去除，可选透视校正，复制 spritesheet 的 chroma 算法保持一致\n- 职责分离：spritesheet 移除 `--smart`（大模型循环分析），该能力迁至 video-analyzer——video-analyzer 新增 `--json` 结构化输出（自动附视频帧数/帧率/时长），循环分析 prompt 模板见 `video-analyzer/references/loop-analysis.md`\n\n### 2026-06-13\n- 重构 spritesheet skill `--smart` 模式：根据 API 端点自动选择视频传入方式\n  - 标准端点 `/api/v3`: 使用 `input_video` 直接传入视频（base64），平台按 fps=5 自动抽帧\n  - Coding plan `/api/coding/v3`: 使用 `input_image` 手动抽帧以图片方式传入\n  - 添加完整 API 文档注释（火山方舟 Responses API / Chat API）\n\n### 2026-06-11\n- 优化 spritesheet skill：改进 AI 循环区间分析提示词，增加视频元数据（总帧数、帧率、时长），添加运动描述字段，提升动画质量\n\n### 2026-06-10\n- 新增 spritesheet skill：从视频中提取帧生成 spritesheet 和独立透明 PNG，支持自动抠图、AI 智能分析循环区间\n- 升级 video-analyzer skill：新增 `agent_config.toml` 多 skill 共用配置支持，支持直接填写 API Key，提供四位置配置文件发现策略\n- 更新 `.gitignore`：新增 `temp/` 目录忽略\n\n### 2026-05-21\n- 升级 git-commit skill：\n  - 新增 Commit Message 规范，强制使用 Conventional Commits 格式并附加 AI 元数据（`Agent-Task`, `Agent-Model`, `Agent-Decision`, `Agent-Limitation`）作为 Git Trailers。\n  - 新增原子提交（Atomic Commits）规范与工作流，规范化逻辑独立的提交拆分。\n  - 新增“整理提交历史/PR准备”工作流，支持交互式变基（rebase/squash）的方案预览与用户确认流程。\n- 更新 `.gitignore`：加入 `.antigravitycli/` 目录以忽略本地 CLI 配置与运行缓存。\n\n### 2026-05-20\n- 新增 video-downloader skill：统一封装 `douyin-downloader` 与 `yt-dlp`，支持项目级/全局 `agent_config.toml` 配置回退，保留 `douyin-downloader` 原生 `config.yml` 作为底层运行配置\n- 更新 `.gitignore`：忽略项目级 `agent_config.toml` 与 `video-downloader/.runtime/`\n\n### 2026-05-01\n- 新增 jellyfin skill：Jellyfin 媒体库文件命名工具，支持解析 BT/字幕组命名风格，查询 OMDb API 获取 IMDB ID，按 Jellyfin 标准重命名电影和剧集文件夹及内部文件\n\n### 2026-04-03\n- 新增 immich skill：将图像和视频上传到 Immich 服务器，支持本地文件上传、远程 URL 下载上传、批量上传和 Album 管理\n\n### 2026-04-01\n- 新增 vikunja skill：Vikunja 任务管理工具，支持查看项目和任务，并将每周已完成的任务同步到 Joplin weekly 笔记\n\n### 2026-03-29\n- 新增 image-generation skill：AI 图片生成工具，支持多 provider（OpenAI/Gemini 兼容 API），支持模型列表查询和 prompt 优化\n\n### 2026-03-28\n- 升级 tencent-docs skill 到 v1.0.21：同步官方压缩包内容，新增 smartcanvas/diagram/slide/docengine/workflows 等参考文档，更新入口说明与版本元数据\n- 精简 git-commit skill：收紧触发描述，统一 CalVer/tag 工作流表述，并明确脚本定位规则\n\n### 2026-03-21\n- 新增 CLAUDE.md：为 Claude Code 创建项目规范执行手册，与 GEMINI.md 保持一致\n- 将所有 skills 通过符号链接注册到 ~/.claude/skills/，实现全局可用\n\n### 2026-03-19\n- 新增 joplin skill：用于通过 REST API 调用本地 Joplin 笔记库，支持笔记读写、搜索和笔记本管理\n\n### 2026-03-17\n- 新增 email skill：邮件处理工具（基于 IMAP），支持搜索、读取、下载附件和移动邮件\n- 升级 tencent-docs skill v1.0.13：重构 SKILL.md，新增 doc/（文档编辑与格式化）、sheet/（表格操作与 JS 脚本）模块，补充认证与管理 API 参考文档，增强 setup.sh\n- 升级 git-commit skill：重构工作流，使用 README.md 代替 CLAUDE.md 记录更新记录，并启用 GEMINI.md 作为规范说明文档\n\n### 2026-03-14\n- 新增 media-use skill：媒体处理工具集，包含 ffmpeg_batch 批量视频转码工具\n- 更新 README.md：添加 media-use skill 说明\n\n### 2026-03-11\n- 新增 tencent-docs skill：腾讯文档 MCP，提供完整的腾讯文档操作能力（创建、编辑、搜索文档）\n",
  "bytes": 18022,
  "sha": "9245d39d65ffe08b4cbc4e009620e874425fae50f206c10dece0a26fa3f928aa",
  "repo_slug": "zrong/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zrong_skills_feishu_image_7bc5ad88/readme"
}