diff --git a/src/contracts.ts b/src/contracts.ts
index 1c86755..260bb98 100644
--- a/src/contracts.ts
+++ b/src/contracts.ts
@@ -185,6 +185,9 @@ export type UINodeType =
 
 export interface UINode {
   type: UINodeType;
+  /** Surface 层节点级标注（core ui.go U2）：整页唯一稳定 id 与事实来源标识，旧路径不填。 */
+  id?: string;
+  source?: string[];
   title?: string;
   items?: string[];
   kv?: [string, string][];