FocusAny v2.2.0 的重点不只是增加几个命令，而是把使用过程中的三类摩擦点分别降低了：选模型时更容易判断能力，排查 SDK 问题时有了更明确的入口，插件开发者也不必再把大型资源文件全部塞进安装包。
这三个变化分别影响模型使用者、开发调试人员和插件作者。下面按实际工作流拆开看。
模型能力标签：从“猜模型名”变成“看能力”
当模型数量达到几十个时，模型名称往往不能直接说明它支持什么。用户真正关心的通常是：
- 能否接收图片等多模态输入；
- 是否支持工具调用；
- 是否适合当前插件或自动化流程；
- 是否需要额外的运行环境或能力配置。
v2.2.0 在模型设置中增加更直观的能力标识。这样一来，选择模型时不必只依赖名称、上下文记忆或反复试错，而是可以先按能力筛选，再比较速度、成本和效果。
这类标签也有助于减少配置错误。例如，一个工作流需要调用外部工具，却误选了不支持工具调用的模型，问题可能要到运行阶段才暴露。能力标识前置了这类信息，能让错误更早被发现。
需要注意的是，标签解决的是“模型具备什么能力”的识别问题，并不等于模型在每个任务上的效果都一样。实际选型仍然要结合响应质量、延迟、上下文长度、费用以及服务端限制。
SDK CLI：把“能不能跑”与“怎么转发”变成可检查的步骤
SDK 或命令行工具遇到问题时，常见症状包括：认证配置不完整、网络无法访问服务端、插件依赖缺失，或者本地端口与转发配置不一致。过去，开发者可能需要手动检查环境变量、进程和端口，再拼接日志判断问题。
v2.2.0 为 SDK CLI 增加诊断与转发相关命令。它们的价值在于把排障流程标准化：
- 先检查本地安装、配置和连接状态；
- 再确认需要暴露或访问的服务端口；
- 最后通过转发能力连接本地插件、开发服务或远程环境。
一个适合团队文档的操作顺序如下。下面的命令演示的是实践方式；具体子命令和参数请以本地版本的 --help 输出为准。
# 确认当前 CLI 版本
focusany --version
# 查看 v2.2.0 提供的 SDK 子命令和参数
focusany sdk --help
# 查看诊断命令的实际用法；不同安装方式可能使用 diagnose 或 doctor 命名
focusany sdk diagnose --help
focusany sdk doctor --help
# 查看转发命令的实际用法
focusany sdk forward --help
如果团队要把检查动作放进开发脚本，可以先保留帮助探测，再执行实际命令，避免把未经确认的参数硬编码进 CI：
#!/usr/bin/env bash
set -euo pipefail
command -v focusany >/dev/null 2>&1 || {
echo "focusany CLI 未安装，请先完成安装" >&2
exit 1
}
focusany --version
focusany sdk --help
echo "请根据上面的帮助信息选择诊断子命令，例如："
echo " focusany sdk diagnose"
echo "或："
echo " focusany sdk doctor"
实际接入时，建议把诊断输出作为问题报告的一部分保存下来，但不要直接上传包含密钥、访问令牌或私有地址的完整环境信息。转发功能同样需要明确监听地址和端口，避免把只应在本机访问的开发服务暴露到不可信网络。
插件资源按需下载：缩小安装包，也改变了发布策略
插件经常包含模型文件、模板、图片、词典或其他大体积资源。如果这些资源全部打进插件包，会带来几个问题：
- 首次安装慢，更新时也要重复传输；
- 用户可能下载了永远不会使用的资源；
- 插件包体积变大，分发和缓存成本上升；
- 资源更新需要重新发布整个插件。
v2.2.0 支持插件资源按需下载。插件包可以只保留清单、代码和必要的小文件，在真正使用某个功能时再获取对应资源。
一个可采用的资源清单示例如下。字段名称需要根据 FocusAny 插件规范调整，这里展示的是一种清晰的组织方式：
# plugin-resources.yaml
plugin: image-toolkit
version: 2.2.0
resources:
- name: vision-model-small
url: https://example.invalid/assets/vision-model-small.bin
sha256: REPLACE_WITH_SHA256
size: 524288000
optional: true
download_when:
- image_analysis
- name: zh-dictionary
url: https://example.invalid/assets/zh-dictionary.dat
sha256: REPLACE_WITH_SHA256
size: 10485760
optional: true
download_when:
- chinese_ocr
插件代码可以把资源下载放在功能入口，而不是安装入口。伪代码流程可以写成：
from pathlib import Path
def ensure_resource(resource_name: str) -> Path:
"""由 FocusAny 的资源管理器负责下载、校验和缓存。"""
resource_path = Path(".focusany-cache") / resource_name
if resource_path.exists():
return resource_path
# 实际项目中调用 SDK 提供的按需资源 API，示意：
# path = focusany.resources.download(resource_name, verify_sha256=True)
# return path
raise RuntimeError(f"resource {resource_name!r} is not downloaded")
def analyze_image(image_path: str):
model_path = ensure_resource("vision-model-small")
# 使用 model_path 初始化推理流程
return {"image": image_path, "model": str(model_path)}
按需下载并不意味着可以忽略资源治理。生产环境至少要考虑版本固定、哈希校验、下载失败重试、断点续传、缓存目录权限和离线运行策略。对于受限网络环境，还应提供预下载或内部镜像方案。
如何评估是否升级
这次升级适合分三步验证，而不是直接把所有工作流一次性切换过去：
- 模型设置验证：确认团队常用模型的能力标签是否能覆盖选择场景，并记录标签与实际服务端能力是否一致。
- SDK 排障验证：在一台开发机上运行诊断命令，检查认证、网络和插件依赖是否能被快速定位。
- 插件安装验证：将一个大资源改为按需下载，比较安装包大小、首次使用延迟和缓存命中率。
上线前可以使用这份清单：
- [ ] 模型能力标签与业务工作流要求匹配；
- [ ] CI 或开发文档记录了 SDK CLI 的实际帮助输出和版本号；
- [ ] 转发只监听必要地址，并限制了可访问范围；
- [ ] 插件资源有固定版本和完整性校验；
- [ ] 资源下载失败时有清晰错误信息和恢复路径；
- [ ] 已准备离线安装、预下载或内部镜像方案。
总体来看，FocusAny v2.2.0 把“选择模型、排查连接、分发资源”这三件容易依赖经验的事情，推进成更可见、更可检查的流程。个人用户会更容易选对模型，开发者能更快缩小 SDK 问题范围，插件作者则可以把安装包和运行时资源拆开管理。升级时重点不在于盲目启用所有新能力，而在于先把它们接入现有的模型选择、调试和发布流程。