Merge branch 'main' into 1.2.x-bugfix-getAppSuiteId

Author: ZJUPJM

.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -32,7 +32,8 @@ body:
       label: 版本信息 / Version Information
       description: 您使用的是哪个版本？/ Which version are you using?
       options:
-        - v1.1.0
+        - v1.2.2
+        - v1.1.2
         - v1.0.1
         - "其他 (请在下方说明) / Other (please specify below)"
     validations:

.github/PULL_REQUEST_TEMPLATE.md

@@ -10,14 +10,25 @@ Please do not create a Pull Request without creating an issue first.
 
 微小的变更（如错别字修复）不需要创建 Issue。
 Trivial changes like typos do not require a Github issue.
+
+提交 PR 之前请务必先阅读我们的贡献指南。
+Please read our Contributing Guide(CONTRIBUTING.md) before submitting your Pull Request.
+
+⚠️ 注意 / Note：
+
+不要重复创建类似的 PR，当你发现需要调整一个 PR 的时候，优先选择编辑修改它，而不是关闭之后再创建一个。
+Do not create a Pull Request without creating an issue first.
 -->
 
 ## 🔗 相关问题 / Related Issue
 
 <!-- 请先创建 Issue 讨论，然后在这里链接 -->
 <!-- Please create an issue for discussion first, then link it here -->
 
-**Issue 链接 / Issue Link:** #
+**Issue 链接 / Issue Link:** <mark>#{$IssueNumber}</mark> 👈👈
+
+<!-- 请修改 {$IssueNumber} 为真实的编号。 -->
+<!-- Please update {$IssueNumber} to an actual number. -->
 
 - [ ] 我已经创建了相关 Issue 并进行了讨论 / I have created and discussed the related issue
 - [ ] 这是一个微小的修改（如错别字），不需要 Issue / This is a trivial change (like typo fix) that doesn't need an issue
@@ -30,6 +41,8 @@ Trivial changes like typos do not require a Github issue.
 - [ ] 📚 文档更新 / Documentation update
 - [ ] 🔧 重构 / Refactoring (no functional changes)
 - [ ] ⚡ 性能优化 / Performance improvement
+- [ ] 📦 依赖升级 / Dependency upgrade (update dependencies to newer versions)
+- [ ] 🚀 功能增强 / Feature enhancement (improve existing functionality without breaking changes)
 - [ ] 🧹 代码清理 / Code cleanup
 
 ## 📝 变更目的 / Purpose of the Change

.gitignore

@@ -12,4 +12,7 @@ build/
 # docker
 docker/app-platform-tmp
 docker/.env
-docker/sql/init/data/tr_init_models.sql
+docker/sql/init/data/tr_init_models.sql
+
+# Claude Code settings
+.claude/

CONTRIBUTING.md

@@ -39,8 +39,11 @@
 ## 标签管理
 
 - 每个标签的名字和发布分支的名字需要保持一致。例如：`fit-java-1.0.0`、`waterflow-2.1.1`。
+- 纯数字版本的分支需要以 `v` 开头。例如：`v3.6.0`。
 - 候选版本以特殊词组结尾，后面可以跟若干数字代表序号。例如：`fit-java-1.0.0-alpha1` 或 `waterflow-python-2.0.0-beta2`。
 - 当标签被打出后，对应的发布分支应当删除，`Git-Flow` 模式下的 `*-main` 分支除外。
+- **注意：** 请不要使用自动生成的深色标签，如 `dependencies`、`python`、`java` 等，他们是平台自动生成用于机器人创建的 Issue 的。
+- 所有的 Issue 和 PR 都需要至少包含两种标签，一种是 `in: {$module}`，另一种是 `type: {$type}`。
 
 ## 开发规范
 
@@ -66,9 +69,10 @@ Licensed under the MIT License. See License.txt in the project root for license
   - 所有 `@param` 和 `@return` 的注释，最后都需要根据其类型添加引用，基本类型需要添加 `{@code }` 标记，其他需要添加 `{@link }` 标记。
   - 所有半角字符和全角字符之间需要增加一个空格，来使得整体排版规整，方便超长内容的换行。
 
-### 插件sql
+### 插件 SQL
 
 - 如果插件包含数据库相关操作，需要在插件的 `resources` 目录下创建 `sql` 目录，其中包含 `schema` 目录（存放创表相关语句）和 `data` 目录（存放预置数据相关的语句）。具体目录格式如下：
+
 ```text
 sql
 ├── schema

README.md

@@ -147,7 +147,6 @@ app-builder/
 │   └── template.zip
 ```
 
