TermPhone 部署手册

把电脑上的 WezTerm 装进口袋 · 钉钉账号登录
← 返回设备页

一、手机 App 绑定钉钉登录

  1. 手机安装 TermPhone App（HarmonyOS）或直接用钉钉：工作台 → 「Linus」应用。
  2. 首次进入登录页，点 「钉钉登录（扫码 / 打开钉钉授权）」：
    • 钉钉内打开：自动免登，无需操作；
    • 外部浏览器：唤起钉钉确认或扫码授权。
  3. 登录后进入「我的设备」页；会话保持 12 小时，过期重新点一下即可。

二、电脑端部署（三平台）

前提：电脑上已安装并正在运行 WezTerm （Windows 安装：winget install wezterm，需 Win10 1803+）。

macOS（Apple Silicon / M 系列）

⬇ termphone-agent-darwin-arm64 
curl -fLo termphone-agent https://codeagent.gqyl777.com/download/termphone-agent-darwin-arm64
chmod +x termphone-agent
xattr -d com.apple.quarantine termphone-agent 2>/dev/null || true
./termphone-agent --hub https://codeagent.gqyl777.com --pair 配对码 \
  --host 127.0.0.1 --port 7878 --token my-secret-token

macOS（Intel 芯片）

⬇ termphone-agent-darwin-amd64 
curl -fLo termphone-agent https://codeagent.gqyl777.com/download/termphone-agent-darwin-amd64
chmod +x termphone-agent
./termphone-agent --hub https://codeagent.gqyl777.com --pair 配对码 \
  --host 127.0.0.1 --port 7878 --token my-secret-token

Windows（x64）

⬇ termphone-agent-windows-amd64.exe 
curl.exe -o termphone-agent.exe https://codeagent.gqyl777.com/download/termphone-agent-windows-amd64.exe
Unblock-File .\termphone-agent.exe
.\termphone-agent.exe --hub https://codeagent.gqyl777.com --pair 配对码 --token my-secret-token

首次运行若弹 SmartScreen：右键 → 属性 → 解除锁定，或「仍要运行」。

三、获取配对码并绑定

  1. 手机 App 登录钉钉后 → 右上角「设置」→「切换电脑」→ 绑定新电脑（可起名字，如「书房 Mac」）。
  2. 页面显示 8 位配对码（15 分钟有效、仅一次），并附完整命令。
  3. 在电脑上执行上面的部署命令（把 配对码 替换进去）。成功后终端打印 [hub] 配对成功，App 设备页自动出现该电脑在线。
  4. 点设备名即进入 WezTerm 实时画面；一个钉钉账号可绑定多台电脑，随时切换。

四、开机自启（可选但推荐）

macOS：新建 ~/Library/LaunchAgents/com.termphone.agent.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.termphone.agent</string>
  <key>ProgramArguments</key><array>
    <string>/完整路径/termphone-agent</string>
    <string>--hub</string><string>https://codeagent.gqyl777.com</string>
    <string>--host</string><string>127.0.0.1</string>
    <string>--port</string><string>7878</string>
    <string>--token</string><string>my-secret-token</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict>
</dict></plist>
# 加载：launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.termphone.agent.plist

配对成功后凭证已保存在 ~/.config/termphone/device.json，自启命令不需要 --pair。

Windows（登录后静默运行）：

schtasks /Create /TN TermPhone /TR "'%CD%\termphone-agent.exe' --hub https://codeagent.gqyl777.com --token my-secret-token" /SC ONLOGON /RL LIMITED

五、常见问题

TermPhone · 我的设备