zrong/skills

我的 AI Agent Skills 集合。

安装

# 安装所有 skills（全局）
npx skills add zrong/skills -g

# 安装到特定 agent
npx skills add zrong/skills --agent claude-code cursor openclaw

# 只安装特定 skill
npx skills add zrong/skills --skill git-commit

Skills

git-commit

Git 提交并打 CalVer 标签。

• 当用户说"提交"、“commit”、“打标签”、“tag”、"发版"时自动激活
• 自动计算 CalVer 版本号（YY.WW.MICRO 格式）
• 自动更新 README.md 记录变更

mcp-deploy

MCP 服务器自动部署工具。

• 当用户说"部署 MCP"、“安装 MCP”、"配置 MCP"时自动激活
• 支持智谱 MCP、Minimax MCP、Gitea MCP 等平台的自动配置
• 提供常用 MCP 的配置参考和部署流程

email

邮件处理工具（基于 IMAP）。搜索、读取、下载附件、移动邮件。

• 当用户需要查看、搜索、管理邮件、下载附件、移动归档邮件时自动激活
• 支持 IMAP 协议，提供完整的邮件管理能力
• 内置配置初始化工具，支持多账户管理
• 密码加密存储在本地 .env 文件中

feishu-image

通过飞书 (Lark) API 发送图片和截图。

• 当用户要求"截图发给我"或发送图片到飞书时自动激活
• 支持在 OpenClaw 中自动读取飞书配置
• 支持独立使用（通过环境变量配置）
• 提供 CLI 工具和 Node.js SDK

media-use

媒体处理工具集，基于 ffmpeg 提供视频转码、目标体积压缩、Logo 水印、片尾拼接、裁剪、合并和修复等功能。

• 当用户需要视频转码、格式转换、指定大小压缩、添加水印/Logo、追加片头片尾、音频处理、视频裁剪/剪辑、视频合并或修复 m3u 下载的损坏视频时自动激活
• ffmpeg_batch：批量视频转码（H.264、H.265/HEVC、AV1、VP9，支持 GPU 硬件加速）
• ffmpeg_cut：按起止时间无损裁剪视频片段（-c copy，支持 HH:MM:SS.ms / 秒数）
• ffmpeg_merge：合并编码一致的视频文件（concat demuxer + -c copy，自动一致性校验）
• ffmpeg_fix：修复 m3u 下载的 mp4（faststart，moov atom 前置，支持文件 / 文件夹批量）
• 支持 AAC、MP3、Opus、FLAC、AC3 等音频编码

video-downloader

统一视频下载工具，整合 douyin-downloader、wx_channels_download 与 yt-dlp 三种 backend。

• 当用户发来视频链接并要求下载，或提到 yt-dlp / douyin-downloader / 微信视频号 / 抖音短链时自动激活
• 支持抖音、微信视频号 SPH 分享链接，以及 yt-dlp 支持的网站视频下载
• 支持抖音热搜榜、搜索作品、刷新 Cookie
• 视频号认证失效时使用专用浏览器自动刷新腾讯元宝 Cookie，下载结果按视频号昵称归档
• douyin-downloader 已集成到 .runtime/douyin-downloader，无需外部安装

video-analyzer

使用视觉/视频大模型分析视频内容。

• 当用户说"分析视频"、“视频理解”、"看看这个视频"时自动激活
• 支持本地视频文件和互联网视频（直接 URL 及 YouTube/Bilibili 等站点）
• 支持抽帧分析和原生视频输入两种模式
• 多模型配置（豆包、GPT-4o 等 OpenAI 兼容 API）

seedance-2-video

为 Sorb 的 Seedance 2.0 视频生成提供提示词、素材分析和分镜方法。

• 当用户明确提出 Seedance 2.0、图生视频、参考视频复刻、运镜、分镜、视频延长或长视频规划时激活
• 支持图片与视频抽帧分析、四维运镜、美学约束、首帧设计和多镜头生产流程
• 使用 Sorb 模型 schema、@图像N 引用语义和 Canvas Agent 工具，不包含外部执行脚本

image-generation

AI 图片生成与编辑工具，通过独立 OpenAI、Gemini 原生和 Seedream adapter 调用图片 API。

