溜达喵导航 XiaoyuYoung/neko-wander

溜达喵 Neko Wander

A little wander, a little wonder

溜达溜达，瞅点儿新鲜

太长不看

溜达喵希望借助 AI 基础服务（大肥鱼牛逼），提供个性化的导航方案，可在对话中搜索地点、标记地图，规划和比较多种出行路线。

目前版本仅为测试 demo，更多还在规划

快速开始

1. 申请高德 Key

在高德开放平台控制台注册或登录，进入「应用管理」，创建一个应用，并在其中添加两种 Key：

| 高德服务平台 | 用途 | 环境变量 |
| Web 服务 | 地点、地址与路线查询，由 DSH Host 调用 | AMAP_WEB_KEY |
| Web 端（JS API） | 在浏览器显示交互地图 | AMAP_JS_KEY |
| 创建 JS API Key 时得到的安全密钥 | JS API 鉴权 | AMAP_JS_SECURITY_CODE |

在启动 DSH 的同一个终端设置环境变量。PowerShell 示例：

$env:AMAP_WEB_KEY = '你的 Web 服务 Key' $env:AMAP_JS_KEY = '你的 Web 端 JS API Key' $env:AMAP_JS_SECURITY_CODE = '对应的 JS API 安全密钥'

macOS / Linux 示例：

export AMAP_WEB_KEY='你的 Web 服务 Key'
export AMAP_JS_KEY='你的 Web 端 JS API Key'
export AMAP_JS_SECURITY_CODE='对应的 JS API 安全密钥'

2. 选择安装方式

两种方式都需要上面的高德配置值，并在启动 DSH 的同一个终端设置环境变量。使用已发布版本请选择 npm 安装；需要修改插件源码或调试时选择源码构建。

方式一：从 npm 安装预构建包

需要 Node.js 22.19.x 或 24+，以及 DSH CLI 0.2.1-alpha.3。如果尚未安装 DSH CLI，先运行：

npm install -g @deepseek-ai/dsh@0.2.1-alpha.3

然后将插件安装到 DSH Web profile 并启动：

dsh plugin --profile web add dsh-neko-wander@alpha
dsh web

也可以在 DSH Web 侧边栏的「插件」页面安装 dsh-neko-wander@alpha。npm 包已包含预构建的 Host、Client 和类型文件，不需要下载插件源码或运行 npm run build。插件的 dsh.bundle 会启用 cordis.patch.yml，从上述环境变量读取 Key。安装后若插件尚未生效，请重启 Web profile。

方式二：从源码构建并运行

需要与插件匹配的 DSH 源码、Node.js 22.19.x 或 24+、pnpm，以及 Windows PowerShell。把本仓库放在 deepseek-harness/packages/experimental/neko-wander，然后在 DSH 仓库根目录运行：

pnpm install
pnpm run build:artifacts
.\packages\experimental\neko-wander\run-local.ps1

run-local.ps1 以源码 overlay 启动 DSH Web；默认把试用数据放在插件目录的 .dsh-local，不会把 Key 写入仓库。脚本要求插件确实位于上述 DSH 工作区路径。源码试用方式不依赖 npm 上的 dsh-neko-wander 包。

3. 在对话中使用

打开 Web 对话，右侧会出现「溜达喵地图」。首次打开地图时允许浏览器定位；也可以在对话里明确给出城市、起点或地址。例如：

附近有没有适合散步的公园？先在地图上给我几个候选点。

回家路上想绕去一个安静的地方，帮我比较绕行时间；我选好以后再规划骑行路线。

把长风街一带圈出约 500 米范围。那个文具店的具体位置再用大头针标出来。

地点搜索、地址查询和周边搜索会把候选点标在地图上；点击大头针或地址条目可以高亮地点。点击地图标记只是查看地点，不会把它自动加入路线。 需要路线时在对话中明确选择地点和出行方式。已规划路线不会因为继续搜索沿途店铺而消失；只有重新规划或要求清除路线才会改变它。

目前支持驾车、步行、自行车骑行、公交及地铁换乘、电动自行车路线；也可以比较直达与途经一个候选点的时间、距离差。地图上的导航入口会打开高德，由高德重新计算并让你确认行程。

构建 npm 发布包

维护者可在单独克隆的插件仓库中构建和打包，不需要 DSH 工作区。使用 Node.js 22.19.x 或 24+ 执行：

npm ci
npm run build
npm pack --dry-run

npm pack 会自动重新构建并检查 Host、Client 和类型声明文件。发布前先检查 npm 账号与包名权限，再执行 npm publish --tag alpha。发布操作需要 npm 登录凭据；此处只准备发布产物，不会自动上传。直接纳入 DSH 工作区的常规发布流程时，其实验包命名检查仍按 DSH 自身规则执行；独立 npm 发布使用本仓库的构建流程。
开发者可查看实现与接口备忘录，了解路线模式、定位状态和错误处理等细节。

当前提供的能力

| 能力 | 行为 |
| 动态地图与定位 | 右侧地图显示候选地点、路线和当前位置；浏览器授权后可以用当前位置搜索或作为路线起点。 |
| 地点与区域 | 搜索地点、查询地址或坐标；具体地点用大头针，模糊区域用可调整半径的圆圈。 |
| 路线与绕行 | 对比途经点与直达路线，按选定方式显示路线、时间和距离；公交路线可显示换乘和步行接驳信息。 |
| 继续探索 | 路线生成后仍可搜索沿途地点；新搜索只更新候选标记，不会自动改写路线。 |

插件工具使用 neko_ 前缀，包括 neko_search_places、neko_search_nearby、neko_geocode、neko_reverse_geocode、neko_show_place、neko_show_area、neko_compare_detour、neko_plan_route 和清除工具。坐标采用高德 GCJ-02 的「经度,纬度」顺序。

已知限制

- 定位与状态：精确定位需要浏览器授权，以及 HTTPS 或 localhost 等安全环境；IP 定位只是大致位置。地图和定位状态保存在当前 DSH 进程内，重启后清空。
- 高德服务：地点和路线结果受高德账号权限、配额、地区及实时数据影响。公交暂不支持途经点、指定出发时间、备选方案切换、火车或出租车接驳；票价和班次应在高德确认。
- 导航跳转：高德会重新规划，跳转后的路线可能与插件显示的折线不同。骑行入口主要面向手机；电动车需要在高德中手动切换相应模式。真实手机上的 App 唤起尚未完成验证。
- 部署范围：目前主要供开发者本机试用。虽然地图与定位接口使用 DSH Connection 鉴权，JS API 安全密钥仍会进入浏览器；公开部署前需要接入高德安全代理并验证 HTTPS、网络监听和访问控制。