用途:通过 Dinox CLI 管理自定义 S3 存储,包括查看配置、测试连通性、上传文件、查看用量统计;为笔记内嵌媒体时应改用 dino-note。
主要能力与用法:
- dino storage list:列出 c_storage 中的自定义存储配置并标记当前活动配置。
- dino storage test:向自定义 S3 目标上传一个临时小对象且不写入 c_resource 行,支持 --storage-id 和 --dry-run。
- dino storage upload <file>:上传单个本地文件到自定义 S3 并写入 c_resource 行,支持 --storage-id、--category images|audios|files|videos、--key、--overwrite、--dry-run。
- dino storage stats:按提供方和存储桶汇总已上传用量。 建议使用 --format json,在线命令加 --sync-timeout 20000,主机超时再高 5–10 秒;测试与上传先 --dry-run 预览桶、主键与 URL。
限制与安全:凭据视为敏感数据,不要回显 secret_access_key,也不要在对话中索要或粘贴令牌;应通过 DINOX_TOKEN 注入或在用户终端执行 dino auth login --token-stdin。上传与测试仅面向自定义 S3 配置,若无配置需先在应用中创建。--key 默认拒绝替换已有主对象或派生缩略图,dry-run 不检查对象是否存在,--overwrite 须用户明确接受。拒绝含纯 . 或 .. 段的对象键与路径前缀。目标不明确、删除、覆盖、批量变更、修复或更新前需再次确认。超时按结果未知处理,重试前先核实键与新鲜度;stats 无条目表示尚无记录。