# Cube Agent 使用文档

> 版本：2.2.0 正式版（2002007）。内容基准：2026-11-07。
> 本站文档与该正式版应用内帮助同源。

## 快速上手

- [免费模型试用有多少次，怎么用？](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 能力

- [哪些事可以让 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 与局域网

- [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)：识别握持手,优化单手操作