Merge branch '3.6.x'

Author: CodeCasterX

.gitignore

@@ -10,4 +10,55 @@ target/
 build/
 
 # Claude Code local settings
-.claude/settings.local.json
+.claude/settings.local.json
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv/
+ENV/
+env.bak/
+venv.bak/
+*.egg
+*.egg-info/
+dist/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.manifest
+*.spec
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
+.scrapy
+docs/_build/
+.pybuilder/
+.ipynb_checkpoints
+.pytype/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pyenv

AGENTS.en.md

@@ -0,0 +1,41 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+This repo hosts the FIT framework and related engines.
+- `framework/` contains the core implementations (`framework/fit/java`, `framework/fit/python`, `framework/waterflow`, `framework/fel`).
+- `docs/` holds user guides, quick starts, and white papers.
+- `examples/` contains runnable samples for FIT and FEL.
+- `docker/` provides container build assets.
+- `build/` is the Maven build output (generated).
+
+## Build, Test, and Development Commands
+
+- `mvn clean install` (repo root): builds all modules and runs tests; outputs to `build/`.
+- `cd framework/fit/java && mvn clean install`: builds the Java FIT framework only.
+- `./build/bin/fit start`: starts the Java runtime (uses Node.js); default port `8080`.
+- `./.claude/run-test.sh`: full CI-like flow (build, start, health checks).
+
+## Coding Style & Naming Conventions
+
+- Java formatting uses the IntelliJ profile `CodeFormatterFromIdea.xml`.
+- Public/protected Java APIs require Javadoc with `@param`/`@return` tags.
+- Class headers must include `@author` and `@since yyyy-MM-dd`.
+- Branch naming follows module prefixes and intent, e.g. `fit-feature-xxx`, `waterflow-bugfix-yyy`.
+
+## Testing Guidelines
+
+- Java tests run via Maven (Surefire); `mvn clean install` is the baseline.
+- Run targeted module tests from their module directory when iterating.
+- Keep tests close to source modules; name tests with `*Test` where applicable.
+
+## Commit & Pull Request Guidelines
+
+- Commit messages use a module tag in brackets and a short Chinese summary, e.g. `[fit] 修复某问题`.
+- Keep commit subjects concise (around 20 characters); add details in the body if needed.
+- PRs should be based on the correct module/version branch and normally include a single commit.
+
+## Security & Configuration Tips
+
+- Do not report vulnerabilities via public issues; follow `SECURITY.md`.
+- Ensure git hooks are enabled for encoding checks (`git-hooks/check-utf8-encoding.sh`).

AGENTS.md

@@ -0,0 +1,41 @@
+# 仓库指南
+
+## 项目结构与模块划分
+
+本仓库包含 FIT 框架及相关引擎。
+- `framework/` 为核心实现目录（`framework/fit/java`、`framework/fit/python`、`framework/waterflow`、`framework/fel`）。
+- `docs/` 存放用户指南、快速入门与白皮书。
+- `examples/` 包含 FIT/FEL 可运行示例。
+- `docker/` 提供容器构建资源。
+- `build/` 为 Maven 构建产物输出目录（自动生成）。
+
+## 构建、测试与开发命令
+
+- `mvn clean install`（仓库根目录）：构建全部模块并运行测试，产物输出到 `build/`。
+- `cd framework/fit/java && mvn clean install`：仅构建 Java FIT 框架。
+- `./build/bin/fit start`：启动 Java 运行时（依赖 Node.js）；默认端口 `8080`。
+- `./.claude/run-test.sh`：完整验证流程（构建、启动、健康检查）。
+
+## 编码风格与命名规范
+
+- Java 格式化使用 IntelliJ 配置 `CodeFormatterFromIdea.xml`。
+- 公共/受保护的 Java API 需要 Javadoc，并包含 `@param`/`@return`。
+- 类头需包含 `@author` 与 `@since yyyy-MM-dd`。
+- 分支命名使用模块前缀与意图，例如 `fit-feature-xxx`、`waterflow-bugfix-yyy`。
+
+## 测试规范
+
+- Java 测试通过 Maven（Surefire）执行，`mvn clean install` 为基线命令。
+- 迭代时可在模块目录运行定向测试。
+- 测试与源码同模块放置，命名优先使用 `*Test`。
+
+## 提交与 PR 规范
+
+- 提交信息以模块标签开头，中文简述，例如 `[fit] 修复某问题`。
+- 标题建议 20 字左右，必要时在正文补充细节。
+- PR 基于正确的模块/版本分支，通常仅包含一次提交。
+
+## 安全与配置提示
+
+- 安全问题请勿在公共 Issue 报告，按 `SECURITY.md` 指引私下提交。
+- 请启用 git hooks 进行编码检查（`git-hooks/check-utf8-encoding.sh`）。

CONTRIBUTING.md

@@ -86,11 +86,10 @@ exec git-hooks/check-utf8-encoding.sh
 
 ### 提交信息格式
 
