SuperAPI AI 工具集

community-cli-howto

部署与运维

查看项目

更新于 10-15 23:41

技能介绍

用途:在仓库中运行和排查 community-domo-cli 命令,使用当前锁定的端点范围。

安装与运行:推荐用户使用 pipx install "git+https://github.com/stahura/community-domo-cli.git",然后 community-domo-cli --help。贡献者/测试路径:python3 -m pip install -e .,再 community-domo-cli --help;本地开发也可用 python3 -m community_domo_cli --help。

认证配置(Ryuu 会话):先安装 Domo CLI 并登录一次:npm install -g ryuu,domo login -i modocorp.domo.com。运行命令前设置环境变量:export DOMO_INSTANCE=modocorp,export DOMO_AUTH_MODE=ryuu-session,然后 community-domo-cli datasets list。Token 认证已弃用,auth_mode=token 不再支持;若出现“Token auth mode is no longer supported”,重新运行 domo login -i <instance> 并保持 DOMO_AUTH_MODE=ryuu-session。CLI 从 ~/.config/configstore/ryuu/<instance>.json 读取登录文件,并复用 domo login 的刷新/会话行为。

实现约束:产品 API 基址为 https://<instance>.domo.com/api(CLI 已处理 /api);不支持删除操作;没有原始透传命令;验证载荷时先对变更操作使用 --dry-run。

支持的命令范围:datasets(list、schema <dataset_id>、sql <dataset_id> --body/--body-file);appdb(collections、collection-get <collection_id>、document-create <collection_id> --body/--body-file);code-engine(get-package <package_id>、create-package --body/--body-file、update-version <package_id> <version> --body/--body-file);workflows(get <workflow_id>);filesets(get <fileset_id>、file-get <fileset_id> <file_id>、upload <fileset_id> --body/--body-file、download <fileset_id> <file_id> --output <path>)。

故障排查:确认调用方式,优先 community-domo-cli ...,python3 -m community_domo_cli ... 主要用于本地贡献者测试,不要运行 python3 community_domo_cli ...;确认认证输入,已设置 DOMO_INSTANCE 和 DOMO_AUTH_MODE=ryuu-session,且已为目标实例成功运行 domo login;确认标识符类型,datasets 命令用 dataset UUID,filesets 命令用 fileset UUID 和 file UUID;遇到 400/404 先重试已知正常的 GET,如 datasets list、appdb collections;变更调用先用 --dry-run 验证载荷。响应风格应简洁具体,给出确切命令而非高层说明,优先直接修复命令再简短解释。