• 当用户说"生成图片"、“改图”、“参考图编辑”、“封面图”、“Gemini 生图”、"Seedream"时自动激活
• endpoint 独立配置 adapter/base_url/key，并用精确模型 allowlist 与 capability policy 在请求前拦截越权调用
• 支持生成、mask/多参考图编辑、JSONL 并发、downscale、去背景和防覆盖输出
• 支持 Seedream 5.0 Pro 点选/框选坐标协议与可恢复的连续编辑 session
• 内置 API易聚合网关示例配置（gpt-image-2-vip、Grok Imagine、Nano Banana）；官方 gpt-image-2 支持原生透明背景，未声明该能力的模型统一走 remove-background 后处理
• 去背景时优先调用独立 matting skill；配置缺失或服务不可用时明确回退现有 chroma-key

matting

独立 matting-api 抠图工具，为本地图片自动选择算法并输出透明 PNG。

• 每次执行前读取服务状态、队列、实时 methods/models 与可证明兼容的组合
• 检查已有 alpha、边框颜色/均匀度、绿蓝幕和亮度分布，自动选择 BiRefNet、InSPyReNet、Luma 或 CorridorKey 组合
• 支持显式算法/模型、dry-run、异步任务轮询、透明 PNG 验证、原子写入和防覆盖
• 可由 image-generation 的 remove-background 统一入口调用

upscale

独立 upscale-api 图片与视频超分工具，支持本地文件和 FileBrowser 远端文件。

• 每次执行前读取服务健康、GPU/队列状态、实时模型能力与提交合同
• 内置最快（Real-CUGAN Pro x2）、标准（Real-ESRGAN x2plus）、高质量（SeedVR2 3B）三档，也支持精确模型名与实时能力建议
• 本地文件通过 multipart 上传，轮询任务终态，并返回 API 下载地址；可选下载并验证 PNG/MP4
• FileBrowser 文件复用独立 filebrowser skill 的 get/put，默认把按实际输出信息命名的结果回传到原目录
• 支持显式模型、upscale/enhance/resize 模式、图片倍率、视频倍率或目标尺寸、contain/cover 适配、RIFE 24→60 等精确补帧、视频时间范围、dry-run 和默认防覆盖
• 默认输出名包含实际尺寸、帧率和模型ID；视频使用输入名_1080p_60fps_模型.mp4，图像使用输入名_WxH_模型.png

object-storage

独立的 S3 兼容对象存储与 CDN 管理工具。

• 支持多个命名 target，以及 AWS S3、腾讯云 COS、阿里云 OSS、火山 TOS、MinIO 等兼容端点
• 上传单个本地文件或通过 upload-tree 递归上传目录，提供 dry-run、相对路径映射、 文件级并发、默认拒绝覆盖与上传后大小校验
• 支持 download 单对象下载和 download-tree 递归下载：默认防覆盖、临时文件原子落盘， 校验远端大小及可用的 SHA-256 metadata
• 支持 head 只读查询对象存在性及大小、类型、缓存策略、版本和摘要 metadata，无需下载正文
• 目录上传复用单对象传输实现和 target 客户端，批次完成后合并执行目录/通配符 CDN 刷新
• 支持显式设置 Cache-Control，覆盖对象时默认保留旧值，并在上传结果中回报实际对象头
• 使用 content-sha256 metadata 实现条件覆盖，并明确报告内容相同的文件列表
• 支持腾讯云 CDN URL/目录刷新、预热和上传后自动刷新
• 支持 Amazon CloudFront 文件/目录失效刷新与任务状态查询
• 支持火山引擎 CDN 文件/目录刷新、预热与任务状态查询

filebrowser

FileBrowser Quantum 文件管理与传输工具。

• 支持 Quantum V2 API key 认证，配置使用 api_key / api_key_env
• 支持多个 FileBrowser source、远程文件管理，以及 FileBrowser 与本地之间的 get/put
• upload 把远端文件流式暂存后委托给独立 object-storage，S3/CDN 配置不再重复维护
• 保留原有 target、覆盖、内容去重、CDN 和 JSON 命令接口，便于下游 Skill 平滑迁移
• 纯 FileBrowser 命令不依赖 object-storage