-- 以中括号开头，然后加上模块名，例如 `[fit]`。
 - 用简短的语句描述提交的主要内容，不要太长，建议 20 个字以内，需要使用中文，结尾不需要句号。
 - 如有必要，在简短的描述后添加一个空行，然后补充详细说明，可以使用多行来描述。
 - 说明中可以包括问题的原因、解决方法和影响范围等。
-- 样例：`[fit] 修复某问题`。
+- 样例：`修复某问题`。
 
 ## 代码审查
 

README.md

@@ -101,9 +101,7 @@ build/
 **启动命令**
 
 ```
-mkdir dynamic-plugins
-cd dynamic-plugins
-../build/bin/fit start
+./build/bin/fit start
 ```
 
 > 以上编译构建出的 `fit` 命令可以通过系统操作（别名或添加系统路径）来简化输入。

framework/fit/java/README.md

@@ -17,6 +17,7 @@ FIT 函数平台是一套支持多语言融合编程、插件化开发、聚散
 * Maven，推荐版本 Maven 3.8.8+
 * 对 fitframework 构建：在 framework/fit/java 目录下使用 Maven 对框架进行编译：`mvn clean install`
 * 对 您的项目 构建：在您的项目下进行编译：`mvn clean install`
+* 内存版注册中心启动：参考 `../registry-center.md`
 
 #### 0. 依赖
 在系统生成的 pom 文件中，添加 Web 相关的依赖，如下所示：
@@ -118,4 +119,4 @@ public class Controller {
 - [配置架构设计](fit-conf/README.md)
 - [插件架构设计](fit-plugin/README.md)
 - [运行时设计](fit-runtime/README.md)
-- [启动程序设计](fit-launcher/README.md)
+- [启动程序设计](fit-launcher/README.md)

framework/fit/python/README.md

@@ -27,7 +27,7 @@ FIT for Python 是基于 FIT Framework 的 Python 运行时与插件开发套件
 ## 配置说明
 
 - 默认配置位于 `conf/`，包括 `application.yml`、`fit.yml`、`fit_startup.yml` 等。
-- 注册中心：`conf/application.yml` 中 `registry-center` 配置为框架发现和加载插件的前置条件，需保证注册中心已启动（可参考 Java 框架的本地注册中心启动方式），并与 `server.addresses` 等参数保持一致。
+- 注册中心：`conf/application.yml` 中 `registry-center` 配置为框架发现和加载插件的前置条件，需保证注册中心已启动并与 `server.addresses` 等参数保持一致。推荐先启动 Java 内存版注册中心，参考 `../registry-center.md`。
 - 如使用直连内存注册中心，默认 `mode: DIRECT`，地址示例 `localhost:8080`；如使用代理/Nacos，请按实际环境调整 `mode`、`addresses`、`protocol` 等字段。
 - 启动前请根据本地环境核对端口、协议及上下文路径，必要时同步修改插件侧的配置文件。
 
@@ -103,4 +103,4 @@ curl --request GET \
 - 启动报端口占用：调整 `conf/fit_startup.yml` 或 `application.yml` 中的端口后重启。
 - 注册中心连通性：确认 `registry-center.addresses` 可达，必要时先用 curl/ping 验证。
 - 重新安装依赖：在已激活虚拟环境中执行 `pip install -r requirements.txt --force-reinstall`。
-- 停止服务：直接中断前台进程（Ctrl+C），或关闭终端会话。
+- 停止服务：直接中断前台进程（Ctrl+C），或关闭终端会话。

framework/fit/registry-center.md

@@ -0,0 +1,39 @@
+# FIT 注册中心（Java 内存版）
+
+本文说明如何启动 FIT Framework 自带的 Java 内存注册中心，用于本地开发或与 Python 运行时联调。该注册中心随 Java 侧构建产物一起生成，无需额外安装服务。
+
+## 前置要求
+
+- Java 17+
+- Maven 3.8.8+
+- Node.js 12+（`fit` 启动脚本依赖 Node.js）
+
+## 启动步骤（最简）
+
+1. 编译 Java 侧框架：
+   ```bash
+   cd framework/fit/java
+   mvn clean install
+   ```
+   产物会输出到仓库根目录 `build/`，其中包含：
+   - `build/bin/fit` 启动脚本
+   - `build/plugins/fit-service-coordination-simple-*.jar` 内存注册中心插件
+
+2. 启动 FIT 服务（默认启用内存注册中心）：
+   ```bash
+   ./build/bin/fit start
+   ```
+   可选：如果希望把当前目录作为动态插件目录，可直接在该目录执行；如需隔离插件，可自行进入其他空目录再执行。
+
+3. 验证服务：
+   ```bash
+   curl http://localhost:8080/actuator/plugins
+   ```
+
+## 常见说明
+
+- 默认端口为 `8080`，若冲突可在启动命令中覆盖，例如：
+  ```bash
+  ./build/bin/fit start server.http.port=8081
+  ```
+- 内存注册中心适用于单机或测试场景；需要 Nacos 时，请改用对应的 Nacos 插件和配置。