用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/crimsonblazezero/Zero-Tools --skill dws-cli-troubleshooting命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | dws-cli-troubleshooting |
| description | 钉钉 DWS CLI 故障排查与升级指南。当 dws upgrade 失败、命令识别异常、版本不一致或网络调用报错时使用。 |
| tags | ["dws","dingtalk","cli","troubleshooting"] |
| requires | [{"commands":["dws","curl","npm"]},{"env_vars":[]}] |
| version | 1.0.0 |
| created_at | 2026-07-26 |
| last_tested_at | 2026-07-26 |
dws upgrade -y 报 下载二进制失败、connection attempt failed 或 read tcp ... timeout。
确认代理环境变量是否干扰
echo ; ;
若代理端口拒绝连接（如 9872），先 unset 再重试，或直接绕过。
测试 GitHub 直连
curl --noproxy "*" -sI "https://api.github.com/repos/DingTalk-Real-AI/dingtalk-workspace-cli/releases/latest"
确认安装方式
where dws # Windows cmd/powershell
which dws # bash/msys
输出路径包含 node_modules/dingtalk-workspace-cli/bin/dws.js → npm 安装
独立 zip/binary → 标准 CLI 安装
当 dws upgrade -y 因 GitHub Release 下载失败、connectex: No connection could be made、read tcp ... timeout 时：
# 0. 清除代理环境变量干扰（必须！）
unset HTTPS_PROXY HTTP_PROXY ALL_PROXY
# 1. 通过 npm registry 升级（比 GitHub 下载稳定得多）
npm update dingtalk-workspace-cli -g
# 2. 确认新版本并验证
dws --version
dws doctor
原理：
dws upgrade内部依赖 GitHub Release 二进制下载，Windows 环境下极不稳定；npm update走 npm registry，穿透力强。
| 版本 | 日期 | 备注 |
|---|---|---|
| v1.0.41 | — | 初版，用户环境 |
| v1.0.54 | 2026-07-21 | 最新稳定版（npm 安装），包含 dws dev/audit/event/profile/skill/pat/agoal 等新命令 |
dws <product> <subcommand> --help 显示的是旧版 help 或报 unknown command。
本地 dws skill 文档可能落后于 npm 发布的 CLI 版本。新版增加了 agoal、audit、event、profile、skill、dev、pat 等命令，但本地 skill 索引未同步。
dws --help 和 dws <cmd> --help 为准，不要硬编码 product 列表dws schema 可动态拉取当前 MCP 注册的工具清单npm view dingtalk-workspace-cli version）是事实源| 场景 | 症状 | 处理 |
|---|---|---|
| VPN 代理端口断开 | connectex: No connection could be made | unset HTTP_PROXY HTTPS_PROXY; npm update ... -g |
| GitHub DNS 污染 | curl --noproxy * 连 API 200，但 release 下载超时 | 用 npm 升级替代 GitHub 下载 |
| macOS keychain 认证 | dws auth login 卡在浏览器或报错 | dws auth reset && dws auth login |
dws --version # 确认版本
dws doctor # 环境健康检查
dws contact user me --format json # 端到端调用测试
https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases（可用 curl 拉取）dws --help / dws schema — 以运行时实际注册的能力为准