SuperAPI AI 工具集

mo-misc

办公与效率

查看项目

更新于 10-16 06:49

技能介绍

用途:mocli misc 是墨问通用工具,当前主要能力是上传本地文件或远端 URL 到墨问,获取后续可被笔记、评论或其它墨问接口引用的 file_id。使用前需先阅读共享规则,其中包含 mocli 初始化、认证、输出解析与安全规则。

主要能力:命令为 mocli misc upload [--file] [--url] [--filename]。上传成功后返回 reply.file_id,并尽量返回文件名、MIME、大小和 file_meta 等元信息。reply 字段包括 file_id、file_type(通常为 IMAGE、AUDIO 或 PDF)、file_name、file_mime、file_size(字节)和 file_meta(JSON 字符串,音频可能含 duration,图片可能含 width/height)。

使用方式:--file 与 --url 二选一,不能同时传;--filename 可选,用于服务端展示名和上传表单文件名。本地路径建议用绝对路径。不要添加 --filetype,CLI 会读取文件内容或远端响应前 512 字节自动识别 MIME。示例:mocli misc upload --file /path/to/avatar.png;mocli misc upload --file /path/to/report.pdf --filename "产品报告.pdf";mocli misc upload --url "https://example.com/image.png" --filename "image.png";mocli misc upload --file /path/to/audio.wav。

适用场景:用户明确要求上传文件到墨问,或创建、编辑笔记前需要先获得图片、音频、PDF 的 file_id 时使用。若只是引用已有公网 URL 且目标接口支持直链,则不要自动上传。

限制:当前仅支持图片、音频和 PDF;HTML、纯文本、压缩包、视频或未知 MIME 会被拒绝。大小限制为图片小于 50MB、音频小于 200MB、PDF 小于 100MB。上传会向墨问服务端提交文件内容,涉及隐私或敏感信息应先确认。远端 URL 由 CLI 下载,需要登录态、临时签名或内网访问时可能失败。执行后按共享规则解析顶层 code、status、reason,成功展示 file_id,失败展示 reason、msg、meta.hints 等信息。