deepminer-cli 0.1.26 → 0.1.27

package/README.md

@@ -10,8 +10,7 @@ DeepMiner 系统的命令行工具，用于管理认证、配置和 AI 会话。
 - **空间管理**: 查看和切换工作空间
 - **配置管理**: API 端点配置
 - **安全存储**: Token 以受限权限存储在本地
-- **文件上传**: 上传文件到 OSS，带文件大小验证
-- **AI 会话**: 启动/继续/停止 AI 助手会话，支持自定义消息、会话追问和 claw_param 参数
+- **AI 会话**: 启动/继续/停止 AI 助手会话，支持自定义消息、文件附件、会话追问和 claw_param 参数
 - **JSON 输出**: 所有命令支持 `--json` 结构化输出，适合 AI agent 和脚本调用
 - **错误提示**: 错误响应包含 `hint` 字段，提供可操作的修复建议
 - **Dry Run**: `--dry-run` 预览 HTTP 请求而不实际执行
@@ -37,6 +36,18 @@ go build -o dm-cli .
 
 ## 快速开始
 
+**方式一：使用 AccessKey（推荐，无需登录）**
+
+```bash
+# 1. 初始化配置（带 AccessKey，无需后续登录和选择空间）
+dm-cli config init --endpoint https://dm-dev.xmingai.com --accesskey <your_access_key>
+
+# 2. 直接使用
+dm-cli agent start-thread --message "你好"
+```
+
+**方式二：使用用户名密码登录**
+
 ```bash
 # 1. 初始化配置
 dm-cli config init --endpoint https://dm-dev.xmingai.com
@@ -49,20 +60,27 @@ dm-cli auth switch <space_id>
 
 # 4. 查看状态
 dm-cli auth status
+```
 
-# 5. 启动 AI 会话（返回 agent_run_id、thread_id）
+**通用操作**
+
+```bash
+# 启动 AI 会话（返回 agent_run_id、thread_id）
 dm-cli agent start-thread --message "你好"
 
-# 5a. 在已有会话中继续追问
+# 带文件附件发送
+dm-cli agent start-thread --message "请分析这个报告" --file ./report.ppt
+
+# 在已有会话中继续追问
 dm-cli agent start-thread --message "继续聊" --thread-id <thread_id>
 
-# 5b. 停止正在运行的 Agent
+# 停止正在运行的 Agent
 dm-cli agent stop --agent-run-id <agent_run_id>
 
-# 6. 上传文件
-dm-cli file upload --file document.pdf
+# 查看用户打开的 agent
+dm-cli agent user-open
 
-# 7. 登出
+# 登出（仅用户名密码模式）
 dm-cli auth logout
 ```
 
@@ -74,8 +92,8 @@ dm-cli auth logout
 dm-cli auth status --json
 # {"ok": true, "data": {"logged_in": true, "user_id": "...", "current_space": "...", ...}}
 
-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,8 +101,9 @@ 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                                       # 显示当前配置
 ```
 
 ### 认证
@@ -96,16 +115,24 @@ dm-cli auth status                                         # 显示登录状态
 dm-cli auth logout                                         # 退出登录
 ```
 
-### 文件管理
+### 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 +140,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 系统的渠道和发送者信息：
@@ -244,13 +261,13 @@ dm-cli/
 │   ├── auth/              # 认证命令
 │   ├── config/            # 配置命令
 │   ├── agent/             # AI 命令
-│   ├── file/              # 文件管理命令
 │   └── schema/            # Schema 输出命令
 ├── internal/
 │   ├── auth/              # 认证模块
 │   ├── client/            # HTTP 客户端
 │   ├── config/            # 配置管理
 │   ├── cmdutil/           # 命令工具
+│   ├── fileutil/          # 文件上传共享逻辑
 │   ├── output/            # 输出处理
 │   └── validate/          # 输入验证
 ├── schema/                # CLI Schema 定义（嵌入）
@@ -310,7 +327,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.27",
   "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 \
@@ -118,7 +117,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 +129,7 @@ _dm_cli_agent() {
       local -a subcommands=(
         'start-thread:发起 AI 会话'
         'stop:停止 Agent 运行'
+        'user-open:列出用户打开的 agent'
       )
       _describe -t subcommands 'subcommand' subcommands
       ;;
@@ -138,6 +138,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 +153,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[显示帮助]'