@josephyan/qingflow-cli 0.2.0-beta.67 → 0.2.0-beta.68

package/src/qingflow_mcp/cli/commands/record.py

@@ -77,6 +77,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     code_block.add_argument("--answers-file")
     code_block.add_argument("--fields-file")
     code_block.add_argument("--manual", action=argparse.BooleanOptionalAction, default=True)
+    code_block.add_argument("--apply-writeback", action=argparse.BooleanOptionalAction, default=True)
     code_block.add_argument("--verify-writeback", action=argparse.BooleanOptionalAction, default=True)
     code_block.add_argument("--force-refresh-form", action="store_true")
     code_block.set_defaults(handler=_handle_code_block_run, format_hint="")
@@ -197,6 +198,7 @@ def _handle_code_block_run(args: argparse.Namespace, context: CliContext) -> dic
         answers=load_list_arg(args.answers_file, option_name="--answers-file"),
         fields=load_object_arg(args.fields_file, option_name="--fields-file") or {},
         manual=bool(args.manual),
+        apply_writeback=bool(args.apply_writeback),
         verify_writeback=bool(args.verify_writeback),
         force_refresh_form=bool(args.force_refresh_form),
     )

package/src/qingflow_mcp/server.py

@@ -132,8 +132,9 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
 - Always resolve the exact code-block field from `record_code_block_schema_get` first.
 - Treat code-block execution as write-capable, not read-only.
 - If the code block is bound to relation outputs, Qingflow may calculate target answers and write them back automatically.
+- For safe debugging, pass `apply_writeback=false` and inspect the parsed alias results plus `relation.calculated_answers_preview` before allowing any writeback.
 - In workflow context, pass `role=3` and the exact `workflow_node_id`.
-- After execution, inspect `outputs.alias_results`, `relation.target_fields`, and `writeback.verification` before claiming success.
+- After execution, inspect `outputs.configured_aliases`, `outputs.alias_results`, `outputs.alias_map`, `relation.target_fields`, and `writeback.verification` before claiming success.
 
 ## Import Path
 

package/src/qingflow_mcp/server_app_user.py

@@ -121,8 +121,9 @@ Use `record_code_block_run` when the user wants to execute a form code-block fie
 - Always resolve the exact code-block field from `record_code_block_schema_get` first.
 - Treat code-block execution as write-capable, not read-only.
 - If the code block is bound to relation outputs, Qingflow may calculate target answers and write them back automatically.
+- For safe debugging, pass `apply_writeback=false` and inspect the parsed alias results plus `relation.calculated_answers_preview` before allowing any writeback.
 - In workflow context, pass `role=3` and the exact `workflow_node_id`.
-- After execution, inspect `outputs.alias_results`, `relation.target_fields`, and `writeback.verification` before claiming success.
+- After execution, inspect `outputs.configured_aliases`, `outputs.alias_results`, `outputs.alias_map`, `relation.target_fields`, and `writeback.verification` before claiming success.
 
 ## Import Path
 

package/src/qingflow_mcp/solution/compiler/form_compiler.py

@@ -23,6 +23,8 @@ QUESTION_TYPE_MAP = {
     FieldType.address: 21,
     FieldType.attachment: 13,
     FieldType.boolean: 10,
+    FieldType.q_linker: 20,
+    FieldType.code_block: 26,
     FieldType.relation: 25,
     FieldType.subtable: 18,
 }
@@ -243,6 +245,33 @@ def build_question(field: dict[str, Any], temp_id: int) -> tuple[dict[str, Any],
                 "queDefaultType": 2,
             }
         )
