hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band

hoobnn/hoobnn-agent-mods/tree/main/claude-code/ts-band

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

TS ● 4/4 直連。◐ 黃色表示經過中繼或 DERP(會標出 DERP 區域,例如 DERP-sfo),○ 紅色表示離線。tailscale status --json;Claude 執行 tailscale up、down、set、switch、login、logout 後立即重新整理。claude -p 和 SDK 中不執行。先安裝 Tailscale,確認 tailscale 命令可用(macOS 應用程式內建的 CLI 也找得到),然後:
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 設定和系統語言環境;都沒有時使用英文。
hoobnn-agent-mods 中還有狀態列 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。請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。
claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install ts-band@hoobnn-agent-mods
简体中文 · English
在输入框上方显示 Tailscale 组网里各节点的连接状态。全部直连时只占一个小标记;有节点走中继或掉线时才把它们列出来。让 Claude 往远程机器部署、同步文件之前,先看一眼链路是否正常。

TS ● 4/4 直连。◐ 黄色表示走中继或 DERP(会标出 DERP 区域,如 DERP-sfo),○ 红色表示离线。tailscale status --json;Claude 执行 tailscale up、down、set、switch、login、logout 后立即刷新。claude -p 和 SDK 里不运行。先装好 Tailscale,确保 tailscale 命令可用(macOS 应用自带的 CLI 也能找到),然后:
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 设置和系统语言环境,都没有时用英语。
hoobnn-agent-mods 里还有状态栏 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。這是你的專案嗎?把這個徽章放進 README 或網站,連回本頁。