HSK CLI

它解决什么问题

调试本地页面时，把 localhost 上的 demo 发给同事或手机上的用户，是件麻烦事：没有公网 IP、没有域名、还得先起一台服务器。HSK CLI 把这类「临时公网暴露」的需求收敛成几条命令——文件分享、前端部署、内网端口映射，全部零配置，输出直接是可用链接。

核心能力

四种发布场景，一套命令行：

• 文件托管 hsk-cli host：单个文件或整个目录都能发布，目录会自动打包成 zip；目录内没有 index.html 时，需要通过 --entry-file 指定入口文件。
• 前端项目部署 hsk-cli deploy：构建产物直接上线。
• 内网穿透 hsk-cli tunnel：通过 --ip 与 --port 把本地动态服务映射到公网，适合本地跑着后端、临时调试 API 的场景。
• 微信文章转公网链接：先把公众号文章保存为本地 HTML，再交给 CLI 发布，绕过公众号的外链限制。

关键步骤很简单：判断意图 → 选对应子命令 → 加 --format json → 解析返回的链接。JSON 输出便于脚本或 Agent 直接消费，不必解析人类可读文本。

复用与更新也内置在工作流里：发布已有资源用 --resource-id，链接失效后可用 --reuse 重新生成而非重复上传。发布后可用状态检测确认链接是否仍有效，valid: false 时再决定是否复用发布。

适用边界与注意点

• 沙盒环境里不要用 --open（浏览器打不开），也不要用 --detach（进程会被杀掉），拿到链接后直接返回给用户即可。
• 隧道不通时，优先改用 hsk-cli host 做文件托管，比排查网络更省事。
• 端口号必须在 1-65535 范围内，传错会直接报错。
• macOS 首次运行可能被网络权限拦截，需要到「系统设置 → 隐私 → 本地网络」里放行。
• 客户端二进制需先行下载（hsk-cli download），上传失败通常与网络或文件大小有关。