deepminer-cli 0.1.24 → 0.1.25

package/README.md

@@ -13,6 +13,8 @@ DeepMiner 系统的命令行工具，用于管理认证、配置和 AI 会话。
 - **文件上传**: 上传文件到 OSS，带文件大小验证
 - **AI 会话**: 启动 AI 助手会话，支持自定义消息和 claw_param 参数
 - **JSON 输出**: 所有命令支持 `--json` 结构化输出，适合 AI agent 和脚本调用
+- **错误提示**: 错误响应包含 `hint` 字段，提供可操作的修复建议
+- **Dry Run**: `--dry-run` 预览 HTTP 请求而不实际执行
 - **CLI Schema**: 内置 `schema` 命令输出机器可读的能力描述
 - **zsh 自动补全**: 安装后自动配置
 
@@ -154,18 +156,46 @@ dm-cli --help         # 显示帮助信息
 | Flag | 说明 |
 |------|------|
 | `--json` | 以 JSON 格式输出结果 |
+| `--dry-run` | 预览 HTTP 请求而不实际执行 |
 | `--help` | 显示帮助信息 |
 
-JSON 模式下成功输出格式：
+### JSON 输出格式
+
+成功：
 ```json
 {"ok": true, "data": {...}}
 ```
 
-JSON 模式下错误输出格式：
+错误（含修复建议）：
 ```json
-{"ok": false, "error": {"type": "auth", "message": "未登陆"}}
+{"ok": false, "error": {"type": "auth", "message": "未登陆", "hint": "运行 'dm-cli auth login --username <user> --password <pass>' 登录"}}
+```
+
+`hint` 字段提供可操作的修复建议，AI agent 可直接据此自动恢复。
+
+### Dry Run 模式
+
+使用 `--dry-run` 预览请求而不实际执行，适合调试和 AI agent 安全验证：
+
+```bash
+dm-cli --dry-run auth login --username user --password pass
+# [DRY RUN] POST https://api.example.com/api/auth/authentication/login
+# Headers:
+#   Content-Type: application/json
+# Body:
+# {"username": "user", "password": "pass"}
 ```
 
+JSON 模式：
+```bash
+dm-cli --dry-run --json agent start-thread --message "你好"
+```
+```json
+{"ok": true, "dry_run": true, "data": {"method": "POST", "url": "...", "headers": {...}, "body": {...}}}
+```
+
+只读命令（`config show`、`auth status`、`version`、`schema`）和纯本地操作（`config init`、`auth logout`）不受 `--dry-run` 影响，正常执行。
+
 ## 文件说明
 
 ### 配置文件：`~/.dm-cli/config.json`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepminer-cli",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "DeepMiner CLI - Command-line tool for DM system with cross-platform support, JWT authentication, and workspace management",
   "keywords": [
     "deepminer",