-
 加入数据库配置项，修改后的配置项如下所示：
 
 ```yml
@@ -181,13 +180,23 @@ app-engine:
 
 **启动命令**
 
+在框架输出目录的 `bin` 目录下执行启动命令
+
 ```
-fit start -Dfit.profiles.active=prod
+fit start
 ```
 
 > 这里直接使用了 `fit` 命令，该命令请参考 `fit-framework` 项目的[指导手册](https://github.com/ModelEngine-Group/fit-framework/blob/main/docs/framework/fit/java/quick-start-guide/03.%20%E4%BD%BF%E7%94%A8%E6%8F%92%E4%BB%B6%E7%9A%84%E7%83%AD%E6%8F%92%E6%8B%94%E8%83%BD%E5%8A%9B.md)。
 > 
-> 当前，`app-platform` 使用了 `fit` 的 3.5.1 版本，因此，如果采用手动编译，需要在 `fit-framework` 仓库中切换到 `v3.5.1` 标签处进行编译构建操作。
+> 当前，`app-platform` 使用了 `fit` 的 3.5.3 版本，因此，如果采用手动编译，需要在 `fit-framework` 仓库中切换到 `v3.5.3` 标签处进行编译构建操作。
+
+**调试命令**
+
+```
+fit debug
+```
+
+> 这里的调试命令背后使用了 Java 内置的远程调试命令，通过该技术，可以在进程启动之后，在 `IDEA` 中绑定启动端口进行远程调试。
 
 ---------
 
@@ -201,7 +210,7 @@ fit start -Dfit.profiles.active=prod
 
 **修改 ELSA 依赖地址**
 
-进入目录 `app-engine\frontend` ，搜索 `package.json` 文件的 ELSA 依赖地址：
+进入目录 `app-platform/frontend` ，搜索 `package.json` 文件的 ELSA 依赖地址：
 
 ```
 "dependencies": {
@@ -213,12 +222,12 @@ fit start -Dfit.profiles.active=prod
 
 **修改代理文件**
 
-修改 `AppPlatform/frontend` 目录下的 `proxy.config.json` 文件，可以修改需要访问的后端地址。如本地后端地址是 `http://127.0.0.1:8080` 。可以按照如下示例配置：
+修改 `app-platform/frontend` 目录下的 `proxy.config.json` 文件，可以修改需要访问的后端地址。如本地后端地址是 `http://127.0.0.1:8080` 。可以按照如下示例配置：
 
 ```json
 {
     "/api": {
-       "target": "http://127.0.0.1:5520",
+       "target": "http://127.0.0.1:8080",
        "secure": false,
        "changeOrigin": true,
        "pathRewrite": {
@@ -231,14 +240,16 @@ fit start -Dfit.profiles.active=prod
 **依赖安装**
 
 ```
-cd app-engine/frontend/
+cd app-platform/frontend/
 npm install
 ```
 
 **打包构建**
 
+在 `package.json` 中定义了多种打包脚本，这里以 `build:single` 为例：
+
 ```
-npm run build
+npm run build:single
 ```
 
 **启动命令**
@@ -253,15 +264,15 @@ npm run start
 
 在对话中使用大模型功能，需要对模型进行配置，包括大模型的地址和鉴权信息。
 首先在首页的`应用市场`一栏中找到 `模型配置应用`，并点击该应用。点击右上角`创意灵感` 的`开始配置`，如下图所示：
-![image-20250508203127410](doc/images/readme/model_config_inspiration.png)
+![model_config_inspiration](docs/images/readme/model_config_inspiration.png)
 然后点击回答的 `添加模型` 按钮，输入模型名称、API Key 和模型地址，并点击确认。此时模型添加成功。
 
 **应用创建**
 
 在首页的`应用开发`一栏中点击`创建空白应用`。如下所示：
-![image-20250508204618312](doc/images/readme/app_create.png)
+![app_create](docs/images/readme/app_create.png)
 输入所要创建的应用名称和简介，并点击 `创建`按钮，即可创建 AI 应用。接着在跳转后的应用配置页面上，在 `大模型` 一栏中选择自定义配置的模型。此时即可在对话框进行对话。如下所示：
-![image-20250508205124203](doc/images/readme/app_chat.png)
+![app_chat](docs/images/readme/app_chat.png)
 
 ## 文档
 

app-builder/plugins/aipp-classify-question/pom.xml

@@ -66,7 +66,7 @@
         <dependency>
             <groupId>org.fitframework.plugin</groupId>
             <artifactId>fit-message-serializer-json-jackson</artifactId>
-            <version>3.5.1</version>
+            <version>${fit.version}</version>
             <scope>test</scope>
         </dependency>
         <dependency>