mcpField
C
community-cli-howto

community-cli-howto

github.com/stahura数据与数据库24176 次安装26 周前更新
代码仓库

关于 community-cli-howto

community-cli-howto 是用于运行和排查 community-domo-cli 的仓库技能，覆盖其当前支持的 Domo 接口。内容包括 Ryuu 会话认证、命令用法和操作限制，面向 CLI 用户与贡献者。

主要功能

  1. 01Ryuu 会话认证设置
  2. 02Domo 命令参考
  3. 03调用方式与标识符排查
  4. 04变更操作的试运行指引

适用场景

  1. 01为 Domo 实例配置 CLI 认证
  2. 02查询受支持接口的命令用法
  3. 03排查 CLI 调用或标识符错误
  4. 04执行变更前验证请求内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/stahura/domo-ai-vibe-rules --skill community-cli-howto

安装后在 Claude Code 中输入/community-cli-howto确认已加载。

详细介绍

社区 Domo CLI

目的

使用当前锁定的端点接口面，在本仓库中运行和排查 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

# alternate module invocation for local dev
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 认证已弃用。 community-domo-cli 不再支持 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）。
  • 不支持删除操作。
  • 不存在 raw 透传命令。
  • 在校验载荷时，对变更操作先使用 --dry-run。

支持的命令接口面（当前）

datasets
  • datasets list
  • datasets schema <dataset_id>
  • datasets sql <dataset_id> --body/--body-file
appdb
  • appdb collections
  • appdb collection-get <collection_id>
  • appdb document-create <collection_id> --body/--body-file
code-engine
  • code-engine get-package <package_id>
  • code-engine create-package --body/--body-file
  • code-engine update-version <package_id> <version> --body/--body-file
workflows
  • workflows get <workflow_id>
filesets
  • filesets get <fileset_id>
  • filesets file-get <fileset_id> <file_id>
  • filesets upload <fileset_id> --body/--body-file
  • filesets download <fileset_id> <file_id> --output <path>

排查清单

  1. 确认调用方式：
    • 优先使用 community-domo-cli ...
    • python3 -m community_domo_cli ... 主要用于本地贡献者测试
    • 不要运行 python3 community_domo_cli ...
  2. 确认认证输入：
    • 已设置 DOMO_INSTANCE 和 DOMO_AUTH_MODE=ryuu-session
    • 已为目标实例成功运行 domo login
  3. 确认标识符类型：
    • datasets 命令使用 dataset UUID
    • filesets 命令使用 fileset UUID 和 file UUID
  4. 对于 400/404 问题，先重试一个已知可用的 GET：
    • datasets list
    • appdb collections
  5. 对于变更调用，在真实执行前使用 --dry-run 校验载荷。

本项目的回复风格

  • 简洁具体。
  • 提供确切的命令，而非高层级说明。
  • 优先先给出直接的修复命令，再作简要说明。

评论

支持 Markdown