meeglesdk 0.1.8 → 0.2.0

package/dist/types/workitem.d.ts

@@ -97,6 +97,8 @@ export interface WorkflowNode {
     owner_usage_mode?: OwnerUsageMode;
     /** 是否差异化排期 */
     different_schedule?: boolean;
+    /** 节点自定义字段 */
+    node_custom_fields?: FieldValuePair[];
 }
 /**
  * 状态流节点
@@ -225,6 +227,8 @@ export interface QueryWorkItemExpand {
     relation_fields_detail?: boolean;
     /** 是否需要复合字段组标识 */
     need_group_uuid_for_compound?: boolean;
+    /** 是否需要子任务父级信息 */
+    need_sub_task_parent?: boolean;
 }
 /**
  * 获取工作项详情请求
@@ -237,6 +241,14 @@ export interface QueryWorkItemRequest {
     /** 扩展查询选项 */
     expand?: QueryWorkItemExpand;
 }
+/**
+ * 创建工作项必填模式
+ */
+export type WorkItemCreateRequiredMode = 0 | 1;
+/**
+ * 创建工作项角色默认值计算模式
+ */
+export type WorkItemCreateRoleMode = 0 | 1;
 /**
  * 创建工作项请求
  */
@@ -254,7 +266,13 @@ export interface CreateWorkItemRequest {
      * - 0: 不校验必填项（默认）
      * - 1: 校验新建页必填项，未填字段返回创建失败并提示哪些字段未填
      */
-    required_mode?: number;
+    required_mode?: WorkItemCreateRequiredMode;
+    /**
+     * 角色可见性计算模式
+     * - 0: 不使用角色默认值（默认）
+     * - 1: 新建角色未传值时，使用配置侧的角色默认值
+     */
+    role_mode?: WorkItemCreateRoleMode;
 }
 /**
  * 更新工作项请求
@@ -270,6 +288,17 @@ export interface DeleteWorkItemRequest {
     /** 工作项 ID */
     work_item_id: number;
 }
+/**
+ * 冻结/解冻工作项请求
+ */
+export interface FreezeWorkItemRequest {
+    /** 空间 ID 或域名 */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** true 冻结，false 解冻 */
+    is_frozen: boolean;
+}
 /**
  * 字段选项
  */
@@ -280,8 +309,18 @@ export interface FieldOption {
     label: string;
     /** 是否默认选中 */
     is_default?: boolean;
+    /** 选项颜色 */
+    color?: string;
+    /** 选项排序 */
+    order?: number;
     /** 子选项（级联） */
     children?: FieldOption[];
+    /** 是否禁用 */
+    is_disabled?: number;
+    /** 是否可见 */
+    is_visibility?: number;
+    /** 所属工作项类型 key */
+    work_item_type_key?: string;
 }
 /**
  * 字段元数据
@@ -309,6 +348,44 @@ export interface FieldMeta {
  * API 直接返回字段数组
  */
 export type GetWorkItemMetaResponse = FieldMeta[];
+/**
+ * 获取工作项字段可选选项请求
+ */
+export interface GetFieldOptionsRequest {
+    /** 空间 ID 或域名 */
+    project_key: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 字段 key */
+    field_key: string;
+    /** 查询的第一个选项 key，用于分页 */
+    first_option_key?: string;
+}
+/**
+ * 获取工作项字段可选选项响应
+ */
+export interface GetFieldOptionsResponse {
+    /** 可选选项 */
+    options?: FieldOption[];
+    /** 是否允许用户添加选项 */
+    free_add?: boolean;
+    /** 是否有更多 */
+    has_more?: boolean;
+    /** 字段 key */
+    field_key?: string;
+    /** 字段名称 */
+    field_name?: string;
+    /** 字段类型 */
+    field_type?: string;
+    /** 级联字段选项类型 */
+    level_mode?: string;
+    /** 字段别名 */
+    field_alias?: string;
+    /** 级联字段可选层级 */
+    level_class?: string;
+}
 /** 操作者类型 */
 export type OperatorType = 'user' | 'auto' | 'system' | 'calc_field' | 'plugin' | 'others';
 /** 操作渠道类型 */