joplin

用于调用 Joplin REST API 读写笔记、查询笔记本、搜索内容等。

• 当用户需要查看、搜索、保存内容到 Joplin 时自动激活
• 支持通过命令行读写 Joplin 笔记（需要开启 Joplin Clipper 服务）
• 支持笔记搜索、内容获取、创建、列出笔记本等操作
• 从 agent_config.toml 的 api_key / api_key_env 读取 Web Clipper 授权密钥

immich

将图像和视频上传到 Immich 服务器。

• 当用户说"上传到 Immich"、“上传图片”、“备份照片”、“上传视频”、"下载视频并上传 Immich"时自动激活
• 只负责本地文件上传；网络资源先由 video-downloader 下载，再将本地路径交给 immich
• 支持批量上传、Album 管理、完整描述写入，并默认按本次上传时间排列资源
• 提供 Python SDK 和 CLI 工具

jellyfin

Jellyfin 媒体库命名与服务器维护工具。按 Jellyfin 标准重命名电影/剧集，并修复错误刮削。

• 当用户需要整理 Jellyfin 媒体库、重命名媒体文件夹、获取/校验 IMDB ID、修复海报不更新、纠正错误刮削时自动激活
• 支持解析 BT/字幕组命名风格（点分隔、中英混合、质量标记如 1080P.X264.AAC）
• clean：批量去除文件名中的空格，图片重命名为 poster 格式
• rename-folder：查询 OMDb API 获取 IMDB ID，重命名为 Movie (year) [imdbid-ttXXXX] 格式，支持电影和剧集；--imdb-id 先经 OMDb 反查验证防手填错
• rename-flat：平铺目录（多部电影共用一个目录，如 TopNNN. 前缀合集）批量重命名，带终审清单与 OMDb 缓存
• verify / retag：批量校验文件名中的 IMDB ID 并只替换标签修复错绑
• server refresh/images/identify/check：调用 Jellyfin API 刷新媒体库、诊断海报来源、重新识别错误刮削、比对 DB 元数据与文件名
• de-localart：清理本地旧海报/.nfo 让位在线刮削，可自动刷新库

vikunja

Vikunja 任务管理工具，将已完成任务同步到 Joplin weekly 笔记。

• 当用户需要查看 Vikunja 项目/任务、同步任务到 Joplin 时自动激活
• 支持列出项目和任务（按项目、完成状态、周过滤）
• 支持将指定周的已完成任务同步到 Joplin GTD 笔记本的 weekly 笔记
• 自动去重，带 [x] 标记已完成任务

spritesheet

从视频中提取帧生成 spritesheet 和独立透明 PNG。

• 当用户说"制作 spritesheet"、“视频转精灵图”、“提取动画帧”、“sprite sheet”、"循环动画"时自动激活
• 支持自动检测背景色（绿幕/蓝幕/白幕/黑幕）并抠图
• 默认主体感知全局接缝检测（主体 mask 内全局搜索最优循环接缝），支持 --analyze 诊断与 --repack-dir 删帧重打包
• 输出独立透明 PNG、合并 spritesheet 和可交互的动画播放器

ui-extractor

从静态图片中提取前景元素并分离 UI 组件。

• 当用户说"提取 UI 元素"、“分离组件”、“去除背景”、“棋盘格背景”、“绿幕抠图”、"checkerboard 抠图"时自动激活
• 支持棋盘格背景去除（自动检测 + 透视校正）和关键色抠图（绿/蓝/白/黑）
• chroma 算法直接复用 spritesheet skill 的核心（保持一致性）
• 输出透明背景 PNG、分离的 UI 元素 PNG、元数据 JSON

dns-manager

DNS 解析记录管理工具（腾讯云 DNSPod，可扩展多服务商）。

• 当用户说"DNS"、“域名解析”、“A 记录”、“CNAME”、“添加/删除解析”、“把域名指向某 IP”、"DNSPod"时自动激活
• 幂等的 list / upsert / delete（unchanged / skipped 明确区分，重复执行无副作用），写操作支持 --dry-run
• 纯标准库实现 TC3-HMAC-SHA256 签名直连腾讯云 OpenAPI，无第三方依赖
• Provider 抽象 + registry，后续新增 aliyun/cloudflare 只需实现 DnsProvider 子类并注册
• 凭据优先从环境变量读取（TENCENTCLOUD_SECRET_ID/KEY），复用 shared/agent-config 模板

