未来飞马
Fmode Studioskill-storage 技能

OBJECT STORAGE FOR AGENTS

对象存储 · 公开分享 · 大文件传输

skill-storage 是智能体的「仓库管理员」:把二进制大文件上传对象存储,本地磁盘零长期占用, 一键生成可转发、可嵌入的公网链接。个人级云存储、企业级云存储、大文件网关,三套能力合于一个技能。

三套能力 默认免密钥 零依赖 · Node ≥ 18 MPL-2.0 开源

CAPABILITIES

一个技能,三套存储能力

从个人素材到项目发布,再到大文件传输,用同一套命令覆盖完整的文件流转链路。

01

个人级云存储

把图片、音频、视频、HTML 报告等任意二进制文件上传对象存储,拿到一个可直接转发或嵌入的公网 URL,本地磁盘零长期占用。

node uploader.mjs put ./report.html --key report/202610/report.html
# → https://s3.fmode.cn/user/<你的ID>/report/202610/report.html

user/<你的ID>/… → https://s3.fmode.cn/…

适用场景:报告发布即分享、媒体素材托管、批量上传并公开读。

02

企业级云存储

面向项目部署的独立存储空间:注册项目后签发作用域受限的项目级 STS,产物发布到 app.fmode.cn/dev/<项目>/, 项目间彼此隔离。

# 注册/复用项目 → 签发项目级 STS → 上传到项目前缀
POST /api/apig/deploy/huaweicloud { token, projectId }
obsutil cp <file> obs://nova-cloud/dev/<ProjectID>/<file> -f -acl=public-read

dev/<ProjectID>/… → https://app.fmode.cn/…

适用场景:站点与报告发布、项目公开资源托管、跨开发者协作部署。

03

大文件网关

当聊天通道被不可协商的大小上限挡住时,生成一个接收页,让对方在浏览器里拖拽直传到对象存储,再用 collect 取回。平时不生成,超限才触发。

node uploader.mjs gateway ./out          # 生成并部署接收页 → 输出 URL
bash collect.sh --list                    # 查看到位槽位
bash collect.sh --out ~/inbox             # 下载取回并登记台账

拖拽直传 · 进度条 · 槽位取回

适用场景:通道超限(如企微入站 20MB)、对方文件从未到达智能体。

INSTALL

安装与获取

技能已发布到 npm,装一次即可在任意工具里调用;也可从 Gogs 仓库直接获取源码。 未来飞马将技能以 ESM 原生模块交付,Node.js ≥ 18 可直接 import,零依赖、零构建。

# npm 全局安装
$ npm i -g @fmode/skill-storage

# 或从仓库获取(fmode/skill-storage · Gogs)
$ git clone https://git.fmode.cn/fmode/skill-storage

AUTO INSTALL

切换不同工具,让 AI 自主安装

把下面任意一段提示词交给对应工具,它会自行完成全局安装并验证通道; 建议同时要求它「安装后自己实测一次」,避免装了一个空壳。

FmodeStudio / Claude Code

请安装 skill-storage 技能到全局(npm i -g @fmode/skill-storage),把它的 SKILL.md 与 scripts/ 放入你读取技能的全局位置,运行 node …/uploader.mjs test 确认通道可用,再汇报安装结果。

Codex CLI

请把 @fmode/skill-storage 的全局技能安装到我的 Codex 技能目录(npm 包解包后放入 ~/.codex/skills 或对应 AGENTS.md 引用),执行 test 自检,汇报可用的公开 URL 能力。

WorkBuddy / Trae / 千问

请在我的工作台安装 skill-storage 技能:从 https://git.fmode.cn/fmode/skill-storage 获取,注册为全局技能,并跑通「上传一个测试文件拿到公开 URL」的完整实测。

FmodeAgent / Hermes Agent

请把 /opt/data/skills/fmode-storage 或 npm 包 @fmode/skill-storage 加入我的全局技能库(skills/ 目录),执行 node …/uploader.mjs test 自检,汇报 ok/via。

Gemini CLI / 其他工具

请安装 skill-storage(npm i -g @fmode/skill-storage),按你的技能格式注册 SKILL.md,并用 uploader.mjs 上传一个小文件验证公开链接可访问。

QUICKSTART

三行命令跑通

安装 skill-storage 后,无需配置任何 AK/SK:只要环境里有登录态,平台云函数就按调用者身份签发临时上传地址, 密钥由云函数保管,永不下发到调用方。

  • 01上传即 public-read,无需额外设置权限
  • 02按扩展名自动推断并透传 Content-Type,HTML 上传后可直接在浏览器渲染
  • 03覆盖同名 key 后 CDN 缓存较久,建议换新路径发布
# 1. 自检通道
$ node uploader.mjs test

# 2. 上传任意文件 → 拿公开 URL
$ node uploader.mjs put ./report.html --key report/202610/report.html

# 3. 大文件被通道挡住 → 生成接收网关页
$ node uploader.mjs gateway ./out

需要写入平台桶(而非个人空间)时,才走 init 向导配置 OBS 子账号作为兜底。

SECURITY

密钥永不落盘的安全边界

未来飞马认为,存储能力的可信度来自边界而非承诺。skill-storage 把每一条权限收敛到必要范围。

密钥零落盘

AK/SK、sessionToken、STS 永不进仓库、日志、对话。默认通道由云函数保管密钥,容器只拿有效期较短的预签名地址。

权限收敛

个人级强制 user/<你的ID>/ 前缀,写不进别人的目录;项目级 STS 作用域限定在项目前缀内,不越权访问其他项目。

大文件网关安全

接收页不含任何密钥,每个文件独立槽位、独立预签名 URL;授权窗口较短,过期后页面自动失效,不沿用旧页。

诚实失败

通道全部失败时打印初始化向导并退出,绝不伪装成功;生成页面后必须先真传一个小文件实测,再发给对方。

把文件流转交给一个技能

从上传、分享到大文件传输,用一条命令完成,让 Agent 的交付物有一个稳定的公网出口。