+    if field_type == FieldType.code_block:
+        question.update(
+            {
+                "minOpts": -1,
+                "maxOpts": -1,
+                "codeBlockConfig": {
+                    "configMode": int(config.get("config_mode") or 1),
+                    "codeContent": str(config.get("code_content") or ""),
+                    "resultAliasPath": deepcopy(config.get("result_alias_path") or []),
+                    "beingHideOnForm": bool(config.get("being_hide_on_form", False)),
+                },
+                "autoTrigger": bool(config.get("auto_trigger", False)),
+                "customBtnTextStatus": bool(config.get("custom_button_text_enabled", False)),
+                "customBtnText": str(config.get("custom_button_text") or ""),
+            }
+        )
+    if field_type == FieldType.q_linker:
+        question.update(
+            {
+                "minOpts": -1,
+                "maxOpts": -1,
+                "remoteLookupConfig": deepcopy(config.get("remote_lookup_config") or config),
+                "autoTrigger": bool(config.get("auto_trigger", False)),
+                "customBtnTextStatus": bool(config.get("custom_button_text_enabled", False)),
+                "customBtnText": str(config.get("custom_button_text") or ""),
+            }
+        )
     if field_type == FieldType.subtable:
         sub_questions: list[dict[str, Any]] = []
         for subfield in field.get("subfields", []):

package/src/qingflow_mcp/solution/spec_models.py

@@ -33,6 +33,8 @@ class FieldType(str, Enum):
     address = "address"
     attachment = "attachment"
     boolean = "boolean"
+    q_linker = "q_linker"
+    code_block = "code_block"
     relation = "relation"
     subtable = "subtable"
 

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -819,15 +819,21 @@ class AiBuilderTools(ToolBase):
                         "profile": profile,
                         "app_key": app_key,
                         "mode": "merge",
-                        "sections": [{"title": "基础信息", "rows": [["字段A", "字段B"]]}],
+                        "sections": [{
+                            "type": "paragraph",
+                            "paragraph_id": "basic",
+                            "title": "基础信息",
+                            "rows": [["字段A", "字段B", "字段C", "字段D"]],
+                        }],
                     },
                 },
             )
