deepminer-cli 0.1.26 → 0.1.28

package/README.md

@@ -5,13 +5,9 @@ DeepMiner 系统的命令行工具，用于管理认证、配置和 AI 会话。
 ## 功能特性
 
 - **跨平台支持**: macOS、Linux、Windows
-- **用户认证**: 用户名/密码登录，支持 JWT Token
-- **自动 Token 管理**: Token 过期时自动刷新（本地 JWT 解析，无需 API 调用）
-- **空间管理**: 查看和切换工作空间
-- **配置管理**: API 端点配置
-- **安全存储**: Token 以受限权限存储在本地
-- **文件上传**: 上传文件到 OSS，带文件大小验证
-- **AI 会话**: 启动/继续/停止 AI 助手会话，支持自定义消息、会话追问和 claw_param 参数
+- **AccessKey 鉴权**: 通过 AccessKey 进行 API 认证
+- **配置管理**: API 端点和 AccessKey 配置
+- **AI 会话**: 启动/继续/停止 AI 助手会话，支持自定义消息、文件附件、会话追问和 claw_param 参数
 - **JSON 输出**: 所有命令支持 `--json` 结构化输出，适合 AI agent 和脚本调用
 - **错误提示**: 错误响应包含 `hint` 字段，提供可操作的修复建议
 - **Dry Run**: `--dry-run` 预览 HTTP 请求而不实际执行
@@ -39,31 +35,22 @@ go build -o dm-cli .
 
 ```bash
 # 1. 初始化配置
-dm-cli config init --endpoint https://dm-dev.xmingai.com
+dm-cli config init --endpoint https://dm-dev.xmingai.com --accesskey <your_access_key>
 
-# 2. 登录（返回空间列表）
-dm-cli auth login --username user@example.com --password xxx
-
-# 3. 选择空间
-dm-cli auth switch <space_id>
-
-# 4. 查看状态
-dm-cli auth status
-
-# 5. 启动 AI 会话（返回 agent_run_id、thread_id）
+# 2. 启动 AI 会话（返回 agent_run_id、thread_id）
 dm-cli agent start-thread --message "你好"
 
-# 5a. 在已有会话中继续追问
+# 3. 带文件附件发送
+dm-cli agent start-thread --message "请分析这个报告" --file ./report.ppt
+
+# 4. 在已有会话中继续追问
 dm-cli agent start-thread --message "继续聊" --thread-id <thread_id>
 
-# 5b. 停止正在运行的 Agent
+# 5. 停止正在运行的 Agent
 dm-cli agent stop --agent-run-id <agent_run_id>
 
-# 6. 上传文件
-dm-cli file upload --file document.pdf
-
-# 7. 登出
-dm-cli auth logout
+# 6. 查看用户打开的 agent
+dm-cli agent user-open
 ```
 
 ### JSON 模式（适合 AI agent / 脚本）
@@ -72,10 +59,10 @@ dm-cli auth logout
 
 ```bash
 dm-cli auth status --json
-# {"ok": true, "data": {"logged_in": true, "user_id": "...", "current_space": "...", ...}}
+# {"ok": true, "data": {"auth_mode": "accesskey", "access_key": "..."}}
 
-dm-cli file upload --file data.xlsx --json
-# {"ok": true, "data": {"file_id": "...", "file_key": "...", ...}}
+dm-cli agent start-thread --message "分析" --file ./data.xlsx --json
+# {"ok": true, "data": {"agent_run_id": "...", "thread_id": "...", ...}}
 ```
 
 ## 命令列表
@@ -83,29 +70,35 @@ dm-cli file upload --file data.xlsx --json
 ### 配置
 
 ```bash
-dm-cli config init --endpoint <url>   # 初始化配置（设置 API 端点）
-dm-cli config show                     # 显示当前配置
+dm-cli config init --endpoint <url>                      # 初始化配置（设置 API 端点）
+dm-cli config init --endpoint <url> --accesskey <key>    # 初始化配置并设置 AccessKey
+dm-cli config show                                       # 显示当前配置
 ```
 
 ### 认证
 
 ```bash
-dm-cli auth login --username <用户名> --password <密码>   # 登录（返回空间列表）
-dm-cli auth switch <space_id>                              # 切换工作空间
-dm-cli auth status                                         # 显示登录状态
-dm-cli auth logout                                         # 退出登录
+dm-cli auth status                                         # 显示鉴权状态
 ```
 
