ZeroNews Skills 是 ZeroNews 官方提供的一组面向 AI Agent 技能书， 指导 ZeroNews 的使用标准流程，用于指导 WorkBuddy、Deepseek、 Cursor、Claude Code、Codex 等 Agent 在不猜测/不乱操作的情况下，按照制定的标准流程自动完成 ZeroNews 的所有操作。

​
ZeroNews Skill 的仓库地址

​
安装 skill 包

​
全局安装 ZeroNews Skills 官方包：

​
要 AI Agent 帮我们安装

​
ZeroNews Skills 的应用示例

以下话术发给已安装 sixtea/zeronews-skills 的 Agent。AI Agent 须按 Skills Agent 安装与配置规程 执行（先装 skills → 装客户端 → login: true 后再映射）；通过 invoke 对应 Skill，禁止 未登录时猜端口或列监听。

​
映射本地 Web 服务

本机 3000 端口已有 HTTP 服务监听时，映射为公网 HTTPS 入口。
典型 Skill： zeronews-expose-service（类型 https，port=3000）。前置：客户端已 login: true 且在跑（可先 zeronews-inspect-client）。

​
添加自定义域名并代理

为账号添加子域（如 arpweb），再在该域名下代理本机服务。
典型 Skill： zeronews-manage-platform-domains（添加/管理子域）→ zeronews-expose-service（绑定域名与本地端口；未给端口时须先枚举并请用户选择，禁止默认 3000）。

​
SSH 远程隧道

将 192.168.1.200:22 的 SSH 以 TCP 隧道发布到公网（需本机网络能访问该主机，且客户端已登录）。
典型 Skill： zeronews-expose-service（类型 tcp，按 Skill 步骤配置目标主机/端口或等价转发；若 Skill 要求本机先有到内网的监听/代理，Agent 应说明前提，禁止 在未验证连通时宣称成功）。

​
LFS 分享目录

将本机目录 /opt/share 以 file_share / LFS 分享出去。
典型 Skill： zeronews-share-files（绝对路径 /opt/share，管理密码等见 Skill 内 FEATURE-CONFIGS）。前置：login: true。
若宿主已配置 ZeroNews MCP 且工具可用，同一意图可改走 ZeroNews MCP 路径；勿 在同一任务中混跑 MCP 与 Skills 规程。

​
能力总览

​
zeronews-install-client

从官方下载源安装 Linux / macOS / Windows 客户端，或 Docker 部署；绑定机器；启动运行时并验证设备在线。
  • 适合场景：从零安装、Docker 首次部署、本机尚无 zeronews 二进制
  • 绑定：原生默认 zeronews login（浏览器）；Docker 须用户提供 TOKEN 环境变量
  • 已安装：会自动与控制面版本比对并升级到最新（无需用户确认）
  • 启动：优先尝试 OS 服务；无权限或失败时回退前台 start
  • 交接：仅改鉴权 → zeronews-configure-client；仅查状态 → zeronews-inspect-client

​
zeronews-configure-client

在本机写入 config.yml，完成账号绑定。不要手改配置文件。
  • 适合场景：首次绑机、更换绑定、CLI 已装但未登录
  • 默认：zeronews login + 轮询 status --json 直至 login: true（NO_TTY=1 非交互）
  • 例外：用户已粘贴控制台 Auth Token 时 → zeronews authtoken {TOKEN}
  • 冲突：若出现 Local config file already exists, token update ignored → 须用户选择重置（zeronews-reset-client）或保留现有配置

​
zeronews-inspect-client

只读检查本机客户端：prg_runtime.json、本地 API、service status、日志与 本机 endpoints。
  • 适合场景：排查未连接、端点是否下发、映射前确认「已 login 且在跑」
  • 与账号 CLI 区别：账号级 show tunnels 见 zeronews-manage-account-tunnels

​
zeronews-manage-client-service

管理本机 ZeroNews 系统服务（安装 / 启动 / 停止 / 重启 / 状态 / 卸载）。
  • 适合场景：长期后台运行；Linux 常需 root / sudo
  • 关键命令：

​
zeronews-expose-service

把本地 TCP 端口发布为公网入口（https、tcp、tls）。不负责目录 LFS 或 Webhook 特性隧道。
  • 适合场景：暴露 Web、TCP 服务、SSH/RDP 等
  • 未指定端口：先枚举本机监听，让用户选择后再 add
  • 核心命令：

​
zeronews-expose-webhook

创建带 webhook 特性的 HTTPS 隧道（标准 Webhook、微信支付、微信签约等）。

​
zeronews-share-files

通过 file_share 分享本地目录（须绝对路径、管理密码等，见 skill 内 FEATURE-CONFIGS）。

​
zeronews-upgrade-client

将客户端升级到最新：device download-resolve / device upgrade，或按下载 URL 替换二进制。远程设备升级要求目标 online。
  • 与安装 skill 关系：zeronews-install-client 检测到旧版本时会自动走升级逻辑；也可单独 invoke 本 skill

​
zeronews-manage-account-tunnels

操作登录账号下的全部隧道（show tunnels --json、删除、enable/disable）。删除前须用户确认。
  • 前置：CLI login: true（本地客户端可不运行）
  • 非本 skill：仅看本机当前活跃映射 → zeronews-inspect-client

​
zeronews-manage-platform-domains

平台域名与子域前缀（6–12 位小写字母数字）、列出域名与端口、删除空域名或端口。不是「把本地 3000 映射出去」——那属于 zeronews-expose-service。

​
zeronews-manage-account-clients

列出账号绑定的设备、删除远程客户端、启用/禁用设备。删除与禁用须明确确认。本机安装/升级请用 zeronews-install-client / zeronews-upgrade-client。

​
zeronews-reset-client

破坏性：卸载本机服务、删除 config.yml、清理 runtime 与日志。仅在用户明确要求清理本机状态时使用；不要作为普通故障的默认手段。