one-design-next 0.0.77 → 0.0.80

package/dist/_genui-inline-ref.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 内联引用 chip 的品类 icon。
+ *
+ * chip 视觉锚点按「类型」而非条目：skill 一律跟 Composer 技能按钮同源，
+ * 不使用 SkillItem.icon（那只服务技能菜单辨识）。
+ */
+export declare const SKILL_CATEGORY_ICON = "wand-sparkles";
+/** skill / 未标明的 invocation 通道 → 技能品类 icon；其它 kind 回退 data.icon */
+export declare function resolveInvocationCategoryIcon(kind?: string, fallback?: string): string | undefined;
+/** mention 按 kind 给品类 icon；未知 kind 回退 data.icon */
+export declare function resolveMentionCategoryIcon(kind?: string, fallback?: string): string | undefined;

package/dist/_genui-inline-ref.js

@@ -0,0 +1,22 @@
+/**
+ * 内联引用 chip 的品类 icon。
+ *
+ * chip 视觉锚点按「类型」而非条目：skill 一律跟 Composer 技能按钮同源，
+ * 不使用 SkillItem.icon（那只服务技能菜单辨识）。
+ */
+export var SKILL_CATEGORY_ICON = 'wand-sparkles';
+
+/** skill / 未标明的 invocation 通道 → 技能品类 icon；其它 kind 回退 data.icon */
+export function resolveInvocationCategoryIcon(kind, fallback) {
+  if (!kind || kind === 'skill' || kind === 'invocation') {
+    return SKILL_CATEGORY_ICON;
+  }
+  return fallback;
+}
+
+/** mention 按 kind 给品类 icon；未知 kind 回退 data.icon */
+export function resolveMentionCategoryIcon(kind, fallback) {
+  if (kind === 'file') return 'file-text';
+  if (kind === 'user' || kind === 'mention') return 'user';
+  return fallback;
+}

package/dist/artifact/actions.d.ts

@@ -1,4 +1,5 @@
 import type { IconName } from '../icon';
