Skip to content

Commit 874287a

Browse files
committed
add 1.7.2 release notes
1 parent 78961dc commit 874287a

2 files changed

Lines changed: 440 additions & 0 deletions

File tree

doc/en-US/release-notes/1.7.2.md

Lines changed: 220 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,220 @@
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 24, 2025 (25 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+
- Shortened chat input header height to save screen space
128+
- Tools list now displayed in fullscreen mode
129+
130+
**Code Refactoring**:
131+
- Extracted `chatApi.ts` from `Chat.tsx` (1431→1384 lines)
132+
- Improved code maintainability and modularity
133+
134+
### 8) Dependency Upgrades
135+
136+
Updated 11 third-party dependencies to the latest stable versions:
137+
138+
**AWS & Azure**:
139+
- `AWSSDK.S3`: 4.0.7.1 → 4.0.7.11
140+
- `Azure.Storage.Blobs`: 12.25.0 → 12.26.0
141+
142+
**Entity Framework Core**:
143+
- `Microsoft.EntityFrameworkCore.Design`: 9.0.9 → 9.0.10
144+
- `Microsoft.EntityFrameworkCore.Sqlite`: 9.0.9 → 9.0.10
145+
- `Microsoft.EntityFrameworkCore.SqlServer`: 9.0.9 → 9.0.10
146+
147+
**Other Key Dependencies**:
148+
- `MiniExcel`: 1.41.3 → 1.41.4
149+
- `Mscc.GenerativeAI`: 2.8.9 → 2.8.17 (Google AI SDK)
150+
- `OpenAI`: 2.4.0 → 2.5.0 (OpenAI SDK)
151+
- `Swashbuckle.AspNetCore`: 9.0.4 → 9.0.6 (Swagger)
152+
- `System.Runtime.Caching`: 9.0.9 → 9.0.10
153+
- `TencentCloudSDK.Sms`: 3.0.1273 → 3.0.1330 (Tencent Cloud SMS)
154+
155+
### 9) Other Improvements
156+
157+
**Development Documentation**:
158+
- New documentation: How to add a field to ChatConfig (`add-chatconfig-field.md`)
159+
- Helps developers quickly understand the ChatConfig extension process
160+
161+
**Bug Fixes**:
162+
- Fixed BE compilation error caused by MCP upgrade
163+
- Fixed frontend build error
164+
165+
---
166+
167+
## Database Migration
168+
169+
**Important Notice**: This version includes database schema changes. Please execute the migration script before upgrading.
170+
171+
Migration script location: `src/scripts/db-migration/1.7/20251016-1.7.2.sql`
172+
173+
Major changes:
174+
1. Added `ChatConfig.CodeExecutionEnabled` field
175+
2. Adjusted `ChatConfig.ReasoningEffort` values (added 1 to existing values)
176+
3. Added/updated 8 model records in `ModelReference` table
177+
178+
The migration script includes safety checks and can be executed repeatedly.
179+
180+
---
181+
182+
## Upgrade Recommendations
183+
184+
1. **Backup Database**: Always backup your database before upgrading
185+
2. **Execute Migration Script**: Run `20251016-1.7.2.sql`
186+
3. **Update Backend**: Deploy the new backend code
187+
4. **Update Frontend**: Deploy the new frontend code
188+
5. **Verify Features**:
189+
- Test streaming image generation functionality
190+
- Verify new models are displayed correctly
191+
- Check reasoning level settings work properly
192+
- Confirm code execution functionality configuration is correct
193+
194+
---
195+
196+
## Tech Stack Versions
197+
198+
- .NET: 8.0/9.0
199+
- Entity Framework Core: 9.0.10
200+
- OpenAI SDK: 2.5.0
201+
- Google AI SDK: 2.8.17
202+
- Azure Storage Blobs: 12.26.0
203+
- AWS S3 SDK: 4.0.7.11
204+
205+
---
206+
207+
## Contributors
208+
209+
Thanks to all the developers who contributed to this release!
210+
211+
---
212+
213+
## What's Next
214+
215+
- Continue optimizing image generation experience
216+
- Expand support for more models
217+
- Enhance API test coverage
218+
- Performance optimization and stability improvements
219+
220+
For questions or suggestions, please provide feedback on [GitHub Issues](https://github.com/sdcb/chats/issues).

0 commit comments

Comments
 (0)