dingtalk-cli — dingtalk-命令行工具

dingtalk-命令行工具

dingtalk-命令行工具 是面向 代理 的钉钉文档 命令行工具，覆盖：

知识库列表与详情 节点查询、URL 反查 文档创建、正文读取、Markdown 覆盖写入、删除 .axls 钉钉表格的 workbook/sheet/range 读取 文档成员添加、更新、移除 安装 pip 安装 dingtalk-命令行工具

如需从源码开发安装：

pip 安装 -e .

启动前配置

优先使用命令保存配置：

dingtalk-命令行工具 auth 设置up \ --应用-key <应用_KEY> \ --应用-secret <应用_SECRET> \ --operator-union-id

如果只有 userId：

dingtalk-命令行工具 auth 设置up \ --应用-key <应用_KEY> \ --应用-secret <应用_SECRET> \ --operator-user-id

配置会写到 ~/.dingtalk-命令行工具/config.json。也可用环境变量覆盖：

DINGTALK_应用_KEY DINGTALK_应用_SECRET DINGTALK_OPERATOR_ID DINGTALK_命令行工具_CONFIG_DIR

注意：

写操作必须带真实用户身份 operatorId，且应为 unionId 输出中不会打印完整凭证，只显示脱敏值 常用命令 # 看知识库 dingtalk-命令行工具 workspace 列出 --all

# 用 URL 反查节点 dingtalk-命令行工具 node resolve-url "https://alidocs.dingtalk.com/i/nodes/xxx"

# 读取文档正文 dingtalk-命令行工具 doc read --url "https://alidocs.dingtalk.com/i/nodes/xxx"

# 覆盖写入文档 dingtalk-命令行工具 doc overwrite --doc-key --content-file /abs/path/content.md --yes

# 若立即删除刚创建的文档，优先使用 创建 返回的 workspace_id + node_id dingtalk-命令行工具 doc 删除 --workspace-id --node-id --yes

# 读取 .axls 表格 dingtalk-命令行工具 workbook read --node-id --range A1:Z80

# 添加成员 dingtalk-命令行工具 member 添加 --node-id --member-id --角色 editor

代理 使用约定 优先使用 --json 对破坏性命令显式传 --yes 读取普通文档用 doc 读取 .axls 用 workbook 若 doc read 返回“目标节点是 .axls”，不要重试同一命令，直接切到 workbook 对创建命令返回的结果，立即读写时优先使用 doc_key 对创建后立即删除的场景，优先使用返回的 workspace_id + node_id 错误提示 MissingoperatorId：未配置 operator unionId paramError：把 userId 当成 unionId 传了 Forbidden.访问Denied.访问令牌权限Denied：应用权限不够 Tar获取 document should be doc.：目标不是普通文档，通常应改走 workbook