English | 中文
Solution Z——一种对复杂行为记录的解决方案 / A solution for complex behavior logging.
格式化行动记录系统——先在 Obsidian 中记录，未来会成长为一款多端行动管理工具。
Solution Z 目前是一个基于 Obsidian vault 的行动记录系统，配合 Claude Code（或其他 AI Agent）实现半自动化记录。你记录自己的每日行动，Agent 帮你将其格式化为结构化的 vault 文件。
未来规划：开发为 macOS 桌面应用（Electron + Vue 3 + better-sqlite3），App 作为编辑入口，vault 作为 Obsidian 浏览层。应用的核心是行动计时器——点击开始、选择类型、输入内容、停止计时，一条行动就记录完成。所有数据存储在本地 SQLite 中，一键导出为 Obsidian vault 的 Markdown 文件。详见 DESIGN-v3.md。
git clone https://github.com/Chartreuse310/solution-z.git
cd solution-zexample-vault/ 包含完整的示例数据，所有文件类型均有格式说明：
example-vault/
├── README.md # 数据模型详细说明
├── actions/ # 行动记录
├── goals/ # 目标
├── areas/ # 领域
├── resources/ # 外部材料（书/播客/游戏）
├── notes/ # 独立笔记
├── journal/ # 日索引
└── templates/ # 各类型格式说明
本项目包含一个 timeline-to-vault skill，可以将每日时间轴自动转换为 vault 文件。
推荐的时间轴格式（3x3 导出）：
- 09:30:28 - 09:57:58,27分钟——早餐：拿铁&三明治（🍚 吃饭）
- 读[[某本书]]（📖 阅读 → 11.11 某领域）
- 10:08:47 - 10:36:08,27分钟——keep（🏂 锻炼）
- 听[[某播客]] - 某某剧集（📻 听播客）
- 11:06:35 - 12:12:40,1小时6分钟——整理照片（🗂 整理 → 22 PKM）
格式规则：
- 每行以
- HH:MM:SS - HH:MM:SS,时长——内容（emoji 类别 → tag hint）开头 - 子活动用 4 空格缩进，表示并行活动
[[wiki-link]]标记关联的资源、目标或笔记（emoji 类别 → tag hint）指定行动类型和标签
在 Claude Code 中直接粘贴时间轴，skill 会自动触发。
如果你想使用其他时间记录软件（如 Toggl、Clockify、自定义 app），只需将导出数据转换为上述时间轴格式，包含以下字段：
| 字段 | 必需 | 说明 |
|---|---|---|
| 开始时间 | 是 | HH:MM:SS |
| 结束时间 | 是 | HH:MM:SS |
| 时长 | 是 | X分钟 或 X小时X分钟 |
| 内容 | 是 | 活动描述，可含 [[wiki-link]] |
| 行动类型 | 是 | （emoji 类别） |
| 标签 | 否 | → tag hint |
| 子活动 | 否 | 缩进的并行活动 |
你可以编写一个简单的转换脚本，将你所用工具的导出格式转为上述时间轴，然后使用 timeline-to-vault skill 录入。
areas（领域） ← 顶层知识域
└── goals（目标） ← 进行中的项目
└── actions（行动）← 原子级时间记录，+ 标记表示并行
└── journal ← 自动生成的日索引
resources（资源） ← 外部材料（书/播客/游戏）
notes（笔记） ← 独立笔记卡片
templates（模板） ← 格式说明与行动模板
沙楚子——一个试图跑通全栈的设计师，一个研究中国建筑史的学生。
经过几年对自己生活记录的实验，我形成了一套比较完整的记录系统，想要通过 Solution Z 分享给大家。
这是一个开源项目，我不会将这个软件做成商业项目。如果你想请我喝咖啡（尽管我并不太相信会有人这么做，不过万一呢？），我未来会提供根据需求个性化定制仓库及软件的服务，我称之为 Solution Z 4U。
欢迎提交 Issue 和 Pull Request。如果你在用自己的记录工具，欢迎分享你的时间轴转换方案。
AGPL-3.0 License