共享开发资源

• shared/agent-config：agent_config.toml 的跨平台查找、全局兜底、显式路径、配置示例和测试模板。创建新 skill 时复制实现，运行时不依赖仓库共享目录。

更新记录

2026-10-29

• 升级 shared/agent-config 共享模板：新增 find_skill_dir 与 find_skill_scripts 跨 Skill 统一查找能力（支持环境变量 _SKILL_DIR、项目级 .agents/.claude/skills 与全局 ~/.agents/~/.claude/skills 优先级解析及软链跟随），补充单元测试与 GitHub 子目录依赖说明。
• 统一 AGENTS.md 规范：强制要求 Python 3.13+（requires-python = ">=3.13" 并通过 uv run 运行），新增 $PWD/outputs/ 与 $PWD/outputs/tmp/ 输出隔离规范、幂等性要求及中英文文档规范，并在 .gitignore 中忽略 outputs/。

2026-10-11

• 统一 immich、jellyfin、video-analyzer 的空 API key 示例，清理 immich、jellyfin 不受支持的顶层元数据；Immich 命令提示保存在 metadata 中。
• 移除 jellyfin 的旧 omdb_api_key 配置别名，提示迁移至 [jellyfin.omdb].api_key，并验证服务端与 OMDb 密钥保持独立。
• 统一 vikunja 的 api_key / api_key_env 配置，补齐独立模板、环境变量读取、全局配置兜底、无交互入口和回归测试。
• 统一 joplin 的 api_key / api_key_env 配置，补齐独立模板、环境变量读取、全局配置兜底、无交互入口和回归测试；Joplin 请求保留协议规定的 token 参数。
• 更新 AGENTS.md 与 shared/agent-config 共享模板：明确静态 API 密钥命名、环境变量字段、第三方协议和其他凭据类型的边界。
• 统一 filebrowser 的 API key 配置为 api_key / api_key_env，移除密码配置并提示旧字段迁移，同步脚本、模板和文档。
• 修复 filebrowser 的 Quantum V2 API 适配：移除旧下载回退，分块上传复用每次上传独立的 session ID，source 列表改用账户可见接口，补充回归测试。

2026-10-09

• 升级 immich skill：新增批量视觉打标工作流。tag-fetch（批量下载缩略图）、tags-ensure（幂等建中文 tag 字典）、tag-apply（应用打标决策，tag 分块写入逐条校验，description 仅在为空时写入）、tag-verify（decisions 与服务端现状全量 diff，收尾必跑）；配套 references/tagging-playbook.md 给出逐资产（≤数千）与按目录簇采样（上万）两条流水线；排障文档新增 Tags API（§9）、只读外部库元数据写入静默回滚（§10）、Partner sharing 范围（§11）；脚本与文档全面中文化。
• 升级 video-downloader skill：「与 Immich 组合」流程补充可选第 6 步——上传后用 immich 批量打标命令给视频打中文 tag 或标记「建议删除」。

2026-10-02

• 升级 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 个单测。

2026-09-27

• 升级 jellyfin skill：新增 lookup（即席查号：imdbid 反查 / tmdbid 补全 / OMDb+RemoteSearch 双通道标题搜索）、dupes（跨目录查重，采样哈希秒级确认同一文件，ffprobe 画质对比给出保留建议）、move（电影整组搬移：视频+旁挂文件，与 dupes 联动做隔离）；RemoteSearch 裸调用收敛为 _jellyfin_search_raw；CJK 噪声词按长度降序剥离（修「西班牙语→牙语」类残留）并补「双字幕」；平铺分组与对账排除 ._ AppleDouble 元数据文件。全部命令在 Jellyfin 12.1 上实测通过（鉴权头 / RemoteSearch / Refresh / Apply 均无 API 破坏性变更）。

2026-09-26

