Merge branch 'master' of http://192.168.0.200/knowledge-base-bj/deerflow-server into dhk-1

frontend-web/src/core/auth/task-deeplink.ts

@@ -111,13 +111,29 @@ export function readCopTaskDetail(): CopTaskDetail | null {
   }
 }
 
+/** 行动详情接口 ``{action_detail_url}/{actionId}`` 返回的 ``data`` 字段（xdfx 行动分析用）。 */
+export interface ActionDetail {
+  /** 行动id（深链 ?taskId= 传入的就是它）。 */
+  id: string;
+  /** 该行动归属的真正「任务id」。 */
+  taskId: string;
+  /** 所属目的id。 */
+  purposeId: string;
+  /** 行动名称。 */
+  actionName: string;
+  /** 行动状态码。 */
+  actionStatus: number | string;
+  /** 行动叙事 / 描述。 */
+  narration: string;
+}
+
 /**
- * xdfx 深链：用「行动id」调行动详情接口 ``{action_detail_url}/{actionId}``，取出 ``data.taskId``
- * 作为真正的「任务id」。``action_test=true`` 时直接用后端配置里的假数据（接口未通时用）。
- * 缺地址 / 返回不合法 → 返回 ""（调用方据此回退）。
+ * xdfx 深链：用「行动id」调行动详情接口 ``{action_detail_url}/{actionId}``，取出整包行动详情。
+ * ``action_test=true`` 时直接用后端配置里的假数据（接口未通时用）。
+ * 缺地址 / 返回不合法 → 返回 null。
  */
-export async function fetchTaskIdFromAction(actionId: string): Promise<string> {
-  if (!actionId) return "";
+export async function fetchActionDetail(actionId: string): Promise<ActionDetail | null> {
+  if (!actionId) return null;
   const cfg = await fetchTaskDeeplinkConfig();
   let body: unknown;
   if (cfg.actionTest) {
@@ -127,12 +143,28 @@ export async function fetchTaskIdFromAction(actionId: string): Promise<string> {
     // service 拦截器已统一注入 Authorization: Bearer admin 并返回整包 body；行动id 走路径段。
     body = await requestCrudService.get(`${base}/${encodeURIComponent(actionId)}`);
   } else {
-    return "";
+    return null;
   }
   const data = body && typeof body === "object" ? (body as { data?: unknown }).data : null;
-  if (!data || typeof data !== "object") return "";
-  const taskId = (data as Record<string, unknown>).taskId;
-  return taskId != null && taskId !== "" ? String(taskId) : "";
+  if (!data || typeof data !== "object") return null;
+  const d = data as Record<string, unknown>;
+  return {
+    id: d.id != null ? String(d.id) : "",
+    taskId: d.taskId != null ? String(d.taskId) : "",
+    purposeId: d.purposeId != null ? String(d.purposeId) : "",
+    actionName: typeof d.actionName === "string" ? d.actionName : "",
+    actionStatus:
+      typeof d.actionStatus === "number" || typeof d.actionStatus === "string" ? d.actionStatus : "",
+    narration: typeof d.narration === "string" ? d.narration : "",
+  };
+}
+
+/**
+ * xdfx 深链：用「行动id」解析出真正的「任务id」（取行动详情的 ``data.taskId``）。
+ * 缺地址 / 返回不合法 → 返回 ""（调用方据此回退）。
+ */
+export async function fetchTaskIdFromAction(actionId: string): Promise<string> {
+  return (await fetchActionDetail(actionId))?.taskId ?? "";
 }
 
 /**