-### 文件管理
+### AI 会话
 
 ```bash
-dm-cli file upload --file <路径>                        # 上传文件
-dm-cli file upload --file <路径> --name <文件名>        # 上传文件（自定义名称）
-dm-cli file upload --file <路径> --feature <类型>       # 上传文件（指定功能类型）
-dm-cli file upload --file <路径> --id <ID>              # 上传文件（指定文件 ID）
+dm-cli agent start-thread --message <消息>                                          # 发送文本消息
+dm-cli agent start-thread --message <消息> --file <路径>                            # 附带文件
+dm-cli agent start-thread --message <消息> --file <路径1> --file <路径2>            # 附带多个文件
+dm-cli agent start-thread --message <消息> --thread-id <会话ID>                     # 在已有会话中继续追问
+dm-cli agent start-thread --message <消息> --claw-param <JSON>                      # 附带渠道参数
+dm-cli agent start-thread --message <消息> --agent-mode <模式>                      # 指定 agent_mode（默认 auto）
+dm-cli agent stop --agent-run-id <运行ID>                                           # 停止正在运行的 Agent
+dm-cli agent user-open                                                              # 列出用户打开的 agent
 ```
 
-#### 文件大小限制
+#### 文件附件说明
+
+使用 `--file` 参数附带本地文件，CLI 会自动上传并拼接到消息中。可多次指定以附带多个文件。
+
+**文件大小限制**：
 
 | 类型 | 扩展名 | 最大大小 |
 |------|--------|----------|
@@ -113,16 +106,6 @@ dm-cli file upload --file <路径> --id <ID>              # 上传文件（指
 | 音频 | mp3/wav/aac | 100 MB |
 | 其他 | * | 300 MB |
 
-### AI 会话
-
-```bash
-dm-cli agent start-thread                                              # 使用默认消息 "你好"
-dm-cli agent start-thread --message <消息>                             # 自定义消息
-dm-cli agent start-thread --message <消息> --thread-id <会话ID>        # 在已有会话中继续追问
-dm-cli agent start-thread --message <消息> --claw-param <JSON>         # 附带渠道参数
-dm-cli agent stop --agent-run-id <运行ID>                              # 停止正在运行的 Agent
-```
-
 #### claw_param 参数说明
 
 可选的 `--claw-param` 用于指定 DM 系统的渠道和发送者信息：
@@ -176,7 +159,7 @@ dm-cli --help         # 显示帮助信息
 
 错误（含修复建议）：
 ```json
-{"ok": false, "error": {"type": "auth", "message": "未登陆", "hint": "运行 'dm-cli auth login --username <user> --password <pass>' 登录"}}
+{"ok": false, "error": {"type": "auth", "message": "未配置 AccessKey", "hint": "运行 'dm-cli config init --endpoint <url> --accesskey <key>' 配置"}}
 ```
 
 `hint` 字段提供可操作的修复建议，AI agent 可直接据此自动恢复。
@@ -185,16 +168,6 @@ dm-cli --help         # 显示帮助信息
 
 使用 `--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 "你好"
 ```
