按天
每天一页:出发地、目的地、途经点、里程、时长、爬升与备注。
它是什么
照片会散在相册里,轨迹会留在手表里,账单会躺在邮箱里。jMap 把它们收在一本按天组织的路书里。
每天一页:出发地、目的地、途经点、里程、时长、爬升与备注。
每个停留是一个条目:名称、时间、地点、指标与自由备注。
生成 /s/… 只读链接,发给朋友或家人;不需要对方登录。
写
新建路书可以给结构化天数组,也可以直接贴一段 Markdown。jMap 会把它解析成按天、按条目的正式结构,而不是一段无法检索的文本。
改
每次修订都必须带上读取时的 baseRev。服务端版本已经变化,就拒绝写入,要求重新读取;写入成功后也会生成新的 revision,书主随时可以回滚。
分享
分享出去的是这本书的只读视图。对方不需要账号,也改不了内容;jMap 不提供公开目录,路书默认私有。
/s/… 只读分享,无需登录AI 与路书
jMap 可以独立使用,也可以经 jAgent 的能力网关被 AI 调用。每把 API Key 绑定一个用户,只能看到自己名下的路书。
| 工具 | 能力 |
|---|---|
list_books | 列出当前 API Key 所属用户的全部路书(标题、起始日期、天数、revision) |
get_book | 读取一本路书:Markdown 便于阅读,JSON 含完整结构与 rev |
get_day | 读取第 N 天的条目、交通与统计(里程、时长、爬升) |
search_items | 按名称、地点、地址、备注搜索条目,返回所在天与序号 |
create_book | 新建路书:结构化天数组,或自由 Markdown 自动解析 |
propose_patch | 提交插入/更新/删除/移动;必须带 baseRev,冲突拒绝,成功生成新 revision |
“把我上次东北自驾的第五天找出来,看看那天开了多少公里。”
“这趟行程里有哪些海边停留?按天列一下。”
“把第三天重复的那个条目删掉,再补一条傍晚看日落的安排。”
AI 修订受 API Key 权限与 revision 冲突保护;书主可在版本历史回滚。jMap 不是公开社交平台,路书默认私有。
在体系里的位置
jMap 有自己的账号、界面与数据模型。它和 jAgent 的关系是“能力挂载”:jAgent 通过标准 MCP 接口读取和修订路书,而不是把 jMap 塞进聊天窗口。在安装分层里,它属于“自建对接”:独立部署,按需接入;不装不影响核心。