HanaAgent 1.0.0-beta

从 0.450 到 1.0 beta，HanaAgent 的变化不只是增加了几件工具。这一阶段，我们把聊天、卡片、应用和后台任务进一步连在一起：聊天里生成的内容可以留下来继续使用，扩展有更清楚的安装与授权过程，多 Agent 分工也更容易跟进和调整。

这是一份面向 0.450 用户的完整升级说明。1.0 beta 将以完整安装包提供，你不需要为了升级而逐个安装中间版本。

本次重点

• 卡片式页面：自由排布、无限组合、自定义生成。 把聊天、文件、终端和应用放到同一张工作台上，按任务组织你的软件页面。
• Agent Showcard：让回答变成可以操作的成果。 Agent 可以生成带交互界面的卡片，连接已获授权的工具，并保留使用状态。
• 新一代 App 扩展系统。 新扩展统一通过 Hana App Creator 制作，以明确的能力声明和授权接入 Hana；你也可以查看和管理 App 携带的内容。
• 更好跟进的多 Agent 协作。 子 Agent 的任务有更清楚的状态，正在执行的工作可以接收补充指令，不必每次都重新开一个任务。
• 更连贯的聊天输入。 忙碌时的消息排队、运行中的补充引导、取消后的收尾，以及账号和会话切换时的输入归属，都得到进一步完善。
• 工具可以组合使用。 Codemode 让 Agent 在隔离环境中串联当前会话已经可用的工具，完成需要多步处理的工作。

卡片式页面：自由排布、无限组合、自定义生成

聊天、终端、浏览器、文件预览和 App 卡片可以在黑板上自由排布，按任务组合成你自己的工作页面。你可以拖拽调整布局、分屏对照，把卡片拆成悬浮小窗，或切到全屏专注处理一件事；一页放不下，就继续组织新的页面。

页面不必套用固定的软件布局。已有卡片可以重新组合，需要新的内容或交互时，也可以让 Agent 自定义生成，再放进工作台。这一阶段进一步整理了卡片的标题栏、视图和进度呈现，让不同来源的内容更容易放在一起使用。

会话卡与工作进度卡的呈现更加统一，任务信息也更紧凑。后台任务的显示控制收进对应的任务菜单，阅读正文时更少被临时状态打断，需要查看进度时仍然找得到入口。拆出的预览窗口也改进了阅读位置和标题栏按钮的稳定性。

Agent Showcard：让回答成为可操作的成果

Agent 会说，也会做；Showcard 让它把成果直接展示成可以操作的界面。一条回答可以长成待办、天气、钢琴或报表卡片，你可以在里面点选、输入和继续处理，而不只是读完一段文字。

Skill 教 Agent 如何做事，Showcard 为成果提供交互界面，并连接 Agent 的工具。它是一份可传递的交互式 HTML 卡片文档，不需要为了每一张卡安装一个完整插件。卡片可以保存状态，在 Hana 中取到黑板上长期使用，也可以导出分享；每份副本独立使用，不会因此携带你的凭据或原来的批准。

工具和资源访问仍由你决定。卡片只能通过宿主调用已声明、已获授权的能力，展示形式不会扩大它的权限。

互动卡片打开后可以接着用

聊天卡片不只是展示一张结果图。你可以在卡片里调整输入、切换视图或继续交互；卡片呈现时保持可用，状态由宿主保存，减少切换、重挂载或重启后重新填写的情况。

从聊天中把卡片取到工作台上时，会带上正在使用的状态。卡片标题变化也不再需要把整张卡片重新挂载，输入法编辑和卡片输入的连续性得到改善。

卡片中的发送操作会确认它属于哪条真实消息、哪个账号和哪个会话。切换会话、退出或连接失效后，不会因为旧回执迟到而自动重发未确认的内容，让互动卡片与普通聊天遵守一致的发送边界。

内容展示更稳定

天气卡片在加载时预留完成后的高度，减少内容出现时的跳动；图片查看器的滚轮与触控板缩放得到修复。卡片文档与视图的恢复也进一步完善，让已有内容更容易接续使用。

Hana Folio：让内容更好地呈现

Hana Folio 基于 Showcard 卡片底座，将文字、图片和表格组织成排版精美的文稿与演示文稿（slide deck）。从梳理想法到呈现成果，让 Agent 帮你把内容做得清楚，也做得好看。

