@qfei-design/make-ai-assistant 0.2.11 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PUBLIC_API.md +5 -4
- package/README.md +6 -7
- package/dist/make-app.cjs +1 -1
- package/dist/make-app.d.ts +1 -1
- package/dist/make-app.mjs +418 -416
- package/dist/react/conversation-controls.d.ts +1 -1
- package/dist/react/use-attachments.d.ts +1 -0
- package/dist/react/use-conversation-manager.d.ts +2 -2
- package/dist/react.cjs +4 -4
- package/dist/react.mjs +1716 -1627
- package/dist/styles.css +368 -177
- package/docs/make-app-integration.md +5 -5
- package/examples/make-app/README.md +1 -1
- package/package.json +1 -1
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
| setFeedback | 持久助手 messageId、requestId、like/dislike/none，以及可选 reason/comment |
|
|
20
20
|
| startUpload / getUpload | 上传初始化与 completedParts 续传进度 |
|
|
21
21
|
| uploadPart / completeUpload | 从 0 编号的二进制分段，全部完成后获取 ready 内容引用 |
|
|
22
|
-
| readContent |
|
|
22
|
+
| readContent（可选） | 宿主具备无损二进制认证读取能力时返回原始 Uint8Array；未提供时不展示下载/预览操作 |
|
|
23
23
|
| eventSourceFactory | 以 chatId、responseId、cursor 创建带凭据的 EventSource；包负责关闭与重连 |
|
|
24
24
|
|
|
25
25
|
JSON 回调返回服务端裸对象，204 返回 void，内容返回 Uint8Array。不要在所有响应上统一解包 data 或 JSON.parse。每个异步回调都必须传递 AbortSignal。scopeKey 仅隔离浏览器内的状态，不能代替服务器授权。
|
|
@@ -32,9 +32,9 @@ JSON 回调返回服务端裸对象，204 返回 void，内容返回 Uint8Array
|
|
|
32
32
|
|
|
33
33
|
输入和重试保存稳定 UUID。多个输入可能对应同一 responseId；面板控制器在响应维度保持一个订阅，关闭面板继续保留当前 UI，切会话/身份或卸载只释放本地连接。停止按钮调用 cancelResponse，并等待终态；完成与取消竞争时接受服务端最终结果。
|
|
34
34
|
|
|
35
|
-
输出按 itemId/partId 归并，完整 done 文本覆盖增量。中间模型活动放在过程区域，不能充当最终可反馈消息。response.completed 后读取历史对账，切换到持久助手 messageId
|
|
35
|
+
输出按 itemId/partId 归并，完整 done 文本覆盖增量。中间模型活动放在过程区域，不能充当最终可反馈消息。response.completed 后读取历史对账，切换到持久助手 messageId，再开放反馈；复制、喜欢和不喜欢以图标按钮并列展示，悬浮或聚焦时显示对应文本提示。点踩说明提交失败保留表单，重新提交复用未知结果的原意图；撤销用 rating=none。
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
文件选择、拖拽和粘贴共用一个“上传文件或图片”入口和上传队列；前端不按 `modelInputKinds` 过滤或拒绝媒体类型。安全的本地位图图片会在输入框上方显示缩略图，悬浮或键盘聚焦时显示右上角移除图标；移除、清空、切换对话和卸载都会释放对应 Object URL。SVG 不生成缩略图。分段大小读 partSize，重试先查 completedParts，未 ready 的附件不能发送；服务端根据消息 parts 和实际模型能力决定是否接受。暂停/移除只影响本地任务和草稿，当前没有远程上传取消接口。提供 `readContent` 时，附件卡片可鉴权下载和受控预览；未提供时仅展示附件元数据，不执行 HTML/SVG/脚本。
|
|
38
38
|
|
|
39
39
|
## 流式事件与恢复
|
|
40
40
|
|
|
@@ -62,9 +62,9 @@ EventSource.onerror 后先关闭旧实例，再由 adapter 从最后处理游标
|
|
|
62
62
|
| 上传 | 单文件 64 MiB，分段当前 1 MiB；服务端按完整 Namespace 限流/限容量 |
|
|
63
63
|
| 历史 | cursor=-1 从最早事件正向扫描，limit 数底层事件；空可见页仍可 hasMore=true |
|
|
64
64
|
| 长历史 | 分页继续加载，有界展示最近加载的 200 条/正文预算；不会声称首个窗口是全部历史 |
|
|
65
|
-
| 模型媒体能力 | modelInputKinds 默认只有 text
|
|
65
|
+
| 模型媒体能力 | modelInputKinds 默认只有 text；前端仍提供统一上传入口，服务端按实际模型能力校验消息 parts |
|
|
66
66
|
| 未完成上传 | 服务端当前 24 小时失效；无公开 abort/清理，容量不保证自动回收 |
|
|
67
|
-
| 下载 |
|
|
67
|
+
| 下载 | readContent 为可选能力；启用时返回 attachment/octet-stream，不承诺 Range/206，预览使用本地受控 Blob |
|
|
68
68
|
| Artifact/页面上下文 | 通用能力保留；当前 Make App 请求不携带 context/capabilities，不从 Markdown 猜 Artifact |
|
|
69
69
|
| 重新生成 | 没有服务端替换语义，保持关闭；普通再次提问属于新消息 |
|
|
70
70
|
|
|
@@ -6,6 +6,6 @@
|
|
|
6
6
|
|
|
7
7
|
宿主提供同源 `GET /runtime-config`，响应为 `{appKey, appName, agentId, identityKey}`；identityKey 是用户/租户变化时同步变化的非凭据缓存隔离键。该配置不构成服务器授权。生产 POC 应将示例 request 换成已有认证客户端，并沿现有 Service/Make Gateway 转发公共接口。
|
|
8
8
|
|
|
9
|
-
当前 Make App 后端只支持文本模型输入；示例的 modelInputKinds 为 `["text"]
|
|
9
|
+
当前 Make App 后端只支持文本模型输入；示例的 modelInputKinds 为 `["text"]`，但仍保留统一的“上传文件或图片”入口。服务端必须根据消息 parts 和实际模型能力校验媒体类型；不要以原件存储或读取能力判断模型已经支持输入。
|
|
10
10
|
|
|
11
11
|
详见 [接入说明](../../docs/make-app-integration.md)。正式发布仍由原仓库 GitLab CI 负责。
|
package/package.json
CHANGED