前言¶
在 DSH（DeepSeek Harness）里做智能体或工具链时，旅行相关的地点、路线和相册往往散落在笔记、表格或第三方地图应用里，很难和当前会话、项目容器放在同一套环境里。通用笔记可以记文字，但不容易在地球上浏览足迹、按日期排路线，并把照片与时间线绑在同一条旅程上。
dsh-studio-travel 把开源项目 StarMap 改造成可独立安装的 DSH Studio：工作台负责 Studio 列表与项目容器，本插件提供旅行页面和本地数据接入。下面介绍它的定位、能力、安装方式与使用上的限制。
这是什么¶
- 名称：
dsh-studio-travel（仓库1997liuyh-boop/dsh-studio-travel） - 维护者：1997liuyh-boop
- 分类：联网工具（SkillHub 目录）
- 一句话：基于 StarMap 的旅行工作室，用于记录到访地点、路线、相册与旅程时间线；在 DSH 中提供地图浏览、路线编排与本地旅行数据存储。
插件以 MIT 许可发布；上游 StarMap 同样为 MIT，改编记录见仓库内 UPSTREAM.json。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明：
- 地图与足迹：在地球仪/地图上浏览国家、城市、已保存地点与旅行足迹。
- 路线：按顺序组织目的地，并记录日期、交通方式与备注。
- 相册与时间线：将旅程照片、说明文字与时间线条目放在一起管理。
- 地图源配置：在 Studio 设置中配置 Cesium ion、天地图（Tianditu）以及默认地图源。
- 本地数据：旅行数据存放在配置的本地 Studio 数据目录；凭证不会写入源码或插件包。
- 会话与重试：使用 DSH 共用的会话控件；连接失败时可按界面提示重试。
捆绑的低分辨率地图源可在无网环境下使用；使用外部地图服务商则需要网络及其各自的凭证与配额策略。
安装与启用¶
本仓库在 package.json 的 dsh.bundle.patch 中声明 DSH bundle。请通过 DSH Desktop 插件管理器安装，并先添加控制台依赖包，再添加本插件的指定标签源：
github:1997liuyh-boop/dsh-studio-library#v0.1.3
github:1997liuyh-boop/dsh-studio-travel#v0.2.7
安装后，在插件管理器中确认列出 dsh-studio-travel（README 要求可见版本 0.2.1），再打开 Travel Studio。
本包声明的对等依赖为 dsh-worktable ^0.6.0、dsh-studio-projects ^0.5.0；README 说明可在 UI 中通过安装上述 dsh-studio-library 控制台包来满足。package.json 中 engines.dsh 为 0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2，请与当前 DSH 版本对齐后再装。
若在本地改源码构建，需 Node.js 22 与 npm：
npm install --include=dev --legacy-peer-deps
npm run build
npm run check
典型用法¶
在 DSH Desktop 中完成安装并打开 Travel Studio 后，可按 README 描述的路径操作：
- 在地图上浏览国家、城市与已保存地点，查看旅行足迹。
- 创建或编辑路线：为目的地排序，填写日期、交通与备注。
- 为某次旅程添加照片、配文与时间线条目。
- 在 Studio 设置里配置 Cesium ion、天地图或默认地图源（使用外部服务前准备好对应账号与密钥，并遵守服务商条款）。
数据默认只落在本地 Studio 数据目录，不会自动上传到本 GitHub 仓库，也不会在设备间自动同步。清理 DSH Studio 数据目录前请先备份旅行数据。
适用场景与注意¶
适合谁
- 已在用 DSH 工作台，希望把「去过哪里、怎么走、照片与时间线」收进同一 Studio 的开发者或重度用户。
- 需要可离线使用的低分辨率底图，同时又能在有网时切换 Cesium ion、天地图等外部源的场景。
运行与信任边界
- 插件以当前 DSH 进程的权限运行；安装前建议阅读仓库源码、
LICENSE与THIRD_PARTY_NOTICES.md，确认许可与第三方声明。 - 外部地图的可用性、配额与使用权由各地图服务商决定，本插件不负责代管这些策略。
- 本地相册与旅行记录不会自动多设备同步；跨机使用需自行备份或迁移数据目录。
社区插件目录 SkillHub 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；安装来源以你实际使用的 DSH Desktop 插件管理器为准。
结尾¶
dsh-studio-travel 把 StarMap 式的地球足迹、路线与相册时间线嵌进 DSH Studio，数据留在本地、地图源可配置，适合把旅行项目管理和工作台会话放在同一环境里。进一步了解可查看目录页与源码仓库：
- 目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-travel
- GitHub：https://github.com/1997liuyh-boop/dsh-studio-travel