+import type { ArtifactFileIconType } from './icons';
 /** 点击产物时的预期行为类型。 */
 export type ArtifactActionKind = 'preview' | 'download';
 export interface ArtifactAction {
@@ -10,3 +11,9 @@ export interface ArtifactAction {
 }
 /** 根据 actionKind 返回对应的 ArtifactAction（label + icon）。 */
 export declare function getArtifactActionFromKind(kind: ArtifactActionKind): ArtifactAction;
+/**
+ * 按文件类型给出点击预期（业务方可据此决定 `actionKind`）：
+ * - html / md / csv / file → 预览（arrow-right）
+ * - pdf / xlsx / docx / pptx → 下载（arrow-down-to-line）
+ */
+export declare function getArtifactAction(fileType: ArtifactFileIconType): ArtifactAction;

package/dist/artifact/actions.js

@@ -3,17 +3,40 @@
 /** 根据 actionKind 返回对应的 ArtifactAction（label + icon）。 */
 export function getArtifactActionFromKind(kind) {
   switch (kind) {
-    case 'preview':
-      return {
-        kind: 'preview',
-        label: '预览详情',
-        icon: 'arrow-right'
-      };
     case 'download':
       return {
         kind: 'download',
         label: '下载导出',
         icon: 'arrow-down-to-line'
       };
+    case 'preview':
+    default:
+      return {
+        kind: 'preview',
+        label: '预览详情',
+        icon: 'arrow-right'
+      };
+  }
+}
+
+/**
+ * 按文件类型给出点击预期（业务方可据此决定 `actionKind`）：
+ * - html / md / csv / file → 预览（arrow-right）
+ * - pdf / xlsx / docx / pptx → 下载（arrow-down-to-line）
+ */
+export function getArtifactAction(fileType) {
+  switch (fileType) {
+    case 'html':
+    case 'md':
+    case 'csv':
+    case 'file':
+      return getArtifactActionFromKind('preview');
+    case 'pdf':
+    case 'xlsx':
+    case 'docx':
+    case 'pptx':
+      return getArtifactActionFromKind('download');
+    default:
+      return getArtifactActionFromKind('preview');
   }
 }

package/dist/artifact/index.d.ts

@@ -2,7 +2,7 @@ import { type CSSProperties } from 'react';
 import { type ArtifactActionKind } from './actions';
 import { type ArtifactFileIconType } from './icons';
 import './style';
-export { getArtifactActionFromKind, type ArtifactAction, type ArtifactActionKind, } from './actions';
+export { getArtifactAction, getArtifactActionFromKind, type ArtifactAction, type ArtifactActionKind, } from './actions';
 export { ARTIFACT_FILE_GLOW_COLORS, getArtifactGlowColor } from './glow';
 export { ARTIFACT_DEDICATED_FILE_ICON_TYPES, ARTIFACT_FILE_ICON_MEDIUM_SIZE, ARTIFACT_FILE_ICON_MEDIUM_VIEWBOX, ARTIFACT_FILE_ICON_SMALL_SIZE, ARTIFACT_FILE_ICON_SMALL_VIEWBOX, ARTIFACT_FILE_ICON_TYPES, ArtifactFileIcon, artifactFileIcons, artifactFileIconsMedium, artifactFileIconsSmall, getArtifactFileIconUrl, } from './icons';
 export type { ArtifactFileIconProps, ArtifactFileIconSize, ArtifactFileIconType, } from './icons';
@@ -40,7 +40,7 @@ export interface ArtifactProps {
 /**
  * 对话流内的产物：
  * - medium / Card：左 Icon + 右标题 / 大小·日期；可点 hover 时 Icon 后退缩小、文案左移遮罩，右侧浮出操作预期
- * - small / Small：无底色/描边；hover 用 HoverFill 叠灰底（不展示预览/下载操作预期）
+ * - small / Small：无底色/描边；hover 用 HoverFill（Navi 默认色）；不可预览类型额外浮出下载 Icon
  */
 export declare function Artifact({ title, actionKind, fileType, fileSize, date, size, status, onOpen, className, style, }: ArtifactProps): import("react").JSX.Element;
 export declare namespace Artifact {

package/dist/artifact/index.js

@@ -10,7 +10,7 @@ import { getArtifactActionFromKind } from "./actions";
 import { getArtifactGlowColor } from "./glow";
 import { ARTIFACT_DEDICATED_FILE_ICON_TYPES, ArtifactFileIcon } from "./icons";
 import "./style";
-export { getArtifactActionFromKind } from "./actions";
+export { getArtifactAction, getArtifactActionFromKind } from "./actions";
 export { ARTIFACT_FILE_GLOW_COLORS, getArtifactGlowColor } from "./glow";
 export { ARTIFACT_DEDICATED_FILE_ICON_TYPES, ARTIFACT_FILE_ICON_MEDIUM_SIZE, ARTIFACT_FILE_ICON_MEDIUM_VIEWBOX, ARTIFACT_FILE_ICON_SMALL_SIZE, ARTIFACT_FILE_ICON_SMALL_VIEWBOX, ARTIFACT_FILE_ICON_TYPES, ArtifactFileIcon, artifactFileIcons, artifactFileIconsMedium, artifactFileIconsSmall, getArtifactFileIconUrl } from "./icons";
 
@@ -73,7 +73,7 @@ function ArtifactActionCue(_ref) {
 /**
  * 对话流内的产物：
  * - medium / Card：左 Icon + 右标题 / 大小·日期；可点 hover 时 Icon 后退缩小、文案左移遮罩，右侧浮出操作预期
- * - small / Small：无底色/描边；hover 用 HoverFill 叠灰底（不展示预览/下载操作预期）
+ * - small / Small：无底色/描边；hover 用 HoverFill（Navi 默认色）；不可预览类型额外浮出下载 Icon
  */
 export function Artifact(_ref2) {
   var title = _ref2.title,
@@ -115,8 +115,8 @@ export function Artifact(_ref2) {
   // Small 形态只展示 Icon + 标题；Card（medium）保留大小 / 日期（或 Generating 文案）
   var showMeta = size !== 'small';
   var metaParts = !showMeta ? [] : isGenerating ? ['生成中'] : [fileSize, date].filter(Boolean);
-  // 操作预期仅 Card 可点时展示；Small 不展示
-  var showAction = size !== 'small' && isInteractive;
+  // Card：预览 / 下载均可点时展示操作预期；Small：仅不可预览（下载）类型 hover 出下载 Icon
+  var showAction = isInteractive && (size !== 'small' || action.kind === 'download');
   var handleClick = function handleClick() {
     onOpen === null || onOpen === void 0 || onOpen();
   };
@@ -191,13 +191,11 @@ export function Artifact(_ref2) {
     onClick: handleClick
   }), content) : /*#__PURE__*/React.createElement("div", sharedProps, content);
 
-  // Small：默认透明；可点时用 HoverFill 叠灰底（对齐 Attachments chip / ChatItem）
+  // Small：默认透明；可点时用 HoverFill（颜色对齐 Navi / HoverFill 默认值）
   if (size === 'small') {
     return /*#__PURE__*/React.createElement(HoverFill, {
       "data-odn-artifact-small-wrap": true,
       bgClassName: "odn-artifact-small-bg",
-      hoverColor: "var(--odn-color-black-4)",
-      activeColor: "var(--odn-color-black-5)",
       disabled: !isInteractive,
       className: className,
       style: style

package/dist/artifact/style/index.css

@@ -12,7 +12,8 @@ html {
   --odn-artifact-icon-height: 36px;
   --odn-artifact-min-height: 68px;
   --odn-artifact-title-size: var(--odn-font-size-text-md);
-  --odn-artifact-title-leading: var(--odn-font-leading-text-md);
+  /* 文件名行高用全局 default（非 text-md 固定 22px） */
+  --odn-artifact-title-leading: var(--odn-line-height);
   --odn-artifact-meta-size: var(--odn-font-size-text-mn);
   --odn-artifact-meta-leading: var(--odn-font-leading-text-mn);
   /* Card hover：对齐即梦 banner 卡（0.3s / ease-out） */
@@ -65,7 +66,8 @@ html {
   --odn-artifact-icon-height: 16px;
   --odn-artifact-min-height: 0;
   --odn-artifact-title-size: var(--odn-font-size-text-sm);
-  --odn-artifact-title-leading: var(--odn-font-leading-text-sm);
+  /* 行高用全局 default（非 text-sm 固定 22px） */
+  --odn-artifact-title-leading: var(--odn-line-height);
   border: none;
   background: transparent;
   box-shadow: none;
@@ -117,7 +119,8 @@ button[data-odn-artifact] {
   margin: 0;
   font-size: var(--odn-artifact-title-size);
   line-height: var(--odn-artifact-title-leading);
-  font-weight: 500;
+  /* Card / Small 默认 Regular；Small 选中态由使用方（如 PreviewPanel 列表）加粗 */
+  font-weight: 400;
   color: var(--odn-color-black-12);
   white-space: nowrap;
 }
@@ -241,7 +244,7 @@ button[data-odn-artifact] {
   transform: translateX(calc(-1 * var(--odn-artifact-hover-shift)));
 }
 
-/* Card：操作预期仅 Icon；右侧间距 20 */
+/* 操作预期仅 Icon；Card 右侧间距 20，Small 对齐自身 padding-x 12 */
 [data-odn-artifact-action] {
   position: absolute;
   right: 20px;
@@ -260,12 +263,21 @@ button[data-odn-artifact] {
   transition: opacity var(--odn-artifact-hover-duration) var(--odn-artifact-hover-ease), transform var(--odn-artifact-hover-duration) var(--odn-artifact-hover-ease);
 }
 
+[data-odn-artifact][data-odn-artifact-size=small] > [data-odn-artifact-action] {
+  right: 12px;
+}
+
 [data-odn-artifact][data-odn-artifact-clickable]:hover > [data-odn-artifact-action],
 [data-odn-artifact][data-odn-artifact-clickable]:focus-visible > [data-odn-artifact-action] {
   opacity: 1;
   transform: translate(0, -50%);
 }
 
+/* Small 下载态：标题给右侧 Icon 让出空间，避免叠字 */
+[data-odn-artifact][data-odn-artifact-size=small][data-odn-artifact-action-kind=download] [data-odn-artifact-copy] {
+  padding-right: 20px;
+}
+
 [data-odn-artifact][data-odn-artifact-status=Generating] {
   opacity: 0.85;
 }

package/dist/chat-list/index.d.ts

@@ -49,12 +49,17 @@ export interface ChatListProps {
     onDelete?: ChatItemProps['onDelete'];
     /** 自定义行渲染。默认渲染 ChatItem。 */
     renderItem?: (item: ChatListItem, node: ReactNode) => ReactNode;
+    /**
+     * 将「最近」列表包进自定义滚动容器。
+     * 标题栏与置顶区始终留在外侧，不进入该容器。
+     */
+    renderRestScroll?: (content: ReactNode) => ReactNode;
 }
 /** 按时间筛选项判断会话是否命中。无有效 `time` 时仅在「全部」下保留。 */
 export declare function matchChatListFilterTime(time: ChatListItem['time'], filter: ChatListFilterTime, now?: number): boolean;
 /** 按类型筛选项判断会话是否命中。缺省 `type` 视为 `'ai'`。 */
 export declare function matchChatListFilterType(type: ChatListItem['type'], filter: ChatListFilterType): boolean;
-export declare function ChatList({ items, title, pinnedSectionTitle, recentSectionTitle, filterTime: filterTimeProp, defaultFilterTime, onFilterTimeChange, filterType: filterTypeProp, defaultFilterType, onFilterTypeChange, filterOpen: filterOpenProp, defaultFilterOpen, onFilterOpenChange, empty, actionMenuZIndex, filterMenuZIndex, className, onItemClick, onRename, onPin, onDelete, renderItem, }: ChatListProps): import("react").JSX.Element;
+export declare function ChatList({ items, title, pinnedSectionTitle, recentSectionTitle, filterTime: filterTimeProp, defaultFilterTime, onFilterTimeChange, filterType: filterTypeProp, defaultFilterType, onFilterTypeChange, filterOpen: filterOpenProp, defaultFilterOpen, onFilterOpenChange, empty, actionMenuZIndex, filterMenuZIndex, className, onItemClick, onRename, onPin, onDelete, renderItem, renderRestScroll, }: ChatListProps): import("react").JSX.Element;
 export declare namespace ChatList {
     var displayName: string;
 }

package/dist/chat-list/index.js

@@ -1,6 +1,6 @@
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
-import { useMemo, useState } from 'react';
 import clsx from 'clsx';
+import { useMemo, useState } from 'react';
 import ChatItem from "../chat-item";
 import Dropdown from "../dropdown";
 import Icon from "../icon";
@@ -34,7 +34,7 @@ var TYPE_OPTIONS = [{
   label: '人工客服'
 }];
 function parseItemTime(time) {
-  if (time == null) return null;
+  if (time === null || time === undefined) return null;
   var t = typeof time === 'number' ? time : time instanceof Date ? time.getTime() : Date.parse(time);
   return Number.isFinite(t) ? t : null;
 }
@@ -49,7 +49,7 @@ export function matchChatListFilterTime(time, filter) {
   var now = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Date.now();
   if (filter === 'all') return true;
   var t = parseItemTime(time);
-  if (t == null) return false;
+  if (t === null || t === undefined) return false;
   if (t > now) return false;
   if (filter === 'today') return t >= startOfLocalDay(now);
   if (filter === '7d') return t >= now - 7 * 86400000;
@@ -144,7 +144,8 @@ export function ChatList(_ref) {
     onPin = _ref.onPin,
     onDelete = _ref.onDelete,
     _ref$renderItem = _ref.renderItem,
-    renderItem = _ref$renderItem === void 0 ? defaultRenderItem : _ref$renderItem;
+    renderItem = _ref$renderItem === void 0 ? defaultRenderItem : _ref$renderItem,
+    renderRestScroll = _ref.renderRestScroll;
   var _useControllable = useControllable(filterTimeProp, defaultFilterTime, onFilterTimeChange),
     _useControllable2 = _slicedToArray(_useControllable, 2),
     filterTime = _useControllable2[0],
@@ -196,6 +197,20 @@ export function ChatList(_ref) {
     }, renderItem(item, node));
   };
   var hasContent = pinnedItems.length > 0 || restItems.length > 0;
+  var pinnedSection = pinnedItems.length > 0 ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-pinned": true
+  }, pinnedSectionTitle !== null && pinnedSectionTitle !== undefined ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-pinned-title": true
+  }, pinnedSectionTitle) : null, /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-pinned-body": true
+  }, pinnedItems.map(renderChatItem))) : null;
+  var restSection = restItems.length > 0 ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-rest": true
+  }, pinnedItems.length > 0 && recentSectionTitle !== null && recentSectionTitle !== undefined ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-recent-title": true
+  }, recentSectionTitle) : null, /*#__PURE__*/React.createElement("div", {
+    "data-odn-chat-list-rest-body": true
+  }, restItems.map(renderChatItem))) : null;
   return /*#__PURE__*/React.createElement("div", {
     "data-odn-chat-list": true,
     className: clsx(className)
@@ -236,21 +251,9 @@ export function ChatList(_ref) {
     size: 16
   }))))), !hasContent ? /*#__PURE__*/React.createElement("div", {
     "data-odn-chat-list-empty": true
-  }, empty !== null && empty !== void 0 ? empty : null) : /*#__PURE__*/React.createElement("div", {
+  }, empty !== null && empty !== void 0 ? empty : null) : renderRestScroll ? /*#__PURE__*/React.createElement(React.Fragment, null, pinnedSection, restSection ? renderRestScroll(restSection) : null) : /*#__PURE__*/React.createElement("div", {
     "data-odn-chat-list-body": true
-  }, pinnedItems.length > 0 ? /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-pinned": true
-  }, pinnedSectionTitle != null ? /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-pinned-title": true
-  }, pinnedSectionTitle) : null, /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-pinned-body": true
-  }, pinnedItems.map(renderChatItem))) : null, restItems.length > 0 ? /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-rest": true
-  }, pinnedItems.length > 0 && recentSectionTitle != null ? /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-recent-title": true
-  }, recentSectionTitle) : null, /*#__PURE__*/React.createElement("div", {
-    "data-odn-chat-list-rest-body": true
-  }, restItems.map(renderChatItem))) : null));
+  }, pinnedSection, restSection));
 }
 ChatList.displayName = 'ChatList';
 export default ChatList;

