HaoyouBox Publish

HaoyouBox Agent 技能

中文说明

通过兼容的 AI Agent，将一个本地 HTML 或 Markdown 文件发布到 HaoyouBox。此技能会创建一个有时效、受密码保护的浏览器链接，并返回完整链接、可见密码和实际到期时间。

此仓库包含开源 Agent 技能及其文档。HaoyouBox 托管服务和服务端源代码不属于此仓库。

安装

Codex、Claude Code、Cursor 及其他受支持的 Agent

使用跨 Agent 技能安装程序：

npx skills add cheng-big/haoyoubox-agent-skill --skill haoyoubox-publish -g

请先检查技能，再批准安装。如果 Agent 没有立即发现该技能，请重启或重新加载 Agent。

Gemini CLI

gemini skills install https://github.com/cheng-big/haoyoubox-agent-skill --path skills/haoyoubox-publish

Gemini CLI 会请求安装许可。安装后使用 /skills list，确认 haoyoubox-publish 已启用。

手动安装

将 skills/haoyoubox-publish 目录复制到 Agent 支持的技能位置，例如 ~/.agents/skills/haoyoubox-publish。

当前托管版本仍可通过 haoyoubox.com/agent/SKILL.md 获取。

使用

向 Agent 提出请求：

Publish report.html to HaoyouBox and create a password-protected link that expires in 24 hours. Use English for the receiver page. Return the complete link, password, and actual expiry together.

对于中文接收者页面：

把 report.html 发布到好友盒，生成 24 小时密码保护链接。接收页使用中文。请一起返回完整链接、密码和实际到期时间。

首次使用时，Agent 会打开 HaoyouBox 设备授权流程。你需要登录 HaoyouBox 并批准该设备。随后，Agent 会将发布令牌存储在其私有凭据存储中。

发布内容

• 一个明确指定的 .html、.htm、.md 或 .markdown 文件。
• HaoyouBox 上适合在浏览器中查看的固定版本。
• 受密码保护且由服务器强制执行到期时间的链接。
• 中文或英文接收者界面。

此技能不会上传目录、ZIP 文件、隐藏文件、环境文件、密钥、符号链接或整个工作区。它不会读取上传历史、删除页面、撤销链接或管理账户。

安全

• 安装前请检查技能。
• 设备授权始终需要用户明确操作。
• 发布令牌必须保存在 Agent 的私有凭据存储中。
• 原始分享密码在本地生成。HaoyouBox 接收的是盐值和验证器，而非原始密码。
• 完整分享链接包含密码，方便预填。请将完整链接视为一项敏感访问凭据。
• 请勿发布包含机密、个人数据、私钥或环境变量的文件。

有关漏洞报告和令牌响应步骤，请参阅 SECURITY.md。

产品

• Agent 接入与安装
• 中文 Agent 接入说明
• 通过浏览器上传
• 安全边界

接收者可在浏览器中打开生成的链接，无需安装此技能或创建 HaoyouBox 账户。

贡献

请参阅 CONTRIBUTING.md。提交拉取请求前，请运行 npm test。

许可证

此仓库中的文件根据 Apache License 2.0 授权。使用 HaoyouBox 托管服务仍须遵守产品已公布的条款和政策。