feat: document compound field group update and WBS view flags

- 验证并对齐“按组更新复合字段值”接口实现，补充 UpdateCompoundFieldValueReq/Resp 及 WorkItemService 接口的 Javadoc，说明 OpenAPI 路径、支持的 action 类型以及按组更新语义
- 为获取工作流详情（WBS）的 WbsViewReq 请求对象和 Builder 新增文档注释，明确 need_union_deliverable 与 need_schedule_table_agg 两个查询参数的含义和行为，对齐官方 WBS 能力说明
- 通过 `mvn clean package` 本地构建，确认新增注释不会影响编译与打包

Co-Authored-By: Aime <aime@bytedance.com>
Change-Id: If579bcf767cb2d4fde1ea629aecaed6c7d0c387a

Author: lincg-bytedance

src/main/java/com/lark/project/service/workitem/WorkItemService.java

@@ -99,10 +99,22 @@ public interface WorkItemService {
     // 更新实际工时
     public UpdateWorkingHourRecordResp updateWorkingHourRecord(UpdateWorkingHourRecordReq req, RequestOptions reqOptions) throws Exception;
 
-    // 获取工作流详情（wbs）
+    /**
+     * 获取工作流详情（WBS）。
+     *
+     * <p>对应 OpenAPI：{@code GET /open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view}。</p>
+     *
+     * <p>请求中可通过 {@code need_union_deliverable} 和 {@code need_schedule_table_agg}
+     * 参数控制返回是否包含融合交付物以及计划表自定义列聚合字段。</p>
+     */
     public WbsViewResp wbsView(WbsViewReq req, RequestOptions reqOptions) throws Exception;
 
-    //增量更新复合字段
-    UpdateCompoundFieldValueResp updateCompoundFieldValue(UpdateCompoundFieldValueReq req, RequestOptions reqOptions) throws Exception;
+    /**
+     * 按组更新复合字段值。
+     *
+     * <p>对应 OpenAPI：{@code POST /open_api/work_item/field_value/update_compound_field}，
+     * 支持对指定工作项的复合字段按组执行删除（delete）、更新（update）或添加（add）操作。</p>
+     */
+    public UpdateCompoundFieldValueResp updateCompoundFieldValue(UpdateCompoundFieldValueReq req, RequestOptions reqOptions) throws Exception;
 
 }

src/main/java/com/lark/project/service/workitem/builder/UpdateCompoundFieldValueReq.java

@@ -6,6 +6,12 @@
 
 import java.util.List;
 
+/**
+ * 按组更新复合字段值的请求对象。
+ *
+ * <p>对应 OpenAPI：{@code POST /open_api/work_item/field_value/update_compound_field}，
+ * 用于对指定工作项的复合字段按组执行删除（delete）、更新（update）或添加（add）操作。</p>
+ */
 public class UpdateCompoundFieldValueReq {
     @Body
     private UpdateCompoundFieldValueReqBody body;

src/main/java/com/lark/project/service/workitem/builder/UpdateCompoundFieldValueResp.java

@@ -2,5 +2,11 @@
 
 import com.lark.project.core.response.BaseResponse;
 
+/**
+ * 按组更新复合字段值的响应对象。
+ *
+ * <p>对应 OpenAPI：{@code POST /open_api/work_item/field_value/update_compound_field}，
+ * 返回请求是否执行成功以及错误码信息。</p>
+ */
 public class UpdateCompoundFieldValueResp extends BaseResponse {
 }

src/main/java/com/lark/project/service/workitem/builder/WbsViewReq.java

@@ -22,6 +22,11 @@
 import com.lark.project.core.annotation.Query;
 import com.lark.project.service.workitem.model.Expand;
 
+/**
+ * 获取工作流详情（WBS）的请求对象。
+ *
+ * <p>对应 OpenAPI：{@code GET /open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view}。</p>
+ */
 public class WbsViewReq {
     @Path
     @SerializedName("project_key")
@@ -129,11 +134,22 @@ public Builder workItemID(Long workItemID) {
             return this;
         }
 
+        /**
+         * 是否融合需要交付物。
+         *
+         * <p>对应查询参数 {@code need_union_deliverable}，含义与请求体
+         * {@link Expand#getNeedUnionDeliverable()} 一致。</p>
+         */
         public Builder needUnionDeliverable(Boolean needUnionDeliverable) {
             this.needUnionDeliverable = needUnionDeliverable;
             return this;
         }
 
+        /**
+         * 扩展查询：是否需要计划表自定义列聚合字段。
+         *
+         * <p>对应查询参数 {@code need_schedule_table_agg}。</p>
+         */
         public Builder needScheduleTableAgg(Boolean needScheduleTableAgg) {
             this.needScheduleTableAgg = needScheduleTableAgg;
             return this;