package/dist/chat-list/style/index.css

@@ -9,19 +9,21 @@
 
 [data-odn-chat-list-toolbar] {
   display: flex;
+  flex-shrink: 0;
   align-items: center;
   justify-content: space-between;
   gap: 8px;
   min-height: 32px;
   min-width: 0;
-  padding: 0 4px;
+  /* 与 ChatItem / 分区标题左缘统一 12px */
+  padding: 0 12px;
   background: transparent;
 }
 
 [data-odn-chat-list-title] {
   flex: 1 1 auto;
   min-width: 0;
-  padding: 0 4px;
+  padding: 0;
   color: var(--odn-color-black-9);
   font-size: 14px;
   font-weight: 400;
@@ -110,14 +112,18 @@
 [data-odn-chat-list-rest] {
   display: flex;
   flex-direction: column;
-  gap: 2px;
+  gap: 4px;
   min-width: 0;
 }
 
-/* 置顶 / 最近分区头：视觉同组标题，无折叠 / 菜单等交互 */
+[data-odn-chat-list-pinned] {
+  flex-shrink: 0;
+}
+
+/* 置顶 / 最近分区头：视觉同组标题，无折叠 / 菜单等交互；左缘同标题栏 / ChatItem */
 [data-odn-chat-list-pinned-title],
 [data-odn-chat-list-recent-title] {
-  padding: 4px 8px 2px;
+  padding: 4px 12px 2px;
   color: var(--odn-color-black-9);
   font-size: 12px;
   font-weight: 400;
@@ -130,6 +136,6 @@
 [data-odn-chat-list-rest-body] {
   display: flex;
   flex-direction: column;
-  gap: 2px;
+  gap: 4px;
   min-width: 0;
 }

package/dist/clarify-dock/style/index.css

@@ -545,13 +545,15 @@ div[data-odn-clarify-dock] [data-odn-clarify-dock-body] {
 div[data-odn-clarify-dock] [data-odn-date-picker-container]:not([data-odn-date-picker-container-range]) {
   display: inline-block;
   box-sizing: border-box;
-  width: calc(12ch + 10px + 32px + 2px);
+  font-size: var(--odn-font-size-text-sm);
+  width: calc(10ch + 10px + 32px + 2px);
 }
 
 div[data-odn-clarify-dock] [data-odn-date-picker-container-range] {
   display: inline-block;
   box-sizing: border-box;
-  width: calc(25ch + 10px + 32px + 2px);
+  font-size: var(--odn-font-size-text-sm);
+  width: calc(21ch + 10px + 32px + 2px);
 }
 
 div[data-odn-clarify-dock] [data-odn-date-picker-input] {

package/dist/composer/editor.d.ts

@@ -41,6 +41,8 @@ export interface ComposerEditorProps {
     defaultValue?: string;
     /** 值变化回调；参数是 raw string，含 marker。 */
     onChange?: (value: string) => void;
+    /** 与 defaultValue / 首次受控 value 配套，把 marker 还原成 chip。 */
+    defaultChips?: ChipData[];
     placeholder?: string;
     autoSize?: ComposerEditorAutoSize;
     /**

package/dist/composer/editor.js

@@ -22,13 +22,13 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 
 import { forwardRef, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
+import ScrollArea from "../scroll-area";
+import { findChipHostBeforeCaret, mergeLineIntoPreviousAtCaretStart, normalizeCollapsedCaretAtChipBoundary, resolveCaretMove, splitLineAt } from "./caret";
 import { buildClipboardPayload, COMPOSER_CLIPBOARD_MIME, parseClipboardPayload, plainTextFromClipboardPayload, remapClipboardPayload } from "./clipboard";
 import { useChipManager } from "./hooks/useChipManager";
 import { useChipSelectionMarker } from "./hooks/useChipSelectionMarker";
+import { chipHasEditableParams, ComposerInlineRef } from "./inline-ref";
 import { createLineRoot, createLineRootWithText, ensureLineRoots, getPlainText, isEditorEmpty, LINE_ATTR_NAME, normalizeEditorDom, probeTrigger } from "./utils";
-import { findChipHostBeforeCaret, mergeLineIntoPreviousAtCaretStart, normalizeCollapsedCaretAtChipBoundary, resolveCaretMove, splitLineAt } from "./caret";
-import { ComposerInlineRef } from "./inline-ref";
-import ScrollArea from "../scroll-area";
 
 /** Composer editor 触发态对外信号——告诉父组件该弹浮层选 skill 了。 */
 
@@ -83,6 +83,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   var valueProp = _ref.value,
     _ref$defaultValue = _ref.defaultValue,
     defaultValue = _ref$defaultValue === void 0 ? '' : _ref$defaultValue,
+    defaultChips = _ref.defaultChips,
     onChange = _ref.onChange,
     placeholder = _ref.placeholder,
     autoSize = _ref.autoSize,
@@ -113,7 +114,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   var minRows = (_autoSize$minRows = autoSize === null || autoSize === void 0 ? void 0 : autoSize.minRows) !== null && _autoSize$minRows !== void 0 ? _autoSize$minRows : 1;
   var maxRows = autoSize === null || autoSize === void 0 ? void 0 : autoSize.maxRows;
   var minHeightPx = minRows * LINE_HEIGHT + PADDING_Y * 2;
-  var maxHeightPx = maxRows != null ? maxRows * LINE_HEIGHT + PADDING_Y * 2 : undefined;
+  var maxHeightPx = maxRows !== undefined ? maxRows * LINE_HEIGHT + PADDING_Y * 2 : undefined;
 
   /** 当前活动 trigger probe；null 表示无触发态。 */
   var triggerRef = useRef(null);
@@ -182,8 +183,8 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     var el = editorRef.current;
     if (!el) return;
     var natural = Math.ceil(el.scrollHeight);
-    var clamped = Math.max(minHeightPx, maxHeightPx != null ? Math.min(natural, maxHeightPx) : natural);
-    var overflow = maxHeightPx != null && natural > maxHeightPx + 1;
+    var clamped = Math.max(minHeightPx, maxHeightPx !== undefined ? Math.min(natural, maxHeightPx) : natural);
+    var overflow = maxHeightPx !== undefined && natural > maxHeightPx + 1;
     setScrollHeight(function (prev) {
       return prev === clamped ? prev : clamped;
     });
@@ -203,7 +204,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   }, []);
   var scheduleControlledSync = useCallback(function () {
     if (!isControlled) return;
-    if (controlledSyncRafRef.current != null) {
+    if (controlledSyncRafRef.current !== null) {
       cancelAnimationFrame(controlledSyncRafRef.current);
     }
     controlledSyncRafRef.current = requestAnimationFrame(function () {
@@ -215,7 +216,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   }, [isControlled]);
   useEffect(function () {
     return function () {
-      if (controlledSyncRafRef.current != null) {
+      if (controlledSyncRafRef.current !== null) {
         cancelAnimationFrame(controlledSyncRafRef.current);
       }
     };
@@ -241,9 +242,10 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   /* ─────────────────────────────────────
    * chip 管理
    * ───────────────────────────────────── */
+  var recomputeTriggerRef = useRef(function () {});
   var _useChipManager = useChipManager(function () {
       fireChange();
-      recomputeTrigger();
+      recomputeTriggerRef.current();
     }),
     chips = _useChipManager.chips,
     _insertChip = _useChipManager.insertChip,
@@ -252,8 +254,11 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     removeChip = _useChipManager.removeChip,
     updateChipData = _useChipManager.updateChipData,
     getChipHost = _useChipManager.getChipHost,
+    getChips = _useChipManager.getChips,
     resetChips = _useChipManager.resetChips;
   useChipSelectionMarker(editorRef, chips);
+  var insertSerializedAtRangeRef = useRef(insertSerializedAtRange);
+  insertSerializedAtRangeRef.current = insertSerializedAtRange;
 
   /* ─────────────────────────────────────
    * Trigger 探测
@@ -282,6 +287,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     triggerRef.current = next;
     onTriggerChange === null || onTriggerChange === void 0 || onTriggerChange(next ? probeToInfo(next) : null);
   }, [triggers, onTriggerChange, probeToInfo]);
+  recomputeTriggerRef.current = recomputeTrigger;
 
   /* ─────────────────────────────────────
    * ref 命令式 API
@@ -363,18 +369,14 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
       },
       /* chips 快照：按 DOM 实际出现顺序输出（chips state 维护时已经有序）。
        * 不直接返回 chips 引用，避免外部 mutate 弄花内部 state。 */
-      getChips: function getChips() {
-        return chips.map(function (c) {
-          return c.data;
-        });
-      },
+      getChips: getChips,
       updateChipData: updateChipData,
       getChipHost: getChipHost,
       get nativeElement() {
         return editorRef.current;
       }
     };
-  }, [onChange, _insertChip, removeChip, resetChips, onTriggerChange, chips, updateChipData, getChipHost]);
+  }, [onChange, _insertChip, removeChip, resetChips, onTriggerChange, getChips, updateChipData, getChipHost]);
 
   /* ─────────────────────────────────────
    * 监听 selection 变化：方向键 / 鼠标点击移位都要重算 trigger
@@ -431,22 +433,34 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     var el = editorRef.current;
     if (!el) return;
     var initial = isControlled ? valueProp !== null && valueProp !== void 0 ? valueProp : '' : defaultValue;
+    var initialChips = defaultChips !== null && defaultChips !== void 0 ? defaultChips : [];
     if (el.childNodes.length === 0) {
-      var lines = (initial !== null && initial !== void 0 ? initial : '').split('\n');
-      var frag = document.createDocumentFragment();
-      var _iterator = _createForOfIteratorHelper(lines),
-        _step;
-      try {
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
-          var line = _step.value;
-          frag.appendChild(createLineRootWithText(line));
+      if (initialChips.length > 0) {
+        el.appendChild(createLineRoot());
+        var firstLine = el.firstChild;
+        if (firstLine) {
+          var range = document.createRange();
+          range.selectNodeContents(firstLine);
+          range.collapse(true);
+          insertSerializedAtRangeRef.current(initial, initialChips, range, el);
         }
-      } catch (err) {
-        _iterator.e(err);
-      } finally {
-        _iterator.f();
+      } else {
+        var lines = (initial !== null && initial !== void 0 ? initial : '').split('\n');
+        var frag = document.createDocumentFragment();
+        var _iterator = _createForOfIteratorHelper(lines),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var line = _step.value;
+            frag.appendChild(createLineRootWithText(line));
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+        el.appendChild(frag);
       }
-      el.appendChild(frag);
       if (initial && initial.length > 0) setEmpty(false);
     }
     // 仅初始化一次；后续受控同步走下方 effect
@@ -793,7 +807,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     return /*#__PURE__*/createPortal( /*#__PURE__*/React.createElement(ComposerInlineRef, {
       data: chip.data,
       active: paramEditChipId === chip.data.id,
-      onClick: onInlineRefClick ? function (anchor) {
+      onClick: onInlineRefClick && chipHasEditableParams(chip.data) ? function (anchor) {
         return onInlineRefClick(chip.data.id, anchor);
       } : undefined
     }), chip.host, chip.data.id);

package/dist/composer/hooks/useChipManager.d.ts

@@ -39,6 +39,8 @@ export interface UseChipManagerReturn {
     updateChipData: (id: string, patch: Partial<ChipData>) => void;
     /** 按 id 取 chip host（参数面板 anchor）。 */
     getChipHost: (id: string) => HTMLSpanElement | null;
+    /** 当前 chip 快照（读 ref，插入后同步 onChange 时可用）。 */
+    getChips: () => ChipData[];
     /** 清空所有 chip 的 React 状态（DOM 由调用方 editor.innerHTML='' 一并处理）。 */
     resetChips: () => void;
 }

package/dist/composer/hooks/useChipManager.js

@@ -388,6 +388,13 @@ onAfterMutate) {
       return c.data.id === id;
     })) === null || _chipsRef$current$fin2 === void 0 ? void 0 : _chipsRef$current$fin2.host) !== null && _chipsRef$current$fin !== void 0 ? _chipsRef$current$fin : null;
   }, []);
