Skip to content

Commit a029c74

Browse files
committed
docs: 新增 release 文档
1 parent 0c75060 commit a029c74

1 file changed

Lines changed: 105 additions & 0 deletions

File tree

docs/release/RELEASE-v0.1.0.md

Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
# COMSOL Agent Desktop v0.1.0 — 首个版本发布说明
2+
3+
**发布日期**:2025 年 2 月
4+
**版本**:0.1.0
5+
**桌面端 Tag**`desktop-v0.1.0`
6+
7+
---
8+
9+
## 概述
10+
11+
COMSOL Agent 首个正式桌面版发布。通过自然语言描述建模需求,自动生成可在 COMSOL Multiphysics 中打开的 `.mph` 模型文件。本版本提供 **仅 Windows** 安装包,安装包内已包含 **Java 11**,无需单独安装 Python 或 JDK。**最终构建的安装程序会自行引用打包进去的 Java 11 环境**,其余行为与测试环境一致(不依赖系统 JAVA_HOME、不自动下载)。
12+
13+
---
14+
15+
## 下载与安装
16+
17+
### Windows 用户(推荐)
18+
19+
1. 打开 [GitHub Releases](https://github.com/iammm0/comsol-agent/releases),找到 **COMSOL Agent Desktop v0.1.0**(或 tag `desktop-v0.1.0`)。
20+
2.**Assets** 中下载其一:
21+
- **`.exe`**(NSIS 安装程序)— 推荐
22+
- **`.msi`**(Windows Installer)
23+
3. 运行安装程序,按提示完成安装。
24+
4. 从开始菜单或桌面快捷方式启动 **COMSOL Agent**
25+
26+
### 系统要求
27+
28+
- **操作系统**:Windows 10/11(64 位)
29+
- **COMSOL Multiphysics**:6.1 或更高(推荐 6.3+)
30+
- **网络**:首次使用需配置 LLM 后端(API 或本地 Ollama),需联网
31+
- **磁盘**:约 500 MB(含内嵌 Java 11)
32+
33+
无需单独安装 Python、JDK 或 Node.js。
34+
35+
---
36+
37+
## 主要功能
38+
39+
- **自然语言建模**:在输入框中用中文或英文描述几何、物理场、网格、研究等需求,Agent 自动规划并执行,生成 `.mph` 模型。
40+
- **ReAct 推理**:支持多轮观察与迭代,提高复杂模型的生成成功率。
41+
- **多 LLM 后端**:支持 DeepSeek、Kimi、Ollama、OpenAI 兼容等,在设置中配置 API Key 或 URL。
42+
- **COMSOL 与 Java 配置**:在设置 → COMSOL 配置中通过 **「选择目录」** 在文件管理器里选择 COMSOL 的 `plugins` 目录及 Java 8/11 安装目录(可选,留空则使用安装包内嵌 Java 11),无需手动填写路径或改系统环境变量。
43+
- **会话与记忆**:多会话、摘要式记忆,便于连续建模与偏好学习。
44+
- **主题与界面**:支持浅色/深色主题与多种强调色。
45+
46+
---
47+
48+
## 首次使用必配项
49+
50+
安装并启动后,在应用内 **设置** 中完成:
51+
52+
1. **LLM 后端**(设置 → LLM 配置):选择并配置至少一个(如 DeepSeek API Key、或本机 Ollama 地址)。
53+
2. **COMSOL 与 Java**(设置 → COMSOL 配置):点击 **「选择目录」** 在文件管理器中选取本机 COMSOL 的 `plugins` 目录(6.3+ 推荐);如需使用自备的 Java 8 或 11,可再选择对应 JDK 安装目录,留空则使用安装包内嵌的 Java 11。
54+
55+
配置完成后即可在输入框输入建模需求开始使用。输入 **`/help`** 可查看斜杠命令,**`/doctor`** 可做环境诊断。
56+
57+
---
58+
59+
## 构建桌面安装包(维护者)
60+
61+
安装包需同时包含**前端、Python 后端(bridge)和 Java 11**,否则会出现 “Python bridge not initialized”。推荐在**项目根目录**执行一键脚本:
62+
63+
```powershell
64+
# 项目根下执行
65+
.\scripts\bundle-desktop.ps1
66+
```
67+
68+
或:
69+
70+
```batch
71+
scripts\bundle-desktop.bat
72+
```
73+
74+
脚本会依次执行:
75+
76+
1. **build-bridge.ps1**:用 PyInstaller 将 Python 后端打成 `comsol-agent-bridge-<target>.exe`,放到 `desktop/src-tauri/binaries/`
77+
2. **download-jdk11.ps1**:将 JDK 11 下载到 `desktop/src-tauri/resources/runtime/java`
78+
3. **npm run tauri build**:在 `desktop` 下打包 NSIS/MSI。
79+
80+
**环境要求**:已安装 Python(含项目依赖,如 `pip install -e .``uv sync`)、Node.js、Rust;PyInstaller 会在第一步自动安装。完成后安装包位于 `desktop/src-tauri/target/release/bundle/nsis``msi` 目录。
81+
82+
若在 `desktop` 目录下构建,也可直接执行 `npm run bundle`(内部会调用上述两个 PowerShell 脚本再执行 tauri build)。
83+
84+
---
85+
86+
## 已知限制
87+
88+
- **桌面端仅支持 Windows**:macOS 与 Linux 请使用 [从源码运行](https://github.com/iammm0/comsol-agent#方式二从源码运行含桌面应用) 或 Python API。
89+
- **依赖 COMSOL 本机安装**:需在本地已安装 COMSOL Multiphysics,Agent 通过其 Java API 生成模型。
90+
- **LLM 需自行配置**:不包含内置大模型,需自备 API 或本地 Ollama 等。
91+
92+
---
93+
94+
## 文档与支持
95+
96+
- **安装与配置**[INSTALL.md](../getting-started/INSTALL.md)[CONFIG.md](../getting-started/CONFIG.md)
97+
- **LLM 后端示例**[llm-backends.md](../getting-started/llm-backends.md)
98+
- **项目主页**[README](https://github.com/iammm0/comsol-agent)
99+
- **问题反馈**[GitHub Issues](https://github.com/iammm0/comsol-agent/issues)
100+
101+
---
102+
103+
## 开源协议
104+
105+
[MIT License](https://github.com/iammm0/comsol-agent/blob/main/LICENSE)

0 commit comments

Comments
 (0)