用途：把本地文件或文件夹批量上传到 Tiangong KB 集合，适合让智能体代为完成文档入库、集合列表查询与上传状态核对。
主要能力：通过固定入口 npx --yes --package "@tiangong-ai/cli@0.0.48" -- tiangong-ai 调用 CLI，无需预装。支持 kb ingest bulk、bulk scan、metadata dry-run、status，以及 kb collections list、schema。CLI 负责 SQLite 断点续传、并发与重试、JSON 输出、API key 与环境变量处理。技能负责选择最安全的集合选择器、在用户未提供 --metadata-map 时依据集合 schema 与目录扫描生成保守的 rule_mode: layered 元数据映射、先跑 dry-run 再批量入库，并解释 duplicate、existingDocumentId、documentId、status、jobId、requestId、idempotencyKey 等返回字段。
使用方式：先确认路径存在，优先用 --collection-name 或 TIANGONG_KB_DEFAULT_COLLECTION_NAME，仅在用户给出精确选择器时用 --collection-key、--collection-path 或 --collection-id。可读取目标目录的 .env 作为默认值，显式 CLI 参数优先。首次检查可运行 npx --yes --package "@tiangong-ai/cli@0.0.48" -- tiangong-ai kb collections list --json。上传示例：npx --yes --package "@tiangong-ai/cli@0.0.48" -- tiangong-ai kb ingest bulk /path/to/folder --upload-concurrency 3 --retries 3 --json。长任务可调 --window-size、--top-up-max、--upload-concurrency、--retries、--state；除非用户要求限定监控，否则不加 --max-polls。后续核对用 kb ingest status <document-id-or-job-id> --json。
限制：不得直接访问后端数据库或存储系统，不得索取 Supabase、NAS、AWS、Pinecone、OpenSearch 等凭据；授权、权限校验、去重、原始写入、解析排队与状态流转均由后端负责。只报告当前 CLI 输出与后端返回字段，不凭数据库查询推断成功。metadata-map.yaml 是可复用的分层规则文件，并非逐文件元数据。具体收费、平台支持范围等资料暂未提供。