+
+  /** 读 ref，插入后同步 onChange 时 state 可能还没 flush。 */
+  var getChips = useCallback(function () {
+    return chipsRef.current.map(function (c) {
+      return c.data;
+    });
+  }, []);
   var resetChips = useCallback(function () {
     setChips([]);
     chipsRef.current = [];
@@ -401,6 +408,7 @@ onAfterMutate) {
     removeChip: removeChip,
     updateChipData: updateChipData,
     getChipHost: getChipHost,
+    getChips: getChips,
     resetChips: resetChips
   };
 }

package/dist/composer/index.d.ts

@@ -66,8 +66,10 @@ export interface ComposerProps {
     value?: string;
     /** 输入框非受控默认值 */
     defaultValue?: string;
-    /** 输入框值变化回调 */
-    onChange?: (value: string) => void;
+    /** 与 defaultValue 配套，首次挂载时把 marker 还原成 chip。 */
+    defaultChips?: ChipData[];
+    /** 输入框值变化回调。第二参是当前 chip 快照，旧调用方忽略即可。 */
+    onChange?: (value: string, chips?: ChipData[]) => void;
     /**
      * 发送回调。
      *
@@ -176,6 +178,8 @@ export interface ComposerProps {
      * - 不传则非受控，组件内部自管，沿用 `URL.createObjectURL(f)` 生成 blob url 的旧行为（向后兼容）。
      */
     attachments?: Attachment[];
+    /** 非受控附件初始值，随组件挂载（如 `key` 切换会话）生效。 */
+    defaultAttachments?: Attachment[];
     /**
      * 附件数组变化时触发（新增、删除、外部回写都会调）。
      * 受控模式下与 `attachments` 配合形成 React 标准受控形态。
@@ -235,7 +239,8 @@ export interface ComposerProps {
      */
     fileRejectMessage?: (ext: string) => string;
     /**
-     * 参数面板内容渲染。提供后 invocation chip 可点击打开面板；
+     * 参数面板内容渲染。提供后，**待补充 / 已填参数** 的 invocation chip
+     * 可点击打开面板；无参数 skill 无 hover、不可点。
      * `SkillItem.initialState='pending'` 插入后会自动打开。
      */
     renderParamPanel?: (ctx: ComposerParamPanelContext) => React.ReactNode;