版本记录
这里记录 @openhex-ai/agent-sdk 每个版本面向使用者的变化。 升级前先看一眼有没有需要你改代码的地方。
npm install @openhex-ai/agent-sdk@latest
查看当前安装的版本：npm ls @openhex-ai/agent-sdk。
0.5.0
新增能力，全部向后兼容，无需改代码。
- Agent 产出的文件：新增
extractFileAttachment，以及client.files.readConversationFile/downloadConversationFile。React 组件把 Agent 写出的文档渲染成可下载的卡片，useOpenhexChat新增downloadAttachment。见附件。 - 语音回复：新增
client.chat.messageAudio、MessageAudioCache、downloadMessageAudio；组件新增朗读按钮（showAudioControls、autoPlayAudio、audioLabels），Hook 新增playAudio/stopAudio/audioPlayback。见语音回复。 - 信息收集卡片：新增
extractInfoCollect、isInfoCollect、infoCollectSubmitMetadata、infoCollectSkipMetadata；组件内置渲染与提交，新增InfoCollectCard与infoCollectLabels。见信息收集卡片。 - 子 Agent 与委派：新增
extractDelegations、isDelegationTool；消息新增agent与delegations，组件新增showSubAgent/subAgentRenderer。见子 Agent 与委派。 - 工作区读取 Agent：
listAgents/getAgent。见读取 Agent。 - 新对话：发送请求支持
newConversation；<ChatWidget>头部新增「新对话」按钮（newConversationLabel），header支持函数形式拿到newConversation动作。见React 组件。 - 主题：新增
tokens属性与PLATFORM_TOKENS预设，可覆盖全部设计变量。 - 思考过程：
chat.stream/chat.history支持includeThinking。
安全与修复：
- 凭据只会发往
baseUrl所在域名；把其他域名的完整 URL 交给底层请求会被拒绝。 - 修复 React StrictMode 下历史记录加载不出来的问题。
- 修复附件卡片显示的名称是模型生成的图片描述、而不是文件名的问题。
- 修复训练对话在回放元数据之后无法继续的问题。
- 输入框与消息列表的滚动、输入行为与网页端保持一致。
0.4.1
- 修复嵌入网页时，在聊天组件里滚动会带动宿主页面滚动的问题。
0.4.0
- 附件：
client.files.upload/uploadPart，发送时带parts；组件支持选择、粘贴、拖拽上传。 - 支付宝收款卡片：
extractPaymentGate、extractPaymentResolution、client.payments.status、PaymentGateCard。 - 会话级 MCP 凭据：
mcpTokens；连接器配置卡片：extractConnectorSetup、submitConnectorSetup。 - Agent 回复中的 Markdown 与图片渲染。
0.3.0
workspace.startVisitorSession：一次调用完成成员开通与会话签发。
0.2.x
- 组件
persist：刷新页面后续上同一段对话。 - 恢复历史时同时显示用户自己发出的消息。
0.1.0
- 首个公开版本：对话 API、React 聊天组件、工作区 API。