新插件系统：统一为 App，安装与管理更清楚

新扩展使用 App

Hana 的新扩展路线统一为 v2 App。App 在安装和首次装载时声明自己提供什么、需要哪些能力，由 Hana 管理授权、运行和回收。它可以提供工具、设置页、卡片和其他已公开的界面入口，进入与你日常工作一致的宿主体验。

制作入口统一为 Hana App Creator，开发者使用官方 App SDK。新的制作与分发不再围绕旧版插件接口展开，也不需要让用户为每个 App 临时安装一套服务器依赖。

一个入口管理扩展与市场

App、Skills、配方、连接器、角色和扩展包进一步进入统一的扩展管理流程。安装记录、来源、启用状态和可更新项集中呈现，减少在不同设置页之间来回寻找。

扩展市场支持搜索和按类型、来源筛选，也可以管理自定义来源。安装与更新会核对下载内容的摘要，并在落地前展示确认过程；市场里出现一个条目不等于它已经获得运行权限。已有本地安装仍有明确的来源和管理入口。

技能与配方更新时保留自己的修改

内置技能与配方按内容检查更新。需要修改官方内容时，可以做一份可编辑的副本；对于 App 提供的 Skill，可以查看应用版本与保留的用户版本，并明确选择使用哪一份。自己的定制与官方更新不再混成一份难以判断来源的内容。

外部技能目录也可以在扩展设置中管理显示范围。隐藏目录只影响列表呈现，不会悄悄停用 Agent 已启用的技能；各 Agent 的实际启停仍按对应能力设置管理。

安装的每一步都有明确结果

扩展安装支持后台执行和进度呈现，确认、取消、成功、失败以及结果尚未确认都有对应状态。重复点击不能重放同一安装尝试；取消后的审批等待也不会继续执行原本被拦下的操作。

你能更清楚地判断：现在是在等待确认、正在安装，还是需要重试。系统不会把“不知道结果”当作已经成功，也不会因界面刷新自动替你再执行一次。

App 携带的内容可以管理

App 不只贡献一个工具入口，也可以携带 Skills、角色等内容。新的管理界面让这些内容更容易查看和处理；对随 App 提供的 Skill 做定制时，原有版本和定制边界也有相应管理。

对于开发者，App SDK 同时提供宿主认可的服务端、界面和控件入口。轻量 HTML 页面也可以使用预构建的官方控件，不必为了一个设置页先搭建完整的前端工程。

已安装的旧插件继续兼容

v1 插件是冻结的兼容层：已安装的插件继续保留运行与管理能力。新的扩展制作、作者工具和 SDK 分发走 App 路线。升级到 1.0 beta 不意味着要求你重新制作所有旧插件。

多 Agent 协作：分工之后，还能继续调整

更清楚地查看任务进度

主 Agent 可以把工作交给子 Agent，再继续处理其他事情。任务列表按子 Agent 线程呈现，后台任务状态与完成结果的收尾进一步统一，减少重复条目、残留“运行中”状态，以及等待结束后无法继续的问题。

后台任务在聊天中的位置和显示方式也经过整理，方便你把具体分工与发起它的对话联系起来。需要细看时可以打开预览，查看后再回到原来的阅读位置。

运行中可以追加同一任务的指令

工作已经开始后，仍可以给正在运行的子 Agent 补充要求或修正方向。指令在当前任务的安全处理步骤中读取，不会为了追加一句说明再创建一个独立任务。

如果任务已经结束或取消，继续工作会走后续任务入口；过期任务或不属于当前会话的任务不能接收这条指令。追加说明也不是新的权限批准，不会替代本来需要你确认的操作。

模型与思考设置更明确

创建或继续子 Agent 工作时，可以明确指定模型和思考设置。模型标识的显示和参数检查进一步完善，避免模糊名称造成误选，也让不合法的设置得到明确反馈。

这些改进让协作更适合真实的长任务：先分工、观察进度、及时补充要求，再把结果接回来，而不是只能等待一次不可调整的调用结束。

聊天、文件与工具：减少来回打断

消息排队与运行中引导

会话忙碌时发出的消息有明确的排队过程；回复进行中也可以补充信息、调整方向。取消会跟随原来的请求收尾，关闭或中止会话时，排队中的输入也会相应清理。

