Changelog

Unreleased

0.5.5

• 新增 Codex Plugin 和 CompShare 插件市场配置，复用现有 CLI Skill，支持从 GitHub 安装； 将插件配置纳入源码包和发布版本一致性校验。
• 精简 README 插件说明，将 Codex Plugin 章节移到 WorkBuddy Connector 下方、SDK 上方。

0.5.4

• 修复 Windows 下 PowerShell 5.1/7 使用 GBK 代码页时中文 JSON 乱码或无法解析的问题，保持 UTF-8 输出和原有 JSON 数据结构。
• 适配 Windows 测试的平台条件，验证 DPAPI 凭证缓存加密，并完成监控、SSH、中文路径传输 和持久化远程任务的真实 PowerShell 回归。
• Windows 经 SSH 会话嵌套调用 OpenSSH 仍可能挂起，独立 PowerShell 实测通过。

0.5.3

• 恢复 instance monitor：自动定位实例地域并按最多 10 台分批查询，终端显示各设备最新 使用率和采样时间，JSON 保留 CPU、内存、GPU 与磁盘的完整时间序列；同步开放 MCP 只读调用。
• 适配监控接口的原生 JSON 数组和数组拼接签名，修复 SDK 展开实例 ID 导致的参数错误， 并移除“生产监控接口不可用”的旧提示。

0.5.2

• 精简 README 快速开始，移除图片、语音和文件传输示例，以及 SSH 细节和使用统计说明。
• 将 Skill 安装说明移到“安装”章节后。

0.5.1

• 修复 SSH 远程命令参数中的空格、空参数、引号和 Shell 特殊字符丢失的问题， 并使 --print 输出的命令与实际执行一致；Shell 脚本使用 -- sh -lc '脚本'。
• 文件传输共用 SSH 连接缓存，支持 --refresh、--no-cache、--cache-ttl 和 --connect-timeout；交互式 SSH 也应用连接超时，连接或认证失败后清除失效缓存。
• 修复 SCP 的 IPv6、SSH URI 和 -l 用户名覆盖处理，区分文件传输错误、远程命令错误 与连接或认证错误，避免把远程程序的 Permission denied 误判为认证失败。
• 非交互密钥认证不再请求密码，密码自动填写兼容 BatchMode 配置；缺失 SSH 程序或 askpass 助手时返回可读错误，JSON 输出能处理非 UTF-8 远程输出。
• 忽略损坏、结构无效或时间戳异常的 SSH 缓存，保持凭证文件权限且不修改已有父目录权限。
• 新增真实 OpenSSH 回归测试，覆盖参数、脚本、双向文件传输、主机密钥校验与远程任务。

0.5.0

• 对齐 MiniMax H3 视频 API：支持 480P、4K、最长 30 秒、Skill、静音、水印和模型筛选， 并允许只传尾帧或仅用素材生成。
• 新增 Qwen-Image 图片任务与 IndexTTS 2.5 语音任务命令，支持创建、查询、取消、删除、 参考素材上传与登记，以及图片价格、语音价格和音色管理。
• 新增视频 Skill 查询、创建、更新和删除命令，并开放对应 MCP 读写分类。

0.4.4

• 新增 WorkBuddy MCP + Skill Token 连接器，通过本地 stdio MCP 安全注入 API 公钥/私钥， 并区分只读、预演和需用户明确确认的写操作。

0.4.3

• 修复 Typer 0.27.2 环境中 CLI 启动时无法导入 Abort 的问题。

0.4.2

• 移除 compshare ask 产品知识问答功能。

0.4.1

• 将 minimax create 的提示词长度上限从 5000 个字符调整为 7000 个字符。

0.4.0

• 新增 bandwidth 命令组，支持查询独享带宽与实例 EIP 带宽归属，并通过先询价、 再确认的流程完成购买、改配、删除和共享/独享带宽切换。
• 新增 minimax 命令组，覆盖 MiniMax H3 视频任务创建、查询、列表、取消以及积分套餐包和 余额查询；模型 API Key 从独立环境变量读取，创建支持幂等键与预演。
• 兼容 Typer 0.27.1 的上下文与命令类型，确保 JSON 确认保护、结构化帮助和命令统计正常工作。

0.3.6

• 将 CLI 使用统计和反馈从旧外网 IP 的 /v1 接口迁移到 CompShare 外部网关， 通过 UCloud SDK 签名调用 CreateCSCLIEvent 和 CreateCSCLIFeedback。
• 网关拒绝使用统计或反馈请求时，返回明确的服务端错误信息。

0.3.5

• 精简 README 的安装和快速开始内容，新增 CompShare SDK 多语言示例入口。
• 新增可通过 npx skills 安装的 CompShare CLI Agent Skill，覆盖实例、镜像、存储、团队、 SSH、文件传输和远程任务等主要工作流。
• 发布版本校验不再依赖 README 中的硬编码版本号，并修正发布文档中的版本更新位置。

0.3.4

• 统一 JSON 顶层契约为 ok/schema_version/data/meta/error：错误提供稳定代码，列表使用精简的 data.items 和一致分页元数据，脱敏时返回字段路径；--json --version 与 --json --help 也输出 JSON。实例聚焦查询保留资源身份，并为缺失集合返回空数组。
• --json、--profile 和 --show-sensitive 支持出现在常见的子命令参数位置；参数预解析 不会跨越 --，避免截取远程命令的同名参数。
• config list 明确显示凭证来自配置文件、环境变量或混合来源；仅使用环境变量时不再把空的 default profile 显示为当前凭证。
• 包版本改为由 compshare_cli.__version__ 生成，并在发布前统一校验构建元数据、运行时版本、 README 和 Changelog。
• 移除用途有限的 --show-completion，保留 --install-completion 自动安装命令补全。
• 增加 instance schedule show 定时关机查询和 instance schedule extend --by 延期能力； 延期以原计划为基准，并在更新后重新查询验证。
• 增加纯客户端的 instance job 持久化远程任务管理，支持提交、列表、详情、双路日志及字节 偏移、等待、取消和历史清理；任务使用远端 XDG state 目录，可在本地终端或网络断开后继续 运行。