@@ -202,7 +175,7 @@ dm-cli --dry-run --json agent start-thread --message "你好"
 {"ok": true, "dry_run": true, "data": {"method": "POST", "url": "...", "headers": {...}, "body": {...}}}
 ```
 
-只读命令（`config show`、`auth status`、`version`、`schema`）和纯本地操作（`config init`、`auth logout`）不受 `--dry-run` 影响，正常执行。
+只读命令（`config show`、`auth status`、`version`、`schema`）和纯本地操作（`config init`）不受 `--dry-run` 影响，正常执行。
 
 ## 文件说明
 
@@ -210,47 +183,26 @@ dm-cli --dry-run --json agent start-thread --message "你好"
 
 ```json
 {
-  "api_endpoint": "https://dm-dev.xmingai.com/api"
+  "api_endpoint": "https://dm-dev.xmingai.com/api",
+  "access_key": "your_access_key"
 }
 ```
 
-### Token 文件：`~/.dm-cli/token.json` (权限 0600)
-
-```json
-{
-  "access_token": "eyJ...",
-  "refresh_token": "ey...",
-  "expires_at": 1716239022,
-  "user_id": "user_123",
-  "email": "user@example.com",
-  "current_space": "space_id"
-}
-```
-
-## Token 管理工作原理
-
-1. **认证**: 使用 `--username`/`--password` 凭证获得 `access_token` (JWT) 和 `refresh_token`
-2. **空间选择**: 登录返回可用空间列表，使用 `auth switch` 选择
-3. **存储**: Token 和元数据保存在 `~/.dm-cli/token.json`
-4. **自动刷新**: API 调用前自动检查 Token 是否过期，过期则刷新
-5. **401 处理**: 服务器拒绝 Token 时自动尝试刷新并重试
-
 ## 项目结构
 
 ```
 dm-cli/
 ├── cmd/                    # 命令定义
 │   ├── root.go            # 根命令
-│   ├── auth/              # 认证命令
+│   ├── auth/              # 鉴权状态命令
 │   ├── config/            # 配置命令
 │   ├── agent/             # AI 命令
-│   ├── file/              # 文件管理命令
 │   └── schema/            # Schema 输出命令
 ├── internal/
-│   ├── auth/              # 认证模块
 │   ├── client/            # HTTP 客户端
 │   ├── config/            # 配置管理
 │   ├── cmdutil/           # 命令工具
+│   ├── fileutil/          # 文件上传共享逻辑
 │   ├── output/            # 输出处理
 │   └── validate/          # 输入验证
 ├── schema/                # CLI Schema 定义（嵌入）
@@ -269,15 +221,9 @@ dm-cli/
 go build -o dm-cli .
 
 # 初始化配置
-./dm-cli config init --endpoint https://dm-dev.xmingai.com
-
-# 登录
-./dm-cli auth login --username user@example.com --password xxx
-
-# 选择空间
-./dm-cli auth switch <space_id>
+./dm-cli config init --endpoint https://dm-dev.xmingai.com --accesskey <your_access_key>
 
-# 查看状态
+# 查看鉴权状态
 ./dm-cli auth status
 ```
 
@@ -296,10 +242,8 @@ make build-all
 
 ## 安全考虑
 
-- Token 存储在 `~/.dm-cli/` 目录，权限为 0600
-- JWT Token 本地解析，只读取 exp 声明（不验证签名）
-- Token 过期时自动刷新
-- Refresh Token 过期后需要重新登录
+- 配置文件存储在 `~/.dm-cli/` 目录，权限为 0600
+- AccessKey 以明文存储在配置文件中，请确保文件权限安全
 
 ## zsh 补全
 
@@ -310,7 +254,6 @@ dm-cli <TAB>          # 显示所有命令
 dm-cli auth <TAB>     # 显示 auth 子命令
 dm-cli config <TAB>   # 显示 config 子命令
 dm-cli agent <TAB>    # 显示 agent 子命令
-dm-cli file <TAB>     # 显示 file 子命令
 ```
 
 ## 许可证

package/package.json

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

package/scripts/_dm-cli

@@ -1,7 +1,7 @@
 #compdef dm-cli
 
 _dm_cli() {
-  local context state state_descr line
+  local curcontext="$curcontext" state state_descr line
   typeset -A opt_args
 
   _arguments -C \
@@ -17,7 +17,6 @@ _dm_cli() {
         'config:管理配置'
         'auth:用户认证'
         'agent:AI 助手相关命令'
-        'file:文件管理'
         'schema:输出 CLI Schema 定义'
         'version:显示版本号'
       )
@@ -28,7 +27,6 @@ _dm_cli() {
         config) _dm_cli_config ;;
         auth)   _dm_cli_auth ;;
         agent)  _dm_cli_agent ;;
