Timeline 时间线技能

功能描述

将文件或目录中的内容解析为时间线事件，生成交互式时间线可视化 HTML 页面。

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, request_user_input, clarify, ask_user, or any equivalent.
Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.

Script Directory

Agent Execution: Determine this SKILL.md directory as {baseDir}. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

| Script | Purpose | |--------|---------| | scripts/main.ts | Main entry point |

触发条件

当用户提及以下关键词时触发：

timeline
时间线
时间轴
历史事件

支持的输入类型

单个文件
多个文件
单个目录

处理流程

Step 1: 收集输入

接收文件路径或目录作为输入。支持多个输入。

Step 2: 文件分类处理

纯文本类 (txt, html, md)

脚本自动解析文本中的时间事件：

日文格式：匹配 YYYY年MM月DD日、YYYY年MM月、YYYY年
英文格式：匹配 年份 + 描述 的段落（如 "1980 A missing slice..."）
HTML 文件会先剥离标签再解析
无法解析时间则跳过该文件：时间线必须有时间和事件，纯地点/无时间的数据不纳入

图片、视频类

读取文件元信息，使用创建时间和最后修改时间作为时间范围，直接显示图片或视频播放器。

其他类

读取文件元信息，显示文件名、大小等元数据。

Step 3: 合并事件

所有输入文件的事件合并为一个时间线，按日期排序。

Step 4: 生成时间线HTML

使用 TimelineJS3 生成交互式时间线页面，顶部显示标题栏。

Usage

${BUN_X} {baseDir}/scripts/main.ts <input> [input2] ... [options]

Options:

| Option | Description | Default | |--------|-------------|---------| | --output <path> | Output HTML file path | timeline.html | | --title <text> | Timeline title | 时间线 | | --llm-events-file <path> | JSON file with externally extracted events | — |

Examples:

# 处理单个文件
${BUN_X} {baseDir}/scripts/main.ts article.md

# 处理目录
${BUN_X} {baseDir}/scripts/main.ts ./documents/

# 处理多个文件
${BUN_X} {baseDir}/scripts/main.ts file1.txt file2.md --output my_timeline.html --title "项目时间线"

# 处理 URL（Agent 先抓取保存为文件）
${BUN_X} {baseDir}/scripts/main.ts ./temp/url_content.txt --title "网页时间线"

Output

File location: Current working directory.

JSON output to stdout:

{
  "success": true,
  "message": "时间线已生成",
  "outputPath": "/path/to/timeline.html",
  "eventsCount": 10
}