ZeroNews 提供了一组面向智能代理的 client skills，用于把常见的本地客户端操作整理成可复用的工作流。你可以把它理解成一层为 AI 协作场景准备好的任务能力封装，让代理在执行 zeronews CLI 时更稳定、更一致，也更贴近真实用户任务。
安装技能包
npx skills add git@github.com:sixtea/zeronews-client-skills.git
我能利用 Skill 做什么？
用于给 ZeroNews 客户端完成鉴权绑定。这个技能会优先走 zeronews authtoken，而不是手动修改本地配置文件。
- 适合场景：首次配置客户端、替换 AuthToken、准备长期运行环境
- 核心动作：绑定 token、写入
config.yml、返回 client_id 和 cloud_server_addr
- 关键命令：
zeronews --workdir {WORKDIR} authtoken {TOKEN}
zeronews-expose-service
用于把本地服务发布到公网入口。它围绕 zeronews add 组织交互，支持 https、tcp、tls，并可按需附带域名、带宽和 feature 配置。
- 适合场景：暴露本地 Web 服务、发布 TCP 服务、给调试环境分配公网入口
- 核心动作：创建隧道、等待端点下发、返回公网地址
- 关键命令：
zeronews --workdir {WORKDIR} add {TYPE} --port={PORT}
zeronews-inspect-client
用于只读检查本地客户端状态。它会结合 prg_runtime.json、本地 API、服务状态和日志来判断客户端是否已配置、是否已连接、当前端点是否正常。
- 适合场景：排查连接状态、确认端点是否已到达、检查运行健康度
- 核心动作：探测健康检查、读取
/api/v1/status、汇总端点状态
zeronews-manage-client-service
用于管理系统服务模式下的 ZeroNews 客户端。它会优先使用 zeronews service，而不是自己拼接守护进程脚本。
- 适合场景：安装服务、启动、停止、重启、查看状态、卸载服务
- 核心动作：根据操作系统调用原生命令，并明确反馈是否成功
- 关键命令：
zeronews --workdir {WORKDIR} service install
zeronews --workdir {WORKDIR} service start
zeronews --workdir {WORKDIR} service status
zeronews-expose-webhook
用于创建带 webhook 特性的 ZeroNews 隧道。它是 zeronews-expose-service 的能力扩展，适合处理标准 Webhook、微信支付回调和微信签约回调。
- 适合场景：开放本地回调地址、为支付回调增加验证能力、标准化第三方通知入口
- 核心动作：生成
--feature=webhook 与对应 --feature-config
- 关键命令：
zeronews --workdir {WORKDIR} add https --port={PORT} --feature=webhook --feature-config '{...}'
zeronews-share-files
用于通过 file_share 特性分享本地目录。它会要求使用绝对路径，并通过现有隧道流程发布文件共享入口。
- 适合场景：共享本地目录、提供文件浏览入口、对外暴露文档资料目录
- 核心动作：生成
file_share 配置、创建隧道、等待端点下发
- 关键命令：
zeronews --workdir {WORKDIR} add https --feature=file_share --feature-config '{...}'
zeronews-reset-client
用于彻底移除本地客户端状态。这个技能是破坏性的，只应该在用户明确要求清理本地状态时使用。
- 适合场景：明确要求重置本地环境、删除服务注册与运行时状态
- 核心动作：卸载服务、删除
config.yml、清理 runtime 与日志文件
- 关键命令：
zeronews --workdir {WORKDIR} reset
zeronews-reset-client 是破坏性操作，不应该被当作普通问题的默认修复方式。优先考虑检查状态、重新鉴权或重建隧道，只有在用户明确要求清理本地状态时才执行。
