@jetcrab/pi-desk-remote-debug

Pi Desk single-entry remote debugging gateway and tunnel UI

Packages

Package details

skill

Install @jetcrab/pi-desk-remote-debug from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@jetcrab/pi-desk-remote-debug

Package: @jetcrab/pi-desk-remote-debug
Version: 1.1.18
Published: Nov 6, 2026
Downloads: 2,442/mo · 521/wk
Author: jetcrab
License: Apache-2.0
Types: skill
Size: 512.9 KB
Dependencies: 3 dependencies · 0 peers

Pi manifest JSON

{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Desk — pi-desk-remote-debug

包名：@jetcrab/pi-desk-remote-debug。插件接口以源码导出为准，个人配置不随包分发。

官方说明：使用说明

公网调试需要由同机 Pi Desk 桌面端托管服务，并在桌面“隧道 → 连接设置”中保存控制服务地址和密钥。插件不附带或自动下载独立隧道程序；未由桌面端托管时，公网调试不可用。

插件调用同机桌面程序的 --tunnel-client --stats，每次调试使用独立临时提供端身份，不复用桌面提供端私钥，也不修改桌面发布表。项目 .pi/remote_debug.yaml 的端口和路由格式不变；公网访问仍由普通浏览器或 TCP 程序直接访问 host:port，不要求访问者安装隧道客户端。

日志中的“活动 TCP”是当前业务转发流数量，不是请求数或人数；公网入口的 direct/relay 仅表示网关到提供端的实际内层路径。连接统计只属于当前调试 CLI，不并入桌面本进程统计。

使用该插件前，桌面端须支持 --stats，并与隧道服务端同步使用 v2 协议；不支持时会提示升级，不静默移除统计参数或降级到旧 Noise 协议。升级在维护窗口进行，活动 TCP 会断开；回退使用备份的旧制品与配置。部署及 CLI 合同见隧道手册。

启动或重启时，若本机端口已被占用，会列出端口、进程名和 PID，询问是否强制结束并继续启动；取消不影响原服务。确认后重新核对占用者，变化时需再次确认。无法识别占用者、系统或 Pi Desk 自身占用时不提供强杀；其他活动调试任务及公网端口冲突仍需手动处理。macOS/Linux 的进程查询需要系统提供 lsof。

许可与来源见本目录的 LICENSE 和 SOURCE.md。