chore(entity): 为 entity 包下部分实体类补齐 Javadoc

[Coder-xiaosuo]

Describe what this PR does / why we need it

在阅读 entity 包下的实体类代码时，发现部分类的字段缺少标准的 Javadoc 注释，仅使用了行内注释 //（如 Agent.java、SemanticModel.java 等）。这导致：

1. IDE 无法在智能提示中显示字段说明，影响开发体验；
2. 生成的 API 文档（如 JavaDoc 站点）不完整，不利于项目文档建设。

本次 PR 参照项目中已有类注释的格式（如 Agent 类上的 /** Agent Entity Class */），统一将字段的行内注释补齐为标准的 Javadoc 格式 /** ... */，并对部分类缺失的类级别 Javadoc 一并补充，使 entity 包的注释风格保持一致。

Does this pull request fix one issue?

本次改动为纯代码注释补充，未关联具体 Issue，如有需要我可以后续补充创建。

Describe how you did it

1. 遍历 entity 包下的所有实体类，识别出缺失标准 Javadoc 的字段和类；
2. 参考项目内已有的注释风格（如 Agent 类的类注释、Component 类的字段注释），保持描述简洁且信息准确；
3. 将原有的行内注释 // xxx 迁移至字段上方的 /** xxx */ 格式，并补充了部分类级别的概要注释；
4. 本次修改仅涉及注释，未对任何业务逻辑代码做变更。

Describe how to verify it

1. 本地执行 mvn clean compile 确认编译通过无报错；
2. 在 IDE（如 IntelliJ IDEA）中打开任意被修改的实体类，将鼠标悬停在字段上，确认智能提示中能正确显示新增的 Javadoc 描述；
3. 执行 mvn javadoc:javadoc 生成 JavaDoc 站点，在生成的 API 文档中核对实体类的字段说明是否完整展示；
4. 执行 mvn checkstyle:check 和 mvn spotless:check 确认代码风格符合项目规范。

Special notes for reviews

1. 本次修改涉及的文件均位于 entity 包下，仅限注释补充，零业务逻辑变更，风险极低；
2. 对于部分字段（如 Prompt 类中的 agent 字段），我参考了该字段在上下文中实际承载的含义编写注释，如有表述不准确的地方，欢迎 reviewers 指出，我会及时修正；

[Coder-xiaosuo]

Describe what this PR does / why we need it

在阅读 entity 包下的实体类代码时，发现部分类的字段缺少标准的 Javadoc 注释，仅使用了行内注释 //（如 Agent.java、SemanticModel.java 等）。这导致：

1. IDE 无法在智能提示中显示字段说明，影响开发体验；
2. 生成的 API 文档（如 JavaDoc 站点）不完整，不利于项目文档建设。

本次 PR 参照项目中已有类注释的格式（如 Agent 类上的 /** Agent Entity Class */），统一将字段的行内注释补齐为标准的 Javadoc 格式 /** ... */，并对部分类缺失的类级别 Javadoc 一并补充，使 entity 包的注释风格保持一致。

Does this pull request fix one issue?

本次改动为纯代码注释补充，未关联具体 Issue，如有需要我可以后续补充创建。

Describe how you did it

1. 遍历 entity 包下的所有实体类，识别出缺失标准 Javadoc 的字段和类；
2. 参考项目内已有的注释风格（如 Agent 类的类注释、Component 类的字段注释），保持描述简洁且信息准确；
3. 将原有的行内注释 // xxx 迁移至字段上方的 /** xxx */ 格式，并补充了部分类级别的概要注释；
4. 本次修改仅涉及注释，未对任何业务逻辑代码做变更。

Describe how to verify it

1. 本地执行 mvn clean compile 确认编译通过无报错；
2. 在 IDE（如 IntelliJ IDEA）中打开任意被修改的实体类，将鼠标悬停在字段上，确认智能提示中能正确显示新增的 Javadoc 描述；
3. 执行 mvn javadoc:javadoc 生成 JavaDoc 站点，在生成的 API 文档中核对实体类的字段说明是否完整展示；
4. 执行 mvn checkstyle:check 和 mvn spotless:check 确认代码风格符合项目规范。

Special notes for reviews

1. 本次修改涉及的文件均位于 entity 包下，仅限注释补充，零业务逻辑变更，风险极低；
2. 对于部分字段（如 Prompt 类中的 agent 字段），我参考了该字段在上下文中实际承载的含义编写注释，如有表述不准确的地方，欢迎 reviewers 指出，我会及时修正；