@fengye404/termpilot 0.1.7 → 0.1.9

package/README.md

@@ -1,99 +1,60 @@
 # TermPilot
 
-TermPilot 是一个终端优先的远程控制工具。电脑上跑 `tmux` 会话，手机直接打开 relay 域名查看和控制同一批会话。
+[![npm version](https://img.shields.io/npm/v/%40fengye404%2Ftermpilot)](https://www.npmjs.com/package/@fengye404/termpilot)
+[![npm downloads](https://img.shields.io/npm/dm/%40fengye404%2Ftermpilot)](https://www.npmjs.com/package/@fengye404/termpilot)
+[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/fengye404/TermPilot/docs.yml?branch=main&label=docs)](https://github.com/fengye404/TermPilot/actions)
 
-如果你已经准备长期部署，直接看完整运维文档：
+TermPilot 是一个终端优先的远程控制工具。它把电脑上的 `tmux` 会话暴露给手机浏览器，让你在电脑和手机之间无缝切换，同步查看和控制同一批任务。
 
-- [部署与运维指南](/Users/fengye/workspace/TermPilot/docs/operations-guide.md)
-
-## 产品形态
+## 为什么是它
 
 - 一个 npm 包：`@fengye404/termpilot`
 - 一个服务器命令：`termpilot relay`
 - 一个电脑命令：`termpilot agent`
 - 手机端不安装，直接打开 relay 域名
-- relay 同时负责消息中继和网页托管
-
-## 5 分钟快速上手
-
-### 1. 启动 relay
+- relay 同时负责 Web UI 托管和 WebSocket 中继
 
-在云服务器或一台能被手机访问到的机器上执行：
+## 30 秒理解工作流
 
-```bash
-npm install -g @fengye404/termpilot
-termpilot relay
-```
+1. 在服务器执行 `termpilot relay`
+2. 在电脑执行 `termpilot agent`
+3. 手机上打开 relay 域名并输入配对码
+4. 在电脑直接执行 `termpilot claude code`
+5. 手机和电脑同时看到同一个会话输出
 
-默认情况下，`termpilot relay` 会直接在后台启动 relay，不占当前窗口。
+## 快速开始
 
-常用 relay 管理命令：
+### 1. 启动 relay
 
 ```bash
+npm install -g @fengye404/termpilot
 termpilot relay
-termpilot relay stop
-termpilot relay run
 ```
 
-- `termpilot relay` 或 `termpilot relay start`：后台启动
-- `termpilot relay stop`：停止后台 relay
-- `termpilot relay run`：前台运行，适合看日志和排查问题
-
-如果你只是先本地体验，也可以直接在自己电脑上跑 relay，然后让手机走局域网访问。
-
-### 2. 启动电脑 agent
-
-在你的电脑上执行：
+### 2. 启动 agent
 
 ```bash
 npm install -g @fengye404/termpilot
 termpilot agent
 ```
 
-如果这是第一次运行，`termpilot agent` 会直接在终端里引导你：
+第一次运行时，`termpilot agent` 会交互式询问：
 
-1. 输入 relay 域名或 IP
-2. 输入端口，直接回车默认 `8787`
-3. 自动保存本机配置
-4. 后台启动 agent
-5. 输出一次性配对码
+1. relay 域名或 IP
+2. 端口，默认 `8787`
 
-以后日常只需要继续执行：
-
-```bash
-termpilot agent
-```
-
-这条命令会根据当前状态自动处理：
-
-- 没有后台 agent：按本机已保存配置启动
-- 已经有后台 agent：直接显示当前状态
-- 想重新给手机配对：执行 `termpilot agent --pair`
-
-常用管理命令：
-
-```bash
-termpilot agent status
-termpilot agent stop
-termpilot agent --pair
-```
+然后它会自动保存配置、后台启动 agent，并打印一次性配对码。
 
 ### 3. 手机完成配对
 
-手机浏览器直接打开 relay 域名：
+手机浏览器打开：
 
 - `http://your-domain.com:8787`
-- 或反代后的 `https://your-domain.com`
-
-然后：
-
-1. 输入电脑端刚打印出来的配对码
-2. 点“配对”
-3. 成功后直接进入会话列表
+- 或 `https://your-domain.com`
 
-### 4. 直接跑一个可同步的任务
+输入配对码后，直接进入会话列表。
 
-日常最短路径是：
+### 4. 直接启动任务
 
 ```bash
 termpilot claude code
@@ -105,163 +66,51 @@ termpilot claude code
 termpilot open code
 ```
 
-这会直接：
+这会直接创建一个受 TermPilot 管理的 `tmux` 会话并 attach 到当前终端，手机端会同步看到同一个会话。
 
-- 创建一个受 TermPilot 管理的 `tmux` 会话
-- 把命令写进这个会话
-- 当前终端自动 attach 进去
-- 手机端同步看到同一个会话
-
-### 5. 你现在应该能做到什么
-
-此时你可以：
-
-- 在电脑上看 `claude code` / `open code` 的流式输出
-- 在手机上看同一份输出
-- 在手机上补一条命令、发快捷键、关闭会话
-- 随时在电脑和手机之间切换
-
-### 服务器
-
-发布后：
-
-```bash
-npm install -g @fengye404/termpilot
-termpilot relay
-```
-
-当前仓库内本地验证：
-
-```bash
-pnpm install
-pnpm build
-npm install -g .
-termpilot relay
-```
-
-常用参数：
+## 常用命令
 
 ```bash
 termpilot relay
-termpilot relay run
 termpilot relay stop
-DATABASE_URL=postgresql://user:pass@127.0.0.1:5432/termpilot termpilot relay
-```
-
-### 电脑
-
-```bash
-npm install -g @fengye404/termpilot
+termpilot relay run
 termpilot agent
-```
-
-如果你只是想看调试日志，可以显式前台运行：
-
-```bash
-termpilot agent --foreground
-```
-
-查看后台状态：
-
-```bash
+termpilot agent --pair
 termpilot agent status
-```
-
-停止后台 agent：
-
-```bash
 termpilot agent stop
-```
-
-本地测试：
-
-```bash
-termpilot agent
-```
-
-### 手机
-
-直接打开 relay 域名：
-
-- `https://your-domain.com`
-
-首次使用时，直接执行上面的 `termpilot agent` 就会进入配置引导并拿到配对码；如果你已经跑着后台 agent、只是想重新给手机配对，用 `termpilot agent --pair`。
-
-配对成功后：
-
-- 访问令牌会自动写回页面
-- 手机端默认先显示会话列表
-- 点进一个会话后才进入终端详情页
-- 连接信息和设备设置都在页面底部折叠区
-
-## 日常使用
-
-### 直接把命令交给 TermPilot
-
-```bash
-termpilot agent
 termpilot claude code
 termpilot open code
-```
-
-如果你想跑别的命令，也可以直接：
-
-```bash
-termpilot npm run dev
-termpilot python worker.py
-```
-
-### 手动管理会话
-
-创建会话并进入：
-
-```bash
-termpilot create --name claude-main --cwd /path/to/project
+termpilot create --name my-task --cwd /path/to/project
 termpilot list
 termpilot attach --sid <sid>
+termpilot kill --sid <sid>
 ```
 
-进入会话以后，你仍然可以自己手动运行：
+## 文档
 
-```bash
-claude code
-# 或
-open code
-```
+- [文档首页](./docs/index.md)
+- [快速开始](./docs/getting-started.md)
+- [部署与运维指南](./docs/operations-guide.md)
+- [当前架构](./docs/architecture.md)
+- [当前协议](./docs/protocol.md)
+- [开发文档](./docs/development.md)
 
-此时手机和电脑看到的是同一个会话，输出会同步刷新。
+## 最佳实践
 
-## 常用命令
+1. 需要跨端同步的任务，一开始就用 `termpilot claude code`、`termpilot open code` 或 `termpilot create` 启动，不要先在普通终端里跑再想着接管。
+2. `termpilot agent` 适合作为长期后台入口。第一次配置完之后，日常只需要记住这一条命令。
+3. relay 长期使用时，优先挂到 HTTPS/WSS 域名后面；本地演示再用裸 IP 和 `8787`。
+4. 手机更适合看输出、发短命令和轻控制；电脑前的重输入仍然建议在本地终端完成。
+
+## 本地开发
 
 ```bash
-termpilot relay
-termpilot relay stop
-termpilot relay run
-termpilot agent
-termpilot agent --pair
-termpilot agent status
-termpilot agent stop
-termpilot create --name claude-main
-termpilot list
-termpilot attach --sid <sid>
-termpilot kill --sid <sid>
-termpilot grants
-termpilot audit --limit 30
-termpilot revoke --token <accessToken>
-termpilot doctor
+pnpm install
+pnpm build
+pnpm docs:dev
+pnpm test:ui-smoke
+pnpm check:stability
 ```
-
-## 最佳实践
-
-1. 需要跨端同步的任务，一开始就用 `termpilot create` 创建，不要先在普通终端里跑再想着接管。
-2. 第一次先跑一次 `termpilot agent` 完成本机配置，之后日常就只需要记住这一条命令。
-3. 如果只是想“开一个会话然后立刻跑起来”，优先用 `termpilot claude code` 这类直达命令，不必手动 `create + attach`。
-4. 一个长期任务用一个独立会话，名称直接写任务语义，比如 `claude-main`、`deploy-watch`、`batch-fix`。
-5. 电脑前重操作优先 `termpilot attach`；手机更适合看进度、发短命令、补快捷键和关闭会话。
-6. 普通 iTerm / Terminal 标签页不是 TermPilot 管理对象，不要指望后面“无缝接管”进来。
-7. 手机优先走一次性配对码，不要长期传播访问令牌。
-8. 要长期使用 relay，优先放到 HTTPS/WSS 域名后面，并接 PostgreSQL；本地演示可以先用内存模式。
-9. 换手机或访问权变更时，先 `termpilot grants`，再 `termpilot revoke --token ...`。
 10. 想排查控制历史时先看 `termpilot audit --limit 30`。
 11. 服务器上日常用 `termpilot relay` 后台运行；只有排查问题时才用 `termpilot relay run`。
 

package/dist/cli.js

@@ -849,11 +849,7 @@ function isLocalRelayHost(hostname) {
 }
 function normalizeRelayUrl(rawHost, rawPort) {
   const hostInput = rawHost.trim();
-  const portInput = rawPort.trim() || "8787";
-  const normalizedPort = Number(portInput);
-  if (!Number.isFinite(normalizedPort) || normalizedPort <= 0 || normalizedPort > 65535) {
-    throw new Error("\u7AEF\u53E3\u65E0\u6548\uFF0C\u8BF7\u8F93\u5165 1 \u5230 65535 \u4E4B\u95F4\u7684\u6570\u5B57\u3002");
-  }
+  const portInput = rawPort.trim();
   if (hostInput.includes("://")) {
     const parsed = new URL(hostInput);
     if (parsed.protocol === "http:") {
@@ -861,8 +857,14 @@ function normalizeRelayUrl(rawHost, rawPort) {
     } else if (parsed.protocol === "https:") {
       parsed.protocol = "wss:";
     }
-    if (!parsed.port) {
-      parsed.port = String(normalizedPort);
+    if (portInput) {
+      const normalizedPort2 = Number(portInput);
+      if (!Number.isFinite(normalizedPort2) || normalizedPort2 <= 0 || normalizedPort2 > 65535) {
+        throw new Error("\u7AEF\u53E3\u65E0\u6548\uFF0C\u8BF7\u8F93\u5165 1 \u5230 65535 \u4E4B\u95F4\u7684\u6570\u5B57\u3002");
+      }
+      parsed.port = String(normalizedPort2);
+    } else if (!parsed.port && parsed.protocol === "ws:" && isLocalRelayHost(parsed.hostname)) {
+      parsed.port = "8787";
     }
     if (!parsed.pathname || parsed.pathname === "/") {
       parsed.pathname = "/ws";
@@ -872,6 +874,16 @@ function normalizeRelayUrl(rawHost, rawPort) {
     return parsed.toString();
   }
   const protocol = isLocalRelayHost(hostInput) ? "ws:" : "wss:";
+  if (!portInput) {
+    if (protocol === "ws:") {
+      return `${protocol}//${hostInput}:8787/ws`;
+    }
+    return `${protocol}//${hostInput}/ws`;
+  }
+  const normalizedPort = Number(portInput);
+  if (!Number.isFinite(normalizedPort) || normalizedPort <= 0 || normalizedPort > 65535) {
+    throw new Error("\u7AEF\u53E3\u65E0\u6548\uFF0C\u8BF7\u8F93\u5165 1 \u5230 65535 \u4E4B\u95F4\u7684\u6570\u5B57\u3002");
+  }
   return `${protocol}//${hostInput}:${normalizedPort}/ws`;
 }
 async function promptForAgentConfig(deviceId) {
@@ -885,7 +897,7 @@ async function promptForAgentConfig(deviceId) {
     if (!host) {
       throw new Error("\u672A\u8F93\u5165 relay \u57DF\u540D\u6216 IP\uFF0C\u5DF2\u53D6\u6D88\u3002");
     }
-    const port = await rl.question("\u8BF7\u8F93\u5165 relay \u7AEF\u53E3\uFF08\u76F4\u63A5\u56DE\u8F66\u9ED8\u8BA4 8787\uFF09: ");
+    const port = await rl.question("\u8BF7\u8F93\u5165 relay \u7AEF\u53E3\uFF08\u53CD\u4EE3\u57DF\u540D\u53EF\u76F4\u63A5\u56DE\u8F66\uFF1B\u672C\u5730 IP \u9ED8\u8BA4 8787\uFF09: ");
     const relayUrl = normalizeRelayUrl(host, port);
     console.log(`\u5C06\u4F7F\u7528 relay: ${relayUrl}`);
     return { relayUrl, deviceId };
@@ -1324,7 +1336,8 @@ function loadRelayRuntime() {
       pid: parsed.pid,
       host: parsed.host,
       port: parsed.port,
-      startedAt: parsed.startedAt
+      startedAt: parsed.startedAt,
+      cliPath: typeof parsed.cliPath === "string" ? parsed.cliPath : void 0
     };
   } catch {
     return null;
@@ -1842,7 +1855,18 @@ function createStaticPath(webDir, urlPath) {
   return resolvedPath;
 }
 function resolveDefaultWebDir(moduleUrl = import.meta.url) {
-  return fileURLToPath(new URL("../../app/dist", moduleUrl));
+  const candidates = [
+    "../../app/dist",
+    "../app/dist",
+    "./app/dist"
+  ];
+  for (const candidate of candidates) {
+    const resolvedDir = fileURLToPath(new URL(candidate, moduleUrl));
+    if (existsSync(path3.join(resolvedDir, "index.html"))) {
+      return resolvedDir;
+    }
+  }
+  return fileURLToPath(new URL("../app/dist", moduleUrl));
 }
 async function startRelayServer(options = {}) {
   const config = {
@@ -2333,26 +2357,14 @@ function readRuntimeStatus2() {
   }
   return { runtime, alive };
 }
-function printRuntime(runtime = readRuntimeStatus2().runtime) {
-  if (!runtime) {
-    console.log("\u540E\u53F0 relay \u5F53\u524D\u672A\u8FD0\u884C\u3002");
-    console.log(`\u8FD0\u884C\u65F6\u6587\u4EF6: ${getRelayRuntimeFilePath()}`);
-    console.log(`\u65E5\u5FD7: ${getRelayLogFilePath()}`);
-    return;
-  }
-  console.log("\u540E\u53F0 relay \u6B63\u5728\u8FD0\u884C\u3002");
-  console.log(`PID: ${runtime.pid}`);
-  console.log(`\u76D1\u542C: http://${runtime.host}:${runtime.port}`);
-  console.log(`\u542F\u52A8\u65F6\u95F4: ${runtime.startedAt}`);
-  console.log(`\u65E5\u5FD7: ${getRelayLogFilePath()}`);
-}
 async function runForeground() {
   const config = loadConfig();
   saveRelayRuntime({
     pid: process.pid,
     host: config.host,
     port: config.port,
-    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    cliPath: process.argv[1]
   });
   process.on("exit", () => {
     clearRelayRuntime(process.pid);
@@ -2366,11 +2378,14 @@ async function runStart2() {
   const existing = readRuntimeStatus2();
   if (existing.runtime && existing.alive) {
     const sameConfig = existing.runtime.host === config.host && existing.runtime.port === config.port;
-    if (sameConfig) {
-      printRuntime(existing.runtime);
-      return;
+    const sameCliPath = existing.runtime.cliPath === process.argv[1];
+    if (sameConfig && sameCliPath) {
+      console.log("\u68C0\u6D4B\u5230\u540E\u53F0 relay \u5DF2\u5728\u8FD0\u884C\uFF0C\u6B63\u5728\u91CD\u542F\u5230\u5F53\u524D\u914D\u7F6E\u3002");
+    } else if (!sameCliPath) {
+      console.log("\u68C0\u6D4B\u5230\u540E\u53F0 relay \u6B63\u5728\u8FD0\u884C\uFF0C\u4F46\u5B89\u88C5\u7248\u672C\u6216\u5165\u53E3\u5DF2\u53D8\u5316\uFF0C\u6B63\u5728\u91CD\u542F\u5230\u5F53\u524D\u7248\u672C\u3002");
+    } else {
+      console.log("\u68C0\u6D4B\u5230\u540E\u53F0 relay \u5DF2\u5728\u8FD0\u884C\uFF0C\u4F46\u76D1\u542C\u914D\u7F6E\u548C\u5F53\u524D\u547D\u4EE4\u4E0D\u4E00\u81F4\uFF0C\u6B63\u5728\u91CD\u542F\u3002");
     }
-    console.log("\u68C0\u6D4B\u5230\u540E\u53F0 relay \u5DF2\u5728\u8FD0\u884C\uFF0C\u4F46\u76D1\u542C\u914D\u7F6E\u548C\u5F53\u524D\u547D\u4EE4\u4E0D\u4E00\u81F4\uFF0C\u6B63\u5728\u91CD\u542F\u3002");
     await runStop2();
   }
   clearRelayRuntime();
@@ -2389,7 +2404,8 @@ async function runStart2() {
     pid: child.pid,
     host: config.host,
     port: config.port,
-    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    cliPath: process.argv[1]
   });
   console.log(`\u540E\u53F0 relay \u5DF2\u542F\u52A8\uFF0CPID: ${child.pid}`);
   console.log(`\u76D1\u542C: http://${config.host}:${config.port}`);

package/docs/.vitepress/config.mts

@@ -0,0 +1,64 @@
+import { defineConfig } from "vitepress";
+
+const repo = process.env.GITHUB_REPOSITORY?.split("/")[1] ?? "TermPilot";
+const base = process.env.GITHUB_ACTIONS ? `/${repo}/` : "/";
+
+export default defineConfig({
+  lang: "zh-CN",
+  title: "TermPilot",
+  description: "手机和电脑共享同一个 tmux 会话的终端远程控制工具。",
+  base,
+  lastUpdated: true,
+  cleanUrls: true,
+  head: [
+    ["meta", { name: "theme-color", content: "#1f7a53" }],
+  ],
+  themeConfig: {
+    siteTitle: "TermPilot",
+    logo: "/favicon.svg",
+    nav: [
+      { text: "首页", link: "/" },
+      { text: "快速开始", link: "/getting-started" },
+      { text: "部署与运维", link: "/operations-guide" },
+      { text: "架构", link: "/architecture" },
+      { text: "协议", link: "/protocol" },
+    ],
+    sidebar: [
+      {
+        text: "开始",
+        items: [
+          { text: "文档首页", link: "/" },
+          { text: "快速开始", link: "/getting-started" },
+          { text: "部署与运维指南", link: "/operations-guide" },
+        ],
+      },
+      {
+        text: "参考",
+        items: [
+          { text: "代码架构", link: "/architecture" },
+          { text: "协议说明", link: "/protocol" },
+          { text: "开发文档", link: "/development" },
+          { text: "技术选型", link: "/tech-selection-2026" },
+        ],
+      },
+    ],
+    search: {
+      provider: "local",
+    },
+    socialLinks: [
+      { icon: "github", link: "https://github.com/fengye404/TermPilot" },
+    ],
+    editLink: {
+      pattern: "https://github.com/fengye404/TermPilot/edit/main/docs/:path",
+      text: "在 GitHub 上编辑此页",
+    },
+    outline: {
+      level: [2, 3],
+      label: "本页目录",
+    },
+    footer: {
+      message: "为长期任务和跨端终端控制而构建。",
+      copyright: "Copyright © 2026 Fengye",
+    },
+  },
+});

package/docs/.vitepress/dist/404.html

@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html lang="zh-CN" dir="ltr">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>404 | TermPilot</title>
+    <meta name="description" content="Not Found">
+    <meta name="generator" content="VitePress v1.6.4">
+    <link rel="preload stylesheet" href="/assets/style.B0lvUXq1.css" as="style">
+    <link rel="preload stylesheet" href="/vp-icons.css" as="style">
+    
+    <script type="module" src="/assets/app.BG4pRgiG.js"></script>
+    <link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
+    <meta name="theme-color" content="#1f7a53">
+    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
+    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"architecture.md\":\"JnC1zyYV\",\"development.md\":\"iwUVjeO6\",\"getting-started.md\":\"Cirp1CHi\",\"index.md\":\"D9XElNRh\",\"operations-guide.md\":\"DfNiIg5F\",\"protocol.md\":\"CCXFJUPR\",\"readme.md\":\"B4-OJVNQ\",\"tech-selection-2026.md\":\"Dk_ymWTx\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"TermPilot\",\"description\":\"手机和电脑共享同一个 tmux 会话的终端远程控制工具。\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"siteTitle\":\"TermPilot\",\"logo\":\"/favicon.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"快速开始\",\"link\":\"/getting-started\"},{\"text\":\"部署与运维\",\"link\":\"/operations-guide\"},{\"text\":\"架构\",\"link\":\"/architecture\"},{\"text\":\"协议\",\"link\":\"/protocol\"}],\"sidebar\":[{\"text\":\"开始\",\"items\":[{\"text\":\"文档首页\",\"link\":\"/\"},{\"text\":\"快速开始\",\"link\":\"/getting-started\"},{\"text\":\"部署与运维指南\",\"link\":\"/operations-guide\"}]},{\"text\":\"参考\",\"items\":[{\"text\":\"代码架构\",\"link\":\"/architecture\"},{\"text\":\"协议说明\",\"link\":\"/protocol\"},{\"text\":\"开发文档\",\"link\":\"/development\"},{\"text\":\"技术选型\",\"link\":\"/tech-selection-2026\"}]}],\"search\":{\"provider\":\"local\"},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/fengye404/TermPilot\"}],\"editLink\":{\"pattern\":\"https://github.com/fengye404/TermPilot/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页\"},\"outline\":{\"level\":[2,3],\"label\":\"本页目录\"},\"footer\":{\"message\":\"为长期任务和跨端终端控制而构建。\",\"copyright\":\"Copyright © 2026 Fengye\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    
+  </body>
+</html>

package/docs/.vitepress/dist/README.html

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html lang="zh-CN" dir="ltr">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>docs 目录 | TermPilot</title>
+    <meta name="description" content="手机和电脑共享同一个 tmux 会话的终端远程控制工具。">
+    <meta name="generator" content="VitePress v1.6.4">
+    <link rel="preload stylesheet" href="/assets/style.B0lvUXq1.css" as="style">
+    <link rel="preload stylesheet" href="/vp-icons.css" as="style">
+    
+    <script type="module" src="/assets/app.BG4pRgiG.js"></script>
+    <link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
+    <link rel="modulepreload" href="/assets/chunks/theme.D0_6rd9F.js">
+    <link rel="modulepreload" href="/assets/chunks/framework.BZohXCq9.js">
+    <link rel="modulepreload" href="/assets/README.md.B4-OJVNQ.lean.js">
+    <meta name="theme-color" content="#1f7a53">
+    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
+    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
+  </head>
+  <body>
+    <div id="app"><div class="Layout" data-v-1bdd7537><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0a4b5d46></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0a4b5d46>Skip to content</a><!--]--><!----><header class="VPNav" data-v-1bdd7537 data-v-07e0ee65><div class="VPNavBar" data-v-07e0ee65 data-v-bfcfe748><div class="wrapper" data-v-bfcfe748><div class="container" data-v-bfcfe748><div class="title" data-v-bfcfe748><div class="VPNavBarTitle has-sidebar" data-v-bfcfe748 data-v-6ce24249><a class="title" href="/" data-v-6ce24249><!--[--><!--]--><!--[--><img class="VPImage logo" src="/favicon.svg" alt data-v-105fdaa6><!--]--><span data-v-6ce24249>TermPilot</span><!--[--><!--]--></a></div></div><div class="content" data-v-bfcfe748><div class="content-body" data-v-bfcfe748><!--[--><!--]--><div class="VPNavBarSearch search" data-v-bfcfe748><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-bfcfe748 data-v-d1dc8fec><span id="main-nav-aria-label" class="visually-hidden" data-v-d1dc8fec> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-d1dc8fec data-v-82ee0671><!--[--><span data-v-82ee0671>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/getting-started" tabindex="0" data-v-d1dc8fec data-v-82ee0671><!--[--><span data-v-82ee0671>快速开始</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/operations-guide" tabindex="0" data-v-d1dc8fec data-v-82ee0671><!--[--><span data-v-82ee0671>部署与运维</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/architecture" tabindex="0" data-v-d1dc8fec data-v-82ee0671><!--[--><span data-v-82ee0671>架构</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/protocol" tabindex="0" data-v-d1dc8fec data-v-82ee0671><!--[--><span data-v-82ee0671>协议</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-bfcfe748 data-v-d994237e><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-d994237e data-v-9a85cf30 data-v-b1949eaf><span class="check" data-v-b1949eaf><span class="icon" data-v-b1949eaf><!--[--><span class="vpi-sun sun" data-v-9a85cf30></span><span class="vpi-moon moon" data-v-9a85cf30></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-bfcfe748 data-v-a61e22dd data-v-f3c77898><!--[--><a class="VPSocialLink no-icon" href="https://github.com/fengye404/TermPilot" aria-label="github" target="_blank" rel="noopener" data-v-f3c77898 data-v-8a10446f><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-bfcfe748 data-v-6d16081b data-v-35350ec6><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-35350ec6><span class="vpi-more-horizontal icon" data-v-35350ec6></span></button><div class="menu" data-v-35350ec6><div class="VPMenu" data-v-35350ec6 data-v-52b08d90><!----><!--[--><!--[--><!----><div class="group" data-v-6d16081b><div class="item appearance" data-v-6d16081b><p class="label" data-v-6d16081b>Appearance</p><div class="appearance-action" data-v-6d16081b><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6d16081b data-v-9a85cf30 data-v-b1949eaf><span class="check" data-v-b1949eaf><span class="icon" data-v-b1949eaf><!--[--><span class="vpi-sun sun" data-v-9a85cf30></span><span class="vpi-moon moon" data-v-9a85cf30></span><!--]--></span></span></button></div></div></div><div class="group" data-v-6d16081b><div class="item social-links" data-v-6d16081b><div class="VPSocialLinks social-links-list" data-v-6d16081b data-v-f3c77898><!--[--><a class="VPSocialLink no-icon" href="https://github.com/fengye404/TermPilot" aria-label="github" target="_blank" rel="noopener" data-v-f3c77898 data-v-8a10446f><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-bfcfe748 data-v-1e510fee><span class="container" data-v-1e510fee><span class="top" data-v-1e510fee></span><span class="middle" data-v-1e510fee></span><span class="bottom" data-v-1e510fee></span></span></button></div></div></div></div><div class="divider" data-v-bfcfe748><div class="divider-line" data-v-bfcfe748></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-1bdd7537 data-v-18894e30><div class="container" data-v-18894e30><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-18894e30><span class="vpi-align-left menu-icon" data-v-18894e30></span><span class="menu-text" data-v-18894e30>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-18894e30 data-v-bdfacdf2><button data-v-bdfacdf2>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-1bdd7537 data-v-1d1d7027><div class="curtain" data-v-1d1d7027></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-1d1d7027><span class="visually-hidden" id="sidebar-aria-label" data-v-1d1d7027> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-594fed9e><section class="VPSidebarItem level-0" data-v-594fed9e data-v-cd30f15d><div class="item" role="button" tabindex="0" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><h2 class="text" data-v-cd30f15d>开始</h2><!----></div><div class="items" data-v-cd30f15d><!--[--><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>文档首页</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/getting-started" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/operations-guide" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>部署与运维指南</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-594fed9e><section class="VPSidebarItem level-0" data-v-594fed9e data-v-cd30f15d><div class="item" role="button" tabindex="0" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><h2 class="text" data-v-cd30f15d>参考</h2><!----></div><div class="items" data-v-cd30f15d><!--[--><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/architecture" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>代码架构</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/protocol" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>协议说明</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/development" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>开发文档</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-cd30f15d data-v-cd30f15d><div class="item" data-v-cd30f15d><div class="indicator" data-v-cd30f15d></div><a class="VPLink link link" href="/tech-selection-2026" data-v-cd30f15d><!--[--><p class="text" data-v-cd30f15d>技术选型</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-1bdd7537 data-v-f89b4fb6><div class="VPDoc has-sidebar has-aside" data-v-f89b4fb6 data-v-1870bdbd><!--[--><!--]--><div class="container" data-v-1870bdbd><div class="aside" data-v-1870bdbd><div class="aside-curtain" data-v-1870bdbd></div><div class="aside-container" data-v-1870bdbd><div class="aside-content" data-v-1870bdbd><div class="VPDocAside" data-v-1870bdbd data-v-2bdf3a15><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2bdf3a15 data-v-3d03f0c2><div class="content" data-v-3d03f0c2><div class="outline-marker" data-v-3d03f0c2></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-3d03f0c2>本页目录</div><ul class="VPDocOutlineItem root" data-v-3d03f0c2 data-v-87a812ef><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2bdf3a15></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-1870bdbd><div class="content-container" data-v-1870bdbd><!--[--><!--]--><main class="main" data-v-1870bdbd><div style="position:relative;" class="vp-doc _README" data-v-1870bdbd><div><h1 id="docs-目录" tabindex="-1">docs 目录 <a class="header-anchor" href="#docs-目录" aria-label="Permalink to &quot;docs 目录&quot;">​</a></h1><p>如果你在 GitHub 仓库里浏览源码，推荐从下面几个入口开始：</p><ul><li><a href="./">文档首页</a></li><li><a href="./getting-started">快速开始</a></li><li><a href="./operations-guide">部署与运维指南</a></li><li><a href="./architecture">代码架构</a></li><li><a href="./development">开发文档</a></li></ul><p>如果 GitHub Pages 已经启用，优先看站点版本，它会带导航、目录和搜索。</p></div></div></main><footer class="VPDocFooter" data-v-1870bdbd data-v-b170fa4f><!--[--><!--]--><div class="edit-info" data-v-b170fa4f><div class="edit-link" data-v-b170fa4f><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/fengye404/TermPilot/edit/main/docs/README.md" target="_blank" rel="noreferrer" data-v-b170fa4f><!--[--><span class="vpi-square-pen edit-link-icon" data-v-b170fa4f></span> 在 GitHub 上编辑此页<!--]--></a></div><div class="last-updated" data-v-b170fa4f><p class="VPLastUpdated" data-v-b170fa4f data-v-33a4642e>Last updated: <time datetime="2026-03-11T17:35:45.000Z" data-v-33a4642e></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-b170fa4f><span class="visually-hidden" id="doc-footer-aria-label" data-v-b170fa4f>Pager</span><div class="pager" data-v-b170fa4f><!----></div><div class="pager" data-v-b170fa4f><a class="VPLink link pager-link next" href="/" data-v-b170fa4f><!--[--><span class="desc" data-v-b170fa4f>Next page</span><span class="title" data-v-b170fa4f>文档首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-1bdd7537 data-v-9a5ea44b><div class="container" data-v-9a5ea44b><p class="message" data-v-9a5ea44b>为长期任务和跨端终端控制而构建。</p><p class="copyright" data-v-9a5ea44b>Copyright © 2026 Fengye</p></div></footer><!--[--><!--]--></div></div>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"architecture.md\":\"JnC1zyYV\",\"development.md\":\"iwUVjeO6\",\"getting-started.md\":\"Cirp1CHi\",\"index.md\":\"D9XElNRh\",\"operations-guide.md\":\"DfNiIg5F\",\"protocol.md\":\"CCXFJUPR\",\"readme.md\":\"B4-OJVNQ\",\"tech-selection-2026.md\":\"Dk_ymWTx\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"TermPilot\",\"description\":\"手机和电脑共享同一个 tmux 会话的终端远程控制工具。\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"siteTitle\":\"TermPilot\",\"logo\":\"/favicon.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"快速开始\",\"link\":\"/getting-started\"},{\"text\":\"部署与运维\",\"link\":\"/operations-guide\"},{\"text\":\"架构\",\"link\":\"/architecture\"},{\"text\":\"协议\",\"link\":\"/protocol\"}],\"sidebar\":[{\"text\":\"开始\",\"items\":[{\"text\":\"文档首页\",\"link\":\"/\"},{\"text\":\"快速开始\",\"link\":\"/getting-started\"},{\"text\":\"部署与运维指南\",\"link\":\"/operations-guide\"}]},{\"text\":\"参考\",\"items\":[{\"text\":\"代码架构\",\"link\":\"/architecture\"},{\"text\":\"协议说明\",\"link\":\"/protocol\"},{\"text\":\"开发文档\",\"link\":\"/development\"},{\"text\":\"技术选型\",\"link\":\"/tech-selection-2026\"}]}],\"search\":{\"provider\":\"local\"},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/fengye404/TermPilot\"}],\"editLink\":{\"pattern\":\"https://github.com/fengye404/TermPilot/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页\"},\"outline\":{\"level\":[2,3],\"label\":\"本页目录\"},\"footer\":{\"message\":\"为长期任务和跨端终端控制而构建。\",\"copyright\":\"Copyright © 2026 Fengye\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    
+  </body>
+</html>