0.3.3

• 将语言设置从 lang 子命令调整为全局 --lang zh|en 选项，并将 feedback 在根命令 帮助中的位置调整到 config 与 doctor 之间。
• 增加 instance cp 双向复制；使用 :/path 标记实例路径，支持本地与实例之间自动认证、 自动递归的上传和下载，并保留原有 instance scp 上传语法兼容性。
• --json instance scp 现在会真实上传，并返回结构化执行结果；--print 保持为仅预览。
• JSON 模式不再启动凭证或危险操作确认提示；需要确认的操作必须显式传入 --yes。
• 交互确认在空输入或无效输入时最多重试三次。
• 增加标准 --version 选项，并改进全局 --json 位置错误提示。
• 实例列表按地域筛选时要求同时指定 --region 和 --zone，确保调用正确的 Zone 接口。
• instance show 显示实例软件入口；URL 默认脱敏，使用 --show-sensitive 后显示。
• instance show 支持按 IP、软件、规格、磁盘、计费、镜像和状态分组聚焦输出，并允许组合查询。
• 增加纯客户端的实例配置模板；支持本地创建、列表、查看、删除，以及通过 instance create --template NAME 加载并用显式参数覆盖模板值。
• 移除当前不可用的 instance monitor 和独立 instance software url 命令。
• 修正云盘列表误用实例接口的问题，改用 DescribeCompshareDisk 并完整显示 ResourceId；已卸载云盘也可被自动定位。
• 镜像收藏迁移到 Create/DeleteCompShareImageFavorite，使用社区镜像 GroupId；平台镜像 列表按类型执行正确的全局分页。
• 放宽镜像列表、网络检测、软件端口和模型查询中接口不需要的 Region/Zone 限制。
• 修正团队账单排序字段/方向的接口值，并让欠费汇总沿用列表的时间范围。
• 开放 Typer 内置的 Bash、Zsh、Fish 和 PowerShell 命令补全安装选项。

0.3.2

• JSON 模式远程命令返回结构化的退出码、标准输出、标准错误及连接/认证错误，不再只打印 SSH 命令。
• 实例创建默认等待到 Running，SSH 连接也会先等待实例运行，避免把创建接口成功误判为实例已就绪。
• --json 固定输出 UTF-8 字节，不再受 Windows GBK 活动代码页影响。
• instance ssh 增加按 profile 和实例隔离的一小时连接信息缓存，减少重复的实例查询。

0.3.1

• 补充 Windows PowerShell 虚拟环境的激活与未激活调用示例，说明 &、.\ 和路径引号的使用条件。
• doctor 在 Windows 上不再将无效的 POSIX 权限位当作配置泄露，改为提示由 Windows ACL 管理权限。
• Windows 上的交互式 instance ssh 使用 OpenSSH askpass 自动填写 API 返回的密码，不再降级为手动输入。

0.3.0

• instance ssh 默认自动填写 API 返回的登录密码，并提供 --no-auto-password 手动输入开关。
• 修正 instance ssh 和 instance scp 将 API 的 Base64 密码字段误当作明文密码的问题。
• 自动 SSH 登录现在接受首次出现的主机密钥，同时继续拒绝已记录主机的密钥变更。
• instance ssh INSTANCE_ID -- COMMAND 支持自动认证后非交互执行远程命令并透传退出码。
• 增加 instance scp INSTANCE_ID LOCAL_PATH REMOTE_PATH，支持自动认证上传文件及递归上传目录。
• 增加 compshare ask QUESTION 产品问答命令，支持引用来源和完整 JSON 响应。
• 增加 compshare feedback bug|suggest MESSAGE，直接向 Insights 服务提交分类反馈。
• 增加只包含指令名称、CLI 版本、操作系统和发生时间的异步使用统计。
• 移除全局默认 Region/Zone；资源位置仅使用请求参数或 API 响应，生命周期操作不再混用查询地域与实例实际可用区。
• 创建实例时的镜像选择支持完整 API 分页，并使用 f/b 前后翻页，不再因匹配超过 50 项而中止。
• 地域型镜像、网络、模型和软件接口会在 CLI 层要求其必需的 Region/Zone，全局接口不再携带无意义的地域参数。
• 默认递归隐藏密码、IP、访问 URL、令牌和登录命令；新增全局 --show-sensitive 以显式显示原始敏感字段。

0.2.1

• 兼容 API 将空列表返回为 null 的情况，空结果不再导致命令异常。
• 凭证配置改用权限受限的唯一临时文件原子写入，并清理写入失败的临时文件。
• 损坏的凭证配置和空配置名称现在会返回明确的 CLI 错误。
• 分页兼容 TotalCount 和 Total 两种总数字段。
• 非 UTF-8 镜像 README 文件现在会返回可读错误。

0.2.0

• 覆盖团队、邀请、成员额度、团队账单和操作日志的 17 个公开 Action。
• 支持批量启动、停止、重启、删除实例，并提供独立的 instance wait。
• 修正跨地域实例聚合后的筛选和分页语义，实例与镜像列表支持 --all。
• 增加只读的 doctor 环境诊断。
• 增加 instance create --max-price 价格保护。
• 最低运行版本继续保持 Python 3.9。

0.1.3

• 兼容新版 Typer 与 Click，直接运行 compshare 时显示帮助。

0.1.0

• 首次公开版本，支持 GPU 实例、实例镜像、云盘和 US3 挂载。