生活事件追踪 - 免费版
概述
生活事件追踪工具免费版帮助个人用户记录与回顾生活中的重要事件。提供三种记录模式,从简单的要点记录到详细的故事叙述,灵活适配不同场景。所有数据存储在本地,保护隐私.
核心能力
1. 三种记录模式
- 简单模式:一句话记录事件
- 详细模式:结构化记录(时间/地点/人物/感受)
- 故事模式:自由叙述完整故事
处理: 解析三种记录模式的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回三种记录模式的响应数据,包含状态码、结果和日志.
2. 事件分类
按类别(工作/生活/学习/旅行/健康)分类管理事件.
处理: 解析事件分类的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回事件分类的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
3. 标签系统
为事件添加自定义标签,便于后续检索.
处理: 解析标签系统的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回标签系统的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
4. 时间线回顾
按时间顺序回顾事件,支持按月/季/年查看.
处理: 解析时间线回顾的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回时间线回顾的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
5. 关键词搜索
全文搜索历史事件,快速定位记录.
处理: 解析关键词搜索的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回关键词搜索的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
6. 数据导出
导出为 Markdown 报告,便于分享与归档.
处理: 解析数据导出的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回数据导出的响应数据,包含状态码、结果和日志.
技术参数:使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式.
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:个人生活事件追踪、支持三种模式记录、与回顾、适合个人时间管理、工具免费版、面向个人用户的时、间记录与回顾等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
使用场景
场景一:记录工作里程碑
使用详细模式记录工作中的重要事件. 用户可通过自然语言指令触发此场景,工具将自动执行相应操作并返回结构化结果.
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 生活事件追踪-免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
# 记录事件(详细模式)
python3 tardis.py add \
--mode detailed \
--category "工作" \
--title "项目上线" \
--date "2025-01-15" \
--location "公司" \
--people "团队全员" \
--feeling "兴奋且疲惫" \
--details "经过3个月开发,核心项目终于上线。团队通宵部署,早上8点正式发布。"
# ...
# 输出:
# 事件已记录
# ID: evt-2025-0015
# 标题: 项目上线
# 日期: 2025-01-15
# 类别: 工作
场景二:简单模式快速记录
用简单模式快速记录日常事件.
# 快速记录
python3 tardis.py add \
--mode simple \
--category "生活" \
--title "学会了做红烧肉" \
--tags "烹饪,新技能"
# ...
# 批量快速记录
python3 tardis.py batch-add \
--file events.txt \
--mode simple
# ...
# events.txt 格式:
# 2025-01-15|生活|学会了做红烧肉|烹饪,新技能
# 2025-01-16|健康|跑步5公里|运动
# 2025-01-17|学习|读完《深入理解计算机系统》|阅读
场景三:时间线回顾
按时间线回顾过去的事件.
# 查看本月时间线
python3 tardis.py timeline \
--period "2025-01" \
--category "all"
# ...
# 输出:
# === 2025年1月时间线 ===
# 01-03 [工作] 新年第一个工作日,制定年度计划
# 01-08 [学习] 开始学习 Rust 语言
# 01-10 [生活] 和朋友聚餐,庆祝生日
# 01-15 [工作] 核心项目上线
# 01-20 [健康] 坚持跑步两周,体重减2kg
# 01-25 [旅行] 周末去古镇一日游
# 01-31 [学习] Rust 学习完成基础部分
# ...
# 按类别筛选
python3 tardis.py timeline --period "2025-01" --category "学习"
不适用场景
以下场景生活事件追踪-免费版不适合处理:
- 黑帽SEO手段
- 搜索引擎作弊
- 付费广告投放管理
触发条件
需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于非本工具能力范围的需求.
快速开始
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
初始化
# 初始化数据存储
python3 tardis.py init \
--storage "~/tardis-data" \
--format "json"
记录第一个事件
# 简单模式
python3 tardis.py add \
--mode simple \
--title "开始使用事件追踪工具" \
--category "生活"
搜索历史事件
# 关键词搜索
python3 tardis.py search \
--keyword "跑步" \
--from "2025-01-01" \
--to "2025-01-31"
# ...
# 输出:
# 找到 3 条匹配记录:
# [2025-01-05] 开始跑步计划
# [2025-01-12] 跑步5公里,个人最佳
# [2025-01-20] 坚持跑步两周,体重减2kg
示例
三种模式对比
| 模式 | 字段 | 适用场景 | 记录速度 |
|---|---|---|---|
| 简单 | 标题/日期/类别 | 日常快速记录 | 最快 |
| 详细 | 标题/日期/地点/人物/感受/详情 | 重要事件 | 中等 |
| 故事 | 自由叙述 | 深度记录 | 最慢 |
命令参数
| 命令 | 说明 | 示例 |
|---|---|---|
add | 添加事件 | tardis.py add --mode simple --title 事件 |
batch-add | 批量添加 | tardis.py batch-add --file events.txt |
timeline | 时间线 | tardis.py timeline --period 2025-01 |
search | 搜索 | tardis.py search --keyword 关键词 |
export | 导出 | tardis.py export --format md |
stats | 统计 | tardis.py stats --period 2025-01 |
事件类别
| 类别 | 说明 | 示例 |
|---|---|---|
| 工作 | 职业相关 | 项目上线、升职、会议 |
| 生活 | 日常生活 | 聚餐、购物、家务 |
| 学习 | 学习成长 | 读书、上课、考试 |
| 旅行 | 出行旅游 | 出差、度假、探亲 |
| 健康 | 身体健康 | 运动、体检、就医 |
| 情感 | 情感记录 | 心情、感悟、反思 |
最佳实践
- 及时记录:事件发生后尽快记录,避免遗忘细节
- 简单模式优先:日常用简单模式快速记录,重要事件再用详细模式
- 善用标签:标签是检索的关键,养成添加标签的习惯
- 定期回顾:每周/每月回顾时间线,总结与反思
- **数据备份:定期导出数据,防止数据丢失
- **隐私保护:本地存储确保隐私,不要将敏感记录同步到云端
常见问题
Q: 数据存储在哪里?
A: 免费版数据存储在本地文件系统(默认 ~/tardis-data/)。使用 JSON 格式,便于备份与迁移。不会上传到任何云端.
Q: 可以在手机上使用吗?
A: 免费版是命令行工具,需要通过终端使用。可以通过 SSH 连接电脑使用,或使用 PRO 版的 Web 界面在手机浏览器访问.
Q: 数据多了会变慢吗?
A: JSON 格式在数千条记录时仍能快速搜索。超过 1 万条建议按年分文件存储。免费版支持按年归档旧数据.
Q: 可以导入其他日记应用的数据吗?
A: 免费版支持导入 CSV 格式数据。将其他应用的数据导出为 CSV,使用 tardis.py import --format csv --file data.csv 导入.
依赖说明
运行环境
- Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- 操作系统: Windows / macOS / Linux
- Python: 3.8+
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Python 3 | 运行时 | 必需 | 官方网站下载 |
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
- 本 Skill 无需 API Key
- 纯本地存储,不涉及外部 API 调用
可用性分类
- 分类: MD+EXEC(Markdown指令 + 命令行执行)
- 说明: 通过自然语言指令驱动 Agent 记录与回顾生活事件
- 限制: 免费版不支持数据分析、多维度回顾与团队协作
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
已知限制
- 本地运行,不支持多设备同步
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
评论
加载中…