CloudOPS 云盘管理

要解决什么问题

CloudOPS 这类私有云盘通常有完整的 Web 界面，但当操作要嵌入自动化流程时，来回切换窗口、点击上传下载很容易出错：临时文件不知道放哪、中文文件名在 PowerShell 的 Invoke-RestMethod + MemoryStream 路径下会变成乱码、团队文件和回收站只能靠手工翻找。这个技能把云盘操作收敛到一套 REST API 调用里，让上传、检索、分享、加密、团队协作都能在脚本中完成。

它如何工作

所有能力都围绕 Python requests + CloudOPS REST API 组织，不再依赖浏览器或 PowerShell。启动任何操作前，脚本会先调用 ensure_token() 获取有效凭证，遇到 401 会自动重新登录，减少手动维护 Token 的负担。连接参数集中在 cloudops_config.json，迁移实例只需修改 base_url；Token 缓存在 ~/.workbuddy/cloudops_token.json，无需手动编辑。

核心操作大致分几层：

• 文件生命周期：upload_file、download_file、search_files、list_files、rename_file、move_file / copy_file、delete_file，以及回收站 trash_list / restore_file。上传前会用 os.path.exists() 校验路径，文件名按 RFC 5987 编码，中文路径在 V8 中已由 Python requests 完整处理。
• 内容与安全：preview_file 支持 PDF、Office、图片、Markdown 等常见格式预览；encrypt_file / decrypt_file 使用 AES-256-CBC；share_file / list_shares / delete_share 管理分享链接，download_by_share 支持文件夹 ZIP 打包和密码校验。
• 协作与自动化：团队维度包含 list_teams、create_team、invite_member、join_team、list_members、team_files；Skill 维度提供 list_skills、create_skill、import_skill、update_skill、delete_skill、run_skill 和运行历史。
• 系统与连接：管理员可读取 get_system_settings、storage_analytics、manage_api_keys，并通过 list_servers / ping_server 获取服务器状态。SSH 终端和 VNC 远程桌面走 ssh_terminal / vnc_connect 获取连接信息，实际连接由 CloudOPS 桌面环境的终端和远程桌面应用完成。

典型流程很直接：用户表达意图，例如“把桌面上的 report.pdf 传到 Documents”，技能先确认文件存在，搜索目标文件夹 ID，再执行 POST /api/files/upload；返回结果会包含文件名、目录和 ID。加密分享、创建团队、远程下载等操作也遵循同样的“取 Token → 定位资源 → 调用 API → 中文反馈”结构。

适用边界与注意点

这个技能适合已经有 CloudOPS 实例、并且希望用脚本化方式管理云盘的场景。它不替代前端交互，而是把重复操作固化成可复用命令。部署地址不同只需改 base_url，但首次使用必须替换默认密码，并把实例地址加入 allowed_urls，防止凭证被发送到非预期目标。

运行远程 Skill 时需要做参数清洗，避免提示词注入。list_users、get_system_settings、webdav_config 等管理能力只应在确认有权限时使用。配置文件保存为 UTF-8 with BOM，读取时必须使用 encoding="utf-8-sig"。遇到 403 通常是权限不足，404 多半是资源不存在或已被移动，410 表示分享已过期；ensure_token() 已内置 401 重登，手动删除 ~/.workbuddy/cloudops_token.json 只是备用手段。

总之，它的价值在于把云盘操作从“打开页面点点点”变成可追踪、可审计的 API 调用，同时用 Python 解决长期困扰 PowerShell 脚本的中文文件名编码问题。