@tencent-map/lbs-skills 0.0.1

package/README.md

@@ -0,0 +1,143 @@
+# @tencent-map/lbs-skills
+
+腾讯地图位置服务命令行工具，支持 POI 搜索、地理编码、周边搜索、路径规划、旅游规划、轨迹可视化等功能。
+
+## 安装
+
+```bash
+npm install -g @tencent-map/lbs-skills
+```
+
+## 快速开始
+
+### 设置 API Key
+
+```bash
+# 方式一：命令行设置（持久化到 ~/.tmap-lbs/config.json）
+tmap-lbs config set-key YOUR_KEY
+
+# 方式二：环境变量（当前会话有效）
+export TMAP_LBS_KEY=YOUR_KEY
+```
+
+获取 Key：https://lbs.qq.com/dev/console/application/mine
+
+### 查看帮助
+
+```bash
+tmap-lbs --help
+tmap-lbs <command> --help
+```
+
+## 命令列表
+
+### `config` — 管理 API Key
+
+```bash
+tmap-lbs config set-key <key>    # 保存 Key
+tmap-lbs config get-key          # 查看当前 Key
+tmap-lbs config remove-key       # 删除 Key
+tmap-lbs config path             # 显示配置文件路径
+```
+
+### `search` — POI 搜索
+
+```bash
+# 城市关键词搜索
+tmap-lbs search --keywords 肯德基 --city 北京
+
+# 周边坐标搜索
+tmap-lbs search --keywords 酒店 --location 116.397,39.909 --radius 1000
+
+# 带分类筛选
+tmap-lbs search --keywords 餐厅 --city 上海 --types 餐饮
+
+# 输出完整 JSON
+tmap-lbs search --keywords 肯德基 --city 北京 --raw
+```
+
+### `geocode` — 地理编码
+
+```bash
+tmap-lbs geocode --address 西直门
+tmap-lbs geocode --address 北京天安门
+```
+
+### `nearby` — 周边搜索（生成可视化链接）
+
+生成腾讯地图周边搜索可视化链接，点击即可在地图上查看结果：
+
+```bash
+tmap-lbs nearby --location 西直门 --keywords 美食
+tmap-lbs nearby --location 北京南站 --keywords 酒店
+tmap-lbs nearby --keyword 天坛餐厅
+```
+
+如需获取结构化 POI 数据，使用 `search` + `geocode` 组合：
+
+```bash
+tmap-lbs geocode --address 西直门
+tmap-lbs search --keywords 美食 --location 116.353,39.939 --radius 1000
+```
+
+### `route` — 路径规划
+
+支持出行方式：`walk`（步行）、`drive`（驾车）、`cycle`（骑行）、`ecycle`（电动车）、`transit`（公交）
+
+```bash
+# 步行
+tmap-lbs route --mode walk --origin 116.397,39.909 --destination 116.427,39.903
+
+# 驾车（带策略）
+tmap-lbs route --mode drive --origin 116.397,39.909 --destination 116.427,39.903 --policy LEAST_TIME
+
+# 驾车（带途经点和车牌号）
+tmap-lbs route --mode drive --origin 116.397,39.909 --destination 116.427,39.903 \
+  --waypoints "116.41,39.91;116.42,39.92" --plate-number 京A12345
+
+# 公交
+tmap-lbs route --mode transit --origin 116.397,39.909 --destination 116.427,39.903 --policy LEAST_TRANSFER
+```
+
+### `travel` — 旅游规划（生成可视化链接）
+
+自动地理编码获取景点坐标，生成旅游规划可视化链接：
+
+```bash
+tmap-lbs travel --city 北京 --interests 故宫,颐和园,香山
+tmap-lbs travel --city 杭州 --interests 西湖,灵隐寺,龙井茶 --recommend restaurant
+```
+
+### `trail` — 轨迹可视化（生成可视化链接）
+
+```bash
+tmap-lbs trail --data https://mapapi.qq.com/web/claw/trail.json
+```
+
+## 编程接口
+
+也可以作为 Node.js 模块在代码中使用：
+
+```js
+const { searchPOI, geocode, walkRoute } = require('@tencent-map/lbs-skills');
+
+// 搜索
+const result = await searchPOI({ keywords: '肯德基', city: '北京' });
+
+// 地理编码
+const geo = await geocode({ address: '西直门' });
+
+// 路线规划
+const route = await walkRoute({
+  origin: '116.397,39.909',
+  destination: '116.427,39.903',
+});
+```
+
+## 坐标格式
+
+所有命令中的坐标参数统一使用 **"经度,纬度"** 格式（经度在前），工具内部会自动转换为腾讯地图 API 所需的 "纬度,经度" 格式。
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,503 @@
+#!/usr/bin/env node
+'use strict';
+
+const lib = require('../lib/index.js');
+
+// ─── 工具函数 ────────────────────────────────────────────────────────
+
+function printJSON(obj, raw) {
+  if (raw) {
+    console.log(JSON.stringify(obj, null, 2));
+  } else {
+    // 去掉 _raw 字段的简洁输出
+    const clean = JSON.parse(JSON.stringify(obj));
+    delete clean._raw;
+    console.log(JSON.stringify(clean, null, 2));
+  }
+}
+
+function fatal(msg) {
+  console.error(`\n❌ ${msg}\n`);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith('--')) {
+        args[key] = next;
+        i++;
+      } else {
+        args[key] = true;
+      }
+    } else {
+      positional.push(arg);
+    }
+  }
+  return { args, positional };
+}
+
+// ─── 帮助信息 ────────────────────────────────────────────────────────
+
+const HELP = `
+tmap-lbs — 腾讯地图位置服务 CLI
+
+Usage:
+  tmap-lbs <command> [options]
+
+Commands:
+  config          管理 API Key 配置
+  search          POI 搜索（关键词/城市/周边）
+  geocode         地理编码（地址 → 坐标）
+  nearby          周边搜索（生成地图可视化链接）
+  route           路径规划（步行/驾车/骑行/公交等）
+  travel          旅游规划（生成地图可视化链接）
+  trail           轨迹可视化（生成地图可视化链接）
+
+Options:
+  --help          显示帮助信息
+  --raw           输出包含原始 API 响应的完整 JSON
+  --json          以 JSON 格式输出（默认就是 JSON）
+
+Run \`tmap-lbs <command> --help\` for command-specific usage.
+
+配置 Key:
+  tmap-lbs config set-key <your-key>
+  或 export TMAP_LBS_KEY=<your-key>
+
+获取 Key: https://lbs.qq.com/dev/console/application/mine
+`;
+
+const HELP_CONFIG = `
+tmap-lbs config — 管理 API Key
+
+Usage:
+  tmap-lbs config set-key <key>    保存 API Key
+  tmap-lbs config get-key          查看当前 Key
+  tmap-lbs config remove-key       删除已保存的 Key
+  tmap-lbs config path             显示配置文件路径
+`;
+
+const HELP_SEARCH = `
+tmap-lbs search — POI 搜索
+
+Usage:
+  tmap-lbs search --keywords <关键词> [options]
+
+Options:
+  --keywords <kw>      搜索关键词（必填）
+  --city <city>        限定城市
+  --location <lng,lat> 中心点坐标（经度,纬度）
+  --radius <meters>    搜索半径（米），与 --location 配合使用
+  --types <type>       POI 分类筛选
+  --page <n>           页码（默认 1）
+  --page-size <n>      每页数量（默认 10，最大 20）
+  --raw                输出完整原始 JSON
+
+Examples:
+  tmap-lbs search --keywords 肯德基 --city 北京
+  tmap-lbs search --keywords 酒店 --location 116.397,39.909 --radius 1000
+  tmap-lbs search --keywords 餐厅 --city 上海 --types 餐饮
+`;
+
+const HELP_GEOCODE = `
+tmap-lbs geocode — 地理编码
+
+Usage:
+  tmap-lbs geocode --address <地址>
+
+Options:
+  --address <addr>    地址关键词（必填）
+  --raw               输出完整原始 JSON
+
+Examples:
+  tmap-lbs geocode --address 西直门
+  tmap-lbs geocode --address 北京天安门
+`;
+
+const HELP_NEARBY = `
+tmap-lbs nearby — 生成周边搜索可视化链接
+
+生成腾讯地图周边搜索的可视化链接，用户点击即可在地图上查看结果。
+
+Usage:
+  tmap-lbs nearby --location <位置名称> --keywords <搜索类别>
+
+Options:
+  --location <name>    位置名称（如"西直门"），与 --keywords 组合为搜索词
+  --keywords <kw>      搜索关键词（如"美食"）
+  --keyword <kw>       直接指定完整搜索关键词（如"西直门美食"）
+
+Examples:
+  tmap-lbs nearby --location 西直门 --keywords 美食
+  tmap-lbs nearby --keyword 北京南站酒店
+  tmap-lbs nearby --location 天坛 --keywords 餐厅
+`;
+
+const HELP_ROUTE = `
+tmap-lbs route — 路径规划
+
+Usage:
+  tmap-lbs route --mode <mode> --origin <lng,lat> --destination <lng,lat> [options]
+
+Modes:
+  walk       步行
+  drive      驾车
+  cycle      骑行（自行车）
+  ecycle     电动车
+  transit    公交
+
+Common Options:
+  --origin <lng,lat>        起点坐标（经度,纬度，必填）
+  --destination <lng,lat>   终点坐标（经度,纬度，必填）
+  --mode <mode>             出行方式（默认 walk）
+  --raw                     输出完整原始 JSON
+
+Drive Options:
+  --waypoints <lng,lat;...> 途经点，多个用 ; 分隔
+  --policy <policy>         策略：LEAST_TIME|LEAST_FEE|AVOID_HIGHWAY|HIGHWAY_FIRST
+  --plate-number <plate>    车牌号（用于避开限行）
+
+Transit Options:
+  --policy <policy>         策略：LEAST_TIME|LEAST_TRANSFER|LEAST_WALKING|RECOMMEND
+  --departure-time <ts>     出发时间（Unix 时间戳）
+
+Examples:
+  tmap-lbs route --mode walk --origin 116.397,39.909 --destination 116.427,39.903
+  tmap-lbs route --mode drive --origin 116.397,39.909 --destination 116.427,39.903 --policy LEAST_TIME
+  tmap-lbs route --mode transit --origin 116.397,39.909 --destination 116.427,39.903
+`;
+
+const HELP_TRAVEL = `
+tmap-lbs travel — 生成旅游规划可视化链接
+
+通过地理编码获取景点坐标，生成腾讯地图旅游规划可视化链接。
+
+Usage:
+  tmap-lbs travel --city <城市> --interests <景点1,景点2,...> [options]
+
+Options:
+  --city <city>              城市名称（必填）
+  --interests <kw1,kw2,...>  景点/兴趣关键词，逗号分隔（必填）
+  --recommend <types>        推荐类型，逗号分隔（如 restaurant,hotel）
+  --raw                      同时输出 JSON 数据
+
+Examples:
+  tmap-lbs travel --city 北京 --interests 故宫,颐和园,香山
+  tmap-lbs travel --city 杭州 --interests 西湖,灵隐寺,龙井茶 --recommend restaurant
+`;
+
+const HELP_TRAIL = `
+tmap-lbs trail — 轨迹可视化
+
+生成腾讯地图轨迹可视化链接。
+
+Usage:
+  tmap-lbs trail --data <数据URL>
+
+Options:
+  --data <url>    轨迹数据 JSON 的 URL 地址（必填）
+
+Examples:
+  tmap-lbs trail --data https://mapapi.qq.com/web/claw/trail.json
+`;
+
+// ─── 命令实现 ────────────────────────────────────────────────────────
+
+async function cmdConfig(positional) {
+  const sub = positional[0];
+
+  if (!sub || sub === '--help') {
+    console.log(HELP_CONFIG);
+    return;
+  }
+
+  switch (sub) {
+    case 'set-key': {
+      const key = positional[1];
+      if (!key) fatal('请提供 API Key: tmap-lbs config set-key <key>');
+      lib.setKey(key);
+      console.log('✅ API Key 已保存');
+      break;
+    }
+    case 'get-key': {
+      const key = lib.getKey();
+      if (key) {
+        const masked = key.length > 8
+          ? key.slice(0, 4) + '*'.repeat(key.length - 8) + key.slice(-4)
+          : '****';
+        console.log(`当前 Key: ${masked}`);
+      } else {
+        console.log('未设置 API Key');
+      }
+      break;
+    }
+    case 'remove-key': {
+      lib.removeKey();
+      console.log('✅ API Key 已删除');
+      break;
+    }
+    case 'path': {
+      console.log(`配置目录: ${lib.CONFIG_DIR}`);
+      console.log(`配置文件: ${lib.CONFIG_FILE}`);
+      break;
+    }
+    default:
+      fatal(`未知 config 子命令: ${sub}\n${HELP_CONFIG}`);
+  }
+}
+
+async function cmdSearch(args) {
+  if (args.help) { console.log(HELP_SEARCH); return; }
+  if (!args.keywords) fatal('缺少 --keywords 参数');
+
+  const result = await lib.searchPOI({
+    keywords: args.keywords,
+    city: args.city,
+    location: args.location,
+    radius: args.radius ? Number(args.radius) : undefined,
+    types: args.types,
+    page: args.page ? Number(args.page) : 1,
+    pageSize: args['page-size'] ? Number(args['page-size']) : 10,
+  });
+
+  if (!result) fatal('搜索未返回结果');
+
+  if (args.raw) {
+    printJSON(result, true);
+  } else {
+    console.log(`\n🔍 搜索 "${args.keywords}" 共 ${result.count} 条结果:\n`);
+    result.pois.forEach((poi, i) => {
+      console.log(`  ${i + 1}. ${poi.name}`);
+      if (poi.address) console.log(`     📍 ${poi.address}`);
+      if (poi.type) console.log(`     🏷  ${poi.type}`);
+      if (poi.tel) console.log(`     📞 ${poi.tel}`);
+      console.log(`     🌐 ${poi.location}`);
+      if (poi.distance !== undefined) console.log(`     📏 ${poi.distance}m`);
+      console.log('');
+    });
+  }
+}
+
+async function cmdGeocode(args) {
+  if (args.help) { console.log(HELP_GEOCODE); return; }
+  if (!args.address) fatal('缺少 --address 参数');
+
+  const result = await lib.geocode({ address: args.address });
+  if (!result) fatal('地理编码未返回结果');
+
+  if (args.raw) {
+    printJSON(result, true);
+  } else {
+    console.log(`\n📍 "${result.title}" 的坐标:`);
+    console.log(`   纬度: ${result.lat}`);
+    console.log(`   经度: ${result.lng}`);
+    console.log(`   坐标: ${result.lng},${result.lat}\n`);
+  }
+}
+
+async function cmdNearby(args) {
+  if (args.help) { console.log(HELP_NEARBY); return; }
+
+  let keyword = args.keyword;
+  if (!keyword) {
+    // 组合 location + keywords 形成搜索关键词
+    if (!args.location && !args.keywords) {
+      fatal('缺少参数。用法: tmap-lbs nearby --location <位置> --keywords <类别>\n       或: tmap-lbs nearby --keyword <完整关键词>');
+    }
+    keyword = (args.location || '') + (args.keywords || '');
+  }
+
+  const encoded = encodeURIComponent(keyword);
+  const url = `https://mapapi.qq.com/web/claw/nearby-search.html?keyword=${encoded}`;
+
+  console.log(`\n🔍 已生成周边搜索链接：\n`);
+  console.log(`  ${url}\n`);
+  console.log(`搜索关键词: ${keyword}`);
+  console.log(`点击链接即可在地图上查看搜索结果。\n`);
+}
+
+async function cmdRoute(args) {
+  if (args.help) { console.log(HELP_ROUTE); return; }
+  if (!args.origin) fatal('缺少 --origin 参数');
+  if (!args.destination) fatal('缺少 --destination 参数');
+
+  const mode = args.mode || 'walk';
+  const modeNames = {
+    walk: '步行', drive: '驾车', cycle: '骑行',
+    ecycle: '电动车', transit: '公交',
+  };
+
+  if (!modeNames[mode]) {
+    fatal(`不支持的出行方式: ${mode}\n支持: walk, drive, cycle, ecycle, transit`);
+  }
+
+  console.log(`\n🗺  正在规划 ${modeNames[mode]} 路线...\n`);
+
+  let result;
+  switch (mode) {
+    case 'walk':
+      result = await lib.walkRoute({ origin: args.origin, destination: args.destination });
+      break;
+    case 'drive':
+      result = await lib.driveRoute({
+        origin: args.origin,
+        destination: args.destination,
+        waypoints: args.waypoints,
+        policy: args.policy,
+        plate_number: args['plate-number'],
+      });
+      break;
+    case 'cycle':
+      result = await lib.cycleRoute({ origin: args.origin, destination: args.destination });
+      break;
+    case 'ecycle':
+      result = await lib.ecycleRoute({ origin: args.origin, destination: args.destination });
+      break;
+    case 'transit':
+      result = await lib.transitRoute({
+        origin: args.origin,
+        destination: args.destination,
+        policy: args.policy,
+        departure_time: args['departure-time'],
+      });
+      break;
+  }
+
+  if (!result) fatal('路线规划未返回结果');
+
+  if (args.raw) {
+    printJSON(result, true);
+  } else {
+    if (mode === 'transit') {
+      const transits = result.route.transits;
+      console.log(`共 ${transits.length} 条线路方案:\n`);
+      transits.forEach((t, i) => {
+        console.log(`  方案 ${i + 1}: 约 ${t.duration} 分钟, ${t.distance}m`);
+      });
+    } else {
+      const p = result.route.paths[0];
+      console.log(`✅ ${modeNames[mode]}路线规划完成:`);
+      console.log(`   距离: ${p.distance}m`);
+      console.log(`   耗时: ${p.duration} 分钟`);
+      if (mode === 'drive') {
+        if (p.toll) console.log(`   过路费: ¥${p.toll}`);
+        if (p.traffic_light_count) console.log(`   红绿灯: ${p.traffic_light_count} 个`);
+      }
+      console.log(`   共 ${p.steps.length} 个导航步骤`);
+    }
+    console.log('');
+  }
+}
+
+async function cmdTravel(args) {
+  if (args.help) { console.log(HELP_TRAVEL); return; }
+  if (!args.city) fatal('缺少 --city 参数');
+  if (!args.interests) fatal('缺少 --interests 参数');
+
+  const interests = args.interests.split(',').map((s) => s.trim()).filter(Boolean);
+  const recommend = args.recommend || '';
+
+  console.log(`\n🗺  正在获取景点坐标...\n`);
+
+  // 对每个景点进行地理编码获取坐标
+  const spots = [];
+  for (const name of interests) {
+    try {
+      const geo = await lib.geocode({ address: `${args.city}${name}` });
+      if (geo) {
+        spots.push({ name, lat: geo.lat, lng: geo.lng });
+        console.log(`  ✅ ${name}: ${geo.lng},${geo.lat}`);
+      } else {
+        console.log(`  ⚠️  ${name}: 未找到坐标，跳过`);
+      }
+    } catch {
+      console.log(`  ⚠️  ${name}: 地理编码失败，跳过`);
+    }
+  }
+
+  if (spots.length === 0) fatal('没有成功获取任何景点的坐标');
+
+  // 生成旅游规划可视化链接
+  const key = lib.getKey() || '';
+  const spotsJSON = JSON.stringify(spots);
+  const params = new URLSearchParams();
+  params.set('spots', spotsJSON);
+  if (recommend) params.set('recommend', recommend);
+  if (key) params.set('key', key);
+
+  const url = `https://mapapi.qq.com/web/claw/travel.html?${params.toString()}`;
+
+  console.log(`\n🗺  已生成旅游规划链接：\n`);
+  console.log(`  ${url}\n`);
+  console.log(`景点: ${spots.map((s) => s.name).join(', ')}`);
+  console.log(`点击链接即可在地图上查看旅游规划。\n`);
+
+  if (args.raw) {
+    printJSON({ spots, url }, false);
+  }
+}
+
+async function cmdTrail(args) {
+  if (args.help) { console.log(HELP_TRAIL); return; }
+  if (!args.data) fatal('缺少 --data 参数');
+
+  const encoded = encodeURIComponent(args.data);
+  const url = `https://mapapi.qq.com/web/claw/trail-map.html?data=${encoded}`;
+
+  console.log(`\n📍 轨迹可视化链接:\n`);
+  console.log(`  ${url}\n`);
+  console.log(`数据来源: ${args.data}\n`);
+}
+
+// ─── 主入口 ──────────────────────────────────────────────────────────
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const command = argv[0];
+
+  if (!command || command === '--help' || command === '-h') {
+    console.log(HELP);
+    return;
+  }
+
+  const rest = argv.slice(1);
+  const { args, positional } = parseArgs(rest);
+
+  try {
+    switch (command) {
+      case 'config':
+        await cmdConfig(positional);
+        break;
+      case 'search':
+        await cmdSearch(args);
+        break;
+      case 'geocode':
+        await cmdGeocode(args);
+        break;
+      case 'nearby':
+        await cmdNearby(args);
+        break;
+      case 'route':
+        await cmdRoute(args);
+        break;
+      case 'travel':
+        await cmdTravel(args);
+        break;
+      case 'trail':
+        await cmdTrail(args);
+        break;
+      default:
+        fatal(`未知命令: ${command}\n运行 tmap-lbs --help 查看可用命令`);
+    }
+  } catch (err) {
+    fatal(err.message);
+  }
+}
+
+main();

