前言¶
出門幾天，記錄往往散在日記、聊天截圖和一摞照片裏。事後想回顧「那天幾點在哪兒、走了多遠、嘴裏反覆唸叨什麼」，通常要在多個文件和相冊裏來回翻。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）。
