---
title: "ts-band"
url: "https://claudemods.dev/zh-tw/builds/ts-band-a5dba3"
source: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band"
source_type: "github"
repo: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band"
author: "hoobnn"
author_handle: "hoobnn"
stars: 8
category: "工具與整合"
categories: ["tools"]
tags: ["Claude Code", "mod"]
permission_level: 2
scan_complete: false
install: "claude plugin marketplace add hoobnn/hoobnn-agent-mods\nclaude plugin install ts-band@hoobnn-agent-mods"
added: "2026-10-04T10:40:36.873Z"
updated: "2026-11-09T14:28:07Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# ts-band

ts-band：在提示列上方用橫條顯示 Tailscale 節點狀態，節點上線或離線時顯示提示

## Description

# ts-band：在 Claude Code 中查看 Tailscale 節點狀態

**繁體中文** · [English](README.en.md)

在輸入框上方顯示 Tailscale 組網中各節點的連線狀態。所有節點都直連時只佔一個小標記；有節點經過中繼或離線時，才會列出來。讓 Claude 往遠端機器部署或同步檔案前，先看一眼連線是否正常。

![ts-band：兩個節點經過中繼，一個節點離線](assets/preview.png)

## 功能

- **正常時幾乎不佔空間**：所有節點上線且直連時，只顯示 `TS ● 4/4 直連`。
- **有異常才展開**：顯示上線節點數，接著只列出需要注意的節點：`◐` 黃色表示經過中繼或 DERP（會標出 DERP 區域，例如 `DERP-sfo`），`○` 紅色表示離線。
- **上線 / 離線提醒**：節點上線或離線時彈出 toast。
- **即時重新整理**：每分鐘讀取一次 `tailscale status --json`；Claude 執行 `tailscale up`、`down`、`set`、`switch`、`login`、`logout` 後立即重新整理。
- **讀取失敗不清空**：讀取失敗時保留上次的節點，並在後面附上錯誤訊息；之後的重試間隔會逐次加倍（最長 10 分鐘）。未安裝 CLI 或背景程式未啟動時，不會每次都重試。
- 在 `claude -p` 和 SDK 中不執行。

## 安裝