-        file)   _dm_cli_file ;;
         schema) _dm_cli_schema ;;
       esac
       ;;
@@ -36,7 +34,7 @@ _dm_cli() {
 }
 
 _dm_cli_config() {
-  local context state state_descr line
+  local curcontext="$curcontext" state state_descr line
   typeset -A opt_args
 
   _arguments -C \
@@ -56,6 +54,7 @@ _dm_cli_config() {
         init)
           _arguments \
             '--endpoint=[API 端点 URL]:url' \
+            '--accesskey=[Access Key]:key' \
             '--json[以 JSON 格式输出]' \
             '--dry-run[预览请求]' \
             '--help[显示帮助]'
@@ -72,7 +71,7 @@ _dm_cli_config() {
 }
 
 _dm_cli_auth() {
-  local context state state_descr line
+  local curcontext="$curcontext" state state_descr line
   typeset -A opt_args
 
   _arguments -C \
@@ -82,32 +81,14 @@ _dm_cli_auth() {
   case "$state" in
     subcommand)
       local -a subcommands=(
-        'login:登录 DM 系统'
-        'logout:退出登录'
-        'status:显示登录状态'
-        'switch:切换空间'
+        'status:显示鉴权状态'
       )
       _describe -t subcommands 'subcommand' subcommands
       ;;
     args)
       case "${line[1]}" in
-        login)
+        status)
           _arguments \
-            '--username=[用户名]:username' \
-            '--password=[密码]:password' \
-            '--json[以 JSON 格式输出]' \
-            '--dry-run[预览请求]' \
-            '--help[显示帮助]'
-          ;;
-        logout|status)
-          _arguments \
-            '--json[以 JSON 格式输出]' \
-            '--dry-run[预览请求]' \
-            '--help[显示帮助]'
-          ;;
-        switch)
-          _arguments \
-            '1:space_id' \
             '--json[以 JSON 格式输出]' \
             '--dry-run[预览请求]' \
             '--help[显示帮助]'
@@ -118,7 +99,7 @@ _dm_cli_auth() {
 }
 
 _dm_cli_agent() {
-  local context state state_descr line
+  local curcontext="$curcontext" state state_descr line
   typeset -A opt_args
 
   _arguments -C \
@@ -130,6 +111,7 @@ _dm_cli_agent() {
       local -a subcommands=(
         'start-thread:发起 AI 会话'
         'stop:停止 Agent 运行'
+        'user-open:列出用户打开的 agent'
       )
       _describe -t subcommands 'subcommand' subcommands
       ;;
@@ -138,6 +120,8 @@ _dm_cli_agent() {
         start-thread)
           _arguments \
             '--message=[消息内容]:message' \
+            '*--file=[本地文件路径]:file:_files' \
+            '--agent-mode=[Agent 模式]:mode:(auto cooperation)' \
             '--thread-id=[会话 ID]:thread_id' \
             '--claw-param=[JSON 参数]:json' \
             '--json[以 JSON 格式输出]' \
@@ -151,34 +135,8 @@ _dm_cli_agent() {
             '--dry-run[预览请求]' \
             '--help[显示帮助]'
           ;;
-      esac
-      ;;
-  esac
-}
-
-_dm_cli_file() {
-  local context state state_descr line
-  typeset -A opt_args
-
-  _arguments -C \
-    '(-): :->subcommand' \
-    '(-)*:: :->args'
-
-  case "$state" in
-    subcommand)
-      local -a subcommands=(
-        'upload:上传文件'
-      )
-      _describe -t subcommands 'subcommand' subcommands
-      ;;
-    args)
-      case "${line[1]}" in
-        upload)
+        user-open)
           _arguments \
-            '--file=[文件路径]:file:_files' \
-            '--name=[远程文件名]:name' \
-            '--feature=[功能类型]:feature' \
-            '--id=[文件 ID]:id' \
             '--json[以 JSON 格式输出]' \
             '--dry-run[预览请求]' \
             '--help[显示帮助]'