hcs-obs-metaquery

Overview / 概述

为华为云 OBS（对象存储服务）提供元数据检索与 AI 内容感知能力的技能，全对标阿里云 alibabacloud-oss-manage-metaquery。

Prerequisites / 前置条件

• Python 3.8+
• 真实调用：huaweicloudsdkobs + huaweicloudsdkcore（见 requirements.txt）
• AI 语义检索：requests（REST API 调用华为云 Image Recognition / VIAS 服务）
• mock 模式无需任何第三方依赖

真实调用前需设置环境变量（不硬编码密钥）：

Workflow / 工作流

标量检索

基于 OBS ListObjects API 返回的元数据（key/size/last_modified），本地按文件名/大小/类型/时间过滤。

语义检索

华为云 OBS 无桶级向量索引服务（不同于阿里云 MetaQuery），采用组合方案：

• 图片对象：调用华为云 Image Recognition REST API 进行图像标签识别
• 视频对象：调用华为云 VIAS（视频分析服务）REST API 进行视频内容分析
• 将 AI 分析结果与 OBS 对象列表组合，按自然语言查询匹配返回

AI 内容感知开通/关闭

为桶配置 AI 分析能力，记录桶级 AI 配置状态（启用/关闭），对应阿里云 MetaQuery 的 ImageInsightEnable / VideoInsightEnable。

详见 references/obs-metaquery-api.md。

Core Commands / 核心命令

# 能力清单
python3 scripts/hcs-obs-metaquery.py capability-list --mock

# 标量检索（按文件名/大小/类型/时间过滤）
python3 scripts/hcs-obs-metaquery.py scalar-search --bucket my-bucket --mock
python3 scripts/hcs-obs-metaquery.py scalar-search --bucket my-bucket --name-filter ".png" --min-size 1024 --mock
python3 scripts/hcs-obs-metaquery.py scalar-search --bucket my-bucket --type image --mock

# 语义检索（以文搜图/视频）
python3 scripts/hcs-obs-metaquery.py semantic-search --bucket my-bucket --query "风景" --mock

# AI 内容感知开通（为桶配置图片/视频语义提取）
python3 scripts/hcs-obs-metaquery.py enable-ai --bucket my-bucket --ai-type image --mock
python3 scripts/hcs-obs-metaquery.py enable-ai --bucket my-bucket --ai-type video --mock

# AI 内容感知查询
python3 scripts/hcs-obs-metaquery.py ai-status --bucket my-bucket --mock

# AI 内容感知关闭
python3 scripts/hcs-obs-metaquery.py disable-ai --bucket my-bucket --mock

# 桶管理
python3 scripts/hcs-obs-metaquery.py create-bucket --bucket new-bucket --region cn-north-4
python3 scripts/hcs-obs-metaquery.py upload-object --bucket my-bucket --file /path/to/file.png
python3 scripts/hcs-obs-metaquery.py bucket-stats --bucket my-bucket --mock

# 桶列表
python3 scripts/hcs-obs-metaquery.py list-buckets --mock

# Markdown 表格输出
python3 scripts/hcs-obs-metaquery.py scalar-search --bucket my-bucket --format md --mock

Parameter Confirmation / 参数确认

输出

默认 JSON，字段因能力而异：

标量检索

{
  "capability": "scalar-search",
  "bucket": "my-bucket",
  "filters": {"name": ".png", "min_size": 1024, "type": "image"},
  "count": 2,
  "objects": [{"key": "img/photo.png", "size": 4096, "last_modified": "...", "type": "image"}]
}

语义检索

{
  "capability": "semantic-search",
  "bucket": "my-bucket",
  "query": "风景",
  "count": 3,
  "results": [{"key": "photos/landscape.png", "score": 0.95, "tags": ["mountain", "sky"]}]
}

AI 内容感知

{
  "capability": "enable-ai",
  "bucket": "my-bucket",
  "ai_type": "image",
  "status": "enabled",
  "service": "Image Recognition"
}

退出码

参考文档

• IAM 权限策略
• API 参考
• 验证方法
• 验收标准