yzj-cli

云之家官方 CLI 工具，为人类用户和 AI Agent 打造。覆盖通讯录、日历等核心业务场景。

安装 · 快速开始 · 认证 · 命令 · 安全

English · 中文

Why yzj-cli?

• Agent 原生设计 — npm install 时自动安装 AI Agent skills，支持 Claude Code、Cursor、Copilot 等主流工具
• 安全优先 — OS 原生密钥链存储凭据，仅 HTTPS，可信域名强制校验
• 渐进重试 — 超时、连接错误、5xx 自动重试（3s × 1.5^n，最多 5 次），无需手动处理网络抖动
• 零运行时依赖 — Rust + rustls 构建，无需系统 OpenSSL
• 双层分发 — npm 壳跨平台安装，Rust 二进制高性能执行

功能一览

| 分类 | 能力 | |------|------| | 认证 | 浏览器登录（默认）/ 设备码登录（--device） | | 通讯录 | 按关键词搜索用户、按 openId 获取用户详情 | | 日历 | 日程查询/新建/修改/删除、可用会议室查询 |

安装

npm install -g @yunzhijia/cli

Node.js >= 18

AI Agent skills 会在安装过程中自动部署。

快速开始

# 1. 登录（自动打开浏览器）
yzj-cli auth login

# 2. 搜索同事
yzj-cli contact user search --keyword "张三"

# 3. 查看今日日程
yzj-cli calendar event list --start 2026-05-25 --end 2026-05-25

认证

| 命令 | 说明 | |------|------| | auth login | 浏览器登录（默认，自动打开） | | auth login --device | 设备码登录（无头模式，适用于无浏览器环境） | | auth logout | 退出当前 profile |

密钥存储于 OS 密钥链。

yzj-cli --profile work auth login
yzj-cli --profile work calendar event list --start 2026-05-25 --end 2026-05-25

命令

全局 Flags

| Flag | 说明 | |------|------| | --debug | 调试输出（stderr） | | --verbose | 详细输出（stderr） | | --profile <name> | 切换凭据/配置 profile（默认 default） | | --endpoint <url> | 覆盖 API 端点（仅 HTTPS） |

通讯录

# 按关键词搜索用户
yzj-cli contact user search --keyword <关键词>

# 按 openId 获取用户信息（支持多个；不传则获取当前登录用户）
yzj-cli contact user get --open-id <OPEN_ID_1> --open-id <OPEN_ID_2>

日历

# 查询日程
yzj-cli calendar event list --start 2026-05-25 --end 2026-05-25

# 日程详情 / 新建 / 修改 / 删除
yzj-cli calendar event get --id <EVENT_ID>
yzj-cli calendar event create --title "产品评审" \
  --start 2026-05-25T10:00:00 --end 2026-05-25T11:00:00 \
  --open-id <OPEN_ID> --meet-organizer-open-ids <OPEN_ID>
yzj-cli calendar event update --id <EVENT_ID> --title "新标题"
yzj-cli calendar event delete --id <EVENT_ID>

# 查询可用会议室
yzj-cli calendar room find --open-id <OPEN_ID> \
  --start 2026-05-25T14:00:00 --end 2026-05-25T15:00:00

自更新

yzj-cli update          # 检查并更新到最新版本
yzj-cli update --force  # 强制更新，忽略版本比较

Agent Skills

安装后自动部署 AI Agent skills 至 ~/.claude/skills/yzj-cli、~/.agents/skills/yzj-cli 等目录，支持主流 AI 工具零配置开箱即用。

| Skill | 说明 | |-------|------| | yzj-cli | 意图路由、安全规则、错误处理、产品命令参考 |

安全

• 仅 HTTPS — 所有请求必须使用 HTTPS，HTTP 直接拒绝
• 可信域名 — 凭据仅发送至 *.yunzhijia.com 及配置的端点
• OS 密钥链 — 密钥通过平台原生密钥链存储，无明文落盘
• 渐进超时 — 3s × 1.5^n，最多 5 次重试，避免连接挂死

许可

Copyright © Kingdee. All rights reserved.