前言¶
家庭录像、旅行素材、活动记录往往动辄数小时，人工筛片段、剪集锦成本高。通用剪辑工具能切时间轴，却很难按「孩子出镜」「某只宠物」「风景镜头」这类语义目标自动找段并汇总。下面介绍 SkillHub 社区技能 Time-Lapse Album Custom Summarization Skill（时光相册自定义浓缩分析技能）：在 Agent 对话里提供视频路径或 URL，并说明提取目标，由技能调用后端分析服务完成识别、片段提取与浓缩报告输出；需要回顾以往任务时，通过固定脚本从云端拉取历史报告列表，而不是依赖本地记忆拼凑。
这是什么¶
时光相册自定义浓缩分析技能 是面向图片/视频智能分析的 Agent Skill，坐标为 @user_bb47e3e3/custom-timelapse-analysis，在 SkillHub 上归类为 design-media，来源为社区（community），发布者为 user_bb47e3e3。当前 SkillHub 页面标注版本为 v1.0.6。
官方简介（中英一致）：基于指定关键词或目标，从长视频中提取相关片段，整理生成时光相册浓缩集锦（condensed album highlights）。
技能内场景码为 CUSTOM_TIMELAPSE；与开放平台分析场景对应的代码在接口文档中记为 OPEN_CUSTOM_TIMELAPSE_ANALYSIS。
核心功能¶
以下能力均来自技能包内 SKILL.md 与配套脚本说明，已核对：
- 目标识别与片段提取：根据用户用自然语言描述的提取目标（
--text），对本地文件或网络视频进行分析。 - 浓缩集锦生成：将匹配片段整理为时光相册式汇总，输出结构化分析报告及报告链接。
- 多类输入：支持图片、视频、本地路径与网络 URL；网络地址由 API 服务侧下载，技能说明中不要求 Agent 先把公网文件拉到本地。
- 历史报告查询：用户表达「查看历史浓缩报告」「浓缩报告清单」等意图时，须执行
python -m scripts.custom_timelapse --list，仅从云端接口获取列表，并以 Markdown 表格等形式展示（禁止从本地 memory 或长期记忆伪造清单）。 - 身份处理：用户身份由脚本在内部自动初始化或复用缺省用户，不向用户索要或展示身份标识。
能力范围表中列出的四项为：目标识别、片段提取、精彩内容浓缩、自定义集锦生成。
安装与启用¶
技能遵循通用 SKILL.md 格式。SkillHub 页面给出的安装指引为：参考 SkillHub 安装文档，安装坐标 @user_bb47e3e3/custom-timelapse-analysis。
安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按官方文档执行完整安装（示例为文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。常用路径如下（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 替换为实际路径）：
skillhub install @user_bb47e3e3/custom-timelapse-analysis --dir <skills 目录>
SkillHub 元数据标签为 requires_api_key=false，表示在 SkillHub 侧不要求用户单独配置商店 API Key；技能运行仍依赖其后端分析服务（接口文档说明为 API Key 鉴权，由 smyx_common 等内置配置管理）。
运行依赖¶
技能声明的 Python 依赖：
requests>=2.28.0
执行分析或查询历史报告时，需要在技能根目录下调用模块 scripts.custom_timelapse。
典型用法¶
在对话中触发¶
技能说明中的触发条件包括：
- 用户需要从视频中按特定目标生成时光浓缩相册时，可默认触发；
- 明确提到时光相册、视频浓缩、提取片段、自定义集锦、关键词提取等，并已提供视频；
- 查询历史报告时，命中「查看历史浓缩报告」「时光相册报告清单」等表述时走
--list流程。
命令行示例¶
下列示例来自技能 SKILL.md，路径与 URL 需替换为真实资源：
# 本地视频 + 提取目标描述
python -m scripts.custom_timelapse --input /path/to/vacation.mp4 --text "提取所有孩子出镜的片段"
# 网络视频 URL
python -m scripts.custom_timelapse --url https://example.com/family.mp4 --text "只提取风景镜头"
# 云端历史浓缩报告列表
python -m scripts.custom_timelapse --list
# 精简输出
python -m scripts.custom_timelapse --input video.mp4 --text "提取车的片段" --detail basic
# 结果写入文件
python -m scripts.custom_timelapse --input video.mp4 --text "提取狗的片段" --output result.json
常用参数摘要：
| 参数 | 作用 |
|---|---|
--input |
本地视频路径 |
--url |
网络视频地址 |
--text |
自定义提取目标/关键词描述 |
--list |
查询历史时光相册浓缩分析报告（可按文档支持日期过滤） |
--detail |
basic / standard / json，默认 json |
--output |
可选，将结果写入文件 |
--api-url |
可选，覆盖默认 API 服务地址 |
技能演示页（官方 SKILL 内链接）：https://lifeemergence.com/sample.html
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里处理长视频、按人物/宠物/场景/事件等语义目标做集锦的创作者或家庭用户；
- 希望历史浓缩任务可重复查询、且清单以云端为准的团队或个人。
限制与注意
- 视频格式：技能说明支持
mp4/avi/mov，单文件最大 500MB。 - 须使用技能自带脚本，禁止临时拼脚本替代
scripts.custom_timelapse。 - 分析结果仅供整理参考，需注意个人隐私。
- 历史报告列表必须走
--list与云端 API，不得用本地会话记忆代替。 - SkillHub 统计（抓取时）：评分 100000，下载约 718 次，安装 2 次；社区技能，使用前请自行评估服务可用性与合规要求。
结尾¶
时光相册自定义浓缩分析技能 把「长视频 + 提取目标描述」收敛成可重复的 Agent 工作流：分析走 custom_timelapse 模块，历史清单走云端查询。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_bb47e3e3/custom-timelapse-analysis
- API 入口（Skill 线索中的官方地址）：https://api.skillhub.cn/user_bb47e3e3/custom-timelapse-analysis