+        normalized_request = request.model_dump(mode="json", exclude_none=True)
         return _safe_tool_call(
             lambda: self._facade.app_layout_plan(profile=profile, request=request),
             error_code="LAYOUT_PLAN_FAILED",
-            normalized_args=request.model_dump(mode="json"),
-            suggested_next_call={"tool_name": "app_layout_plan", "arguments": {"profile": profile, **request.model_dump(mode="json")}},
+            normalized_args=normalized_request,
+            suggested_next_call={"tool_name": "app_layout_plan", "arguments": {"profile": profile, **normalized_request}},
         )
 
     def app_flow_plan(
@@ -1124,7 +1130,7 @@ class AiBuilderTools(ToolBase):
             "app_key": str(plan_args.get("app_key") or app_key),
             "mode": parsed_mode.value,
             "publish": publish,
-            "sections": [section.model_dump(mode="json") for section in parsed_sections],
+            "sections": [section.model_dump(mode="json", exclude_none=True) for section in parsed_sections],
         }
         return _safe_tool_call(
             lambda: self._facade.app_layout_apply(
@@ -1912,6 +1918,13 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "field.allow_multiple": "field.relation_mode",
             "field.optional_data_num": "field.relation_mode",
             "field.optionalDataNum": "field.relation_mode",
+            "field.remoteLookupConfig": "field.remote_lookup_config",
+            "field.qLinkerBinding": "field.q_linker_binding",
+            "field.codeBlockConfig": "field.code_block_config",
+            "field.codeBlockBinding": "field.code_block_binding",
+            "field.autoTrigger": "field.auto_trigger",
+            "field.customBtnTextStatus": "field.custom_button_text_enabled",
+            "field.customBtnText": "field.custom_button_text",
         },
         "allowed_values": {
             "field.type": [member.value for member in PublicFieldType],
@@ -1962,6 +1975,13 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "field.allow_multiple": "field.relation_mode",
             "field.optional_data_num": "field.relation_mode",
             "field.optionalDataNum": "field.relation_mode",
+            "field.remoteLookupConfig": "field.remote_lookup_config",
+            "field.qLinkerBinding": "field.q_linker_binding",
+            "field.codeBlockConfig": "field.code_block_config",
+            "field.codeBlockBinding": "field.code_block_binding",
+            "field.autoTrigger": "field.auto_trigger",
+            "field.customBtnTextStatus": "field.custom_button_text_enabled",
+            "field.customBtnText": "field.custom_button_text",
         },
         "allowed_values": {
             "field.type": [member.value for member in PublicFieldType],
@@ -1972,6 +1992,10 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "multiple relation fields are backend-risky; read verification.relation_field_limit_verified and warnings before declaring the schema stable",
             "backend 49614 is normalized to MULTIPLE_RELATION_FIELDS_UNSUPPORTED with a workaround message",
             "relation_mode=multiple maps to referenceConfig.optionalDataNum=0",
+            "if relation target metadata lookup is blocked by 40161/40002/40027, explicit display_field.name and visible_fields[].name let builder degrade verification and still continue schema write",
+            "q_linker_binding lets you declare request config, dynamic inputs, alias parsing, and target-field bindings in one step; builder writes remoteLookupConfig plus the existing backend relation-default and questionRelations structures",
+            "code_block_binding lets you declare inputs, code, alias parsing, and target-field bindings in one step; builder writes codeBlockConfig plus the existing backend relation-default and questionRelations structures",
+            "builder configures code blocks only; it does not execute or trigger code blocks",
         ],
         "minimal_example": {
             "profile": "default",
@@ -2002,34 +2026,99 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "update_fields": [],
             "remove_fields": [],
         },
+        "code_block_example": {
+            "profile": "default",
+            "app_key": "APP_SCRIPT",
+            "publish": True,
+            "add_fields": [
+                {
+                    "name": "查询代码块",
+                    "type": "code_block",
+                    "code_block_binding": {
+                        "inputs": [
+                            {"field": {"name": "客户名称"}, "var": "customerName"},
+                            {"field": {"name": "预算金额"}, "var": "budget"},
+                        ],
+                        "code": "const qf_output = {}; qf_output.customerLevel = budget > 100000 ? 'A' : 'B'; return qf_output;",
+                        "auto_trigger": True,
+                        "custom_button_text_enabled": True,
+                        "custom_button_text": "评估客户",
+                        "outputs": [
+                            {"alias": "customerLevel", "path": "$.customerLevel"},
+                        ],
+                    },
+                }
+            ],
+            "update_fields": [],
+            "remove_fields": [],
+        },
+        "q_linker_example": {
+            "profile": "default",
+            "app_key": "APP_CUSTOMER",
+            "publish": True,
+            "add_fields": [
+                {"name": "客户名称", "type": "text"},
+                {"name": "企业名称", "type": "text"},
+                {"name": "统一社会信用代码", "type": "text"},
+                {
+                    "name": "企业信息查询",
+                    "type": "q_linker",
+                    "q_linker_binding": {
+                        "inputs": [
+                            {"field": {"name": "客户名称"}, "key": "keyword", "source": "query_param"},
+                        ],
+                        "request": {
+                            "url": "https://example.com/company/search",
+                            "method": "GET",
+                            "headers": [],
+                            "query_params": [],
+                            "body_type": 1,
+                            "url_encoded_value": [],
+                            "result_type": 1,
+                            "auto_trigger": True,
+                            "custom_button_text_enabled": True,
+                            "custom_button_text": "查询企业信息",
+                        },
+                        "outputs": [
+                            {"alias": "company_name", "path": "$.data.name", "target_field": {"name": "企业名称"}},
+                            {"alias": "credit_code", "path": "$.data.creditCode", "target_field": {"name": "统一社会信用代码"}},
+                        ],
+                    },
+                },
+            ],
+            "update_fields": [],
+            "remove_fields": [],
+        },
     },
     "app_layout_plan": {
         "allowed_keys": ["app_key", "mode", "sections", "preset"],
         "aliases": {"overwrite": "replace", "sectionId": "section_id"},
-        "section_allowed_keys": ["section_id", "title", "rows"],
+        "section_allowed_keys": ["type", "paragraph_id", "section_id", "title", "rows"],
         "section_aliases": {
             "name": "title",
+            "paragraphId": "paragraph_id",
             "sectionId": "section_id",
             "fields": "rows",
             "field_ids": "rows",
             "columns": "rows_chunk_size",
         },
         "allowed_values": {"mode": [member.value for member in LayoutApplyMode], "preset": [member.value for member in LayoutPreset]},
-        "minimal_section_example": {"title": "基础信息", "rows": [["字段A", "字段B"]]},
+        "minimal_section_example": {"type": "paragraph", "paragraph_id": "basic", "title": "基础信息", "rows": [["字段A", "字段B", "字段C", "字段D"]]},
         "minimal_example": {
             "profile": "default",
             "app_key": "APP_KEY",
             "mode": "merge",
-            "sections": [{"title": "基础信息", "rows": [["字段A", "字段B"]]}],
+            "sections": [{"type": "paragraph", "paragraph_id": "basic", "title": "基础信息", "rows": [["字段A", "字段B", "字段C", "字段D"]]}],
         },
         "preset_example": {"profile": "default", "app_key": "APP_KEY", "mode": "merge", "preset": "balanced", "sections": []},
     },
     "app_layout_apply": {
         "allowed_keys": ["app_key", "mode", "publish", "sections"],
         "aliases": {"overwrite": "replace", "sectionId": "section_id"},
-        "section_allowed_keys": ["section_id", "title", "rows"],
+        "section_allowed_keys": ["type", "paragraph_id", "section_id", "title", "rows"],
         "section_aliases": {
             "name": "title",
+            "paragraphId": "paragraph_id",
             "sectionId": "section_id",
             "fields": "rows",
             "field_ids": "rows",
@@ -2040,13 +2129,13 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "layout verification is split into layout_verified and layout_summary_verified",
             "LAYOUT_SUMMARY_UNVERIFIED means raw form readback is stronger than the compact summary",
         ],
-        "minimal_section_example": {"title": "基础信息", "rows": [["字段A", "字段B"]]},
+        "minimal_section_example": {"type": "paragraph", "paragraph_id": "basic", "title": "基础信息", "rows": [["字段A", "字段B", "字段C", "字段D"]]},
         "minimal_example": {
             "profile": "default",
             "app_key": "APP_KEY",
             "mode": "merge",
             "publish": True,
-            "sections": [{"title": "基础信息", "rows": [["项目名称", "项目负责人"]]}],
+            "sections": [{"type": "paragraph", "paragraph_id": "basic", "title": "基础信息", "rows": [["项目名称", "项目负责人", "项目阶段", "优先级"]]}],
         },
     },
     "app_flow_plan": {

package/src/qingflow_mcp/tools/approval_tools.py

@@ -277,6 +277,7 @@ class ApprovalTools(ToolBase):
                 fields=fields,
                 public_action="task_transfer",
             )
