核心用法
here.now 是专为AI代理设计的云托管与存储技能,分为两大功能模块:
Sites(站点发布):通过 ./scripts/publish.sh 将HTML、文档、图片、PDF、视频等静态文件发布至 {slug}.here.now 的实时URL,支持自定义域名和SPA路由。匿名站点24小时过期,绑定API Key后永久保存。
Drives(私有云盘):通过 ./scripts/drive.sh 创建私密云端文件夹,存储代码、记忆、计划、研究资料等,支持跨会话持久化、路径级共享和代理间协作。使用Scoped Token实现安全的代理间文件交接。
认证流程:支持邮箱验证码获取API Key,推荐存储于 ~/.herenow/credentials(权限600),避免命令行暴露密钥。
显著优点
1. 零配置部署:无需服务器、域名或构建工具,单行命令即可发布可访问URL
2. AI原生设计:专为代理场景优化,支持程序化操作、状态文件追踪和自动化工作流
3. 双模式存储:公开站点与私有云盘分离,满足分享与保密的双重需求
4. 跨工具持久化:Drive文件可在不同会话、不同AI工具间共享
5. 细粒度权限:Drive支持路径前缀限制、读写权限控制和TTL过期设置
6. 丰富文件支持:自动为单文件生成富媒体预览,多文件生成导航目录
潜在局限
- 匿名限制:未认证站点24小时自动过期,需用户交互完成邮箱验证才能永久化
- 静态托管:仅支持静态文件,无服务器端执行能力(如PHP、Node.js运行时)
- 依赖外部服务:核心功能依赖here.now云平台可用性和API稳定性
- 学习成本:Drive的Scoped Token机制和路径前缀规则需要理解
- 平台锁定:数据存储于专有云服务,导出机制文档未明确
适合人群
- 需要快速原型展示、文档分享或临时托管的开发者与设计师
- 希望AI代理拥有"记忆"和"工作空间"的多会话用户
- 构建多代理协作系统、需要安全文件中转的技术团队
- 追求极简部署、不愿配置CDN或VPS的独立创作者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 密钥泄露 | API Key或Drive Token通过命令历史、日志暴露 | 强制使用credentials文件,禁止--api-key交互使用,设置600权限 |
| 敏感数据误公开 | 将私密文件误发布为Site而非存入Drive | 严格区分Sites(公开)与Drives(私有)的使用场景 |
| 匿名数据丢失 | 24小时过期机制导致临时站点意外消失 | 及时获取API Key,保存claim URL完成永久认领 |
| 代理权限越界 | Scoped Token范围过大或TTL过长 | 遵循最小权限原则,使用narrow pathPrefix和短TTL |
| 状态文件泄露 | `.herenow/state.json` 包含claim token | 加入.gitignore,不对外暴露本地路径 |
| 钓鱼域名风险 | 自定义域名可能被滥用 | 平台层面需配合DNS验证,用户侧警惕仿冒URL |
技术实现亮点
- 三步原子发布:create/update → upload → finalize,确保站点完全就绪后才可访问
- ETag乐观并发:Drive写入支持ETag校验,防止代理间覆盖冲突
- Client Attribution:--client参数支持按代理类型追踪可靠性指标
- 智能回退机制:文档获取失败时降级至本地skill和实时API行为
---
版本: 1.15.9 | 文档: https://here.now/docs