• 升级 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 重写并收录实战教训。
• jellyfin 实战加固：OMDb 配额耗尽/网络故障时不再整批退出，自动降级 Jellyfin RemoteSearch（TMDb 支持中文标题）并按标题/年份可信度校验命中，复用文件名已有的 [imdbid-]/[tmdbid-] 标签；BT 命名解析强化（中文质量词/英文分辨率编码噪声清洗、括号与粘连年份、国家/地区/复制副本标记剥除）并支持多 CD/多碟电影 - cdN 堆叠命名；verify 跳过 SMB 8.3 短文件名与 ._ AppleDouble 元数据防止误判孤儿文件。

2026-09-22

• object-storage 新增 download、download-tree 与 head：支持单对象和递归下载、 本地覆盖保护、临时文件原子落盘、大小及可用 SHA-256 校验，以及不下载正文的对象元数据查询。

2026-09-20

• object-storage 新增 upload-tree：默认递归上传目录、保留相对路径、复用单对象上传实现和 target 客户端，支持文件级并发、批量覆盖预检、结果汇总及目录优先的合并 CDN 刷新。
• object-storage 上传支持 --cache-control，覆盖时默认保留已有缓存策略，防止入口文件的 no-cache,max-age=0,must-revalidate 被覆盖清除，并回报上传后实际对象头。
• object-storage 接入火山引擎 CDN：支持文件与目录刷新、预热、任务状态查询，并可复用 TOS target 的 AK/SK。
• object-storage 主说明补充 Amazon CloudFront 与火山引擎 CDN 的刷新、预热和任务查询能力。
• 明确项目版本记录规则：以 Git CalVer tag 为唯一正式版本，按 Git 历史推导单 Skill 版本，不在 SKILL.md 重复维护版本号。

2026-09-18

• 升级 upscale skill：支持视频 upscale/enhance/resize 明确处理模式、1080p 原尺寸增强、Lanczos 缩放，以及 RIFE 4.25/4.25 Lite 目标帧率补帧；按实时输入帧率校验120fps和4倍上限，并同步hc88的20秒人物样本速度与显存基线
• 统一 upscale 默认结果命名：本地运行和FileBrowser回传均根据实际输出尺寸、实际帧率和模型ID生成文件名，显式指定输出路径时仍保留调用方名称
• 增加 upscale CLI 的 cancel ：支持取消排队或运行中的任务，并可用 --wait 等待取消、完成或失败终态

2026-09-17

• 新增 upscale skill：直连 upscale-api 对本地或 FileBrowser 图片/视频执行超分，内置最快/标准/高质量三档并支持精确模型与实时能力建议；视频可按 2×/4× 或目标尺寸输出，并支持 contain/cover 适配；FileBrowser 结果默认回传至源文件同目录。

2026-09-15

• 新增 dns-manager skill：腾讯云 DNSPod 解析记录的幂等管理（list/upsert/delete + dry-run），纯标准库 TC3 签名，Provider 抽象预留多服务商扩展；已通过单元测试与真实 API 全路径验证
• git-commit 明确提交与历史整理的授权边界、部分步骤受阻时的处理方式，以及原子提交的实际文件树验证要求。
• object-storage 统一 AWS/腾讯云优先目录刷新策略，补充 CloudFront 每月 1000 个失效路径免费规则、跨分配合计与通配符计数，并区分腾讯云目录刷新额度。
• object-storage 新增 AWS CloudFront 配置、文件/目录刷新和任务状态查询，复用 S3 凭据；修复 CDN --paths 参数未传入适配器的问题。

2026-09-08

• 修正 image-generation 官方 gpt-image-2 示例配置：移除不支持的 input_fidelity，改用尺寸规则放行合法 2K/4K 分辨率；新增直接读取示例配置的参数与尺寸边界回归测试。
• 升级 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）。
• 升级 filebrowser skill v26.37.58：新增 duration 子命令，通过 GET /api/media/metadata 读取服务端媒体索引中的时长（整数秒），无需下载视频即可统计目录内视频总时长；支持 --pattern（fnmatch）按文件名过滤，如 filebrowser duration --path /某项目/成片/480p/ --pattern '99*'。索引可能滞后于新上传/覆盖文件，亚秒精度仍须下载后用 ffprobe 实测。

2026-09-03