@@ -428,9 +505,9 @@ export interface GetOperationRecordsResponse {
 /** 复合字段操作类型 */
 export type CompoundFieldAction = 'add' | 'update' | 'delete';
 /**
- * 更新复合字段请求
+ * 按组更新复合字段值请求
  */
-export interface UpdateCompoundFieldRequest {
+export interface UpdateCompoundFieldValueRequest {
     /** 空间 ID 或域名 */
     project_key: string;
     /** 工作项 ID */
@@ -484,18 +561,25 @@ export interface DownloadAttachmentRequest {
 /**
  * 删除附件请求参数
  */
-export interface DeleteAttachmentRequest {
+export type DeleteAttachmentFieldSelector = {
+    /** 附件字段 key（与 field_alias 二选一） */
+    field_key: string;
+    /** 附件字段对接标识（与 field_key 二选一） */
+    field_alias?: never;
+} | {
+    /** 附件字段 key（与 field_alias 二选一） */
+    field_key?: never;
+    /** 附件字段对接标识（与 field_key 二选一） */
+    field_alias: string;
+};
+export type DeleteAttachmentRequest = {
     /** 空间 ID 或域名 */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number;
-    /** 附件字段 key（与 field_alias 二选一） */
-    field_key?: string;
-    /** 附件字段对接标识（与 field_key 二选一） */
-    field_alias?: string;
+    work_item_id: number | string;
     /** 要删除的附件 UUID 列表 */
     uuids: string[];
-}
+} & DeleteAttachmentFieldSelector;
 /**
  * 创建子任务请求
  */
@@ -552,10 +636,14 @@ export interface CompleteRollbackSubtaskRequest {
     assignee?: string[];
     /** 子任务角色负责人列表（角色联动模式使用） */
     role_assignee?: RoleOwner[];
+    /** 单个估分排期信息 */
+    schedule?: Schedule;
     /** 估分排期信息 */
     schedules?: Schedule[];
     /** 交付物字段列表 */
     deliverable?: FieldValuePair[];
+    /** 目标更新的字段列表 */
+    update_fields?: FieldValuePair[];
     /** 备注信息 */
     note?: string;
 }
@@ -639,6 +727,12 @@ export interface NodeTask {
     id: string;
     /** 节点 state_key */
     state_key: string;
+    /** 节点名称 */
+    node_name?: string;
+    /** 流程模板 ID */
+    template_id?: number;
+    /** 流程模板版本 */
+    version?: number;
     /** 子任务列表 */
     sub_tasks: SubTask[];
 }
@@ -694,7 +788,7 @@ export interface Comment {
     /** 评论 ID（字符串格式，避免大整数精度丢失） */
     id: string;
     /** 评论所属工作项 ID */
-    work_item_id: number;
+    work_item_id: number | string;
     /** 评论所属工作项类型 */
     work_item_type_key: string;
     /** 评论创建时间，毫秒精度 */
@@ -710,34 +804,98 @@ export interface Comment {
  * 富文本元素（用于创建/更新评论）
  * 参考: 富文本格式
  */
+export interface RichTextAttrs {
+    /** 背景色 */
+    backgroundColor?: string;
+    /** 是否加粗 */
+    bold?: string | boolean;
+    /** 字体色 */
+    fontColor?: string;
+    /** 字体大小 */
+    fontSize?: string;
+    /** 是否斜体 */
+    italic?: string | boolean;
+    /** 是否删除线 */
+    strikethrough?: string | boolean;
+    /** 是否下划线 */
+    underline?: string | boolean;
+    /** 超链接标题 */
+    title?: string;
+    /** 链接地址 */
+    url?: string;
+    /** 图片地址 */
+    src?: string;
+    /** 图片宽度 */
+    width?: string | number;
+    /** 兼容新增富文本属性 */
+    [key: string]: unknown;
+}
+/**
+ * 富文本行属性
+ */
+export interface RichTextLineAttrs {
+    /** 缩进层级 */
+    indent?: string | number;
+    /** 对齐方式 */
+    align?: string;
+    /** 是否引用 */
+    blockquote?: string | boolean;
+    /** 列表标识 */
+    list?: string;
+    /** 兼容新增行属性 */
+    [key: string]: unknown;
+}
+/**
+ * 富文本表格单元格
+ */
+export interface RichTextTableCell {
+    /** 行号 */
+    row: number;
+    /** 列号 */
+    col: number;
+    /** 单元格内容 */
+    cellContent: RichTextElement[];
+}
+/**
+ * 富文本表格信息
+ */
+export interface RichTextTableInfo {
+    /** 行数 */
+    rowSize: number;
+    /** 列数 */
+    colSize: number;
+    /** 单元格列表 */
+    cellList: RichTextTableCell[];
+}
 export interface RichTextElement {
-    /** 元素类型: paragraph, text, image 等 */
+    /** 元素类型 */
     type: string;
     /** 文本内容（type=text 时使用） */
     text?: string;
     /** 元素属性 */
-    attrs?: Record<string, unknown>;
+    attrs?: RichTextAttrs;
     /** 子元素（type=paragraph 时使用） */
     content?: RichTextElement[];
+    /** 行属性 */
+    lineAttrs?: RichTextLineAttrs;
+    /** 表格信息 */
+    tableInfo?: RichTextTableInfo;
 }
-/**
- * 创建评论请求
- */
-export interface CreateCommentRequest {
+export type CommentContentRequest = {
     /** 评论内容，仅支持原生文本（与 rich_text 二选一，都有值时 rich_text 优先） */
-    content?: string;
+    content: string;
     /** 评论内容，支持富文本格式（与 content 二选一，都有值时 rich_text 优先） */
     rich_text?: RichTextElement[];
-}
-/**
- * 更新评论请求
- */
-export interface UpdateCommentRequest {
+} | {
     /** 评论内容，仅支持原生文本（与 rich_text 二选一，都有值时 rich_text 优先） */
     content?: string;
     /** 评论内容，支持富文本格式（与 content 二选一，都有值时 rich_text 优先） */
-    rich_text?: RichTextElement[];
-}
+    rich_text: RichTextElement[];
+};
+/** 创建评论请求 */
+export type CreateCommentRequest = CommentContentRequest;
+/** 更新评论请求 */
+export type UpdateCommentRequest = CommentContentRequest;
 /**
  * 查询评论请求参数
  */
@@ -892,14 +1050,6 @@ export interface SearchWorkItemsByParamsRequest {
     fields?: string[];
     expand?: QueryWorkItemExpand;
 }
-/**
- * 通用搜索数据源
- * 接口: /open_api/view_search/universal_search
- */
-export interface UniversalSearchDataSource {
-    project_key: string;
-    work_item_type_keys: string;
-}
 /**
  * 通用搜索分页请求
  */
@@ -917,7 +1067,8 @@ export interface UniversalSearchPagination extends SearchAfterPagination {
  * 接口: /open_api/view_search/universal_search
  */
 export interface UniversalSearchRequest {
-    data_sources: UniversalSearchDataSource[];
+    project_key: string;
+    work_item_type_key: string;
     search_group: SearchGroup;
     field_selected?: string[];
     pagination?: UniversalSearchPaginationRequest;
@@ -926,7 +1077,7 @@ export interface UniversalSearchRequest {
  * 通用搜索响应
  */
 export interface UniversalSearchResponse {
-    data: WorkItemInfo[];
+    datas: WorkItemInfo[];
     pagination: UniversalSearchPagination;
 }
 /**
@@ -946,7 +1097,7 @@ export interface SearchByRelationRequest {
     relation_key: string;
     /** 关联类型：0=关联字段ID，1=关联字段对接标识 */
     relation_type?: RelationType;
-    /** 分页大小，最大 200 */
+    /** 分页大小，最大 50 */
     page_size?: number;
     /** 页码，从 1 开始 */
     page_num?: number;
@@ -966,6 +1117,8 @@ export interface CompositiveSearchRequest {
     query: string;
     /** 空间 key 列表（限定搜索范围） */
     project_keys?: string[];
+    /** 空间域名列表（限定搜索范围） */
+    simple_names?: string[];
     /** 工作项类型列表（query_type=workitem 时生效） */
     query_sub_type?: string[];
     /** 分页大小，默认 50 */
@@ -1175,6 +1328,19 @@ export interface NodeOperateRequest {
     /** 角色负责人（节点与角色绑定时使用） */
     role_assignee?: RoleOwner[];
 }
+/**
+ * 排期联动子项规则
+ */
+export interface ScheduleConstraintRule {
+    /** 是否联动节点 */
+    node?: boolean;
+    /** 是否联动任务 */
+    sub_task?: boolean;
+    /** 是否联动子流程 */
+    sub_process_node?: boolean;
+    /** 按工作项类型区分的 WBS 子实例联动配置 */
+    wbs_sub_instance_type?: Record<string, boolean>;
+}
 /**
  * 更新节点请求（节点流工作项）
  * 接口: PUT /open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id
@@ -1190,6 +1356,10 @@ export interface UpdateNodeRequest {
     fields?: FieldValuePair[];
     /** 角色负责人（节点与角色绑定时使用） */
     role_assignee?: RoleOwner[];
+    /** 排期联动子项规则 */
+    schedule_constraint_rule?: ScheduleConstraintRule;
+    /** 节点自定义字段 */
+    node_custom_fields?: FieldValuePair[];
 }
 /** 流转必填信息查询模式 */
 export type TransitionRequiredMode = 'unfinished';
@@ -1309,6 +1479,8 @@ export interface WbsViewQueryParams {
 export interface WbsViewExpand {
     /** 是否需要融合交付物信息 */
     need_union_deliverable?: boolean;
+    /** 是否需要计划表自定义列聚合字段 */
+    need_schedule_table_agg?: boolean;
     /** 是否需要 WBS 链路层级信息 */
     need_wbs_relation_chain_path?: boolean;
     /** 是否需要 WBS 链路实例信息 */
@@ -1347,175 +1519,1253 @@ export interface WbsWorkflowNode {
     }>;
 }
 /**
- * WBS 工作项视图（行业专版）
+ * WBS 视图关联子工作项
+ */
+export interface WbsViewRelatedSubWorkItem {
+    /** 工作项 ID */
+    id?: number;
+    /** 工作项名称 */
+    name?: string;
+    /** 工作项类型 key */
+    work_item_type_key?: string;
+    /** 空间 key */
+    project_key?: string;
+    /** 字段聚合值 */
+    field_values?: FieldValuePair[];
+    /** 融合交付物 */
+    union_deliverable?: Array<Record<string, unknown>>;
+    /** 模板 key */
+    template_key?: string;
+    /** 模板版本 */
+    template_version?: number;
+}
+/**
+ * WBS 视图响应（行业专版）
  * 接口: GET /open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view
  */
-export interface WbsWorkItem {
+export interface WbsViewResponse {
     /** 工作项 ID */
-    id: number;
+    id?: number;
     /** 工作项名称 */
-    name: string;
+    name?: string;
     /** 工作项类型 key */
-    work_item_type_key: string;
+    work_item_type_key?: string;
     /** 空间 key */
-    project_key: string;
+    project_key?: string;
+    /** 模板 key */
+    template_key?: string;
+    /** 模板版本 */
+    template_version?: number;
+    /** 模板名称 */
+    template_name?: string;
+    /** 模板 ID */
+    template_id?: string;
     /** WBS 工作流节点列表 */
     workflow_nodes?: WbsWorkflowNode[];
+    /** 节点连接信息 */
+    connections?: WbsExpandConnection[];
+    /** 父工作项信息 */
+    related_parent_work_item?: WbsRelatedParentWorkItem;
+    /** 子工作项信息 */
+    related_sub_work_items?: WbsViewRelatedSubWorkItem[];
     /** WBS 链路层级信息 */
-    wbs_relation_chain_path?: string[];
+    relation_chain_path?: WbsRelationChainPathInfo;
     /** WBS 链路实例信息 */
-    wbs_relation_chain_entity?: Array<{
-        work_item_id: number;
-        work_item_type_key: string;
-        project_key: string;
-    }>;
+    relation_chain_entity?: WbsRelationChainEntityInfo;
+    /** 兼容接口直接返回的链路层级字段 */
+    wbs_relation_chain_path?: WbsRelationChainPathItem[];
+    /** 兼容接口直接返回的链路实例字段 */
+    wbs_relation_chain_entity?: WbsRelationChainEntityItem[];
 }
 /**
- * 工时关联对象类型
+ * 查询 WBS 草稿请求
  */
-export type WorkHourResourceType = 'node' | 'sub_task';
+export interface QueryWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /**
+     * 是否在未命中时初始化草稿
+     * 查询接口本身承担“读不到时可转创建”的能力，因此单独保留这个开关。
+     */
+    need_init?: boolean;
+}
 /**
- * 创建工时记录条目
+ * 创建 WBS 草稿请求
  */
-export interface CreateWorkingHourRecord {
-    /** 关联对象类型 */
-    resource_type: WorkHourResourceType;
-    /** 关联对象 ID */
-    resource_id: string;
-    /** 实际工时（单位：天） */
-    work_time: number | string;
-    /** 工作描述 */
-    work_description?: string;
+export interface CreateWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
 }
 /**
- * 创建工时登记记录请求
+ * 创建 WBS 草稿返回值
  */
-export interface CreateWorkHourRecordRequest {
-    /** 工作开始日期（毫秒时间戳） */
-    work_begin_date: number;
-    /** 工作结束日期（毫秒时间戳） */
-    work_end_date: number;
-    /** 是否包含节假日 */
-    include_holidays: boolean;
-    /** 待创建工时记录列表 */
-    working_hour_records: CreateWorkingHourRecord[];
+export interface CreateWbsDraftResponse {
+    draft_meta: {
+        draft_id: string;
+        /**
+         * 创建进度
+         * 0-未知状态；1-创建中；2-创建完成
+         */
+        draft_status: 0 | 1 | 2 | number;
+    };
 }
 /**
- * 更新工时记录条目
+ * 重置 WBS 草稿请求
  */
-export interface UpdateWorkingHourRecord {
-    /** 工时记录 ID */
-    id: number;
-    /** 实际工时 */
-    work_time?: number | string;
-    /** 工作描述 */
-    work_description?: string;
+export interface ResetWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
 }
 /**
- * 更新工时登记记录请求
+ * 发布 WBS 草稿请求
  */
-export interface UpdateWorkHourRecordRequest {
-    /** 待更新记录列表 */
-    working_hour_records: UpdateWorkingHourRecord[];
+export interface PublishWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
 }
 /**
- * 删除工时登记记录请求
+ * 完成创建草稿审核请求
+ *
+ * 平台把这条链路独立成单独接口，因此这里单独建模，
+ * 避免后续把 commit 相关字段继续塞进通用发布接口里。
  */
-export interface DeleteWorkHourRecordRequest {
-    /** 工时记录 ID 列表 */
-    working_hour_record_ids: number[];
+export interface CompleteCreateAuditDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
+    /** 提交版本 ID */
+    commit_id: string;
 }
 /**
- * 查询工时登记记录请求
+ * 更新草稿冻结行请求
  */
-export interface ListWorkHourRecordsRequest {
+export interface UpdateWbsDraftFrozenRowsRequest {
     /** 空间 ID */
     project_key: string;
-    /** 工作项类型 key */
-    work_item_type_key: string;
     /** 工作项 ID */
     work_item_id: number;
-    /** 页码 */
-    page_num?: number;
-    /** 分页大小 */
-    page_size?: number;
+    /** 草稿 ID */
+    draft_id: string;
+    /** 冻结行更新类型 */
+    update_type: number;
+    /** 提交版本 ID */
+    commit_id: string;
 }
 /**
- * 工时登记记录
+ * 基于提交版本发布 WBS 草稿请求
  */
-export interface WorkHourRecord {
-    /** 工时记录 ID */
-    id: number;
-    /** 工作日期（毫秒时间戳） */
-    work_date?: number;
-    /** 实际工时 */
-    work_time?: number;
-    /** 创建时间 */
-    created_at?: number;
-    /** 更新时间 */
-    updated_at?: number;
-    /** 关联对象 ID */
-    resource_id?: string;
-    /** 关联对象名称 */
-    resource_name?: string;
-    /** 关联对象类型 */
-    resource_type?: WorkHourResourceType;
-    /** 工时归属人 user_key */
-    work_user_key?: string;
-    /** 工作描述 */
-    work_description?: string;
-    /** 关联工作项 ID */
-    related_work_item_id?: number;
-    /** 关联工作项名称 */
-    related_work_item_name?: string;
-    /** 关联工作项类型 */
-    related_work_item_type_key?: string;
+export interface PublishWbsDraftByCommitRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
+    /** 提交版本 ID */
+    commit_id: string;
 }
 /**
- * 评审结论标签
+ * 审批拒绝后切回草稿请求
  */
-export interface ReviewConclusionOptionItem {
-    /** 标签 key */
-    key: string;
-    /** 标签名称 */
-    label: string;
-    /** 原始标签名称 */
-    origin_label?: string;
+export interface SwitchBackWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
+    /** 提交版本 ID */
+    commit_id: string;
 }
 /**
- * 评审意见（个人）
+ * 查询 WBS 草稿子工作项配置请求
  */
-export interface ReviewOwnerOpinionInfo {
-    /** 用户 user_key */
-    owner: string;
-    /** 评审意见 */
-    finished_opinion_result: string;
+export interface GetWbsDraftSubWorkItemConfRequest {
+    /** 草稿 ID */
+    draft_id: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 节点 UUID */
+    node_uuid: string;
+    /** 空间 ID */
+    project_key: string;
 }
 /**
- * 评审意见（汇总）
+ * WBS 草稿中的顺序引用
  */
-export interface ReviewOpinionInfo {
-    /** 汇总意见 */
-    finished_opinion_result?: string;
-    /** 人员意见 */
-    owners_finished_opinion_result?: ReviewOwnerOpinionInfo[];
+export interface WbsDraftOrderInfo {
+    value_type?: string;
+    vaule?: string;
+    path?: string;
 }
 /**
- * 评审结论（个人）
+ * WBS 草稿中的前后序信息
  */
-export interface ReviewOwnerConclusionInfo {
-    /** 用户 user_key */
-    owner: string;
-    /** 结论 */
-    finished_conclusion_result: ReviewConclusionOptionItem;
+export interface WbsDraftSeqOrderInfo {
+    pre?: WbsDraftOrderInfo[];
+    post?: WbsDraftOrderInfo[];
+    parent?: WbsDraftOrderInfo;
 }
 /**
- * 评审结论（汇总）
+ * WBS 草稿依赖信息
  */
-export interface ReviewConclusionInfo {
-    /** 汇总结论 */
-    finished_conclusion_result?: ReviewConclusionOptionItem;
-    /** 人员结论 */
+export interface WbsDraftDependencyInfo {
+    work_item_id?: number;
+    state_key?: string;
+    name?: string;
+    type?: string;
+}
+/**
+ * WBS 草稿相对排期引用
+ */
+export interface WbsDraftScheduleReferenceValue {
+    work_item_id?: number;
+    state_key?: string;
+    name?: string;
+    type?: string;
+}
+/**
+ * WBS 草稿负责人配置
+ */
+export interface WbsDraftOwnerConf {
+    owner_usage_mode?: string;
+    owner_roles?: string[];
+    user_keys?: string[];
+}
+/**
+ * WBS 节点角色负责人
+ */
+export interface WbsDraftNodeRoleOwners {
+    path?: string;
+    work_item_id?: number;
+    name?: string;
+    role_owners?: RoleOwner[];
+    work_item_type_key?: string;
+}
+/**
+ * WBS 草稿字段交付物
+ */
+export interface WbsDraftFieldDeliverableItem {
+    field_info?: FieldValuePair;
+    placeholder?: string;
+    remark?: string;
+    status?: number;
+}
+/**
+ * WBS 草稿实例交付物
+ */
+export interface WbsDraftInstanceDeliverableItem {
+    name?: string;
+    work_item_id?: number;
+    deletable?: boolean;
+    must_complete?: boolean;
+    state_key?: string;
+    state_name?: string;
+    owners?: string[];
+    remark?: string;
+}
+/**
+ * WBS 草稿融合交付物
+ */
+export interface WbsDraftUnionDeliverable {
+    field_deliverables?: WbsDraftFieldDeliverableItem[];
+    instance_deliverables?: WbsDraftInstanceDeliverableItem[];
+}
+/**
+ * WBS 草稿节点/子项
+ */
+export interface WbsDraftWorkItem {
+    node_uuid?: string;
+    work_item_id?: number;
+    type?: string;
+    wbs_status?: string;
+    wbs_status_map?: Record<string, string>;
+    sub_work_item?: WbsDraftWorkItem[];
+    name?: string;
+    deliverable?: FieldValuePair[];
+    schedule?: Schedule;
+    schedules?: Schedule[];
+    points?: number;
+    role_owners?: RoleOwner[];
+    work_item_type_key?: string;
+    milestone?: boolean;
+    connections?: Connection[];
+    state_key?: string;
+    start_time?: number;
+    finish_time?: number;
+    owner_conf?: WbsDraftOwnerConf;
+    is_draft_create?: boolean;
+    need_actual_work_time?: boolean;
+    node_wbs_role_owners?: WbsDraftNodeRoleOwners[];
+    task_type?: number;
+    uuid_in_conf?: string;
+    union_deliverable?: WbsDraftUnionDeliverable;
+    seq_order_info?: WbsDraftSeqOrderInfo;
+    dismantle_mode?: number;
+    status?: number;
+    dependencies?: WbsDraftDependencyInfo[];
+    relative_schedule_v2?: WbsDraftScheduleReferenceValue[];
+    is_schedule_agg_item?: boolean;
+    field_values?: FieldValuePair[];
+}
+/**
+ * WBS 草稿
+ */
+export interface WbsDraft {
+    template_uuid?: string;
+    template_version?: number;
+    work_item_type_key?: string;
+    related_sub_work_items?: WbsDraftWorkItem[];
+    connections?: Connection[];
+    draft_id?: string;
+    delete_uuids?: string[];
+    role_owners?: Record<string, RoleOwner[]>;
+    user_details?: UserDetail[];
+    work_item_id?: number;
+}
+/**
+ * WBS 草稿子工作项关系配置
+ */
+export interface WbsDraftSubWorkItemConfRelation {
+    relation_key?: string;
+    relation_name?: string;
+    relation_conf_uuid?: string;
+}
+/**
+ * WBS 草稿子工作项配置
+ */
+export interface WbsDraftSubWorkItemConf {
+    work_item_type_key?: string;
+    work_item_type_name?: string;
+    relations?: WbsDraftSubWorkItemConfRelation[];
+    enable_model_resource_lib?: boolean;
+}
+/**
+ * WBS 草稿 patch 请求
+ */
+export interface PatchWbsDraftRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 草稿 ID */
+    draft_id: string;
+    /** 单个操作描述 */
+    operation: WbsDraftOperation;
+}
+/**
+ * 差异化负责人类型
+ */
+export type WbsDraftAssigneeType = 0 | 1 | 2 | 3;
+/**
+ * 计划表 value 包装
+ */
+export interface WbsDraftValueRef<T> {
+    value: T;
+}
+/**
+ * 计划表日期范围
+ */
+export interface WbsDraftScheduleDateRange {
+    estimate_finish?: WbsDraftValueRef<number>;
+    estimate_start?: WbsDraftValueRef<number>;
+}
+/**
+ * 计划表差异化排期
+ */
+export interface WbsDraftAssigneeSchedule {
+    assignee?: string[];
+    assignee_type: WbsDraftAssigneeType;
+    schedule_date?: WbsDraftScheduleDateRange;
+    schedule_point?: WbsDraftValueRef<number>;
+}
+/**
+ * 计划表差异化实际工时
+ */
+export interface WbsDraftAssigneeActualTime {
+    assignee?: string[];
+    assignee_type: WbsDraftAssigneeType;
+    value: number;
+}
+/**
+ * 计划表整体排期
+ */
+export interface WbsDraftWholeSchedule {
+    schedule_date?: WbsDraftScheduleDateRange;
+    schedule_point?: WbsDraftValueRef<number>;
+}
+/**
+ * 计划表整体实际工时
+ */
+export interface WbsDraftActualTime {
+    value: number;
+}
+/**
+ * WBS 草稿角色负责人更新值
+ */
+export interface WbsDraftRoleOwnersValue {
+    role_key?: string;
+    owners: string[];
+    work_item_id?: number;
+}
+/**
+ * WBS 草稿字段交付物更新值
+ */
+export interface WbsDraftFieldDeliverableValue {
+    field_key: string;
+}
+/**
+ * WBS 草稿实例交付物更新值
+ */
+export interface WbsDraftInstanceDeliverableValue {
+    resourceID: number;
+}
+/**
+ * WBS 草稿 patch 操作
+ *
+ * 开放文档当前以“单 key 联合体”的方式展示操作值，这里保持同形态，
+ * 这样用户可以直接把文档示例粘过来使用。
+ */
+export type WbsDraftPatchOperationValue = {
+    add_task_row: {
+        parent_uuid: string;
+        pre_uuid?: string;
+        name?: string;
+        element_key?: string;
+    };
+} | {
+    add_node_row: {
+        parent_uuid: string;
+        parent_group_uuid?: string;
+        pre_uuid?: string;
+        name?: string;
+        element_key?: string;
+    };
+} | {
+    add_sub_instance_row: {
+        parent_uuid: string;
+        work_item_type_key: string;
+        pre_uuid?: string;
+        /**
+         * 文档示例展示为字符串化 JSON。
+         * 这里同时接受结构化数组，方便调用方直接复用已有字段值对象。
+         */
+        field_values?: FieldValuePair[] | string;
+    };
+} | {
+    add_resource_sub_instance_row: {
+        parent_uuid: string;
+        work_item_type_key: string;
+        pre_uuid?: string;
+        resource_work_item_ids: number[];
+    };
+} | {
+    delete_row: {
+        uuid: string;
+        reason?: string;
+        delete_action_type?: 'delete' | 'move_out' | string;
+    };
+} | {
+    restore_row: {
+        uuid: string;
+    };
+} | {
+    update_dismantle_mode: {
+        uuid: string;
+        dismantle_mode: 0 | 1 | number;
+    };
+} | {
+    adjust_row_order: {
+        uuid: string;
+        parent_uuid?: string;
+        pre_uuid?: string;
+    };
+} | {
+    update_node_sequence: {
+        uuid: string;
+        pre_list?: string[];
+        next_list?: string[];
+    };
+} | {
+    update_node_phase: {
+        uuid: string;
+        phase: string;
+    };
+} | {
+    update_name: {
+        uuid: string;
+        name: string;
+    };
+} | {
+    update_role_owner: {
+        uuid: string;
+        role_owners: WbsDraftRoleOwnersValue;
+    };
+} | {
+    update_delivery: {
+        uuid: string;
+        field_deliverables?: WbsDraftFieldDeliverableValue[];
+        instance_deliverables?: WbsDraftInstanceDeliverableValue[];
+    };
+} | {
+    update_planned_schedule: {
+        uuid: string;
+        assignee_schedules?: WbsDraftAssigneeSchedule[];
+        schedule?: WbsDraftWholeSchedule;
+        different_schedule: boolean;
+    };
+} | {
+    update_schedule_actual_time: {
+        uuid: string;
+        assignee_actual_times?: WbsDraftAssigneeActualTime[];
+        actual_time?: WbsDraftActualTime;
+        different_schedule: boolean;
+    };
+};
+/**
+ * WBS 草稿单次操作
+ */
+export interface WbsDraftOperation {
+    operation_type: 'AddTaskRow' | 'AddNodeRow' | 'AddSubInstanceRow' | 'AddResourceSubInstanceRow' | 'DeleteRow' | 'RestoreRow' | 'UpdateDismantleMode' | 'AdjustRowOrder' | 'UpdateNodeSequence' | 'UpdateNodePhase' | 'UpdateName' | 'UpdateRoleOwner' | 'UpdateDelivery' | 'UpdatePlannedSchedule' | 'UpdateSchedulePoint' | 'UpdateScheduleActualTime' | string;
+    operation_value: WbsDraftPatchOperationValue;
+}
+/**
+ * WBS 草稿 patch 返回值
+ */
+export interface PatchWbsDraftResponse {
+    /** 更新计划表操作标识 */
+    transaction_id: string;
+    /** 状态 saving/success/failed */
+    status: 'saving' | 'success' | 'failed' | string;
+    /** 报错信息 */
+    msg?: string;
+}
+/**
+ * WBS 草稿布尔结果
+ */
+export interface WbsDraftSuccessResponse {
+    success?: boolean;
+}
+/**
+ * 创建草稿进度查询请求
+ */
+export interface CreateWbsDraftProgressRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+}
+/**
+ * 创建草稿进度
+ */
+export interface CreateWbsDraftProgressResponse {
+    /** 创建进度：0-未知状态；1-创建中；2-创建完成 */
+    draft_status: 0 | 1 | 2 | number;
+}
+/**
+ * 更新草稿进度
+ */
+export interface PatchWbsDraftProgressResponse {
+    transaction_id: string;
+    status: 'saving' | 'success' | 'failed' | string;
+    create_time: number;
+    max_saving_ttl: number;
+}
+/**
+ * 更新草稿进度查询请求
+ */
+export interface PatchWbsDraftProgressRequest {
+    project_key: string;
+    transaction_id: string;
+}
+/**
+ * 发布草稿进度
+ */
+export interface PublishWbsDraftProgressResponse {
+    publish_order_id: string;
+    /** 0-发布中；1-成功；2-失败 */
+    publish_status: 0 | 1 | 2 | number;
+}
+/**
+ * 发布草稿进度查询请求
+ */
+export interface PublishWbsDraftProgressRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+    publish_order_id: string;
+}
+/**
+ * 重置草稿进度
+ */
+export interface ResetWbsDraftProgressResponse {
+    /** 0-未知状态; 2-重置完成; 3-重置中; 4-部分重置中 */
+    draft_status: 0 | 2 | 3 | 4 | number;
+}
+/**
+ * 重置草稿进度查询请求
+ */
+export interface ResetWbsDraftProgressRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+}
+/**
+ * 计划表当前行
+ */
+export interface WbsDraftCurrentRow {
+    uuid: string;
+    type: 'Creator' | 'General' | 'CardGroup' | 'GridGroup' | string;
+    [key: string]: unknown;
+}
+/**
+ * 计划表草稿骨架
+ */
+export interface WbsDraftStructure {
+    current_row: WbsDraftCurrentRow;
+    children?: WbsDraftStructure[];
+    [key: string]: unknown;
+}
+/**
+ * 草稿骨架查询请求
+ */
+export interface QueryWbsDraftStructureRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+}
+/**
+ * 草稿骨架查询响应
+ */
+export interface QueryWbsDraftStructureResponse {
+    wbs_draft_structure: WbsDraftStructure;
+}
+/**
+ * 草稿行详情查询请求
+ */
+export interface QueryWbsDraftRowDetailRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+    uuids: string[];
+    row_field_marks: WbsRowFieldMark[];
+}
+/**
+ * 文档把字段掩码写成枚举列表，直接收紧可以把拼写错误提前拦在编译期。
+ */
+export type WbsRowFieldMark = 'meta.*' | 'meta.uuid' | 'meta.type' | 'meta.conf_uuid' | 'meta.parent_uuid' | 'meta.belong_work_item_info' | 'meta.editable_conf' | 'base.*' | 'base.name' | 'base.start_time' | 'base.finish_time' | 'base.owners' | 'base.schedule' | 'base.schedule_dependency' | 'base.dependencies' | 'base.union_deliveries' | 'base.process_status' | 'node_extra.*' | 'node_extra.is_milestone' | 'node_extra.phase' | 'node_extra.predecessor' | 'node_extra.state_key' | 'sub_instance_extra.*' | 'sub_instance_extra.dismantle_mode';
+/**
+ * 草稿/发布态明细共用同一套行类型，统一成字面量后更容易跟文档持续对齐。
+ */
+export type WbsRowDetailType = 'node' | 'sub_instance' | 'sub_task' | string;
+/**
+ * 负责人分配模式
+ */
+export type WbsOwnerAssignType = 'AssignUnknown' | 'AssignLimited' | 'AssignRoleBind' | 'AssignFree' | string;
+/**
+ * 负责人候选范围
+ */
+export type WbsOwnerCandidateScopeType = 'CandidateScopeUnknown' | 'CandidateScopeNone' | 'CandidateScopeFromRole' | 'CandidateScopeFromParentOwner' | string;
+/**
+ * 排期依赖类型
+ */
+export type WbsScheduleDependencyType = 'FF' | 'FS' | 'SF' | 'SS' | string;
+/**
+ * 启动完成依赖类型
+ */
+export type WbsDependencyType = 'FF' | 'FS' | string;
+/**
+ * 启动完成依赖源类型
+ */
+export type WbsDependencySourceType = 'WbsTask' | 'node' | 'task' | 'sub_instance' | 'sub_task' | string;
+/**
+ * 目前文档仅给出了 ongoing，先把已知值显式化，同时保留平台后续扩展空间。
+ */
+export type WbsProcessStatus = 'ongoing' | string;
+/**
+ * 子工作项拆解模式
+ */
+export type WbsSubInstanceDismantleMode = 'item' | 'flow' | string;
+/**
+ * WBS 链路节点类型
+ */
+export type WbsRelationChainItemType = 'rootWorkItem' | 'subWorkItem' | 'node' | 'subTask' | string;
+/**
+ * 草稿行元信息
+ */
+export interface WbsTemplateInfo {
+    template_version?: number;
+    templateUUID?: string;
+}
+/**
+ * 草稿行所属工作项信息
+ */
+export interface WbsBelongWorkItemInfo {
+    work_item_id?: number;
+    work_item_type_key?: string;
+    template_info?: WbsTemplateInfo;
+}
+/**
+ * 草稿行可编辑配置
+ */
+export interface WbsFieldEditableState {
+    uneditable?: boolean;
+}
+/**
+ * 草稿行字段可编辑配置
+ */
+export interface WbsFieldsEditableConf {
+    actual_work_effort_editable?: WbsFieldEditableState;
+    [key: string]: WbsFieldEditableState | undefined;
+}
+/**
+ * 草稿行编辑配置
+ */
+export interface WbsEditableConf {
+    fields_editable_conf?: WbsFieldsEditableConf;
+}
+/**
+ * 计划表工期/工时单位
+ */
+export type WbsTimeUnit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | number;
+/**
+ * 带单位的数值
+ */
+export interface WbsValueWithUnit {
+    value: number;
+    unit: WbsTimeUnit;
+}
+/**
+ * 负责人范围中的角色成员
+ */
+export interface WbsOwnerRoleMemberInfo {
+    work_item_id?: number;
+    role_key?: string;
+    members?: string[];
+    role_name?: string;
+    is_member_multi?: boolean;
+}
+/**
+ * 行负责人信息
+ */
+export interface WbsOwnersInfo {
+    owner_assign_type?: WbsOwnerAssignType;
+    candidate_scope_type?: WbsOwnerCandidateScopeType;
+    owners?: string[];
+    owners_with_role?: WbsOwnerRoleMemberInfo[];
+}
+/**
+ * 计划排期
+ */
+export interface WbsPlannedSchedule {
+    estimate_start_time?: number;
+    estimate_finish_time?: number;
+}
+/**
+ * 估分信息
+ */
+export interface WbsEstimatedEffort {
+    estimated_effort_value?: WbsValueWithUnit;
+}
+/**
+ * 实际工时信息
+ */
+export interface WbsActualWorkEffort {
+    actual_work_effort_value?: WbsValueWithUnit;
+}
+/**
+ * 计划工期信息
+ */
+export interface WbsPlannedDuration {
+    planned_duration_value?: WbsValueWithUnit;
+}
+/**
+ * 差异化负责人排期
+ */
+export interface WbsAssigneeScheduleDetail {
+    user_key?: string;
+    planned_schedule?: WbsPlannedSchedule;
+    estimated_effort?: WbsEstimatedEffort;
+    actual_work_effort?: WbsActualWorkEffort;
+    planned_duration?: WbsPlannedDuration;
+}
+/**
+ * 单行排期汇总配置
+ */
+export interface WbsScheduleRuleConf {
+    need_aggregate?: boolean;
+}
+/**
+ * 行排期信息
+ */
+export interface WbsScheduleInfo {
+    schedule_rule_conf?: WbsScheduleRuleConf;
+    planned_schedule?: WbsPlannedSchedule;
+    estimated_effort?: WbsEstimatedEffort;
+    assignee_schedule?: WbsAssigneeScheduleDetail[];
+    planned_duration?: WbsPlannedDuration;
+    actual_work_effort?: WbsActualWorkEffort;
+}
+/**
+ * 排期依赖里的延迟
+ */
+export interface WbsDayOffset {
+    value?: number;
+}
+/**
+ * 排期依赖
+ */
+export interface WbsScheduleDependencyItem {
+    day_offset?: WbsDayOffset;
+    type?: WbsScheduleDependencyType;
+    from_uuid?: string;
+    to_uuid?: string;
+    from_name?: string;
+}
+/**
+ * 排期依赖集合
+ */
+export interface WbsScheduleDependencyInfo {
+    schedule_dependencies?: WbsScheduleDependencyItem[];
+}
+/**
+ * 启动完成依赖
+ */
+export interface WbsDependencyItem {
+    type?: WbsDependencyType;
+    from_type?: WbsDependencySourceType;
+    from_uuid?: string;
+    from_uuid_belonged_wid?: number;
+    from_name?: string;
+}
+/**
+ * 字段交付物引用
+ */
+export interface WbsFieldDeliveryRef {
+    project_key?: string;
+    work_item_type_key?: string;
+    field_key?: string;
+}
+/**
+ * 实例交付物引用
+ */
+export interface WbsInstanceDeliveryRef {
+    project_key?: string;
+    work_item_type_key?: string;
+    resource_id?: number;
+}
+/**
+ * 融合交付物
+ */
+export interface WbsUnionDeliveryItem {
+    type?: 'field' | 'instance' | string;
+    field_delivery?: WbsFieldDeliveryRef;
+    instance_delivery?: WbsInstanceDeliveryRef;
+}
+export interface WbsDraftRowDetailMeta {
+    uuid?: string;
+    type?: WbsRowDetailType;
+    conf_uuid?: string;
+    parent_uuid?: string;
+    belong_work_item_info?: WbsBelongWorkItemInfo;
+    editable_conf?: WbsEditableConf;
+    [key: string]: unknown;
+}
+/**
+ * 草稿行基本信息
+ */
+export interface WbsDraftRowDetailBase {
+    name?: string;
+    start_time?: number;
+    finish_time?: number;
+    owners?: WbsOwnersInfo;
+    schedule?: WbsScheduleInfo;
+    schedule_dependency?: WbsScheduleDependencyInfo;
+    dependencies?: WbsDependencyItem[];
+    union_deliveries?: WbsUnionDeliveryItem[];
+    process_status?: WbsProcessStatus;
+    [key: string]: unknown;
+}
+/**
+ * 草稿行详情
+ */
+export interface WbsSubInstanceExtra {
+    dismantle_mode?: WbsSubInstanceDismantleMode;
+}
+/**
+ * 节点阶段信息
+ */
+export interface WbsPhaseInfo {
+    phase_key?: string;
+    phase_name?: string;
+}
+/**
+ * 节点额外信息
+ */
+export interface WbsNodeExtra {
+    is_milestone?: boolean;
+    phase?: WbsPhaseInfo;
+    predecessor?: string[];
+    state_key?: string;
+}
+export interface WbsDraftRowDetail {
+    meta?: WbsDraftRowDetailMeta;
+    base?: WbsDraftRowDetailBase;
+    sub_instance_extra?: WbsSubInstanceExtra;
+    node_extra?: WbsNodeExtra;
+    [key: string]: unknown;
+}
+/**
+ * 草稿行详情查询响应
+ */
+export interface QueryWbsDraftRowDetailResponse {
+    draft_row_details: WbsDraftRowDetail[];
+}
+/**
+ * 草稿行配置查询请求
+ */
+export interface QueryWbsDraftRowConfigRequest {
+    project_key: string;
+    work_item_id: number;
+    draft_id: string;
+    uuid: string;
+}
+/**
+ * 草稿行配置里的工作项类型信息
+ */
+export interface WbsDraftTaskConfWorkItemTypeInfo {
+    work_item_type_key: string;
+    name: string;
+}
+/**
+ * 草稿行配置
+ */
+export interface WbsDraftTaskConf {
+    sub_work_instance_create_info?: {
+        work_item_type_infos?: WbsDraftTaskConfWorkItemTypeInfo[];
+    };
+}
+/**
+ * 草稿行配置查询响应
+ */
+export interface QueryWbsDraftRowConfigResponse {
+    sub_work_instance_create_info?: {
+        work_item_type_infos?: WbsDraftTaskConfWorkItemTypeInfo[];
+    };
+}
+/**
+ * 发布态计划表骨架查询请求
+ */
+export interface QueryWbsViewStructureRequest {
+    project_key: string;
+    work_item_id: number;
+}
+/**
+ * 发布态计划表骨架查询响应
+ */
+export interface QueryWbsViewStructureResponse {
+    wbs_structure: WbsDraftStructure;
+}
+/**
+ * 发布态计划表行详情查询请求
+ */
+export interface QueryWbsViewRowDetailRequest {
+    project_key: string;
+    work_item_id: number;
+    uuids: string[];
+    row_field_marks: WbsRowFieldMark[];
+}
+/**
+ * 发布态计划表行详情查询响应
+ */
+export interface QueryWbsViewRowDetailResponse {
+    view_row_details: WbsDraftRowDetail[];
+}
+/**
+ * 发布态计划表扩展查询参数
+ */
+export interface QueryWbsInstanceExpand {
+    need_wbs_relation_chain_entity?: boolean;
+    need_wbs_relation_chain_path?: boolean;
+    need_parent_work_item?: boolean;
+}
+/**
+ * 发布态计划表扩展信息查询请求
+ */
+export interface QueryWbsInstanceExpandInfoRequest {
+    project_key: string;
+    work_item_id: number;
+    work_item_type_key: string;
+    expand: QueryWbsInstanceExpand;
+}
+/**
+ * 发布态计划表扩展信息查询响应
+ */
+export interface WbsRelatedParentWorkItem {
+    is_top?: boolean;
+    work_item_id?: number;
+    work_item_type_key?: string;
+    name?: string;
+    template_id?: string;
+    template_key?: string;
+    template_name?: string;
+    template_version?: number;
+    relation_node_id?: string;
+    relation_node_name?: string;
+    relation_node_tags?: string[];
+    relation_node_uuid?: string;
+}
+/**
+ * 扩展信息里的节点间连接字段
+ */
+export interface WbsExpandConnectionField {
+    name?: string;
+    type?: string;
+    value?: string;
+}
+/**
+ * 扩展信息里的节点间连接
+ */
+export interface WbsExpandConnection {
+    source_state_key?: string;
+    target_state_key?: string;
+    transition_id?: number;
+    fields?: WbsExpandConnectionField[];
+}
+/**
+ * WBS 链路层级条目
+ */
+export interface WbsRelationChainPathItem {
+    project_key?: string;
+    level?: number;
+    type?: WbsRelationChainItemType;
+    work_item_type_key?: string;
+    name?: string;
+    node_name?: string;
+}
+/**
+ * WBS 链路层级信息
+ */
+export interface WbsRelationChainPathInfo {
+    wbs_relation_chain_path?: WbsRelationChainPathItem[];
+    work_item_id?: number;
+}
+/**
+ * WBS 链路实例条目
+ */
+export interface WbsRelationChainEntityItem {
+    project_key?: string;
+    work_item_type_key?: string;
+    work_item_id?: number;
+    type?: WbsRelationChainItemType;
+    work_item_name?: string;
+    state_key?: string;
+    node_name?: string;
+    sub_task_id?: number;
+    sub_task_name?: string;
+    level?: number;
+}
+/**
+ * WBS 链路实例信息
+ */
+export interface WbsRelationChainEntityInfo {
+    wbs_relation_chain_entity?: WbsRelationChainEntityItem[];
+    work_item_id?: number;
+}
+export interface QueryWbsInstanceExpandInfoResponse {
+    template_key?: string;
+    template_version?: number;
+    template_name?: string;
+    template_id?: string;
+    related_parent_work_item?: WbsRelatedParentWorkItem;
+    connections?: WbsExpandConnection[];
+    relation_chain_path?: WbsRelationChainPathInfo;
+    relation_chain_entity?: WbsRelationChainEntityInfo;
+}
+/**
+ * 发布 WBS 草稿返回值
+ */
+export interface PublishWbsDraftResponse {
+    publish_order_id: string;
+    recommend_interval_ms: number;
+}
+/**
+ * 重置 WBS 草稿返回值
+ */
+export interface ResetWbsDraftResponse {
+    new_draft_id: string;
+    recommend_interval_ms: number;
+}
+/**
+ * 工时关联对象类型
+ */
+export type WorkHourResourceType = 'node' | 'sub_task';
+/**
+ * 创建工时记录条目
+ */
+export interface CreateWorkingHourRecord {
+    /** 关联对象类型 */
+    resource_type: WorkHourResourceType;
+    /** 关联对象 ID */
+    resource_id: string;
+    /** 实际工时（单位：天） */
+    work_time: number | string;
+    /** 工作描述 */
+    work_description?: string;
+}
+/**
+ * 创建工时登记记录请求
+ */
+export interface CreateWorkHourRecordRequest {
+    /** 工作开始日期（毫秒时间戳） */
+    work_begin_date: number;
+    /** 工作结束日期（毫秒时间戳） */
+    work_end_date: number;
+    /** 是否包含节假日 */
+    include_holidays: boolean;
+    /** 待创建工时记录列表 */
+    working_hour_records: CreateWorkingHourRecord[];
+}
+/**
+ * 更新工时记录条目
+ */
+export interface UpdateWorkingHourRecord {
+    /** 工时记录 ID */
+    id: number;
+    /** 实际工时 */
+    work_time?: number | string;
+    /** 工作描述 */
+    work_description?: string;
+}
+/**
+ * 更新工时登记记录请求
+ */
+export interface UpdateWorkHourRecordRequest {
+    /** 待更新记录列表 */
+    working_hour_records: UpdateWorkingHourRecord[];
+}
+/**
+ * 删除工时登记记录请求
+ */
+export interface DeleteWorkHourRecordRequest {
+    /** 工时记录 ID 列表 */
+    working_hour_record_ids: number[];
+}
+/**
+ * 查询工时登记记录请求
+ */
+export interface ListWorkHourRecordsRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 页码 */
+    page_num?: number;
+    /** 分页大小 */
+    page_size?: number;
+}
+/**
+ * 工时登记记录
+ */
+export interface WorkHourRecord {
+    /** 工时记录 ID */
+    id: number;
+    /** 工作日期（毫秒时间戳） */
+    work_date?: number;
+    /** 实际工时 */
+    work_time?: number;
+    /** 创建时间 */
+    created_at?: number;
+    /** 更新时间 */
+    updated_at?: number;
+    /** 关联对象 ID */
+    resource_id?: string;
+    /** 关联对象名称 */
+    resource_name?: string;
+    /** 关联对象类型 */
+    resource_type?: WorkHourResourceType;
+    /** 工时归属人 user_key */
+    work_user_key?: string;
+    /** 工作描述 */
+    work_description?: string;
+    /** 关联工作项 ID */
+    related_work_item_id?: number;
+    /** 关联工作项名称 */
+    related_work_item_name?: string;
+    /** 关联工作项类型 */
+    related_work_item_type_key?: string;
+}
+/**
+ * 评审结论标签
+ */
+export interface ReviewConclusionOptionItem {
+    /** 标签 key */
+    key: string;
+    /** 标签名称 */
+    label: string;
+    /** 原始标签名称 */
+    origin_label?: string;
+}
+/**
+ * 评审意见（个人）
+ */
+export interface ReviewOwnerOpinionInfo {
+    /** 用户 user_key */
+    owner: string;
+    /** 评审意见 */
+    finished_opinion_result: string;
+}
+/**
+ * 评审意见（汇总）
+ */
+export interface ReviewOpinionInfo {
+    /** 汇总意见 */
+    finished_opinion_result?: string;
+    /** 人员意见 */
+    owners_finished_opinion_result?: ReviewOwnerOpinionInfo[];
+}
+/**
+ * 评审结论（个人）
+ */
+export interface ReviewOwnerConclusionInfo {
+    /** 用户 user_key */
+    owner: string;
+    /** 结论 */
+    finished_conclusion_result?: ReviewConclusionOptionItem;
+    /** 结论，兼容文档结构表中的字段名 */
+    owners_finished_conclusion_result?: ReviewConclusionOptionItem;
+}
+/**
+ * 评审汇总模式
+ */
+export type ReviewSummaryMode = 'calculation' | 'independence';
+/**
+ * 评审结论（汇总）
+ */
+export interface ReviewConclusionInfo {
+    /** 汇总结论 */
+    finished_conclusion_result?: ReviewConclusionOptionItem;
+    /** 人员结论 */
     owners_finished_conclusion_result?: ReviewOwnerConclusionInfo[];
 }
 /**
@@ -1529,7 +2779,7 @@ export interface ReviewFinishedInfoItem {
     /** 评审结论 */
     conclusion?: ReviewConclusionInfo;
     /** 汇总模式 */
-    summary_mode?: string;
+    summary_mode?: ReviewSummaryMode;
 }
 /**
  * 批量查询评审信息请求
@@ -1539,7 +2789,7 @@ export interface ReviewBatchQueryRequest {
     /** 空间 ID（必填） */
     project_key: string;
     /** 工作项 ID（必填） */
-    work_item_id: number;
+    work_item_id: number | string;
     /** 节点 ID 列表（必填，最多 10 个） */
     node_ids: string[];
 }
@@ -1548,7 +2798,7 @@ export interface ReviewBatchQueryRequest {
  */
 export interface ReviewBatchQueryResponse {
     project_key: string;
-    work_item_id: number;
+    work_item_id: number | string;
     finished_infos: ReviewFinishedInfoItem[];
 }
 /**
@@ -1558,7 +2808,7 @@ export interface ReviewConclusionOptionRequest {
     /** 空间 ID */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number;
+    work_item_id: number | string;
     /** 节点 ID 列表 */
     node_ids: string[];
 }
@@ -1575,6 +2825,10 @@ export interface ReviewConclusionOption {
     /** 整体评审结论标签 */
     finished_overall_conclusion_option?: ReviewConclusionOptionItem[];
 }
+/**
+ * 评审更新操作类型
+ */
+export type ReviewOperationType = 'node' | 'owner';
 /**
  * 修改评审意见/结论请求
  */
@@ -1582,7 +2836,7 @@ export interface UpdateReviewRequest {
     /** 空间 ID */
     project_key: string;
     /** 工作项 ID */
-    work_item_id: number;
+    work_item_id: number | string;
     /** 节点 ID */
     node_id: string;
     /** 评审意见 */
@@ -1590,7 +2844,7 @@ export interface UpdateReviewRequest {
     /** 评审结论标签 key */
     finished_conclusion_option_key?: string;
     /** 操作类型 */
-    operation_type?: string;
+    operation_type?: ReviewOperationType;
     /** 是否置空 */
     reset?: boolean;
 }