Laper通过本地JSON文件管理故事时间线,支持ISO/相对日期格式,提供初始化、事件增删、批量导入、多维筛选及Markdown导出功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Laper管理故事时间线,需要把零散事件按时间顺序组织成可追溯、可编辑、可视觉化的时间轴结构。它不依赖外部数据库,所有时间点和事件描述都存在本地JSON文件里,修改后实时生效。
初始化时间线项目
在终端中进入你的故事目录,运行:
laper init --type timeline
这会生成 【.laper/config.json】 和空的 【events/】 文件夹。config.json 里默认启用日期解析器,但不会自动识别中文“三月”“下周二”这类表达——必须统一用 ISO 格式(如 2026-08-15)或相对语法(如 +3d、-1w)。
添加单个事件
方法一:命令行快速录入
laper event add --date 2026-08-22 --title "主角抵达青石镇" --desc "雨夜,马车轮陷进泥里,他第一次看见灯塔"
方法二:手动编辑 JSON 文件
在 events/ 下新建 2026-08-22.json,内容如下:
{
"date": "2026-08-22",
"title": "主角抵达青石镇",
"desc": "雨夜,马车轮陷进泥里,他第一次看见灯塔",
"tags": ["开端", "伏笔"]
}
注意:文件名必须与 date 字段完全一致,否则 laper list 不会显示该事件。
批量导入历史事件
第一步:准备 CSV 文件,表头为 date,title,desc,tags(tags列用英文逗号分隔)
第二步:确保所有 date 值符合 ISO 格式,例如 2026-07-01,不能写成 1/7/2026 或 七月一日
第三步:执行导入命令 → laper import events.csv
第四步:检查输出日志里是否有 “Skipped invalid date” 提示,有则说明某行日期格式错误,需返回修正
查看与筛选时间线
查看全部事件(按时间升序):
laper list
只看带“伏笔”标签的事件:
laper list --tag 伏笔
查看最近7天发生的事件:
laper list --since -7d
导出为 Markdown 时间轴(含超链接跳转):
laper export --format md > timeline.md