• 新增 matting skill：直连 matting-api，实时读取状态与算法/模型能力，按输入图技术特征自动选择兼容组合并输出经验证的透明 PNG。
• 升级 image-generation v26.36.56：新增 remove-background，matting 配置可用时优先调用独立 skill；配置缺失或服务不可用时明确回退现有 chroma-key，已探测可用后的任务失败不静默回退。
• 修正更新记录时间排序：filebrowser v26.36.55（2026-09-01）条目此前误置于列表末尾，已按日期归位。

2026-09-01

• 升级 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 差异

2026-08-30

• 修复 jellyfin 多图片统一改名 poster 互相覆盖的问题：首图作 poster，其余移入 extrafanart/fanartN.jpg（rename 与 clean 均修复）
• jellyfin rename 批量模式新增 --exclude 参数，可重复传递以跳过指定子目录
• jellyfin 字幕文件在文件名与视频一致（或仅多语言标签）时跟随视频重命名，便于 Jellyfin 挂载
• jellyfin SKILL.md 补充典型工作流注意事项：清理广告噪声文件夹名、--imdb-id 配合 --title/--year 防 OMDb 超时回退

2026-08-14

• 新增独立 object-storage skill：统一管理多个 S3 兼容 target、本地文件上传、SHA-256 条件覆盖与腾讯云 CDN；filebrowser 移除 boto3/CDN SDK 和 target 配置，改用稳定 CLI/JSON 接口委托 object-storage。

2026-08-08

• 新增 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）

2026-08-06

• 修复 media-use 的 ffmpeg_brand 在 Windows 使用 --target-mb 时将两遍编码第一遍输出写入 /dev/null 的问题，改用 Python 跨平台空设备。
• 调整 media-use 的 ffmpeg_brand 默认 Logo 尺寸：自动取输出画面短边的 30%，并保留 --watermark-width 显式覆盖。

2026-08-03

• 新增 filebrowser skill：将 FileBrowser Quantum 文件安全转存到多个 S3 兼容 bucket，支持环境变量凭据、覆盖保护、临时文件清理和新旧下载接口兼容

2026-07-28

• 统一视频下载到 Immich 的元数据交接：video-downloader 为抖音、微信视频号和 yt-dlp 视频生成公开字段白名单侧车，Immich 自动将标题、作者、平台、发布时间、时长、视频 ID、原始文案、话题和来源页写入 Description

2026-07-20

• 升级 media-use 至 v0.3.0：新增 ffmpeg_brand，支持图片水印、片尾拼接、统一分辨率与帧率、目标体积两遍编码、缺失音轨补静音及超限自动降码率重试

2026-07-19

• 新增 seedance-2-video：适配 Seedance 2.0 提示词、图生视频、参考视频、分镜和长视频方法论，统一使用 Sorb 模型 schema 与 Canvas Agent 工具
• 修正 seedance-2-video 的 Canvas 参数约束：使用 canvas_form 的精确字段与 select/aspect_ratio 映射，避免把 Provider schema 结构键写入生成节点
• 升级 image-generation 至 v26.29.14：移植系统 imagegen CLI 能力，拆分 OpenAI/Gemini/Seedream adapter，新增严格 endpoint 模型 allowlist、Gemini/Seedream 生成与编辑、Seedream 5.0 Pro 坐标交互会话、批量/重试/downscale/chroma-key 及离线与 live smoke 验证

2026-07-16

• 统一 video-downloader 输出目录：yt-dlp 下载默认按作者名或账号名建立子目录，与抖音、微信视频号保持一致；作者字段缺失时使用 unknown-author

2026-07-15

• 新增 shared/agent-config：统一 agent_config.toml 的四级查找顺序、显式路径、软硬缺失策略、配置示例及接入文档，供新 skill 复制复用
• 优化微信视频号下载命名：文件名保留中文原始标题，移除话题、非法字符和符号字符，标题限制 30 字符；下载结果同时输出完整原始描述供 Immich 保存
• 升级 immich skill：新增 asset_time_source 和 --asset-time，默认在元数据提取后将时间线时间修正为本次上传时间；单文件上传支持 --description 保存完整标题与话题

2026-07-14

