# Cube Agent > HarmonyOS 原生 AI 工作台。本文档对应 2.2.0 正式版（构建 2002007），内容基准 2026-11-07；不要据此断言邀测版或后续版本的能力。 ## 阅读方式 - 先按目录找到相关主题，再读取主题正文。按问题给出入口、步骤、前提与限制，不必一次读完整本说明书。 - 每篇主题提供公开 Markdown，无需登录或在 Cube Agent 内调用工具。正文中的 use_skill、工具名和虚拟 help/ 路径属于应用内操作，不是此网站的 HTTP API。 - 不确定版本时先问用户安装版本。文档没有说明时明确缺少依据，不推测入口、权限、费用或配额。配额、模型与权益以应用内实时显示及所选服务商说明为准。 - 本站仅提供公开产品帮助，不提供访问用户配置、知识库或凭据的接口。 ## 入口 - [可浏览的使用文档](https://cubeagent.app/docs/) - [Markdown 主题目录](https://cubeagent.app/docs/index.md) - [完整说明书](https://cubeagent.app/llms-full.txt) ## 主题 - [免费模型试用有多少次，怎么用？](https://cubeagent.app/docs/free_trial.md)：无需 API Key；当前可用次数以会员中心实时显示为准 - [Cube 使用助手是什么？](https://cubeagent.app/docs/cube_app_guide.md)：随时询问应用怎么用，并分清它和服务商管理智能体的职责 - [添加第一个模型](https://cubeagent.app/docs/add_model.md)：服务商、Header 模板与模型同步 - [没有 API Key 怎么办](https://cubeagent.app/docs/no_key.md)：需到模型服务商官网申请 - [回复慢、答得不好、生不了图，是应用的问题吗？](https://cubeagent.app/docs/model_decides_quality.md)：应用负责工具和体验，回复的快慢和质量主要取决于所选模型 - [会员中心与 Pro](https://cubeagent.app/docs/membership_pro.md)：购买、兑换、恢复与 Pro 权益说明 - [反馈与建议](https://cubeagent.app/docs/feedback_center.md)：加入 QQ 群交流,或在线提交可追踪进度的反馈 - [自定义主页入口](https://cubeagent.app/docs/home_tabs.md)：把知识库、生图、收藏放到主页，最多 5 个入口 - [桌面卡片与 PC 关闭方式](https://cubeagent.app/docs/desktop_cards.md)：继续对话、余额卡片与收起至托盘 - [收藏对话、消息与图片](https://cubeagent.app/docs/favorites.md)：统一聚合、搜索、预览与批量管理 - [Cube 随行怎么显示、隐藏和切换任务？](https://cubeagent.app/docs/cube_companion.md)：小方块或三点、握姿停靠、显示范围与远程工作 - [Cube 形象库怎么用？](https://cubeagent.app/docs/cube_appearance_library.md)：挑选方豚等形象、导入形象文件，并与聊天主题搭配 - [本地文件夹怎么交给 AI 使用？](https://cubeagent.app/docs/folder_mounts.md)：Pro 目录授权、子目录管理、AI 保存与删除确认 - [怎么把 NAS 或网盘接进对话？](https://cubeagent.app/docs/webdav_mounts.md)：Pro WebDAV 网络存储：坚果云、群晖、Nextcloud、AList 等，配置一次即可读写 - [文件空间与我的分享](https://cubeagent.app/docs/file_space_shares.md)：管理脚本产物、对话分享与站点发布 - [怎样快速找到设置](https://cubeagent.app/docs/settings_search.md)：关键词、别名、拼音检索并直达功能 - [Cube 官方搜索怎么用？](https://cubeagent.app/docs/official_search.md)：不填 API Key 也能联网；了解开启入口、聊天使用和实时额度 - [GPT / DeepSeek / Gemini 内置搜索怎么开](https://cubeagent.app/docs/builtin_search_gpt_deepseek_gemini.md)：官方内置搜索与外部搜索服务的配置区别 - [哪些事可以让 AI 替你做？](https://cubeagent.app/docs/ai_agents_overview.md)：配服务商、查余额、接生图、设计主题、存技能与笔记——说清楚需求即可，写入前都需确认 - [如何配置和测试应用内代理？](https://cubeagent.app/docs/app_proxy_settings.md)：HTTP、SOCKS5 认证与绕过列表 - [如何测试模型连接与能力？](https://cubeagent.app/docs/provider_connection_tests.md)：选择模型，分别验证普通回复、流式输出、工具调用或向量数据 - [如何分享或导入服务商？](https://cubeagent.app/docs/provider_share_import.md)：二维码或分享码传给他人，含 API Key 时才需要密码 - [AI 服务商管理是什么？](https://cubeagent.app/docs/provider_ai_management.md)：用对话检查配置、测试连接、获取模型，并比较服务商或套餐 - [服务商余额查询怎么配置？](https://cubeagent.app/docs/provider_balance.md)：模板一键配置，支持 GET/POST 覆盖与专用余额 Key，也可让 AI 帮你调好 - [默认模型的任务角色](https://cubeagent.app/docs/roles.md)：聊天、标题、推荐、翻译、OCR、文档解析、图像与向量化 - [服务商、默认模型和助手模型有什么区别？](https://cubeagent.app/docs/provider_default_assistant_models.md)：先接入模型，再为任务指定默认值，最后按助手覆盖 - [如何导入和使用世界书（Pro）？](https://cubeagent.app/docs/worldbook.md)：导入条目、检查兼容性，再挂载到助手 - [Skill、知识库、系统提示词和记忆怎么选？](https://cubeagent.app/docs/assistant_capability_compare.md)：规则每轮生效、方法按需读取、资料可检索、偏好长期保存 - [系统提示词](https://cubeagent.app/docs/system_prompt.md)：设置默认提示词，了解助手与对话的覆盖关系 - [如何设置提示词注入规则？](https://cubeagent.app/docs/assistant_prompt_rules.md)：按角色、位置和顺序补充要求，独立启停并复用变量 - [如何让助手先开口？](https://cubeagent.app/docs/assistant_opening.md)：固定开场白、模型生成、自动开始与手动重试 - [环境变量是什么，怎么使用？](https://cubeagent.app/docs/assistant_environment_variables.md)：安全保存助手要用的 API Key，并了解何时会发送给模型 - [知识库挂载](https://cubeagent.app/docs/knowledge_base.md)：全量灌入、@Depth 与按需检索 - [知识库“建立语义索引”是做什么的？](https://cubeagent.app/docs/knowledge_indexing.md)：它不会修改原文；不建立索引也能用，但语义召回会受限 - [如何让 AI 操作网页？](https://cubeagent.app/docs/agent_browser.md)：Pro · 实时查看网页、随时接管、登录后继续，并保存网页资源 - [内置模型在部分地区连接失败怎么办？](https://cubeagent.app/docs/builtin_network.md)：自动使用加密 DNS 兜底，保留原域名与证书验证 - [工具中心与联网搜索](https://cubeagent.app/docs/tools.md)：联网搜索、MCP、JavaScript 执行与助手工具开关 - [怎么让 AI 在手机上运行 Python？](https://cubeagent.app/docs/python_runtime.md)：内置 Python 3.12，处理表格、画图、生成文档，技能和 MCP 也能本机运行 - [如何生成 Word、Excel 和 PPT 文件？](https://cubeagent.app/docs/office_generation.md)：无需 Pro，用对话生成报告、会议纪要、预算表和计划表 - [技能中心与助手技能](https://cubeagent.app/docs/skills.md)：管理 Skill,并按助手启用 - [助手记忆与全局记忆](https://cubeagent.app/docs/assistant_memory.md)：自动读取、缓存策略与记忆迁移 - [如何自定义会话头像和模型标识？](https://cubeagent.app/docs/session_avatar_and_model_badges.md)：单个会话设置形象，列表显示当前模型 - [聊天失败后如何自动重试？](https://cubeagent.app/docs/chat_retry_policy.md)：网络、服务异常与限流分别设置，查看倒计时或停止 - [如何全屏编辑草稿和修改待发送消息？](https://cubeagent.app/docs/composer_and_queue.md)：展开长草稿，修改队列中的正文与附件 - [怎么让 AI 直接用某个文件或技能？](https://cubeagent.app/docs/chat_mention_files_skills.md)：输入框 @ 引用文件，/ 指定本轮技能 - [怎么查看 AI 改了哪些文件？](https://cubeagent.app/docs/chat_turn_changes.md)：回复末尾的「本轮改动」卡片，可展开看行级改动 - [如何按助手筛选对话列表？](https://cubeagent.app/docs/conversation_assistant_filter.md)：标题卡片切换浏览范围，新建默认助手另行设置 - [如何多选对话？](https://cubeagent.app/docs/conversation_multi_select.md)：从对话列表标题菜单进入批量选择 - [如何增强提示词并恢复原句？](https://cubeagent.app/docs/chat_prompt_enhancement.md)：模型与风格、预览编辑、替换和撤销 - [粘贴的长文本为什么变成附件？](https://cubeagent.app/docs/chat_long_text_paste.md)：转换阈值、预览、撤销与放回输入框 - [单条回复的缓存命中率怎么看？](https://cubeagent.app/docs/chat_cache_hit_rate.md)：输入用量、缓存数量与有效数据范围 - [如何使用和排序提示词库？](https://cubeagent.app/docs/chat_prompt_library.md)：自建、收藏、排序、导入导出与工具栏入口 - [无痕对话](https://cubeagent.app/docs/incognito_chat.md)：只存在于此刻的对话:不进历史、不写记忆,离开即销毁。 - [需要验证的助手](https://cubeagent.app/docs/private_assistant.md)：切换到指定助手前,先验证锁屏密码或指纹人脸。 - [推荐后续问题](https://cubeagent.app/docs/suggestions.md)：按应用语言生成可继续追问的问题 - [移动对话到助手](https://cubeagent.app/docs/move_assistant.md)：调整会话归属，不移动记忆 - [如何使用 MiMo 音色朗读？](https://cubeagent.app/docs/speech_readaloud.md)：系统语音、云端 TTS、音色设计、样本复刻与试听 - [如何归档和恢复对话？](https://cubeagent.app/docs/conversation_archive.md)：收起暂时不用的会话，筛选、批量归档与恢复 - [如何压缩上下文？](https://cubeagent.app/docs/context_compression.md)：手动与自动压缩、近期原文三档、查看摘要、清除上下文 - [附件与按需读取](https://cubeagent.app/docs/attachments.md)：适用场景、读取时机与原有用法 - [大文件和资料该放在哪里？](https://cubeagent.app/docs/where_to_put_files.md)：附件、会话文件、文件夹与知识库各自适合什么 - [文档解析与 OCR](https://cubeagent.app/docs/documents_ocr.md)：解析 PDF、PPTX、扫描件和图片文字 - [输出统计与使用统计](https://cubeagent.app/docs/usage_stats.md)：查看消息、会话和全局 token 用量 - [两种生图方式的区别](https://cubeagent.app/docs/image_paths.md)：对话内生图 vs 独立绘图工作台 - [如何把其他应用的内容分享给 Cube？](https://cubeagent.app/docs/system_share.md)：接收文字、链接、图片和文件，转发到当前对话或新建草稿 - [分享对话](https://cubeagent.app/docs/share.md)：导出为图片、PDF、网页、Markdown 或文本 - [对话分享（云端）](https://cubeagent.app/docs/conversation_share.md)：把对话发布成可分享的链接或网页文件 - [拖拽输入](https://cubeagent.app/docs/drag_drop.md)：从相册、网页、中转站拖入文本与图片 - [公式预览](https://cubeagent.app/docs/formula_preview.md)：点击放大查看复杂公式 - [文生图 / 图生图 / 图库](https://cubeagent.app/docs/workspace.md)：画布、灵感、参考图、4K 与收藏 - [图片预览如何使用超清增强？](https://cubeagent.app/docs/image_super_resolution.md)：小图增强、原图对比、保存与分享；无需 Pro，需支持的 API 26 设备 - [接入自己的生图模型](https://cubeagent.app/docs/image_model_setup.md)：从 API Key 到出图，含阿里云百炼示例 - [AI 生图接入是什么？](https://cubeagent.app/docs/recipe_onboarding.md)：用对话把任意生图接口变成工作台可用的配方 - [生图配方怎么设计好用？](https://cubeagent.app/docs/recipe_best_practice.md)：三条接入路径怎么选；参数、尺寸、参考图与异步任务的设计取舍 - [云空间同步和数据备份有什么区别？](https://cubeagent.app/docs/cloud_sync_experimental.md)：配置同步默认关闭，完整数据仍使用备份 - [数据备份](https://cubeagent.app/docs/backup.md)：本地导出导入 · 华为云盘 / WebDAV / SMB 备份 - [如何使用碰一碰传送？](https://cubeagent.app/docs/nearby_transfer.md)：实验性 Cube 传送包：两端确认、接收导入与文件分享备用方式 - [导入第三方备份](https://cubeagent.app/docs/foreign_import.md)：支持 Cherry Studio、RikkaHub、Kelivo - [存储管理](https://cubeagent.app/docs/storage_management.md)：查看占用与清理冗余文件 - [诊断与崩溃日志](https://cubeagent.app/docs/diagnostics.md)：查看、导出或分享异常报告 - [如何连接 SSH 服务器？](https://cubeagent.app/docs/ssh_connect.md)：添加主机、密码或私钥认证，以及聊天中的远程连接工具 - [如何浏览和传输远端文件？](https://cubeagent.app/docs/sftp_files.md)：SFTP 上传下载、传输记录、覆盖确认和聊天附件 - [终端字体、粘贴和组合键怎么设置？](https://cubeagent.app/docs/ssh_terminal.md)：专注与横屏、8–24 字号、终端按键和多行粘贴 - [SSH 审批、始终允许和输出外发有什么区别？](https://cubeagent.app/docs/ssh_approval.md)：每次确认、独立模型审批、主机始终允许，以及 token 消耗 - [切后台会断开吗？如何通过 Tailscale 连接？](https://cubeagent.app/docs/ssh_network.md)：短时后台保护、断线恢复和 VPN 连接排查 - [Web 服务器](https://cubeagent.app/docs/web_server.md)：用浏览器访问本机会话与模型 - [桌面 Agent 迁移](https://cubeagent.app/docs/desktop_agent_migration.md)：让 Claude Code、Codex 直接写入记忆与提示词 - [公网与远程访问](https://cubeagent.app/docs/web_remote_access.md)：密码、JWT、IPv6、域名与局域网发现 - [浏览器聊天端](https://cubeagent.app/docs/web_chat.md)：会话、工具、MCP 与连接复用 - [工作目录](https://cubeagent.app/docs/script_workspace.md)：预览脚本产物并发布公网静态站点 - [外观个性化](https://cubeagent.app/docs/appearance.md)：模式、配色、字体、Markdown 排版 - [聊天输入设置](https://cubeagent.app/docs/input.md)：发送方式、推荐问题、自动跟随、屏幕常亮、HTML 预览 - [如何使用消息导航？](https://cubeagent.app/docs/message_navigation.md)：逐条跳转、自动显隐与拖动位置 - [如何切换桌面图标？](https://cubeagent.app/docs/desktop_icon.md)：刷新可用图标、切换与恢复默认 - [使用屏幕朗读时，怎样操作更方便？](https://cubeagent.app/docs/accessibility.md)：会话菜单、按钮名称与状态提示 - [智感握姿](https://cubeagent.app/docs/hand.md)：识别握持手,优化单手操作 --- # 免费模型试用有多少次，怎么用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/free_trial/ ## 先说答案 免费模型试用是随账号发放的**一次性**对话额度，不是每天或每月自动恢复的长期免费套餐。当前可用次数、单位和支持的模型由在线服务实时下发；打开 **设置 → 会员账号卡 → 会员中心 → 本期额度 → 免费模型试用**，这里显示的余额就是你的实际可用量。无需 API Key,注册即赠送一次性对话额度,可以直接体验建对话、用助手、试技能和联网搜索。 ## 怎么用 如果你在首次启动的引导里选了「我是第一次用这类工具」,应用已经替你配好了: - 对话模型指向内置的 **Cube 试用** 服务商。 - 标题生成、推荐提问、翻译这些辅助能力也一并配好;压缩上下文直接跟随对话模型。 - 若试用额度包含向量模型与视觉模型,**知识库与识图也会一并配好**,无需自备 `API Key` 即可使用。 直接回到对话页开始聊天即可,不需要填任何东西。 ## 在哪看剩余额度 打开 **设置** 顶部的会员账号卡进入 **会员中心**,在「本期额度」里可以看到「免费模型试用」的当前余额和单位。活动赠送、补充额度或服务规则调整会直接反映在这里；这份余额**不随日/月周期自动重置**,用完即止。 ## 模型从哪来 模型来自官方渠道或官方中转,不是来路不明的共享账号。请求由客户端发往 Cube Agent 在线服务网关,再由网关转发到上游模型;上游密钥由服务端持有,不会下发到你的设备。 同理,应用内所有**预置服务商的接口地址都是该服务商自己的官方域名**——模型厂商官方接口(如 DeepSeek 的 `api.deepseek.com`)或官方聚合/中转平台的官方地址。你填入的 `API Key` 只会发往你选定的那一家,应用不会再插一层自己的中转。 ## 试用额度如何持续维护 帮助中心中的部分服务商注册链接属于作者邀请渠道。用户通过这类链接加入并完成对应活动要求后,作者可能获得服务商发放的模型使用额度；**作者获得的这部分额度将用于补充 Cube Agent 内置免费试用,承担新用户体验期间的模型调用成本**。 使用邀请链接不会增加你的套餐价格,也不是使用 Cube Agent 的前提。是否发放、奖励金额、有效期和使用限制均由对应服务商决定,以活动页面的实时规则为准。 ## 需要注意 - 额度按华为账号发放,需要先连接在线服务登录。 - **不保证 100% 可用**:免费试用依赖上游服务,不保证 100% 可用,偶尔可能失败或变慢；本地功能和你自己配置的模型不受影响。如果你对稳定性有要求,请配置自己的 `API Key`。 - 免费试用为单次请求设置了输入长度上限,超长的文档请用自己的 `API Key`。 - 请求过于频繁时会被限流,稍等几秒重试即可。 - 内置的 **Cube 试用** 服务商没有可填写的接入参数(地址与密钥由云端管理),所以它的详情页里看不到 `Base URL` 和 `API Key` 输入框,这是正常的。 ## 用完之后 **免费额度是试用品,不是长期免费的承诺。** 试用用完后需要自己的 API Key 或订阅套餐。想低成本按量可看 DeepSeek；拿不准时去服务商管理点“让 AI 帮我配置”。用完后应用不会停止工作,本地功能与你自己配置的模型都照常可用。 --- # Cube 使用助手是什么？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/cube_app_guide/ ## 它是做什么的 **Cube 使用助手**是应用内置的陪伴式帮助角色。你可以直接问它“这个功能是什么”“两种设置有什么区别”“入口在哪里”“我该怎么选”，它会先读取与帮助中心同步的 `app-help` 资料，再根据当前版本的说明回答。 它适合解释知识库、技能、记忆、环境变量、模型角色、备份和其它应用功能。它不是独立的模型服务，回答仍需要一个可用的聊天模型。 ## 从哪里打开 - 在 **帮助中心** 顶部点击 **直接问 Cube**。搜索不到结果时，也可以把原问题预填给它，由你确认后再发送。 - 在首页 **助手** 页选择 **Cube 使用助手**，像普通助手一样开始对话。 主动新建普通对话时，内置助手会先显示固定欢迎语。这条欢迎语不调用模型；你发送问题后才会使用所选模型回答。可在 **编辑助手 → 提示词 → 开场** 调整或关闭，已有的自定义开场设置不会被默认欢迎语覆盖。 内置助手无需自行创建，也不能删除。若不想在助手列表显示，可到 **设置 → 应用设置 → 通用偏好 → 显示 Cube 使用助手** 关闭；这只隐藏入口，不会删除已有会话和数据。 ## 它和“AI 服务商管理”有什么区别 - **Cube 使用助手**负责解释整个应用怎么用，给出概念、差异、限制和操作路径。 - **AI 服务商管理**专门处理服务商、套餐与模型配置。检查配置、测试连接、获取模型，也能比较服务商和套餐，配置变更仍由你掌控，执行前会再次确认。 需要实际检查或修改服务商时，请打开 **设置 → 模型与用量 → 服务商管理 → 让 AI 帮我配置**，不要只停留在帮助问答里。 ## 模型与隐私 Cube 使用助手默认跟随全局对话模型。无需 API Key,注册即赠送一次性对话额度；试用用完后需要自己的 API Key 或订阅套餐。想低成本按量可看 DeepSeek；拿不准时去服务商管理点“让 AI 帮我配置”。你发送的问题和为回答而读取的相关帮助内容会交给当前所选模型服务商处理，具体数据规则以该服务商说明为准。 ## 回答边界 它以随当前版本打包的帮助资料为准。帮助里没有写明的功能、服务商实时价格或活动规则，它应明确说明无法确认，而不是猜测。服务商的价格、模型、额度和奖励应以官方实时页面为准。 --- # 添加第一个模型 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/add_model/ ## 你需要准备 - 一个模型服务商账号。 - 服务商提供的 `API Key`。 - 服务商接口地址,通常叫 `Base URL`。 ## 配置步骤 1. 打开 **设置 → 模型与用量 → 服务商管理**。 2. 选择已有服务商,或新增一个服务商。 3. 填入 `Base URL` 与 `API Key`,然后保存。 4. 在该服务商下添加你要使用的模型。 如果不熟悉接口风格、模型 ID、能力开关或套餐选择,可以在 **服务商管理** 页点击常驻的 **让 AI 帮我配置**。先从当前已启用的聊天模型中选择一个管理模型,再直接描述“检查当前配置”“帮我选择服务商、套餐和模型”“获取这个服务商的模型”,或粘贴模型列表让 AI 整理写入。配置变更仍由你掌控，执行前会再次确认。把 API Key 交给 AI 时,首选输入区的 **密钥** 按钮:剪贴板中的密钥只保存在本机,对话里仅出现 CUBEKEY 引用,原文不会发送给管理模型的服务商;服务商详情页手动填写同样安全。如果已经把密钥明文粘贴进对话,也可以让 AI 直接配置,但密钥已随对话发送,建议尽快在服务商后台重置。 ## 给单个模型选择协议 在服务商的模型编辑页设置协议与接口路径，默认跟随服务商。同一服务商的不同模型可分别使用 OpenAI Chat Completions、Responses、Anthropic 或 Gemini 协议；选择服务商实际支持的组合。协议配置不会使模型自动获得视觉或工具能力，修改后请测试。Command Code 已提供服务商预置及余额模板，仍需填写自己的有效凭据。 ## 配置完成后 回到聊天页,在模型选择里切换到刚添加的模型即可开始对话。 ## Header 模板 如果某些中转站要求特定 `User-Agent`、来源标识或其它请求头,可以在服务商详情页打开 **Header 模板**。当前服务商的 Header 可保存成模板,之后在其它服务商中一键应用、合并或替换。 ## 重新获取模型 服务商模型列表变化后,可以重新获取模型。获取结果会显示本次新增、已存在和本次未获取到的旧模型。默认会保留旧模型,避免误删手动添加或临时不可见的模型;如果确认服务商已经下架,可开启“删除本次未获取到的旧模型”,保存前会再次确认。 --- # 没有 API Key 怎么办 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/no_key/ ## 先说明 Cube Agent 本身不销售模型服务。已登录并连接 Cube Agent 在线服务时,可以优先使用**硅基流动（内置）**合作服务；它的地址、访问配置和当前合作模型目录会自动下发，模型请求直接发送到硅基流动。你也可以使用赠送的**免费试用额度**(见「免费试用额度」一篇)把应用跑起来;需要更多模型或自选套餐时，再到模型服务商官网申请自己的 `API Key`。 应用内**预置服务商的接口地址,一律是该服务商自己的官方域名**——既包括 DeepSeek、OpenAI 这类模型厂商官方接口(如 `api.deepseek.com`),也包括 OpenRouter、AiHubMix 这类官方聚合/中转平台的官方地址。你的 `API Key` 只会发往你选定的那家,应用不会再插一层自己的中转。如果你自己添加第三方中转站,那条链路由你自行掌控。 ## 免费模型:硅基流动（内置） SiliconFlow 如果已连接在线服务,服务商管理页顶部会显示 **硅基流动（内置）**，这是连接在线服务后的免费模型权益。它当前提供合作目录，无需填写 API Key，且请求直连硅基流动；断开在线服务后该入口会自动移除。 ## 免费体验的能力边界 内置免费模型适合日常问答、简单改写等轻量任务，可以直接开始使用。处理复杂推理、代码编写或长文分析时，回答的准确性和完整性可能有限。 模型能力、问题描述和对话上下文都会影响回答效果。可以补充背景或拆分任务再试；如果遇到连接失败、消息异常等使用问题，欢迎通过「反馈与建议」告诉我们。 如果希望尝试更强的模型，可在「设置 → 模型与用量 → 服务商管理」添加服务商，填入从该服务商获取的 API Key，再选择相应模型。是否收费及具体价格以服务商说明为准，相关费用由服务商收取；也可以继续使用内置免费模型。 ## 使用自己的硅基流动 API Key 如果你想使用硅基流动的完整模型目录或自己的套餐，可以配置普通 **硅基流动** 服务商: - **一站式**:可接入多种开源与商业模型,适合从一个服务商开始配置。 - **兼容**:Cube Agent 已预置 OpenAI 兼容地址、品牌图标和余额查询配置。 - **国内直连**:不需要额外的网络条件,适合日常对话、写作和代码场景。 - **选择模型**:模型能力和价格会更新,请以硅基流动控制台的实时说明为准。 注册地址:[https://cloud.siliconflow.cn/i/PphCNUwa](https://cloud.siliconflow.cn/i/PphCNUwa) 拿到密钥后,进入 **设置 → 模型与用量 → 服务商管理 → 硅基流动**,填入 `API Key` 保存即可,`Base URL` 已经预置好了。 ## 其它渠道 - **DeepSeek**:适合按量使用国产对话与推理模型。 注册链接:[https://platform.deepseek.com](https://platform.deepseek.com) - **小米 MiMo 开放平台**:可体验小米顶尖模型 MiMo V2.5 等,**支持图片识别**,可以配成 OCR / 视觉模型补上 DeepSeek 的短板。通过邀请码注册新用户可得 ¥10 API 体验金。 邀请码:`JR2N2R` 注册链接:[https://platform.xiaomimimo.com?ref=JR2N2R](https://platform.xiaomimimo.com?ref=JR2N2R) ## MiMo 邀请码填写 注册后进入控制台,点击左下方入口填入邀请码。体验金有效期 40 天。 ## 提示 上面的部分链接和邀请码属于作者邀请渠道。符合对应活动条件时,新用户可获得体验额度,作者也可能获得模型使用额度；**作者获得的奖励将用于维护 Cube Agent 内置免费试用额度**。使用邀请链接不会增加你的价格,奖励资格与金额以服务商实时规则为准。 拿到密钥后,回到 **服务商管理** 选中对应服务商,填入 `Base URL` 和 `API Key`。各服务商的 API 地址以其官方文档为准。 --- # 回复慢、答得不好、生不了图，是应用的问题吗？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/model_decides_quality/ ## 应用和模型各管什么 Cube Agent 负责对话界面、文件、浏览器、Office 文档、知识库和记忆等功能；回复的速度和质量，主要取决于你选择的模型及其服务商。同样的问题，换一个模型，速度和效果可能差别很大。 ## 常见情况 - **回复慢**：思考型模型会先思考再回答，问题越复杂，用时越长。服务商在高峰期也可能需要排队，响应会变慢。 - **答得不好、做不好任务**：小模型或较旧的模型处理复杂任务、长文档和多步骤工具操作的能力有限，可以换用能力更强的模型。 - **生不了图**：画图需要专门支持图像生成的模型，普通聊天模型本身不会画。当前模型（包括内置免费模型）不支持生图时就无法出图。需要在 **设置 → 模型与用量 → 默认模型 → 图像生成** 中配置一个支持生图的模型；想在对话里出图，还要在输入框 **工具** 中开启 **生成图片**。 - **看不了图、用不了工具**：这取决于模型本身是否支持图片理解和工具调用。 ## 关于内置免费模型 服务商列表中的 **硅基流动（内置）** 是 Cube Agent 与硅基流动合作提供的，目的是让刚接触 AI 的朋友不用去服务商注册、也不用填 `API Key`，登录后就能直接使用。它适合日常问答和简单改写；处理复杂推理、写代码、分析长文档或连续调用工具时，能力和稳定性有限，偶尔也可能变慢或失败。随账号赠送的免费试用额度同样只用于体验。 如果想发挥 Cube Agent 的全部能力，建议在模型服务商处购买模型服务，然后在 **设置 → 模型与用量 → 服务商管理** 中添加服务商、填入 `API Key` 并选择模型。添加时先从 **服务商目录** 里选（包含各家的编码套餐），只需填 `API Key`，再点「连接并获取模型」；目录里没有的再选「自定义添加」。服务商列表只显示你添加过的服务商，不用的可以在卡片的「更多」菜单或详情页删除，之后仍可从服务商目录重新添加；旧版本自动列出、但从未填过 `API Key` 也没有模型的预置服务商，升级后会自动移出列表（开过云同步的设备不自动清理，可手动删除）。Cube Agent 本身不销售模型服务，费用由服务商收取。 ## 可以这样做 1. **换个模型试试**：在聊天页的模型选择里切换模型，用同一个问题对比一下，往往能很快看出差别。 2. **按任务选择模型**：日常闲聊和简单问题可以选择响应快的模型，或调低推理强度；写作、编程和处理文档时，再选择能力更强的模型。 3. **慢得反常或经常报错**：请在 **设置 → 反馈与建议** 中告诉我，最好附上模型名称和出现问题的时间，方便判断是应用的问题还是服务商的问题。 --- # 会员中心与 Pro > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/membership_pro/ ## Free 与 Pro 会员体系只有两档： - **Free**:所有已登录用户默认享有，含每端每日 / 每月的免费官方搜索配额等基础在线能力。本地聊天、自有模型 API、知识库、会话级工作目录和技能等主流程均可完整使用；大型技能包导入和 Skill 市场下载、更新也无需 Pro，市场下载与更新需要连接在线服务。Office 文档工具生成 Word / Excel / PPT 文件、保存到本机和系统分享也无需 Pro；模型调用仍使用所选服务商的额度。 - **Pro**:一次性买断、永久有效，解锁进阶能力。Pro 是可选进阶，不是使用本地主流程的前提。 ## Pro 主要权益 - **网页操作**:在支持的 API 23 及以上设备上，让 AI 实际打开、操作网页，读取内容、截图并保存资源到当前对话；操作过程可见，随时接管，登录后可继续。使用步骤见「如何让 AI 操作网页？」。 - **远程连接**:连接自己的电脑或服务器，使用终端、SFTP 文件传输和聊天中的远程命令；复用主机身份与凭据。 - **记忆 AI**:从其它 AI 平台批量导入记忆；对现有记忆做 AI 去重、合并、精炼。 - **Web 工作台生图**:在内置 Web 工作台(浏览器面板)批量生成图像，可选模型、比例与张数。 - **全局文件空间与共享文件**:跨会话集中管理脚本产物，公共文件可发布为链接，也可在任意对话中让 AI 直接读取。 - **发布站点**:把 AI 生成的网页、报告或小工具发布为公网静态站点，接收方访问时不要求你的设备在线。 - **在线字体**:聊天正文与代码可使用在线字体(Free 仅限内置字体)。 - **更多界面个性化配置**:输入框、助手回复与工具卡片的背景不透明度可自由定制(Free 使用默认样式)。 - **更高并行任务上限**:同时进行的对话生成任务从 3 个提升到 6 个,多线整理资料、批量对话不用排队;Pro 到期后已在进行的任务会自然完成,只是不能再新开超额任务。 - **会员专属在线能力**:对话分享、域名映射与站点发布等功能及相应额度。 - **高优先级需求与问题响应**:Pro 用户的功能需求与问题反馈会获得更高处理优先级，但不承诺固定时效。 **图片超清增强无需 Pro**，在支持该系统能力的 API 26 及以上设备上，打开图片预览后点击「超清增强」。会员开通不能解除设备或图片格式限制，具体见同名帮助。 ## Cube Agent 在线服务 Cube Agent 在线服务（原“Cube Agent 云服务”）提供免费模型、官方搜索、对话分享、域名映射等在线能力，并展示会员权益与额度。是否连接由你主动选择；未连接时，本地聊天、自有模型、知识库等功能照常使用。 **连接在线服务不会自动备份或同步聊天记录和知识库。** 数据备份需要在 **设置 → 数据与同步 → 数据备份** 单独操作；卸载或换机前请确认已成功备份。会员中心也提供“数据备份与恢复”入口。 ## 在线额度 会员中心会分别展示官方搜索、对话分享与站点发布额度。Free / Pro 共用官方搜索的周期基础额度；活动、购买或后台发放的额外官方搜索余额会在会员中心实时显示，其中不随周期清零的余额会单独标明。对话分享与站点发布为 Pro 专属在线能力。 ## 三天 Pro 功能体验 会员中心会按账号资格显示金色试用券。先登录并连接在线服务，再按住券下方撕口约 1 秒领取；中途松手可取消，轻点会提示继续按住。领取成功后开始三天计时，并显示剩余时间；失败按页面提示重试。读屏操作可双击领取。 体验只解锁 Pro 功能，不包含正式开通赠送额度，在线功能仍消耗已有额度，模型试用沿用普通版规则。首次体验通常每账号、每台安装限领一次；若显示限时活动，以页面所示截止时间和“活动期内一次”为准，不代表活动一直开放。当前有效 Pro 与正在体验的账号不会叠加领取。 ## 怎么开通 在 **设置** 顶部点 **会员账号卡** 进入 **会员中心**,查看当前方案、权益与额度。应用内购买现已开放： - **购买**:选择 Pro 永久版后会打开应用市场收银台，实付金额以收银台为准。 - **兑换码**:可先预览权益再确认兑换；折扣购买码会衔接到对应优惠商品的收银台。 - **恢复购买**:换机或重装后可在会员中心恢复已经购买的非消耗型 Pro 权益。 早期通过打赏等方式支持过的用户，一般已在后台开通 Pro。若权益未生效，联系作者说明账号信息即可补开，无需反复证明打赏记录。 ## 最佳实践 - 只用本地聊天 + 自有模型 API 的用户，Free 完全够用，无需开通 Pro。 - 需要 AI 网页操作、记忆 AI、Web 生图、跨会话文件空间、站点发布或会员专属在线能力的进阶用户，再考虑 Pro。 - 在线服务连接异常不影响本地功能；可在会员中心查看连接状态。 --- # 反馈与建议 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：快速上手。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/feedback_center/ ## 功能说明 遇到问题或有新想法,有两条反馈渠道:**QQ 交流反馈群**(推荐,沟通更快)与**应用内在线反馈**(无需 QQ、可匿名、可追踪进度)。两条渠道最终汇入同一个处理后台,反馈不会散落。 ## 入口 打开 **设置 → 反馈与建议**，也可以点击设置页标题栏的反馈入口，或在设置搜索输入「反馈」直达。 ## QQ 交流反馈群(推荐) 页面里可直接拉起 QQ 加群(群号 `752237762`),也可以保存群二维码。适合使用咨询、体验讨论和需要来回沟通复现的问题。 ## 在线提交反馈 1. 选择反馈类型:问题反馈 / 功能建议 / 体验问题 / 其他。 2. 描述问题,最多可附 3 张截图，也可附加 1 个不超过 5 MiB 的 UTF-8 TXT 日志文件。选择文件后不会立即上传，提交反馈时才会发送；发送前请检查文件内容。 3. **附上运行环境** 默认开启,只包含应用版本、系统版本、设备型号与网络类型,不含账号、对话内容、密钥与本地文件;可随时关闭。 4. 联系方式选填,仅用于需要补充信息时联系你。 提交后会生成反馈编号,无需登录即可凭本机保存的凭证追踪进度。 ## 我的反馈 在「反馈与建议」页打开 **我的反馈**,可查看每条反馈的处理状态(已收到 / 处理中 / 已完成 / 已关闭)与开发者回复,也可以继续补充说明;有新回复时列表会有标记。 开发者回复会按格式显示列表、加粗和链接,点链接用系统浏览器打开;回复卡片上的复制按钮会复制去掉格式符号的纯文本,链接保留为地址。反馈原文与你的补充消息可长按选中复制,详情顶部的反馈编号旁也有复制按钮,联系开发者时直接粘贴即可。 你补充的消息和开发者的回复都可以附带截图(每条最多 3 张),在详情里点击截图可全屏预览,方便定位问题或展示处理结果。补充消息也可选择 TXT 日志附件，大小与格式要求同上。 注意:匿名反馈的追踪凭证只保存在本机,卸载应用或清除应用数据后将无法再查询之前的反馈进度。 ## 进度通知 提交反馈时勾选「工单有新动态时通知我」(默认开启),反馈有新进展时——如收到回复、或处理状态变更(已收到 / 处理中 / 已完成 / 已关闭)——会通过系统通知及时提醒,无需打开应用。点击通知可直接跳到该条反馈的详情页。 首次提交会引导你允许应用发送通知;之后可在系统通知设置里随时开关。 ## 最佳实践 - 有其他想要的功能或使用建议，欢迎在应用内提单反馈。 - 问题反馈写清「在哪里发生、做了什么、期望怎样」,配一张截图定位最快。 - 需要来回讨论的问题优先进群;希望留痕、涉及隐私或不便使用 QQ 时用在线反馈。 - 不要在反馈正文或截图里包含 API Key 等敏感信息。 --- # 自定义主页入口 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/home_tabs/ ## 功能说明 主页导航可以按你的使用习惯调整顺序，并选择是否把知识库、生图与收藏放在主页，最多显示 5 个入口。 ## 怎么设置 点击对话首页提示卡或右上角菜单的 **自定义主页导航**，也可打开 **设置 → 应用设置 → 通用偏好 → 主页入口**： 1. 长按并拖动入口行，调整展示顺序。 2. 按需开启 **知识库**、**生图** 或 **收藏**；达到 5 个时，先关闭一个可选入口。 3. 点击右上角保存，主页底部会按新配置更新。 ## 固定入口与可选入口 - **助手、对话、设置**:固定入口，可以排序但不能关闭，确保主页始终可用。 - **知识库、生图、收藏**:可选入口，可以开启、关闭与排序，最多同时开启其中 2 个。 关闭入口只会隐藏主页按钮，不会删除数据。知识库、生图和收藏仍可从设置进入；收藏的常驻入口在 **设置 → 内容与文件 → 收藏**，已有资料、已生成图片与收藏标记都会保留。 ## 更新说明与公告弹出 不想被打扰时，在 **设置 → 通用偏好 → 主页与桌面 → 主页** 关闭 **自动弹出更新说明和公告**。关闭后，升级后的更新说明和普通公告不再自动弹出，可在 **设置 → 关于 Cube Agent** 中查看；服务中断等紧急通知仍会提醒。 ## 历史版本 在 **设置 → 关于 Cube Agent → 历史版本** 可以按时间倒序查看随应用附带的历次版本说明，当前安装的版本会标出。点标题栏的搜索输入功能名，能看到它出现在哪些版本和命中的原文；打开某个版本可以长按选择文字、复制全文或分享为 HTML 文件，发布前各轮邀测的公告附在正文之后。内容随应用安装，只包含当前及更早的版本，早期个别版本没有说明。 --- # 桌面卡片与 PC 关闭方式 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/desktop_cards/ ## 添加卡片 在 **设置 → 通用偏好 → 主页与桌面 → 添加桌面卡片** 打开系统卡片管理，或从系统桌面长按应用图标添加。也可在设置中搜索“桌面卡片”。 对话卡片可继续最近对话或草稿，并提供独立新建入口。卡片可选择助手；绑定私密助手时进入应用后仍需验证。最近对话按本人打开、编辑和发送等活动选择，后台回复不会抢占最近记录；原对话失效时会提示并进入列表。 ## 服务商余额卡片 在系统卡片管理中选择余额卡片，可添加到桌面或支持的负一屏。可选玻璃样式或不透明的标准样式，按桌面背景和可读性选择。每张卡片独立选择服务商；先在服务商详情配置余额查询并确认可用，再绑定卡片。卡片显示余额和更新时间，可手动刷新，系统也会按调度刷新；不能保证固定时刻更新。点击标题或余额打开对应服务商详情。查询失败会保留上次数据，请结合更新时间判断；服务商已删除或未配置时需重新设置。 ## PC 关闭窗口 首次点击关闭，可选择收起至系统托盘或退出，并勾选记住。收起后从托盘恢复原页面；退出且仍有任务时会再次确认。要改变已记住的选择，在通用偏好找到“重新选择关闭方式”。 --- # 收藏对话、消息与图片 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/favorites/ ## 收藏中心是什么 收藏中心把重要对话、单条消息与喜欢的生图作品聚合在一起，适合保存需要反复回看的内容。 ## 怎么收藏 - **对话**:在对话列表长按或右滑某个会话，选择 **收藏**；也可点击搜索结果会话卡右上角的爱心。 - **消息**:点击搜索结果中消息旁的爱心，或在会话内打开消息的 **更多 → 收藏**。再次点击爱心即可取消收藏。无痕和管理类会话不提供消息收藏。 - **图片**:在生图图库或大图预览中点击爱心按钮。 随时可从 **设置 → 内容与文件 → 收藏** 打开收藏中心，不需要开启主页收藏入口。也可前往 **设置 → 应用设置 → 通用偏好 → 主页入口**，把收藏固定到主页；第一次收藏时会提示这个快捷方式。 ## 怎么管理 - 顶部可查看 **全部、对话、消息、图片**，按收藏时间排列，也可搜索消息片段和会话标题。 - 点击对话会直接进入原会话；点击消息会进入并定位到对应节点；点击图片可进入大图预览并保存或分享。 - 左滑单项可移出收藏；多选模式可批量移出。 搜索的 **收藏** 筛选同时包含已收藏的会话和消息：已收藏会话显示全部匹配；未收藏会话只显示其中已收藏的匹配消息。普通对话列表的收藏筛选仍只显示已收藏会话。 收藏按消息版本保存。重新生成或编辑产生的新版本不会继承收藏；收藏页保留原版本内容，打开时定位到该节点当前显示的版本。删除原消息或整个会话会同时删除对应消息收藏；消息收藏不会阻止删除。私密助手的会话和消息不出现在收藏中心。 消息收藏状态和收藏时间会随全量、增量备份保存和恢复。移出收藏只会取消标记，不会删除原内容；关闭主页收藏入口同样不会影响收藏数据。 --- # Cube 随行怎么显示、隐藏和切换任务？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/cube_companion/ ## 它是什么 Cube 随行是应用内的悬浮入口，方便回到进行中、待处理或最近使用的对话、生图、SSH、SFTP 与原生文件传输。它不会成为其他应用上方的系统悬浮窗。 ## 打开设置 进入 **设置 → 我的 Cube → Cube 随行**，或从 **任务中心 → 随行设置** 打开设置。选择 **小方块 / 三点 / 隐藏** 并调整显示偏好，修改即时生效。 在随行设置中可以调整： - **小方块大小**：小方块模式下可选 **小巧 / 适中 / 略大**，按习惯调整随行入口大小。 - **显示策略**：自动、始终显示或仅提醒。自动模式在有任务、在线连接或最近入口时显示；仅提醒只显示待处理或未读状态。 - **停靠方式**：跟随握姿、固定左侧或固定右侧。跟随需要全局智感握姿开关和设备支持；无法识别时保持原位置，手动拖动优先。 - **展示页面与快捷内容**：选择在哪些页面显示，以及收录对话、生图、SSH、SFTP、文件传输中的哪些内容。 - **最近入口与终端按键**：按自己的使用习惯保留入口或调整按键显示。 ## 任务中心入口 默认仅在 **设置页右上角** 显示任务中心。可在 **设置 → 显示与外观 → 界面** 开启 **在其他页面显示任务中心入口**，或通过设置搜索定位此项。关闭只隐藏其他页面入口，不取消任务，也不清除任务记录。任务中心可查看待处理、进行中与最近记录；文档解析任务可查看状态、停止或丢弃，具体限制见文档解析帮助。 ## 切换和清理 在普通页面点击 Cube 展开工作列表，选择条目返回。SSH 终端中点击 Cube 优先开合常用按键，再从 **更多 → 切换工作** 进入列表。返回 SFTP 时会按需要重新连接到上次目录，不恢复未确认操作和批量选择。 移除或清理入口只整理列表，不会取消任务、断开连接或删除会话。最近记录仅在本次应用运行中保留，无痕对话不收录；隐私助手仍需解锁。Web 的 SSH 会话和传输不列入原生随行。远程连接功能仍需 Pro。 支持互动的 Cube 展示区域增加揉捏挤眼与旋转后的眩晕反馈，动作会随交互平滑衔接；开启减少动态效果后按相应设置简化。 三点模式会在开合时过渡为当前 Cube 形象；减少动态效果时直接切换。隐藏入口后仍可使用任务中心，终端保留常用按键的替代入口。 想换 Cube 的形象（例如方豚），或导入形象文件，见「Cube 形象库怎么用？」。 --- # Cube 形象库怎么用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/cube_appearance_library/ ## 它是什么 Cube 形象库收录了多款现成的 Cube 形象，例如 **方豚**（海蓝小方豚）、经典 Cube、蛋黄方方等。选中后，悬浮的 Cube 与三点模式展开时的形象都会随之改变。 ## 怎么使用 打开 **设置 → 我的 Cube**，顶部舞台展示当前形象，点下方的状态胶囊可以预览思考、搜索、完成等动作： 1. 点 **形象库** 浏览各款形象，点卡片就在顶部预览；右上角菜单可 **刷新形象库**。 2. 中意的形象点 **加入我的形象**（免费形象直接使用）。 3. 回到 **我的形象**，点卡片即可使用；长按卡片可以编辑、复制、导出或删除。 4. 想自己调颜色、性格和动作，点 **编辑形象**，或在 **我的形象** 末尾点 **新建**，改完点右上角保存。 ## 导入形象文件 在 **形象库** 右上角点 **导入文件** 选择 .cube.json，或在菜单里选 **粘贴配置** 后点 **校验并预览**，满意后再加入我的形象。方案的导出文件也可以用同样方式分享给自己的其他设备。 ## 免费与 Pro 所有形象都可以预览。经典 Cube、方豚和蛋黄方方全员免费；其他形象的添加、保存定制与使用需要 Pro。Pro 失效后会回到免费形象，已保存的方案不会丢失。 ## 和聊天主题的关系 聊天主题里也有 **方豚 · 晴潮**（全员免费），可在 **设置 → 外观 → 聊天主题** 里单独选择。它和 Cube 形象互相独立：选用方豚形象不会自动切换聊天主题，选用方豚聊天主题也不会改变 Cube 形象，可以随意搭配。形象怎么显示、隐藏与停靠，见「Cube 随行」篇。 --- # 本地文件夹怎么交给 AI 使用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/folder_mounts/ ## 添加目录（Pro） 在设置中搜索 **文件夹挂载**，打开后选择 **添加文件夹**，通过系统选择器选择目录，设置名称及只读／读写权限。依赖设备与系统的文件夹选择能力；提示不支持时仍可通过聊天附件提供文件。 ## 在对话中使用 在普通对话工具栏点击 **挂载文件夹**（或输入框 **＋ → 文件夹**），启用本对话要使用的目录；若 **文件操作** 尚未开启，启用目录时会自动开启并轻提示；禁用全部目录不会关闭文件操作。通过 **管理挂载文件夹** 添加或管理目录，也可点击工具栏的 **挂载文件夹**，逐项启用或禁用；没有挂载目录时，工具栏与附件菜单均不显示文件夹入口。仅添加挂载不会自动向对话提供目录。若希望重复使用，可在文件夹管理中开启该目录的 **新对话默认启用**：之后的新对话会自动选择该目录并开启文件操作，已有对话不受影响。也可在 **助手设置 → 工具 → 挂载文件夹** 中关闭该助手的目录访问，或选择独立的新对话默认目录；未单独设置时沿用文件夹管理页的默认项，独立选择为空表示不自动启用。默认目录选择仅保存在本机，不随助手传送到其他设备。仍遵循目录读写范围和操作授权，可在单个对话中关闭。AI 只能访问当前对话已选择且系统授权有效的目录。PDF、Office 等文档可直接通过文件操作按需解析；开启读取图片后，可直接查看已选文件夹里的图片。无需先复制到工作目录，只读授权即可使用这些读取能力；视频不提供抽帧或内容理解。 ## 新建子目录与保存文档 在 **设置 → 文件夹挂载 → 浏览文件** 中，点击文件夹逐层进入，点击顶部路径返回上级；读写模式下可在当前目录 **新建文件夹**。 在对话中可以说：“把刚才的总结保存到「学习资料」的「鸿蒙开发/知识总结」子目录，文件名为「目录授权.md」。”AI 会按文件操作权限请求写入；缺失的中间目录会一并创建。Markdown、TXT 可直接写入，已生成的 Word、PDF 等文件可以复制到指定子目录。只读目录不能新建、写入或删除。 ## 删除与移除挂载的区别 - **删除原文件…**：通过文件或文件夹右侧菜单操作，先核对路径、文件及文件夹数量，再确认永久删除；不会进入回收站。AI 删除也每次单独确认，“始终允许”不能跳过。内容发生变化后需要重新核对；挂载根目录不能删除。 - **移除挂载**：只撤销访问，不删除本地文件。 当前支持列出、读取、复制、写入、文本编辑、新建及删除，暂不支持移动原文件。写入或删除失败可能已有部分变更，请以实际结果及恢复副本提示为准。 ## 授权失败怎么办 目录选择依赖设备能力。若提示“系统未能保存文件夹授权”，表示系统返回的长期授权复核未通过，不代表选中了系统目录。可重新选择自己新建的普通文件夹；若仍失败，请反馈设备型号、系统版本及是否为模拟器。 ## 管理与迁移 在对话中取消选择即可停止该对话访问；也可以切换读写模式、重新授权或移除挂载。移除不会删除原目录文件。授权失效时需重新选择确认；本地挂载不随备份、同步或碰一碰迁移，换设备后需重新授权。NAS、坚果云等网络存储见「怎么把 NAS 或网盘接进对话？」。 --- # 怎么把 NAS 或网盘接进对话？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/webdav_mounts/ ## 添加（Pro） 在 **设置 → 文件夹挂载 → 添加 → WebDAV 网络存储** 中添加；也可以从 **远程连接 → 网络存储**，或在对话的文件夹面板里点 **添加 WebDAV 网络存储**（在对话里添加的会自动在本对话启用）。 只需填写地址、用户名和密码。点 **坚果云、Nextcloud、群晖、AList** 卡片会自动填好地址模板；已经配置过数据备份的 WebDAV，可以一键 **带入**。点 **连接并保存** 会同时测试连接，成功后直接返回。 - **坚果云**：用户名是注册邮箱，密码要用「账户信息 → 安全选项 → 第三方应用管理」生成的应用密码，不是登录密码。 - **群晖**：先在套件中心安装 WebDAV Server，默认 HTTP 端口 5005、HTTPS 端口 5006。 - **AList / OpenList**：地址以 /dav 结尾，默认端口 5244；需要给用户开启 WebDAV 读取与管理权限。 - **阿里云盘、123 云盘** 等自带的 WebDAV 限制较多，体验可能不理想，可以优先选择自建 NAS 或坚果云。 ## AI 权限 添加时选一次即可：**只读**、**修改前询问** 或 **无需确认**（默认）。选「无需确认」时，AI 读取、写入、编辑、新建文件夹和改名都不会再弹窗；**删除远端文件始终单独确认一次**，因为大多数 WebDAV 服务没有回收站。 ## 证书与明文连接 自建 NAS 常用自签名证书：表单里会显示一行说明和证书指纹，保存即信任，不需要额外确认。之后如果证书变了，管理页这一项会显示 **证书已变更**，点 **信任新证书** 即可。使用 http:// 地址时，密码和文件不加密传输，建议只在家庭或公司局域网内使用。 ## 连不上、密码失效怎么办 人不在家、连不上 NAS 时也可以先保存，回到局域网后自动可用。密码修改或应用密码被撤销后，管理页会提示 **密码已失效**，点 **重新输入密码** 直接改密码即可。 ## 换设备 WebDAV 配置和密码会随数据备份（含密钥时）与云空间同步一起恢复，换设备不用重新配置。本机下载的临时文件只是缓存，不进备份。 ## 使用限制 网络存储比本地文件夹慢，服务商可能限制请求频率；请尽量让 AI 列出具体的子目录，避免整盘扫描。暂不支持移动原文件。坚果云单个目录超过 750 项时，可能只能看到其中一部分。 --- # 文件空间与我的分享 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：主页与内容。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/file_space_shares/ ## 三个入口分别做什么 - **会话工作目录**:当前对话中代码解释器产生的文件，所有用户都可在聊天页菜单进入；支持生成文件和全部工作区文件浏览；已有共享文件可免费查看、导出和删除。 - **文件空间**:所有用户都可从设置进入，查看、导出和删除已有共享文件；跨会话集中浏览产物、新增和整理共享文件需要 Pro。 - **我的分享**:从 **设置** 顶部会员账号卡进入 **会员中心 → 账号与服务 → 我的分享**,统一管理已经提交的对话分享与站点发布，支持查看状态、复制链接和撤回。 ## 文件空间 文件按网页、图片、文档、数据、代码等类型展示。点击文件可直接预览；更多菜单中可以保存、分享、重命名、删除或选择其它打开方式，也可把整个目录打包下载。点击标题栏搜索按钮可搜索当前目录，长按文件进入多选；搜索与类型筛选共同决定全选范围，改变关键词后会清空原选择。 ## 共享文件按目录整理（Pro） 在会话文件菜单选择 **存入共享文件**，逐级选择目标目录，也可以先新建文件夹再存入；会话原文件仍保留。共享文件或文件夹的更多菜单提供 **移动到…**，长按进入多选后可批量移动，不能移入自身或自己的子目录。 同名内容可以跳过或保留两份，不会直接覆盖。结果会区分成功、跳过与失败，未完成项可以重新选择位置处理。移动会改变路径，旧路径访问链接会失效，文件内部的相对引用可能需要调整。原生与 Web 均支持目录存入和整理。 上传文件夹、从 ZIP 导入目录及批量导入的限制，见「工作目录」帮助。 ## 排序与清理 文件列表可按名称、修改时间或大小升降序排列，文件夹优先，原生与 Web 分别记住选择。工作目录的文件／文件夹菜单支持删除，非空目录会先核对内容再确认；请留意部分失败或取消后的实际结果。 文件空间的会话菜单可选择 **删除该会话全部产物**，只清理输出内容，保留聊天、输入附件及其他工作文件。该会话仍有任务运行时不可执行整体清理。 共享文件保存在本机，供其他会话使用，不等于发布到公网。新增共享文件需要 Pro；让 AI 代办存入或整理时，可选择本次允许或始终允许文件操作。已有文件可免费查看、导出和删除，会员到期后仍可清理。AI 删除共享文件也免费，复用文件操作的本次允许或始终允许，授权后无需额外确认。AI 可按需读取 `public/文件名`，无痕会话不读取共享文件。访问链接依赖本机 Web 服务、设备在线和身份验证；匿名公网访问需另行执行“发布到公网”。 ## 发布站点（Pro） 会话工作目录支持 **发布到公网**。点击后会进入选择模式，自行勾选要发布的文件（也可全选），经确认后把所选静态文件发布为站点，适合 AI 生成的网页、报告和小工具；站点经过内容审核后可公开访问，接收方访问时不要求你的设备在线。 发布记录统一出现在 **我的分享 → 站点发布**。公开内容不要包含 API Key、个人资料或其它敏感信息，不再需要时请及时撤回。 --- # 怎样快速找到设置 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：热门问题。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/settings_search/ ## 功能说明 设置页顶部的搜索入口可以查找具体功能，不必先记住它属于哪个分组。搜索单位不只是页面，也包含页面里的开关、页签和可直接执行的操作。 ## 支持怎样搜索 - 功能名称与说明，例如“默认模型”“备份”“崩溃日志”。 - 常用别名，例如“API Key”“清缓存”“换机”。 - 中文标题的拼音或首字母，例如输入 `morenmoxing` 或 `mrmx` 查找默认模型。 ## 结果怎么用 点击结果会直接进入对应页面；部分叶子项会同时定位到指定页签或通道，例如华为云盘 / WebDAV / SMB。更新模型库、重新查看引导等操作可以从结果中直接执行。 空白搜索页会展示最近搜索与常用设置。最近记录可手动清空；没有匹配结果时，可继续进入 **使用帮助** 查找说明。 --- # Cube 官方搜索怎么用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：热门问题。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/official_search/ ## 它是什么 Cube 官方搜索是由 Cube Agent 在线服务提供的联网查询能力。连接在线服务后，不必先注册每家搜索服务或填写自己的 API Key，也可以使用工具中心中标有「官方额度」的搜索服务。 它和模型的**内置搜索**不是同一件事：官方搜索是应用提供的联网工具，会使用会员中心显示的官方搜索额度；内置搜索是模型服务商自己的联网能力，是否可用和如何计费取决于你当前的服务商、模型与套餐。 ## 第一次怎么开启 1. 打开 **设置** 顶部的会员账号卡，进入 **会员中心**，按提示连接 Cube Agent 在线服务并登录。 2. 连接成功后，如果出现「开启免费官方搜索」提示，点击一键开启。应用会启用当前可用的官方搜索服务、打开联网搜索总开关，并保留你已经填写的 API Key。 3. 回到聊天页，点击输入框左下方的联网入口，选择已启用的官方搜索服务并打开联网。只有一个可用选项时，直接点击该名称即可切换开关。 ## 错过首次提示，或想单独调整 进入 **设置 → 助手与能力 → 工具服务 → 联网搜索**，选择标有「官方额度」的服务，打开该服务和「优先使用官方服务」。你可以按需要分别启停各项服务；已有 API Key 不会被一键开启覆盖。 ## 在聊天里怎么提问 开启联网后，直接提出需要最新公开信息的问题，例如“查一下今天的发布公告”“帮我找官方文档并总结”“打开这个网页，提取其中的价格规则”。联网搜索是模型按需调用的工具：问题不需要实时资料时，模型不一定会搜索；需要时会先检索或读取网页，再结合结果回答。 ## 额度怎么看，为什么没有固定数字 打开 **设置 → 会员账号卡 → 会员中心 → 本期额度**，查看官方搜索当前的基础额度、额外余额和重置时间。额度规则、可用服务和活动赠送可能调整，因此会员中心显示的是唯一准确的当前口径。联网查询和网页读取都可能消耗官方搜索额度。 基础额度同时受**每日**和**每月**两档上限约束，实际可用次数以两档剩余的较小值为准——因此月度额度用完后，即使今日用量还很低，也要等月度周期恢复后才能继续。卡片上的「剩余 N 次」就是按这个规则算出的当前实际可搜次数。 额度不足时，若你已为对应搜索服务配置自己的 API Key，应用可以继续使用自备服务；也可以等待周期额度恢复或改用其它已配置的联网方式。 ## 常见问题 - 看不到官方搜索：先确认已经连接在线服务，并在工具服务中启用了标有「官方额度」的搜索服务。 - 开了联网但没有搜索：当前模型需要支持工具调用；同时确认聊天页联网入口处于开启状态。 - 菜单里只有「内置搜索」：这是模型服务商提供的联网能力，不消耗 Cube 官方搜索额度；请查看帮助中心的「GPT / DeepSeek / Gemini 内置搜索」说明。 ## 隐私提示 联网时，查询词和要读取的网页地址会发送给 Cube Agent 在线服务及对应的搜索服务。不要把密钥、客户资料、内部地址或其它不希望外传的信息写进搜索请求。 --- # GPT / DeepSeek / Gemini 内置搜索怎么开 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：热门问题。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/builtin_search_gpt_deepseek_gemini/ ## 先分清两个开关 - **工具服务里的联网查询**:控制 Bing、Exa、Tavily、DeepSeek、Firecrawl、Metaso 等外部搜索服务是否出现在聊天联网菜单里,不控制模型内置搜索。 - **模型的内置联网**:表示当前模型和接口支持服务商自己的搜索能力。内置搜索不使用工具服务下方配置的 Exa、Tavily、DeepSeek、Firecrawl、Metaso 等外部搜索服务,所以这些服务不启用也可以。 聊天联网菜单里只有在当前服务商接口、传输方式和当前模型都支持内置联网时,才会出现 **内置搜索**。 如果当前只有一个可用搜索项,聊天底栏会直接显示该搜索项名称,点击即可启用,再次点击即可禁用;有多个搜索项时,点击后在菜单中选择。 ## GPT / OpenAI 内置搜索 1. 打开 **设置 → 模型与用量 → 服务商管理**,进入 OpenAI 服务商,或新增一个 OpenAI 风格服务商。 2. API 风格选择 **OpenAI**,传输方式选择 **Responses**。官方 OpenAI 的 Base URL 通常是 `https://api.openai.com/v1`。 3. 选择或添加支持内置联网的 GPT 模型。如果模型能力里的 **内置联网** 没有开启,进入模型编辑页手动勾选。 4. 回到聊天页,确认当前对话使用该 GPT 模型,点击左下方联网入口启用 **内置搜索**。 OpenAI 内置搜索的展示条件是:**OpenAI API 风格 + Responses 传输方式 + 当前模型开启内置联网**。如果仍然看不到 **内置搜索**,优先检查当前服务商是不是 OpenAI 风格、传输方式是不是 Responses、当前聊天是否真的切到了对应模型。 ## DeepSeek Responses API 内置搜索 1. 打开 **设置 → 模型与用量 → 服务商管理**,进入 DeepSeek 服务商。 2. API 风格选择 **OpenAI**,传输方式选择 **Responses**。Base URL 填写 `https://api.deepseek.com`（已有的 `https://api.deepseek.com/v1` 配置也可继续使用）,不要填写自定义 API 路径。 3. 选择 DeepSeek 官方 Responses API 支持的模型（如 `deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`）。如果模型能力里的 **内置联网** 没有开启,进入模型编辑页手动勾选。 4. 回到聊天页,确认当前对话使用该模型,点击左下方联网入口启用 **内置搜索**。 此方式会请求 DeepSeek 官方的 `/responses` 接口，并由模型自行执行联网搜索。内置搜索入口对所有开启了 **内置联网** 能力的模型开放；实际可用性以 DeepSeek 上游 Responses API 的支持为准，若所选模型暂未开放，服务端会返回相应的不支持错误。 ## DeepSeek Anthropic 兼容接口内置搜索 也可以继续使用已有的 Anthropic 兼容路径：API 风格选择 **Claude(Anthropic)**，Base URL 填写 `https://api.deepseek.com/anthropic`，再选择支持内置联网的 DeepSeek 模型并在聊天页开启 **内置搜索**。 ## Gemini 官方内置搜索 1. 打开 **设置 → 模型与用量 → 服务商管理**,进入 Gemini 服务商。 2. API 风格保持 **Google**,Base URL 使用官方 Gemini 地址,默认是 `https://generativelanguage.googleapis.com/v1beta`。 3. 选择或添加支持内置联网的 Gemini 模型。如果模型能力里的 **内置联网** 没有开启,进入模型编辑页手动勾选。 4. 回到聊天页,点击左下方联网入口启用 **内置搜索**。 ## 三方或中转服务商 三方提供的 GPT、DeepSeek、Gemini 模型不一定支持官方内置搜索。可以先按对应 API 风格配置服务商,在模型编辑页勾选 **内置联网**,再回到聊天页查看联网菜单里是否出现 **内置搜索**。 如果没有出现,说明当前接口不满足内置搜索条件。如果出现但请求失败,说明中转接口可能没有透传服务商的内置搜索能力。此时可以改用外部搜索服务:在 **设置 → 助手与能力 → 工具服务** 中配置并启用可用搜索服务,然后在聊天联网菜单选择对应服务。 --- # 哪些事可以让 AI 替你做？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/ai_agents_overview/ ## 它是什么 Cube 把一批"配置和维护类"的活交给了专用 AI 会话或助手工具:你说清楚需求,AI 读取真实配置、试调接口、给出方案;所有写操作都会弹出确认卡,你批准才落库,AI 不能私自改动。 ## 配置类:三个专用 AI 会话 - **AI 服务商管理**:设置 → 模型与用量 → 服务商管理 → 「让 AI 帮我配置」。检查配置、测试连通、获取模型列表、比较服务商与套餐、整理你粘贴的模型列表,遇到非标准接口还会用脚本直接探测。详见「AI 服务商管理是什么?」。 - **余额查询**:在服务商详情页「账户余额」区选模板一键配置,或点「让智能体帮你配置」把文档贴给它,真实试调到能解析出余额才保存;配置好后服务商列表和模型选择面板直接显示余额。详见「服务商余额查询怎么配置?」。 - **AI 生图接入**:生图工作台 → 模型面板 → 「AI 接入生图模型」。贴上任意生图接口的文档,AI 自动试调、真实出图验收后保存为配方,模型随即出现在工作台。详见「AI 生图接入是什么?」与「生图配方怎么设计好用?」。 - **AI 主题设计师**:「我的配色」页进入。描述感觉、发一张参考图照着配色,或点名仿照某个主题,一次给多套候选,深浅色自动配套;点候选卡上的按钮保存或应用(自定义配色为 Pro 权益)。详见「外观个性化」。 ## 沉淀类:三个助手级工具 在 **助手 → 编辑助手 → 工具** 中开启后,任意对话里直接说需求: - **管理技能**:说「帮我把这套流程做成技能」,AI 出草稿卡,确认后入库;以后一句话复用整套玩法,支持局部修改、在指定段落前后插入与回滚上一版，无需重写整篇技能。 - **管理知识库**:说「把这条结论存进 XX 库」,AI 整理成规范笔记出草稿卡;支持局部修改、中间插入、文件本地复制，整份文件也可以直接入库(原文进库,不经过模型)。 - **环境变量**:技能和脚本要用的 `API Key` 统一存这里,按助手隔离，通过网络请求的宿主凭据代用调用接口，不向脚本或模型返回明文。 ## 一个完整的场景 "我想用 XX 家生图,顺便给 App 换套配色": 1. 服务商管理会话:贴上文档与密钥,接入这家服务商; 2. 顺手说「帮我把余额查询也配上」; 3. 生图工作台确认模型已可用,直接出图; 4. 主题设计师:发一张喜欢的截图,「照这个配一套」; 5. 对调教顺手的提示词套路说「存成技能」。 全程没有一个写操作跳过你的确认。 ## 提问卡 服务商管理、生图接入和主题设计三个专用会话,遇到需要你在几个选项里做决定的地方(例如选哪个服务商、模型或方案),会弹出提问卡让你点选,推荐项排在前面,查得到的信息不会再问你。提问卡不会用来索要 API Key、密码、令牌或验证码;需要密钥时,请使用输入区的 **安全保存密钥** 按钮存入本机。 ## 注意事项 - 三个沉淀类工具只在助手编辑页开关,不出现在聊天页的工具选择器里; - AI 不能删除整个技能或知识库,整删仍需前往技能中心 / 知识库中心; - 专用会话只管自己的领域(如服务商管理会话不碰 MCP、技能与助手),互不越界。 --- # 如何配置和测试应用内代理？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/app_proxy_settings/ 在设置中搜索 **应用内代理**，添加或编辑代理，填写主机、端口并选择协议。SOCKS5 需要 API 26 及系统能力支持；切换到该类型后可填写用户名与密码，多数本地代理无需认证。 **绕过列表** 支持域名或 IP，例如 example.com、192.168.1.10，多个地址用逗号或换行分隔，匹配的地址直接连接。 底部 **测试连接** 使用当前未保存的配置检查实际通道，显示成功或失败原因；确认无误后点击 **保存**。测试不会替你保存配置，也不代表所有模型接口都已通过验证；模型能力请再使用服务商详情的连接测试。 --- # 如何测试模型连接与能力？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/provider_connection_tests/ 打开 **设置 → 模型与用量 → 服务商管理**，进入服务商详情，点击 **测试连接**。在面板顶部选择模型，可按名称或 ID 搜索。 对话模型可分别测试 **普通回复、流式输出、工具调用**；Embedding 模型检查返回的向量数据。点击单项测试或重试，也可开始一轮测试，运行中可停止。展开 **查看详情** 查看返回结果，并按需复制。 成功判定会检查实际响应，不只看 HTTP 状态码。普通回复通过不代表流式或工具调用也支持；请分别验证所需能力。模型与接口的实际支持仍以服务商为准。 一轮测试使用同一把 Key；需要指定 Key 时，进入多 Key 管理单独测试。测试会真实调用模型，按服务商规则计费。 --- # 如何分享或导入服务商？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/provider_share_import/ ## 分享 打开 **设置 → 模型与用量 → 服务商管理**，进入服务商详情，点击标题栏的 **分享**。默认不打开 **包含 API Key**，只分享接入地址、协议和模型等配置；生成的二维码和分享码无需密码，接收方导入后自行填写 Key。 打开 **包含 API Key** 时，需要设置 4–6 位数字密码，分享内容会用这个密码加密。请通过私密渠道告诉对方密码，不要和二维码一起转发。配置过大无法生成二维码时，可以复制分享码发给对方。内置的 Cube 试用等由云端管理的服务商不能分享。 ## 导入 在服务商管理页标题栏选择 **扫码导入**，或先复制对方发来的分享码，再选择 **从剪贴板导入**，预览确认后保存。不含 Key 的分享码导入时会清除其中的密钥、余额凭据和凭据类请求头，需要自己填写 API Key；旧版本生成的分享码仍可导入。 --- # AI 服务商管理是什么？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/provider_ai_management/ ## 它能做什么 打开 **设置 → 模型与用量 → 服务商管理**，点击列表顶部常驻的 **让 AI 帮我配置**。检查配置、测试连接、获取模型，也能比较服务商和套餐；右上角的彩色 AI 图标是同一个入口。 ## 如何识别这个入口和模式 首次进入服务商管理页时，应用会展示一次 AI 管理介绍，可直接点击 **选择管理模型** 开始体验；关闭后不会反复自动弹出。顶部的 **让 AI 帮我配置** 会一直保留，不需要记住隐藏入口。 进入后，标题栏会固定显示 **AI 服务商管理** 和 **专用管理模式**，因此不会与普通聊天混淆；保存配置等实际变更前仍会请你确认。管理会话会自动保留：配置到一半随时可以退出，下次从服务商管理页顶部的 **继续上次 AI 配置** 一键回到原会话继续；全部历史可在服务商管理页或管理会话标题栏菜单的 **AI 会话历史** 中查看、继续或删除。管理会话的标题栏菜单还提供消息导航和 **清空当前对话**：清空会删除当前会话的全部消息及历史版本，已保存的配置不受影响。管理会话只保留在本机（并随备份同步），不会出现在任何助手的会话列表里。 可以直接让 AI： - 检查配置、测试连接，并整理服务商与模型。 - 根据最新官方资料比较服务商、套餐与模型。 - 从标准接口发现模型列表。 - 联网查询服务商文档、接口格式和模型能力线索。 - 新建、编辑服务商，停用服务商，或修改模型能力。 - 把你从网页复制的真实模型列表解析、去重并合并到指定服务商。 配置变更仍由你掌控，执行前会再次确认；联网脚本可临时使用现有密钥，执行前请核对。 ## 先选择管理模型 每次从服务商页进入时，应用都会先列出当前已启用的文本聊天模型。顶部会优先推荐上次使用、默认聊天模型或已知支持工具调用的模型；这个选择只用于 AI 服务商管理，不会改动默认聊天模型和普通对话当前模型。 模型能力尚未确认时可以先选，首次发送会验证工具调用。若模型或接口不支持工具调用，或所选模型后来被停用，页面会明确提示并重新打开模型选择器。 ## 读取与写入 查看配置、连接测试和发现模型属于只读操作。新建、编辑、删除服务商，以及增删模型或修改能力属于写操作，模型只能提出结构化变更，真正执行前会显示工具确认面板和关键参数。 删除服务商或移除模型会使用红色的强化确认，并提示操作不可从确认面板撤销。免费试用等由账号或云服务管理的内置服务商有底层保护，不能删除，不需要时可以停用；其他预置服务商可以删除，之后可从服务商目录重新添加。 ## JavaScript 能力 管理模式可以使用本机 QuickJS 处理你粘贴的非标准列表、清洗 JSON、去重模型 ID，也可以直接访问网络。标准连接测试和模型发现优先使用应用原生服务；遇到非标准接口、自定义请求体或需要检查原始响应时，AI 会先展示 JavaScript 执行确认，再通过 `providerFetch` 自动附加服务商现有凭据并发起真实请求。测试新服务商时，先保存服务商配置，再申请代用其凭据。`getLocalSecret` 和 `getProviderCredential` 不再向脚本返回密钥；CUBEKEY 是管理模式保存密钥后生成的引用，不是助手环境变量名，也不能自行猜测编号。 ## 隐私与密钥风险 AI 管理需要把你的管理对话，以及服务商名称、Base URL、API 路径、模型 ID、配置状态、测试结果等必要信息发送给所选管理模型。联网搜索时，查询词和访问目标也会交给对应的搜索或网页服务。不要在管理对话中放入不希望发送给这些服务的内部地址、客户信息或其他敏感内容。 服务商 API Key、多 Key 当前选中的有效 Key 及识别为敏感的认证 Header，不会通过服务商查询工具返回给模型。只有在你批准 JavaScript 后，它们才会临时注入本机 QuickJS，脚本随后可以把带凭据的请求发往代码中指定的网络地址。账号会话型内置服务商不会向脚本暴露 Session Token，仍使用原生连接测试。 脚本日志、返回值和错误中的原始凭据会再次脱敏，但自动识别并非绝对保护：脚本主动对密钥编码、拆分、变形，写入输出文件，或直接随另一网络请求转发时，可能绕过字符串脱敏。因此确认面板会展示脚本内容；批准前应核对服务商 ID、请求域名和代码用途，发现陌生域名、打印凭据、写文件或二次转发时应取消执行。新增或更换密钥时，推荐使用输入区「安全保存密钥」按钮——密钥只保存在本机，对话里仅出现 CUBEKEY 引用，可用于保存服务商配置，不能在脚本中读取原文；或在服务商详情原生表单填写。如果密钥已经明文粘贴进对话，可以让 AI 直接写入（写入前仍会弹确认面板，面板上的密钥会自动掩码）；此时密钥已随对话发送给管理模型的服务商，建议尽快在服务商后台吊销或重置，再把新密钥更新进来。 管理模式还会提供联网搜索和网页读取。用户说不清服务商规则、接口地址或能力字段时，AI 可以先查找公开资料和官方页面，再结合本机实际配置给出建议；搜索到的信息不会被当成本机配置直接写入，所有变更仍需确认。 ## 推荐说法 - “检查当前服务商配置，告诉我哪里可能有问题。” - “测试这个模型是否连通，只检查不要修改。” - “这是服务商网页上的模型列表，帮我去重后写入对应服务商。” - “把这个模型改成支持视觉和工具调用，其他能力保持不变。” AI 会先读取真实配置再处理；写入完成后会重新读取核对。当前版本只管理服务商与模型，MCP、Skill 和助手仍在各自页面管理。 --- # 服务商余额查询怎么配置？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/provider_balance/ ## 余额查询是什么 配置了余额接口的服务商，会在 **设置 → 模型与用量 → 服务商管理** 列表上直接显示账户余额；聊天页 **选择模型** 面板可一键刷新全部支持余额查询的服务商，余额显示在服务商一栏。金额按币种展示，查询失败会显示失败状态。 配置入口：服务商详情页 → **账户余额** 区。 ## 方式一：选模板 内置 DeepSeek、硅基流动、Kimi、StepFun、OpenRouter 五个官方模板，选中即填好余额地址、路径与解析规则，保存后查询验证即可。模板不匹配时再手动微调，通常只需要改地址和结果路径。 ## 方式二：让智能体帮你配置 点击余额区的 **让智能体帮你配置**，进入 AI 服务商管理专用会话。把接口文档或服务商后台页面的说明发给它，AI 会真实试调、按返回结果修正解析路径；配置写入前会弹出确认面板。 ## 自定义接口 - **余额 Base URL / 余额 API 路径**：Base URL 留空时使用服务商主地址。 - **GET / POST 覆盖**：接口要求 POST 时切换方法，并填写 **请求体模板（JSON）**。 - **自定义请求头（JSON 对象，可选）**：默认发送 Accept 与 Authorization: Bearer 头，同名会被你的值覆盖。 - **占位符**：请求体与请求头支持 `{{apiKey}}` 与 `{{baseUrl}}`。 - **结果 JSON 路径 / 币种 JSON 路径**：告诉应用余额数值与币种在响应里的位置。支持点路径、数组下标与 +/- 表达式，纯数字按常量参与运算（如 `100 - usage.monthly.percent` 算剩余百分比）；中转站返回的额度需要换算时，在单个路径后加 **`* 正数`** 或 **`/ 正数`**，如 `data.quota / 500000`（OneAPI 系中转的 quota 通常 ÷500000 才是美元金额）。 - **专用余额 Key（可选）**：余额接口与模型接口凭据不同的服务商可单独填写，配置后查询请求优先使用它。 ## 请求预览（已脱敏） 预览按当前配置实时组装实际请求，凭据以掩码显示。发送前核对一遍，能提前发现地址写错、方法不对这类问题。 ## 最佳实践 - 优先选模板；每改一处就点查询验证，不要攒一批改动再一起测。 - 请求成功但金额显示不对时，优先检查 **结果 JSON 路径**——多数情况是数值嵌套在别的字段里；数字大得离谱（如几千万）通常是中转站的原始额度，需要加 `/ 500000` 这类换算系数。 - 中转站与官方的余额接口不同时，用 **专用余额 Key** 或单独的 Base URL，避免影响模型调用。 - 冷门接口解析不出来，直接丢给智能体：贴上文档，让它试调到显示正确为止。 ## 隐私提示 余额查询由应用直接向你配置的服务商发起，不经过 Cube Agent 服务器；让智能体配置时，接口地址与文档会发送给你选择的管理模型。 --- # 默认模型的任务角色 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/roles/ ## 默认模型是什么 默认模型用于给不同任务指定首选模型,各角色互不影响。入口在 **设置 → 模型与用量 → 默认模型**。页面顶部是对话模型主卡,其余任务分组排列,每行右侧的模型胶囊就是该任务当前的模型,点一下即可更换;任务下方的小字只在有需要注意的信息时出现,例如推理强度不是自动、用了自定义提示词或尚未设置。 ## 任务角色 - **聊天**:主对话使用的模型。 - **标题生成**:自动命名会话,生成语言跟随当前应用语言。 - **推荐候选词**:生成后续问题,生成语言跟随当前应用语言。 - **翻译**:消息翻译。 - **OCR 识图**:用于图片文字识别。文档、文字、表格类图片可优先走端侧 OCR;开启”优先使用大模型识别”时,会优先使用这里配置的 OCR 模型。 - **图像生成**:独立图像生成工作台使用的模型。 - **文档解析**:MinerU、PaddleOCR 与已有视觉模型,独立于图片识别。 - **知识库向量化**:用于知识库混合检索中的语义向量路(Embedding)。只在默认模型页或知识库详情里配置,不会出现在日常聊天的模型选择器中。 - **SSH 命令审核(Pro)**:用于 SSH 智能审批。 ## 辅助任务的推理强度 点 **标题生成** 或 **推荐候选词** 打开选模型面板,面板顶部有该任务独立的 **默认推理强度**,默认是自动(使用模型自己的默认强度)。它只对对应任务生效,不影响聊天和助手里的推理强度。所选模型不支持推理时不显示。OCR 识图的「优先使用大模型识别」同样在它的选模型面板顶部设置。 ## 向量模型与对话模型 应用会根据模型 id/名称等特征尽量自动识别 **向量模型**。若识别不准,可在服务商的 **模型编辑** 页手动标注类型(对话 / 向量)。标注为向量后: - 不会出现在聊天、助手等对话场景的模型选择器中。 - 会出现在默认模型「知识库向量化」以及知识库索引相关选择器中。 ## 切换模型 聊天页打开模型选择器时,可看到更清晰的当前选择、服务商品牌、能力胶囊与收藏状态。可以按服务商浏览，也可优先查看收藏模型；点击品牌入口可继续进入对应服务商管理。 对话场景会自动过滤生图专用模型与向量模型，避免误选。支持文本 + 图片双模态输出的模型仍可在聊天选择器中出现，并会展示对应能力标识。 ## 注意事项 某个角色未配置或模型不可用时,只会影响对应功能。例如推荐候选词未配置,不影响正常聊天。标题和推荐候选词会清理多余编号、Markdown、引号等格式,让结果更稳定。 --- # 服务商、默认模型和助手模型有什么区别？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/provider_default_assistant_models/ ## 三层关系 1. **服务商管理**解决“应用能连接哪些模型”。在这里填写 Base URL、API Key、接口协议，并维护该服务商提供的模型列表。 2. **默认模型**解决“不同任务平时用哪个模型”。聊天、标题、推荐问题、翻译、OCR、生图和知识库向量化各自独立；压缩上下文不单独设置，直接跟随当前对话模型。 3. **助手模型**解决“这个助手是否要覆盖全局聊天模型”。助手不单独指定时跟随全局聊天模型；指定后，只影响该助手的新对话。 ## 推荐顺序 - 第一步：到 **设置 → 模型与用量 → 服务商管理** 接入服务商，确保目标模型已启用且能连接。 - 第二步：到 **设置 → 模型与用量 → 默认模型** 配置聊天和需要的辅助任务。 - 第三步：只有某个助手确实要长期使用不同模型时，再到 **助手 → 编辑助手 → 模型** 设置覆盖。 ## 更新模型库 **设置 → 模型与用量 → 更新模型库**（同步最新模型能力与图标）会同时刷新模型目录和补充信息。其中一路失败时会明确提示，并保留原有数据，不会被清空。使用尚未收录的模型时,应用也会在后台自动刷新一次,无需手动操作。 ## 常见误区 - 只在服务商里添加模型，不代表它已经成为默认聊天模型。 - 修改默认聊天模型，不会改掉已经显式绑定模型的助手。 - 标题、翻译或 Embedding 未配置，只影响对应任务，不代表聊天模型不可用。 - 服务商或模型名称不能证明视觉、工具调用和协议能力；这些能力要以实际配置、官方资料和连接测试为准。 不确定服务商、套餐、模型或协议怎么选时，可进入 **服务商管理 → 让 AI 帮我配置**，让 AI 先读取当前状态并测试，再由你确认修改。 --- # 如何导入和使用世界书（Pro）？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/worldbook/ ## 导入与挂载 1. 打开 **设置 → 助手与能力 → 世界书**，点击加号 **添加世界书**，可以：**选择 JSON 文件**（SillyTavern 或 RikkaHub 导出）、**让 AI 设计一本**，或导入 **示例世界书**。世界书与知识库有各自的管理入口和列表；导入需要有效的 Pro 权益。 2. 在导入预览核对可用、需要处理及原文件停用的条目，并展开兼容详情。无法识别的文件不会创建数据。 3. 导入后可在详情中搜索、编辑条目，或导出为 SillyTavern World Info JSON。 4. 在详情页点击 **开始体验**：新建或复用「书名 · 讲述者」助手，挂载这本世界书并开启剧情选项，按本书的开场设置进入新对话。开场关闭时只预填用户草稿，不自动发送。 5. 也可以打开 **助手 → 编辑助手 → 知识 → 世界书**，把世界书挂载到已有助手。知识库与世界书分组展示，各组的 **管理** 打开对应列表，标签批量挂载仅影响本组。点击 **查看条目** 可进入详情，从管理页或详情返回后继续编辑助手。 ## 角色卡开场与配置 导入带内嵌世界书的 SillyTavern V2/V3 角色卡 JSON 时，会同时读取主开场白与备选开场。可以在导入预览中选择、编辑，也可以之后打开 **世界书详情 → 开场** 调整。主开场默认为固定开场；没有主开场时使用第一个非空备选。 - **固定**：新对话直接显示一条助手消息，不调用模型。 - **生成**：填写开场要求，复用助手的模型开场功能；可选择自动开始，也可进入对话后点击 **让助手先开口**。从文件导入时自动开始默认关闭，需要时自行开启。 - **关闭**：由你先发送消息。 普通世界书没有角色卡开场时，如果有按关键词触发的开场条目（名称含「开场」「开局」，或关键词为「开场」「开始游戏」等），导入预览会默认改为 **生成**，并把该条目正文作为开场要求。这类条目靠对话中的关键词触发，模型开场时通常触发不到，带入后讲述者会按条目内容开场。可以在预览中修改或关闭；已导入的世界书可在 **开场** 中点击「用条目生成开场」。 开场设置对挂载这本世界书的助手生效：助手自己的开场为 **关闭** 时，主动新建对话会使用世界书的开场，从助手列表点「新对话」也一样；改了世界书开场后，下一次新建对话即生效。讲述者会一直跟随本书；如果你在助手中单独设置或改过开场，则以助手的设置为准。已有对话不改动。挂载了多本带开场的世界书时，使用挂载列表中第一本。在 **编辑助手 → 提示词 → 开场** 可以看到当前会用哪本世界书的开场，也可以把它带入后修改，或在固定模式下直接选择角色卡的备选开场。 备选开场原文会保留，当前选择和编辑后的开场也会随世界书保存、备份及导出。开场配置使用 Cube 扩展保存在 World Info JSON 中；其他应用是否采用该配置取决于其支持情况。正文按原文保存，角色卡中的酒馆宏不会自动执行，可在预览时改为实际文本。 ## 让 AI 设计世界书 在 **世界书 → 添加世界书 → 让 AI 设计一本** 中描述想法（题材、基调或一个画面即可），或发送小说、设定文档。AI 会先用提问卡确认几个关键问题，再把整本世界书显示为对话里的卡片。点 **预览并导入** 进入导入预览，确认后才会创建；可以继续提出修改意见，AI 只提交改动的条目，卡片显示合并后的整本，不必每次重写整本。设计对话保留在本机，可从该入口回来继续。 ## 剧情选项 助手开启了「向用户提问」（ask_user）工具并挂载了世界书时，AI 会在剧情来到分支时弹出提问卡，给出几个行动选项，可以点选或自己输入；普通叙述不会每轮都问。不想要选项时，在助手的工具设置里关闭「向用户提问」。「开始体验」创建的讲述者助手默认开启。这类对话里的提问卡标题显示为「轮到你了」。 ## 用入门示例试一次 最快的方式：在 **世界书 → 添加世界书 → 示例世界书** 中选择「雾港银灯」或「失落矿坑」，导入后点 **开始体验**。 下方 JSON 是可导入的最小示例，包含“故事背景”和“灯塔”两条设定。将代码内容保存为 UTF-8 编码的 `世界书入门示例.json` 文件，在 **设置 → 世界书 → 添加世界书 → 选择 JSON 文件** 中选择该文件，核对预览后确认导入；不会自动挂载到任何助手。 1. 将示例挂载到一个助手，开始新对话。 2. 发送“介绍一下这座小城”：始终启用的背景条目会参与本轮请求。 3. 再发送“带我去灯塔看看”：最近消息出现“灯塔”后，灯塔条目也会参与匹配。 4. 打开聊天的上下文容量，查看世界书匹配、加入的条目；回复是否逐字复述设定由模型决定。 示例采用 SillyTavern JSON 格式。entries 存放条目，comment 是名称，key 是主关键词，content 是加入上下文的正文；constant 为 true 表示始终启用，disable 为 true 表示停用。 ```json { "name": "世界书入门示例", "entries": { "0": { "uid": 0, "comment": "故事背景（始终启用）", "key": [], "content": "故事发生在海边小城银港。城里的人以航海和修船为生。", "constant": true, "disable": false }, "1": { "uid": 1, "comment": "灯塔（关键词触发）", "key": ["灯塔", "守塔人"], "content": "银港的灯塔由林舟看守。每逢大雾，他会敲响铜钟引导船只归港。", "constant": false, "disable": false } } } ``` ## AI 能直接读写世界书吗？ 当前由应用在发送消息时自动匹配并加入条目，AI 能看到本轮实际加入的正文；不会因此拿到整本世界书，也没有直接列出或修改已有世界书条目的工具。修改条目请在世界书详情中操作。想让 AI 起草新的世界书，使用 **世界书 → 添加世界书 → 让 AI 设计一本**，生成结果由你预览后导入。 应用使用助手可通过“应用使用帮助”技能读取 help.md；该资料由帮助中心实时生成，包含本篇说明。读帮助不等于能读写你的世界书；原会话已读过旧帮助时，可让它重新读取。 ## 什么时候生效 支持主关键词、正则及始终启用条目；默认扫描最近两条消息。匹配不等于全部加入：条目还受开关、兼容状态和上下文预算限制。聊天的上下文容量中可查看 **世界书** 的匹配数、加入数和实际条目。 世界书用于按条件补充设定，不走普通文档的向量检索。次要关键词、概率、延迟等暂不支持的触发条件会归入 **需要处理** 并停用；在条目编辑页明确处理后才能开启。分组等部分设置仅保留原始信息，实际效果可能与原应用不同。 ## 文件与权益限制 导入文件最大 8 MiB、最多 5000 条目；单次请求最多加入 64 条、24000 字。Pro 到期后数据和挂载保留，可查看、导出、删除或取消挂载，但导入、编辑、开关和触发暂停。权益无法确认时先检查会员状态或重试。 --- # Skill、知识库、系统提示词和记忆怎么选？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/assistant_capability_compare/ ## 一句话判断 - 每轮都必须遵守的身份、语气和短规则，放 **系统提示词**。 - 一套做事方法、操作步骤或可按需读取的多文件说明，做成 **Skill**。 - 产品手册、项目资料、长文档和可检索正文，放 **知识库**。 - 用户偏好、长期事实和以后还要记得的信息，放 **记忆**。 ## 系统提示词 每轮都会进入模型上下文，约束最稳定，但内容越长越占 token。适合短、稳定、始终生效的规则，不适合塞大量参考资料或密钥。 ## Skill 模型需要时通过工具读取，适合工作流、规范和分步骤方法。它可以引用助手环境变量名，但密钥本身不要写进 Skill 文件。 ## 知识库 保存资料正文，可选择全量灌入、关键词检索或建立语义索引后按意思检索。建立索引不修改原文；只用短资料全量灌入时可以暂不建立。 ## 记忆 保存长期偏好和事实，分助手独立与全局共享。它不是文档仓库，也不适合保存 API Key。无痕对话不会写入记忆。 ## 可以组合使用 例如：系统提示词规定回答风格，Skill 规定处理流程，知识库提供产品资料，记忆保存用户偏好。它们不是互相替代，而是分别解决“规则、方法、资料、长期信息”。 --- # 系统提示词 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/system_prompt/ ## 它是什么 系统提示词用来设定 AI 的身份、语气和回答规则。基础提示词按 **对话 → 助手 → 全局默认** 的优先级只选一份，不会自动合并。 ## 在哪里设置 打开 **设置 → 助手与能力 → 系统提示词**,可以自定义或关闭全局默认提示词。它仅在对话和助手都未设置提示词时生效；关闭后仍可使用助手或对话提示词。点右上角 **从文件导入** 可直接读取 .md / .txt 文件，标题、列表和代码块保持原样，比复制粘贴更不易丢格式；导入后点保存才生效。 清空全局文本并保存会恢复默认模板；不需要全局默认时，请关闭 **启用全局默认提示词**。 ## 可用变量 编辑时可以点击插入变量,发送时会自动替换为实际值: - `{{current_date}}` 当前日期、`{{current_weekday}}` 星期、`{{current_lunar}}` 农历。 - `{{current_time}}` 完整日期(含星期与农历,精确到“天”)。 - `{{current_clock}}` 当前时分(精确到分钟)。 ## 助手环境变量 API Token 等密钥不要写进系统提示词、记忆或 Skill 正文。打开 **助手 → 编辑助手 → 提示词 → 变量**,为当前助手新增环境变量,例如 `SILICONFLOW_API_KEY`。变量按助手隔离,切换到其它助手时不会读取或覆盖它。 需要复用时,点击环境变量标题右侧的复制按钮,选择变量和目标助手。同名变量默认保留目标值,也可以明确选择覆盖。复制得到的是独立副本,之后修改任一助手的变量都不会同步到其它助手。 变量不会自动加入模型上下文。只有在助手提示词里显式写 `{{env.SILICONFLOW_API_KEY}}` 时,它才会替换为实际值;这种写法会把值发送给模型服务商,只在确有必要时使用。 需要调用接口时，使用网络请求的宿主凭据代用，或在代码工作台申请服务商凭据后调用 providerFetch。脚本的 process.env 默认为空，不再直接读取这些敏感值；不要把密钥写进 Skill、聊天正文、日志或工具结果。 环境变量会随所选助手包含在备份、导出和碰一碰传送中，选择「分享内容」也会保留。核对页会说明文件含明文凭据；不希望外传时，请取消选择该助手或改用只分享正文的方式，不要把导出包作为反馈附件。 ## 助手提示词工作区 在 **助手 → 编辑助手 → 提示词** 中，「指令」编辑助手设定，「注入」管理补充规则，「开场」设置第一句话，「变量」管理助手环境变量。指令、注入和开场由助手右上角保存按钮统一提交；环境变量单独保存并立即生效。具体操作见「如何设置提示词注入规则？」与「如何让助手先开口？」。 ## 时间变量与缓存 系统提示词位于每次请求的最前面,其中任何时间变量一变化,模型的前缀缓存就要整段重建,导致回复变慢、token 消耗增加。`{{current_clock}}` 每分钟都变,影响最大;到“天”的 `{{current_date}}` 等变量也会在跨天时失效。因此默认模板不再包含时间变量。需要让 AI 知道时间时,建议在工具中心启用 **get_time_info** 工具让模型按需获取,或在编辑助手中开启 **时间间隔提醒**,而不是写进系统提示词。 ## 生效范围 保存后从下一次发送开始生效，包括已有对话；已生成的回复不会改变。不同模型对系统提示词的遵循程度可能不同。 显式启用的提示词注入规则、工具、记忆、技能、知识库和时间提醒仍按各自配置补充内容。需要单独测试基础提示词时，应关闭这些功能并新建对话，避免历史内容影响结果。 ## 会话级覆盖 1.5.0 起,可以单独为某个对话覆盖系统提示词:打开聊天页右上角更多菜单 → **对话提示词修改**,填入要让该对话使用的内容,保存后只影响当前对话,不会改变其它对话。 设置对话提示词后，不再同时使用助手提示词或全局默认提示词。清除后先恢复使用助手提示词；助手也未设置时，才使用已启用的全局默认提示词。 --- # 如何设置提示词注入规则？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/assistant_prompt_rules/ ## 适合什么场景 把每次都要重复的回答格式、补充要求保存为规则。普通身份和语气设定仍写在「指令」；规则会按配置加入后续模型请求，不改写聊天记录，也不会单独发起模型调用。 ## 配置步骤 1. 打开 **助手 → 编辑助手 → 提示词 → 注入**，点击 **添加**。 2. 填写规则名称与正文，选择位置：系统提示词之前、系统提示词之后、对话开头、最新问题之前或指定深度。 3. 对话内的规则可选择系统、用户或助手角色；系统提示词前后的规则按系统指令处理。指定深度从末尾计算，0 表示末尾，超过有效历史时放在开头，工具调用和结果会保持完整。 4. 按需插入日期或环境变量、调整规则顺序，返回列表后开启该规则，最后点击助手右上角 **保存**。 例如，希望每次回答先给结论，可把“先用一句话给出结论，再解释原因”放在「最新问题之前」。同一位置有多条规则时按列表顺序应用，暂时不用时关闭即可。 ## 编辑与用量 切换指令、注入和开场区域会保留草稿；变量插入到正文末尾。规则内容会占用模型输入上下文，可在上下文用量明细查看「提示词注入与开场」。在规则中引用环境变量会将实际值发送给当前模型服务商，不应借此传递密钥。 ## 协议兼容性 当前 Anthropic、Gemini 和 OpenAI Responses 发送方式不支持在对话区域插入独立 system 规则，遇到该组合会提示调整；可改用其他角色、系统提示词前后位置，或关闭对应规则。兼容端点是否接受某种顺序仍取决于服务商；末尾 assistant 内容也可能被模型理解为续写。 --- # 如何让助手先开口？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/assistant_opening/ ## 在哪里设置 打开 **助手 → 编辑助手 → 提示词 → 开场**，选择关闭、固定或生成，最后用助手右上角 **保存** 提交。 - **固定**：填写一段开场白，可直接预览。主动新建普通对话时显示你写好的第一句话，不调用模型。 - **生成**：可填写开场要求，使用当前模型生成第一句话。开启自动开始后，新建符合条件的对话会自动请求；关闭自动开始时，可手动点击 **让助手先开口**。 - **关闭**：由你先发送消息，助手再回复。如果助手挂载了设置开场的世界书，则使用世界书的开场。 ## 什么时候生效 只对主动新建的普通对话授予开场资格。重新打开历史、分叉、导入、无痕及管理会话不会自动开场；用户先发送真实消息后也不会再补一次开场。删除已有消息不会重新触发。 模型开场不会调用工具，不清空输入草稿。失败或停止后需手动重试；已经生成部分正文时，可在该回复上选择 **重新生成**。进程中断不会自动重发请求。导入助手配置后自动生成开场会关闭，需要使用时再主动开启。 ## 是否收费 固定开场和固定文本预览不产生模型请求。生成开场会使用当前模型并产生相应用量，与普通聊天一样遵循服务商计费；开场消息在后续对话中也会作为历史上下文使用。 内置 **Cube 使用助手**预置固定欢迎语，可按相同方式修改或关闭。 --- # 环境变量是什么，怎么使用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/assistant_environment_variables/ ## 先说结论 环境变量是保存在某个助手里的“名称 + 私密值”。它会随该助手持续保存；不同助手可以使用同一个变量名保存不同的值，彼此不会读取或覆盖。它适合保存 Skill 或 JavaScript 工具需要使用的 API Key、Token 等配置，避免把敏感值直接写进聊天消息、系统提示词、Skill 文件、日志或工具结果。 ## 在哪里设置 打开 **助手 → 编辑助手 → 提示词 → 变量**，新建变量名、用途和值，例如 `SILICONFLOW_API_KEY`。列表可按名称或用途搜索，默认不展示值；点条目编辑，点 **插入** 将引用添加到助手指令。需要给其他助手复用时，可用复制功能创建独立副本。 环境变量 **单独保存、立即生效**，不会等待助手右上角保存；放弃助手指令草稿也不会撤销已保存的变量。变量尚未保存时会拦截助手保存，并提示先处理变量草稿。新助手需先保存，再配置环境变量。 ## 怎么使用 - 调用外部接口时，通过网络请求的凭据代用指定当前助手变量，或在代码工作台申请服务商凭据；由应用在获准的 HTTPS 目标上添加鉴权，不把明文交给脚本。 - 助手提示词确实需要引用某个值时，可以写 `{{env.SILICONFLOW_API_KEY}}`。 ## 会自动发送给模型吗 不会。仅仅保存环境变量，不会把变量名或值自动放进模型上下文。 但如果在提示词中使用 `{{env.变量名}}`，发送前会替换成真实值，**这会把该值发送给当前模型服务商**。密钥通常不应通过提示词传给模型；需要调用接口时，优先使用宿主凭据代用。process.env 默认为空，不要打印、写文件或返回敏感值。 ## 备份与导出 环境变量会随所选助手进入完整备份、助手导出和碰一碰传送，分享用途也保留，不会自动去除密钥。文件含明文凭据，请仅保存到可信位置或交给可信接收方；不希望外传时取消选择该助手，反馈中不要附上这类导出包。凭据无法读取时，整次导出会停止。 ## 环境变量和提示词变量的区别 - `{{current_date}}`、`{{current_clock}}` 等提示词变量由应用生成，用于日期与时间。 - 助手环境变量由用户保存，主要承载外部服务配置和敏感值。 - 代码工作台的 `process.env` 默认为空；外部接口鉴权使用宿主凭据代用。`{{env.KEY}}` 会把实际值插入提示词并发送给模型。 --- # 知识库挂载 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/knowledge_base/ ## 知识库是什么 知识库是一个可包含多个文件的资料容器,可挂载给助手。适合放项目文档、产品手册、术语表、固定参考资料等内容,避免每次对话都手动粘贴。一个知识库内可以导入多份不同格式的文件,统一管理。 ## 保存与备份 知识库保存在本机，连接 Cube Agent 在线服务不会自动备份。可从知识库首页的 **备份与恢复** 进入数据备份页，选择华为云盘、WebDAV 或 SMB 保存备份。SMB 需要先配置可访问的共享目录。卸载或换机前请确认备份成功；重装后先检查已有备份，再选择恢复。 ## 多级文件夹与搜索 进入某个知识库后可新建文件夹，逐级进入目录，通过路径导航返回上级或祖先。文件夹菜单支持重命名、移动和删除空文件夹；非空文件夹需先处理其中内容，不能移入自身或子目录。 文档菜单可以移动文件，多选后可以批量移动到目标目录。新建文本和导入资料默认进入当前目录。未搜索时，全选作用于当前目录；在标题栏搜索文件名或来源文件名时会跨文件夹查找，全选只作用于搜索结果，切换目录或关键词会清空原选择。 系统文件夹和普通文档 ZIP 导入保留有效资料的相对层级；多文档导出为带目录的 ZIP。合并知识库时，以来源库名创建子目录并保留层级。仅导出文档不等于整库备份，未选中文档所在的空目录不会随文档包导出。 ## 跨知识库移动文件 多选文件（或单个文件菜单）选择移动时，目的地弹窗会显示当前知识库。点 **切换知识库** 选择另一个文档知识库，再选择库内的文件夹；库根目录是该库最外层，不是系统文件夹。世界书不能作为目的地，文件夹本身只能在库内移动。 - 文件的正文、原件、草稿和历史版本会一起移走，目标库有同名文件时自动加序号，不会覆盖。 - 跨库移动后关键词检索可直接使用，向量索引需要到目标库重新建立。 - 文件正在索引、识别、优化或导出时不能移动，请等待完成后再试。 - 移动过程中可点 **停止后续移动**，已完成的保留在目标库，其余仍在来源库。 移动目录或文档不会改写正文、文档身份或已有索引。检索结果带目录路径以区分同名资料；助手仍按整库挂载，全部索引与覆盖率也仍按整库计算。目录最多 16 层、每库最多 2000 个；旧版可能丢弃目录字段，请使用支持目录功能的版本恢复和维护新目录。 ## 复制知识库文件到工作区 在普通会话中让助手“把知识库里的这份文件复制到工作区”，即可本地复制到当前会话的 outputs 目录，并显示文件卡片。需要当前助手启用“管理知识库”和来源知识库。默认复制保留的 PDF 或图片原件，其他文档复制为 Markdown；也可以明确要求复制当前 Markdown 正文。同名自动加序号，原件及索引保留，无需 AI 读取或重写全文。 未保留的 Office / EPUB 原件不能由导出恢复；无痕会话不保存工作区文件。知识库之间的复制与复制到工作区是两个独立操作，分别遵循设置中的确认策略。 ## 怎么导入 打开 **设置 → 知识库**,点击 **导入** 或进入某个知识库详情点 **导入文件**。支持文本(`.md`/`.txt`)与文档(`.pdf`/`.docx`/`.xlsx`/`.ofd`/`.ppt`/`.pptx`/`.epub`,自动抽取正文;EPUB 电子书整本转为 Markdown),文件选择器只显示支持的格式。文本文件导入时会自动识别编码(UTF-8 / UTF-16 / GB18030,覆盖 GBK 老文件),无需手动转码。已有知识库时会先询问 **导入到哪个库**(新建或追加到已有库);也可以在标题栏点 **新建** 先建一个空知识库,再进详情页慢慢添加内容。 ## 批量导入 文件选择器支持一次多选(最多 100 个)。选中多个文件会进入批量导入页:逐个解析、实时展示每个文件的状态与字数,解析失败的文件可移除后继续,底部一次确认全部入库,完成后直达知识库详情页。文字版 PDF 会自动提取文本；扫描件可保留原 PDF 并标记「待 OCR」，先导入知识库，再从文档中继续识别。 单文件导入会先预览解析结果,你可以选择: - **直接导入**:原样落库(标记为「原始」)。 - **后台优化为 Markdown（可选）**:选择一个已配置的对话模型，确认后先保存原文，再后台清理段落、标题、列表和表格。可以离开页面，在知识库的文档任务中查看进度；优化完成后先预览审核稿，确认采用才替换正文。任务失败时原文仍保留，可重试。 导入时跳过优化也可以稍后处理：在知识库详情通过文件菜单进行单篇优化，或进入多选、选择所需文件后点 **LLM 优化**。每批最多 100 篇，选择一次模型即可排队，全局同时处理最多 2 篇。可离开页面，在任务记录中查看逐篇进度、取消或仅重试未完成项。后台运行仍受系统限制；进程结束后保留中断记录，不自动重复收费请求。 优化不设字数上限。长文档可能耗时较久，也可能超出所选模型的上下文或最大输出长度，导致请求失败或结果不完整，请在采用前核对完整性。 优化先生成待审核稿，不直接覆盖正文。确认采用后才替换当前内容，并保留原文恢复入口；采用导致旧语义索引失效，需要重新建立索引。未选择的文件不受影响。 ## 直接导入 ZIP 在知识库页选择 **导入知识库（压缩包）**，选择本应用导出的文档 ZIP，再选择新建知识库或追加目标。也可以从某个知识库详情的同名入口直接追加。预览文件列表后确认导入，无需先手动解压。 支持文档 ZIP 和可识别的普通文档压缩包；本应用导出的清单会校验正文与完整性信息。压缩包最多 256 MiB、展开后最多 256 MiB、每次最多 100 篇文档。整应用备份包请使用 **设置 → 数据与同步 → 数据导入**，不要从知识库文档入口恢复。 ## 多选删除 进入知识库详情的多选模式，勾选文档后点 **删除所选**，确认数量后删除。取消确认会保留选择；删除只处理所选文档及其索引，保留知识库和未选文档。删除后不能从该知识库直接撤销，请先导出需要保留的正文。 ## 重命名与导出 知识库与库内文件均可重命名；只修改显示名称，不改变正文、索引或挂载关系。已授权的助手也可通过 **管理知识库** 提交改名操作，默认确认面板显示原名与新名；按已设置的该助手重命名授权策略执行，仍核对原名称。 从文件菜单或多选操作栏可以导出：单篇保存为 Markdown，多篇打包为 ZIP，并附来源及完整性清单。准备完成后再选择保存位置，取消保存仍可稍后继续。导出的是当前已保存的正文，不含原始 PDF/Office 附件、未采用的优化稿、语义索引或本地解析图片。知识库检索使用解析正文，图片本身不会自动成为视觉检索内容。 ## 手写新建文本 在知识库详情点 **新建文本**,可直接填写文件名与正文落库,适合笔记、设定、规则等不必先从外部导入的内容。已有文本文件也可进入编辑页修改。 ## 在对话里直接入库 和助手讨论出一个结论后,不必先生成 Markdown 文件再下载、再回来导入。为助手开启 **助手 → 编辑助手 → 工具 → 管理知识库**，并在 **助手 → 编辑助手 → 知识** 中启用目标知识库后，可以直接在对话里说「把刚才这段存进 XX 库」，或者只说「存进知识库」，让助手按需列出已启用的库后选择。关闭或未挂载的库不能被列出、读取或写入，开启管理工具也不会扩大权限。助手能做的操作有: - **新增笔记**:把讨论结论整理成一篇新笔记写入某个库;目标库不存在时可顺带新建。 - **追加**:把补充内容接到已有笔记末尾,避免同一主题散成很多篇。 - **局部修改与中间插入**:只替换指定的一句话或一段内容，也可以删除片段、在指定标题或段落前后插入新内容。助手定位原文后只提交相关片段和新增文字，减少读取和重写全文带来的 token 消耗。 - **复制文件**:在同一个知识库或两个已启用的知识库之间复制文件，可指定目标目录和副本名称。正文、原始附件与修订文件在本地复制，保留源文件，同名自动加序号，无需 AI 手抄。复制默认不建立语义索引，可在确认卡开启，使用目标库的向量模型配置。 - **覆盖**:整篇重写一篇已有笔记。 - **删除**:删掉某一篇笔记(不支持删除整个知识库,那仍需去知识库中心操作)。 - **查阅**:列出知识库与文件、按关键词定位原文或分段读取笔记。查阅是只读操作,不会打断你。 例如，可以说「把售后知识库《服务说明》里的服务期从 7 天改成 15 天，其他内容保持原样」，或「在这篇笔记的『退款流程』标题前插入以下说明……」。复制时可以说「把售后库的《服务说明》复制到培训库的新人目录，命名为《服务说明副本》」。描述清楚来源和目标即可，无需自己复制整篇原文。只需在末尾补充时，可以直接说「在这篇笔记末尾追加……」。 默认每次写入都会在对话里弹出 **入库草稿卡**，确认后才落库；点取消则不写入。可在 **工具服务 → 授权 → 知识库管理** 按新建笔记、导入文件、复制文件、导入并追加、追加内容、修改正文、重命名文档／知识库、新建文件夹、移动文档和删除文档分别设置。选择全局默认，或选择助手设为 **跟随 / 询问 / 允许**；助手的单项设置优先于全局。可点击 **确认策略** 右侧的 **批量允许**，勾选操作并一次确认；删除默认不勾选，未选操作保持原设置，助手的批量授权仅影响当前选中的助手。同一行的 **重置** 可将当前对象全部改为询问；助手还可全部跟随全局，清除单独设置（全局已允许的操作仍会直接执行）。草稿卡的 **此助手始终允许此操作** 只保存当前助手当前操作的授权。授权仅保存在本设备，不随备份或分享迁移，可在授权页撤销；新建知识库并挂载仍每次确认。始终允许不会开启管理工具或扩大助手可访问的知识库范围，覆盖与删除仍检查内容版本。新增或整篇覆盖时可以检查正文；局部修改时会展示 **修改对比**，列出原文和替换后的文字。可以编辑替换文字，留空表示删除该片段。默认只替换唯一匹配的原文；要修改所有相同内容时，请明确说明「全部替换」，并检查卡片上的提示。原文找不到、匹配不唯一或编辑期间内容已变化时，助手需要重新定位或读取后再提交。 新增、导入或修改成功后，默认只为这一条新内容建立语义索引(需要已配置知识库向量模型)，未配置时会跳过并提示；复制文件默认不自动建立索引，减少单纯复制的向量化消耗。可在确认卡调整索引开关，或稍后到详情页手动整理。副本不继承原文件的向量索引；关键词检索与全量灌入不受影响。 技能中心内置了一个 **知识入库** 技能,挂给助手后会约束入库前的归纳格式(标题、结论、要点、来源与日期),避免把整段对话原样塞进知识库。 ## 标签整理 可在知识库详情为资料添加多个标签,例如“项目 A”“产品资料”或“待整理”。标签会显示在知识库列表中,方便快速筛选和辨认同类资料。 ## 语义索引与后台保活 需要语义检索时,可在详情页摘要卡点 **为全部文档建立索引**，也可以在单个文件卡上手动触发。未配置向量模型时会直接弹出选择器,选完自动继续。索引进行中可切到后台继续(continuous task 保活),不必一直停在页面;建立失败会显示具体数量,可点重试。导入时的正文优化同样支持后台继续。 ## 怎么挂载给助手 进入 **助手 → 编辑助手 → 知识**,打开需要的知识库开关。除了逐个选择,也可以按标签一次选择或卸载一组知识库。挂载以整个知识库为单位(库内全部文件一起生效),可选择装载方式: - **全量灌入**:把知识库全部文件正文聚合后注入请求上下文。适合短资料、规则手册。 - **按需检索**:不主动塞进上下文,模型需要时通过 `search_knowledge_base` 检索相关片段。适合长资料、多文档合集。 ## 混合检索(关键词 + 语义) 按需检索模式下,系统会同时执行关键词检索与语义向量检索,融合后返回最相关的片段(仅在配置了 Embedding 模型时启用语义路)。未配置 Embedding 模型时自动降级为纯关键词检索,不中断对话。 在 **设置 → 模型与用量 → 默认模型 → 知识库向量化** 配置全局 Embedding 模型,或在单个知识库详情里覆盖使用不同的 Embedding 模型。在详情页切换某个库的向量模型后,旧索引会失效,需手动点 **为全部文档建立索引** 重新建立,不会自动全量重跑。 ## System 与 @Depth 全量灌入时可以选择注入位置: - **System 设定**:并入系统提示词,更稳定,也更适合长期规则。 - **@Depth 深度**:把资料插到靠近最近消息的位置。深度越靠近末尾,模型越容易关注;适合临时性更强、需要提高注意力的资料。 ## 和技能的区别 技能更像"做事方法 + 可按需读取的多文件资料",适合工作流、规范和工具使用说明。知识库更像"可检索/可注入的资料正文",适合把文档内容挂给助手长期参考。 ## 注意事项 全量灌入会增加上下文长度和 token 消耗。同一次对话中所有全量灌入的知识库合计最多 100 万字符,且不超过当前模型上下文窗口的一半(按估算 token 计,模型未填写窗口时只按字符上限),超出部分按挂载顺序和文件顺序截断,模型会看到截断提示和未灌入的文件数;超过 20 万字符的大文本建议优先使用按需检索并建立向量索引,检索不受长度限制且更细致。知识库正文与向量索引保存在本机文件目录中;删除知识库会自动解除所有助手挂载。使用备份/恢复可完整携带知识库的多文件内容与向量索引,恢复后可直接复用向量无需重新计算。旧版本(单文件知识库)在升级后会自动迁移为含单文件的新模型,挂载关系完整保留。 ## 合并知识库 在知识库列表可以把多个知识库合并为一个，常用于整理重复或同类资料。合并会把所选知识库的文件汇聚到目标库，原知识库的挂载关系也随之转移到目标库。若个别文件迁移失败，涉及的源库会整库保留以防内容丢失，完成时会展示迁移/失败/保留的具体计数。 ## 最佳实践 - 合并前确认目标知识库命名清晰，便于合并后分辨来源。 - 合并不会自动建立索引；完成后可点 **去建立索引** 直达新库，用摘要卡的 **为全部文档建立索引** 一键完成。 - 合并是文件汇聚、原库会被整合，重要资料建议先备份再操作。 --- # 知识库“建立语义索引”是做什么的？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/knowledge_indexing/ ## 先说结论 建立语义索引会把知识库正文切成片段，再用 Embedding 模型生成向量，供按需检索理解“意思相近但用词不同”的问题。**它不会修改知识库原始正文。** ## 不建立索引还能用吗 能： - 使用 **全量灌入** 时，助手仍会直接读取知识库正文，不依赖语义索引。 - 使用 **按需检索** 时，仍可降级为关键词搜索。 - 区别是没有语义向量检索。用户换一种说法、正文里没有相同关键词时，更容易漏掉相关片段。 ## 和“优化正文为 Markdown”有什么区别 - **优化正文为 Markdown**可在导入预览或知识库详情的单篇/多选操作中进行，由对话模型清理段落、标题、列表和表格。导入预览会先保存原文再创建后台任务，离开页面后继续。优化结果先生成审核稿，确认采用后才替换正文；可以预览、重试或恢复原文。 - **建立语义索引**可在知识库列表顶部一键处理全部知识库，也可在单个知识库详情里进行，只生成检索用的分块和向量文件，不改原文。 ## 什么时候需要建立或重建 - 知识库较大，并使用按需检索时，建议建立索引。 - 新导入或修改正文后，需要为相应文件建立索引。 - 更换 Embedding 模型后，旧向量与新模型不匹配，需要重新建立。修改全局默认向量模型时，跟随默认模型的知识库会标记索引过期；单独指定覆盖模型的库不受这次默认切换影响。只标记过期，不自动删除原文或立即重新建立索引。 - 只使用短资料的全量灌入时，可以暂时不建立。 ## 一键为全部知识库建立 有文件还没建立索引时，知识库列表顶部会显示待处理数量。点 **全部建立**，会按列表顺序逐个处理所有知识库里未建立、上次失败或被中断的文件： - 卡片上的圆环显示本轮进度，下方显示正在处理的知识库和文件。离开页面也会继续；切到后台时会尽量保持运行，若被系统中断，再点一次即可接着处理。 - 可以随时点 **停止**。已完成的文件会保留；处理到一半的文件下次从已保存的分段继续，已保存的分段不会重复请求。 - 遇到向量服务鉴权、额度或限流等问题时会自动暂停，使用同一模型的其余知识库不再继续请求；处理好后点 **继续** 即可。 - 个别文件失败不影响其他文件，失败原因可在对应知识库的文件上查看。 ## 需要什么 语义索引需要先配置可用的 Embedding 模型。入口在 **设置 → 模型与用量 → 默认模型 → 知识库向量化**，也可以在单个知识库详情里指定覆盖模型。未配置时，点击建立索引会先打开模型选择器；在知识库列表顶部选好模型后，会自动开始为全部知识库建立索引。 --- # 如何让 AI 操作网页？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/agent_browser/ ## 先准备好 对话浏览器需要 **Pro、API 23 或更高版本的设备系统，以及支持工具调用的聊天模型**。在普通对话的 **工具** 中勾选 **网页操作**，再直接描述任务，例如： > 打开百度搜索 DeepSeek，进入官网找到 API 文档，查看更新日志最新一次更新，并保存页面中的 Logo 到当前对话的工作目录。 浏览器可以由 AI 按任务需要打开，也可以在当前对话的 **工具 → 网页操作 → 打开浏览器** 中手动打开。你可以先输入网址、登录常用网站，再让 AI 使用；手动浏览本身不发起模型调用。AI 会实际访问页面、输入、点击和翻页；与联网搜索返回摘要、网页抓取读取正文是不同的工具。浏览任务使用当前模型的调用额度，不包含无限模型用量。 AI 的点击、输入、按键和滚动由应用自研的网页操作引擎以真实输入事件完成，富文本编辑器和内嵌页面里的元素也能操作。需要大量重复点击或翻页时，AI 可以在代码工作台里写一段脚本连续操作当前网页，运行卡片显示进度，你接管网页即可中断脚本。AI 还可以截取整页长图，或只截页面中的某个元素。 ## 在哪里看进展 手动或由 AI 打开网页后，当前对话工具栏会出现 **浏览器** 入口；AI 浏览时，消息中也会显示当前页面与进展。点击可展开真实网页，收起后继续在聊天里看进度。AI 正在操作的标签会显示主题色、Cube 工作动效和「AI 操作中」。 **查看不会暂停任务**，切换到另一个标签查看也不会改变 AI 正在操作的标签。可以按需要新建标签页，不设固定数量上限；四点菜单可关闭当前页或其他页。关闭 AI 正在操作的标签会打断当前任务。这里是浏览器标签页，不是多个独立应用窗口。 为节省内存，所有对话中既不在屏幕上查看、也没有任务在用的闲置标签最多保留 3 个，较久未用的会自动休眠；系统内存紧张时会释放全部闲置标签。休眠的标签仍在列表中，再次查看或 AI 需要操作时按原地址重新加载，页内未提交的输入和滚动位置不会保留。AI 任务进行中（包括你接管或等待回答时）正在操作的标签不会休眠。 ## 网页兼容与长文读取 浏览器四点菜单的 **网页版本** 可在自动、手机版、电脑版之间切换，作用于当前标签页并刷新，同时记为新标签页的默认值；AI 操作期间不可切换。也可以让 AI 按需切换当前标签的桌面／移动 UA、前进后退、刷新、停止加载，等待页面内容出现，或分段读取长正文。UA 是网站兼容设置，不等于完整模拟手机或电脑。切换 UA 会重新加载页面；有未提交表单时先处理草稿。页面正文读取不代表绕过网站登录与访问限制。AI 浏览时，网页跳转留在浏览器内，不会拉起手机上已安装的对应应用；你自己浏览时保持系统默认。 ## 我想自己操作 浏览器顶部左侧是 **返回聊天**，右侧按钮可接管网页、继续任务或回答当前问题；输入区只在需要时展开，平时不占用网页空间。 同一时刻由一方操作：点顶部 **AI 接管中** 切换为用户操作，等交接完成后即可操作原网页；完成后点 **继续任务** 让 AI 继续。需要增加说明时，从四点菜单选择 **补充要求**；手动打开、尚无任务时，点顶部 **让 AI 操作** 输入第一条任务，消息会进入当前对话。输入区可随时收起，未发送的草稿会保留。等待登录、验证码等问题时，点 **回答并继续**，即可在网页内回答原问题，无需返回聊天；跳过问题不会继续。聊天预览卡中的 **我来操作** 入口仍可使用。任务结束后网页可自由操作，新的浏览器任务会自动开始，**不需要先释放控制权，也不逐次确认普通跳转、搜索和资源保存**。 ## 遇到登录、扫码或验证码 这些步骤由你在原网页完成，账号密码不需要发到聊天里。可给助手启用 **向用户提问**：模型提出等待问题后，你直接操作浏览器，完成后在网页内点 **回答并继续**，或回到聊天中的原提问卡片回答「已完成」，AI 会重新查看页面，再继续原任务。两处回答的是同一个问题，不会重复开启任务。跳过或取消问题不会自动继续；没有启用提问工具时，可点顶部 **继续任务**，或从四点菜单的 **补充要求** 发送说明，也可以回到聊天继续。 ## 保存图片与文件 直接要求「把这张图片保存到当前对话工作目录」，AI 会尝试保存网页中可访问的原始资源，成功后在聊天中提供文件卡，可从本对话工作目录查看和导出。保存的不是网页截图；如果网站只提供缩略图，得到的仍可能是缩略图。小尺寸位图可打开原生图片预览，再点 **超清增强**，具体条件见同名帮助。账号权限、防盗链或网站限制可能导致下载失败。 ## 切换聊天、后台与网站数据 切换到其他聊天或把应用放到后台时，运行中的任务会继续尝试执行，回到当前对话即可查看进度；系统节电、进程回收或网络中断仍可能影响任务，不保证无限后台运行。退出或重启应用后，当前标签页不会自动恢复。 Cookie、登录状态与站点存储按网站规则保留在设备上，关闭标签或删除对话不等于退出网站账号。当前没有按对话隔离账号、多账户配置或逐站清理入口，需要退出账号时请在网站内退出。**无痕对话暂不启用此浏览器**。 ## 打开本地 HTML 启用 **网页操作** 后，可让 AI 打开当前会话工作目录或已发送附件中的 HTML，例如 /workspace/outputs/site/index.html。关联 CSS、JavaScript、图片与 JSON 需要保留目录关系，多文件页面可先导入工作目录。AI 可继续读取、点击、输入和刷新；修改文件后刷新可读取新内容。 该能力用于当前会话的静态文件，不提供后端服务，也不允许访问工作目录之外的任意设备路径。它与消息内的 HTML 代码预览入口不同，沿用网页操作的 Pro / API 23 要求。 --- # 内置模型在部分地区连接失败怎么办？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/builtin_network/ 内置模型和免费试用网关会检查当前网络的解析与连通性。检测到回环或私网等异常解析，或直连连接失败时，可以自动使用 **DoH 加密 DNS** 再尝试原 HTTPS 域名，无需手动填写美国服务器 IP，也无需打开额外开关。 DoH 只向 DNS 服务查询域名解析，不把 API Key 或对话内容发给 DNS 服务；模型请求仍发往原网关，保留 HTTPS 证书验证。它主要改善湖北等地区的 DNS 解析异常，不保证解决 TLS/SNI 干扰、服务器故障或所有网络限制。本版没有启用腾讯中继。 应用代理、系统代理、PAC 或 VPN 生效时尊重已有线路。流式回复开始后不切换解析线路；超时或接收失败等无法确定请求是否已执行的情况，不会自动换线重发。关于页的 **模型线路** 可辅助排查，提交反馈时说明地区、运营商和错误提示即可，不要提供密钥。 --- # 工具中心与联网搜索 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/tools/ ## 工具中心是什么 工具中心列出了可供模型调用的内置工具。启用后,模型可以在需要时调用工具补充信息或完成操作。 ## 联网搜索 联网搜索分为两种: - **外部搜索服务**:需要先在工具中心选择并配置搜索服务,填入对应密钥或参数。配置完成后,支持工具调用的模型可以在需要时调用搜索工具获取资料再作答。 - **内置搜索**:由模型服务商直接提供,不使用工具中心里配置的 Exa、Tavily 等搜索服务。只有当前服务商接口和当前模型都支持“内置联网”时,聊天输入框的联网菜单里才会显示“内置搜索”。你也可以在模型编辑页调整“内置联网”能力开关。 ## 可选择的外部搜索服务 - **Exa**:偏 AI 搜索 API,适合给模型补充网页结果与摘要。官网:[https://exa.ai](https://exa.ai) - **Tavily**:面向 AI Agent 的搜索 API,配置简单,适合通用联网检索。官网:[https://www.tavily.com](https://www.tavily.com) - **DeepSeek**:使用 DeepSeek API Key 提供网页搜索与 Markdown 正文抓取，可单独配置搜索密钥和 Base URL。文档:[https://api-docs.deepseek.com/zh-cn/guides/search/](https://api-docs.deepseek.com/zh-cn/guides/search/) - **Firecrawl**:偏网页抓取、解析和内容提取,适合需要读取网页正文的场景。官网:[https://www.firecrawl.dev](https://www.firecrawl.dev) - **秘塔搜索 / Metaso**:适合中文搜索场景,可在搜索 API 控制台申请和查看用量。入口:[https://metaso.cn/search-api/playground](https://metaso.cn/search-api/playground) 这些服务通常都会提供一定免费额度,轻量个人使用一般足够。具体额度、重置周期和计费方式会调整,以服务商控制台和最新价格页为准。 ## MCP 工具 服务地址末尾的斜杠会保留，部分服务的 /mcp/ 与 /mcp 不是同一个端点。若旧版保存时已裁剪地址，请按服务商提供的完整地址补回并刷新工具。零工具、鉴权失败和无效响应会分别提示；HTTP 成功不等于已发现可用工具。 MCP Server 可以把外部系统能力接入为工具。打开 **设置 → 助手与能力 → 工具服务**,切到 **MCP 服务** Tab,点 **新增** 进入 MCP 服务编辑页,填写服务地址、认证方式和请求头;也可在编辑页使用 **JSON 快速导入**,直接粘贴标准 MCP JSON,应用会自动识别可导入的服务并填入连接配置。 JSON 导入兼容根级 `mcpServers`(Claude 等)与 `servers`(Cursor / VS Code Copilot 等);`type=http` / `sse` / `streamable-http` 等常见别名也可识别;也可省略 type,按 url 或 command 自动推断传输方式。华为等标准远程 MCP 配置一般可直接粘贴导入。 支持三种连接方式： - **流式 HTTP**：大多数远程服务，地址一般以 `/mcp` 结尾。 - **旧式 SSE**：地址以 `/sse` 结尾时自动按 SSE 连接，魔搭、百炼等 MCP 广场的 SSE 地址可以直接用。 - **本机运行（stdio）**：地址栏直接填启动命令，例如 `uvx mcp-server-time`，或粘贴带 `command` / `args` / `env` 的 JSON。服务会在应用内置的 Python 环境里运行，首次保存时自动安装，需要的 API Key 填在「环境变量」里。只支持 Python 写的服务（`uvx`、`pipx run`、`python -m`）；需要 Node.js（`npx`）、Docker 的服务无法在手机上运行，可改用它的远程地址。依赖需要编译的原生库时也可能装不上，编辑页会显示具体原因。 进入某个 MCP Server 详情后,顶部更多菜单提供刷新、编辑和删除。工具列表支持按名称或描述搜索。每个工具右侧的 **询问 | 允许** 决定调用前是否先问你,开关只控制工具是否启用。聊天中对某个工具点 **始终允许** 后会立刻生效,无需退出重进页面。所有 MCP 服务和工具的授权也可在 **工具服务 → 授权** 统一查看和修改。 在聊天里按对话开启 MCP：打开输入框工具栏的 **工具 → 选择工具**，在 **MCP 服务 · 仅当前对话** 中打开某个服务的开关，应用会立即连接它并获取工具列表，卡片上显示 **已连接 · N 个工具**；连接失败时卡片会给出原因，并提供 **重试连接** 等按钮。只有为本对话开启的服务才会连接。当前对话已开启的服务排在前面。 为避免工具过多导致渲染、持久化或请求体过大,单个 MCP Server 最多保留 256 个工具;新发现的工具默认只启用前 64 个,其余可在详情页手动启用。 ## OAuth 授权与连接恢复 服务要求网页登录授权时，在认证方式中选择 OAuth，按服务方要求填写 Client ID、权限范围等信息，再从应用进入授权流程。预注册 Client ID 与客户端元数据地址是不同配置：同时填写时优先使用预注册 ID；两者均留空时是否可用取决于服务是否支持动态注册。不要自行猜测这些值。 授权完成后应用复用有效令牌；权限不足或授权失效时，按提示重新授权。连接失败会保留服务配置，可修正地址、认证或网络后重试。授权成功不代表所有工具自动获准执行，仍需设置工具开关和「询问／允许」。当前不承诺支持 MCP 的任务、采样或交互式表单等可选扩展。 ## 常用内置工具，各做什么 - **文件操作**：直接创建、读取、精确编辑、追加、合并、复制、移动和删除工作区文件。TXT/Markdown 可按指定顺序在本地合并，不需要模型重新输出全文。只改一段文字时用编辑，复制文件不需要先读出全文再写回。模型调用名是 `file_operations`。 - **Office 文档**：读取、生成、修改 Word / Excel / PPT，生成离线预览并交付文件。只开启这一个工具即可使用，操作说明由工具按需提供，无需另外开启技能或代码工作台。 - **代码工作台**：默认用 Python 运行代码，适合表格筛选统计、数据分析、画图和批量处理文件；技能里写的命令行（如 `python scripts/x.py`、`pip install`）用 bash 执行。JavaScript 只在需要代管服务商密钥或无痕会话时使用。模型调用名是 `run_code`，旧版 `eval_javascript` 配置仍兼容。 - **网络请求**：访问网络服务、上传或下载文件，调用名是 `http_request`。单次联网优先用它；需要多步计算时才由 JavaScript 编排。外部目标、局域网或凭据使用按本次操作确认。 - **生成图片**：用你选择的生图模型生成或修改图片，图片直接显示在对话里并保存到本对话的 `outputs/`，网页、文档等后续任务可以直接引用。生图模型在本行的 **换模型** 中切换，与图像生成工作台共用同一个设置。 - **向用户提问**：需要你做决定或补充信息时，提问卡会直接占据输入区，一次最多 3 题、左右切换作答，离开对话后已填的回答会保留，支持单选、多选、下拉选择（选项较多时）、滑块取值（如时长、数量、比例）和文字回答，可以只答一部分或整轮跳过。滑块回答会告诉 AI 你是否调整过默认值。模型调用名是 `ask_user`。 ## 工作区与文件交付 当前会话通过 `/workspace` 虚拟工作区访问文件，写入 `outputs/` 的产物会显示为可打开、保存的附件。输入附件和已启用的 Skill 资源只读；其他会话、应用数据库和内部配置不属于脚本的访问范围。共享资料可按需读取；AI 删除共享文件免费，复用文件操作的本次允许或始终允许，授权后无需额外确认。存入、新建目录和移动共享文件需要 Pro 与用户授权；共享根目录、输入附件和 Skill 资源仍受保护。 创建文件只需提供正文与目标路径，不必先在回复里重复粘贴正文。写入成功后，通常无需再读一遍或再次列目录来确认；用户要求内容校验、结果不明确或确有结构验证需要时才检查。成功写入不等于已经验证内容质量。 ## 结果与详情为什么不同 文件写入等操作默认展示简洁回执，例如成功状态、相对路径、实际新建或修改以及字节数；后续请求也使用这份回执，减少重复附件信息和设备内部路径进入上下文。展开后的 **详情** 保留本地执行记录，附件仍可打开、保存；查看详情和复制不会重新执行操作，也不额外调用模型。 正在读取的正文、计算结果、非空日志、HTTP 响应和关键错误会保留。结果较大时按工具已有范围读取或落盘规则处理，截断会明确标识，不能把一段预览当成完整内容。MCP 与不认识的历史结果不按内置工具规则删字段。文件已部分修改后发生失败或取消，不代表先前操作自动回滚。 这不是新的付费或配置选项，也不会再用模型总结工具结果。节省的是部分工具回执进入请求的开销，文件正文参数仍需传给模型服务；实际费用以服务商返回的用量为准，不保证固定节省比例。 ## 代码工作台支持范围 Python 是完整的 Python 3.12，自带 pandas、numpy、openpyxl、matplotlib（已配中文字体）、Pillow 等常用库；python-docx、python-pptx、pypdf、pdfplumber 等常见库在首次用到时自动安装（需要联网），装好后长期保留。在「设置 → Python 运行环境」可以查看已安装的包或一键清理。不能运行系统程序（如 LibreOffice、Node.js），需要编译的 Python 包也装不上，AI 会改用纯 Python 的办法。 bash 不是系统 Shell，而是在应用内模拟常用命令：python、pip、git、ls、cat、grep、find、cp、mv、zip、curl 等。不支持 `$(...)`、heredoc 和后台任务，遇到不支持的程序会提示改用 Python。 git 可以克隆、提交、切换分支、合并和推送，只支持 HTTPS 地址，不支持 SSH。私有仓库或推送需要在地址里带上访问令牌（如 `https://令牌@github.com/用户/仓库.git`），令牌会保存在这个仓库的配置里。仓库里的符号链接会变成内容为链接目标的普通文件。 JavaScript 使用 QuickJS，没有网页 DOM 或 Node.js 运行时，主要用于代管服务商密钥的接口调用和无痕会话里的计算。 **Word / Excel / PPT 生成**无需 Pro。在当前聊天的工具选择中勾选 **Office 文档**，即可用自然语言要求生成文件。无需另开技能或代码工作台。完整步骤、示例和限制见帮助篇目「如何生成 Word、Excel 和 PPT 文件？」。 ## 联网、下载与取消 如脚本返回 **E_JS_TIMEOUT**，先检查循环是否正常推进，不要原样重试或只增加超时时间。生成 Office 文件失败后先检查工作目录中是否已有完整产物，再修改脚本重试，避免重复生成；诊断信息可帮助模型定位耗时步骤。 JavaScript 的联网目标需要明确授权；网络请求与代码工作台共用文件和网络检查。保持 TLS 校验，不自动跟随重定向；返回跳转地址后，新的目标需要重新确认。大响应优先保存文件，再按范围读取，不要为查看详细结果重复下载。 代码执行有时间、内存和输出限制。点击停止后会通知执行器取消，未提交的文件不会覆盖原文件；已完成的操作仍可能保留。不要把停止后的一条错误当成可以无条件重复执行写入、上传或发布的理由。 ## 助手配置与当前会话工具开关 工具是否可用还取决于助手配置和当前会话选择。在 **助手 → 编辑助手 → 工具** 中配置助手的工具；聊天页输入框工具栏的 **工具 → 选择工具** 调整当前会话的内置工具和 MCP Server，不会改写助手配置。代码工作台需要在当前会话中明确勾选，启用技能不会自动代为开启。 两处工具都按用途分组：基础能力、处理文件、创作、联网与设备、进阶（默认收起）。不知道选哪些时，点顶部 **推荐组合 → 一键开启**，推荐组合包含获取时间、向你提问、查看图片、资料目录、文件操作、Office 文档和代码工作台（获取时间和向你提问只在助手编辑页开关），只增加、不关闭已开的工具。新建助手默认就选好这一组，已有助手不受影响。工具上的 **可修改** 标签表示它可能改动文件、日程等数据；浏览器和远程连接需要 Pro。 其中 **管理技能** 和 **管理知识库** 是助手级写工具,只能在助手编辑页开关,不出现在聊天页的工具选择器里。开启后模型可以在对话中创建/更新 Skill、维护知识库笔记,管理技能写入仍需草稿确认；知识库写入默认询问，可在工具服务的授权页按操作设置全局默认和助手覆盖。未授予始终允许时，可在草稿卡修改内容或取消。「管理知识库」的查阅动作(列出知识库、读取笔记)是只读的,不会打断你。 ## 接口密钥与助手环境变量 在 **助手 → 编辑助手 → 提示词 → 变量** 保存所需值后，网络请求可按授权让宿主代用指定变量；也可申请使用某个服务商的凭据。凭据与本次目标绑定，由应用附加到请求，不以明文交给脚本或模型。JavaScript 的 `process.env` 默认为空，不再使用旧版直接读取密钥的写法。不要将凭据粘贴到正文、脚本、输出文件或日志中。 ## 注意事项 外部搜索服务、MCP 工具和代码工作台是否可用，取决于当前模型是否支持工具调用、工具配置和当前会话选择。内置搜索不要求模型支持普通工具调用，但必须启用模型的“内置联网”能力，并且服务商接口本身支持。 --- # 怎么让 AI 在手机上运行 Python？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/python_runtime/ ## 功能说明 应用内置完整的 Python 3.12，随应用安装，不需要下载或配置。打开 **代码工作台** 工具后，AI 会在需要时直接在手机上运行 Python：表格筛选统计、数据分析与画图、批量处理文件、生成 Word / PPT / PDF 都可以交给它。 - 自带 pandas、numpy、openpyxl、matplotlib（已配中文字体）、Pillow、lxml 等常用库。 - python-docx、python-pptx、pypdf、pdfplumber 等常见库在首次用到时自动安装（需要联网），装好后长期保留。 - 同一对话里算好的变量和数据会保留，后续可以接着处理。 - 技能文档里写的命令行（如 `python scripts/x.py`、`pip install`）用应用内模拟的 bash 执行。 - MCP 服务可以填写 `uvx`、`pipx run`、`python -m` 启动命令，在内置 Python 环境里运行。 ## 怎么使用 1. 在输入框 **工具 → 选择工具** 开启 **代码工作台**（推荐组合已包含）。 2. 把要处理的文件放进对话：用 **@** 引用，或在会话文件里导入。表格、数据类文件放进工作区让 Python 处理，比整篇直接发给 AI 更省上下文。 3. 直接说要做什么，例如「按部门统计这张表的平均分并画柱状图」「把这 20 张图片统一裁成 1:1」。 4. 回复里的代码卡片显示每段代码做了什么、用时多久；展开后可以看输出和代码。生成的文件出现在「生成文件」卡片里，可以预览、保存或分享。 5. 设置 → 连接与高级 → **Python 运行环境** 可以查看运行状态和已安装的包，也可以一键清除自己装的包。 ## 最佳实践 - 需要精确计算、统计或批量处理时，明确说「用 Python 算」，结果比让模型心算可靠。 - 想用 Skill 市场的 PDF、Excel、Word、PPT、海报设计、GIF 动图等技能，安装后在助手中启用，或在输入框用 **/** 指定。技能详情会标出「本机可运行」「部分可用」或「需要外部环境」。 - 不能运行系统程序（如 LibreOffice、Node.js），需要编译的 Python 包也装不上，AI 会改用纯 Python 的办法；依赖 npx、Docker 的 MCP 服务请改用它的远程地址。 - 首次自动安装库需要联网，在弱网下可能稍慢；安装失败时 AI 会看到原因并换用其他办法。 --- # 如何生成 Word、Excel 和 PPT 文件？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/office_generation/ ## 需要 Pro 吗 **生成 Word / Excel / PPT、保存到本机和通过系统分享均无需 Pro。** 文件在本机生成，AI 整理内容仍使用你选择的模型及其额度。把文件新增到跨会话共享文件、发布到公网属于另外的 Pro 功能，不影响普通生成和导出。 ## 开始使用 1. 打开普通会话，选择支持 **工具调用** 的模型。 2. 点击输入框工具栏的 **工具 → 选择工具**，勾选 **Office 文档**。也可在 **助手 → 编辑助手 → 工具** 中设为该助手的默认工具。 3. 提供正文、数据或附件，说明想要的文件名、用途和格式，然后等待生成文件卡片。要修改已有文件时，建议先导入会话文件，见下方「PPT 与现有文档修改」。无需另开技能、代码工作台或管理技能。 ## 可以这样说 - “把上面的讨论整理成一份 Word 项目周报，包含本周进展、待办列表和任务表格，生成项目周报.docx。” - “根据这份会议记录生成 Word 会议纪要，列出结论、负责人和截止日期。” - “生成项目预算.xlsx：设计 3000 元、开发 12000 元、测试 2500 元。金额保留两位小数，增加合计公式，冻结首行。” ## 支持哪些内容 - **Word（.docx）**：标题、三级章节标题、正文、编号或项目符号列表、文本表格；提供工作报告、会议纪要和简洁正文模板，文件可在 Word / WPS 中继续编辑。 - **Excel（.xlsx）**：多个工作表、文字、数值、公式，以及列宽、加粗、数字格式、对齐、边框、表头冻结和筛选；提供预算表、计划表和基础样式。 Excel 公式由办公软件打开后重算，修改表格后预览可能显示“待重算”。需要打开前就能看到合计数值时，可以要求 AI 先计算，再把结果写成数值。编号、前导零和超过 15 位的长数字应作为文本保存，避免精度损失。 ## PPT 与现有文档修改 可以要求“生成两页项目汇报 PPT，分别介绍本周进展和下周计划，交付项目汇报.pptx”，或“把 预算.xlsx 中 B2 的金额改成 15000，保留其他内容并另存一份”。 **修改现有文档，从会话文件导入效果最好**：在聊天页右上角菜单打开 **会话文件 → 导入文件** 导入原文件，再在 **工具 → 选择工具** 中同时开启 **文件操作** 和 **Office 文档**，告诉 AI 要改哪个文件。文件不会随消息整篇塞进上下文，AI 按需读取、在原件基础上修改并另存一份，更容易保留原有格式、样式和公式。如果已经把 Word、Excel 或 PPT 添加为输入框附件，附件上方会出现提示：点 **添加到会话文件** 即可转为会话文件，再点 **开启工具** 一次开启文件操作和 Office 文档。旧版 .doc、.xls、.ppt 需先转为新版格式。直接作为附件发送也能处理，但正文会先被解析成文字随消息发送，适合阅读和总结，修改原文件的效果不如会话文件。 PPT 当前支持基础页面、文本框的文字和排版，以及按比例放入 PNG/JPEG 图片；修改已有文件时保留原件，成功后交付修改稿。内容过多时建议拆页，生成后检查换行和图片布局。 也可要求生成离线 HTML 预览，检查后继续修改。预览的字体与分页可能和 Office/WPS 不同，数学公式暂以文本显示，3D 和外部媒体不渲染；复杂 Office 对象和动画仍未全面覆盖。AI 的浏览器看图检查需要另外启用浏览器工具，并遵循该工具的设备与会员条件。 ## 文件在哪里 回复完成后，展开消息下的 **生成文件** 卡片，可以打开、保存或通过系统分享。也可在聊天页菜单进入当前会话的工作目录查找文件。预览能力取决于当前设备；无法预览时，先保存，再用 Word / Excel / WPS 打开。 ## 已有回答如何变成 Word 如果内容已经在回复里，无需再让 AI 重新生成。打开消息 **更多 → 分享**，在分享面板选 **更多 → Word**，即可导出回答；支持正文、标题、列表、表格、代码和公式，公式会转成 Word 可编辑的原生公式。需要指定模板、改动原文件或生成 PPT 时，再使用 Office 文档工具。 ## 没有生成文件时怎么排查 - 检查模型是否支持工具调用，以及当前会话是否勾选了 **Office 文档**。只在回复中显示正文或表格，不代表已生成可下载的文件；可以明确要求“生成 .docx / .xlsx / .pptx 文件并交付”。 - 无痕会话不创建持久工作目录，生成文件请使用普通会话。 - 当前 Word 不支持插图、页眉页脚或合并单元格；Excel 不支持图表或合并单元格。两种格式的单个生成文件上限均为 32 MiB，内容较多时可拆分为多个文件。 --- # 技能中心与助手技能 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/skills/ ## 技能中心是什么 技能是一组可被模型按需读取的专项指令和资料。它适合沉淀固定工作流、写作规范、项目背景、工具使用说明等内容,避免每次聊天都手动粘贴。 ## 先说清楚作用范围 技能有“内容”和“启用”两层：技能中心中安装的一份 Skill 内容由本应用内的助手共享，但**安装不等于对所有助手自动生效**。每个助手都可以在自己的“技能”页独立打开或关闭同一个 Skill；只有当前助手已启用的 Skill 才会暴露给模型。 也可以从技能这一侧批量设置：在技能中心列表中点技能右侧的 **启用** 或助手数，或打开技能详情的 **概览 → 启用到助手**，一次勾选多个助手，支持全选和反选，关闭面板即保存。Skill 市场中已安装技能的详情页，以及对话中创建技能成功后的卡片，也提供同一入口。 关闭某个助手的开关只影响该助手，不会删除 Skill，也不影响其它助手。相反，编辑、更新或删除 Skill 本体会影响所有已启用它的助手；需要不同规则时，应创建或复制为另一份 Skill。 ## 在哪里管理 打开 **设置 → 助手与能力 → 技能中心**,可以新建技能、编辑技能、删除技能。列表顶部可进入 **技能市场**；上方筛选可只看已启用、未启用或有新版本的技能，标题栏的搜索可按名称和触发描述查找。点标题栏的 **＋**，可以新建技能或分组，从文件导入 zip 或带 frontmatter 的 `SKILL.md` 文本文件，也可以从 GitHub 安装（粘贴公开的仓库、技能子目录或 `SKILL.md` 链接）。 从 GitHub 导入时，先查找技能；仓库内有多个技能时，选择需要的项目，再核对来源、附件和运行条件后安装。安装的是所选技能目录及其附件，不只是 `SKILL.md` 正文。同名技能需要明确确认覆盖；失败项可单独重试。安装后可选择助手启用；从助手编辑页进入时，启用只加入原编辑草稿，仍需保存助手。 **外部技能的运行条件**：受系统与当前环境限制，安装成功不代表所有功能均可直接运行。技能里的 Python 脚本和 `python`、`pip` 等命令行可以用应用内置的 Python 运行环境执行；依赖 Node.js、系统程序或 MCP 的技能可能需要另外配置远端环境或工具。技能详情和导入页会分析运行条件，标出「本机可运行」「部分可用」或「需要外部环境」，并列出已预置和首次运行会自动安装的依赖；缺失依赖不阻止安装。作者未声明依赖时，会提示运行条件未确认，而不会标为已兼容。安装不会自动执行脚本、连接服务或启用工具。 删除 Skill 会同时清理所有助手对它的启用引用，而且当前不可撤销。预置 Skill 删除后也不会在下次启动或版本升级时自动恢复；需要保留副本时，应先在技能详情中导出 ZIP，之后可再导入。 普通和大型技能包均可免费导入；Skill 市场下载和更新也无需 Pro，但需要登录并连接在线服务。文件数量超过 1000 个或解压后超过 50 MiB 时会识别为“大型技能包”，支持海量资料的分段读取和资源定位。GitHub 导入可在安装前查看文件数量与大小。超过安全上限，或包含设备无法可靠处理的超长路径时会拒绝导入，并提示精简目录、缩短文件名或拆分技能包。 ## 预置技能 应用提供多种预置技能，可以按需启用、编辑或删除。例如，`app-help` 可以读取帮助中心、当前安装版本和历史版本的更新说明，回答应用使用和版本变化问题或为技能更新提供依据，`grilling` 帮你逐步澄清方案；「文档转 Markdown」用于转换文档，「ZIP 文件处理」用于配合代码工作台处理压缩包。Word、Excel、PPT 的生成和编辑已由独立的「Office 文档」内置工具提供。 这些内置文档与表格能力无需 Pro。生成文件只需在当前聊天中勾选 **Office 文档**。旧官方文档与表格技能由新工具替代；用户自行修改过的技能会保留。具体步骤见「如何生成 Word、Excel 和 PPT 文件？」。 ## 技能包含什么 - **概览**:技能名称和触发描述等基础信息。触发描述就是 `SKILL.md` frontmatter 中的 `description`,模型据此判断是否需要加载该技能。 - **正文**:技能的主说明,模型调用 `use_skill` 时会读取这里的指令。 - **文件**:技能附带资料。可以上传文本和文档,文档会先抽取为文本后保存到技能文件中。 技能包可附带 `cube-extension.json` 声明版本、来源、运行环境、工具依赖和必备资源，在概览显示“扩展要求”。来源由作者填写，不代表认证。应用会检查清单和资源；安装不会自动启用工具、连接 MCP 或安装运行时。模型加载技能时会得到本轮实际可用的依赖名称。Python 由应用内置环境提供，Node.js 需要另行准备远端环境。删除技能不删除独立配置的 MCP 连接。 ## 怎么给助手启用 进入 **助手 → 编辑助手 → 技能**,打开需要的技能开关。相同的 Skill 可以在助手 A 中打开、在助手 B 中关闭，无需复制一份 Skill；也可以在该区域点 **管理** 跳转到技能中心。 ## 在对话中创建或编辑 先在 **助手 → 编辑助手 → 工具** 中打开 **管理技能**。开启后不需要在对话工具选择器中再次勾选，你可以直接要求助手“创建一个 Skill”“优化并更新某个 Skill”或“恢复上一版”。模型会生成结构化草稿，并在消息中展示名称、触发描述、正文差异和文本附件变更。Skill 名称是展示名，支持中文等任意文本(不超过 64 个字符)；应用会自动生成内部目录标识，与展示名互不影响。编辑现有技能时，如果触发描述未修改，模型可以在工具调用中省略该字段，草稿会继承技能中已保存的值。确认前可以直接编辑触发描述、正文和附件内容。 **只改需要调整的部分**：例如说「把这个技能里要求输出表格的那一段改为分点说明，其他内容保持原样」。助手可以按关键词定位正文片段，再只提交这部分的替换文字；编辑读取默认分段返回，不必为了改一句话读取、重写整个技能。只改触发描述时，也无需重新提交未改动的正文。这能减少编辑时的 token 消耗，实际用量仍取决于模型调用方式和修改范围。此处的局部替换支持技能主正文，技能附件的内容更新仍按单个文件处理。 **根据应用更新调整技能**：在当前助手的 **技能** 页启用 `app-help`，并在 **工具** 页开启 **管理技能** 后，可以说「读取当前版本更新说明，检查我的某某技能需要哪些调整，并生成修改草稿」。助手可搜索或分段读取与 **设置 → 关于 Cube Agent → 更新说明** 相同的内容，再结合帮助主题和实际可用工具核对用法。读取不会自动修改技能，修改仍需你确认草稿。 **问版本变化**：启用 `app-help` 后，也可以问「相比上一版改了什么」「这个功能是哪个版本加的」。助手会读取与 **设置 → 关于 Cube Agent → 历史版本** 相同的随包说明，引用对应版本的原文回答；资料只到当前安装的版本，不包含尚未安装的新版本。 草稿确认后会直接保存到技能中心，并可为当前助手启用；取消则不会写入任何内容。每次覆盖前会自动保存当前内容作为“上一版”，新的正式更新会覆盖更早的备份。恢复上一版时两版会交换，因此误恢复后仍可切回。 更新或恢复现有 Skill 时会在内部校验当前内容是否发生变化。如果编辑期间原文件已经变化，会停止覆盖；草稿卡可直接基于最新版重试。对话内可以新增、修改或删除小型文本附件，但不能删除整个 Skill，也不能访问 `.cubeagent` 内部目录；删除整个 Skill 仍需前往技能中心。 **管理技能** 完全由当前助手的工具开关控制。它控制的是“创建、更新或恢复共享 Skill 内容”的权限，不是某个 Skill 的使用开关。关闭后，即使助手已经启用了其他 Skill，也不能创建、更新或恢复 Skill；会话中的历史工具选择同样不能绕过。拒绝或取消草稿不会修改任何文件。 只有当前助手启用的技能会暴露给模型。对话时,模型会先看到技能摘要,再通过 `use_skill` 按需读取完整正文或文件内容。大型文件会分段读取;大型资料技能可以先按路径关键词搜索资源,避免一次加载整个资料目录。 ## 连接技能账号（如 ima 知识库） 部分技能需要你自己的账号，例如 ima 知识库与笔记。这类技能会在 **技能详情 → 账号连接** 显示连接入口；对话中第一次用到时，结果下方也会出现 **连接** 卡片。点开后按提示打开获取页面，把 Client ID、API Key 等粘贴进去，点 **验证并连接**。 - 只需填写一次。可勾选 **同时用于其他助手**，让已启用该技能的其他助手一起使用。 - 保存的内容只在请求该技能声明的网站（卡片上会写明，如 ima.qq.com）时由应用自动填入，AI 和脚本都看不到内容，也不需要把 Key 发在聊天里。 - 连接成功后对话会自动继续。Key 过期或被重置时，AI 会再次显示连接卡片，重新粘贴即可。 - 技能更新后如果改了发送目标网站，会显示 **需重新确认**，确认前不会自动发送。 - 不想继续使用时，在连接界面点 **断开连接**，会删除已保存的字段。 ## Skill 的接口密钥 Skill 需要调用外部 API 时，把 Token 保存到 **助手 → 编辑助手 → 提示词 → 变量**，在 Skill 中只记录变量名和接口鉴权方式。同一个 Skill 给不同助手使用时，每个助手使用自己的变量。 调用接口时启用 **网络请求**，使用 `http_request` 的 `credential_env` 指定变量名、`url` 指定真实 HTTPS 接口地址；应用读取当前助手的变量并附加到请求头。`credential_header` 默认为 Authorization，`credential_prefix` 默认为“Bearer ”（末尾有空格）；按接口要求设置，自定义请求头直接传密钥时将前缀设为空字符串。不要把 Token 写进 Skill、聊天正文或脚本。 ## 旧技能提示 process.env 为空怎么办？ 代码工作台不会注入助手环境变量。旧技能要求读取 `process.env.ZHIHU_ACCESS_SECRET` 等变量时，应将其请求步骤迁移到上述宿主凭据代用；可先用 `assistant_env list` 核对变量名，无需用 get 将值返回给模型，也无需重新在对话中输入凭证。环境变量工具的开关不会改变脚本的 process.env。 `getLocalSecret` 不用于读取助手变量，不要尝试猜测 CUBEKEY 编号。若接口需要用密钥进行签名计算或放入请求体，当前请求头代用方式不能直接替代，需要技能作者适配受支持的鉴权链路。 ## 本轮指定技能 技能多、名字相近时，可以在输入框用 **/** 或 **＋ → 技能** 直接指定这一条消息用哪个技能，见「怎么让 AI 直接用某个文件或技能？」。 ## 注意事项 技能能力依赖当前模型的工具调用能力和指令遵循程度。没有指定技能时，模型要先调用 `use_skill` 才会读取技能正文；描述相近的技能可能被选错，这时用上面的方式直接指定。 --- # 助手记忆与全局记忆 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：模型与 AI 能力。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/assistant_memory/ ## 记忆是什么 记忆是长期保存的用户偏好、项目背景等稳定信息。 ## 启用记忆与记忆工具 打开 **启用记忆** 是唯一的总开关。当前模型支持工具调用时,应用会在每次发送时自动加入内置 `memory_tool`;助手工具和对话工具列表中不会出现单独开关,也不需要手动勾选。 模型不支持工具调用时,应用会自动改为把记忆同步到系统提示词,避免记忆功能失效。无痕会话例外:不会读取、注入或修改长期记忆。 ## 本地助手记忆与全局记忆 - **助手记忆**:只属于当前助手。适合项目专属助手等场景。 - **全局记忆**:所有选择“仅全局”或“共同使用”的助手共享。适合你的固定偏好、常用称呼、通用工作背景等信息。 - **共同使用**:同时读取全局记忆和当前助手记忆,模型能看到每条记忆的归属。新增默认放在助手记忆,用户明确要求跨助手共享时才写入全局;更新和删除按原归属执行。全局修改会影响其他使用它的助手。 默认仍为单组策略,已有助手保留原来的选择,不会自动开启共同使用。切换范围不会移动或删除已有记忆。共同使用模式的管理页可切换两组,新增、导入、整理和最近变更均针对当前分组。 ## 记忆写入方式 记忆写入分三档，按助手设置，原生与 Web 聊天共用： - **手动维护**：AI 可读取已有记忆，不可新增、修改或删除。 - **确认后保存**：AI 提出完整变更，你在确认卡中查看归属和修改前后内容，可直接编辑后保存或拒绝；确认前不会写入正式记忆。全局记忆会影响其他使用它的助手。 - **自动保存**：AI 可直接新增、修改或删除，保留撤销和最近变更。 升级保留原行为：原来关闭自动维护对应手动维护，开启对应自动保存；新助手默认仍为手动维护。Web 可在顶部助手菜单调整当前助手的写入方式，启用记忆仍在 App 中设置。确认主要用于控制记忆内容，不保证减少 token 消耗。 ## 记忆读取方式 - **自动同步**:每次请求把最新记忆注入系统提示词,模型一定能看到,结果更可靠。记忆变化会改变系统提示词,相关提示词缓存需要重新建立。 - **按需读取**:系统提示词只保留稳定的记忆规则,模型通过 `memory_tool` 的 `read` 操作读取数据库中的最新列表。缓存前缀更稳定,但可能增加一次工具调用,模型也可能漏读。不支持工具的模型会自动回退到自动同步。 两种方式都不会重写历史对话。历史中的 `read` 结果保留调用时的快照;记忆被修改后,下一次 `read` 会返回数据库中的最新状态,并以它为准。 ## 手动管理 在 **助手 → 编辑助手 → 基础 → 记忆** 中保存记忆设置后,可进入独立记忆管理页,手动新增、编辑、停用或删除记录。点击记忆行可编辑;右滑可显示提升/下放与编辑;左滑可删除。关闭“启用记忆”不会清空已存记忆,只是暂停读取、注入和自动维护。 ## 最近变更(回收站) 记忆被修改、删除或 AI 整理整批替换前,旧内容会自动存入「最近变更」,在记忆管理页右上角菜单进入。快照保留 30 天,每条可一键恢复:原条目还在就用旧内容覆盖回去,已删除则以旧内容重新新增。恢复动作本身也会留快照,可再次回档。AI 在对话中自动记住或改动记忆后,会弹出「查看」提示,点查看直接打开该助手(全局记忆则为全局)的记忆列表核对改动,返回即回到对话;要恢复旧内容就从这里进入「最近变更」。 ## 全局与助手记忆迁移 单条记忆支持在助手私有记忆和全局记忆之间迁移或复制: - 在助手私有记忆页,可把单条记忆提升到全局记忆。 - 在全局记忆页,可把单条记忆下放到已开启本地记忆的助手。 - 迁移会移动原记录;复制会在目标位置新增一条,源记录保留。 ## 迁移与克隆 **迁移或克隆记忆** 用于助手之间的本地记忆批量处理,入口在 **助手 → 编辑助手 → 基础 → 记忆 → 迁移或克隆记忆**,只对”已开启本地记忆”的助手展示。迁移会把源助手的本地记忆转移到目标助手;克隆会复制一份到目标助手,源助手保留原记忆。源助手和目标助手都需要开启本地记忆。 ## 删除助手时 删除助手不会直接丢弃有内容的本地记忆。若该助手存在本地记忆,会先让你选择迁移到其它本地记忆助手,或明确删除这些记忆。关联对话仍会按助手删除规则转移到默认助手。 ## 时间间隔提醒 1.5.0 起,时间间隔提醒改为可选开关(默认关闭),入口从记忆面板移至 **助手 → 编辑助手 → 基础**(对话行为卡片的「时间间隔提醒」开关)。需要时再开启;未开启时,记忆本身的注入与自动维护不受影响。 ## Pro 记忆 AI Pro 会员在记忆管理页可用两项 AI 能力： - **批量导入**:复制页面提供的「提取提示词」→ 粘贴到其它 AI 平台让它整理你的记忆 → 把结果粘贴回来，AI 解析预览后自动去重批量入库。适合从其它工具一次性迁移大量记忆。已有 .md / .txt 记忆文件(如桌面 agent 的 CLAUDE.md)时，点「从文件导入」直接读取，不必复制粘贴。 - **桌面 agent 迁移**:Claude Code、Codex 等桌面 agent 可通过 Web 服务器直接写入记忆，见「桌面 Agent 迁移」。 - **智能整理**:让 AI 对现有记忆自动去重、合并、精炼，把零散或重复条目收敛成更干净的集合。可以整理全部，也可以**长按进入多选、勾选部分条目仅整理所选**，未选的原样保留——适合只精修某一类记忆而不动其余。 ## 最佳实践 - 批量导入先复制本页给的提取提示词，到其它平台生成结构化结果再粘回，识别率最高。 - 智能整理会修改、合并已有条目,确认替换后原始内容会保留在「最近变更」中,30 天内可恢复。 - 只想精修某一类记忆时，用多选「整理所选」，未选条目原样保留，避免全量改动。 - 两项均为 Pro 专属；非 Pro 点击会引导开通。 --- # 如何自定义会话头像和模型标识？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/session_avatar_and_model_badges/ 在会话列表的会话操作菜单中打开头像编辑，可选择图库图片（支持 GIF 动图）、Emoji、文字及背景色，也可恢复全局样式。只修改当前会话，头像图片随包含该会话的备份、导出和迁移保留。 在 **设置 → 显示与外观 → 界面 → 会话列表** 调整对话图标与模型名称显示，页面顶部有实时预览，也可以通过设置搜索查找。**对话图标** 可选标题首字、模型图标或所属助手头像；模型图标没有匹配时保留文字，自定义会话头像始终优先。开启 **助手名称着色** 后，全部对话视图会在助手名前显示该助手的颜色圆点。模型名称随会话当前模型更新。 同一页的 **助手列表** 可设置点击助手卡片头像和名称时 **编辑助手** 还是 **进入对话**，描述区始终进入编辑，预览卡会标出两处的点击效果。 --- # 聊天失败后如何自动重试？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_retry_policy/ 在 **设置 → 通用偏好 → 输入与交互 → 发送与回复** 分别调整三类重试： - **网络异常自动重试**：默认关闭，对网络中断或超时尝试重新请求，可能替换本轮已输出的部分回复。 - **服务异常自动重试**：默认关闭，仅对尚未输出内容的 502/503/504 服务错误重试。 - **限流自动重试**：默认开启，对尚未输出内容的临时限流等待后重试；额度或余额耗尽不自动重试。已有保存值会继续保留。 三类错误每轮合计最多重试 3 次，不是每类各 3 次。等待时输入区显示原因和倒计时，可停止。服务端要求等待超过 60 秒时不继续自动重试；用户取消、鉴权错误、无效请求等不会因此反复发送。有工具或图片等不宜安全重放的请求，也可能停止自动重试。 重试可能产生额外模型调用和费用，不保证无缝续接原回答。此处是聊天重试；生图任务的失败重试在任务中心单独配置。 --- # 如何全屏编辑草稿和修改待发送消息？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/composer_and_queue/ 点击聊天输入框右侧的展开入口进入全屏编辑。编辑内容实时同步草稿，点击完成或系统返回后保留全文，不会自动发送。 AI 回复期间可把后续消息加入待发送队列。点击待发送条目的编辑入口，正文与附件会回到输入区；可修改文字、添加或移除附件，再保存。完成或取消编辑后返回原草稿。若消息已开始执行或队列状态已变化，可能无法保存，应按提示重新检查。 发送校验通过后会及时收起软键盘；附件仍在解析或校验失败时，先处理提示。输入区收起不等于模型已经收到请求，请以消息和任务状态为准。 --- # 怎么让 AI 直接用某个文件或技能？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_mention_files_skills/ ## 功能说明 不用再描述「去读某某文件」「用某某技能」：在输入框里直接点名，内容会随这条消息一起交给 AI，省去 AI 先查找、再读取的往返，也不会选错名字相近的技能。 - **@ 引用文件**：本对话工作目录里生成或导入的文件，以及本对话选中的本地文件夹、网络存储里的文件。 - **@ 选择 SSH 服务器（Pro）**：已允许 AI 使用的 SSH 服务器，选中后作为这条消息的操作目标。 - **/ 指定技能**：当前助手已启用的技能。 ## 怎么使用 - **引用文件**：在输入框末尾输入 **@**，列出可引用的文件（网络存储只列根目录），继续输入文件名可筛选，点选后输入框显示为「@文件名」。每条消息最多 8 个文件；单个文件超过约 2.4 万字只发送开头，一条消息合计约 6 万字。PDF、Word 等文档会先提取文字，图片等非文本文件不会附上。 - **选择 SSH 服务器（Pro）**：同样输入 **@**，按服务器名称或地址筛选后点选，输入框显示为「@服务器名」。发送前会重新确认服务器仍可用；AI 执行的命令仍按 SSH 审批规则询问或自动执行，网页端用法相同。 - **指定技能**：在输入框开头或空格后输入 **/**，再输入名称或描述里的词筛选、点选；也可以点 **＋ → 技能** 打开完整列表搜索和多选。工具栏也能加一个「技能」按钮，在工具栏设置中开启。每条消息最多 3 个，选中的技能显示在输入框上方，点 × 移除。列表只显示当前助手已启用的技能，去启用点列表底部的 **管理本助手的技能**。 - 发送后，消息下方显示「引用文件：…」或「使用技能：…」，点开可查看每一项是完整附上、只附了开头，还是沿用前文。 ## 最佳实践 - 引用的文件和技能正文按发送时的样子保存在这条消息上，之后每轮原样带上，便于命中缓存；之后修改文件或技能不影响已发送的内容，需要新内容就重新引用。同一份内容前文已附过时，只提示 AI 沿用，不重复占用上下文。 - 只引用这一轮真正需要的文件；资料很长时，让 AI 按需分段读取更省上下文。 - 技能正文特别长时只发送开头，其余由 AI 按需读取。修改助手启用的技能后，下一次请求会重新建立一次提示词缓存。 - 无痕对话和管理会话不提供 @ 引用。引用和指定技能的效果仍取决于模型的指令遵循能力。 --- # 怎么查看 AI 改了哪些文件？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_turn_changes/ ## 功能说明 AI 在一条回复里新建、修改、删除或移动了文件（会话工作目录、本地文件夹或网络存储）时，回复末尾会显示 **本轮改动** 卡片，列出每个文件以及新增、删除的行数。 ## 怎么使用 - 点文件即可展开，查看具体改了哪些行：新增为绿色，删除为红色。 - 文件较大、改动过多或不是文本文件时，只显示统计。 - 本轮只新建了交付文件时，由「生成文件」卡片展示，不再重复显示本卡片。 ## 最佳实践 - 让 AI 修改重要文件后，先在卡片里核对改动范围，再继续下一步；不符合预期就直接说明要恢复或调整哪一处。 - 改动明细只用于显示，不会发给 AI，也不消耗额度。 --- # 如何按助手筛选对话列表？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/conversation_assistant_filter/ ## 它是什么 对话页顶部的标题卡片显示当前浏览范围：**全部对话**，或某个助手的名称与头像。它是切换浏览范围的唯一入口。 ## 怎么使用 1. 点击标题卡片，打开带搜索框的助手选择弹窗，里面分为 **全部对话**、**最近使用** 和 **其他助手**；助手多时可直接搜索名称。 2. 点选 **全部对话** 查看所有助手的对话，点选某个助手则只看它名下的对话。 3. 选择后弹窗关闭，列表切换到新范围；切换范围会退出正在进行的多选。 ## 会记住上次的范围 - 上次查看的助手在重启应用后保持，并排在 **最近使用** 的第一位；切回 **全部对话** 后也能一步选回。 - 上次查看的助手被删除后，会回到 **全部对话**。 - 隐私助手需要先通过身份验证才能选择；应用重新启动后不会直接停在隐私助手，而是回到 **全部对话**。 ## 新建对话与默认助手 - 停在某个助手的范围下新建对话，会直接使用这个助手，只对本次生效，不会修改全局设置。 - 点击标题栏 **更多 → 新对话** 或悬浮加号即可开始对话。 - 在 **全部对话** 下，新对话使用当前的新建默认助手；菜单的 **新对话** 下方会显示「使用：助手名称」，名称过长时省略。指定助手范围下只显示「新对话」，不重复显示助手名称。 - 想修改新建默认助手，进入 **助手** 页，在目标助手的更多菜单中选择 **设为新建默认**。它只改变新建对话默认使用谁，不改变对话列表的浏览范围。 --- # 如何多选对话？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/conversation_multi_select/ 在首页 **对话列表标题菜单 → 多选对话** 进入批量选择，进入时不会预选任何对话。没有可选对话时入口禁用；也可沿用单条对话菜单中的多选入口，此时会选中该条对话。 进入后逐项勾选，或使用标题菜单中的 **全选 / 取消全选**，全选范围是当前筛选后的列表。点击 **取消** 退出多选。 多选时，点分组标题（今天、昨天、7 天内、更早）可以整组选中，再点一次取消。想清理旧对话、只留最近的，点 **更早** 后删除即可；也可以先全选，再点 **今天** 把最近的去掉。 ## 可用的批量操作 底部操作栏提供 **归档**、**移动**（悬停提示「移动对话」）、**分享**（仅选中 1 条时可用）和 **删除**，具体按钮以当前页面为准，操作前先核对选中范围。 - **批量移动**：点 **移动**，在弹出的列表里选择目标助手，所选对话一并移到它名下。已有消息保持不变，之后的重新生成与继续发送按新助手的配置执行。部分对话移动失败时，会提示成功与失败数量，失败的对话保持选中，可检查目标助手后重试。 - **批量删除**：已收藏的对话会被跳过，不会被删除。删除过程中如有对话未能删除（例如等待超时），这些对话会保留并继续保持选中，提示里会写明数量，稍后可再次点击删除重试。 --- # 如何增强提示词并恢复原句？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_prompt_enhancement/ ## 开启和配置 在 **设置 → 通用偏好 → 提示词增强** 中开启，默认关闭。可指定增强模型、自定义改写指令，并选择通用、公文、报告、代码等风格，也能维护自己的风格。配置会保存，临时选择可以另行设为默认。 提示词增强同样有独立的推理强度：在增强设置的 **默认配置** 里调整默认值（默认自动）；每次增强时可在面板里改 **本次推理强度**，只用于这次草稿，勾选 **设为默认配置** 后才会保存为新的默认。 ## 预览后再替换 先在聊天输入框写下草稿，再点击发送按钮同排的 **提示词增强** 入口。生成后可编辑结果、对照原句，确认后替换输入框内容，不会自动发送。生成期间可以取消；若切换会话或草稿已变化，请重新发起增强，避免覆盖新输入。 草稿附有图片时，增强会结合这些图片，需选择支持图片输入的增强模型；开启 **参考对话内容** 时，使用的是当前对话模型。图片未就绪、读取失败或模型不支持图片输入时，会提示并停止本次增强。替换提示词只修改文字，保留草稿图片。 面板里的 **原句** 可以直接修改，改完点 **重新增强** 即可。打开 **参考对话内容** 后，增强会结合当前对话的前文补全草稿，前文已经给出的信息不再标为待补充；此时沿用当前对话的模型与推理设置，复用对话的提示词缓存，不能单独换模型。开关会记住，下次打开面板保持上次的选择。 替换后可使用入口提供的恢复原句操作撤销；若又编辑过文本，会先询问是否覆盖后续编辑。清空输入、切换会话或离开页面后，不应依赖此前的撤销状态。 增强请求会把草稿交给所选模型处理并可能消耗额度。检查增强结果是否保留原意、是否仍有待补充信息，再发送。 --- # 粘贴的长文本为什么变成附件？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_long_text_paste/ 原生与 Web 默认将单次粘贴 **超过 1000 字符** 的文本保存为完整文本附件，等于阈值时仍放入输入框。每次粘贴生成独立附件，方便继续补充问题；不会自动发送。 点击 **粘贴的文本** 附件可预览。未发送时可撤销转换或选择 **放回输入框**；草稿未变化时恢复原插入位置，已有新内容时追加全文，保留后续输入。已发送附件只提供查看与设置。超长文本预览最多展示前 10 万字符，保存文件与恢复正文不截断。 在附件详情点击 **自动转换设置**，或进入 **设置 → 通用偏好 → 输入与交互**，可关闭转换或将长度设置为 100～10000 的整数；修改只影响后续粘贴。Web 在 **设置 → 聊天 → 长文本附件** 中配置，偏好保存在当前浏览器，不与原生设置同步。 保存失败、附件数量或上传大小达到限制时保留正文；转换期间切换会话或继续编辑，不会覆盖新草稿。文件与图片粘贴仍沿用原有行为。 --- # 单条回复的缓存命中率怎么看？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_cache_hit_rate/ 在单条回复的用量详情中，输入 Token 下方可查看缓存数量和命中率。命中率按 **缓存 Token ÷ 输入 Token** 计算，显示一位小数。 仅在服务商返回有效数据，且输入与缓存数量均大于零、缓存不超过输入时显示。未返回、零值或异常数据会隐藏，不能据此判断一定没有使用缓存。 这里展示的是本条回复的用量信息，不等于费用折扣或整个会话的缓存比例；实际计费与缓存规则以服务商为准。 --- # 如何使用和排序提示词库？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/chat_prompt_library/ 在聊天输入框点击 **＋ → 提示词**。提示词库提供内置与自建条目，可按名称或用途搜索，切换全部、收藏和最近使用。 点击条目将正文追加到输入框，编辑后再发送，不会自动发出。行尾编辑入口可查看、编辑、删除，内置条目可复制为自建；保存或删除后返回列表立即刷新。收藏与最近使用跨助手共享，无痕会话不记录最近使用，库内容随应用备份保存。 在设置的 **导出数据** 或 **碰一碰传送** 中打开 **提示词库** 分类，可搜索并勾选单条或多条提示词，预览正文后导出。接收文件后，在导入清单中选择要恢复的提示词；重复条目可跳过、替换或保留副本，不影响未选条目。名称、用途、正文、分类与收藏状态会一起恢复，新增条目追加到本机列表；内置提示词导入为可编辑的自建副本。 开启 **云空间同步** 后，提示词库会按条目同步名称、用途、正文、分类、收藏、排序及最近使用记录，导入恢复的提示词也会纳入同步。不同条目的修改可分别接收；同一条的并发修改或删除按同步页提示处理。同步保持原条目身份，内置提示词不会变成自建副本；删除的内置条目不会因重新打开提示词库而出现。 收藏条目优先显示，支持在所属分组内上下移动并保存顺序。可在设置搜索 **工具栏排序** 或 **显示提示词**，进入聊天工具栏设置，开启 **在工具栏显示提示词** 并调整位置，点击右上角保存后生效。快捷入口默认隐藏，关闭后仍可从加号面板进入。 这里的插入用于当前输入内容，不是每轮自动注入。需要持续生效的规则，请使用助手的提示词规则设置。 --- # 无痕对话 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/incognito_chat/ ## 功能说明 无痕对话是一种「只存在于此刻」的会话:不进历史列表、不写助手记忆、不入云同步与备份,离开即销毁,无法恢复。适合一次性的敏感提问。 ## 怎么开启 有三种入口: 1. 对话列表顶栏的虚线气泡图标(搜索左侧),点一下即进。 2. 长按右下角「新对话」按钮约 1.2 秒:按住后会浮起一只立方体,盒盖合拢、灯光熄灭、外圈封缄环顺时针闭合;**环闭合即进入**,中途松开则取消。 3. 聊天页右上角菜单 → **无痕对话**。 如果已经有一个进行中的无痕会话,再点入口会直接回到它,不会新建第二个。 ## 无痕期间哪些被关闭 - 历史记录:会话与消息永不落库。 - 助手记忆:不读取、也不写入。 - 草稿、自动标题、候选问题:全部关闭(顺带少发两次全文给服务商)。 - token 用量记账:不计入统计。 - 云同步与备份:不写库自然无从同步。 ## 哪些能力照常 模型切换、联网搜索、知识库检索、压缩上下文、消息地图仍可使用，工具受各自会话范围限制。无痕会话不创建持久工作目录，因此不能生成 Word / Excel 等工作区文件；需要交付文件时请切换到普通会话。附件与 AI 生图改为临时缓存，退出即自动删除。 ## 退出与销毁 - 空会话直接返回即静默销毁。 - 有内容时返回会确认一次,确认后整页溶解、彻底删除。 - 打开 **无痕状态** 面板可当场核验关闭了哪些项、临时缓存里有几个文件,也可以一键「结束并销毁」。两个入口:聊天页右上角菜单 →「无痕状态」,或点无痕提示条右侧的「查看状态」。 ## 需要注意 - 消息仍会发送给你配置的模型服务商(及启用的搜索与工具),由其按各自政策处理——无痕是本地承诺,不是对服务商的。 - 防截屏与后台遮蔽默认开启,可在无痕状态面板临时关闭。 - 应用被系统结束后无痕会话同样归零,这是特性不是故障。 --- # 需要验证的助手 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/private_assistant/ ## 功能说明 给某个助手加一道身份验证。开启后,切换到它之前需要先通过系统验证(锁屏密码 / 指纹 / 人脸),用的是系统统一认证控件,应用不接触你的密码和生物特征。 与「无痕对话」不同:无痕是不留下记录,这里是**照常保存记录,但进入要验证**。适合放私人日记、健康咨询、财务这类希望长期留存又不想被人随手翻到的对话。 ## 怎么开启 打开 **助手 → 编辑助手 → 基本信息**,在「对话行为」分区开启 **需要身份验证**。设备没有设置锁屏密码时开关不可用,请先到系统设置里设置锁屏密码。 ## 验证时机 - 应用启动后**第一次**切换到该助手时验证一次;通过后只要应用没被系统结束,再切回来不用重复验证。 - 应用被完全退出或被系统结束后,下次进入需要重新验证。 - 上次退出应用时停留在该助手,下次启动会自动回到默认助手,不会直接落进去；对话列表的浏览范围也会回到「全部对话」。 - 在对话列表的助手选择弹窗里点选它,同样要先通过验证；验证失败或取消时弹窗保持打开。 - 桌面卡片绑定了该助手时,点击卡片同样需要先验证;从通知打开属于它的会话也一样。 ## 同时生效的保护 - 该助手的会话不会出现在 **收藏** 聚合页。 - 未验证前,它的会话列表不会展示。 ## 需要注意 - 这是入口门禁,聊天内容在本机数据库中并未加密。它防的是他人随手翻看,不能替代设备加密,也挡不住取证级别的读取。 - 验证失败或取消时会停在当前助手,不会切换。 - 备份与恢复会带上这个开关,换机恢复后保护依然有效。 - 如果开启后又清除了设备锁屏密码,该助手将无法进入;重新设置锁屏密码即可恢复访问,数据不会丢失。 --- # 推荐后续问题 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/suggestions/ ## 功能说明 开启后,AI 每次回复完成会在输入框上方给出最多 3 个推荐的后续问题。 ## 怎么开启 打开 **设置 → 应用设置 → 通用偏好**,在「聊天交互」分区开启 **推荐后续问题**。 ## 模型来源 生成候选问题所用的模型在 **默认模型 → 推荐候选词** 中指定。点击候选问题即可快速追问。 ## 生成规则 候选问题的语言跟随当前应用语言。生成结果会清理编号、Markdown、引号、思考标签等多余格式,最多显示 3 条。 --- # 移动对话到助手 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/move_assistant/ ## 它能做什么 可以把当前对话移动到另一个助手名下,用于整理会话归属,或把某段对话切换到更合适的助手继续使用。 ## 怎么使用 打开聊天页右上角更多菜单,选择 **移动对话**,再选择目标助手。一次移动多条对话，可在对话列表标题菜单的 **多选对话** 里选中后点底部的 **移动**。 ## 移动后会发生什么 - 只移动这个对话的归属。 - 已有消息不会改写,历史回复仍然是当时生成的内容。 - 后续重新生成或继续发送时,会按新的助手配置取系统提示词、默认模型、工具和记忆。 - 记忆不会跟随单个对话迁移。需要处理助手本地记忆时,请到 **助手 → 编辑助手 → 基础 → 记忆 → 迁移或克隆记忆**。 ## 助手页怎么看对话 在助手页点击助手卡片,会进入该助手下的消息列表,用于快速查看和继续对应助手的历史对话。卡片右侧圆形「+」可直接新建对话;需要修改助手配置时,点助手卡片右侧的圆形「编辑」按钮,或长按卡片进入编辑。顶部「继续聊」可快速回到当前助手。 ## 自动身份图标 助手页与对话列表会为助手、会话自动生成身份图标(名称首字与稳定配色等),方便在列表里快速辨认;你仍可在助手编辑里自定义头像覆盖自动图标:可选图库图片、图片链接或 QQ 头像,三种方式都支持 GIF 动图(QQ 需该号码本身是动态头像);从图库选动图时直接选用原图即可保留动画。 ## 助手级推理显示 思考进行中时,默认只显示一行「深度思考中」加上最新一句,点这一行可以展开完整内容;思考结束后自动收起成「已思考 耗时」加上第一句要旨。 在 **助手 → 编辑助手 → 基础** 中打开 **思考时展开完整内容**,该助手思考时会直接展开全文,结束后同样自动收起。这个设置只影响当前助手,默认关闭。 --- # 如何使用 MiMo 音色朗读？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/speech_readaloud/ ## 打开朗读设置 在设置中打开 **语音朗读**；也可以搜索“朗读”“TTS”或“MiMo”。系统朗读使用设备语音能力，云端朗读是 Pro 功能。开启后，可在助手回复的消息操作中选择朗读。 ## 配置 MiMo 切换到 **云端朗读**，选择已配置且可用的服务商与 MiMo 语音模型。服务商需要正确的接口地址和 API Key；可在该页补充 MiMo 模型。云端会收到需要朗读的文字，调用费用由服务商收取。 - **预置精品音色**：选择 MiMo 默认、冰糖、茉莉、苏打、白桦、Mia、Chloe、Milo 或 Dean。 - **文字设计音色**：选择对应模型，用文字描述希望的声音。 - **样本复刻音色**：选择对应模型并提供自己的或有权使用的语音样本；该模式会把样本发送给所选服务商。 可调整语气与表达风格，先试听再保存。各模式需要服务商支持对应模型；普通聊天模型不等于 TTS 模型。更换配置或离开试听页会结束当前试听。 ## 播放与缓存 支持长回复分段，开启流式播放后可边接收音频边播放。当前会话内重复播放可复用相同文字与配置的缓存；修改文字或朗读配置后可能重新生成。缓存不是永久音频备份，也不保证应用重启后仍可直接播放。 没有声音时先检查系统媒体音量、朗读开关和所选服务配置，再用试听检查连接；服务报错时按提示核对额度、模型与凭据。 --- # 如何归档和恢复对话？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/conversation_archive/ ## 归档入口 在聊天页更多菜单中选择 **归档对话**；也可以在对话列表进入多选，选择会话后归档。归档保留聊天记录，适合把暂时不用的会话收起来。 ## 查看与恢复 通过对话列表的归档状态筛选查看已归档会话，再选择恢复；归档操作后的撤销提示也可撤回刚才的归档。恢复后会话重新出现在相应列表中。 已归档列表也能批量处理：点筛选栏右侧的多选按钮，逐项勾选、全选或点分组标题整组选中，然后在底部选择 **恢复** 或 **删除**。已收藏的对话不会被批量删除。 打开已归档会话继续聊天仍保持归档状态，需要时主动恢复。归档不删除消息，也不压缩上下文；想减少后续请求携带的历史，请使用 **压缩上下文** 或 **清除上下文**。删除则会清除相应会话，请核对确认提示。 --- # 如何压缩上下文？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/context_compression/ ## 怎么压缩上下文 打开聊天页右上角更多菜单，选择 **压缩上下文**；也可从 **上下文容量** 面板进入。选好近期原文的保留档位（可选再写压缩要求）后，点击 **开始压缩**。 **近期原文** 分为 **较少**、**自动**、**较多** 三档，面板顶部的 **压缩预览** 会估算压缩前后的占用，以及固定内容、摘要与近期原文的比例。保留按完整步骤计算，不拆开工具调用与结果；保留越少释放越多，但摘要可能遗漏细节。原始消息和图片仍保存在本地，不会删除。 上下文压缩将较早的对话总结为摘要，后续请求使用摘要与保留的近期原文。压缩不删除消息；助手需要核对细节时，可以按需搜索和查看被压缩的原文。上下文占用是估算参考，不会仅因估算超过 100% 就阻止发送。 ## 清除上下文 想在当前对话里开始新一轮、又不想新建对话时，打开聊天页右上角更多菜单，选择 **清除上下文**。最后一条消息下方会出现「上下文已清除」分隔，之后发送的消息只带分隔以下的内容；分隔以上的消息照常显示，可以翻看、搜索和复制，只是不再发给模型。可以多次清除，每次都会留下一条分隔。 刚清除、还没发消息时，点分隔上的 **撤销**（或更多菜单里的 **撤销清除上下文**）即可恢复；已经在新一轮里聊过，撤销前会再确认一次。在分隔以上的旧回复上重新生成，仍按它当时的上下文；在分隔以上的用户消息上重新生成，会从那里重新开始对话，分隔随后面的消息一起移除。清除前已有的压缩摘要不再使用；清除后再压缩，只压缩分隔以下的内容。 ## 自动压缩 在 **设置 → 应用设置 → 通用偏好** 打开 **自动压缩上下文**（默认关闭）；每个对话也可以在 **上下文容量** 面板里单独开启或关闭。开启后，接近上限时会在发送前或工具步骤之间自动压缩，完成后继续；已执行的操作不会重做。发送前压缩时可以点 **跳过，直接发送**，只跳过这一次。停止会停止整个发送，你的消息仍留在输入框。自动压缩未完成时会按原上下文继续，本次发送不再自动压缩。 同一位置的 **压缩触发点** 可以填 32K～2000K（例如 200K、500K），留空为 **自动**。自动按模型窗口计算（约 80%），百万窗口的模型要到约 800K 才压缩；填了固定大小后，上下文达到这个大小就压缩，压缩后也控制在这以下，长对话的单次请求更小、更省。填的值比模型的自动触发点还大时按自动处理。系统提示词、知识库和工具定义占用较多时，触发点填得太小可能压不下来，调大一些即可。 未开启时只提醒：占用达到 70% 时建议压缩，接近压缩所需空间时再次提醒。没有可靠上下文窗口的模型不会自动压缩，可在模型设置里填写窗口大小，或手动压缩。 ## 上下文容量与 Token 单位 上下文面板估算的是当前请求要携带的内容，不等于本条回复或整个会话的累计用量；连续工具调用产生的多次输入会计入消耗，不能简单相加作为当前窗口占用。估算与服务商实际计量可能不同。 模型编辑中的容量支持完整整数及 K/M：**1K = 1,000、1M = 1,000,000 Token**，例如 272K、1M、1.048576M。保存的是精确整数，已有的 1,048,576 不会因为显示为 1.05M 就变成另一个值；只修改模型名称等其他设置也不会重写容量。请使用服务商实际窗口值，不要把输出上限当作总窗口。 上下文容量面板还会显示上次请求的完整 JSON 体积、图片数量和内联图片编码体积，失败请求也会计量。它与 token 窗口不同，压缩后需到下一次发送才更新。遇到 HTTP 413，表示服务商或中转拒绝了过大的请求；可在压缩时选择 **较少** 少保留近期原文，或减少、缩小本次图片。同一服务商内更换模型不一定能改变请求体积限制。 ## 会话级压缩要求 在压缩面板里展开 **压缩要求**（可选，不填则使用默认规则），可指定需要优先保留的人物关系、情绪变化、代码细节等内容，最多 2000 字。点击 **保存要求** 单独保存；点击 **开始压缩** 也会先保存。关闭面板不会保存未提交的修改。 要求仅对当前对话生效，在 **高级** 里换模型后仍保留，后续压缩继续沿用；清空并保存可恢复默认。修改只影响下一次压缩，不会改写已有摘要，也不能恢复此前摘要中已遗漏的细节。自定义要求补充保留重点，不替换忠实于原文、不虚构事实等基础规则。 ## 查看摘要与中断 压缩进行时，输入框上方会显示进度，可以先去聊别的；完成后可从提示中 **查看摘要**，之后也可以打开聊天页 **右上角更多菜单 → 查看上下文摘要**。摘要是后续聊天使用的内容概括，可能遗漏细节；需要核对时直接问助手，它会按需查看原文。 如果主要占用不在历史对话里（例如挂载的知识库或工具较多），压缩后释放的空间有限，会先让你选择 **仍然保存** 或 **放弃这份摘要**。放弃不会改变上下文，本次用量已计入。 失败或停止不会用不完整摘要替换现有内容，可查看提示后重试。应用进程被系统结束不代表云端请求已取消，后台任务受系统限制。 ## 模型和费用 压缩默认使用当前对话的模型和推理强度，请求沿用对话已有的历史，尽量复用服务商缓存，按服务商计费。手动压缩时，面板最下方的 **高级** 可以为本次换一个模型；换用其他模型后才可选择推理强度，且无法复用对话缓存，费用可能更高，不会修改聊天模型和全局默认设置。自动压缩始终使用对话模型。压缩不做分段：服务商提示超出窗口时会去掉近期原文后重试一次，仍放不下则如实报错、原文不变，可在 **高级** 里换窗口更大的模型。正在生成回复、已有压缩任务或没有可压缩内容时，入口可能不可用。 --- # 附件与按需读取 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/attachments/ ## 照常上传，告诉 AI 你想做什么 点击输入框旁的 **加号** 添加图片或文档，再像平常一样提问。也可以从中转站、相册或网页拖入文本和图片：图片成为附件，文本填入输入框。 ## 上传附件会怎样处理？ 输入框上传的可解析文档默认解析，正文随消息发送；视觉模型直接接收图片，非视觉模型沿用已配置的辅助识图或端侧 OCR。文件工具是否开启，不改变这些行为。解析中、失败或加密的文档会显示状态；完成解析后再发送，不能完整解析时请先处理错误。 ## 拍照是否保存到系统图库？ 进入 **设置 → 通用偏好 → 输入与交互 → 拍照**，调整 **拍照时保存到系统图库**，默认关闭。关闭时，聊天拍摄的照片只作为应用内附件保留，拍摄临时文件在处理结束后清理；开启后交由系统相机流程保存到图库。开关只影响之后在聊天中拍摄的照片，不清理已有图库照片，也不改变从相册选择图片的行为。 ## 发送前裁切图片 图片添加到输入栏后，长按缩略图选 **裁切**，或点开全屏预览在底栏点 **裁切**。可以拖动四角和边框自由裁切，选择常用比例，或旋转 90°；完成后替换待发送的图片。原图会保留，再次裁切时可以 **还原**；直接返回则放弃本次修改。拍照和选图流程不变，裁切只是可选步骤，也不影响「拍照时保存到系统图库」。 ## 文件格式、ZIP 与旧版 PPT 文件入口支持添加各类原文件，能添加不等于模型能理解该格式。旧版 **.ppt** 与 **.pptx** 演示文稿均支持正文解析，可用于总结和问答；解析正文不等于完整还原幻灯片版式或动画。PDF、Office、EPUB 等仍受解析器、文件大小及模型上下文限制。 ZIP 保留原包，并尝试展开可解析的子附件；解压失败仍可保存原包。未知或不能提取正文的二进制格式按原文件保存，不会把二进制当文字或整份 Base64 发给模型。已发送文件可在当前会话工作目录的输入文件区域只读浏览，按格式预览或导出；上传不会自动启用文件工具。 ## 工作目录中的文件如何读取？ **图片来源与准备进度**：点击附件 **照片** 默认打开本机相册。支持跨设备导入的设备可 **长按照片（鼠标右键）→ 从其他设备导入**，使用系统提供的远端相册、拍照或扫描来源；可用设备与业务由系统决定。DeepSeek 官方接口发送图片时会显示准备进度，可展开查看上传与复用情况；是否能理解图片仍取决于所选模型。生成文件中的图片仅显示文件名与大小，点击文件行后打开预览；回复正文中的工作区图片仍可内联显示。 在聊天的 **工具** 面板明确开启需要的能力：**文件操作** 负责列举工作目录、读取文档和修改文件；**读取图片** 负责查看已知路径的图片；**列出资源** 负责发现已挂载知识库中的资料和历史图片记录，不列举工作目录或原始会话附件。知道路径或资源 ID 时可以直接读取，无需先列举。工作目录中的文档在实际读取时解析，图片在实际调用时识别。工具不会因上传附件而自动开启；在本对话启用挂载文件夹时，会自动开启文件操作并提示。 已有文件夹授权还需要在工具栏的 **挂载文件夹** 中启用；未启用的目录不会随对话提供给模型。也可从 **＋ → 文件夹** 调整，目录授权只在当前设备有效。 工具读取仍会消耗上下文和调用次数，具体用量取决于任务和文件。普通附件的解析、识图与历史处理保持原来的用法，没有额外的附件加载方式开关。 可以调整的是 **识别与解析方式**： - **图片**：进入 **设置 → 模型与用量 → 默认模型 → OCR 识图**，配置辅助识图模型及「优先使用大模型识别」偏好。模型需要辅助识图时，可根据你的问题指定观察内容；这不是附件加载方式开关。 - **PDF**：点开附件正文预览，选择 **更换解析方式 / 文档 OCR**。核对新正文并采用后，后续读取会使用更新的内容；已发送的 PDF 也可以这样处理，正在回复时需等本次回复结束。 - **文档解析服务**：在 **设置 → 模型与用量 → 默认模型 → 文档解析** 管理。选择服务不会立即上传文件，开始解析时再核对上传范围。 ## 会影响原来的用法吗？ - **普通聊天**：照常输入和发送，无需额外操作。 - **图片**：支持视觉的模型直接随消息看到图片，追问时可按需重看或查看局部。不支持视觉的模型可使用已配置的辅助识图模型或端侧 OCR，识别效果取决于所用方式。 - **文档**：上传后默认解析并随消息发送；工作目录中的文档只有调用已启用的工具时才解析。文件过大、损坏或无法完整解析时会提示原因，不会把不完整正文当作全文发送。 - **无痕／临时会话**：文档与图片沿用直接准备内容的方式，已有 OCR 和解析配置继续生效。 - **视频**：已撤回相册视频专用入口与按时间点抽帧。通过文件入口添加的视频仅保存为原文件，不提供画面或声音理解；需要理解内容时请提供截图或文字说明。旧版专用视频附件会在加载或导入时过滤。 ## 一次读取很多图片会怎样？ 图片输入受模型视觉能力、上下文容量、图片数量与请求大小限制，历史图片还受历史范围和图片预算约束。不要把原文件仍在聊天记录中理解为每轮都会重新发送全部图片。需要核对具体细节时，可重新附上对应图片，或在启用读取图片工具后明确指定目标。 读取图片和辅助识图仍会消耗模型调用与上下文；具体费用和限制以所选服务商为准。 ## 预览原文件 - **发送前**：点击待发送的文件附件查看正文面板，再点 **预览原文件** 打开原件。尚未解析时，没有正文不代表附件不能发送。 - **聊天记录中**：PDF 先打开正文预览，可更换解析方式或点 **预览原文件**；其他文件按支持的方式打开原件。多选消息时，点击用于选择消息。 - Markdown、纯文本和支持的代码文件在应用内预览；PDF、Office 等使用系统预览或「打开方式」，可用性取决于设备和已安装应用。 打开原文件供你查看，不代表模型已读取，也不会自动发送。若提示原件不存在或无法访问，请重新添加；只剩解析正文的旧记录无法还原原件。 --- # 大文件和资料该放在哪里？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/where_to_put_files/ ## 先看区别 - **输入框附件**：上传后先解析，全文随消息交给 AI，之后的对话也会一直带着。适合篇幅不长、需要 AI 通读的文件，不需要开启任何工具。 - **会话文件**：放进当前对话的文件空间，AI 需要时才读取，并且只读用到的部分，不会把整份文件塞进上下文。适合大表格、长报告、整个项目压缩包，导入免费。 - **挂载文件夹（Pro）**：直接使用手机里现成的目录，不用复制进应用，AI 同样按需读取。适合持续更新的资料目录。 - **知识库**：长期保存、可在多个对话和助手之间复用，提问时按内容检索相关片段。适合常用的参考资料。 ## 大文件推荐放进会话文件 1. 在聊天页右上角菜单打开 **会话文件**，点 **导入文件**（也可导入 ZIP，会解压为独立目录）。 2. 在输入框 **工具 → 选择工具** 中为本对话开启 **文件操作**。 3. 直接告诉 AI 要处理哪个文件，例如「读一下 销售数据.xlsx 的第二个表，按月汇总」。AI 会按需打开文件，PDF、Word、Excel、PPT 等文档在读取时才解析。 ## 注意 - 会话文件需要支持工具调用的模型；不开启 **文件操作** 时，AI 看不到这些文件。 - 需要按单元格、公式或指定区域读取表格，或要修改、生成 Office 文件时，可同时开启 **Office 文档** 工具。要修改现有的 Word、Excel、PPT，从会话文件导入原文件效果最好。 - 会话文件只属于当前对话；想在多个对话里共用，可使用 **共享文件**（新增需要 Pro）或知识库。 - 已经作为附件发出的文件仍会随对话保留全文；如果上下文快满了，可以压缩上下文，或在新对话里改用会话文件。 --- # 文档解析与 OCR > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/documents_ocr/ ## PDF 解析入口 聊天中点击待发送或已发送的 PDF 附件进入正文预览，再选择 **更换解析方式 / 文档 OCR**；正文预览中的 **预览原文件** 可用于对照原件。已发送 PDF 采用新结果后，AI 下一次读取会使用更新的内容，不会改写已经生成的回答；正在回复时需先等待完成。知识库导入预览及已保存原 PDF 的文档也可进入 **文档解析** 面板。只保存了正文的旧文档，需重新提供 PDF 才能再次识别。 - **原生**：适合含文本层的 PDF，在本机提取文字。 - **端侧 OCR**：适合扫描件，在本机渲染页面并识别。 - **解析服务**：选择已配置的 MinerU、PaddleOCR 官方云服务或已有兼容服务/视觉模型。 ## 配置 MinerU 或 PaddleOCR 打开 **设置 → 模型与用量 → 默认模型 → 文档解析**，进入服务管理，点 **添加文档服务**。选择官方服务，填写 API Token 或 AI Studio Access Token、选择模型，再点 **保存服务**；需要时设为默认。也可以从解析面板的 **管理** 进入。 选择或保存服务不会上传文档。开始解析时请核对服务、模型与上传范围。官方云服务直接接收原 PDF；即使选择部分页面，整份原件仍会上传，确认面板会说明实际范围。视觉模型等其他方式的范围以当次确认提示为准。云服务可能计费，额度和可用性由服务商决定。 ## 审核与使用结果 新正文生成后先核对页数、内容及完整性提示，可以对照原文，再选择 **使用此结果**。只识别出部分内容不代表全文完整；失败或取消不会自动替换旧正文。知识库采用新正文后需为更新的文档重新建立语义索引。 ## 切换解析方式 在结果页点 **换种方式**，或在上传确认页点 **返回调整**，重新选择原生、端侧 OCR 或解析服务。新任务准备成功后才替换旧任务；准备失败会保留旧任务和结果。替换按完成后的任务数量和 PDF 容量检查，不会把同一旧任务重复算入额度。 旧任务还在运行时，先停止任务；若提示正在停止并释放资源，等待释放后再点 **下一步 / 开始解析**。更换解析服务后仍需核对上传范围，新请求可能重新计费。 ## 管理解析任务 - 解析面板中的 **管理解析任务** 可查看各文档的任务；点当前文档的任务回到确认或结果页。右上角 **完成** 只关闭面板，不会停止或丢弃任务。 - 也可从 **设置页右上角** 打开 **任务中心**；在 **设置 → 显示与外观 → 界面** 开启「在其他页面显示任务中心入口」后，助手、对话和知识库页也会显示入口。在 **文档解析** 分组查看任务。**当前** 显示尚待处理的任务；**最近记录** 显示已采用结果或已清理原件的记录；**全部** 同时显示两类。 - 点任务行查看状态、错误原因和已有正文预览；点右侧 **更多操作** 可 **停止任务** 或 **丢弃任务**。任务仍占用资源时需先停止并等待释放，再丢弃。 - **结果待确认** 表示结果已保存、尚未采用。任务中心的 **如何确认结果** 会说明入口：聊天中打开原 PDF 附件 → **更换解析方式 / 文档 OCR**；知识库中返回原文档的解析入口。面板会恢复已有结果，核对后点底部固定的 **使用此结果**；部分内容需再次确认。打开和采用已有结果不会重新发起解析请求，无需重新上传或换种方式。右上角 **完成** 只关闭面板，不等于采用结果。 - 从知识库 **添加文档** 开始解析、尚未保存就退出预览时，知识库可能仍显示 **0 篇资料**。在任务中心找到该文档的 **结果待确认** 任务，点 **恢复导入并保存**，核对已保留正文、选择目标知识库，再点 **保存到知识库**。恢复和保存不重新调用解析服务；保存成功后才标为已采用，并将原 PDF 一并保存。关闭恢复页或保存失败会保留任务，可稍后重试；请勿先丢弃任务。 - **丢弃任务** 会删除该任务未采用的结果及解析副本，保留原文档；确认后才执行。需要继续识别或采用结果，请回到原聊天附件或知识库文档的 **文档解析**。重启应用不会自动续跑付费请求。 ## 遇到本地任务限制怎么办？ - **此文档已有运行中或排队任务**：点 **查看当前文档任务**，查看进度或停止旧任务；准备文件、清理原件或停止释放资源期间，稍后重试。 - **运行中和排队任务达到 4 个**：等待任务结束，或在 **管理解析任务 / 任务中心** 停止不再需要的任务。 - **待处理任务达到 16 个**：丢弃不再需要的任务，或回原文档采用结果。失败、已停止和待确认的任务也会保留，关闭面板不会释放额度。 - **保留的解析 PDF 加上本次文件超过 400 MiB**：丢弃不再需要的解析任务后重试。这里统计解析副本，不能据此判断手机存储空间已满。 - **解析任务尚未载入**：点 **重新加载解析任务**；任务列表载入失败时点 **重新加载**。 ## 中断、重试与错误 已有远端任务的重试会继续查询原任务或取回结果，不自动重新创建任务。若提交结果不明确，应用会提示，不能据此认定服务未收到文件。停止等待不等于厂商取消任务或停止计费；后台运行受系统限制。 服务繁忙或请求受限时稍后重试；额度不足时检查服务商账户；鉴权失败时检查所选服务与 Token。PaddleOCR 的 10010 表示任务提交队列已满，与每日剩余页数不是同一项限制。 ## 其他文档与图片 聊天和知识库还支持 DOCX、XLS/XLSX、OFD、PPT/PPTX、EPUB 等文档；解析、预览和模型上下文各有容量限制，保存原件成功不代表所有方式都能完整处理。单独图片的 OCR 设置仍由 **默认模型 → OCR 识图** 管理，与文档解析服务独立。 --- # 输出统计与使用统计 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/usage_stats/ ## 单条输出统计 在聊天页点击助手气泡右下角的 AI 标识,可以查看该条回复的输入 token、输出 token、缓存 token、总 token、生成速度、耗时和模型信息。 ## 会话使用统计 打开聊天页右上角更多菜单,选择 **会话使用统计**,可以查看当前会话内的用量汇总。 ## 全局使用统计 打开 **设置 → 模型与用量 → 使用统计**,可以查看全局用量。默认显示近 30 天,点主卡左上角的区间可切换近 7 天、近 12 个月或全部。 - 主卡:本期 Token 消耗、与上一周期的对比和每日/每月走势,点柱子看具体数值。 - 使用节奏:日历热力、连续使用天数和你最常使用的时段。 - 模型:按 Token 排序,点开一个模型可看输入、缓存命中和输出的构成。 - Token 去向:输入缓存命中率与按用途的拆分。 - 最耗 Token 的对话:点击可直接打开;隐私助手的对话只显示「隐私对话」。逐条明细只保留 90 天,所以这一项最多覆盖近 90 天。 ## 本期回顾 统计页主卡下方的横幅会根据你的使用习惯给出一个 Cube 人格(例如「深夜模型收藏家」)。点进去可以生成一张带你自己 Cube 形象的分享图,选择样式、决定是否显示 Token 与消息数,然后保存到图库或直接分享。Cube 身边会贴上你的高峰时段、连续天数等数据贴纸,并显示与上一周期的对比。分享图不包含任何对话标题和内容,按 2 倍清晰度导出。 **AI 锐评**:在回顾页点「写一句」,AI 会以 Cube 的口吻根据这段时间的数据写一句点评,印在海报上,海报只署名「Cube 锐评」。默认使用「默认模型」里的标题模型(未设置时用对话模型),也可以点「模型」换成更会说话的模型。发给模型的只有汇总数字和模型名,不含任何对话内容;只有你点了才会调用,同一周期的点评会记住,可以「换一句」或「移除」。这部分用量在使用统计里记为「回顾点评」。 ## 注意事项 全局统计的 **用量来源** 可区分聊天、对话标题、上下文压缩、建议问题、翻译、记忆整理与导入、文字识别、知识库优化、提示词优化、回顾点评和连接测试。辅助任务也可能调用模型并产生用量；旧版本未记录的来源无法补齐，可能归入其他或没有记录。 上下文容量用于判断当前请求占用的窗口；使用统计累计各次请求的消耗，包含工具多轮调用，不是当前上下文长度，也不能直接当作账单金额。 token 用量取决于服务商接口是否返回 usage。旧消息、异常中断的请求,或不返回用量的接口可能没有统计数据。 --- # 两种生图方式的区别 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/image_paths/ ## Cube Agent 有多种生图方式 - **对话内生图**:在 **工具** 里开启 **生成图片** 后,助手会在需要时自己调用生图模型出图,图片直接显示在对话里;想改图直接说「把这张改成夜景」即可。使用 **默认模型 → 图像生成** 配置的模型,任何能调用工具的聊天模型都可以触发。 - **图像生成工作台**:**设置 → 助手与能力 → 图像生成** 中的独立文生图、图生图、图库界面,使用 **默认模型 → 图像生成** 配置的模型。 - **Web 工作台生图(Pro)**:在内置 Web 服务器的浏览器面板中批量生成,可选模型、比例与张数。 ## 对话内切换生图模型 - 在输入框 **工具** 面板中,**生成图片** 一行会显示当前生图模型,点右侧 **换模型** 即可切换。 - 还没选模型或模型已不可用时,生图失败处会出现 **选择生图模型** 按钮,选好后让助手再画一次即可。 - 切换改的是 **默认模型 → 图像生成**,图像生成工作台下次打开也会使用同一个模型。对话里的模型列表只包含已接入的模型,接入新的生图服务请到工作台的模型选择中使用 **AI 接入**。 ## 怎么选择 想边聊边出图,使用对话内生图。想集中管理提示词、参考图和历史图片,使用图像生成工作台。 ## 注意事项 对话内生图与图像生成工作台使用同一个生图模型,也沿用工作台里的分辨率、质量、输出格式和生图配方参数;比例由助手按用途选择。对话里生成的图片保存在本对话的文件里,不进入工作台图库。工作台支持更完整的生成设置与批量任务。 --- # 如何把其他应用的内容分享给 Cube？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/system_share/ ## 从系统分享面板进入 1. 在其他应用选择文字、链接、图片或文件，打开系统分享面板，选择 **Cube**。 2. 预览收到的内容。存在可接收分享的当前对话时，可选择 **转发到当前对话**；也可选择助手并 **打开新对话**，隐私助手需要先解锁。 3. 内容放入目标输入框后，可以继续编辑，再由你点击发送，不会自动调用模型。 转发到当前对话会追加文字和附件，保留已有草稿；新建则创建独立普通草稿。若当前目标是可用的无痕对话，转发沿用该会话的临时存储；选择新建仍是普通草稿。当前对话已关闭或不可用时按提示重新选择，不会悄悄发往其他会话。 ## 分享偏好 进入 **设置 → 通用偏好 → 输入与交互 → 接收分享 → 分享偏好**，也可在分享页调整。**默认打开新对话** 默认开启；关闭后优先转发到当前对话，没有可用对话时改为新建。默认分享助手用于新建对话，不改变已有对话的助手。开启默认助手后按偏好直接准备目标输入框；关闭后每次询问。无论哪种方式，仍需你确认发送。 分享失败或文件授权失效时，可回到来源应用重新分享。 ## 内容限制 每次文字最多 100000 字符，文件最多 50 个、图片最多 20 张；单文件最多 64 MiB，总附件最多 256 MiB。实际可解析格式沿用聊天附件能力，普通 ZIP 会按现有规则展开并筛选可解析内容，超限时显示错误。 Cube 传送包走独立的数据导入核对，不作为聊天附件；不要与普通文件混在同一次分享中。在 Cube 内分享对话给别人，请查看「对话分享」相关帮助。 --- # 分享对话 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/share/ ## 功能说明 可以把单条或多条消息分享为图片、Word、PDF、网页、Markdown 或纯文本。图片适合直接发到聊天软件,PDF 和网页适合归档,Markdown 与纯文本适合继续编辑。 导出网页和云端分享会保留对话中的结构化内容,包括数学公式、Mermaid 图表和代码块;接收方可直接查看，无需安装 Cube Agent。 ## 怎么使用 点消息下方工具栏的「更多」按钮,选择 **分享**,可进入分享预览;在多选模式下也能用底部「分享」按钮一次导出多条消息。 分享页顶部可切换图片、PDF、网页、链接；Word、Markdown 和纯文本在 **更多** 菜单中。其中「链接」即云端分享链接入口。 ## 将回答导出 Word 在分享面板选择 **更多 → Word**，确认消息和内容过滤选项后导出 .docx。保留标题、正文、列表、表格、代码和公式，保存后可在 Word/WPS 中继续编辑。公式会转成 Word 原生公式，可以直接修改；少数无法转换的公式（例如带颜色的）改用图片，仍无法渲染的保留原始 LaTeX 文本，都不会影响整篇导出。此入口直接转换已有回答，无需再调用模型或开启 Office 文档工具。复杂版式和不同办公软件的行内图片位置可能有差异，交付前请检查导出文件。 ## 内容过滤 分享预览可选择是否包含思考过程、工具调用等内容。需要给别人看最终结论时,可以隐藏推理与工具;需要归档完整过程时,可以保留这些内容。 ## 展示设置（Pro） 链接、网页与 PDF 模式下,可在分享面板的 **展示设置** 中隐藏底部的应用介绍与二维码,让内容更聚焦对话本身。选择会跨会话记忆;云端链接以发布时的选择为准,发布后再改不影响已生成的链接。 ## 图片与隐私 分享预览会展示对话中的图片类附件。导出 HTML/PDF 时,嵌入的 JPEG 图片会剥离 EXIF 信息;长图分享会重新截图生成,不会直接转发原图文件。 --- # 对话分享（云端） > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/conversation_share/ ## 功能说明 把一整段对话发布成云端链接或网页文件，方便分享给别人在线查看。云端链接经 AI 内容审核通过后公开访问。 ## 和「消息分享」的区别 - **消息分享**(上一条):把选中的消息导出成图片 / PDF / 网页 / Markdown，重点是导出文件。 - **对话分享**:把整段对话发布到云端生成链接，重点是在线分享给别人看。 ## 怎么使用 在对话页的分享入口选择生成 **网页文件** 或 **云端链接**。网页文件可直接发送；云端链接提交后进入 AI 内容审核，通过即可公开访问，审核期间链接已可打开并显示「审核中」。 ## 我的分享 在 **设置** 顶部会员账号卡进入 **会员中心 → 账号与服务 → 我的分享**,通过 **对话分享 / 站点发布** 两个页签统一管理发布内容。对话分享支持查看状态、复制链接或撤回；撤回后链接立即失效。Pro 用户发布的工作目录站点也会显示在这里。 ## 最佳实践 - 分享前确认对话里是否含思考过程、工具调用或隐私信息，不需要的可在预览中过滤。 - 云端链接公开后任何人可访问，不要分享含个人隐私、密钥或敏感信息的对话。 - 不再需要的分享及时撤回，避免链接长期暴露。 --- # 拖拽输入 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/drag_drop/ ## 它是什么 1.5.0 起,支持从中转站、相册、网页等位置把文本和图片直接拖入聊天输入框,无需逐个复制粘贴或点击附件入口。 ## 拖入后会发生什么 - **拖入图片**:作为附件添加到当前消息。 - **拖入文本**:填入输入框,可直接编辑或发送。 ## 多源支持 统一拖拽适配多个来源,包括系统相册、浏览器网页内容、中转站暂存等,操作方式一致。 --- # 公式预览 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：聊天。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/formula_preview/ ## 它是什么 消息中的数学公式可以点击放大,进入全屏预览页面单独查看。 ## 什么时候用 适合阅读复杂或较长的公式:在正常消息流里因为排版空间有限,长公式可能折行或难以辨认,放大预览后排版更清晰,便于逐行查看。 ## 与行内渲染的关系 消息正文里的公式仍会正常行内渲染,点击公式只是进入预览页,不会改变原消息内容。 --- # 文生图 / 图生图 / 图库 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：图像生成。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/workspace/ ## 开始之前 请先在 **设置 → 模型与用量 → 默认模型 → 图像生成** 配置具备出图能力的模型。也可以在服务商的模型编辑页确认已开启“图片生成”能力。 ## 画布优先的新界面 1.7.0 起，生图工作台以生成结果为主画布，提示词、参考图、模型与生成参数集中在底部 Dock。没有生成结果时会展示整齐双列的灵感画廊，点击示例可快速带入创作方向；灵感内容会由服务端后台维护并自动更新，网络不可用时仍会使用内置预置，不影响正常创作。 ## 生成方式与参数 - **文生图**:输入文字描述直接生成图片。 - **图生图**:从相册或文件中添加一张或多张参考图，再说明希望保留或改变的内容。 - **提示词工具**:可用模型优化提示词，也可进入全屏编辑器处理长提示词、分镜或复杂风格要求。 - **生成参数**:按模型能力选择比例、数量、质量、输出格式与分辨率；部分模型支持 1K / 2K / 4K，分辨率越高通常耗时越长。 ## 绘图设置会保留吗？ 张数、比例、分辨率、自定义尺寸、质量、输出格式、压缩与审核选项，以及配方参数会在修改后保存，重启应用后恢复。实际可用项取决于当前模型；自定义尺寸和配方参数按所属服务商／模型校验，切换模型时不会强套旧模型的配置。 这项恢复只针对绘图设置，不表示提示词、参考图或正在执行的任务都会随之恢复；未完成任务的处理仍以任务中心状态为准。 ## 生成流与任务中心 - 生成结果区按任务分组成生成流:每条任务一张卡,多任务结果不会互相顶掉;失败卡保留原因可行内重试,成功卡可**再次生成**(以原参数快照克隆入队)。 - **并发任务数（Pro）**：在生图参数面板选择一次提交 1～4 个相同参数的独立任务；与单个请求的图片张数是两个设置，超出同时执行上限的任务会排队，每个任务分别计费。 - **任务中心**从标题栏菜单进入(运行中带角标):「进行中」可取消、移到队首、移除;「历史」按日分组留痕(成功/失败/取消/中断),每张任务卡显示首张产物缩略图,点卡片预览,右侧圆形按钮以原参数**再次生成**,长按可再次生成、复制提示词或删除记录;历史行可左滑删除,右上角可多选批量删除或一键清空历史(仅清任务记录,进行中任务与已生成的图片不受影响),保留最近 500 条,清空图库不影响任务记录。 - Pro 会员可边生成边排队、多路并发出图,并发与队列长度在任务中心调整;429 限流自动重排,不丢提示词。 ## 失败自动重试 进入 **任务中心 → 任务与并发设置**，开启 **失败自动重试**。该开关默认关闭；开启后可设置重试上限，默认 3 次，0 表示不限次数，不包含首次请求。网络、超时、限流、服务异常或可重试的任务失败会等待后再试，间隔逐步延长至 60 秒；鉴权和无效参数等错误不会一概重试。 开启后，限流也使用该上限；未开启时，原有限流重试开关仍最多重试 2 次。任务显示“等待自动重试”和重试次数，可手动取消。已有异步任务在可恢复的查询失败时继续查询原任务；重新提交生成可能再次计费。成功收到结果后若本地保存失败，不会因此自动重新生成。应用进程结束后，未完成任务会记为中断，不承诺退出后持续重试。 任务卡与历史显示结束时间及本次请求耗时；自动重试的耗时不是所有尝试的累计时间。通用偏好中可分别配置生图成功和失败提醒。提示词提交成功后会清空，提交期间新编辑的草稿会保留；提示词预设支持删除。 ## 结果与图库 生成结果可以保存、分享、再次编辑或加入收藏。图库会保留历史生成记录,右上角视图按钮可切换到「按任务分组」，每个任务一张卡片，单张左图右文、多张为方格；任意视图点右上角「多选」(或长按图片)可进入多选,批量保存或删除所选;在图库卡片或大图预览中点击爱心，即可在收藏中心集中回访。 你可以在 **设置 → 应用设置 → 通用偏好 → 主页入口** 开启生图，把工作台固定到主页底部。关闭主页入口不会删除生成历史。 ## 三种生图路径 - **对话内生图**:适合边聊边生成，在聊天 **工具** 中开启 **生成图片**，由助手按需调用；与工作台共用同一个生图模型。 - **生图工作台**:适合参考图、精细参数、提示词与图库管理。 - **Web 工作台生图（Pro）**:适合在浏览器面板中批量生成，可选模型、比例与张数。 对话内生图与工作台共用 **默认模型 → 图像生成**；Web 工作台可单独选择模型。 --- # 图片预览如何使用超清增强？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：图像生成。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/image_super_resolution/ ## 适合哪些图片 AI 从网页保存的小图、聊天中的图片和附件、生图参考图、图库及任务产物，都可以在原生大图预览中使用统一的 **超清增强**。它改善小图的观看与使用体验，不会重新访问网站寻找原图，也不能保证还原真实文字或细节。 ## 怎么使用 1. 点击图片打开大图预览，在右上角点击 **超清增强**。只有你主动点击才处理，不会自动增强每张图片。 2. 处理中显示 Cube 动效与「增强中」。多张图片的增强请求会依次处理，不需要重复点击。 3. 完成后可切换 **查看原图 / 查看增强**，对比实际尺寸，并保存到相册或通过系统分享。 原图始终保留。普通图片的增强副本仅供本次预览，请在关闭对比面板前保存或分享；生图产物的增强副本会另外存入图库，不覆盖原记录。切图或退出后，旧任务不会在下一张图片上弹出结果。 ## 需要会员吗，为什么没有入口 超清增强 **无需 Pro**，但要求 API 26 或更高版本，并且设备提供系统图像超分能力；只有满足条件才显示入口，开通会员不能解除设备限制。华为当前的能力说明仅支持中国境内（不含港澳台），不支持模拟器。没有入口时，普通图片预览、保存和分享仍可使用。 ## 尺寸与格式限制 - 仅支持静态位图，原图宽高均需在 **17–2047 像素**之间。SVG 和多帧动图不进行增强。 - 1024×1024 以下更适合处理，较大图片可能更慢或超时。应用不会为满足限制擅自缩小原图。 - 普通预览图片输入上限为 32 MiB；远程图片还受现有下载限制与网络条件影响。 - 设备服务不可用、格式不适用或尺寸超限时会提示，失败不修改原图。 --- # 接入自己的生图模型 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：图像生成。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/image_model_setup/ ## 有自己的生图 API Key，怎么接进工作台？ 支持应用内置图像接口的模型，可在 **设置 → 模型与用量 → 服务商管理** 配好 Key、启用模型并打开 **图片生成** 能力，再到生图工作台选择。遇到阿里云百炼等原生接口，使用 **AI 接入生图模型**，让 AI 按官方文档制作并测试生图配方。 “配方”就是这个模型的调用配置。你不需要先学会写 JSON；提供服务商、准确模型 ID、地域和接口资料即可。**只开启“图片生成”只会让模型进入列表，不会自动把聊天接口转换为生图接口。** ## 第一步：准备服务商与模型 在服务商管理中配置自己的 API Key；已经配置过就直接复用，不必再复制到对话。还没配置时，也可在 AI 接入会话中使用 **安全保存密钥**，让 AI 帮你建立服务商。 百炼用户请准备： - 百炼控制台的模型调用 **API Key**，不要用阿里云 AccessKey ID / Secret 代替。见[获取百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key)。 - 准确的 **模型 ID**，例如 `wan2.6-t2i`；请使用你所在地域已开通、可调用的模型，以控制台与该模型文档为准。 - **地域与 API Host**。Key、模型与请求地址要对应；文档中的业务空间域名若含 `{WorkspaceId}`，须换成你自己的业务空间 ID。原有百炼聊天配置可保留，生图地址写在对应模型的配方里。 ## 第二步：先选一个能帮你配置的 AI 首次使用，打开 **设置 → 模型与用量 → 服务商管理 → 让 AI 帮我配置**，选一个可正常聊天、支持工具调用的文本模型，进入管理会话后即可返回。 这个是“负责读文档、配置接口的 AI”，与你要接入的“负责画图的模型”可以不同。只会输出图片的模型不能承担接入工作。 ## 第三步：进入生图接入，查文档并制作配方 打开 **生图工作台 → 顶部模型名称（未选择时显示“图像模型”）→ AI 接入生图模型**。工作台也可从 **设置 → 助手与能力 → 图像生成** 打开。 生图接入默认开启联网研究，独立于普通聊天的联网开关；优先使用可用的搜索服务，没有配置时提供无需 Key 的基础搜索与网页读取。输入区可切换搜索服务或关闭联网，主动关闭后会保留选择。 可以直接说“查百炼这个模型的官方文档”，也可以贴文档链接。AI 应先读请求与响应正文，再制作配方；搜索摘要不足以确认接口参数。网页无法读取时，把官方请求示例、响应示例和参数说明粘贴进来。 把下面内容复制到 **AI 生图接入**，补全方括号中的信息： ```text 请把阿里云百炼的生图模型接入生图工作台。 服务商名称：[应用中已配置的服务商名称] 模型 ID：[准确的模型 ID] 地域与 API Host：[控制台提供的地域和实际地址] 用途：先接入文生图，每次 1 张。 请先读取我的现有配置，查询并阅读这个模型的官方接口文档， 确认请求地址、必需请求头、尺寸和响应格式；若是异步接口，配置查询任务结果。 使用这个服务商已配置的 API Key 测试配方，不要让我重复粘贴 Key。 真实出图后展示结果，再请我确认保存，并告诉我回工作台如何选择。 ``` 百炼官方资料：[千问 Qwen-Image](https://help.aliyun.com/zh/model-studio/qwen-image-api)、[万相文生图](https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference)。**不同模型与版本的调用方式可能不同**，不要直接套用其他模型的地址、尺寸或配方。百炼聊天的 `compatible-mode` 地址不能直接用来调用这些原生生图接口。 ## 第四步：看见测试图片，再确认保存 AI 的配方测试会在本机使用目标服务商当前有效的 Key 发起真实请求，密钥明文不会作为测试工具结果交给 AI。测试图片会显示在会话产物卡片中；拿到任务编号、连接测试通过、或者 AI 说“配置好了”，都不能代替真实出图。 确认测试结果后，在配方保存确认面板中核对服务商与模型。**管理模型对话和生图测试都可能消耗各自服务商的额度**；先测试 1 张，成功后再批量使用。 ## 第五步：回工作台使用 返回工作台，打开模型面板，在 **自定义配方** 中选择刚才保存的模型，输入描述并生成。以后可在生成设置里 **编辑配方**；失败时复制工作台报错，回 **AI 接入会话历史** 继续排查。 ## 卡住了，先看这里 - **点 AI 接入却打开手动编辑页**：还没选可用的 AI 管理模型。先完成第二步，再回工作台进入。 - **没有联网工具或查询失败**：查看输入区联网状态；开启或切换服务，也可粘贴完整文档。关闭联网研究仍可用现有 Key 测试已有配方，但缺失接口资料时不应猜字段。 - **模型不显示**：核对配方是否真正保存到了目标服务商/模型、模型是否启用；保存有效配方会自动补上图片输出能力。仅保存服务商 Key 并不等于完成生图接入。 - **能聊天，生图却报错**：核对生图原生地址、模型 ID、地域和图片提取方式。不要通过改动整个服务商的聊天路径来修复生图。 - **提示不支持同步调用，或只得到 task_id**：让 AI 核对该模型的异步接口。配方可设置非鉴权请求头（如文档要求的 `X-DashScope-Async: enable`）和任务轮询；必须等待任务成功并提取最终图片。 - **想带参考图**：先确认具体模型支持图像编辑，再让 AI 配置参考图参数；文生图配方不会自动变为图生图配方。图生图配方无需 Pro。 熟悉接口的用户也可手动编辑配方。编辑页的 **DashScope** 和 **Async 异步任务** 是起点模板，需要按实际模型文档修改地址、参数、请求头与提取路径，并测试后再用；不是所有百炼模型通用的一键配置。 --- # AI 生图接入是什么？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：图像生成。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/recipe_onboarding/ ## 它能做什么 生图工作台内置支持 OpenAI 图像接口、Gemini、Imagen、Grok 等常见接口范式，但各家生图接口的细节差异很大（参数名、请求体结构、图片在响应里的位置都不一样），无法全部内置。**AI 生图接入** 把这类"接不进来"的生图模型交给 AI 处理：你在专用管理会话里贴上接口文档或描述需求，AI 自动试调接口、根据报错迭代修正，真实出图验收后保存为一份**配方**，模型随即出现在工作台，与内置模型同样使用。 入口在 **生图工作台 → 顶部配置胶囊 → 模型选择 → AI 接入生图模型**。与 AI 服务商管理一致，它也使用专用管理会话：标题栏固定标识当前模式，会话自动保留、可续用，不出现在任何会话列表里。 ## 什么是配方 配方是一份声明式数据，完整描述"怎么调用一个生图接口"： - **地址与鉴权**：URL 模板（`{{baseUrl}}` 会替换为所属服务商地址）与鉴权方式；密钥始终引用所属服务商，不会写进配方。 - **接口请求头**：`requestHeaders` 可声明接口所需的固定非鉴权头，例如百炼异步开关；鉴权由服务商 Key 自动附加，不要把 Key 写进配方。 - **请求体模板**：任意 JSON 结构加占位符（`{{prompt}}`、`{{modelId}}`、`{{count}}`、`{{param.参数名}}`），各平台的特殊要求（例如 content 必须是数组格式）直接照写即可。 - **参数表**：比例、尺寸、风格、种子等参数与取值范围。工作台的生成设置面板按参数表动态渲染——配方没声明的参数不会出现，每个模型的设置面板恰好只有它支持的选项。支持任意像素尺寸的接口还可在配方中声明 `customSize`，把工作台的宽 × 高输入映射到一个 `size` 参数或独立的 `width` / `height` 参数，并附带各自的范围、像素和倍数限制；关闭自定义尺寸时，仍可使用参数表中配置的常用预置尺寸。 - **提取路径**：声明图片在响应中的位置（支持数组展开与按字段过滤）与错误信息位置；提取失败时还有自动深扫兜底。 配方挂在具体模型上，保存后该模型自动标记为图片输出能力。 ## 直接对它说 - "帮我接入硅基流动的 Seedream，接口文档已粘贴。" - "新加的这个中转和 A 站一样，把 A 的生图配方复用到它的同款模型上。" - "生图报错了：{粘贴工作台复制的报错}，帮我修一下配方。" AI 会先读取本机真实配置再动手；目标服务还不是已配置的服务商时，会先新建服务商挂好地址与密钥，再开始试调。**保存前必须真实生成一张图验收**，测试图会直接出现在会话里；保存配方需要你确认，确认前 AI 不会声称已完成。 ## 多服务商复用 多个服务商只有地址不同、模型相同时，配方可以直接复用：告诉 AI 复制到哪个服务商的同款模型即可，AI 会读取现有配方改挂过去，并先对新服务商出图验证再保存。只有 URL 模板使用 `{{baseUrl}}` 相对形式的配方才能跨服务商复用；写死完整地址的配方（如 DashScope 官方原生端点）不可跨服务商复用。 ## 安全与清理 - 密钥可经输入区 **安全保存密钥** 按钮存入本机（对话里只显示脱敏引用，模型全程看不到明文），也可直接使用已配置服务商的密钥。 - 配方保存与服务商写入都需要逐次确认；联网搜索在输入区可开关、可切换引擎。 - 试调产生的测试图片随会话保留（回到该管理会话即可查看）；删除会话时连带清理，不留垃圾文件。 ## 工作台配合 - 配方模型在配置胶囊上带渐变小圆点标识；生成设置面板底部可打开 **请求预览**，查看按当前参数实时组装的实际请求（密钥已脱敏），排障时一目了然。 - 生成失败时，错误行提供两个入口：**复制**（复制含服务商与模型信息的报错上下文，带去 AI 会话咨询或建配方）与 **编辑配方**（一键带着报错进入配方编辑页手动修复）。 ## 手动编辑 不经过 AI 也可以管理配方：选中模型尚无配方时，生成设置面板会出现 **为此模型配置生图配方** 入口；模型已有内置适配（gpt-image、Gemini 图像、Imagen、Grok 等）时入口显示为 **基于内置预设微调配方**，编辑页会自动生成一份配方起点，改参数保存即可，不必从模板或 AI 从头配。GPT Image 预设支持最多 4 张参考图，添加参考图后自动切换到文件上传编辑接口；保留原名称和请求结构的旧 GPT 预设会在读取时自动补齐，原有参数和保存的 JSON 保留。Gemini 图像与对话出图预设支持单张参考图。已有配方则从设置面板 → **编辑配方** 进入编辑页。编辑页另内置多套起点模板（OpenAI 兼容对话出图 / DashScope 原生 / Images API / 图生图 / 异步任务），支持 JSON 校验、真实测试生成与保存，也可在编辑页删除配方（清空配方，模型与密钥保留；内置适配模型删除配方后即恢复预设行为）；把目标服务商或模型切换后再保存，即为复制。尚未设置 AI 管理模型时，「AI 接入生图模型」入口也会先打开这里；可在服务商管理页设置管理模型后使用 AI 接入。 ## 最佳实践：一次接成功 1. **备好材料**：官方接口文档原文或能跑通的 cURL 示例最有效，地址、请求体、**响应示例**缺一不可——响应示例决定图片提取路径；实在没有文档，再口头描述需求。 2. **一次接一个模型**：先在最容易成功的官方站接入并验收，再让 AI 把配方复用到同款模型的中转上。只有 URL 模板使用 `{{baseUrl}}` 相对形式的配方才能跨服务商复用。 3. **走报错闭环**：工作台生成失败时，用错误行的 **复制** 带走完整上下文去问 AI，比口头说「报错了」高效得多；想自己动手就用 **编辑配方**。 4. **验收后再批量**：保存前必须真实出图；保存后先在生成设置面板底部打开 **请求预览** 核对参数，再批量生成。 5. **密钥不粘贴明文**：用输入区 **安全保存密钥** 按钮存入本机，或直接使用已配置服务商的密钥。 ## 当前边界 文生图与图生图使用不同接口时，可声明 editRequest（包含 urlTemplate、requestEncoding、bodyTemplateJson）：有参考图时使用此分支，无图时仍使用主模板；参数、鉴权和响应提取规则共用。图片参数也可仅在编辑分支中引用。GPT Image 内置预设已包含此配置。 配方在参数表中声明 `image` 参数后即可使用参考图（图生图），未声明的纯文生图配方暂不支持；参考图以 base64 内联注入，可选参数（required:false）在未添加参考图时自动省略请求体中的注入点，一份配方可同时覆盖文生图与图生图，单图参数还支持 `{{param.<键>.mime}}` / `{{param.<键>.base64}}` 子键拆解（供 Gemini 原生 inline_data 这类 MIME 与数据分字段的接口）；文件上传类接口（如 OpenAI images/edits）可设置 requestEncoding 为 multipart/form-data：bodyTemplateJson 用顶层对象描述表单，普通字段为字符串、数字或布尔值，图片字段完整引用 {{param.<键>}}，字段名按接口要求填写 image 或 image[]；多图按同一字段名上传，不支持嵌套对象、数组及图片 .mime/.base64 子键。省略 requestEncoding 时保持原有 JSON 行为。需要"提交任务后轮询取图"的接口请使用配方的 async 段（详见「生图配方怎么设计好用?」）。 --- # 生图配方怎么设计好用？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：图像生成。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/recipe_best_practice/ 「AI 生图接入是什么?」讲的是把模型接进工作台的流程;这篇讲配方本身的取舍——参数怎么声明好用、什么时候需要异步任务。AI 接入与手动编辑两条路都适用。 ## 三条接入路径怎么选 - **AI 接入**:有官方文档原文或能跑通的 cURL 时首选。AI 会研究接口、真实试调出图,验收后保存;目标服务商还没配置时,它会先建好服务商并保管密钥。 - **内置预设起点**:模型已有内置适配(gpt-image、Images API、Grok、Imagen、Gemini 图像、对话出图),只是想改参数或加参数时,在配方编辑页选「内置预设」,应用按当前服务商地址生成一份等价配方起点,小改即存。 - **模板手写**:接口特殊或你熟悉 JSON 时,从五套模板(对话出图 / 百炼原生 / Images API / 图生图 / 异步任务)起步,用编辑页的「校验」和「测试」兜底。 ## 参数面板:让设置变成点选 配方里声明的参数会直接渲染成工作台控件。按取值特征选类型: - 固定枚举(尺寸、质量、风格档)用**点选胶囊**,不要让用户手输易错值; - 有边界的数值用**步进器**或**滑条**; - 是/否选项用**开关**;自由文本(种子、风格提示)用**输入框**; - 参数支持**条件显隐**:比如只在某个选项取特定值时才露出下一级参数。 支持任意像素尺寸的接口,用 `customSize` 声明宽高参数与边界(倍数、像素上下限),工作台即可自由出尺寸,不必枚举一大堆预设档。 ## 参考图:一份配方可选两用 `image` 类型参数(最多 4 张)就是图生图入口。把参考图声明为可选(`required: false`)后,不传图时请求体里的注入点会被整体省略——同一份配方无图走文生图、有图走图生图,不会因空字段被接口拒绝。需要 MIME 与数据分字段的接口,再用 `.mime` / `.base64` 子键拆解。 ## 异步任务:慢模型的解药 如果生成经常在一两分钟处失败并提示「服务网关提前断开了连接」,多半是中转网关掐断了长连接——图片可能已在服务端生成,只是响应回不来。这时改用异步配方,把"一次等到底"拆成两步: 1. **提交**:正常发起请求,从响应提取任务 ID(`taskIdPath`); 2. **轮询**:按 `pollUrlTemplate` 定期查询任务状态,出现成功值后按提取路径取图。 默认轮询预算约 10 分钟,间隔自适应,限流(429)会自动退避;超时会提示任务可能仍在服务端执行。编辑页的「Async Task 异步任务」模板可以直接起步;凡是"提交返回任务 ID、再查询取结果"的接口都适合这条路。 ## 单次张数与排队 配方声明单请求张数上限(1-4 张);Pro 还可调整生成并发与队列长度,边生成边排队,429 限流自动重排、提示词不丢。 ## 常见问题 - **保存配方会影响内置适配吗?**——配方接管该模型;删除配方即恢复应用自动识别,模型与密钥保留。 - **图生图是会员功能吗?**——文生图、图生图及配方生成均无需 Pro；免费用户同一时间可运行 1 个任务，多任务提交、排队与并发为 Pro 能力。模型调用费用由服务商收取。 - **想跨服务商复用?**——让 AI 把配方改挂到另一个服务商的同款模型上即可;只有使用 `{{baseUrl}}` 相对地址的配方才能跨服务商复用。 --- # 云空间同步和数据备份有什么区别？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/cloud_sync_experimental/ **设置 → 数据与同步 → 云空间同步** 是默认关闭的实验入口。开启前核对范围：包含助手、服务商等配置及相关凭据，以及技能说明、脚本和附带资源；不包含聊天记录、知识库正文和本机文件夹授权，不能替代完整数据备份。 技能包同步需要两台设备都升级到支持版本。助手配置先到，技能包下载并校验后自动安装，保留原标识与助手关联；不同内容需要处理冲突。本机执行授权、隐藏配置、执行历史和依赖缓存不复制。首版每个技能最多 1000 个文件、原始内容合计 16 MiB、单文件 10 MiB；未下载完成、超限或校验失败会单独提示，其他配置仍继续同步。知识库内容仍需另行传送。 单项配置最大 512 KB。超出的配置（常见于模型列表很长的服务商，或系统提示词很长的助手）会单独列出、暂不同步，其他配置照常同步；它们保留在本机，不会被删除，也不会被其他设备的版本覆盖。删除不用的模型或精简提示词后，会自动重新同步。 开启后可查看同步状态，手动立即同步，并处理冲突与图片等待。发生错误时按页面提示处理，不要把“部分同步”理解为全部完成。当前正式签名环境和完整双设备流程尚待验证，本版不承诺正式环境可用；换机、清理或重装前请通过数据备份保留完整副本。 --- # 数据备份 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/backup/ ## 先确认资料是否已备份 连接 Cube Agent 在线服务、登录华为账号或恢复购买，都不会自动备份聊天记录与知识库。请单独执行数据备份，确认上传成功；仅显示云盘已就绪或待上传，不代表备份已完成。当前备份需要手动执行，不是实时同步。 ## 本地导出 / 导入 可以把对话、附件与配置打包成一个备份文件。在新设备或重装应用后,使用 **设置 → 数据与同步 → 导入数据** 恢复。第三方应用备份导入请看“导入第三方备份”。 打开 **设置 → 数据与同步 → 导出数据**，默认使用 **备份迁移** 并选中可导出的内容，可取消不需要的条目，核对后保存文件、分享文件或使用实验性碰一碰传送。导入与碰一碰接收共用核对流程：对话、记忆和用量默认合并，对话冲突保留恢复分支，记忆不同内容同时保留；配置冲突默认跳过。也可主动选择跳过、保留完整副本或替换，替换需确认可能丢失本机独有内容。 ## 所选配置的凭据会一起导出 服务商 API Key、多 Key 池、自定义请求头、搜索密钥、MCP 鉴权、SSH 密码／私钥／口令及助手环境变量，都会随所属配置一起导出。选择 **分享内容** 也不会自动移除这些凭据；不希望传送某项配置时，应取消选择该配置。完整数据备份还会携带 SMB 连接配置及密码；当前选择性传送不包含 SMB 连接配置。 核对页会说明文件包含明文凭据，条目预览不显示凭据值。配置或凭据无法完整读取时，整次导出失败，需要解决错误后重试，不会生成缺少凭据的成功包。请仅保存到可信位置或交给可信接收方，不要把包附在反馈中。 若清单提示部分技能或文件名称不受支持，这些内容不会列入可选项。技能作为整体检查，不会只传一部分脚本或配置；请整理名称后重新读取清单。其他可选内容仍可正常导出。 历史消息的模型名称和 ID 会随导入保留；旧备份缺少凭据时保留本机已有密钥。知识库目录、助手规则与开场配置也随相应数据导出；导入后自动模型开场关闭，后续需要时再启用。知识库目录请使用支持该功能的版本恢复，旧版重写可能丢失层级。 选择性传送仍遵循导入规则，部分模型连接或助手工具绑定需要重新检查；生成图片分类不等于完整生图任务备份。重复导入并选择保留两份会继续增加副本，不等同于设备自动同步。 ## 数据备份（华为云盘 / WebDAV / SMB） 入口在 **设置 → 数据与同步 → 数据备份**。同一页面用顶部切换选择通道，共用立即备份与备份历史；华为云盘和 SMB 从 **恢复** 选择文件夹，WebDAV 可使用 **恢复最新**： - **华为云盘**：登录华为账号，并在系统云空间允许本应用使用云盘，备份包保存在你自己的华为云空间。 - **WebDAV**：配置网盘或服务器的 WebDAV 地址、目录与登录凭据，适合已提供 WebDAV 服务的网盘或 NAS。 - **SMB 备份**：连接 NAS、家庭存储或电脑开放的 SMB 2/3 共享，将备份保存到指定共享内的目录。通常在同一局域网使用；应用不会自动为 NAS 开通外网访问。 SMB 客户端要求服务器支持签名，目前不支持 SMB1，也不会自动发现 NAS；请手动填写设备的地址和共享信息。 三个通道共用同一套备份格式： 1. 备份范围包含知识库、对话、附件／生图、助手、服务商密钥、偏好等；需要只导出部分会话时请用 **设置 → 数据与同步 → 导出数据**。 2. 首次 **立即备份** 生成完整备份，作为后续增量的基础；文件名以 `cubeagent_backup_` 开头。 3. 完整备份及变更记录仍可用时，后续只上传变更，增量文件名以 `cubeagent_incr_` 开头；无新增变更时不上传。 4. **恢复最新** 会恢复所选来源的完整备份与连续增量；华为云盘和 SMB 先选择文件夹，WebDAV 多来源时先选择设备；消息与记忆逐条合并，保留本机独有内容；单边续聊补入原会话，双方续聊或共同消息冲突时另存为「恢复分支」。全局及助手记忆保留两端不同内容，增量备份中的删除记录不会删除本机数据。 5. 要先看清单，请在 **最近备份** 中点击指定历史条目的 **恢复**。应用先下载、检查文件并显示会话、消息、附件等统计，点击 **确认恢复** 后才写入；点击取消不会导入。此入口只恢复所选包，单个增量包只含该次变更。历史条目也可单独删除，删除可能使依赖它的增量链不再完整，操作前请确认仍有可用的完整备份。 ## 华为云盘：备份位置与恢复 - **备份位置 → 更改**：选择已有文件夹或新建文件夹。默认按设备分开存放；切换位置后，下次备份会生成完整包。升级后设备标识变化时，也会重新建立完整基线，不需要删除旧包。 - 备份位置只保存在当前设备，不随备份迁移。设备标识在系统允许的有效期内稳定，不能保证卸载重装后不变；重装后可在恢复列表中手动找到旧文件夹。以前安装产生的备份仍可能显示为“其他设备”。 - **恢复 → 文件夹 → 最新状态**：恢复该文件夹内可用的完整备份及其连续增量。**选择具体版本 → 恢复** 则先下载并展示预览，确认后才写入。应用会核对增量包依赖的完整基线；无法验证或断链时，只保留已成功恢复的部分并提示，不能把不同安装的序号直接拼成一条链。 - 旧版本直接存放的包显示在 **旧版备份** 中，不自动迁移或删除。另一台设备默认使用自己的文件夹；查找其他设备备份时，请从 **恢复** 进入文件夹列表，而不是只看当前位置的“最近备份”。 ## 华为云盘：清理与清空 “云空间内容”卡片底部有两个不同的操作，都需要二次确认： - **清理历史数据**：删除旧版备份、异常残留或其他列出的历史条目。勾选时只清理所选项；未勾选时清理确认时列出的全部历史项。所选目录包含其中全部内容，新发现的条目不会自动加入本次清理。请先检查名称与用途，不要把仍需恢复的旧版备份当成无用文件。 - **清空此备份位置**：删除当前备份文件夹中的全部内容，并清理异常残留；其他备份文件夹与旧版根目录备份不随之清空。若其他设备也使用这个位置，它们的文件同样会被删除，请先停止向该位置备份。清空后下次重新生成完整备份。 两种操作都不会清空本机聊天，但云端删除不可恢复；中途失败时可能已有部分条目被删除，应刷新核对后再决定是否重试。目录重新扫描与同步完成不等于锁住其他设备，其他设备稍后写入仍可能重新出现文件。 ## 配置 SMB 备份 在 **SMB 备份 → 服务器配置 → 编辑** 填写以下内容。假设 NAS 地址为 `192.168.1.10`、已开放共享 `backup`，希望以其中的 `CubeAgent/phone` 作为备份根目录： - **地址**：填 `192.168.1.10` 或可解析的主机名，只填主机部分，不附加共享路径或端口。 - **共享名称**：填 `backup`，必须与设备在网络邻居／SMB 中已开放的共享名称一致；不是设备名称，不要填写本地磁盘路径或多级目录。 - **备份子目录**：填 `CubeAgent/phone`，表示共享内的子目录；默认是 `CubeAgent`，留空从共享根目录开始；开启“按设备分目录”后，还会在其下追加本机目录。测试连接或备份时会创建缺少的目录，需写入权限。目录不能包含 `..`。 - **账号、密码**：填写具有目标目录读写权限的共享账号和密码。 - **更多设置**：域通常留空，只有服务器要求时才填，例如 `WORKGROUP`；端口默认 **445**，服务器使用其它 SMB 端口时再修改，范围为 1～65535；不要填写 NAS 管理网页的端口。 华为家庭存储需先在设备管理入口开启 **网络邻居／SMB 共享**，常见入口为智慧生活的家庭存储页面中的 **应用服务 → 网络邻居**，具体名称与位置随设备和版本而异。这里使用的是 **网络邻居设置的账号和密码，不是华为账号密码**；共享名和当前 IP 以设备页面实际显示为准，路由器重新分配 IP 后需更新地址。操作入口可参照[华为家庭存储官方说明](https://consumer.huawei.com/cn/support/content/zh-cn15927787/)。 例如 `smb://192.168.1.10/backup/CubeAgent/phone` 中，`backup` 是共享名称，`CubeAgent/phone` 才是备份子目录；不是两个可互换的路径。 填写后先点 **测试连接**。SMB 测试会在目标目录实际检查临时文件的写入、读取、重命名与清理权限，测试成功后点击 **保存**，返回备份页再点 **立即备份**。测试成功不等于配置已经保存，也不等于完成备份；修改字段后应重新测试。操作忙碌时无法改目标，请等待完成或按页面提示取消。 换到新的服务器、端口、共享目录或访问账号时，会使用该目标独立的备份进度，首次备份重新生成完整备份，不会延续旧目标的增量进度。各目标分别保留历史；修改并保存 SMB 连接配置后，下次备份也会重新生成完整包，以完整携带最新配置和密码。多个通道交替备份时，如果某个通道落后、所需变更记录已被清理，或远端完整备份已缺失，应用会自动重新生成完整备份；这时包变大、耗时增加属于正常行为。 SMB 连接密码在本机安全存储中保存。设备锁定、凭据缺失或不可读取时，请先解锁并重新打开配置，必要时重新输入密码保存；不会用读不到的密码冒充空密码继续操作。本机安全存储不代表备份文件已加密：完整数据备份会携带 SMB 配置及密码，所选业务配置的凭据也会按上述规则进入备份或导出包，预览仅隐藏其值。需要导出的配置或凭据无法完整读取时，整次备份／导出会停止，不生成缺少凭据的成功包。 ## SMB：多设备目录、恢复与删除 - **按设备分目录**：新配置默认开启。例如共享为 backup、备份子目录为 CubeAgent，实际备份位置为 CubeAgent/device-设备标识。主页面显示实际位置；目录标识由哈希派生，不包含原始设备标识。 - **已有配置升级**：保留原路径，不自动开启分目录，也不搬迁或删除旧文件。手动开启后，新目录首次生成完整备份；关闭后重新使用原目录。重装或系统标识重置后，本机目录可能变化，旧目录仍可从恢复入口找到。 - **查找旧版或其他设备备份**：进入 **恢复**，选择原目录中的 **旧版备份** 或其下的设备文件夹，再选择版本。浏览不会改变本机备份位置，也不会把其他设备目录设为上传目标。列表只浏览配置根目录及其直接子目录；更深的历史目录需将备份子目录设为该位置，并关闭按设备分目录后恢复。 - **恢复最新状态**：会合并所选目录内各设备的完整备份和连续增量，开始前再次确认；同一条本机记录可能被更新。只想查看或恢复某次备份时，选择具体版本，下载并核对预览后再确认。 - **删除备份**：确认框显示目标目录和文件名，只删除该文件，不递归清空目录。确认后若配置已变化，需重新确认；删除完整基线可能使依赖它的增量无法恢复。恢复列表不提供其他设备目录的删除入口。 目录隔离用于避免多设备混写，不代替服务器权限。使用同一 SMB 账号的人仍可能通过其他工具访问这些目录；备份也不是多设备实时双向同步。 ## SMB 连接与恢复遇到问题时 - **无法连接或超时**：确认 NAS 在线、共享服务已开启，手机与服务器网络可达，检查地址、端口及路由器的设备隔离设置。在外网使用需已有可达网络，仅填家庭内网 IP 不能自动远程连接。 - **认证失败**：检查共享账号、密码以及服务器是否要求域；华为家庭存储请检查网络邻居账号。 - **没有读写权限**：检查共享与目录两级权限。能浏览目录不一定能备份，测试所用的写入、读取、重命名和删除临时文件都需要授权。 - **共享、目录或文件不存在**：核对共享名与子目录后刷新列表；查找另一台设备的备份时，连接同一配置根目录，再从“恢复”选择来源目录。 - **空间不足或校验失败**：检查 NAS 和手机的可用空间、网络稳定性，解决原因后重试。出现失败提示或只显示传输进度，均不能当作备份成功。 ## 备份范围与运行 完整备份包含知识库正文、索引及库内已保存的原始文件，不包含尚未导入应用的外部文件；还会包含会话工作目录中由 AI 生成的文件，以及助手使用的自定义聊天壁纸。恢复到新设备后，这些文件和壁纸会一并还原。只导出部分会话时，可按需关闭“包含工作目录文件”以减小备份包体积。 备份与恢复支持切到后台继续（长时任务保活），实际运行仍受系统限制。备份可按页面提示取消，大量消息版本读取期间也会响应取消；恢复进入数据写入阶段后暂不可取消，避免只恢复部分数据。 消息导出采用分页读取与分块写入，完整保留超长正文；不会为缩小备份而截断消息。备份仍可能需要较长时间和可用存储空间。 若清单提示部分技能或文件名称不受支持，这些内容不会列入可选项。技能作为整体检查，不会只传一部分脚本或配置；请整理名称后重新读取清单。其他可选内容仍可正常导出。 导出与碰一碰会提前核对所选 SSH 配置的登录凭据。若凭据已失效，请到远程连接重新填写密码或选择私钥并保存；设备锁定时先解锁。读取凭据失败会终止整次导出，不生成缺失凭据的成功包。预览不展示凭据值，但导出包包含所选配置的明文凭据。 ## 华为云盘同步与上传状态 - 上传阶段会同时监听系统同步状态与文件上云结果。网络不可用、系统限制仅 WLAN、低电量、云空间已满、本机空间不足或设备温度过高时，会尽快显示可操作原因，不再长时间无反馈。 - 上传阶段显示 **正在同步至华为云空间** 的等待状态，耗时取决于备份大小和网络。系统没有提供该文件的上传字节进度，因此不显示按等待时间增长的百分比；只有确认目标文件实际上传完成才会记为成功。 - 新建文件夹与刷新备份历史会先等待云端目录同步完成。刚完成新建或清理时，系统可能短暂返回“未就绪”（22400001），应用会自动短暂退避重试，仍未恢复时才提示失败。同步失败或超时时保留上次显示的列表，并提示检查或重试；保留列表不代表它已经是云端最新状态，也不能据此判断备份已被删除。 - 上传中断后仅留在本机、尚未真正上云的包会标记为 **待上传到云端**，也不会改写“上次备份”时间或显示为安全备份。 - 仅在云端的备份会先下载到本机，再复制到导入缓存。下载启动与传输都响应取消和超时；取消或失败后会尽力停止系统下载，未确认恢复前不写入业务数据。请预留下载和解压所需空间。 若提示云目录或系统同步服务异常，可按提示关闭再重新开启系统云空间中的应用同步开关，仍无效时重启设备并提交诊断日志。遇到备份目录被同名非目录条目占用时，应用会尝试保留原内容后修复；无法安全处理时会明确失败。 ## 另一台设备看不到备份时 先确认两端使用同一华为账号、系统云空间中已允许本应用同步，并确认源设备的备份已经上传成功，再在目标设备刷新备份历史。遇到目录尚未同步完成或同步受限提示，按原因检查网络、WLAN 限制、电量和空间后重试。仅在源设备生成备份文件不代表已上云；更新应用也不会自动把旧的未上传备份变成已完成备份。 ## 注意事项 - 华为云盘、WebDAV 与 SMB **分别记录备份进度与历史**，可以按需使用多个通道；切换通道不会自动复制其它通道的备份。 - 这是 **灾备备份**,不是双设备实时协同:两台都改再互相同步可能互相覆盖,建议明确一台主设备日常备份。 - 备份包含所选配置的密钥和登录凭据，请只保存到可信位置，预览隐藏值不代表导出文件已经脱敏。 - 知识库正文会随 1.4.3 及之后版本的备份恢复;更旧的备份若只有挂载引用,需在新设备重新导入知识库。 - 导入偏好后默认模型和 Prompt 缓存会自动刷新,不必重启应用。 - 数据备份页可开启备份提醒，按三个通道中最近一次备份时间判断；提醒不会自动执行备份。服务器账号建议使用具有所需目录权限的专用账号，请妥善保管含凭据的备份文件。 --- # 如何使用碰一碰传送？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/nearby_transfer/ ## 先了解功能边界 这是一项实验性文件传送功能，尚未经双真机验证。它把你选中的内容打包，交给系统分享，再由接收端核对导入；**暂不支持自动双向同步**。是否可用取决于两端机型、系统版本与碰一碰支持情况。 ## 发送步骤 1. 两端安装支持该功能的新版 Cube，亮屏解锁并开启华为分享。 2. 在发送端进入 **设置 → 数据与同步 → 碰一碰传送**，选择发送；设置搜索也能用“碰一碰”或“手机互传”找到入口。 3. 选择要传送的内容，核对清单。所选配置的 API Key、搜索密钥、MCP 鉴权、SSH 凭据和助手环境变量会一起进入包内，文件含明文凭据，请只交给可信设备。 4. 按引导轻碰支持的设备，再按系统卡片提示确认传送。也可在导出页选择 **分享文件**，通过其他方式交给对方。 ## 接收与导入 手机、平板或电脑经系统收到 Cube 传送包后，选择用 Cube 打开，再核对导入；若没有自动打开，可从文件管理中选择 Cube，或在导入页手动选择文件。支持的平板或电脑还可在接收引导中开启窗口内接收。 文件通过校验后才进入导入清单，与文件导入使用相同规则：对话、记忆和用量默认合并，冲突对话保留恢复分支；也可主动选择跳过、保留完整副本或替换。收到文件不等于已经导入；发送端的 **已交给系统传送** 也不代表对端已完成导入，最终结果以接收端页面为准。 ## 失败、取消和反馈 等待超时或失败后可重试，或改用 **分享文件**。退出页面、切到后台会停止应用内等待；已经交给系统的传送，请在系统界面查看或取消。 反馈时提供两端机型与系统版本、发送方向、失败阶段和页面提示，也可说明文件分享是否成功。请勿提交传送包、密钥或私钥。 --- # 导入第三方备份 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/foreign_import/ ## 支持哪些来源 打开 **设置 → 数据与同步 → 导入数据**,选择备份文件。当前支持本软件备份,以及 Cherry Studio、RikkaHub、Kelivo 的备份文件。 ## Cherry Studio 请在 Cherry Studio 中使用 **导出为 JSON** 得到的文件。直接备份 LevelDB 目录暂不支持。导入时不会导入工具调用历史、联网搜索结果和偏好设置。 ## RikkaHub 完整对话依赖读取备份中的数据库。如果数据库读取失败,可能只导入服务商和助手。RikkaHub 导入不包含图片/文件附件、工具调用历史、联网搜索结果和偏好设置。 ## Kelivo Kelivo 可导入会话、消息、服务商和助手等可识别数据,但不包含图片/文件附件、工具调用历史、联网搜索结果和偏好设置。 --- # 存储管理 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/storage_management/ ## 它是什么 存储管理用来查看应用各模块的占用空间,并在空间不足时安全清理冗余文件。入口在 **设置 → 数据与同步 → 存储管理**。 ## 可查看的占用 占比会按 会话与消息、对话附件、AI 生图、知识库、技能、脚本产物、缓存、数据库、应用本体 等模块分别展示(其中「缓存」已合并临时缓存与模型/服务商图标缓存;「数据库」以单行展示,不再细分主库 / WAL / SHM)。 ## 可清理项 - **冗余附件文件(孤儿附件)**:已无任何会话或记录引用的附件文件。 - **临时缓存**:导入导出预览等临时文件,以及模型/服务商图标缓存(清理后按需重新下载)。 - **脚本工作区**:已删除会话留下的脚本产物。 - **未使用字体**:已下载但当前未启用的字体文件。 ## 是否安全 可用页面底部的 **清理** 处理选中的冗余项，提交前请核对清单。扫描会检查聊天附件、生成媒体、消息内容和未发送草稿中的文件引用，读取失败时停止扫描，避免用不完整的引用列表判断文件无用。 大量聊天记录会分批读取，以减少界面长时间无响应；扫描失败后应按提示重试，不要把未完成的扫描当成可以清空附件目录的依据。 ## 什么时候用 感觉空间占用异常、或收到空间不足提示时,可以来这里查看各模块占用并清理冗余。如果「会话与消息」一行出现「数据库预写日志冗余」的警示,说明预写日志未正常回收(通常体积比主库还大),与真实数据量无关——继续正常使用或重启应用后一般会自行收敛,无需手动删除这些文件。 --- # 诊断与崩溃日志 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：数据与同步。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/diagnostics/ ## 什么时候使用 遇到闪退、冻屏或难以复现的异常时，打开 **设置 → 连接与高级 → 诊断与崩溃日志**，查看已记录的故障报告及应用运行日志。 ## 采集运行日志 日志采集默认关闭。需要排查时，先开启页面中的日志采集开关，再回到出问题的页面复现。默认采集警告与错误；需要更多线索时可开启详细日志，包含 INFO / DEBUG。反馈云盘备份、同步类问题时请先开启详细日志再复现，否则报告里看不到备份流程的过程记录。采集在 15 分钟窗口内会跨页面、跨重启自动续采，不必每次重新开启。采集会在 15 分钟后自动停止，重启应用后保持关闭。 运行日志只保留最近约 2 MiB。页面预览展示末尾内容，导出包含当前保留的完整日志；需要时也可清理运行日志。 分享或导出的报告还包含 **内存水位**：应用在启动、前后台切换、打开对话、系统内存告警时以及运行期间每 10 分钟记录一次内存占用，保留最近 240 条，闪退或重启后仍在，便于判断闪退前内存是否持续上涨。它不受日志采集开关影响，只记录内存数值、同时生成的回复数和浏览器标签数，不包含对话内容。 ## 如何反馈 1. 复现后返回诊断页面，刷新查看最新记录。 2. 使用 **分享报告**，或选择 **导出** 保存 TXT 文件。按需要选择是否包含故障详情。 3. 打开 **设置 → 反馈与建议**，在新工单或补充消息中添加 TXT 日志附件。 4. 同时说明发生时间、操作步骤、是否可以稳定复现，便于对照日志定位。 反馈支持 1 个不超过 5 MiB 的 UTF-8 TXT 文件。选择附件不会立即上传，提交或发送时才会上传。日志可能包含运行过程中的信息，发送前请检查内容，避免附上密钥或其他不希望分享的信息。没有故障报告不代表没有发生问题，也可以提供运行日志和复现步骤。 --- # 如何连接 SSH 服务器？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：远程连接。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/ssh_connect/ ## 首次连接（Pro） 1. 打开 **设置 → 连接与高级 → 远程连接 → 添加服务器**。 2. 填写服务器地址、SSH 端口（通常为 22）和服务器上的用户名。名称可选，地址填写 IP 或域名，不带 ssh://。 3. 选择 **私钥** 或 **密码**。私钥从文件选择；有私钥口令时再填写口令。登录凭据自动加密保存在本机，无需另外开启保存；缺少或无法读取时，按提示补充后再连接。 4. 点击 **连接**。首次连接需将主机指纹与服务器控制台或管理员提供的信息比对，核验后选择 **信任并连接**。 ## 终端与聊天工具 - **打开终端 / 继续终端**：直接输入命令，按 Enter 执行，不需要配置模型，也不逐条审批。终端输入和输出不会自动发给模型。 - **聊天中的远程连接工具**：在聊天工具列表勾选“远程连接”即可，无需先选服务器。“远程连接”入口与联网、工具、推理位于同一排；点击可管理服务器。模型先查询已配置的服务器，再按你的需求指定目标执行；目标不明确时应先询问。每次执行都会显示目标服务器，模型必须支持工具调用。 手动终端与聊天命令可以同时连接同一服务器，聊天使用独立连接，不继承终端中的当前目录和临时环境变量；同一服务器的聊天执行仍互斥。服务器页面不保存对话与主机的绑定。 ## 编辑连接 在服务器列表点击 **编辑**。未填写新凭证时保留原凭证；切换认证方式时需确认该方式的凭据可用。**更多设置 → 默认目录**用于聊天命令，留空时使用远端登录目录。正在占用的连接需先结束再编辑。 服务器卡片可单独控制是否允许 AI 使用该主机。关闭后，助手不能通过远程工具发现或操作它，手动终端与文件浏览仍按原有权限使用；开启 AI 使用也不会跳过主机指纹和命令授权。 主机指纹变化时先通过其他渠道核验，再管理旧信任，不能直接沿用原授权。 ## 网络存储 远程连接页底部的 **网络存储** 用于添加 NAS、坚果云等 WebDAV 存储，让 AI 在对话里直接读写文件，和 SSH 服务器互不影响。详见「怎么把 NAS 或网盘接进对话？」。 --- # 如何浏览和传输远端文件？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：远程连接。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/sftp_files/ 在 **设置 → 连接与高级 → 远程连接** 中找到主机，点击 **浏览文件**。复用同一份 SSH 地址、登录凭据和主机指纹；目标主机需要开启 SFTP。 点击文件夹整行即可进入；路径栏可前往指定目录，旁边可返回上一级或刷新。点击文件行下载，点击 **上传** 选择本机文件，文件夹加号用于新建目录。 标题栏搜索用于筛选当前目录。系统返回先返回上级目录，顶部关闭按钮直接退出文件页。认证失败时可修正凭据后点击 **重新连接文件**；通过 Cube 随行返回时，可按需要重新连接到上次目录。 手机通过 **浏览 / 传输** 切换；宽屏同时展示文件和传输记录。传输可取消，失败或取消后可 **从头重试**。替换远端同名文件必须重新核对并确认，不继承聊天命令的“始终允许”。 普通聊天附件面板的 **本地文件** 从手机选取；**远端文件** 从主机下载，完成后选择 **加入聊天**，不会自动发送。下载也可以 **另存为**；清除传输记录不会删除已经另存或加入聊天的副本。 聊天中的 **远端文件** 工具可以浏览、新建、上传和下载；直接新建文本最多 16 MiB（按 UTF-8 字节计算）。附件及生成的 Excel、PDF、图片等可原样上传，单文件最多 256 MiB，不覆盖远端同名文件。确认面板可选 **允许一次** 或 **始终允许**。始终允许按操作分开保存：在浏览或下载时确认只放开 **浏览与下载**，在新建或上传时确认只放开 **新建与上传**。它保存在本设备，重启后仍有效，适用于所有会话中已启用的远端文件工具和已配置、已核验的服务器；可在 **设置 → 工具服务 → 授权 → 远端文件（SFTP）** 按操作查看和撤销。它与 SSH 命令的按主机授权独立，主机身份和对话文件范围仍逐次检查。 离开页面不会主动取消传输，长时间后台运行取决于系统。重启后不会自动重传，也不提供断点续传。 --- # 终端字体、粘贴和组合键怎么设置？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：远程连接。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/ssh_terminal/ ## 字体与界面 终端跟随应用的深浅色，并使用 **字体设置中的代码字体**。在 **设置 → 应用设置 → 显示与外观** 中选择代码字体即可，无需在终端再选一次。未配置或加载失败时使用系统等宽字体。 ## 常用操作 终端区域点击、滑动不会唤起软键盘；点击常用按键中的 **键盘** 开始输入。上下滑动查看历史，双指捏合可调整字号（8–24，默认 14），不唤起键盘。字号独立保存，不改变全局代码字体；在 **显示** 中也可调整字号或恢复默认。在标题栏菜单中打开 **显示**，可选择 **适应 / 80 / 120 / 160 列**。适应模式按屏幕宽度自然换行；top 等全屏程序会自行决定显示哪些列，宽列模式向远端报告更大的终端宽度，可左右滑动查看，不会强行折行破坏表格。 点击 Cube 开合常用按键，提供 Esc、Tab、Ctrl、方向键、键盘与更多；Home、End、PgUp、PgDn 和组合键收在 **更多** 操作面板中，也可从标题栏 **显示** 打开。**Ctrl** 为单次修饰键，点亮后输入 C 对应 Ctrl+C，也可与方向键组合。想常驻按键时选择 **更多 → 固定按键条**；隐藏 Cube 时仍保留替代按键条。 ## 专注模式与横屏 在标题栏菜单或操作面板开启 **专注模式**，隐藏常规标题并扩大终端区域；顶部仍可退出专注和调整字号。手机可选择 **横屏显示**，随后用 **恢复方向** 返回原策略；离开页面也会恢复。非全屏窗口可能无法切换方向，以页面提示为准。 终端是持久 shell，cd、export 等状态在同一终端内延续；聊天的每次命令有自己的工作目录，不继承手动终端状态。 ## 自定义组合键 打开 **更多（或显示）→ 组合键 → 管理**，添加按键，例如 Ctrl+L、Alt+B、Ctrl+Shift+Left。名称可选，例如把 Ctrl+L 命名为“清屏”。已保存条目可点开编辑，也可删除；最多保存 12 项，重启后保留在本机。 支持 Ctrl、Alt、Shift 与字母、数字、方向键、Home / End、PageUp / PageDown、Insert / Delete、F1–F12 等。部分组合没有通用终端编码，会提示换用其他按键。它发送的是组合按键，不是命令脚本；实际效果由远端 shell 或程序决定。 默认提供 Ctrl+C、Ctrl+D、Ctrl+L、Ctrl+Z。Ctrl+C 通常用于中断，Ctrl+D 可能退出 shell，Ctrl+Z 通常挂起当前前台任务。 ## 复制与粘贴 在操作面板点 **选择文字**，长按选择后使用 **复制选中**，也可取消选择回到滑动模式。点 **粘贴**后先查看内容，多行需额外确认；应用不会额外补一个 Enter，但内容中已有的换行仍可能执行命令。 外接键盘可直接操作终端。Ctrl+Shift+C 复制选中内容；Ctrl+Shift+Esc 将焦点移回原生工具栏。 --- # SSH 审批、始终允许和输出外发有什么区别？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：远程连接。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/ssh_approval/ ## 命令执行前 在 **远程连接 → 聊天执行设置** 中选择： - **每次确认**：先查看模型提出的命令，再允许本次执行或拒绝。 - **模型审批**：单独选择审批模型，测试并保存。AI 提出的命令先交给审批模型判断：只读查询（查看文件与日志、磁盘、进程、服务状态等，包括带管道、分号的组合命令）通过后自动执行；写入、删除、改权限、安装、重启服务、提权或意图不清时转为手动确认，审核失败或超时也转手动。可在 **补充审核规则** 里用自然语言追加规则（例如放行某些容器的重启、要求数据库相关命令一律询问），保存后生效。审批模型配置与“默认模型”中的 SSH 命令审核用途共用。 - **始终允许此主机**：在 **远程连接 → 聊天执行设置 → 主机权限 · 始终允许** 中按主机开启，确认后立即生效，不必断开终端；也可从服务器编辑页或 **工具服务 → 授权 → SSH 主机** 设置。首次使用会在当前页面连接服务器并确认指纹，无需先打开终端。开启后，这台主机的聊天命令直接执行，包括修改和删除，不调用审批模型，也不逐条弹窗。关闭后跟随全局设置；更换地址、端口、账号或认证类型，以及清除主机信任后，需重新开启。 主机始终允许优先于全局审批方式，“暂停模型审批”不会关闭主机的始终允许。应用既有的凭证访问阻止、连接核验和执行状态检查仍然有效，但不构成远端权限沙箱；命令的实际权限取决于 SSH 账号。独立终端的手动输入不走这套聊天审批。手动终端和聊天可同时连接同一服务器，聊天命令使用独立连接，不继承终端中的当前目录或临时环境变量；同一服务器的聊天执行仍互斥。 ## 命令执行后 命令输出直接返回当前聊天模型，用于分析和继续执行，无需额外确认。 审批模型只接收执行前的命令与必要上下文，不接收执行结果。长输出可能截断，请结合卡片中的真实状态和退出码判断结果。 ## 会消耗多少 token？ 纯终端不调用模型。聊天每轮命令和返回输出都会进入模型交互，连续命令可能增加轮次和上下文；模型审批还会额外调用审批模型。主机“始终允许”省去的是审批模型这部分消耗，不会免除聊天模型的费用。当前没有专门的多命令摘要或按需读取长输出机制。 --- # 切后台会断开吗？如何通过 Tailscale 连接？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：远程连接。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/ssh_network/ ## 页面返回与切后台 退出终端页面不会主动断开连接，可从服务器列表 **继续终端**。已连接的 SSH 会话和正在执行的 SSH 命令会共用应用的数据传输持续任务，切到后台后显示系统任务通知并继续接收输出；断开最后一个 SSH 会话且没有其他任务时释放。通知仅展示连接状态，不展示命令和输出。 请允许应用通知。系统仍会检查实际传输，长时间空闲、系统暂停任务、进程回收或网络变化可能影响连接，因此通知不是永久保活保证。用户删除任务通知后，本次后台期间不会立即重新申请。 在标题栏菜单中点 **断开**才会关闭本地终端连接。断线不代表远端任务停止；重新连接不会自动重放之前的命令。若提示任务状态待核验，先通过服务器或其他连接检查，再解除占用。 ## 浏览器中的 SSH / SFTP 已连接并完成身份验证的 Web 工作台，可在客户端切到后台后继续使用独立的 SSH／SFTP 会话、终端输入和文件传输，仍需本机 Web 服务与网络可用。停止 Web 服务、关闭会话或访问资格失效后不能继续操作；系统回收应用进程也会中断服务，不保证永久后台在线。 Web 不复用手动原生终端，主机凭据与指纹仍在客户端管理。原生 Cube 随行只收录原生远程入口，不显示 Web 会话和 Web 传输。 ## 通过 Tailscale 连接 1. 手机与目标机器加入同一个 Tailscale 网络，确认设备在线。 2. 目标机器运行普通 SSH 服务，并允许手机访问实际 SSH 端口。 3. 手机开启能覆盖 Cube Agent 的系统 VPN。使用原生鸿蒙客户端时，如有按应用分流，需包含 Cube Agent。 4. 在 Cube Agent 添加目标机器的 Tailscale 地址（通常是 100.x.x.x）、SSH 端口、服务器用户名和密码或私钥，再核验指纹。 每台机器分别添加。本方案使用普通 SSH 经 Tailscale 网络连接，Tailscale 本身不替代目标机器的 SSH 服务或登录凭证。Tailscale 自带的 SSH 功能有另一套认证策略，不应与普通 SSH 配置混淆。 ## 常见连接问题 - **超时**：检查网络、VPN 覆盖范围、Tailscale 访问规则和服务器防火墙。 - **拒绝连接**：检查 SSH 服务是否运行、端口是否正确。 - **认证失败**：填写服务器系统账号的凭证，不是 Tailscale 登录账号。 - **主机身份变化**：向管理员核验新指纹，再更新信任。 手机连接实际机器时，不要沿用模拟器测试网关 10.0.2.2。 --- # Web 服务器 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：Web 与局域网。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/web_server/ ## 它是什么 Web 服务器可以让你在同一局域网内,用电脑或其它设备的浏览器打开本机会话与模型配置,无需额外安装客户端。 ## 怎么开启 打开 **设置 → 连接与高级 → Web 服务器**,打开开关即可启动服务;再次关闭开关会停止服务。服务停止后浏览器将无法访问。 ## 访问地址 启动后会展示两类地址: - **本机地址**:在本设备浏览器打开使用。 - **局域网地址**:与当前设备连接同一 Wi-Fi 的其它设备(电脑、平板等)可直接访问。 ## 端口 端口可自定义,修改后访问地址也会随之变化。请避免与系统中已占用的端口冲突。 ## 仅本机访问 开启 **仅本机访问** 后，只有本机能访问服务，局域网地址不再展示。该模式支持免密码启动和访问；对外开放时仍需按访问模式配置密码与鉴权，不能把本机免密规则用于局域网或公网。 ## 安全提醒 关闭“仅本机访问”、又未启用「访问需要密码」时,服务会给出不安全提示。若需要让局域网或公网稳定使用,建议在页面的「安全保护」分区设置访问密码并开启「访问需要密码」。 ## 给桌面 Agent 使用 Claude Code、Codex 等电脑上的 agent 也可以通过 Web 服务器直接读写记忆和系统提示词，用法见「桌面 Agent 迁移」。 --- # 桌面 Agent 迁移 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：Web 与局域网。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/desktop_agent_migration/ ## 它是什么 如果你习惯在电脑上用 Claude Code、Codex 等桌面 agent，它们积累的记忆和自定义指令(如 CLAUDE.md、AGENTS.md)可以由 agent 自己迁移进 Cube Agent：agent 通过 Web 服务器的接口读取接入说明，再直接写入全局记忆、助手记忆和系统提示词。不需要复制粘贴，也不需要在网页聊天里让它代为输入，Markdown 格式原样保留。 ## 怎么使用 1. 打开 **设置 → 连接与高级 → Web 服务器** 并启动服务。电脑与手机不在同一设备时，关闭「仅本机访问」，并设置访问密码、开启「访问需要密码」。 2. 点访问地址下方的 **复制桌面 Agent 迁移指令**。 3. 把指令粘贴给电脑上的 agent。它会先读取 `/api/agent/guide` 了解规则，需要密码时会向你索取。 4. agent 列出准备写入的内容后，确认无误再让它执行。完成后可在记忆管理页和系统提示词页查看结果。 ## 会写到哪里 - **记忆**：适合长期有效的个人信息和偏好，按「一条一个事实」写入。默认写入全局记忆，也可以指定某个助手；助手需开启记忆(使用全局记忆时还要开启「使用全局记忆」)才会生效。 - **系统提示词**：适合行为规则、回答风格等指令，可写入全局系统提示词或某个助手的提示词，标题、列表和代码块保持原样。 ## 规则与限制 - 记忆只追加并自动去重，重复执行不会产生重复条目；删除的记忆进入回收站，可以恢复。 - 接口不提供整体替换或批量删除。需要合并精简时，请在 App 内用「智能整理」，可先预览再保存。 - 批量写入记忆与 App 内批量导入一样是 Pro 功能；读取记忆、单条修改或删除，以及系统提示词的读写不限。 - 写入系统提示词会覆盖原内容，迁移指令已要求 agent 写入前先向你确认。 - 隐私助手需先在 App 内解锁，否则无法读取或修改它的记忆与提示词。 ## 最佳实践 - 让 agent 把个人事实写进记忆、把工作规则写进系统提示词，不要把长篇规则拆成记忆。 - 不在电脑上用 agent 时，也可以在系统提示词页和记忆导入页点 **从文件导入**，直接读取 .md / .txt 文件。 - 迁移完成后可以修改访问密码，旧令牌会立即失效。 --- # 公网与远程访问 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：Web 与局域网。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/web_remote_access/ ## 它是什么 公网与远程访问让你在不在同一 Wi-Fi 的情况下也能访问本机服务,并为访问过程提供密码保护、连接加密和固定域名等能力。 ## 访问密码 在「安全保护」分区设置访问密码。公网或局域网开放访问时务必设置密码,避免被随意访问。 ## 访问需要密码 「安全保护」分区里的「访问需要密码」开关开启后,在局域网或公网访问时必须输入密码(连接以 JWT 加密)。需要先设置访问密码才能启用。 ## IPv6 公网访问(实验) 在「公网访问」分区,具备 IPv6 公网地址的网络下可启用,让远程设备通过公网访问本机。需要先设置访问密码并开启「访问需要密码」。实际可达性取决于运营商/路由器的入站策略。 ## IPv6 域名访问 基于 IPv6 公网访问,可把变化的公网地址映射为一个固定域名,方便长期访问(Pro 专属)。需要先开启 IPv6 公网访问。 ## 启用顺序 这些选项存在依赖关系,需逐级开启:访问密码 → 访问需要密码 → IPv6 公网访问 → IPv6 域名访问。前置项未开启时,后续项不可启用。 ## 安全建议 只要开放到局域网或公网,请务必先设置访问密码;公网访问建议同时开启「访问需要密码」。 --- # 浏览器聊天端 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：Web 与局域网。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/web_chat/ ## 它是什么 浏览器聊天端是 Web 服务器对外提供的网页版聊天界面,用电脑或其它设备的浏览器即可使用本机会话与配置。 ## 核心能力 - **会话列表**：查看、切换、新建会话；Web 列表隐藏已归档对话，并同步归档状态。归档不等于删除聊天记录。 - **流式回复**:与移动端一致的实时输出体验。 - **附件上传**：可点附件按钮选择、直接粘贴，或把文件拖到页面任意位置松开添加（拖入时输入框高亮提示，文件夹会被忽略）；可解析文档默认解析后将正文随消息发送；视觉模型直接接收图片，非视觉模型按辅助识图/OCR 配置处理。ZIP 保留原包，未知格式只保存原文件；文件工具开关不改变普通附件的投递方式。视频原文件不提供抽帧或声音理解。 - **工具审批**:对模型发起的工具调用进行审批。 - **模板插入**:使用提示词模板快速构造消息。 ## 渲染 移动端使用 CubeMark 渲染对话,Web 端则使用独立的网页渲染方案。两端均支持 Markdown、数学公式、表格、引用、代码块与 Mermaid 图表;AI 输出过程中已完成的内容会保持稳定,方便一边生成一边阅读。 HTML、SVG 和 Mermaid 等内容可以直接打开预览。HTML 默认先展示源码,切换到预览后才加载动态页面。HTML 预览执行 JavaScript 默认开启,以支持依赖脚本的动态内容与交互;此前手动关闭的选择会保留。若页面显示不完整或无法交互,可在「设置 → 通用偏好 → 内容预览」检查「允许 HTML 预览执行 JavaScript」;不可信内容可关闭脚本。 ## 会话级配置 在 Web 端可以为当前会话调整模型与助手、联网搜索模式、推理强度,并按分组启停内置工具与 MCP 服务,设置仅影响当前会话。 ## AskUser 对齐 当助手使用 `ask_user` 向你确认问题时,Web 端支持跳过、自定义答案、单选、多选、下拉选择、滑块取值和文本问答,行为与移动端一致。 ## 连接与端口 Web 端默认复用 keep-alive 长连接,减少重复握手开销。若服务端口被占用,会给出友好提示,便于排查。 ## 与移动端共享数据 Web 端与移动端使用同一套会话与配置,在一端的修改会在另一端体现。 --- # 工作目录 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：Web 与局域网。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/script_workspace/ ## 功能说明 工作目录管理代码解释器运行产生的文件。AI 在本机代码工作台（Python 与 JavaScript）中生成的网页、图片、文档、数据与代码等产物都会保存在这里。AI 将文件写入 outputs/ 后，整条回复结束时会在对应消息显示「生成文件」卡片。每条消息聚合为一张卡片，默认折叠，展开后每页最多显示 3 个文件，可翻页预览、保存或分享。其他工作区目录里的文件可让 AI 使用文件操作的 deliver 交付：保留原文件，复制到 outputs/，并同步显示在卡片和工作目录。交付不覆盖已有的同名文件；后续修改请编辑 outputs/ 内的交付文件。文件操作 write 仅传文件名时默认写入生成文件；显式指定路径则保留原位置。工具会区分“已写入工作区”和“已交付”，不能用 AI 的文字承诺代替真实文件结果。在会话文件中使用“浏览工作目录”进入全部工作区文件，再用“返回会话文件”返回；可直接导出，或在文件菜单选择“添加到生成文件”。手动添加保留原文件，显示在生成文件列表中。 ## 生成 Word、Excel 和 PPT 在当前会话启用 **Office 文档**，可直接要求 AI 生成 Word 报告、Excel 预算表或 PPT 汇报。无需另开技能和代码工作台。生成、保存到本机和系统分享均无需 Pro；新增到跨会话共享文件、发布到公网另按会员规则处理。完整步骤见「如何生成 Word、Excel 和 PPT 文件？」。 ## 两级入口 - **会话级（免费）**:在聊天页菜单打开，查看生成文件和全部工作区文件；已有共享文件可免费查看、导出和删除。 - **全局入口**:在 **设置 → 内容与文件 → 文件空间** 打开。所有用户可清理已有共享文件；跨会话集中浏览产物、新增与整理共享文件需要 Pro。已有公网发布仍可在“我的分享”撤销，不要求续费。 ## 浏览文件夹时批量删除 在工作目录的文件夹浏览中，可长按可删除项目，或从菜单进入选择模式，再勾选文件与文件夹。**全选** 只选当前可删除项目，只读输入文件不会被纳入。删除前核对文件数量与范围，目录会连同其内容处理；包含子项目在内单次最多 500 项，较大范围需分批。 确认后可以取消后续处理，已删除的内容不会自动恢复。若文件内容发生变化、权限变化或部分项目失败，会给出部分完成结果；请按实际结果检查剩余文件，不要把失败提示理解为整批都没有执行。 ## 已发送的输入文件 会话输入文件复用已发送附件的原件，按会话展示；可只读浏览、按格式预览和导出。同名文件通过别名区分，不表示原件已被重命名。输入文件不能像生成产物一样直接编辑或删除；需要修改时先保存副本到工作目录。能浏览原件不代表模型能解析该格式。 ## 导入的文件放在哪里 会话文件根目录有两个文件夹：**输入文件** 是已作为附件发送的原件，只读；**生成与导入的文件** 放 AI 生成的文件，以及你用 **导入文件**（含 ZIP）或输入框的 **添加到会话文件** 手动放进来的文件，可编辑、删除、导出。导入的文件会和 AI 生成的文件放在同一处，同名时自动加序号，不会覆盖；它们不属于「输入文件」，也不是 AI 生成的结果。 ## 文件操作与预览 文件会按类型展示。会话工作目录可导入普通文件或 ZIP；ZIP 会解压到独立目录，适合把完整项目交给 AI 继续修改。点击文件可直接预览：HTML 直接在内置预览中打开（支持同目录的样式、脚本等相对资源，无需为此启动 Web 服务器），常见文档 / 图片使用系统预览，其它格式可选择系统打开方式。更多菜单支持保存、存入共享文件、分享、预览链接、重命名与删除；整个目录也可下载为 zip。存入共享文件时可选择目标目录或新建文件夹；共享文件更多菜单支持“移动到…”，长按多选后可批量移动。同名可选择保留两份或跳过，原文件不会被覆盖。移动后旧路径访问链接失效，文件内相对引用可能需要调整。长按文件行可进入多选模式，批量删除选中的文件或目录（会话产物与共享文件均支持），删除前会再次确认。 ## 文件夹与 ZIP 导入 在 **共享文件** 的上传菜单中选择 **上传文件夹** 或 **从 ZIP 导入文件夹**。支持文件夹选择的设备可直接选目录；手机和不支持直选的设备会引导使用 ZIP。目录导入保留子目录、空目录、隐藏文件和二进制文件，同名根目录自动避让，不合并覆盖已有内容。 共享文件的 **上传文件** 会把 ZIP 当普通文件保存；只有选择 **从 ZIP 导入文件夹** 才展开为目录。会话文件的 ZIP 导入则会解压到独立目录，两者用途不同。 共享单文件与输入 ZIP 上限为 200 MiB；共享目录累计最多 500 MiB、10000 项、64 层。会话文件导入沿用 500 MiB 限制。目录导入先准备完整内容再放入目标位置，失败或取消会清理暂存，不留下半个目标目录。 ## 批量进度与取消 会话文件与共享文件的普通上传不再由应用限定单次 20 个，实际可选数量取决于系统文件选择器，并继续受容量限制；聊天附件与知识库自己的数量限制不变。 选择多个文件后逐项导入，显示当前文件和进度；某一项失败会继续后续项。普通批次取消会在当前项处理完后停止后续导入，已完成文件保留。结果区分成功、失败和未开始，失败项可重新选择重试；离开页面也会停止后续项。 标题栏搜索用于查找当前目录，结合类型筛选决定全选范围；改变搜索或切换目录会清空旧选择。目录导航可以返回上级或指定祖先，刷新收在目录菜单中。 ## 共享文件与本机链接 共享文件单文件存入上限为 200 MB，本机上传、会话产物存入、AI 代办存入与 Web 分块上传保持一致。存入成功不代表所有读取方式都支持同样大小：本机 Web 访问链接目前支持最大 50 MB 的文件，较大文件请在应用内打开；AI 读取、文档解析和预览仍受各自处理能力限制。 共享文件用于本机跨会话复用，存入不等于公网发布。新增、上传、新建文件夹、重命名与移动需 Pro；已有文件的查看、导出、删除免费。AI 代办存入、新建目录和移动需要 Pro 与用户授权，可选择本次允许或始终允许；AI 删除共享文件不需要 Pro，复用同一授权，始终允许后不再额外确认。授权可在设置中撤销。其他普通会话可按需读取共享文件，无需启动 Web 服务，无痕会话不读取。访问链接需要身份验证，且依赖本机 Web 服务和设备在线；可根据网络环境选择域名、IPv6、局域网或本机地址。需要匿名公网访问时，请单独使用“发布到公网”。 ## 发布到公网（Pro） 会话工作目录底部提供 **发布到公网**。点击后进入选择模式，勾选要发布的文件（支持全选），再经底栏 **发布所选** 提交；只有勾选的内容会上传，网页引用的样式、脚本等依赖文件需一并勾选。站点优先以 `index.html` 作为入口；没有入口页时会生成目录索引。站点提交后会经过内容审核，通过后可长期用公网链接访问，不要求你的设备或本机 Web 服务保持在线。 所有发布记录统一在 **设置** 顶部会员账号卡进入 **会员中心 → 账号与服务 → 我的分享 → 站点发布** 管理，可查看审核状态、复制链接或撤回。 ## 引用文件与查看改动 在输入框用 **@** 把这里的文件直接交给 AI，见「怎么让 AI 直接用某个文件或技能？」；AI 改了哪些文件、改了哪几行，见「怎么查看 AI 改了哪些文件？」。 ## 最佳实践 - 只查看当前会话结果时使用会话级工作目录，无需 Pro。 - 临时在同一网络分享时可用预览 / 公共链接；需要对方随时从公网访问时使用站点发布。 - 不要发布含 API Key、个人资料或其它敏感信息的文件；不再需要时及时撤回。 - 脚本产物会占用本机存储，可定期在文件空间或存储管理中清理。 --- # 外观个性化 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/appearance/ ## 可调整内容 「显示与外观」页面最上方常驻 **省电模式**，对所有页签生效；下方分为 **外观 / 界面 / 字体排版 / 流式动效** 四个页签： - 外观:顶部实时预览，显示模式(深色 / 浅色 / 跟随系统)、应用配色(预置配色;自定义配色为 Pro 权益)、首页背景、聊天主题，以及沉浸光感、系统组件档位和按压光色(底部页签、悬浮按钮、标题卡片等按压时的光晕，可选系统默认、跟随主题色或自定义取色)。 - 界面:桌面图标(以当前可用图标为准)、彩色设置图标、模型与服务商图标，会话列表卡片、助手卡片点击行为、消息时间与助手气泡、图库排版、分栏布局(会话列表与助手卡片带实时预览)。 - 字体排版:字体大小、Markdown 排版密度、段落间距和行高，正文与代码字体；在线字体为 Pro 专属功能。可在助手编辑器的「字体」中分别覆盖正文字体与代码字体，未覆盖的项目跟随全局设置；恢复跟随不会改动其他助手。 - 流式动效:流畅度与流式输出动效。 ## 配色与背景 每种颜色只有一个来源：**应用配色** 决定页面底色、卡片、文字和强调色；**背景** 只决定首页画面，可选 **纯净**(配色底色)、**柔光**(强调色晕染)或 **图片**；**聊天主题** 只作用于聊天页；**沉浸光感** 只改变质感，不改变颜色。外观页顶部的实时预览会标出当前配色、背景和聊天主题。 背景在 **外观 → 背景** 直接切换；点 **分页面与图片调整** 可让助手、对话、设置首页分别设置，或选择相册图片并调整模糊、遮罩和取景。图片背景下卡片自动半透明，卡片不透明度精调为 Pro 权益。设置首页默认使用纯净背景。 早期版本的「固定配色」背景已停用，相应页面改为纯净背景，底色跟随应用配色。首次进入外观页会看到一次提示，可一键用原来的底色新建一套自定义配色(Pro)。 ## 系统材质与动效 在 **设置 → 应用设置 → 显示与外观 → 外观 → 材质与光感** 调整沉浸光感与系统组件档位。API 26 的部分菜单、弹层、确认框和控件已接入系统材质与交互效果。实际效果取决于系统版本、设备能力和当前设置；手动选择高效果档位也会根据设备能力适配，不支持时使用兼容样式。关闭材质后使用相应的主题背景。 ## 省电模式 在 **设置 → 应用设置 → 显示与外观** 页面最上方(页签栏之上)选择 **关闭 / 跟随系统 / 开启**。生效时一键精简特效:沉浸光感与各处模糊改为纯色背板,聊天壁纸不再模糊,流式文字直接出现、流畅度按省电节奏刷新,Cube 动画、输入框流光和工具运行扫光都会停下;聊天主题的配色与装饰照常保留,只是不再播放出场动效,适合长对话滑动卡顿或同时运行多个任务时使用。 默认 **跟随系统**:设备开启省电模式时自动生效,关闭后恢复;也可以选择始终 **开启** 或 **关闭**。生效期间页面会提示光感与动效设置已暂停;省电模式不会改动你原来的光感与动效设置,关闭后原样恢复。该选项只保存在本机,不参与云空间同步与备份。系统「减弱动效」开启时,Cube 动画与导航过渡同样会直接切换。 ## 樱花粉主题 在 **设置 → 显示与外观 → 外观** 的应用配色中选择 **樱花粉**，支持浅色与深色，并应用到聊天和 Markdown 配色。 ## 自定义主题配色（Pro） 在 **设置 → 应用设置 → 显示与外观 → 外观** 的应用配色中进入「我的配色」(也可点色卡末尾的「新建」),可创建最多 20 套自定义配色:调整主色、容器、背景、强调 4 个核心色,文字、表面、分隔线、Markdown 等十余项自动派生,浅色深色一键互生,编辑器内实时预览三场景。槽位支持应用、编辑、复制、重命名与删除;Pro 失效后回退默认主题,配置保留。 自定义配色可生成分享码:在「我的配色」导入(粘贴分享码、系统粘贴授权或相册扫码均可),解析预览免费,保存需 Pro。 ## AI 主题设计师 「我的配色」页的 AI 入口进入主题设计师会话——与 AI 服务商管理同构的专用会话,默认使用当前聊天模型,顶栏可随时切换:描述感觉即可获得多套候选,候选卡可保存或「保存并应用」;保存由你点击触发,AI 不能直接改动主题。仿近期热门配色可让 AI 联网找参考再出方案,也可以发送参考图照图配色;点名现有主题(如「基于清爽蓝改一版」)时,AI 会先读取真实色值再设计。支持多轮微调,历史会话可恢复。需要在几个明确选项之间做决定时,AI 会弹出提问卡,点选即可,不必打字。 ## Markdown 排版 Markdown 排版支持紧凑、标准、宽松三种密度,也可以继续微调段落间距和行高。页面内有实时预览,调整时可直接观察正文、列表、引用、行内代码和表格的变化。 ## 聊天字体与聊天主题 正文与代码可分别选择字体,调整后会立即应用到聊天内容。SSH 终端也使用这里配置的代码字体；未配置或字体不可用时使用系统等宽字体。 **聊天主题** 在 **设置 → 显示与外观 → 外观 → 聊天主题** 中选择，作为所有助手的默认聊天外观。主题库共 11 套：简约、沉浸两套基础主题；方豚 · 晴潮（浅蓝奶白的纸面质感）和小鲸娘两套角色主题；以及小猫、樱花、森林、海洋、月光、小熊、莓果七套插画主题。所有主题都可以预览；简约、沉浸、小鲸娘和方豚 · 晴潮全员免费，小猫、樱花、森林、海洋、月光、小熊和莓果需要 Pro 才能应用。Pro 失效后，已选的 Pro 主题在聊天中暂按简约显示，选择和自选背景都会保留，恢复 Pro 后自动还原。主题库里的 Pro 主题带有 **PRO** 标记。每套主题同时决定背景、气泡、按钮外框、工具栏、输入框、引用与表格配色以及边角插画，浅色与深色跟随应用设置，正文字号、行高和气泡内距保持不变。聊天主题与 Cube 形象互相独立，选用方豚形象不会自动切换聊天主题，反之亦然。点按主题卡片进入完整预览，按「设为默认主题」才会生效；直接返回则不改动任何设置。 在预览中点「背景」，可选 **主题默认 / 纯色 / 自定义图片**。主题默认保留主题自带的渐变、纹样与背景插画；纯色提供雾白、奶油、暖砂、浅玫、薰衣草、晴空、鼠尾草和薄荷八种预设，随浅深色自动适配，保留主题气泡和控件样式；自定义图片从相册选取，自动加一层遮罩保证文字清晰。已有图片可「更换图片」或「移除自定义背景」，移除后恢复主题默认背景。背景修改仅在预览中展示，关闭面板后点击应用才会保存，直接返回主题库则放弃修改。聊天主题与沉浸光感独立，标题、输入区与弹层的材质统一跟随「显示与外观」中的沉浸光感设置；关闭光感或设备不支持时使用静态效果，切换主题不会修改光感设置。 助手可以单独选择：在 **助手 → 编辑助手 → 基础 → 聊天主题** 或聊天页 **更多 → 聊天主题** 中打开同一个主题库。默认「跟随全局」，选择其他主题后只影响该助手。 想让助手回复不带气泡，可开启 **显示与外观 → 界面 → 助手回复不显示气泡**，它与主题独立，所有主题都适用。 升级前调整过聊天背景、气泡样式或不透明度的用户，会看到「当前外观（升级前）」，在主动选择新主题前外观保持不变；单独调整过外观的助手显示为「已有自定义」。这些旧设置会完整保留，可随时选回，壁纸随完整备份恢复。 ## 流式输出 流式输出相关设置分布在两个入口;省电模式生效时,下面的流畅度与动效设置暂停,流式文字直接出现: - 在「显示与外观」的 **流式动效** 页签中,可调整 **流式流畅度** 与 **流式输出动效**。流畅度控制 AI 回复回填和自动贴底的刷新节奏;**自动** 为推荐选项,会跟随应用当前刷新率,由系统平衡流畅度和功耗;长回复时想降低发热可选 **省电**;设备性能充足、希望文字和自动滚动更细腻可选 **高刷**,相应功耗可能增加。流式输出动效则控制推理内容和正文新文字的出现方式,所有样式都可在页面内预览并直接应用到实际聊天,无需 Pro。默认的 **光标跟随** 开销接近关闭动效:文字成组直接出现,只在末尾显示闪烁光标;**柔和淡入** 会按屏幕刷新率持续推进文字和渐变,观感更顺滑,但会多占用一些处理资源;**流光拖尾** 在柔和淡入的基础上让新文字先带主题链接色浮现、再慢慢过渡回正文颜色,留下一段彩色拖尾,开销略高于柔和淡入;**关闭动效** 开销最低。 - 在「通用偏好」中,可调整 **流式输出自动跟随** 与 **流式代码高亮**。自动跟随开启后,仅当你停留在消息底部时才会随新内容滚动;向上浏览历史消息会暂停跟随。关闭流式代码高亮后,代码围栏未闭合时先以纯文本显示,待代码完整生成后再高亮,可减少长代码回复期间的渲染开销。嫌回复时消息下方的 Cube 动画占地方，可在 **通用偏好 → 阅读** 关闭 **回复时显示 Cube**。 ## 入口 打开 **设置 → 应用设置 → 显示与外观 → 流式动效** 调整流畅度和动效;打开 **设置 → 应用设置 → 通用偏好** 调整自动跟随和流式代码高亮。 --- # 聊天输入设置 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/input/ ## 可调整内容 - **发送快捷键** 可选 **Enter**、**Shift+Enter** 或 **Ctrl+Enter**。选择 Enter 时，Shift+Enter 换行；选择其他组合时，Enter 换行。Ctrl+Enter 模式下 Shift+Enter 也可换行。软键盘回车仅在 Enter 模式下发送，其他模式下换行。聊天与生图输入框共用此设置。 - **启动后打开**：打开应用后进入 **会话列表**、**新对话** 或 **上次会话**；选新对话时保留助手开场白，从通知、分享等外部跳转进入时仍直接打开对应页面。 - **单独显示 MCP**（通用偏好 → 工具栏排序）：开启后 MCP 在输入区使用独立按钮，可以和其他工具栏按钮一起排序，**工具** 按钮只显示内置工具；关闭后两者合并显示。 - 是否开启 **推荐后续问题**。 - 是否开启 **流式输出自动跟随**。开启后,当前停在底部时会跟随 AI 回复输出;你向上拖动会临时打断跟随。 - **消息导航** 提供简洁和完整两种模式：简洁仅按需显示回底按钮，完整可逐条跳转消息。 - **默认分享助手**：在「输入与交互」中指定系统分享内容交给哪个助手，也可恢复每次询问；分享仍保存为新对话草稿，由你确认发送。 - 是否显示 **会话菜单按钮**。使用屏幕朗读时建议保持开启，便于直接进入会话操作。 - 是否开启 **记住阅读位置**。开启后重新进入会话会回到上次阅读的精确位置(含长消息内偏移),而不是总是跳到最新。 - 是否开启 **助手回复不显示气泡**（显示与外观 → 界面 → 聊天消息）。开启后助手回复去掉气泡底色、边框、尾巴和气泡上的主题角标，正文直接显示在聊天背景上，适合阅读长文；你的消息仍保留气泡，工具卡片、代码块和表格不受影响。适用于所有聊天主题，默认关闭。 - 是否开启 **聊天页面保持常亮**。该开关默认关闭,只在聊天详情页生效。 - 是否开启 **等待确认提醒**。开启后(默认),AI 提问或等待你审批时,应用在后台也会收到系统通知,点击可直达对应会话;关闭后仅在前台提醒。无痕会话不上通知。 - 是否开启 **HTML 预览** / **Mermaid 预览**。HTML 默认先显示源码,切到预览 Tab 后才加载动态页面;也可开启 **HTML 默认打开预览**。Mermaid 继续使用缓存图,分享卡片会强制启用 Mermaid。关闭相应预览后代码块只显示源码。 - 是否允许 **HTML 预览执行 JavaScript**。需先开启 HTML 预览;该开关默认开启,只在预览 HTML 内容时生效,支持依赖脚本的动态内容与交互;此前手动关闭的选择会保留。若预览显示不完整或无法交互,可检查此开关。模型输出或外部内容中的脚本会在开启时运行,不可信内容可关闭脚本。 - 是否开启 **PDF 端侧 OCR 优先** 等文档解析相关选项。 **提示**：HTML 预览执行 JavaScript、PDF 端侧 OCR 优先等选项位于通用偏好的 **内容预览** 分类，可用设置搜索定位。 ## 直接选择和复制回复文字 在 **设置 → 通用偏好 → 阅读 → 直接选取回复文字** 开启（也可搜索“文字选取”）。支持的系统上，长按可选择正文、引用、代码行或表格单元格中的局部文字，也可跨段拖选；代码与表格原有的整块复制按钮保留，复制完整 Markdown 表格请使用 **复制 MD**。 直接选择需要 API 26 及以上并成功加载系统选择能力。低版本、能力不可用或关闭开关时，沿用原来的选择文本页面及代码／表格复制入口。修改开关会同步到当前回复的选择行为。思考过程和译文可以展开收起，始终通过长按进入选择文本页面，避免收起较长内容时卡顿。 ## 完整复制与跨段选择 在选择文本面板切换 **正文 / Markdown 原文**。正文去掉 Markdown 标记，按原顺序包含段落、列表、代码和表格：表格每行一行、单元格以 Tab 分隔，可直接粘贴到笔记，也能粘贴到表格软件里分列（面板里用浅色竖线标出单元格之间的分隔，复制出去仍是 Tab）；块公式保留 LaTeX 源码。HTML 和自定义内容没有文字形式，折叠内容未展开时只保留标题，面板会提示数量。 回复分多步完成、正文之间穿插工具调用或思考时，长按任意一段正文都会打开整条回复的全部正文，按原顺序排列，并定位到你长按的那一段；工具调用和思考不包含在内。回复结束后，这些过程收在顶部的 **用时 N 秒** 一行，点开即可在正文之间原位查看。 面板顶部的 **复制全部** 复制整条回复的全部正文：在正文页是纯文本（含表格），在 Markdown 原文页是完整 Markdown。更多菜单提供 **复制全部（纯文本）**、**复制全部（Markdown）**、**导出纯文本（.txt）** 和 **导出 Markdown（.md）**。粘贴到不支持 Markdown 的笔记、聊天或邮件时用纯文本；需要保留标题、链接地址、公式、折叠内容，或粘贴到支持 Markdown 的编辑器时用 Markdown。 较长文本会分段显示，**全选本段** 只选当前分段；可用 **设为起点 / 设为终点** 跨分段选取，**复制全部** 不受分段限制。内容过长时按提示改用导出。 ## 长 Markdown 按需渲染（实验功能） 在 **设置 → 通用偏好 → 阅读 → 实验功能** 调整 **长 Markdown 按需渲染**，默认开启，重新进入聊天后生效。它减少符合条件的已完成长段落、列表和表格同时创建的界面内容；并不覆盖所有 Markdown 类型，也不缩短保存的原文。出现显示问题可关闭后重新进入对话。 ## CubeMark 预览 聊天中的 Markdown 会由 CubeMark 实时排版。遇到 Mermaid、SVG 或 HTML 代码块时,可直接在消息内查看预览;需要继续编辑或检查内容时,随时切回源码。较长回复在生成过程中会保持阅读位置和已完成内容,减少跳动。 ## 入口 打开 **设置 → 应用设置 → 通用偏好** 进行调整(聊天输入、阅读与预览、握姿、通知、语言等已收拢到此页)。 --- # 如何使用消息导航？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/message_navigation/ ## 选择导航模式 在聊天页 **更多对话操作 → 消息导航**，或 **设置 → 通用偏好 → 阅读 → 消息导航** 中，通过胶囊按钮选择模式，应用于所有对话。 - **简洁**：离开底部超过半屏，或跳转到历史位置后显示回底按钮；回到底部即隐藏。 - **完整**：提供首条、上一条、下一条和最新消息四个操作。 已有设置自动对应：原先开启为完整，关闭为简洁；未设置时仍为完整。 ## 完整模式如何跳转 在聊天页翻动消息约一屏以上并停下后，侧边会显示快捷导航，保留约 1.5 秒，可前往首条、上一条、下一条或最新消息。用户消息和助手回复都按实际气泡逐条切换，回复内部的工具卡片不会单独作为跳转目标。到达边界后再次点击会停留原位。 跳转距离较远时，底部会提示「回到原位置」，约 4 秒内点按即可回到跳转前正在阅读的位置；连续多次跳转都以第一次跳转前的位置为准。 ## 显示、隐藏与移动 可以连续点击进行跳转。滚动过程中导航隐藏，停下后才显示；为了点按附近内容而小幅滑动不会唤醒导航。导航显示时点按消息内容会让它立即隐藏，不会挡住卡片里的按钮。输入、菜单、选择期间，以及模型正在等你回答问题或确认草稿时，导航会暂时隐藏；读屏、按钮焦点等交互期间保持可用。 长按导航条后上下拖动，松手保存高度。开启握姿自适应且设备支持时，可根据握持手调整所在侧边；高度保持，重启后也可恢复。 ## 阅读位置与动画 如需离开后继续阅读，可同时开启 **记住阅读位置**。导航在近距离跳转时平滑滚动，远距离跳转采用淡出定位再淡入；开启系统减少动态效果偏好时，导航直接切换。 --- # 如何切换桌面图标？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/desktop_icon/ ## 入口与步骤 打开 **设置 → 应用设置 → 显示与外观 → 界面 → 桌面图标**，点击 **刷新图标** 查看当前设备可用的选项，再选择喜欢的图标。选择默认图标可恢复应用自带的样式。 ## 为什么暂时没有其他图标 可选目录由应用市场图标服务提供，取决于图标审核、上架和设备适用范围。接入切换能力不代表所有图标已经开放；显示暂无可选图标时，可稍后刷新。查询失败时请重试。 ## 与主题的关系 桌面图标不会随应用深浅色或主题配色自动切换，也不会替换应用内和启动页的 Cube 形象。如果提示系统主题正在使用自定义图标，请先在系统主题中恢复默认图标样式，再尝试切换。 --- # 使用屏幕朗读时，怎样操作更方便？ > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/accessibility/ ## 常用操作 应用已进一步补充新建会话、模型切换、附件入口、消息操作、模型编辑与收藏等控件的名称和状态提示。开启系统屏幕朗读后，可按系统的焦点浏览与激活方式操作。 ## 保留会话菜单按钮 在 **设置 → 应用设置 → 通用偏好** 中，建议保持会话菜单按钮显示开启。这样可直接找到会话的四点菜单按钮，进入相关操作；关闭后仍可通过长按会话打开菜单。 ## 阅读与动态效果 可以在 **显示与外观** 调整字体和 Markdown 排版。消息快捷导航尊重系统减少动态效果偏好，启用后跳转与导航显隐使用直接切换。 ## 反馈具体问题 如果某个按钮没有清楚读出名称、状态不明确或焦点无法到达，请到 **设置 → 反馈与建议** 提单，说明页面、操作步骤、实际播报与预期效果，并附上设备和系统版本。 --- # 智感握姿 > Cube Agent 2.2.0 正式版（构建 2002007）使用说明。 > 分类：个性化。内容基准：2026-11-07。 > 网页：https://cubeagent.app/docs/hand/ ## 功能说明 在支持的设备上，开启「启用握姿自适应」后会识别你的握持手。入口在 **设置 → 应用设置 → 通用偏好 → 输入与交互 → 智感握姿**。 ## 按场景选择 - **新建对话入口**：首页新建对话悬浮入口换边。 - **输入操作区**：发送、附件、模型等按钮整体换边。双手打字时希望发送位置稳定，可以只关闭这一项，发送按钮会固定在右侧。 - **消息导航**：消息导航条和返回底部按钮换边。 - **截图快捷添加**：截图添加卡片换边。 - **随行入口**：打开已有的随行设置，选择跟随握姿、固定左侧或固定右侧。 前四项关闭后恢复右侧固定布局。总开关关闭后暂停所有握姿跟随，但保留各场景选择；重新开启时恢复这些选择。随行入口沿用原有停靠规则，暂停跟随时保持上次位置，固定模式不受总开关影响。 升级后新增场景开关默认开启，延续原有行为。