输入草稿、模型列表和聊天显示缓存进一步按账号、会话与连接状态隔离。切换账号或会话后，迟到的旧读取不会覆盖当前状态；发送时也会再次确认当前会话的模型选择。

更容易找到会话、接续之前的工作

会话列表增加按 Agent 查看和分页呈现，聊天积累较多时，不必把所有记录同时堆在一个列表里。不同 Agent 的查看状态有自己的归属，切换时更容易保持你正在处理的上下文。

新对话里继续之前的话题时，Agent 可以通过历史会话检索找回相关线索，再读取需要的内容。这个过程不是把所有旧聊天自动塞进新会话，检索与读取仍遵守当前可访问范围。

交付文件与过程文件分开呈现

会话文件面板区分交付物与中间文件，查找 Agent 最终交给你的内容更方便。已有图片和媒体的预览、相邻内容切换以及阅读操作继续保留，不需要为了看一个结果离开当前工作。

安装包内 Word、Excel 预览的相关问题得到修复；书桌中已展开的文件夹被外部删除后，也减少了反复读取不存在路径和重复报错的情况。

书桌与目录交付更方便

书桌提供切换浏览目录和目录收藏入口，方便在常用项目之间查看文件。选择浏览位置与赋予访问权限是两件事，切换目录不会自动放宽 Agent 的文件权限。

交付内容可以是一整个目录。文件面板按需要把目录整理为 ZIP 下载；通过支持文档投递的 Bridge 发送目录时，也可以交付压缩包，让多文件成果更容易带走，而不必逐个点选下载。

文件预览进一步接入 App 提供的文档视图和编辑器，并增加 3D 模型预览入口。支持的文档可以在对应视图中保存和继续处理；具体可用格式由实际预览器和 App 决定，不要求所有文件都采用同一种呈现方式。

终端协作由你决定何时执行

你手动打开的终端，与 Agent 自己启动的任务终端有清楚的边界。Agent 可以查看当前会话中你的终端信息和输出，也可以递交执行建议，但不会直接替你往用户终端里输入命令。建议会作为确认卡片呈现，由你决定运行或忽略。

聊天中已经完成的 Shell 代码块增加“在终端中执行”入口。点击后先展示完整命令和实际工作目录，确认才会打开独立终端窗口执行；取消不会运行，窗口未能打开也不会在后台偷偷启动命令。

Codemode：把多步工具工作连起来

对“先检索、再筛选、最后整理”这类任务，Agent 可以在一次隔离脚本中组合当前会话的工具，处理工具返回的数据并给出结果。普通的单工具调用仍然可用。

脚本本身不能直接读取文件或访问网络，实际操作仍通过已有工具执行，保留参数检查、会话权限和审批。取消会阻止后续调用；已经执行的操作不会被自动回滚，重要操作仍需要按原有规则确认。

模型与服务配置：更容易选，也更容易了解使用情况

常用模型可以收藏

模型收藏在不同选择入口之间共用，不必在每个会话、频道或设置页重新寻找常用模型。模型信息与可用列表的刷新也得到整理，让选择器更贴近当前服务真正提供的能力。

对于支持目录发现的服务和 OAuth 订阅，Hana 会使用对应来源获取模型列表，而不是把一次发现结果永久变成手工维护的清单。你仍可以隐藏不需要的条目或补充单个模型。已有本地 Codex 登录也提供复用入口，减少重复配置；是否可用仍取决于实际登录状态和服务权限。

服务提供方的表单、模型验证与媒体设置进一步统一。带斜杠的模型标识可以由 App 正常调用，子 Agent 的模型和思考设置也会明确检查，而不是默默选择另一个模型。

查看已记录的模型用量

用量页面提供按日期、模型和使用类别查看的统计与请求记录，日汇总可以持续保留。个人页面也能查看已记录的 Token 活动，帮助你了解使用变化。

统计缺少信息时会说明不完整，未知用量不会被当成零。这里反映的是 Hana 已记录的数据，费用和账单仍以服务提供方为准。

图像与音频：结果之外，也能看清生成过程

图像生成有更明确的请求与结果记录

图像生成进一步整理了参考图、生成与编辑模式、画布和质量选项的处理。涉及 Codex 图像服务的请求可以按支持的接口路线执行，结果保留这次请求的设置和服务实际返回的证据，方便生成后复查。