• 升级 video-downloader skill：新增微信视频号 SPH 分享链接下载，通过本地 wx_channels_download API 解析；认证缺失或过期时使用专用 Playwright 浏览器自动刷新腾讯元宝 Cookie、重启服务并重试，下载文件按视频号昵称建立目录，兼容迁移旧根目录文件
• 拆分下载与上传职责：immich 移除 upload-url、yt-dlp 和未使用的 aiohttp 依赖，只处理本地资源；网络下载统一由 video-downloader 完成并通过本地文件路径衔接
• 升级 immich skill：为默认公开相册增加 public_album_url 配置，资源成功加入相册后返回并显示可匿名访问的资源链接；覆盖本地、批量和重复资源上传场景

2026-07-12

• 修复 immich skill：配置查找新增 ~/.agents/agent_config.toml 最终兜底；统一约定 base_url 不含 /api 并由客户端自动追加，兼容旧配置且避免生成 /api/api/assets
• 修复 video-downloader 的 douyin_downloader_home 配置，使检测、安装和运行统一使用该目录；路径支持 ~、环境变量及相对 skill 目录的写法，并移除代码和说明中的机器相关绝对路径

2026-07-04

• 升级 media-use ffmpeg_cut：-s/--start 与 -e/--end 改为可选（二者至少传一个），省略 -s 表示从开头开始，省略 -e 表示裁剪到末尾，支持单端裁剪场景

2026-07-04

• 维护：从 git 索引移除 .serena/（.gitignore 早已有 .serena/ 规则，但因 .serena/.gitignore、.serena/project.yml 仍被跟踪而失效），本地文件保留，后续 .serena/ 修改不再进入版本控制
• 修复 media-use common.py：ffmpeg 调用显式传入 -y，并新增对「Not overwriting / Error opening output file」的防御性检查，规避 ffmpeg 8.x 在非交互 stdin 下退出码为 0 却未写出文件的隐患

2026-07-04

• 升级 media-use skill：重构为统一 media_use 包结构，新增 3 个 ffmpeg 工具
  • 新增 ffmpeg_cut：按起止时间无损裁剪视频片段（-c copy，支持 HH:MM:SS.ms / MM:SS / 秒数）
  • 新增 ffmpeg_merge：合并编码一致的视频文件（concat demuxer + -c copy，ffprobe 自动一致性校验）
  • 新增 ffmpeg_fix：修复 m3u 下载的 mp4（-c copy -movflags +faststart，支持文件 / 文件夹批量）
  • ffmpeg_batch 迁移至 media_use/convert.py，命令行接口与行为完全不变
  • 公共逻辑下沉到 media_use/common.py（ffprobe 探测、ffmpeg 封装、时间解析、目录安全检查）

2026-07-01

• 升级 video-downloader skill：整合 douyin-downloader 到内部（.runtime/douyin-downloader），新增 refresh-cookies、hot-board、search 命令
• 移除 tencent-docs skill（不再维护）

2026-06-16

• 重构 spritesheet skill 抠图与裁剪流程：统一步骤编号，删除已废弃的 --canvas-size 参数
• 新增抠图与裁剪流程参考文档 references/pipeline.md，详细记录 9 步流水线和抠图算法实现
• 集成循环分析能力：新增主体感知全局接缝检测 find_loop_point_global 作为默认循环检测，突破旧 CV 法"循环从第 0 帧开始"与"背景稀释 MSE"两个局限
• 新增 --analyze 诊断模式（输出 MSE 曲线/周期候选/质心轨迹/主体大小趋势报告）与 --repack-dir 删帧重打包模式
• 代码拆分为 5 个子模块（chroma/subject/loopdetect/analyze/repack），旧 CV 帧差法保留为 --from-frame-zero
• 新增 ui-extractor skill：从静态图片中提取 UI 元素，支持棋盘格 + chroma 两种背景去除，可选透视校正，复制 spritesheet 的 chroma 算法保持一致
• 职责分离：spritesheet 移除 --smart（大模型循环分析），该能力迁至 video-analyzer——video-analyzer 新增 --json 结构化输出（自动附视频帧数/帧率/时长），循环分析 prompt 模板见 video-analyzer/references/loop-analysis.md

2026-06-13

