@aipanel/core 1.2.3 → 1.2.5

package/es/types.d.ts

@@ -72,6 +72,8 @@ export interface LogFileConfig {
  * 选中的元素信息
  */
 export interface SelectedElement {
+    /** 节点唯一 id（`@节点[n<id>]` 引用标记与上下文注入共用；由 ensureNodeId 分配） */
+    id?: string;
     /** 文件路径 */
     filePath: string | null;
     /** 行号 */
@@ -145,6 +147,8 @@ export interface AIPanelWidgetSession {
  * 挂件选中的元素
  */
 export interface AIPanelSelectedElement {
+    /** 节点唯一 id（与 SelectedElement.id 同源，`@节点[n<id>]` 标记与上下文注入共用） */
+    id?: string;
     filePath: string | null;
     line: number | null;
     column: number | null;

package/es/utils.d.ts

@@ -1,6 +1,16 @@
 /**
  * @fileoverview 通用工具函数
  */
+/**
+ * 取（或生成）元素的节点唯一 id：优先复用已赋值的 id，否则生成随机 id 并写回元素。
+ * 同一引用在会话标记（`@节点[n<id>]`）与上下文注入里使用同一个 id；
+ * 不同包（client / dsh-client / context 端点）共用此实现，保证 id 体系一致。
+ * @param element - 携带可选 id 的元素对象（会被写回生成的 id）
+ * @returns 该元素最终使用的节点 id
+ */
+export declare function ensureNodeId(element: {
+    id?: string;
+}): string;
 /**
  * 截断字符串到指定长度
  * @param value - 要截断的字符串

package/es/utils.mjs

@@ -1,3 +1,9 @@
+function ensureNodeId(element) {
+  if (element.id) return element.id;
+  const random = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID().replace(/-/g, "").slice(0, 8) : Math.random().toString(36).slice(2, 10);
+  element.id = `n${random}`;
+  return element.id;
+}
 function truncate(value, maxLength) {
   if (value.length <= maxLength) {
     return value;
@@ -47,6 +53,7 @@ function extractTextFromResponse(data) {
 export {
   base64Decode,
   base64Encode,
+  ensureNodeId,
   extractTextFromResponse,
   sleep,
   truncate

package/lib/types.d.ts

@@ -72,6 +72,8 @@ export interface LogFileConfig {
  * 选中的元素信息
  */
 export interface SelectedElement {
+    /** 节点唯一 id（`@节点[n<id>]` 引用标记与上下文注入共用；由 ensureNodeId 分配） */
+    id?: string;
     /** 文件路径 */
     filePath: string | null;
     /** 行号 */
@@ -145,6 +147,8 @@ export interface AIPanelWidgetSession {
  * 挂件选中的元素
  */
 export interface AIPanelSelectedElement {
+    /** 节点唯一 id（与 SelectedElement.id 同源，`@节点[n<id>]` 标记与上下文注入共用） */
+    id?: string;
     filePath: string | null;
     line: number | null;
     column: number | null;

package/lib/utils.cjs

@@ -19,11 +19,18 @@ var utils_exports = {};
 __export(utils_exports, {
   base64Decode: () => base64Decode,
   base64Encode: () => base64Encode,
+  ensureNodeId: () => ensureNodeId,
   extractTextFromResponse: () => extractTextFromResponse,
   sleep: () => sleep,
   truncate: () => truncate
 });
 module.exports = __toCommonJS(utils_exports);
+function ensureNodeId(element) {
+  if (element.id) return element.id;
+  const random = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID().replace(/-/g, "").slice(0, 8) : Math.random().toString(36).slice(2, 10);
+  element.id = `n${random}`;
+  return element.id;
+}
 function truncate(value, maxLength) {
   if (value.length <= maxLength) {
     return value;
@@ -74,6 +81,7 @@ function extractTextFromResponse(data) {
 0 && (module.exports = {
   base64Decode,
   base64Encode,
+  ensureNodeId,
   extractTextFromResponse,
   sleep,
   truncate

package/lib/utils.d.ts

@@ -1,6 +1,16 @@
 /**
  * @fileoverview 通用工具函数
  */
+/**
+ * 取（或生成）元素的节点唯一 id：优先复用已赋值的 id，否则生成随机 id 并写回元素。
+ * 同一引用在会话标记（`@节点[n<id>]`）与上下文注入里使用同一个 id；
+ * 不同包（client / dsh-client / context 端点）共用此实现，保证 id 体系一致。
+ * @param element - 携带可选 id 的元素对象（会被写回生成的 id）
+ * @returns 该元素最终使用的节点 id
+ */
+export declare function ensureNodeId(element: {
+    id?: string;
+}): string;
 /**
  * 截断字符串到指定长度
  * @param value - 要截断的字符串

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",