请求使用的模型名称，与服务实际报告的模型分开记录；服务没有报告时，不会编造确认结果。尺寸或质量与请求不一致时，也会保留图片并标明差异，避免把“请求过”写成“实际做到”。

取消和重试按每次生成尝试处理，旧尝试不会因为迟到的回调影响新的任务。并发与排队也有明确控制，取消排队中的请求不会在稍后重新启动它。媒体预览与结果归属一起整理，让生成的文件更容易回到正确会话。

语音与音频播放

语音生成增加了豆包相关能力，音色选择更明确，生成的音频可以在聊天中直接播放并按组呈现。语音转录也可以配置对应模型，让不同服务的语音能力按实际配置使用。

这些能力仍需要对应服务的可用配置；更新不会替你开通付费服务或改变已有账号授权。

记忆与持续工作

每个 Agent 的新聊天记忆偏好可以分别保存，切换 Agent 时沿用对应选择，减少反复调整。记忆是否参与一段新对话有更明确的选择，不影响各 Agent 原本独立的身份和内容。

定时任务与心跳继续承担对话之外的工作。这个阶段重点完善后台任务的等待、恢复、通知和收尾：已完成结果不会因为后续阶段超时被改写，主动取消也不会被记录成整轮完成。长期任务的状态和结果与聊天中的显示进一步对齐。

权限与可靠性改进

授权记录可以查看和撤销

权限设置集中展示 App、卡片和连接器等能力的授权记录，方便判断谁获得了什么访问权，并撤销不再需要的允许。操作审批结合真实目标和可信证据，避免仅凭工具显示名称作决定。

自动审核规则支持用自然语言表达“先询问”或“自动允许”的政策；先询问具有优先级，规则不是一个可以无限放宽权限的总开关。审核反复失败时会暂停自动审核并说明状态，不会把失败当作批准。需要你确认的操作仍保持明确的确认过程。

命令联网与升权的边界更明确

在 macOS 和 Linux 上，启用操作系统沙盒后，默认命令仍在隔离环境中执行，并默认隔离网络。需要联网或越过该沙盒限制的命令，会走逐条审批的升权流程；批准后在宿主执行，原有应用层文件访问检查和禁止操作规则仍然生效。

旧的“沙盒联网”开关已移除，因为它已不再控制实际命令的网络行为。Windows 命令沙盒采用写隔离方式，网络按当前用户权限运行，并不提供与 macOS、Linux 相同的网络隔离。各平台的边界会明确说明，不通过关闭整个沙盒来处理联网需求。

执行与显示正确收尾

• 审批展示进一步关联真实操作证据，等待中的审批更容易识别。
• 无人响应的权限确认明确记为超时，不再等同于用户拒绝。
• 取消后的审批与 Computer 操作准备不会继续越过原来的等待边界。
• 终端被直接关闭后，对应命令正确收尾，不再长期残留“运行中”。
• 心跳巡检某个阶段超时，不会反写已经完成的执行结果。
• App 卡片、服务观察与发送状态进一步绑定真实归属，减少切换后旧状态影响当前界面的情况。

这些改进保持原有授权边界。新的卡片、App 和工具编排能力都不会自动获得更高权限。

从 0.450 升级

本次提供 Project 1.0 beta 完整安装包，不需要先安装 0.6xx 或其他中间版本。请在更换安装包前退出旧应用，并保留现有数据的备份。

这是 beta 版本，旧稳定渠道不会因为本次发布而切换为 beta。请在公开 Release 页面下载对应平台的完整安装包，退出旧应用后再更换。升级会保留已有聊天与配置；如遇恢复提示，请按提示使用备份与找回入口。

Windows 安装包沿用未签名发行，可能出现“未知发布者”提示。本次不声明 Authenticode 有效签名；请从正式 Release 下载并核对提供的 SHA256，保持系统安全功能启用。

Linux 仍按 Preview 平台提供。各平台实际下载项以正式 Release 资产为准。这里不包含 Cloud 或 Expo 原生手机客户端的更新。

下载说明 / Download note

请下载本页提供的桌面安装包。GitHub 自动生成的 “Source code” 压缩包对应公开仓库的历史代码，并非本次 beta 安装包的源码。

Use the desktop installers attached to this release. GitHub-generated “Source code” archives contain the historical public repository snapshot, not the source for these beta binaries.