package/lib/index.js

@@ -0,0 +1,474 @@
+'use strict';
+
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+
+// ─── 配置管理 ────────────────────────────────────────────────────────
+
+const CONFIG_DIR = path.join(os.homedir(), '.tmap-lbs');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+/**
+ * 读取持久化配置文件
+ * @returns {Object} 配置对象
+ */
+function loadConfigFile() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+  } catch {
+    // ignore
+  }
+  return {};
+}
+
+/**
+ * 保存配置到文件
+ * @param {Object} config - 配置对象
+ */
+function saveConfigFile(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+/**
+ * 获取 API Key（优先环境变量，其次配置文件）
+ * @returns {string|null}
+ */
+function getKey() {
+  return process.env.TMAP_LBS_KEY || process.env.TMAP_LBS_CONFIG || loadConfigFile().key || null;
+}
+
+/**
+ * 设置 API Key 到配置文件
+ * @param {string} key
+ */
+function setKey(key) {
+  const config = loadConfigFile();
+  config.key = key;
+  saveConfigFile(config);
+}
+
+/**
+ * 删除已保存的 API Key
+ */
+function removeKey() {
+  const config = loadConfigFile();
+  delete config.key;
+  saveConfigFile(config);
+}
+
+/**
+ * 获取 Key，未设置时抛出错误
+ * @returns {string}
+ */
+function ensureKey() {
+  const key = getKey();
+  if (!key) {
+    const msg = [
+      '',
+      '⚠️  未找到腾讯地图 API Key',
+      '',
+      '请通过以下方式之一设置:',
+      '  tmap-lbs config set-key <your-key>',
+      '  export TMAP_LBS_KEY=<your-key>',
+      '',
+      '获取 Key: https://lbs.qq.com/dev/console/application/mine',
+      '',
+    ].join('\n');
+    throw new Error(msg);
+  }
+  return key;
+}
+
+// ─── HTTP 请求 ───────────────────────────────────────────────────────
+
+/**
+ * HTTP GET 请求
+ * @param {string} url - 请求基础 URL
+ * @param {Object} params - 查询参数
+ * @returns {Promise<Object|null>}
+ */
+async function httpGet(url, params) {
+  const qs = Object.entries(params)
+    .filter(([, v]) => v !== undefined && v !== null && v !== '')
+    .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+    .join('&');
+
+  const endpoint = qs ? `${url}?${qs}` : url;
+
+  const response = await fetch(endpoint, {
+    method: 'GET',
+    signal: AbortSignal.timeout(15000),
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+  }
+
+  return response.json();
+}
+
+// ─── 坐标工具 ────────────────────────────────────────────────────────
+
+/**
+ * 将 "经度,纬度" 翻转为腾讯地图格式 "纬度,经度"
+ * @param {string} coordStr - "lng,lat"
+ * @returns {string} "lat,lng"
+ */
+function flipCoord(coordStr) {
+  const [lng, lat] = coordStr.split(',').map((s) => s.trim());
+  return `${lat},${lng}`;
+}
+
+// ─── 地理编码 ────────────────────────────────────────────────────────
+
+/**
+ * 地理编码：地址 → 坐标
+ * @param {Object} params
+ * @param {string} params.address - 地址关键词
+ * @returns {Promise<Object|null>}
+ */
+async function geocode(params) {
+  const key = ensureKey();
+  const url = 'https://apis.map.qq.com/ws/geocoder/v1/';
+  const data = await httpGet(url, {
+    key,
+    address: params.address,
+    policy: 1,
+    output: 'json',
+  });
+
+  if (!data) return null;
+
+  if (data.status === 0) {
+    const loc = data.result.location;
+    return {
+      title: data.result.title || params.address,
+      lat: loc.lat,
+      lng: loc.lng,
+      _raw: data,
+    };
+  }
+  throw new Error(`地理编码失败: ${data.message}`);
+}
+
+// ─── POI 搜索 ────────────────────────────────────────────────────────
+
+/**
+ * POI 搜索
+ * @param {Object} params
+ * @param {string} params.keywords - 搜索关键词
+ * @param {string} [params.city] - 城市名称
+ * @param {string} [params.location] - 中心点 "经度,纬度"
+ * @param {number} [params.radius] - 搜索半径(米)
+ * @param {string} [params.types] - POI 分类筛选
+ * @param {number} [params.page=1] - 页码
+ * @param {number} [params.pageSize=10] - 每页数量(最大20)
+ * @returns {Promise<Object|null>}
+ */
+async function searchPOI(params) {
+  const key = ensureKey();
+  const url = 'https://apis.map.qq.com/ws/place/v1/search';
+  const hasCoord = params.location && params.radius;
+
+  const queryOpts = {
+    key,
+    keyword: params.keywords || '',
+    page_index: params.page || 1,
+    page_size: Math.min(params.pageSize || params.offset || 10, 20),
+    output: 'json',
+  };
+
+  if (hasCoord) {
+    const latLng = flipCoord(params.location);
+    queryOpts.boundary = `nearby(${latLng},${params.radius})`;
+  } else if (params.city) {
+    const expandArea = params.cityLimit === false ? 1 : 0;
+    queryOpts.boundary = `region(${params.city},${expandArea})`;
+  }
+
+  if (params.types) {
+    queryOpts.filter = `category=${params.types}`;
+  }
+
+  const data = await httpGet(url, queryOpts);
+  if (!data) return null;
+
+  if (data.status === 0) {
+    const count = data.count || (data.data ? data.data.length : 0);
+    const pois = (data.data || []).map((item) => ({
+      name: item.title,
+      address: item.address || '',
+      type: item.category || '',
+      tel: item.tel || '',
+      location: `${item.location.lng},${item.location.lat}`,
+      distance: item._distance || undefined,
+      id: item.id || '',
+    }));
+    return { status: '1', count, pois, _raw: data };
+  }
+  throw new Error(`POI 搜索失败: ${data.message}`);
+}
+
+// ─── 路径规划 ────────────────────────────────────────────────────────
+
+/**
+ * 步行路径规划
+ */
+async function walkRoute(params) {
+  const key = ensureKey();
+  const data = await httpGet('https://apis.map.qq.com/ws/direction/v1/walking/', {
+    key,
+    from: flipCoord(params.origin),
+    to: flipCoord(params.destination),
+    output: 'json',
+  });
+  if (!data) return null;
+  if (data.status === 0) {
+    const route = data.result.routes[0];
+    return {
+      status: '1',
+      route: {
+        paths: [{
+          distance: route.distance,
+          duration: route.duration,
+          direction: route.direction || '',
+          steps: route.steps || [],
+        }],
+      },
+      _raw: data,
+    };
+  }
+  throw new Error(`步行规划失败: ${data.message}`);
+}
+
+/**
+ * 驾车路径规划
+ */
+async function driveRoute(params) {
+  const key = ensureKey();
+  const queryOpts = {
+    key,
+    from: flipCoord(params.origin),
+    to: flipCoord(params.destination),
+    output: 'json',
+  };
+  if (params.policy) queryOpts.policy = params.policy;
+  if (params.plate_number) queryOpts.plate_number = params.plate_number;
+  if (params.waypoints) {
+    queryOpts.waypoints = params.waypoints
+      .split(';')
+      .map((wp) => flipCoord(wp))
+      .join(';');
+  }
+
+  const data = await httpGet('https://apis.map.qq.com/ws/direction/v1/driving/', queryOpts);
+  if (!data) return null;
+  if (data.status === 0) {
+    const route = data.result.routes[0];
+    return {
+      status: '1',
+      route: {
+        paths: [{
+          distance: route.distance,
+          duration: route.duration,
+          toll: route.toll || 0,
+          traffic_light_count: route.traffic_light_count || 0,
+          restriction: route.restriction || null,
+          tags: route.tags || [],
+          steps: route.steps || [],
+        }],
+      },
+      _raw: data,
+    };
+  }
+  throw new Error(`驾车规划失败: ${data.message}`);
+}
+
+/**
+ * 骑行路径规划（自行车）
+ */
+async function cycleRoute(params) {
+  const key = ensureKey();
+  const data = await httpGet('https://apis.map.qq.com/ws/direction/v1/bicycling/', {
+    key,
+    from: flipCoord(params.origin),
+    to: flipCoord(params.destination),
+    output: 'json',
+  });
+  if (!data) return null;
+  if (data.status === 0) {
+    const route = data.result.routes[0];
+    return {
+      status: '1',
+      route: {
+        paths: [{
+          distance: route.distance,
+          duration: route.duration,
+          direction: route.direction || '',
+          steps: route.steps || [],
+        }],
+      },
+      _raw: data,
+    };
+  }
+  throw new Error(`骑行规划失败: ${data.message}`);
+}
+
+/**
+ * 电动车路径规划
+ */
+async function ecycleRoute(params) {
+  const key = ensureKey();
+  const data = await httpGet('https://apis.map.qq.com/ws/direction/v1/ebicycling/', {
+    key,
+    from: flipCoord(params.origin),
+    to: flipCoord(params.destination),
+    output: 'json',
+  });
+  if (!data) return null;
+  if (data.status === 0) {
+    const route = data.result.routes[0];
+    return {
+      status: '1',
+      route: {
+        paths: [{
+          distance: route.distance,
+          duration: route.duration,
+          direction: route.direction || '',
+          steps: route.steps || [],
+        }],
+      },
+      _raw: data,
+    };
+  }
+  throw new Error(`电动车规划失败: ${data.message}`);
+}
+
+/**
+ * 公交路径规划
+ */
+async function transitRoute(params) {
+  const key = ensureKey();
+  const queryOpts = {
+    key,
+    from: flipCoord(params.origin),
+    to: flipCoord(params.destination),
+    output: 'json',
+  };
+  if (params.policy) queryOpts.policy = params.policy;
+  if (params.departure_time) queryOpts.departure_time = params.departure_time;
+
+  const data = await httpGet('https://apis.map.qq.com/ws/direction/v1/transit/', queryOpts);
+  if (!data) return null;
+  if (data.status === 0) {
+    const routes = data.result.routes || [];
+    return {
+      status: '1',
+      route: {
+        transits: routes.map((route) => ({
+          duration: route.duration,
+          distance: route.distance || 0,
+          bounds: route.bounds || '',
+          steps: route.steps || [],
+        })),
+      },
+      _raw: data,
+    };
+  }
+  throw new Error(`公交规划失败: ${data.message}`);
+}
+
+// ─── 旅游规划 ────────────────────────────────────────────────────────
+
+/**
+ * 旅游规划助手
+ * @param {Object} params
+ * @param {string} params.city - 城市名称
+ * @param {string[]} params.interests - 兴趣关键词数组
+ * @param {string} [params.travelMode=walking] - 出行方式
+ * @returns {Promise<Object>}
+ */
+async function travelPlan(params) {
+  const { city, interests = [], travelMode = 'walking' } = params;
+  const placeList = [];
+  const renderItems = [];
+
+  for (const interest of interests) {
+    const result = await searchPOI({
+      keywords: interest,
+      city,
+      page: 1,
+      pageSize: 5,
+    });
+
+    if (result && result.pois && result.pois.length > 0) {
+      placeList.push(...result.pois);
+      result.pois.forEach((poi) => {
+        const [lng, lat] = poi.location.split(',').map(Number);
+        renderItems.push({
+          type: 'poi',
+          lnglat: [lng, lat],
+          sort: poi.type || interest,
+          text: poi.name,
+          remark: poi.address || `${interest}推荐`,
+        });
+      });
+    }
+  }
+
+  if (placeList.length >= 2) {
+    for (let i = 0; i < placeList.length - 1; i++) {
+      const start = placeList[i];
+      const end = placeList[i + 1];
+      const [startLng, startLat] = start.location.split(',').map(Number);
+      const [endLng, endLat] = end.location.split(',').map(Number);
+      const pathItem = {
+        type: 'route',
+        routeType: travelMode,
+        start: [startLng, startLat],
+        end: [endLng, endLat],
+        remark: `从 ${start.name} 到 ${end.name}`,
+      };
+      if (travelMode === 'transfer') pathItem.city = city;
+      renderItems.push(pathItem);
+    }
+  }
+
+  return { pois: placeList, mapTaskData: renderItems };
+}
+
+// ─── 导出 ────────────────────────────────────────────────────────────
+
+module.exports = {
+  // 配置
+  getKey,
+  setKey,
+  removeKey,
+  ensureKey,
+  loadConfigFile,
+  saveConfigFile,
+  CONFIG_DIR,
+  CONFIG_FILE,
+  // HTTP
+  httpGet,
+  // 坐标
+  flipCoord,
+  // 地理编码
+  geocode,
+  // POI
+  searchPOI,
+  // 路径规划
+  walkRoute,
+  driveRoute,
+  cycleRoute,
+  ecycleRoute,
+  transitRoute,
+  // 旅游
+  travelPlan,
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@tencent-map/lbs-skills",
+  "version": "0.0.1",
+  "description": "腾讯地图位置服务命令行工具，支持 POI 搜索、地理编码、周边搜索、路径规划、旅游规划、轨迹可视化等功能",
+  "bin": {
+    "tmap-lbs": "./bin/cli.js"
+  },
+  "main": "lib/index.js",
+  "files": [
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"no test\" && exit 0"
+  },
+  "keywords": [
+    "tmap",
+    "tencent-map",
+    "lbs",
+    "poi",
+    "geocoding",
+    "route-planning",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {}
+}