VuuCode 用户指南
V1.77 · VuuMake 共享 Agent · Windows
V1.77 · VuuMake Shared Agent · Windows
开始使用
Getting started
VuuCode 是 VuuMake 中的代码工作台。打开项目后，在左侧浏览文件，在中央编辑代码，并使用右侧或底部的 Agent 面板获得协作帮助。
VuuCode is the code workspace inside VuuMake. Open a project, browse files on the left, edit in the center, and collaborate through the Agent panel.
- 从欢迎页或文件菜单打开本地文件夹。
- 在文件树中选择文件；修改会显示未保存状态。
- 使用保存操作写入当前文件，再运行、预览或让 Agent 继续处理。
- Open a local folder from the welcome page or File menu.
- Select a file in the tree; unsaved changes are indicated in the editor.
- Save before running, previewing, or asking the Agent to continue work.
工作区与编辑器
Workspace and editor
工作区根目录决定文件工具可读取和写入的范围。Agent 会使用当前工作区、打开文件和宿主上下文来理解任务；请在请求中明确目标文件、预期结果与是否允许修改。
The workspace root defines the files that tools may read and write. The Agent uses the current workspace, open files, and host context; state the target files, expected outcome, and whether changes are allowed.
| 区域 | Area | 用途 | Purpose |
|---|---|---|---|
| 文件侧栏 | File sidebar | 浏览、打开与管理项目文件。 | Browse, open, and manage project files. |
| 编辑器 | Editor | 编写代码、查看修改与保存。 | Write code, review changes, and save. |
| Agent 面板 | Agent panel | 选择模式和等级，提出协作请求。 | Choose a mode and tier, then request assistance. |
共享 Agent
Shared Agent
VuuCode 使用 VuuMake 共享 Agent、模型和运行时。Agent 的设置、资源和会话能力可被其它子 App 共享。
VuuCode uses VuuMake's shared Agent, models, and runtimes. Its settings, resources, and session capabilities can be shared by other sub-apps.
模式与等级
Modes and tiers
Ask解答与说明；Explore先检查再建议；Plan输出实施计划；Agent按授权执行。免费账户默认最高使用 High 等级。
Askanswers and explanations; Exploreinspect before advising; Planproduce an implementation plan; Agentacts within granted authority. Free accounts default to the High tier.
获取更准确的结果
Getting accurate results
- 说明要解决的问题、相关文件和验收标准。
- 让 Agent 修改前，可先使用 Explore 或 Plan 审阅影响范围。
- 询问 VuuCode 操作时，Agent 会优先参考本指南。
- State the problem, relevant files, and acceptance criteria.
- Use Explore or Plan first when you want an impact review before changes.
- For VuuCode operation questions, the Agent first refers to this guide.
模型与运行时下载
Model and runtime downloads
在 Agent Settings → Models 的 Shared 区域选择“更新及资源下载”。这里管理共享的模型与运行时资源；VuuMake 发布包仅内置 CPU 和 Vulkan DLL，CUDA 与 RT Package 需要单独下载。
Open Agent Settings → Models and use the Shared “Updates & resource downloads” section. It manages shared models and runtimes. The VuuMake package includes CPU and Vulkan DLLs only; CUDA and RT packages are separate downloads.
- 浏览模型：打开 VuNiti 模型发布页。
- 下载运行时：打开 VuNiti Releases。
- 打开共享模型文件夹：查看本机已安装的共享资源。
- Browse models: opens the VuNiti model page.
- Download runtimes: opens VuNiti Releases.
- Open shared model folder: shows installed shared resources.
设置与外观
Settings and appearance
默认采用深色主题，并优先跟随系统语言；无法识别的系统语言会回退为英文。可在设置中选择语言、主题和背景图片。共享 Agent 设置中的语言会同步更新宿主界面。
The default is the dark theme and the system language is preferred; unsupported system languages fall back to English. Choose language, theme, and wallpaper in Settings. Language changes in Shared Agent Settings update the host UI as well.
版本信息会显示宿主版本（例如 VuuCode V1.77）和共享 Agent 版本（Agent V1.77），便于发现宿主与共享资源的版本差异。
Version information shows the host version (for example, VuuCode V1.77) and shared Agent version (Agent V1.77) to help identify a host/resource version mismatch.
常用操作
Common operations
| 目的 | Goal | 建议操作 | Suggested action |
|---|---|---|---|
| 解释一段代码 | Explain code | 选择代码后使用 Ask，附上你想理解的部分。 | Select code, use Ask, and state what you want explained. |
| 修复问题 | Fix an issue | 说明复现步骤、报错和验收方式；先 Explore 也可以。 | Provide reproduction, errors, and acceptance criteria; Explore first if desired. |
| 获取资源 | Get resources | 打开 Agent Settings 的 Models / Shared 下载区。 | Open the Models / Shared downloads section in Agent Settings. |
常见问题
FAQ
为什么显示的 Agent 等级不是我的订阅？
Why does the displayed Agent tier not match my subscription?
先确认账户已登录并刷新账户状态。等级由当前账户权益与选择的 Agent 轨道共同决定。
Confirm that the account is signed in and refresh its state. The displayed tier is determined by account entitlement and the selected Agent track.
为什么 Agent 没有执行我说的操作？
Why did the Agent not perform an action?
Ask、Explore 和 Plan 以回答、检查或规划为主；需要修改文件或执行操作时，选择 Agent 并明确授权范围。
Ask, Explore, and Plan focus on answering, inspection, or planning. Select Agent and state the allowed scope when you need file changes or actions.
模型或运行时缺失怎么办？
What if a model or runtime is missing?
通过 Shared 下载区获取对应资源，然后重新打开相关 Agent 会话。CPU 与 Vulkan 随 VuuMake 发布；CUDA 与 RT 单独安装。
Use the Shared downloads section, then reopen the relevant Agent session. CPU and Vulkan ship with VuuMake; CUDA and RT install separately.