1. 开始使用
VuuNote 是以本地工作区为中心的笔记与资料编辑宿主。左侧显示工作区文件树，中间编辑当前文件，顶部标签页管理已打开文件，右侧可打开共享 VuMos Agent。
2. 工作区与左侧栏
顶部工作区标题旁的“…”是文件操作入口。左侧活动栏用于切换不同功能面板。
| 入口 | 用途 |
|---|---|
| 文件 | 查看工作区文件树，选择文件并在编辑器中打开。 |
| 搜索 | 在工作区内查找文件或内容。 |
| 通知 | 查看保存、导入、导出和运行相关提示。 |
| 扩展 | 进入扩展能力入口；具体能力取决于当前安装内容。 |
| Agent | 显示或收起右侧共享 Agent 面板。 |
| 设置 | 打开 Host Settings 或 Agent Settings。 |
2.1 新建、导入和打开
- 点击工作区标题右侧的“…”。
- 选择新建笔记、导入文件或打开文件。
- 新文件会出现在工作区文件树，并在编辑器标签页中打开。
- 在文件树中点击文件可切换；标签页上的 × 可关闭当前标签。
3. 编辑器
中间编辑器用于编写当前笔记或打开的文本资料。编辑器设置可控制自动保存、行号、小地图、字号和行高。
3.1 常用操作
- 通过标签页切换多个已打开文件。
- 修改内容后按设置中的自动保存规则保存；关闭前建议确认已保存。
- 需要交付或分享时，使用文件菜单中的导出操作选择目标格式和位置。
- 可把已有资料导入工作区，再在 VuuNote 中整理成笔记。
工作区文件树 ──> 打开文件 ──> 编辑 ──> 保存 ──> 导出
4. 搜索、资料读取与导出
搜索面板用于定位工作区中的文件和内容。对资料进行整理时，先确认文件已位于当前工作区，再通过搜索或文件树打开它。
| 任务 | 建议操作 |
|---|---|
| 查找笔记 | 打开搜索入口，输入关键词，再从结果选择文件。 |
| 读取 PDF / Word / Excel | 将文件放入工作区后打开或交给具备相应读取能力的 Agent 流程。 |
| 整理资料 | 让 Agent 先读取工作区和目标文件，再要求生成或更新指定笔记。 |
| 交付文件 | 使用导出功能，并检查导出路径和生成文件。 |
5. 共享 Agent
右侧 Agent 面板使用 VuuMake 共享的 Pro / Ultra Agent 和共享模型、会话、Skills 与记忆能力。VuuNote 只是提供当前工作区、文件和编辑操作的宿主能力，不另建一套 Agent 运行时。
5.1 可以这样提问
- “读取当前工作区，帮我整理一份项目说明，写入 docs/project.md。”
- “搜索包含‘发布流程’的笔记，汇总到当前文件。”
- “把这份 Markdown 改成适合交付的结构，并先告诉我将修改哪些文件。”
- “导出当前笔记为指定格式，并返回实际生成路径。”
5.2 宿主软件使用问题
当用户询问“VuuNote 怎么操作”或其他宿主软件的界面、菜单、设置和操作流程时，Agent 必须优先参考该宿主根目录的 User_Guide.html，再结合当前实时宿主上下文回答。指南不存在或无法读取时，应明确说明，并只给出已经验证的操作。
6. 设置
点击齿轮后可分别进入两类设置：
| 设置页 | 内容 |
|---|---|
| Host Settings | 宿主外观、主题、壁纸、透明度等共享宿主显示偏好。 |
| Agent Settings | 共享 Agent 的模型、模式、语言、会话和相关 Agent 偏好。 |
6.1 VuuNote 设置分类
VuuNote 自身设置包含外观、模型路由、云端增强、硬件、壁纸、编辑器和系统。模型路由可查看本地模型；云端增强需要配置供应商、模型、API 节点和密钥；硬件页显示 CPU、CUDA、Vulkan 等运行选项。
编辑器分类可调整自动保存、行号、小地图、字号和行高；系统分类可设置语言、开机启动、最小化到托盘和检查更新。
7. 常见问题
为什么找不到文件？
确认当前工作区路径正确，并在文件树刷新或使用搜索入口查找。最近打开的文件不等于当前工作区中的全部文件。
为什么 Agent 没有修改文件？
请明确目标文件、修改内容和输出路径；涉及写入的请求必须使用 VuuNote 声明的宿主工具，并可能需要确认。
为什么看不到 Agent？
点击左侧活动栏底部的聊天图标显示右侧面板；如果共享运行时不可用，请先确认 VuuMake 基础安装和共享 Agent 服务正常。
如何获得准确的操作帮助？
直接描述当前页面、目标和遇到的提示。共享 Agent 会优先参考宿主根目录的 User_Guide.html，并结合当前工作区上下文回答。