@qfei-design/make-ai-assistant 0.2.10 → 0.2.12

package/dist/styles.css

@@ -283,8 +283,8 @@
   background: var(--make-ai-internal-bg);
   border-bottom: 1px solid var(--make-ai-internal-border);
   display: grid;
-  gap: 8px;
-  grid-template-columns: auto 1fr auto;
+  gap: 10px;
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
   grid-row: 1;
   height: var(--make-ai-internal-header-height);
   min-height: var(--make-ai-internal-header-height);
@@ -327,6 +327,7 @@
 
 .make-ai-assistant__avatar svg,
 .make-ai-assistant__icon-button svg,
+.make-ai-assistant__task-list-trigger svg,
 .make-ai-assistant__send svg {
   fill: none;
   height: 20px;
@@ -359,110 +360,78 @@
   align-items: center;
   display: flex;
   gap: 2px;
+  justify-self: end;
+  min-width: 0;
 }
 
-.make-ai-assistant__header-content,
-.make-ai-assistant__header-title-row,
-.make-ai-assistant__header-context {
+.make-ai-assistant__header-leading {
+  justify-self: start;
   min-width: 0;
 }
 
-.make-ai-assistant__header-title-row,
-.make-ai-assistant__header-context {
+.make-ai-assistant__header-center {
   align-items: center;
   display: flex;
-}
-
-.make-ai-assistant__header-title-row {
   gap: 8px;
-}
-
-.make-ai-assistant__header-title {
-  flex: 0 1 auto;
+  justify-self: center;
+  max-width: min(100%, 310px);
   min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.make-ai-assistant__read-only-tag {
-  background: color-mix(in srgb, var(--make-ai-internal-accent) 10%, var(--make-ai-internal-bg));
-  border: 1px solid color-mix(in srgb, var(--make-ai-internal-accent) 24%, var(--make-ai-internal-border));
-  border-radius: 5px;
-  color: color-mix(in srgb, var(--make-ai-internal-accent) 82%, var(--make-ai-internal-text));
-  flex: 0 0 auto;
-  font-size: var(--make-ai-internal-font-size-caption);
-  font-weight: 650;
-  line-height: var(--make-ai-internal-line-height-caption);
-  padding: 0 5px;
 }
 
-.make-ai-assistant__header-context {
-  gap: 6px;
-  margin-top: 1px;
+.make-ai-assistant__header-center > .make-ai-assistant__avatar {
+  border-radius: 50%;
+  height: 30px;
+  width: 30px;
 }
 
-.make-ai-assistant__header-context p {
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
+.make-ai-assistant__header-center > .make-ai-assistant__avatar svg {
+  height: 17px;
+  width: 17px;
 }
 
-.make-ai-assistant__header-context-help {
+.make-ai-assistant__task-list-trigger {
   align-items: center;
-  border-radius: 50%;
-  color: color-mix(in srgb, var(--make-ai-internal-text-secondary) 84%, var(--make-ai-internal-accent));
+  background: var(--make-ai-internal-surface-strong);
+  border: 0;
+  border-radius: 9px;
+  color: var(--make-ai-internal-text-secondary);
   cursor: pointer;
   display: inline-flex;
-  flex: 0 0 auto;
-  height: 18px;
-  justify-content: center;
-  width: 18px;
+  font-size: var(--make-ai-internal-font-size-caption);
+  gap: 6px;
+  height: 34px;
+  max-width: 118px;
+  padding: 0 8px;
+  white-space: nowrap;
 }
 
-.make-ai-assistant__header-context-help svg {
-  fill: none;
-  height: 14px;
-  stroke: currentColor;
-  stroke-linecap: round;
-  stroke-linejoin: round;
-  stroke-width: 1.8;
-  width: 14px;
+.make-ai-assistant__task-list-trigger:hover,
+.make-ai-assistant__task-list-trigger[aria-expanded="true"] {
+  background: color-mix(in srgb, var(--make-ai-internal-accent) 8%, var(--make-ai-internal-surface-strong));
+  color: var(--make-ai-internal-text);
 }
 
-.make-ai-assistant__header-context-help:focus-visible {
-  outline: 2px solid color-mix(in srgb, var(--make-ai-internal-accent) 32%, transparent);
-  outline-offset: 2px;
+.make-ai-assistant__task-list-trigger svg:first-child {
+  height: 19px;
+  width: 19px;
 }
 
-.make-ai-assistant__header-context-tooltip {
-  background: var(--make-ai-internal-overlay);
-  border-radius: 8px;
-  box-shadow: 0 8px 18px var(--make-ai-internal-overlay-shadow);
-  color: var(--make-ai-internal-on-overlay);
-  font-size: var(--make-ai-internal-font-size-meta);
-  font-weight: 500;
-  line-height: var(--make-ai-internal-line-height-meta);
-  max-height: calc(100vh - 32px);
-  max-width: min(280px, calc(100vw - 32px));
-  opacity: 0;
-  overflow: auto;
-  padding: 7px 8px;
-  pointer-events: none;
-  position: fixed;
-  transform: translateY(-2px);
-  transition: opacity 120ms ease, transform 120ms ease;
-  visibility: hidden;
-  white-space: normal;
-  width: max-content;
-  z-index: calc(var(--make-ai-internal-z-index) + 1);
+.make-ai-assistant__task-list-trigger svg:last-child {
+  height: 15px;
+  transition: transform 160ms ease;
+  width: 15px;
 }
 
-.make-ai-assistant__header-context-tooltip[data-positioned][data-visible] {
-  opacity: 1;
-  transform: translateY(0);
-  visibility: visible;
+.make-ai-assistant__task-list-trigger[aria-expanded="true"] svg:last-child {
+  transform: rotate(180deg);
+}
+
+.make-ai-assistant__header-title {
+  flex: 0 1 auto;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
 .make-ai-assistant__body {
@@ -1260,14 +1229,15 @@
 }
 
 .make-ai-assistant__composer {
-  align-items: flex-end;
   background: var(--make-ai-internal-surface);
   border: 1px solid var(--make-ai-internal-border);
   border-radius: 15px;
-  display: flex;
-  gap: 9px;
-  min-height: 54px;
-  padding: 7px 8px 7px 12px;
+  display: grid;
+  gap: 7px 10px;
+  grid-template-columns: minmax(0, 1fr) auto;
+  grid-template-rows: minmax(46px, auto) 36px;
+  min-height: 96px;
+  padding: 10px 10px 8px;
   transition: background 160ms ease, border-color 160ms ease, box-shadow 160ms ease;
 }
 
@@ -1285,10 +1255,12 @@
   color: var(--make-ai-internal-text);
   font-size: var(--make-ai-internal-font-size-body);
   line-height: var(--make-ai-internal-line-height-body);
-  max-height: 112px;
-  min-height: 38px;
+  grid-column: 1 / -1;
+  grid-row: 1;
+  max-height: 128px;
+  min-height: 46px;
   outline: 0;
-  padding: 4px 0 2px;
+  padding: 2px 5px;
   resize: none;
   width: 100%;
 }
@@ -1312,12 +1284,20 @@
   flex: 0 0 auto;
   height: 34px;
   justify-content: center;
-  margin-bottom: 2px;
   position: relative;
   transition: background 160ms ease, box-shadow 160ms ease, opacity 160ms ease;
   width: 34px;
 }
 
+.make-ai-assistant__composer-actions {
+  align-items: center;
+  display: flex;
+  gap: 7px;
+  grid-column: 2;
+  grid-row: 2;
+  justify-self: end;
+}
+
 .make-ai-assistant__send::before {
   content: "";
   inset: -5px;
@@ -1555,11 +1535,30 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
 
 @container (max-width: 360px) {
   .make-ai-assistant__header {
-    gap: 8px;
-    grid-template-columns: auto minmax(0, 1fr) auto;
+    gap: 6px;
+    grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
     padding: 7px var(--make-ai-internal-panel-gutter-compact);
   }
 
+  .make-ai-assistant__task-list-trigger {
+    max-width: 34px;
+    padding: 0 8px;
+  }
+
+  .make-ai-assistant__task-list-trigger > span,
+  .make-ai-assistant__task-list-trigger svg:last-child {
+    display: none;
+  }
+
+  .make-ai-assistant__header-center {
+    gap: 6px;
+  }
+
+  .make-ai-assistant__header-center > .make-ai-assistant__avatar {
+    height: 26px;
+    width: 26px;
+  }
+
   .make-ai-assistant__body {
     padding: 16px var(--make-ai-internal-panel-gutter-compact) 24px;
   }
@@ -1739,29 +1738,171 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
 }
 
 .make-ai-assistant__conversation-controls {
-  border-bottom: 1px solid var(--make-ai-internal-border);
-  flex: 0 0 auto;
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 12px;
+  box-shadow: 0 14px 34px color-mix(in srgb, var(--make-ai-internal-text) 12%, transparent);
   font-size: var(--make-ai-internal-font-size-meta);
-  max-height: 240px;
+  left: var(--make-ai-internal-panel-gutter);
+  max-height: min(430px, calc(100% - var(--make-ai-internal-header-height) - 24px));
   overflow: auto;
-  padding: 8px 12px;
+  padding: 12px 8px 8px;
+  position: absolute;
+  top: calc(var(--make-ai-internal-header-height) + 3px);
+  width: min(300px, calc(100% - var(--make-ai-internal-panel-gutter) * 2));
+  z-index: calc(var(--make-ai-internal-z-index) + 1);
 }
-.make-ai-assistant__panel--managed { grid-template-rows: auto auto minmax(0, 1fr) auto; }
-.make-ai-assistant__panel--managed > .make-ai-assistant__conversation-controls { grid-row: 2; }
-.make-ai-assistant__panel--managed > .make-ai-assistant__body { grid-row: 3; }
-.make-ai-assistant__panel--managed > .make-ai-assistant__composer-region { grid-row: 4; }
+
+.make-ai-assistant__panel--managed {
+  grid-template-rows: auto minmax(0, 1fr) auto;
+}
+
 .make-ai-assistant__response-status { color: var(--make-ai-internal-text-secondary); font-size: var(--make-ai-internal-font-size-meta); }
 
-.make-ai-assistant__conversation-list { max-height: 130px; overflow: auto; }
-.make-ai-assistant__conversation-row { display: flex; gap: 4px; margin-bottom: 4px; }
-.make-ai-assistant__conversation-row > button:first-child { flex: 1; min-width: 0; overflow: hidden; text-align: left; text-overflow: ellipsis; white-space: nowrap; }
-.make-ai-assistant__conversation-row > button[aria-pressed="true"] { background: var(--make-ai-internal-accent-soft); color: var(--make-ai-internal-accent); }
-.make-ai-assistant__conversation-actions { align-items: center; display: flex; flex-wrap: wrap; gap: 6px; padding-top: 8px; }
-.make-ai-assistant__conversation-actions input { flex: 1; min-width: 100px; }
+.make-ai-assistant__conversation-heading {
+  align-items: center;
+  color: var(--make-ai-internal-text-secondary);
+  display: flex;
+  font-size: var(--make-ai-internal-font-size-caption);
+  justify-content: space-between;
+  letter-spacing: .02em;
+  min-height: 26px;
+  padding: 0 7px 6px;
+}
+
+.make-ai-assistant__conversation-list {
+  max-height: 220px;
+  overflow: auto;
+  overscroll-behavior: contain;
+}
+
+.make-ai-assistant__conversation-list > p {
+  color: var(--make-ai-internal-text-secondary);
+  margin: 16px 8px;
+  text-align: center;
+}
+
+.make-ai-assistant__conversation-row {
+  align-items: center;
+  display: flex;
+  gap: 2px;
+  min-width: 0;
+}
+
+.make-ai-assistant__conversation-row > button:first-child {
+  align-items: center;
+  border-color: transparent;
+  display: flex;
+  flex: 1;
+  gap: 8px;
+  min-height: 36px;
+  min-width: 0;
+  overflow: hidden;
+  padding: 0 8px;
+  text-align: left;
+}
+
+.make-ai-assistant__conversation-row > button:first-child svg,
+.make-ai-assistant__conversation-new svg {
+  fill: none;
+  flex: 0 0 auto;
+  height: 16px;
+  stroke: currentColor;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  stroke-width: 1.7;
+  width: 16px;
+}
+
+.make-ai-assistant__conversation-row > button:first-child span {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.make-ai-assistant__conversation-row > button[aria-pressed="true"] {
+  background: var(--make-ai-internal-accent-soft);
+  color: var(--make-ai-internal-accent);
+}
+
+.make-ai-assistant__conversation-row > button:last-child {
+  background: transparent;
+  border-color: transparent;
+  color: var(--make-ai-internal-text-secondary);
+  flex: 0 0 auto;
+  height: 30px;
+  padding: 0;
+  width: 30px;
+}
+
+.make-ai-assistant__conversation-more,
+.make-ai-assistant__conversation-refresh {
+  background: transparent !important;
+  border-color: transparent !important;
+  color: var(--make-ai-internal-text-secondary) !important;
+}
+
+.make-ai-assistant__conversation-more {
+  margin-top: 4px;
+  width: 100%;
+}
+
+.make-ai-assistant__conversation-management {
+  border-top: 1px solid var(--make-ai-internal-border);
+  margin-top: 8px;
+  padding: 8px 7px 0;
+}
+
+.make-ai-assistant__conversation-management summary {
+  color: var(--make-ai-internal-text-secondary);
+  cursor: pointer;
+}
+
+.make-ai-assistant__conversation-actions {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  padding-top: 8px;
+}
+
+.make-ai-assistant__conversation-actions input {
+  flex: 1;
+  min-width: 100px;
+}
+
+.make-ai-assistant__conversation-error {
+  color: var(--make-ai-internal-danger);
+  display: grid;
+  gap: 6px;
+  padding: 8px 7px 0;
+}
+
+.make-ai-assistant__conversation-new {
+  align-items: center;
+  background: transparent !important;
+  border-color: transparent !important;
+  border-radius: 8px !important;
+  border-top: 1px solid var(--make-ai-internal-border) !important;
+  color: var(--make-ai-internal-accent) !important;
+  display: flex;
+  font-weight: 650 !important;
+  gap: 8px;
+  justify-content: flex-start;
+  margin-top: 8px;
+  min-height: 40px;
+  padding: 8px !important;
+  width: 100%;
+}
+
+.make-ai-assistant__conversation-new:hover {
+  background: var(--make-ai-internal-accent-soft) !important;
+}
+
 .make-ai-assistant__conversation-controls button,
 .make-ai-assistant__feedback button,
-.make-ai-assistant__attachment button,
-.make-ai-assistant__attachment-composer button {
+.make-ai-assistant__attachment button {
   background: var(--make-ai-internal-surface);
   border: 1px solid var(--make-ai-internal-border);
   border-radius: 6px;
@@ -1780,14 +1921,120 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
 .make-ai-assistant__attachment img,
 .make-ai-assistant__attachment video { max-height: 260px; max-width: 100%; object-fit: contain; }
 .make-ai-assistant__attachment audio { max-width: 100%; }
-.make-ai-assistant__attachment-composer { font-size: var(--make-ai-internal-font-size-meta); max-height: 140px; overflow: auto; padding-bottom: 8px; }
-.make-ai-assistant__attachment-composer input { max-width: 100%; }
-.make-ai-assistant__attachment-composer ul { list-style: none; margin: 6px 0 0; padding: 0; }
-.make-ai-assistant__attachment-composer li { align-items: center; display: flex; flex-wrap: wrap; gap: 4px; padding: 4px 0; }
+
+.make-ai-assistant__attachment-composer {
+  align-self: center;
+  font-size: var(--make-ai-internal-font-size-meta);
+  grid-column: 1;
+  grid-row: 2;
+  justify-self: start;
+  position: relative;
+}
+
+.make-ai-assistant__attachment-trigger {
+  align-items: center;
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: 50%;
+  color: var(--make-ai-internal-text-secondary);
+  cursor: pointer;
+  display: flex;
+  height: 34px;
+  justify-content: center;
+  padding: 0;
+  width: 34px;
+}
+
+.make-ai-assistant__attachment-trigger:hover,
+.make-ai-assistant__attachment-trigger[aria-expanded="true"] {
+  background: var(--make-ai-internal-surface-strong);
+  border-color: color-mix(in srgb, var(--make-ai-internal-accent) 24%, var(--make-ai-internal-border));
+  color: var(--make-ai-internal-text);
+}
+
+.make-ai-assistant__attachment-trigger svg,
+.make-ai-assistant__attachment-menu svg {
+  fill: none;
+  height: 18px;
+  stroke: currentColor;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  stroke-width: 1.7;
+  width: 18px;
+}
+
+.make-ai-assistant__attachment-menu {
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 10px;
+  bottom: calc(100% + 8px);
+  box-shadow: 0 12px 28px color-mix(in srgb, var(--make-ai-internal-text) 12%, transparent);
+  left: 0;
+  min-width: 168px;
+  padding: 5px;
+  position: absolute;
+  z-index: calc(var(--make-ai-internal-z-index) + 2);
+}
+
+.make-ai-assistant__attachment-menu button {
+  align-items: center;
+  background: transparent;
+  border: 0;
+  border-radius: 7px;
+  color: var(--make-ai-internal-text);
+  cursor: pointer;
+  display: flex;
+  gap: 9px;
+  min-height: 38px;
+  padding: 0 10px;
+  text-align: left;
+  width: 100%;
+}
+
+.make-ai-assistant__attachment-menu button:hover {
+  background: var(--make-ai-internal-surface-strong);
+}
+
+.make-ai-assistant__attachment-drafts {
+  font-size: var(--make-ai-internal-font-size-meta);
+  max-height: 140px;
+  overflow: auto;
+  padding-bottom: 8px;
+}
+
+.make-ai-assistant__attachment-drafts ul {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.make-ai-assistant__attachment-drafts li {
+  align-items: center;
+  background: var(--make-ai-internal-surface);
+  border: 1px solid var(--make-ai-internal-border);
+  border-radius: 8px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  padding: 5px 7px;
+}
+
+.make-ai-assistant__attachment-drafts button {
+  background: transparent;
+  border: 0;
+  color: var(--make-ai-internal-accent);
+  cursor: pointer;
+  padding: 2px 4px;
+}
+
 .make-ai-assistant__conversation-controls button:focus-visible,
 .make-ai-assistant__feedback button:focus-visible,
 .make-ai-assistant__attachment button:focus-visible,
-.make-ai-assistant__attachment-composer button:focus-visible { outline: 2px solid var(--make-ai-internal-accent); outline-offset: 2px; }
+.make-ai-assistant__attachment-composer button:focus-visible,
+.make-ai-assistant__attachment-drafts button:focus-visible { outline: 2px solid var(--make-ai-internal-accent); outline-offset: 2px; }
 
 @media (prefers-reduced-motion: reduce) {
   .make-ai-assistant__drawer,
@@ -1801,10 +2048,13 @@ button.make-ai-artifact__record:hover { background: var(--make-ai-internal-accen
   .make-ai-assistant__launcher > svg,
   .make-ai-assistant__back-to-latest,
   .make-ai-assistant__drawer-resize-handle::after,
-  .make-ai-assistant__header-context-tooltip,
   .make-ai-assistant__reply-action[data-tooltip]::after,
   .make-ai-assistant__send[data-tooltip]::after,
   .make-ai-assistant__process summary::after {
     transition: none;
   }
+
+  .make-ai-assistant__task-list-trigger svg:last-child {
+    transition: none;
+  }
 }

package/docs/make-app-integration.md

@@ -19,7 +19,7 @@
 | setFeedback | 持久助手 messageId、requestId、like/dislike/none，以及可选 reason/comment |
 | startUpload / getUpload | 上传初始化与 completedParts 续传进度 |
 | uploadPart / completeUpload | 从 0 编号的二进制分段，全部完成后获取 ready 内容引用 |
-| readContent | 鉴权后原始 Uint8Array，不能把 contentRef 当公开 URL |
+| readContent（可选） | 宿主具备无损二进制认证读取能力时返回原始 Uint8Array；未提供时不展示下载/预览操作 |
 | eventSourceFactory | 以 chatId、responseId、cursor 创建带凭据的 EventSource；包负责关闭与重连 |
 
 JSON 回调返回服务端裸对象，204 返回 void，内容返回 Uint8Array。不要在所有响应上统一解包 data 或 JSON.parse。每个异步回调都必须传递 AbortSignal。scopeKey 仅隔离浏览器内的状态，不能代替服务器授权。
@@ -34,7 +34,7 @@ JSON 回调返回服务端裸对象，204 返回 void，内容返回 Uint8Array
 
 输出按 itemId/partId 归并，完整 done 文本覆盖增量。中间模型活动放在过程区域，不能充当最终可反馈消息。response.completed 后读取历史对账，切换到持久助手 messageId，再开放反馈。点踩说明提交失败保留表单，重新提交复用未知结果的原意图；撤销用 rating=none。
 
-文件选择、拖拽和粘贴进入同一上传队列。分段大小读 partSize，重试先查 completedParts；未 ready 的附件不能发送。暂停/移除只影响本地任务和草稿，当前没有远程上传取消接口。附件卡片可鉴权下载和受控预览，不执行 HTML/SVG/脚本。
+文件选择、拖拽和粘贴共用一个“上传文件或图片”入口和上传队列；前端不按 `modelInputKinds` 过滤或拒绝媒体类型。分段大小读 partSize，重试先查 completedParts，未 ready 的附件不能发送；服务端根据消息 parts 和实际模型能力决定是否接受。暂停/移除只影响本地任务和草稿，当前没有远程上传取消接口。提供 `readContent` 时，附件卡片可鉴权下载和受控预览；未提供时仅展示附件元数据，不执行 HTML/SVG/脚本。
 
 ## 流式事件与恢复
 
@@ -62,9 +62,9 @@ EventSource.onerror 后先关闭旧实例，再由 adapter 从最后处理游标
 | 上传 | 单文件 64 MiB，分段当前 1 MiB；服务端按完整 Namespace 限流/限容量 |
 | 历史 | cursor=-1 从最早事件正向扫描，limit 数底层事件；空可见页仍可 hasMore=true |
 | 长历史 | 分页继续加载，有界展示最近加载的 200 条/正文预算；不会声称首个窗口是全部历史 |
-| 模型媒体能力 | modelInputKinds 默认只有 text；逐类真实模型验收后由宿主开放 |
+| 模型媒体能力 | modelInputKinds 默认只有 text；前端仍提供统一上传入口，服务端按实际模型能力校验消息 parts |
 | 未完成上传 | 服务端当前 24 小时失效；无公开 abort/清理，容量不保证自动回收 |
-| 下载 | 当前为 attachment/octet-stream，不承诺 Range/206；预览用本地受控 Blob |
+| 下载 | readContent 为可选能力；启用时返回 attachment/octet-stream，不承诺 Range/206，预览使用本地受控 Blob |
 | Artifact/页面上下文 | 通用能力保留；当前 Make App 请求不携带 context/capabilities，不从 Markdown 猜 Artifact |
 | 重新生成 | 没有服务端替换语义，保持关闭；普通再次提问属于新消息 |
 

package/examples/make-app/README.md

@@ -6,6 +6,6 @@
 
 宿主提供同源 `GET /runtime-config`，响应为 `{appKey, appName, agentId, identityKey}`；identityKey 是用户/租户变化时同步变化的非凭据缓存隔离键。该配置不构成服务器授权。生产 POC 应将示例 request 换成已有认证客户端，并沿现有 Service/Make Gateway 转发公共接口。
 
-当前 Make App 后端只支持文本模型输入；示例的 modelInputKinds 为 `["text"]`。图片、文件、非实时音视频可先上传和查看原件，模型理解逐类验收后再配置开放。不要以文件上传成功判断模型已经支持。
+当前 Make App 后端只支持文本模型输入；示例的 modelInputKinds 为 `["text"]`，但仍保留统一的“上传文件或图片”入口。服务端必须根据消息 parts 和实际模型能力校验媒体类型；不要以原件存储或读取能力判断模型已经支持输入。
 
 详见 [接入说明](../../docs/make-app-integration.md)。正式发布仍由原仓库 GitLab CI 负责。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qfei-design/make-ai-assistant",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Platform-wide Make AI Assistant contracts, React shell, and context-aware artifact templates.",
   "type": "module",
   "sideEffects": [