先安裝 [Tailscale](https://tailscale.com/download)，確認 `tailscale` 命令可用（macOS 應用程式內建的 CLI 也找得到），然後：

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band@hoobnn-agent-mods
```

## 命令

- `/ts`：切換顯示與隱藏；`/ts off`、`/ts on` 可直接設定。這項設定會寫回 `/config`，之後的工作階段也會沿用。

## 選項

在 `/config` 修改，或寫入 `~/.claude/settings.json` 的 `pluginConfigs`：

| 選項 | 作用 | 預設 |
| --- | --- | --- |
| `visible` | 顯示橫條（`/ts` 修改的就是它） | 開 |
| `nodes` | 只顯示這些節點，並依填寫順序排列；`host=名稱` 可以修改顯示名稱，例如 `nas=家裡, dev-box, vps-west=美西`。留白時顯示全部，上線數和提醒也只按選取的節點計算 | 空 |
| `hideOffline` | 不在橫條列出離線節點（上線數仍會計入） | 關 |
| `tailscalePath` | `tailscale` 命令的路徑；留白時依序在 PATH、Homebrew 和 macOS 應用程式中尋找 | 空 |
| `intervalSeconds` | 兩次讀取之間的秒數（至少 10） | 60 |
| `language` | 介面語言：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru` | `auto` |

`language` 為 `auto` 時，依序跟隨 Claude Code 的 `language` 設定和系統語言環境；都沒有時使用英文。

## 同系列 mod

[hoobnn-agent-mods](../../README.md) 中還有狀態列 HUD（`hud`）、任務進度條（`todo-bar`）、回合回執（`receipt`）、運行動畫和寵物（`spinner`）以及一言（`hitokoto`），可以搭配使用。

## 開發

- `hooks/register.tsx`：掛鉤（工作階段開始時的語言、`/ts` 和定時讀取、命令和橫條）。
- `hooks/config.ts`：選項，一次讀成型別化的 `Config`。
- `hooks/parse.ts`：把 `tailscale status --json` 解析成節點，把 `nodes` 選項解析成篩選規則。
- `hooks/i18n.ts`：各語言文案。
- `hooks/kit/`：`claude-code/kit` 的副本；修改原始檔後執行 `scripts/sync-kit.sh`。

## Install

```
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band@hoobnn-agent-mods
```

## Original README

# ts-band：在 Claude Code 里看 Tailscale 节点状态

**简体中文** · [English](README.en.md)

在输入框上方显示 Tailscale 组网里各节点的连接状态。全部直连时只占一个小标记；有节点走中继或掉线时才把它们列出来。让 Claude 往远程机器部署、同步文件之前，先看一眼链路是否正常。

![ts-band：两个节点走中继，一个节点离线](assets/preview.png)

## 功能

- **正常时几乎不占地方**：所有节点在线且直连时，只显示 `TS ● 4/4 直连`。
- **有异常才展开**：显示在线节点数，然后只列出需要注意的节点：`◐` 黄色表示走中继或 DERP（会标出 DERP 区域，如 `DERP-sfo`），`○` 红色表示离线。
- **上线 / 掉线提醒**：节点上线或掉线时弹 toast。
- **及时刷新**：每分钟读一次 `tailscale status --json`；Claude 执行 `tailscale up`、`down`、`set`、`switch`、`login`、`logout` 后立即刷新。
- **读取失败不清空**：读取失败时保留上次的节点，后面附上错误信息；之后的重试间隔逐次翻倍（最长 10 分钟），没装 CLI 或守护进程没开时不会每次都重试。
- 在 `claude -p` 和 SDK 里不运行。

## 安装

先装好 [Tailscale](https://tailscale.com/download)，确保 `tailscale` 命令可用（macOS 应用自带的 CLI 也能找到），然后：

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install ts-band@hoobnn-agent-mods
```

## 命令

- `/ts`：切换显示和隐藏；`/ts off`、`/ts on` 直接设定。这个设置会写回 `/config`，以后的会话也会沿用。

## 选项

在 `/config` 里修改，或写在 `~/.claude/settings.json` 的 `pluginConfigs` 里：

| 选项 | 作用 | 默认 |
| --- | --- | --- |
| `visible` | 显示横条（`/ts` 改的就是它） | 开 |
| `nodes` | 只显示这些节点，按填写顺序排列；`host=名字` 可以改显示名，如 `nas=家里, dev-box, vps-west=美西`。留空显示全部，在线数和提醒也只按选中的节点算 | 空 |
| `hideOffline` | 横条里不列离线节点（在线数仍然计入） | 关 |
| `tailscalePath` | `tailscale` 命令的路径；留空时依次在 PATH、Homebrew 和 macOS 应用里找 | 空 |
| `intervalSeconds` | 两次读取之间的秒数（至少 10） | 60 |
| `language` | 界面语言：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru` | `auto` |

`language` 为 `auto` 时，依次跟随 Claude Code 的 `language` 设置和系统语言环境，都没有时用英语。

## 同系列 mod

[hoobnn-agent-mods](../../README.md) 里还有状态栏 HUD（`hud`）、任务进度条（`todo-bar`）、回合回执（`receipt`）、运行动画和宠物（`spinner`）和一言（`hitokoto`），可以搭配使用。

## 开发

- `hooks/register.tsx`：钩子（会话开始时的语言、`/ts` 和定时读取，命令和横条）。
- `hooks/config.ts`：选项，一次性读成类型化的 `Config`。
- `hooks/parse.ts`：把 `tailscale status --json` 解析成节点，把 `nodes` 选项解析成筛选规则。
- `hooks/i18n.ts`：各语言文案。
- `hooks/kit/`：`claude-code/kit` 的副本；改源文件后运行 `scripts/sync-kit.sh`。