+        self._raise_if_self_transfer(profile=profile, payload=payload)
         raw = self.record_transfer(profile=profile, app_key=app_key, apply_id=record_id, payload=payload)
         return self._public_action_response(
             raw,
@@ -326,7 +327,9 @@ class ApprovalTools(ToolBase):
             audit_node_id=workflow_node_id,
             keyword=keyword,
         )
-        items = _approval_page_items(raw.get("page"))
+        original_items = _approval_page_items(raw.get("page"))
+        items = self._filter_self_transfer_candidates(profile=profile, items=original_items)
+        filtered_count = max(len(original_items) - len(items), 0)
         return self._public_page_response(
             raw,
             items=items,
@@ -335,7 +338,7 @@ class ApprovalTools(ToolBase):
                 "page_size": page_size,
                 "returned_items": len(items),
                 "page_amount": _approval_page_amount(raw.get("page")),
-                "reported_total": _approval_page_total(raw.get("page")),
+                "reported_total": max(_approval_page_total(raw.get("page")) - filtered_count, 0),
             },
             selection={"app_key": app_key, "record_id": record_id, "workflow_node_id": workflow_node_id, "keyword": keyword},
         )
@@ -849,6 +852,32 @@ class ApprovalTools(ToolBase):
         if payload.get("handSignImageUrl"):
             raise_tool_error(QingflowApiError.not_supported("NOT_SUPPORTED_IN_V1: handSignImageUrl is not supported"))
 
