@moziaverse/context-cli

Mozia 企业上下文只读命令行客户端。它通过统一 Context API 读取已授权的企业数据， 不直接持有底层数据源凭据。

安装

需要 Node.js 20 或更高版本。

从 npm 全局安装：

npm install --global @moziaverse/context-cli

配置

由管理员创建 Service Token，或由系统签发 Personal Token，然后配置：

export CONTEXT_API_URL="https://context.example.com"
export CONTEXT_API_TOKEN="..."

也可以从标准输入传入令牌，避免令牌出现在命令参数和 Shell 历史中：

printenv CONTEXT_API_TOKEN | context-cli whoami --token-stdin

CLI 不提供 --token <value> 参数。

命令

context-cli whoami
context-cli list context://openviking/projects/example/
context-cli search "项目风险" --source projects
context-cli read context://oa/workflows/123
context-cli query context://erp/records --limit 100
context-cli stat context://oa/attachments/123
context-cli download context://oa/attachments/123 --output ./invoice.pdf

默认输出 JSON，可用 --format text 输出适合阅读的文本。query 支持时间范围、过滤、 排序、字段选择、分组聚合和游标分页；完整参数请运行：

context-cli --help

退出码

• 0：成功
• 1：参数、网络或服务错误
• 2：未认证或令牌失效
• 3：没有访问权限
• 4：资源不存在

安全边界

• 只支持 list、search、read、query、stat、download 只读操作。
• Agent 使用按运行签发的短期令牌；个人工具使用绑定用户授权的 Personal Token；外部 Agent 使用管理员创建的 Service Token。
• 令牌只通过环境变量、标准输入或系统密钥管理工具提供，不写入命令参数。
• 所有 Context API 访问都会在服务端记录权限结果和审计信息。

开发

npm --prefix apps/context-cli test
npm --prefix apps/context-cli run verify:package

源码位于 MoziaVerse/mozia-org-platform。