feat: Agent optimization and file upload enhancements (#182)

Author: yhjun1026

.python-version

@@ -0,0 +1,163 @@
+# 零配置快速启动指南
+
+## 快速启动
+
+### 方式一：使用 `derisk quickstart` 命令（推荐）
+
+```bash
+# 零配置启动（无需任何配置文件）
+derisk quickstart
+
+# 指定端口启动
+derisk quickstart -p 8888
+
+# 使用旧配置文件启动
+derisk quickstart -c configs/my/dev.toml
+```
+
+启动后访问: http://localhost:7777
+
+### 方式二：使用 `derisk start webserver` 命令
+
+```bash
+# 零配置启动
+derisk start webserver
+
+# 使用配置文件启动
+derisk start webserver -c configs/my/dev.toml
+
+# 后台启动
+derisk start webserver -d
+```
+
+### 方式三：直接运行 Python 脚本
+
+```bash
+# 零配置启动
+python -m derisk_app.derisk_server
+
+# 使用配置文件启动
+python -m derisk_app.derisk_server -c configs/derisk-minimal.toml
+```
+
+## 配置说明
+
+### 零配置模式
+
+零配置模式下，服务会使用默认配置启动：
+- **服务端口**: 7777
+- **数据库**: SQLite (pilot/meta_data/derisk.db)
+- **向量存储**: Chroma (pilot/data)
+- **语言**: 中文
+
+启动后通过 Web UI 配置：
+1. 访问 http://localhost:7777
+2. 进入"系统配置"页面
+3. 添加模型配置（LLM、Embedding、Reranker）
+4. 配置其他功能
+
+### 使用配置文件
+
+旧的 TOML 配置文件仍然完全支持：
+
+```bash
+# 使用阿里云配置
+derisk quickstart -c configs/derisk-proxy-aliyun.toml
+
+# 使用 OpenAI 配置
+derisk quickstart -c configs/derisk-proxy-openai.toml
+
+# 使用自定义配置
+derisk quickstart -c configs/my/dev.toml
+```
+
+### 配置优先级
+
+1. **命令行参数**（最高优先级）
+   - `-p/--port`: 服务端口
+   - `-h/--host`: 服务主机
+
+2. **TOML 配置文件**
+   - 如果指定了 `-c` 参数，使用指定的 TOML 文件
+
+3. **默认配置**（最低优先级）
+   - 如果未指定配置文件，使用零配置模式
+
+## 数据持久化
+
+### 数据库存储
+
+- **位置**: `pilot/meta_data/derisk.db`
+- **内容**: 用户配置、模型配置、对话历史等
+- **备份**: 直接复制该文件即可
+
+### 向量数据存储
+
+- **位置**: `pilot/data/`
+- **内容**: 向量索引、文档片段等
+
+### JSON 配置存储
+
+- **位置**: `~/.derisk/derisk.json`
+- **内容**: 应用配置（可通过 UI 修改）
+
+## 停止服务
+
+```bash
+# 如果是前台运行
+Ctrl+C
+
+# 如果是后台运行
+derisk stop webserver
+```
+
+## 常见问题
+
+### 1. 端口被占用
+
+```bash
+# 使用其他端口
+derisk quickstart -p 8888
+```
+
+### 2. 数据库迁移警告
+
+首次启动时可能会看到数据库迁移警告，这是正常的。数据库会自动创建和迁移。
+
+### 3. 如何配置模型
+
+启动服务后：
+1. 访问 http://localhost:7777
+2. 进入"模型管理"页面
+3. 添加你的模型配置（支持 OpenAI、阿里云、智谱等）
+4. 配置会自动保存到数据库
+
+### 4. 如何恢复默认配置
+
+```bash
+# 删除数据库（会清除所有配置）
+rm pilot/meta_data/derisk.db
+
+# 重新启动
+derisk quickstart
+```
+
+## 开发模式
+
+### 使用最小配置文件开发
+
+```bash
+# 创建最小配置文件
+# configs/derisk-minimal.toml 已存在
+
+# 使用最小配置启动
+derisk quickstart -c configs/derisk-minimal.toml
+```
+
+### 查看帮助
+
+```bash
+derisk quickstart --help
+derisk start webserver --help
+derisk --help
+```

QUICKSTART.md

@@ -115,6 +115,27 @@ uv sync --all-packages --frozen \
 
 #### Start Server
 
+**🚀 Quick Start (Zero Configuration, Recommended)**
+
+Start without any configuration file:
+
+```bash
+# Method 1: Use quickstart command
+uv run derisk quickstart
+
+# Method 2: Use startup script
+./start.sh
+
+# Method 3: Specify port
+uv run derisk quickstart -p 8888
+```
+
+After starting, visit http://localhost:7777 and configure models and settings through the web UI.
+
+For detailed instructions, see: [Quick Start Guide](QUICKSTART.md)
+
+**📝 Start with Configuration File**
+
 Configure the API_KEY in `derisk-proxy-aliyun.toml`, then run:
 
 > Note: By default, we use the Telecom dataset from OpenRCA. Download via:
@@ -124,6 +145,10 @@ After downloading, move datasets to `pilot/datasets/`
 
 Run the startup command:
 ```bash
+# Start with configuration file
+uv run derisk quickstart -c configs/derisk-proxy-aliyun.toml
+
+# Or use traditional method
 uv run python packages/derisk-app/src/derisk_app/derisk_server.py --config configs/derisk-proxy-aliyun.toml
 ```
 

README.md

@@ -115,6 +115,27 @@ uv sync --all-packages --frozen \
 
 #### 启动服务
 
+**🚀 快速启动（零配置，推荐）**
+
+无需任何配置文件，直接启动：
+
+```bash
+# 方式一：使用快速启动命令
+uv run derisk quickstart
+
+# 方式二：使用启动脚本
+./start.sh
+
+# 方式三：指定端口
+uv run derisk quickstart -p 8888
+```
+
+启动后访问 http://localhost:7777，通过 Web UI 配置模型和其他设置。
+
+详细说明请查看: [快速启动指南](QUICKSTART.md)
+
+**📝 使用配置文件启动**
+
 在 `derisk-proxy-aliyun.toml` 中配置 API_KEY，然后运行：
 
 > 注意：默认使用 OpenRCA 的 Telecom 数据集。通过以下链接或命令下载：
@@ -124,6 +145,10 @@ uv sync --all-packages --frozen \
 
 运行启动命令：
 ```bash
+# 使用配置文件启动
+uv run derisk quickstart -c configs/derisk-proxy-aliyun.toml
+
+# 或使用传统方式
 uv run python packages/derisk-app/src/derisk_app/derisk_server.py --config configs/derisk-proxy-aliyun.toml
 ```
 

README.zh.md

@@ -9,7 +9,7 @@ use derisk;
 -- MySQL DDL Script for Derisk
 -- Version: 0.3.0
 -- Generated from SQLAlchemy ORM Models
--- Generated: 2026-03-24 19:23:14
+-- Generated: 2026-03-29 23:19:58
 -- ============================================================
 
 SET NAMES utf8mb4;
@@ -114,6 +114,30 @@ CREATE TABLE IF NOT EXISTS `recommend_question` (
   `gmt_modify` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
 
+-- Table: agent_input_queue
+-- Source Model: AgentInputQueueEntity
+CREATE TABLE IF NOT EXISTS `agent_input_queue` (
+  `id` BIGINT NOT NULL AUTO_INCREMENT,
+  `conv_id` VARCHAR(255) NOT NULL COMMENT '对话ID (agent_conv_id)',
+  `conv_session_id` VARCHAR(255) NOT NULL COMMENT '会话ID',
+  `message_id` VARCHAR(64) NOT NULL COMMENT '消息唯一ID',
+  `message_content` TEXT NOT NULL COMMENT '消息内容 (JSON)',
+  `sender_name` VARCHAR(128) NULL COMMENT '发送者名称',
+  `sender_type` VARCHAR(32) NULL COMMENT '发送者类型 (user/system)',
+  `status` VARCHAR(20) NOT NULL COMMENT 'pending/processing/consumed',
+  `consumed_at` DATETIME NULL COMMENT '消费时间',
+  `consumed_by` VARCHAR(64) NULL COMMENT '消费的服务器实例ID',
+  `priority` INT NULL DEFAULT 0 COMMENT '优先级 (数字越大越优先)',
+  `extra` TEXT NULL COMMENT '扩展信息 (JSON)',
+  `gmt_create` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `gmt_modified` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '更新时间',
+  `gmt_modify` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
+  PRIMARY KEY (`id`),
+  KEY `idx_input_conv_session_status` (`conv_session_id`, `status`),
+  KEY `idx_input_conv_id_status` (`conv_id`, `status`),
+  KEY `idx_input_gmt_create` (`gmt_create`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
 -- Table: authorization_audit_log
 -- Source Model: AuthorizationAuditLogEntity
 CREATE TABLE IF NOT EXISTS `authorization_audit_log` (
@@ -479,7 +503,7 @@ CREATE TABLE IF NOT EXISTS `gpts_app_config` (
   `system_prompt_template` TEXT NULL COMMENT '当前版本配置的system prompt模版',
   `user_prompt_template` TEXT NULL COMMENT '当前版本配置的user prompt模版',
   `layout` VARCHAR(255) NULL COMMENT '当前版本配置的布局配置',
-  `custom_variables` VARCHAR(2000) NULL COMMENT '当前版本配置自定义参数配置',
+  `custom_variables` TEXT NULL COMMENT '当前版本配置自定义参数配置',
   `llm_config` TEXT NULL COMMENT '当前版本配置的模型配置',
   `resource_knowledge` TEXT NULL COMMENT '当前版本配置的知识配置',
   `resource_tool` TEXT NULL COMMENT '当前版本配置的工具配置',

assets/schema/derisk.sql

@@ -51,11 +51,13 @@ max_new_tokens = 4096
 name = "qwen-vl-max"
 temperature = 0.7
 max_new_tokens = 4096
+is_multimodal = true  # 多模态模型，支持图片输入
 
 [[agent.llm.provider.model]]
 name = "glm-5"
 temperature = 0.7
 max_new_tokens = 4096
+is_multimodal = true  # 多模态模型，支持图片输入
 
 [[serves]]
 type = "file"

configs/derisk-proxy-aliyun.toml

@@ -51,11 +51,13 @@ max_new_tokens = 4096
 name = "qwen-vl-max"
 temperature = 0.7
 max_new_tokens = 4096
+is_multimodal = true  # 多模态模型，支持图片输入
 
 [[agent.llm.provider.model]]
 name = "glm-5"
 temperature = 0.7
 max_new_tokens = 4096
+is_multimodal = true  # 多模态模型，支持图片输入
 
 [[serves]]
 type = "file"