+    def _extract_transfer_target_uid(self, payload: dict[str, Any]) -> int | None:
+        for key in ("uid", "target_member_id", "targetMemberId"):
+            value = payload.get(key)
+            if isinstance(value, int) and value > 0:
+                return value
+        return None
+
+    def _raise_if_self_transfer(self, *, profile: str, payload: dict[str, Any]) -> None:
+        target_uid = self._extract_transfer_target_uid(payload)
+        if target_uid is None:
+            return
+        session_profile = self.sessions.get_profile(profile)
+        if session_profile is not None and target_uid == session_profile.uid:
+            raise_tool_error(
+                QingflowApiError.config_error(
+                    "task transfer does not support transferring to the current user; choose another transfer member"
+                )
+            )
+
+    def _filter_self_transfer_candidates(self, *, profile: str, items: list[dict[str, Any]]) -> list[dict[str, Any]]:
+        session_profile = self.sessions.get_profile(profile)
+        if session_profile is None:
+            return items
+        current_uid = session_profile.uid
+        return [item for item in items if item.get("uid") != current_uid]
+
     def _delegate_task_action(
         self,
         *,

package/src/qingflow_mcp/tools/code_block_tools.py

@@ -33,6 +33,27 @@ SUPPORTED_CODE_BLOCK_ROLES = {1, 2, 3, 5}
 
 
 class CodeBlockTools(RecordTools):
+    def _get_code_block_relation_schema(
+        self,
+        profile: str,
+        context,  # type: ignore[no-untyped-def]
+        app_key: str,
+        *,
+        force_refresh: bool,
+    ) -> JSONObject:
+        cache_key = (profile, app_key, "code_block_relation_form", 1)
+        if not force_refresh and cache_key in self._form_cache:
+            return self._form_cache[cache_key]
+        schema = self.backend.request(
+            "GET",
+            context,
+            f"/app/{app_key}/form",
+            params={"type": 1},
+        )
+        normalized = schema if isinstance(schema, dict) else {}
+        self._form_cache[cache_key] = normalized
+        return normalized
+
     def register(self, mcp: FastMCP) -> None:
         super().register(mcp)
 
@@ -49,9 +70,10 @@ class CodeBlockTools(RecordTools):
 
         @mcp.tool(
             description=(
-                "Run a form code-block field against the current record data, then reuse Qingflow's existing "
-                "relation-calculation chain to compute bound outputs and write them back automatically. "
-                "Use record_code_block_schema_get first and choose an exact code-block field selector."
+                "Run a form code-block field against the current record data, parse alias results, and optionally "
+                "reuse Qingflow's existing relation-calculation chain to compute bound outputs and write them back. "
+                "Use record_code_block_schema_get first and choose an exact code-block field selector. "
+                "For safe debugging, pass apply_writeback=false to inspect parsed results without writing back."
             )
         )
         def record_code_block_run(
@@ -64,6 +86,7 @@ class CodeBlockTools(RecordTools):
             answers: list[JSONObject] | None = None,
             fields: JSONObject | None = None,
             manual: bool = True,
+            apply_writeback: bool = True,
             verify_writeback: bool = True,
             force_refresh_form: bool = False,
             output_profile: str = "normal",
@@ -78,6 +101,7 @@ class CodeBlockTools(RecordTools):
                 answers=answers or [],
                 fields=fields or {},
                 manual=manual,
+                apply_writeback=apply_writeback,
                 verify_writeback=verify_writeback,
                 force_refresh_form=force_refresh_form,
                 output_profile=output_profile,
@@ -95,7 +119,7 @@ class CodeBlockTools(RecordTools):
         normalized_output_profile = self._normalize_public_output_profile(output_profile)
 
         def runner(session_profile, context):
-            schema = self._get_form_schema(profile, context, app_key, force_refresh=False)
+            relation_schema = self._get_code_block_relation_schema(profile, context, app_key, force_refresh=False)
             index = self._get_applicant_top_level_field_index(profile, context, app_key, force_refresh=False)
             input_fields = [
                 self._ready_schema_field_payload(
@@ -113,7 +137,7 @@ class CodeBlockTools(RecordTools):
                 if field.que_type != CODE_BLOCK_QUE_TYPE:
                     continue
                 targets = _collect_code_block_relation_targets(
-                    _collect_question_relations(schema),
+                    _collect_question_relations(relation_schema),
                     code_block_que_id=field.que_id,
                 )
                 bound_output_fields = [
@@ -127,6 +151,7 @@ class CodeBlockTools(RecordTools):
                         "title": field.que_title,
                         "selector": field.que_title,
                         "bound_output_fields": bound_output_fields,
+                        "configured_aliases": _extract_code_block_configured_aliases(field),
                     }
                 )
             response: JSONObject = {
@@ -164,6 +189,7 @@ class CodeBlockTools(RecordTools):
         answers: list[JSONObject] | None = None,
         fields: JSONObject | None = None,
         manual: bool = True,
+        apply_writeback: bool = True,
         verify_writeback: bool = True,
         force_refresh_form: bool = False,
         output_profile: str = "normal",
@@ -178,7 +204,12 @@ class CodeBlockTools(RecordTools):
             raise_tool_error(QingflowApiError.config_error("code_block_field is required"))
 
         def runner(session_profile, context):
-            schema = self._get_form_schema(profile, context, app_key, force_refresh=force_refresh_form)
+            relation_schema = self._get_code_block_relation_schema(
+                profile,
+                context,
+                app_key,
+                force_refresh=force_refresh_form,
+            )
             index = self._get_field_index(profile, context, app_key, force_refresh=force_refresh_form)
             code_block = self._resolve_field_selector(code_block_field, index, location="code_block_field")
             if code_block.que_type != CODE_BLOCK_QUE_TYPE:
@@ -233,8 +264,9 @@ class CodeBlockTools(RecordTools):
                 json_body=run_body,
             )
             alias_results = _normalize_code_block_alias_results(run_result)
+            configured_aliases = _extract_code_block_configured_aliases(code_block)
             relation_target_fields = _collect_code_block_relation_targets(
-                _collect_question_relations(schema),
+                _collect_question_relations(relation_schema),
                 code_block_que_id=code_block.que_id,
             )
             relation_errors: list[JSONObject] = []
@@ -277,7 +309,12 @@ class CodeBlockTools(RecordTools):
             writeback_applied = False
             status = "completed"
             ok = True
-            if relation_target_fields and calculated_answers:
+            if relation_errors:
+                status = "relation_failed"
+                ok = False
+            elif not apply_writeback:
+                status = "debug_completed"
+            elif relation_target_fields and calculated_answers:
                 write_body: JSONObject = {"role": role, "answers": calculated_answers}
                 if workflow_node_id is not None:
                     write_body["auditNodeId"] = workflow_node_id
@@ -305,9 +342,6 @@ class CodeBlockTools(RecordTools):
                     if not bool(verification.get("verified")):
                         status = "verification_failed"
                         ok = False
-            elif relation_errors:
-                status = "relation_failed"
-                ok = False
             else:
                 status = "no_writeback"
             response: JSONObject = {
@@ -325,9 +359,11 @@ class CodeBlockTools(RecordTools):
                     "role": role,
                     "workflow_node_id": workflow_node_id,
                     "manual": bool(manual),
+                    "apply_writeback": bool(apply_writeback),
                     "result_count": len(alias_results),
                 },
                 "outputs": {
+                    "configured_aliases": configured_aliases,
                     "alias_results": alias_results,
                     "alias_map": _build_alias_result_map(alias_results),
                 },
@@ -335,11 +371,14 @@ class CodeBlockTools(RecordTools):
                     "target_fields": relation_target_fields,
                     "result_item_count": len(relation_items),
                     "calculated_answer_count": len(calculated_answers),
+                    "calculated_answers_preview": calculated_answers,
                     "errors": relation_errors,
                 },
                 "writeback": {
+                    "enabled": bool(apply_writeback),
                     "attempted": writeback_attempted,
                     "applied": writeback_applied,
+                    "skipped_reason": "apply_writeback_disabled" if not apply_writeback else None,
                     "verify_writeback": verify_writeback,
                     "write_verified": bool(verification.get("verified")) if verification is not None else None,
                     "result": write_result,
@@ -606,6 +645,38 @@ def _normalize_code_block_alias_results(payload: JSONValue) -> list[JSONObject]:
     return results
 
 
+def _extract_code_block_configured_aliases(field: FormField) -> list[JSONObject]:
+    raw_config = field.raw.get("codeBlockConfig")
+    if not isinstance(raw_config, dict):
+        return []
+    raw_aliases = raw_config.get("resultAliasPath")
+    if not isinstance(raw_aliases, list):
+        return []
+    return [item for item in (_normalize_code_block_alias_item(alias) for alias in raw_aliases) if item is not None]
+
+
+def _normalize_code_block_alias_item(value: JSONValue) -> JSONObject | None:
+    if not isinstance(value, dict):
+        return None
+    alias_name = _normalize_optional_text(value.get("aliasName", value.get("alias_name")))
+    alias_path = _normalize_optional_text(value.get("aliasPath", value.get("alias_path")))
+    if alias_name is None and alias_path is None:
+        return None
+    raw_sub_alias = value.get("subAlias", value.get("sub_alias"))
+    sub_alias = (
+        [item for item in (_normalize_code_block_alias_item(entry) for entry in raw_sub_alias) if item is not None]
+        if isinstance(raw_sub_alias, list)
+        else []
+    )
+    return {
+        "alias_id": _coerce_count(value.get("aliasId", value.get("alias_id"))),
+        "alias_name": alias_name,
+        "alias_path": alias_path,
+        "alias_type": _coerce_count(value.get("aliasType", value.get("alias_type"))) or 1,
+        "sub_alias": sub_alias,
+    }
+
+
 def _build_alias_result_map(alias_results: list[JSONObject]) -> JSONObject:
     alias_map: JSONObject = {}
     for item in alias_results:
@@ -625,7 +696,11 @@ def _collect_code_block_relation_targets(question_relations: list[JSONObject], *
     for relation in question_relations:
         if _coerce_count(relation.get("relationType")) != CODE_BLOCK_RELATION_TYPE:
             continue
-        if _coerce_count(relation.get("qlinkerQueId")) != code_block_que_id:
+        alias_config = relation.get("aliasConfig") if isinstance(relation.get("aliasConfig"), dict) else {}
+        relation_code_block_que_id = _coerce_count(relation.get("qlinkerQueId"))
+        if relation_code_block_que_id is None:
+            relation_code_block_que_id = _coerce_count(alias_config.get("queId"))
+        if relation_code_block_que_id != code_block_que_id:
             continue
         target_id = _coerce_count(
             relation.get("queId", relation.get("targetQueId", relation.get("displayedQueId")))
@@ -636,8 +711,10 @@ def _collect_code_block_relation_targets(question_relations: list[JSONObject], *
         targets.append(
             {
                 "que_id": target_id,
-                "alias_id": _coerce_count(relation.get("aliasId")),
-                "qlinker_que_id": _coerce_count(relation.get("qlinkerQueId")),
+                "alias_id": _coerce_count(relation.get("aliasId")) or _coerce_count(alias_config.get("aliasId")),
+                "alias_name": _normalize_optional_text(relation.get("qlinkerAlias"))
+                or _normalize_optional_text(alias_config.get("qlinkerAlias")),
+                "qlinker_que_id": relation_code_block_que_id,
             }
         )
     return targets