\n \n ![\"Star](\"https://img.shields.io/badge/⭐_Star-项目-yellow?style=for-the-badge&logo=github\"){kind=icon}
\n \n
\" }\n3. 响应中获得 access_token 和 refresh_token\n4. 后续 API 请求携带 Authorization: Bearer \n```\n\n### 方式二：浏览器配对\n\n```bash\nhermeslink pair\n# 在浏览器打开终端输出的 Pairing page URL\n# 点击\"在此设备上配对\"，页面直接显示 access_token 和 refresh_token\n```\n\n### 方式三：命令行脚本（适合自动化）\n\n```bash\n# 1. 获取 connect_token\nCONNECT_TOKEN=$(hermeslink pair 2>&1 | grep \"Connect token:\" | awk '{print $NF}')\n\n# 2. 用 connect_token 换 access_token\ncurl -s -X POST http://localhost:18642/api/v1/auth/device-session \\\n -H \"Authorization: Bearer $CONNECT_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"device_label\":\"my-script\",\"device_platform\":\"cli\"}'\n```\n\n---\n\n> **Token 有效期**：access_token 2 小时，refresh_token 90 天。access_token 过期后用 refresh_token 换新，无需重新配对。\n\n## 命令一览\n\n| 命令 | 说明 |\n|------|------|\n| `hermeslink start` | 启动后台守护进程 |\n| `hermeslink stop` | 停止守护进程 |\n| `hermeslink restart` | 重启守护进程 |\n| `hermeslink status` | 查看运行状态 |\n| `hermeslink pair` | 生成配对 URL 和二维码 |\n| `hermeslink config get` | 查看当前配置 |\n| `hermeslink config set ` | 修改配置 |\n| `hermeslink autostart on` | 开机自启（同 `enable`）|\n| `hermeslink autostart off` | 关闭自启（同 `disable`）|\n| `hermeslink logs` | 查看 Link 日志 |\n| `hermeslink logs --gateway` | 查看 Hermes 网关日志 |\n| `hermeslink logs -n 100` | 查看最近 100 条日志 |\n| `hermeslink version` | 查看版本号 |\n\n## 配置\n\n```bash\nhermeslink config set port 18642 # 修改监听端口（默认 18642）\nhermeslink config set lan-host 192.168.1.10 # 手动指定局域网 IP（默认自动检测）\nhermeslink config set language zh-CN # 语言：auto / en / zh-CN\nhermeslink config set log-level debug # 日志级别：debug / info / warn / error\n```\n\n配置文件位于 `~/.hermeslink/config.json`。\n\n## API 参考\n\n服务默认监听 `http://0.0.0.0:18642`。所有需要鉴权的接口均使用 Bearer Token（`hlat_` 前缀）。\n\n交互式 Swagger 文档：**`http://localhost:18642/api/docs`**\n\n### Token 说明\n\n| Token | 前缀 | 有效期 | 用途 |\n|-------|------|--------|------|\n| Connect Token | 无前缀（base64url）| 5 分钟，一次性 | 兑换 access_token |\n| Access Token | `hlat_` | 2 小时 | 所有 API 请求 |\n| Refresh Token | `hlrt_` | 90 天 | 刷新 access_token |\n\n### 无需鉴权\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/pair` | 配对网页（浏览器打开） |\n| GET | `/api/v1/bootstrap` | 服务基础信息，含 link_id、版本、能力 |\n\n### 认证 / 设备\n\n所有以下接口需要 Header：`Authorization: Bearer hlat_xxx`\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/auth/me` | 当前 Token 信息及设备信息 |\n| POST | `/api/v1/auth/device-session` | 用 connect_token 换取 access/refresh token |\n| POST | `/api/v1/auth/refresh` | 用 refresh_token 换新 access_token |\n| POST | `/api/v1/auth/logout` | 撤销 refresh_token |\n\n**POST `/api/v1/auth/device-session`** 的 Authorization 头需放 **connect_token**（不是 hlat_），Body：\n\n```json\n{\n \"device_label\": \"我的设备\",\n \"device_platform\": \"ios|android|web|cli\",\n \"device_model\": \"可选，设备型号\"\n}\n```\n\n响应：\n\n```json\n{\n \"ok\": true,\n \"device\": { \"device_id\": \"dev_xxx\", \"label\": \"我的设备\", \"platform\": \"ios\" },\n \"access_token\": { \"token\": \"hlat_xxx\", \"expires_at\": \"2026-05-08T13:00:00Z\" },\n \"refresh_token\": { \"token\": \"hlrt_xxx\", \"expires_at\": \"2026-08-06T12:00:00Z\" }\n}\n```\n\n**POST `/api/v1/auth/refresh`** Body：\n\n```json\n{ \"refresh_token\": \"hlrt_xxx\" }\n```\n\n### 配对\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/pairing/session` | 查询配对会话状态（含 claimed 字段） |\n| POST | `/api/v1/pairing/claim` | App 端用来完成配对 |\n\n**GET `/api/v1/pairing/session`** 查询参数：`?session_id=ps_xxx`\n\n**POST `/api/v1/pairing/claim`** Body：\n\n```json\n{\n \"session_id\": \"ps_xxx\",\n \"claim_token\": \"connect_token值\",\n \"device_label\": \"My App\",\n \"device_platform\": \"ios\"\n}\n```\n\n### 系统状态\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/status` | 服务整体状态（版本、设备数、profiles 数量等） |\n| GET | `/api/v1/logs` | 最近日志（`?source=link\\|gateway&limit=50`） |\n\n### 设备列表\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/devices` | 列出所有已配对设备 |\n| PATCH | `/api/v1/devices/:deviceId` | 重命名设备（`{\"label\":\"新名字\"}`） |\n| DELETE | `/api/v1/devices/:deviceId` | 撤销设备（吊销 token） |\n| DELETE | `/api/v1/devices/:deviceId/app-listing` | 从列表中隐藏已撤销设备 |\n\n### 对话（Conversations）\n\n#### 活跃对话\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/conversations` | 列出活跃对话（`?limit=20&cursor=xxx`） |\n| GET | `/api/v1/conversations/search` | 搜索活跃对话（`?q=关键词`） |\n| POST | `/api/v1/conversations` | 新建对话 |\n| DELETE | `/api/v1/conversations` | 批量删除对话（`{\"conversation_ids\":[\"conv_xxx\"]}`） |\n| DELETE | `/api/v1/conversations/:id` | 删除单个对话 |\n| GET | `/api/v1/conversations/:id/messages` | 获取对话消息列表（含 `runtime` 上下文信息） |\n| POST | `/api/v1/conversations/:id/messages` | 发送消息 |\n| GET | `/api/v1/conversations/:id/events` | SSE 实时事件流 |\n| GET | `/api/v1/conversations/events` | 所有对话事件流（SSE） |\n| PATCH | `/api/v1/conversations/:id/title` | 重命名对话（`{\"title\":\"新标题\"}`） |\n| PATCH | `/api/v1/conversations/:id/model` | 切换模型（`{\"model_id\":\"xxx\"}`） |\n| PATCH | `/api/v1/conversations/:id/profile` | 切换 profile |\n| POST | `/api/v1/conversations/:id/ack` | 确认已读 |\n| POST | `/api/v1/conversations/:id/runs/:runId/cancel` | 取消对话内的某次执行 |\n| POST | `/api/v1/conversations/:id/approvals/:approvalId/approve` | 审批工具调用（允许，`{\"scope\":\"once\\|session\\|always\"}`） |\n| POST | `/api/v1/conversations/:id/approvals/:approvalId/deny` | 审批工具调用（拒绝） |\n| POST | `/api/v1/conversations/:id/blobs` | 上传附件 |\n| GET | `/api/v1/conversations/:id/blobs/:blobId` | 下载附件 |\n| DELETE | `/api/v1/conversations/:id/blobs/:blobId` | 删除附件 |\n\n#### 归档对话\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/conversations/archived` | 列出已归档对话（`?limit=20&cursor=xxx`） |\n| GET | `/api/v1/conversations/archived/search` | 搜索已归档对话（`?q=关键词`） |\n| POST | `/api/v1/conversations/:id/archive` | 归档对话（发送新消息时自动恢复为活跃） |\n| POST | `/api/v1/conversations/:id/unarchive` | 取消归档 |\n\n#### 批量清理计划\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/v1/conversations/clear-plans` | 创建批量删除计划（`{\"target_status\":\"active\\|archived\"}`） |\n| GET | `/api/v1/conversations/clear-plans/:planId` | 查询计划状态 |\n| POST | `/api/v1/conversations/clear-plans/:planId/execute` | 执行计划（批量删除） |\n\n#### 批量归档计划\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/v1/conversations/archive-plans` | 创建批量归档计划（`{\"exclude_conversation_ids\":[]}`） |\n| GET | `/api/v1/conversations/archive-plans/:planId` | 查询计划状态 |\n| POST | `/api/v1/conversations/archive-plans/:planId/execute` | 执行计划（批量归档） |\n\n#### 响应结构说明\n\n**ConversationSummary**（对话列表每项）：\n\n```json\n{\n \"id\": \"conv_xxx\",\n \"title\": \"对话标题\",\n \"created_at\": \"2026-05-09T00:00:00.000Z\",\n \"updated_at\": \"2026-05-09T00:00:00.000Z\",\n \"last_event_seq\": 12,\n \"usage\": { \"input_tokens\": 100, \"output_tokens\": 200, \"total_tokens\": 300, \"updated_at\": \"...\" },\n \"profile\": { \"uid\": \"prof_xxx\", \"name\": \"default\", \"display_name\": \"default\", \"avatar_url\": null },\n \"last_message\": { \"id\": \"msg_xxx\", \"role\": \"assistant\", \"content_preview\": \"消息摘要...\" }\n}\n```\n\n**GET `/api/v1/conversations/:id/messages`** 响应新增 `runtime` 字段：\n\n```json\n{\n \"ok\": true,\n \"messages\": [...],\n \"last_event_seq\": 12,\n \"runtime\": {\n \"profile\": { \"name\": \"default\", \"display_name\": \"default\", \"avatar_url\": null },\n \"model\": { \"id\": \"claude-3-5-sonnet\", \"provider\": \"anthropic\", \"context_window\": 200000 },\n \"context\": { \"input_tokens\": 100, \"output_tokens\": 200, \"total_tokens\": 300, \"usage_percent\": 0, \"source\": \"estimated\" }\n },\n \"page\": { \"limit\": 50, \"has_more_before\": false, \"has_more_after\": false, \"oldest_message_id\": \"...\", \"newest_message_id\": \"...\" }\n}\n```\n\n**LinkMessage**（消息对象）：\n\n```json\n{\n \"id\": \"msg_xxx\",\n \"schema_version\": 1,\n \"conversation_id\": \"conv_xxx\",\n \"role\": \"user|assistant|tool|system\",\n \"status\": \"queued|streaming|completed|failed|cancelled\",\n \"created_at\": \"...\",\n \"updated_at\": \"...\",\n \"sender\": { \"id\": \"app_user\", \"type\": \"human|agent|system|tool\", \"display_name\": \"Me\" },\n \"parts\": [{ \"type\": \"text\", \"text\": \"消息内容\" }],\n \"attachments\": [],\n \"blocks\": [],\n \"agent_events\": [],\n \"approvals\": []\n}\n```\n\n**DELETE `/api/v1/conversations/:id`** 响应新增字段：\n\n```json\n{\n \"ok\": true,\n \"conversation_id\": \"conv_xxx\",\n \"hermes_deleted\": false,\n \"deleted_at\": \"2026-05-09T00:00:00.000Z\"\n}\n```\n\n### 统计\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/statistics` | 全局使用统计（`?profile=xxx&profile_uid=xxx`） |\n| GET | `/api/v1/statistics/usage` | Token 用量统计（`?days=7&from=2026-05-01&to=2026-05-08&model=xxx&profile=xxx`） |\n\n**GET `/api/v1/statistics`** 响应：\n\n```json\n{\n \"ok\": true,\n \"statistics\": {\n \"conversations\": { \"total\": 10, \"active\": 8, \"archived\": 1, \"deleted\": 1 },\n \"tokens\": { \"input_tokens\": 5000, \"output_tokens\": 8000, \"total_tokens\": 13000 },\n \"messages\": { \"total\": 120 },\n \"runs\": { \"total\": 50 },\n \"models\": { \"total\": 0 },\n \"profiles\": { \"total\": 0 },\n \"skills\": { \"total\": 0 },\n \"tools\": { \"total\": 0 }\n }\n}\n```\n\n### 模型（Models）\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/models` | 列出可用模型（来自 Hermes API Server，OpenAI 兼容格式） |\n| GET | `/api/v1/model-configs` | 列出全局模型配置 |\n| POST | `/api/v1/model-configs` | 新增全局模型配置 |\n| PATCH | `/api/v1/model-configs/defaults` | 更新默认模型配置 |\n| DELETE | `/api/v1/model-configs` | 删除全局模型配置 |\n\n### Profiles\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/profiles` | 列出所有 Profile 名称 |\n| POST | `/api/v1/profiles` | 创建新 Profile（异步，返回 202） |\n| PATCH | `/api/v1/profiles/:name` | 重命名（`{\"name\":\"new-name\"}`）或更新元数据 |\n| DELETE | `/api/v1/profiles/:name` | 删除 Profile |\n| GET | `/api/v1/profiles/catalog` | 完整目录（包含各 Profile 的 capabilities、permissions、modelConfigs）|\n| GET | `/api/v1/profile-creation/status` | 查询创建进度 |\n| GET | `/api/v1/profile-creation/events` | 创建进度 SSE 流 |\n| GET | `/api/v1/profiles/:name/status` | Profile 状态（存在性、API Key 配置等） |\n| GET | `/api/v1/profiles/:name/statistics` | Profile 的对话统计 |\n| GET | `/api/v1/profiles/:name/skills` | 列出 Profile Skills（`?include_disabled=true`）|\n| PATCH | `/api/v1/profiles/:name/skills/:skillName` | 启用/禁用 Skill（`{\"enabled\":true}`） |\n| GET | `/api/v1/profiles/:name/memory` | 查看记忆（USER.md + MEMORY.md） |\n| POST | `/api/v1/profiles/:name/memory/entries` | 新增记忆条目（`{\"target\":\"memory\",\"content\":\"...\"}`) |\n| PATCH | `/api/v1/profiles/:name/memory/entries` | 替换记忆条目（`{\"target\":\"memory\",\"match\":\"旧内容\",\"content\":\"新内容\"}`）|\n| DELETE | `/api/v1/profiles/:name/memory/entries` | 删除记忆条目（`{\"target\":\"memory\",\"match\":\"匹配内容\"}`）|\n| DELETE | `/api/v1/profiles/:name/memory` | 重置记忆（`{\"target\":\"memory\\|user\\|all\"}`）|\n| PATCH | `/api/v1/profiles/:name/memory/settings` | 更新记忆 Provider 设置 |\n| PATCH | `/api/v1/profiles/:name/memory/provider` | 切换记忆 Provider（`{\"provider\":\"built-in\"}`）|\n| GET | `/api/v1/profiles/:name/permissions` | 查看权限配置 |\n| PATCH | `/api/v1/profiles/:name/permissions` | 更新权限配置 |\n| GET | `/api/v1/profiles/:name/tool-configs/:toolKey` | 查看工具配置（toolKey：`web` / `image_gen` / `stt` / `tts` / `messaging` / `homeassistant` / `rl`）|\n| PATCH | `/api/v1/profiles/:name/tool-configs/:toolKey` | 更新工具配置（同上 toolKey）|\n| GET | `/api/v1/profiles/:name/model-configs` | 列出 Profile 的模型配置 |\n| POST | `/api/v1/profiles/:name/model-configs` | 新增 Profile 的模型配置 |\n| PATCH | `/api/v1/profiles/:name/model-configs/defaults` | 更新 Profile 默认模型 |\n| DELETE | `/api/v1/profiles/:name/model-configs` | 删除 Profile 的模型配置 |\n\n记忆 `target` 字段：`\"memory\"`（Agent 笔记，MEMORY.md）或 `\"user\"`（用户信息，USER.md）。\n\n### Cron Jobs（定时任务）\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/cron-jobs` | 汇总列出所有 Profile 的定时任务 |\n| GET | `/api/v1/profiles/:name/cron-jobs` | 列出指定 Profile 的定时任务 |\n| POST | `/api/v1/profiles/:name/cron-jobs` | 创建定时任务 |\n| GET | `/api/v1/profiles/:name/cron-jobs/:jobId` | 查看定时任务详情 |\n| PATCH | `/api/v1/profiles/:name/cron-jobs/:jobId` | 更新定时任务 |\n| DELETE | `/api/v1/profiles/:name/cron-jobs/:jobId` | 删除定时任务 |\n| POST | `/api/v1/profiles/:name/cron-jobs/:jobId/pause` | 暂停定时任务 |\n| POST | `/api/v1/profiles/:name/cron-jobs/:jobId/resume` | 恢复定时任务 |\n| POST | `/api/v1/profiles/:name/cron-jobs/:jobId/run` | 立即执行定时任务 |\n\n### Runs（执行任务）\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/v1/runs` | 向 Hermes Agent 提交执行任务（返回 202） |\n| GET | `/api/v1/runs/:runId/events` | 订阅执行事件流（SSE 代理） |\n| POST | `/api/v1/runs/:runId/cancel` | 取消执行任务 |\n\n**POST `/api/v1/runs`** Body：\n\n```json\n{\n \"input\": \"请帮我整理 ~/Downloads 目录\",\n \"profile\": \"default\",\n \"instructions\": \"可选的系统指令\",\n \"session_id\": \"可选的会话 ID\",\n \"conversation_history\": []\n}\n```\n\n响应（202）：\n\n```json\n{\n \"run_id\": \"run_xxx\",\n \"fallback\": false\n}\n```\n\n### 更新管理（Updates）\n\n#### Hermes Agent 更新\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/hermes/update-check` | 检查 Hermes Agent 是否有新版本 |\n| GET | `/api/v1/hermes/update/status` | 查询 Hermes 更新进度 |\n| POST | `/api/v1/hermes/update` | 触发 Hermes Agent 更新 |\n| GET | `/api/v1/hermes/update/events` | 更新进度 SSE 流 |\n\n#### Link 自身更新\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/link/update-check` | 检查 Link 是否有新版本 |\n| GET | `/api/v1/link/update/status` | 查询 Link 更新进度 |\n| POST | `/api/v1/link/update` | 触发 Link 自更新（`{\"version\":\"0.3.0\"}`）|\n| GET | `/api/v1/link/update/events` | 更新进度 SSE 流 |\n\n### 系统（System）\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/api/v1/system/status` | 系统详情（版本、自启状态、网络环境）|\n| GET | `/api/v1/system/version` | 仅返回 Link 版本号 |\n| POST | `/api/v1/system/autostart/enable` | 开启开机自启 |\n| POST | `/api/v1/system/autostart/disable` | 关闭开机自启 |\n| GET | `/api/v1/system/logs` | 最近 Link 日志 |\n| GET | `/api/v1/system/logs/gateway` | 最近 Gateway 日志 |\n| GET | `/api/v1/system/updates` | 查询可用更新（Hermes + Link 汇总）|\n| POST | `/api/v1/system/updates/dismiss` | 忽略当前可用更新提示 |\n\n### 错误响应格式\n\n所有错误均返回：\n\n```json\n{\n \"ok\": false,\n \"error\": {\n \"code\": \"error_code\",\n \"message\": \"Human readable message\"\n }\n}\n```\n\n常见错误码：\n\n| code | HTTP | 说明 |\n|------|------|------|\n| `auth_required` | 401 | 未提供 Authorization |\n| `device_access_token_invalid` | 401 | access_token 已过期或无效 |\n| `auth_invalid` | 401 | connect_token 无效或已用过 |\n| `pairing_session_not_found` | 404 | 配对会话不存在 |\n| `pairing_session_expired` | 404 | 配对会话已过期 |\n| `pairing_claim_mismatch` | 409 | 配对 token 不匹配 |\n| `link_not_paired` | 409 | 服务尚未分配 link_id |\n\n## 调用示例\n\n### 全流程脚本\n\n```bash\n#!/bin/bash\nBASE=\"http://localhost:18642\"\n\n# Step 1: 生成配对 token\nCONNECT=$(hermeslink pair 2>&1 | grep \"Connect token:\" | awk '{print $NF}')\necho \"Connect token: $CONNECT\"\n\n# Step 2: 兑换 access_token 和 refresh_token\nRESP=$(curl -s -X POST \"$BASE/api/v1/auth/device-session\" \\\n -H \"Authorization: Bearer $CONNECT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"device_label\":\"my-script\",\"device_platform\":\"cli\"}')\n\nACCESS=$(echo $RESP | python3 -c \"import json,sys; print(json.load(sys.stdin)['access_token']['token'])\")\nREFRESH=$(echo $RESP | python3 -c \"import json,sys; print(json.load(sys.stdin)['refresh_token']['token'])\")\necho \"Access: $ACCESS\"\necho \"Refresh: $REFRESH\"\n\n# Step 3: 查询状态\ncurl -s \"$BASE/api/v1/status\" -H \"Authorization: Bearer $ACCESS\" | python3 -m json.tool\n```\n\n### 刷新 Token\n\n```bash\ncurl -s -X POST http://localhost:18642/api/v1/auth/refresh \\\n -H \"Content-Type: application/json\" \\\n -d \"{\\\"refresh_token\\\":\\\"$REFRESH\\\"}\"\n```\n\n### 查询设备列表\n\n```bash\ncurl -s http://localhost:18642/api/v1/devices \\\n -H \"Authorization: Bearer $ACCESS\"\n```\n\n### 查询对话列表\n\n```bash\ncurl -s \"http://localhost:18642/api/v1/conversations?limit=10\" \\\n -H \"Authorization: Bearer $ACCESS\"\n```\n\n## 开机自启\n\n- **macOS**：通过 launchd（`~/Library/LaunchAgents/com.hermes.link.plist`）\n- **Linux**：通过 systemd 用户服务或 XDG autostart\n- **Windows**：通过 Startup 文件夹\n\n```bash\nhermeslink autostart on\nhermeslink autostart off\n```\n\n## 运行时文件\n\n所有文件存储于 `~/.hermeslink/`：\n\n| 路径 | 说明 |\n|------|------|\n| `config.json` | 用户配置 |\n| `identity.json` | 设备身份（ed25519 密钥对 + link_id）|\n| `credentials.json` | 已配对设备的访问令牌 |\n| `app-connect-tokens.json` | 待使用的配对 token（5 分钟有效）|\n| `conversations/` | 对话数据 |\n| `blobs/` | 文件附件 |\n| `pairing/` | 配对会话 |\n| `link.db` | SQLite 数据库（统计信息）|\n| `logs/` | 日志文件 |\n\n卸载 npm 包不会删除此目录，重新安装后仍可复用同一 link_id。\n\n## 环境变量\n\n| 变量 | 说明 |\n|------|------|\n| `HERMESLINK_HOME` | 覆盖运行时目录（默认 `~/.hermeslink`）|\n| `HERMESLINK_LOG_LEVEL` | 覆盖日志级别 |\n| `HERMESLINK_LANG` | 覆盖语言（`en` / `zh-CN`）|\n| `HERMES_BIN` | `hermes` 二进制路径（默认 `hermes`）|\n| `HERMESLINK_LISTEN_HOST` | HTTP 监听地址（默认 `0.0.0.0`）|\n\n## 开发调试\n\n```bash\n# 安装依赖\nnpm install\n\n# 启动开发服务器 — 监听源码变化，自动编译并重启 daemon\nnpm run dev\n\n# 生产构建\nnpm run build\n\n# TypeScript 类型检查\nnpm run check\n```\n\n服务运行后可访问 `http://localhost:18642/api/v1/bootstrap` 验证是否正常。\n\n交互式 API 文档（Swagger UI）：`http://localhost:18642/api/docs`\n\n## License\n\nMIT\n","readmeFilename":"README.zh-CN.md"}