• 重构 spritesheet skill --smart 模式：根据 API 端点自动选择视频传入方式
  • 标准端点 /api/v3: 使用 input_video 直接传入视频（base64），平台按 fps=5 自动抽帧
  • Coding plan /api/coding/v3: 使用 input_image 手动抽帧以图片方式传入
  • 添加完整 API 文档注释（火山方舟 Responses API / Chat API）

2026-06-11

• 优化 spritesheet skill：改进 AI 循环区间分析提示词，增加视频元数据（总帧数、帧率、时长），添加运动描述字段，提升动画质量

2026-06-10

• 新增 spritesheet skill：从视频中提取帧生成 spritesheet 和独立透明 PNG，支持自动抠图、AI 智能分析循环区间
• 升级 video-analyzer skill：新增 agent_config.toml 多 skill 共用配置支持，支持直接填写 API Key，提供四位置配置文件发现策略
• 更新 .gitignore：新增 temp/ 目录忽略

2026-05-21

• 升级 git-commit skill：
  • 新增 Commit Message 规范，强制使用 Conventional Commits 格式并附加 AI 元数据（Agent-Task, Agent-Model, Agent-Decision, Agent-Limitation）作为 Git Trailers。
  • 新增原子提交（Atomic Commits）规范与工作流，规范化逻辑独立的提交拆分。
  • 新增“整理提交历史/PR准备”工作流，支持交互式变基（rebase/squash）的方案预览与用户确认流程。
• 更新 .gitignore：加入 .antigravitycli/ 目录以忽略本地 CLI 配置与运行缓存。

2026-05-20

• 新增 video-downloader skill：统一封装 douyin-downloader 与 yt-dlp，支持项目级/全局 agent_config.toml 配置回退，保留 douyin-downloader 原生 config.yml 作为底层运行配置
• 更新 .gitignore：忽略项目级 agent_config.toml 与 video-downloader/.runtime/

2026-05-01

• 新增 jellyfin skill：Jellyfin 媒体库文件命名工具，支持解析 BT/字幕组命名风格，查询 OMDb API 获取 IMDB ID，按 Jellyfin 标准重命名电影和剧集文件夹及内部文件

2026-04-03

• 新增 immich skill：将图像和视频上传到 Immich 服务器，支持本地文件上传、远程 URL 下载上传、批量上传和 Album 管理

2026-04-01

• 新增 vikunja skill：Vikunja 任务管理工具，支持查看项目和任务，并将每周已完成的任务同步到 Joplin weekly 笔记

2026-03-29

• 新增 image-generation skill：AI 图片生成工具，支持多 provider（OpenAI/Gemini 兼容 API），支持模型列表查询和 prompt 优化

2026-03-28

• 升级 tencent-docs skill 到 v1.0.21：同步官方压缩包内容，新增 smartcanvas/diagram/slide/docengine/workflows 等参考文档，更新入口说明与版本元数据
• 精简 git-commit skill：收紧触发描述，统一 CalVer/tag 工作流表述，并明确脚本定位规则

2026-03-21

• 新增 CLAUDE.md：为 Claude Code 创建项目规范执行手册，与 GEMINI.md 保持一致
• 将所有 skills 通过符号链接注册到 ~/.claude/skills/，实现全局可用

2026-03-19

• 新增 joplin skill：用于通过 REST API 调用本地 Joplin 笔记库，支持笔记读写、搜索和笔记本管理

2026-03-17

• 新增 email skill：邮件处理工具（基于 IMAP），支持搜索、读取、下载附件和移动邮件
• 升级 tencent-docs skill v1.0.13：重构 SKILL.md，新增 doc/（文档编辑与格式化）、sheet/（表格操作与 JS 脚本）模块，补充认证与管理 API 参考文档，增强 setup.sh
• 升级 git-commit skill：重构工作流，使用 README.md 代替 CLAUDE.md 记录更新记录，并启用 GEMINI.md 作为规范说明文档

2026-03-14

• 新增 media-use skill：媒体处理工具集，包含 ffmpeg_batch 批量视频转码工具
• 更新 README.md：添加 media-use skill 说明

2026-03-11

• 新增 tencent-docs skill：腾讯文档 MCP，提供完整的腾讯文档操作能力（创建、编辑、搜索文档）