|
| 1 | +<!-- Language: en-US --> |
| 2 | +<p align="right"><b>English</b> | <a href="../../zh-CN/release-notes/1.7.2.md">简体中文</a></p> |
| 3 | + |
| 4 | +# Chats 1.7.2 Release Notes |
| 5 | + |
| 6 | +> Release Date: October 27, 2025 (28 commits since 1.7.1) |
| 7 | +
|
| 8 | +Version 1.7.2 is a significant feature enhancement and quality improvement release, primarily focused on streaming image generation support, code execution capabilities, API testing framework, extended model support, along with multiple frontend experience optimizations and bug fixes. |
| 9 | + |
| 10 | +## Highlights |
| 11 | + |
| 12 | +- Streaming Image Generation: `gpt-image-1` and `gpt-image-1-mini` now support streaming image generation with real-time progress |
| 13 | +- Gemini Code Execution Display Optimization: Code execution results displayed as tool calls for better clarity |
| 14 | +- API Integration Testing Framework: New `Chats.BE.ApiTest` project with comprehensive OpenAI-compatible API tests |
| 15 | +- New Model Support: Added `gpt-5-codex`, `gpt-5-pro`, and `gpt-image-1-mini` model references |
| 16 | +- Code Execution Configuration: ChatConfig now includes `CodeExecutionEnabled` field |
| 17 | +- Reasoning Level Expansion: Added `minimal` reasoning level for gpt-5 series |
| 18 | +- Frontend Experience Optimization: Image size adjustments, Markdown line break fixes, UI layout improvements |
| 19 | +- Dependency Upgrades: Updated 11 third-party dependencies to keep the tech stack current |
| 20 | + |
| 21 | +--- |
| 22 | + |
| 23 | +## Feature Details and Improvements |
| 24 | + |
| 25 | +### 1) Streaming Image Generation Support (Database Migration Required) |
| 26 | + |
| 27 | +Complete streaming support added for image generation service: |
| 28 | +- **Backend Implementation**: |
| 29 | + - Major refactor of `ImageGenerationService` with streaming support for `gpt-image-1` and `gpt-image-1-mini` |
| 30 | + - Real-time image generation progress push, allowing users to view the generation process instantly |
| 31 | + - Optimized network transmission: Removed unnecessary server responses (type 12) to save bandwidth |
| 32 | + - Automatic routing: Switches to non-streaming mode when `n>1` (streaming mode doesn't support multiple image generation) |
| 33 | + |
| 34 | +- **Frontend Support**: |
| 35 | + - Full frontend support for streaming image generation |
| 36 | + - Real-time display of image generation progress |
| 37 | + - Image size adjustment support for `gpt-image-1-mini` model |
| 38 | + - Tested and confirmed streaming image generation works correctly |
| 39 | + |
| 40 | +- **Bug Fixes**: |
| 41 | + - Fixed reasoning effort not supported in API image generation service |
| 42 | + - Fixed reasoning effort settings not taking effect |
| 43 | + |
| 44 | +### 2) Gemini Code Execution Display Optimization |
| 45 | + |
| 46 | +Optimized display of Google AI (Gemini) code execution results: |
| 47 | +- Code execution results displayed as tool calls instead of raw text output |
| 48 | +- New `ToolCallSegment` type to support code execution tool calls |
| 49 | +- Extended `StepContent` to support serialization and deserialization of tool call segments |
| 50 | +- Added `FromCodeExecution` factory method to `ChatSegmentItem` |
| 51 | +- Frontend can now display code execution process and results more clearly, enhancing user experience |
| 52 | + |
| 53 | +### 3) API Integration Testing Framework |
| 54 | + |
| 55 | +New `Chats.BE.ApiTest` xUnit test project for comprehensive OpenAI-compatible API testing: |
| 56 | +- **Test Coverage**: |
| 57 | + - `ChatCompletionTests`: Chat completion API tests |
| 58 | + - `ImageGenerationTests`: Image generation API tests (252 lines) |
| 59 | + - `ToolCallTests`: Tool call API tests |
| 60 | + - `ReasoningModelTests`: Reasoning model API tests |
| 61 | + - `ModelsTests`: Model list API tests |
| 62 | + - `CachedCompletionTests`: Cached completion API tests |
| 63 | + |
| 64 | +- **Testing Infrastructure**: |
| 65 | + - `ApiTestFixture`: Test fixture providing test environment setup |
| 66 | + - `Program.cs`: 348 lines, complete test program entry point |
| 67 | + - `appsettings.json`: Test configuration file |
| 68 | + - `QUICKSTART.md`: Quick start documentation |
| 69 | + |
| 70 | +- **Statistics**: Added 1,252 lines of test code ensuring API compatibility and quality |
| 71 | + |
| 72 | +### 4) Code Execution Configuration (Database Migration Required) |
| 73 | + |
| 74 | +Added code execution control to ChatConfig: |
| 75 | +- New `CodeExecutionEnabled` field to control whether code execution is enabled |
| 76 | +- Database migration script: `20251016-1.7.2.sql` |
| 77 | +- Default value is `false` (disabled), administrators can enable as needed |
| 78 | +- Supports fine-grained code execution permission control |
| 79 | + |
| 80 | +### 5) Reasoning Level Expansion (Database Migration Required) |
| 81 | + |
| 82 | +Extended Reasoning Effort configuration: |
| 83 | +- Added `minimal` reasoning level for gpt-5 series models |
| 84 | +- Reasoning level adjustment: |
| 85 | + - Original levels: 1 (low), 2 (medium), 3 (high) |
| 86 | + - New levels: 1 (minimal), 2 (low), 3 (medium), 4 (high) |
| 87 | +- Automatic database migration: Adds 1 to existing non-zero values to adapt to the new level system |
| 88 | +- Migration only executes if level 4 doesn't exist in the database to avoid duplicate execution |
| 89 | + |
| 90 | +### 6) New Model Support (Database Migration Required) |
| 91 | + |
| 92 | +Added the following models to the `ModelReference` table: |
| 93 | + |
| 94 | +**gpt-5-codex** (Model IDs 133/533): |
| 95 | +- Release Date: September 15, 2025 |
| 96 | +- Context Window: 400,000 tokens |
| 97 | +- Max Response: 128,000 tokens |
| 98 | +- Pricing: Input $2/1M tokens, Output $10/1M tokens |
| 99 | +- Supports streaming, vision, and system prompts |
| 100 | + |
| 101 | +**gpt-5-pro** (Model IDs 134/534): |
| 102 | +- Release Date: August 7, 2025 |
| 103 | +- Context Window: 400,000 tokens |
| 104 | +- Max Response: 272,000 tokens |
| 105 | +- Pricing: Input $15/1M tokens, Output $120/1M tokens |
| 106 | +- Supports streaming, vision, system prompts, and reasoning responses |
| 107 | + |
| 108 | +**gpt-image-1-mini** (Model IDs 135/535): |
| 109 | +- Release Date: October 6, 2025 |
| 110 | +- Context Window: 65,536 tokens |
| 111 | +- Max Response: 10 tokens |
| 112 | +- Pricing: Input $2/1M tokens, Output $8/1M tokens |
| 113 | +- Supports streaming image generation |
| 114 | + |
| 115 | +### 7) Frontend Experience Optimization |
| 116 | + |
| 117 | +Multiple frontend user experience improvements: |
| 118 | + |
| 119 | +**Markdown Rendering Optimization**: |
| 120 | +- Fixed extra blank lines in Markdown response messages |
| 121 | +- Enabled `remark-breaks` plugin to properly handle soft line breaks |
| 122 | +- Message display now conforms better to Markdown standards |
| 123 | + |
| 124 | +**UI Layout Improvements**: |
| 125 | +- Fixed SystemPrompt textarea scrolling issue |
| 126 | +- Fixed excessive spacing below chat messages after reducing input rows |
| 127 | +- Fixed ChatInput z-index issue to prevent being covered by other elements |
| 128 | +- Shortened chat input header height to save screen space |
| 129 | +- Tools list now displayed in fullscreen mode |
| 130 | + |
| 131 | +**Code Refactoring**: |
| 132 | +- Extracted `chatApi.ts` from `Chat.tsx` (1431→1384 lines) |
| 133 | +- Improved code maintainability and modularity |
| 134 | + |
| 135 | +### 8) Dependency Upgrades |
| 136 | + |
| 137 | +Updated 11 third-party dependencies to the latest stable versions: |
| 138 | + |
| 139 | +**AWS & Azure**: |
| 140 | +- `AWSSDK.S3`: 4.0.7.1 → 4.0.7.11 |
| 141 | +- `Azure.Storage.Blobs`: 12.25.0 → 12.26.0 |
| 142 | + |
| 143 | +**Entity Framework Core**: |
| 144 | +- `Microsoft.EntityFrameworkCore.Design`: 9.0.9 → 9.0.10 |
| 145 | +- `Microsoft.EntityFrameworkCore.Sqlite`: 9.0.9 → 9.0.10 |
| 146 | +- `Microsoft.EntityFrameworkCore.SqlServer`: 9.0.9 → 9.0.10 |
| 147 | + |
| 148 | +**Other Key Dependencies**: |
| 149 | +- `MiniExcel`: 1.41.3 → 1.41.4 |
| 150 | +- `Mscc.GenerativeAI`: 2.8.9 → 2.8.17 (Google AI SDK) |
| 151 | +- `OpenAI`: 2.4.0 → 2.5.0 (OpenAI SDK) |
| 152 | +- `Swashbuckle.AspNetCore`: 9.0.4 → 9.0.6 (Swagger) |
| 153 | +- `System.Runtime.Caching`: 9.0.9 → 9.0.10 |
| 154 | +- `TencentCloudSDK.Sms`: 3.0.1273 → 3.0.1330 (Tencent Cloud SMS) |
| 155 | + |
| 156 | +### 9) Other Improvements |
| 157 | + |
| 158 | +**Development Documentation**: |
| 159 | +- New documentation: How to add a field to ChatConfig (`add-chatconfig-field.md`) |
| 160 | +- Helps developers quickly understand the ChatConfig extension process |
| 161 | + |
| 162 | +**Bug Fixes**: |
| 163 | +- Fixed BE compilation error caused by MCP upgrade |
| 164 | +- Fixed frontend build error |
| 165 | + |
| 166 | +--- |
| 167 | + |
| 168 | +## Database Migration |
| 169 | + |
| 170 | +**Important Notice**: This version includes database schema changes. Please execute the migration script before upgrading. |
| 171 | + |
| 172 | +Migration script location: `src/scripts/db-migration/1.7/20251016-1.7.2.sql` |
| 173 | + |
| 174 | +Major changes: |
| 175 | +1. Added `ChatConfig.CodeExecutionEnabled` field |
| 176 | +2. Adjusted `ChatConfig.ReasoningEffort` values (added 1 to existing values) |
| 177 | +3. Added/updated 8 model records in `ModelReference` table |
| 178 | + |
| 179 | +The migration script includes safety checks and can be executed repeatedly. |
| 180 | + |
| 181 | +--- |
| 182 | + |
| 183 | +## Upgrade Recommendations |
| 184 | + |
| 185 | +1. **Backup Database**: Always backup your database before upgrading |
| 186 | +2. **Execute Migration Script**: Run `20251016-1.7.2.sql` |
| 187 | +3. **Update Backend**: Deploy the new backend code |
| 188 | +4. **Update Frontend**: Deploy the new frontend code |
| 189 | +5. **Verify Features**: |
| 190 | + - Test streaming image generation functionality |
| 191 | + - Verify new models are displayed correctly |
| 192 | + - Check reasoning level settings work properly |
| 193 | + - Confirm code execution functionality configuration is correct |
| 194 | + |
| 195 | +--- |
| 196 | + |
| 197 | +## Tech Stack Versions |
| 198 | + |
| 199 | +- .NET: 8.0/9.0 |
| 200 | +- Entity Framework Core: 9.0.10 |
| 201 | +- OpenAI SDK: 2.5.0 |
| 202 | +- Google AI SDK: 2.8.17 |
| 203 | +- Azure Storage Blobs: 12.26.0 |
| 204 | +- AWS S3 SDK: 4.0.7.11 |
| 205 | + |
| 206 | +--- |
| 207 | + |
| 208 | +## Contributors |
| 209 | + |
| 210 | +Thanks to all the developers who contributed to this release! |
| 211 | + |
| 212 | +Special thanks to: |
| 213 | +- [@sangyuxiaowu](https://github.com/sangyuxiaowu) - Fixed ChatInput CSS z-index issue (#104) |
| 214 | + |
| 215 | +--- |
| 216 | + |
| 217 | +## What's Next |
| 218 | + |
| 219 | +- Continue optimizing image generation experience |
| 220 | +- Expand support for more models |
| 221 | +- Enhance API test coverage |
| 222 | +- Performance optimization and stability improvements |
| 223 | + |
| 224 | +For questions or suggestions, please provide feedback on [GitHub Issues](https://github.com/sdcb/chats/issues). |
0 commit comments