前言¶
出门几天，记录往往散在日记、聊天截图和一摞照片里。事后想回顾「那天几点在哪儿、走了多远、嘴里反复念叨什么」，通常要在多个文件和相册里来回翻。dsh-trip-log 是 DeepSeek Harness（DSH）上的客户端 UI 插件：只读取你自己仓库里的普通 Markdown 和图片，在时间线、路线、词云、相册和总结五个视图里排开展示，不调用外部账号、不替你生成文案。笔记仍是纯文本，留在你的 git 仓库里；改介绍段时插件写回文件并按仓库状态执行 commit、push。
下面按定位、能力、安装、档案格式与注意点说明用法。事实以 GitHub 仓库 README 为准；社区目录见 SkillHub 插件页。目录站为社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
维护者 Ricardozhuyuyu，分类为客户端插件。简介：Turns a folder of trip notes into a timeline, route map, word cloud and photo album — a DeepSeek Harness UI plugin.
它不生成行程内容，只解析你已写好的 档案.md 与 图/ 目录，在 DSH 左侧栏以「行程记录」入口呈现五个页签：时间线 · 路线 · 词云 · 相册 · 总结。许可为 MIT（README 与 package.json 一致）。
核心功能¶
时间线：从 ## 行程 等分组及 ### / **日期** 标题、带 HH:MM 的行拆成按日、按时刻排列的事件。
路线：读取 ## 坐标 中「名字 + 纬度 + 经度」（WGS-84），用 Leaflet + Esri 暗色瓦片绘制；无需 API key。瓦片连续失败会切 OpenStreetMap，再失败则退回手绘 SVG，避免白屏。
词云：由档案正文统计高频词。
相册：图/ 下图片按时刻与档案关联展示。
总结：## 记着 等节供给「记着的几件事」；标题与 --- 之前或第一个 ## 之前的介绍段可在页面上编辑，写回 档案.md 并视仓库情况 commit + push。
基地：## 基地 仅作出发地标注，不画在路线上。
插件通过本地 HTTP（/trip-log?action=...，监听 127.0.0.1）读写文件；本身不持久化业务数据。
安装与启用¶
README 写明尚未发布 npm，不能按包名安装。在 DSH 里安装该目录：调用 plugin_manager install_bundle，target 填绝对路径，例如：
/Users/you/code/dsh-trip-log
上述路径即 README 中的示例写法，请换成你本机上的插件源码目录。
安装后重启 DSH，左侧栏应出现「行程记录」图标。
在 DSH 配置中可指定档案根目录，例如：
- id: trip-log
name: dsh-trip-log
config:
root: '~/Documents/trip-notes'
未配置 root 时默认 ~/Documents/trip-notes。
安全与权限：插件随当前 DSH 进程权限读写字面路径下的 Markdown、图片并可能执行 git commit / git push。安装前应阅读源码与 MIT 许可证，确认 root 指向你本意中的仓库目录。
档案目录与 Markdown 写法¶
在档案根目录下，一趟一个子目录，内含 档案.md 与可选 图/：
旅程/
京都-2026-04-02/
档案.md
图/
2026-04-03-岚山-0912.png
大理-2026-08-14/
档案.md
图/
...
档案.md 示例结构（节选）：
# 京都 · 2026-04-02 → 04-05
清明四天，看樱花。前两天在岚山和市区，第三天去了宇治。
---
## 行程
**04-02 周四**
- 08:15 出门，地铁去机场。
- 10:40 起飞。
## 记着
四条通的樱花。风一过整条街都在往下掉。
## 基地
上海
## 坐标
- 关西机场 34.4347 135.2320
- 岚山 35.0094 135.6668
解析规则要点¶
| 写法 | 含义 |
|---|---|
# 标题 |
卡片标题 |
--- 前 / 第一个 ## 前 |
介绍段，可在 UI 中编辑并写回 |
## 行程（名称可自定） |
事件分组 |
### 日期段 或 **10-31 周六** |
记为 day |
一行多个 HH:MM |
拆成多条并挂到对应时刻 |
## 记着 |
总结页条目来源 |
## 基地 |
出发地标注，不参与路线绘制 |
## 坐标 |
每行「名字 纬度 经度」，WGS-84 |
## 图 |
解析时跳过；图片以 图/ 文件为准 |
坐标请使用 WGS-84。从高德（GCJ-02）或百度（BD-09）复制的坐标在国内地图上会偏移，不宜直接粘贴。
适用场景与限制¶
适合：习惯用 Markdown + git 管理行程、希望在 DSH 里统一浏览时间线与地图的开发者或自用场景。
注意：
- 不依赖 API key、账号或独立后端。
- 跨 180° 经线路线（如上海 → 旧金山）目前可能绕反方向，README 标明未处理。
- 星标与版本以仓库为准；
package.json中版本为 0.1.0，生态上 DSH 奉行「一切皆插件」，本插件是其中一例 UI 扩展。
结尾¶
dsh-trip-log 把「你已经写下的档案」变成可浏览的五视图，数据留在本地仓库。要试用或审代码，打开 GitHub；在 SkillHub 检索 Ricardozhuyuyu/dsh-trip-log 可看社区目录条目（当前星标 0）。
