个人级云存储
把图片、音频、视频、HTML 报告等任意二进制文件上传对象存储,拿到一个可直接转发或嵌入的公网 URL,本地磁盘零长期占用。
node uploader.mjs put ./report.html --key report/202610/report.html
# → https://s3.fmode.cn/user/<你的ID>/report/202610/report.html 适用场景:报告发布即分享、媒体素材托管、批量上传并公开读。
CAPABILITIES
从个人素材到项目发布,再到大文件传输,用同一套命令覆盖完整的文件流转链路。
把图片、音频、视频、HTML 报告等任意二进制文件上传对象存储,拿到一个可直接转发或嵌入的公网 URL,本地磁盘零长期占用。
node uploader.mjs put ./report.html --key report/202610/report.html
# → https://s3.fmode.cn/user/<你的ID>/report/202610/report.html 适用场景:报告发布即分享、媒体素材托管、批量上传并公开读。
面向项目部署的独立存储空间:注册项目后签发作用域受限的项目级 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 适用场景:站点与报告发布、项目公开资源托管、跨开发者协作部署。
当聊天通道被不可协商的大小上限挡住时,生成一个接收页,让对方在浏览器里拖拽直传到对象存储,再用 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
把下面任意一段提示词交给对应工具,它会自行完成全局安装并验证通道; 建议同时要求它「安装后自己实测一次」,避免装了一个空壳。
请安装 skill-storage 技能到全局(npm i -g @fmode/skill-storage),把它的 SKILL.md 与 scripts/ 放入你读取技能的全局位置,运行 node …/uploader.mjs test 确认通道可用,再汇报安装结果。
请把 @fmode/skill-storage 的全局技能安装到我的 Codex 技能目录(npm 包解包后放入 ~/.codex/skills 或对应 AGENTS.md 引用),执行 test 自检,汇报可用的公开 URL 能力。
请在我的工作台安装 skill-storage 技能:从 https://git.fmode.cn/fmode/skill-storage 获取,注册为全局技能,并跑通「上传一个测试文件拿到公开 URL」的完整实测。
请把 /opt/data/skills/fmode-storage 或 npm 包 @fmode/skill-storage 加入我的全局技能库(skills/ 目录),执行 node …/uploader.mjs test 自检,汇报 ok/via。
请安装 skill-storage(npm i -g @fmode/skill-storage),按你的技能格式注册 SKILL.md,并用 uploader.mjs 上传一个小文件验证公开链接可访问。
QUICKSTART
安装 skill-storage 后,无需配置任何 AK/SK:只要环境里有登录态,平台云函数就按调用者身份签发临时上传地址, 密钥由云函数保管,永不下发到调用方。
# 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;授权窗口较短,过期后页面自动失效,不沿用旧页。
通道全部失败时打印初始化向导并退出,绝不伪装成功;生成页面后必须先真传一个小文件实测,再发给对方。
LINKS
源码、发行与经验记录集中在以下入口,便于团队检索与引用。