OrvixCode 学院

OrvixCode 是一款 Windows 桌面开发环境，把 AI 聊天与真实项目、文件、编辑器工作流和内置终端连接起来。

您可以打开或创建项目，使用 AI 分析和编辑代码，执行多文件项目任务，并在受支持的本地或在线模型之间选择。

核心能力

• 针对长代码和大型项目任务的规划与自动续写。
• 多文件项目生成以及基于依赖关系的文件清单验证。
• 语法高亮代码编辑器、问题面板、AI 修复与行内 AI 编辑。
• 内置终端以及 AI 辅助分析终端错误。
• 使用同一 Python 解释器自动安装缺失包并重试。
• 解释、编辑和修复选中代码。
• 可自定义键盘快捷键、停止回复以及流式 Markdown 格式化。
• Ollama 本地模型、在线提供商、Combo Mode 与 Visual Studio Code 集成。

请从官方产品页下载 OrvixCode：

https://orvixcode.orvixgames.com/download.php?lang=zh-cn

1. 下载安装程序 打开 OrvixCode 产品页并下载当前 Windows 安装包。
2. 运行 Setup 如果 Windows 弹出安全提示，请确认文件来源后再继续。
3. 选择安装目录 可以使用默认目录，也可以选择其他受支持的位置。
4. 选择 VS Code 集成 如果安装程序提供安装/更新 Visual Studio Code 扩展的选项，可以保持启用。
5. 完成安装 从桌面快捷方式或开始菜单启动 OrvixCode。

首次启动时，OrvixCode 可能会显示初始化和基础偏好设置。你可以选择应用语言、工作目录以及基本使用选项。

初始化完成后会进入主工作区。你可以在这里添加项目、创建新对话、配置 AI 提供商或准备本地模型。

左侧面板

左侧面板用于快速访问项目、对话、工具和应用主要区域，并可按需折叠。

顶部标签页

标签页可同时保持多个对话或工作区打开。关闭标签页并不等于删除对话历史。

AI 聊天区域

可在这里管理提示词、当前模型和项目上下文。AI 回复中可显示操作摘要、受影响文件以及编辑状态。

OrvixCode 项目基于本地文件夹。选择文件夹作为工作区后，AI 可以使用与任务相关的项目上下文。

新建或现有项目

• 通过新建项目创建工作区。
• 可以直接连接现有源码文件夹。
• 可从消息框下方的项目选择器使用 + 新建项目。

AI 任务自动创建项目

当您要求 OrvixCode 生成项目而没有选择真实项目时，它可以创建项目文件夹并加入 Projects。名称重复时会生成 Project 2、Project 3 等唯一名称。

大型项目文件规划

大型任务会按子系统和文件拆分，而不是压缩成少数超大文件。生成过程中会检查 import、依赖和接口关系；发现缺失本地模块时可以扩展 manifest。

AI 聊天可用于询问项目、分析错误、生成代码、编辑文件或获取架构建议。

附件与选中代码上下文

使用输入框中的 + 菜单添加文件。TXT/代码附件会明确作为可用上下文提供给 AI；选中代码的解释请求也不会被误判为项目生成任务。

停止回复

AI 回复期间，发送按钮会变为 ■ 停止。停止操作会取消续写和大型项目生成步骤，并阻止迟到的输出继续追加。

流式显示

Markdown 与代码块会在回复流式生成时实时格式化，而不是等回复完成后才处理。长用户消息会保留换行和代码块结构。

提示词示例

检查此项目的登录系统。
找出会话刷新期间可能发生的错误。
如有需要，请编辑相关文件并说明你的修改。

在 Ask 模式中编辑

Ask 不仅用于解释。如果提示词明确要求修改代码，OrvixCode 可以准备可应用的编辑包。

AI 修改不必只停留在聊天文本中。OrvixCode 可以把结果转换为可应用到项目文件的修改。

创建新文件

在 Agent 等多文件模式下，AI 可以根据任务需要创建新文件。

代码编辑器保留原有编辑区域，并加入语法高亮以及错误/警告层。

语法与问题

• 常见语言的语法高亮。
• 解析/语法错误可显示为红色；警告和部分缺失模块情况显示为黄色。
• 有问题的代码范围可直接在编辑器中用下划线标记。

AI 编辑

• ★ 使用 AI 修复：从问题面板修复当前文件，但不会自动保存。
• 使用 AI 编辑…：只发送选中的文本范围和您的指令，并把返回结果替换回同一范围。
• 让 OrvixCode 解释选中代码：把选中内容作为解释上下文发送。

行内 AI 编辑期间，选中区域可暂时模糊并显示 ★ AI 正在编辑…。AI 编辑也会加入 Ctrl+Z / Ctrl+Y 历史。

运行 Python 文件时，如果存在项目 .venv 或 venv，OrvixCode 会优先使用其中的 Python 解释器。

自动安装缺失包

如果出现 ModuleNotFoundError 且缺失名称不是本地项目模块，OrvixCode 可以用同一解释器尝试 pip 安装，然后重新运行文件。

部分 import 名会映射到包名，例如 cv2 → opencv-python、PIL → Pillow、yaml → PyYAML、sklearn → scikit-learn。

使用 AI 修复

运行失败时，★ 使用 AI 修复可以把错误、当前文件和相关上下文发送给 AI。

内置终端可像普通命令终端一样使用。

• cd 修改的工作目录会在终端会话中保持。
• clear / cls 可清空输出。
• 会话中保存命令历史，可用上/下方向键查看之前的命令。

使用 AI 修复终端错误

命令失败时，★ 使用 AI 修复可以把最后一条命令、错误输出以及相关时的当前文件发送给 AI。

OrvixCode 会在编辑流程中跟踪文件修改状态。

• Diff / 预览：在应用前或应用后比较改动。
• 应用：把准备好的编辑包写入文件。
• 已应用：已经写入的修改会保持状态，而不会被错误地识别为不存在。
• 撤销：回退最近一次 AI 修改。

OrvixCode 提供 Visual Studio Code 扩展。扩展会在 Activity Bar 中打开 OrvixCode 面板，把云端和本地 AI 能力带入编辑器。

VS Code 中的主要功能

• OrvixCode AI 聊天面板，以及 Ask、Edit、Agent 模式。
• 选择云端模型和本地 Ollama 模型。
• 当前文件和已选代码上下文。
• 对选中代码使用右键命令。
• 经用户确认后应用 AI 文件修改，并支持 Diff / 预览 / 撤销。
• 模型选择、连接状态和错误信息。
• 把 VS Code 对话同步到桌面版 OrvixCode 历史记录。

快速 AI 操作

扩展的快速 AI 操作不再局限于解释和基础修复：

• 解释代码
• 修复错误
• 重构
• 检查项目
• 生成测试
• 代码审查
• 生成文档
• 性能改进建议

可直接从 Visual Studio Code 的“扩展”页面安装 OrvixCode。普通用户不需要手动安装 VSIX。

1. 打开 Visual Studio Code 点击 Activity Bar 的扩展图标，或按 Ctrl+Shift+X。
2. 搜索 OrvixCode 在 Marketplace 搜索框输入 OrvixCode。
3. 安装扩展 选择发布者为 Orvix Games AI Studio 的 OrvixCode 扩展并点击 Install。
4. 打开 OrvixCode 面板 安装完成后点击 Activity Bar 中的 OrvixCode 图标。
5. 连接桌面应用 使用 AI 功能前，请确认电脑上已安装 OrvixCode 桌面应用。

在编辑器中选中一段代码并右键，即可使用 OrvixCode 命令。

命令运行时 OrvixCode 面板会打开并开始请求，处理过程中应显示状态指示。

Agent 模式用于不局限于单个文件的任务，AI 可以把当前 workspace 中的多个文件纳入处理范围。

适合 Agent 的任务

• 添加新功能。
• 修复跨多个文件的错误。
• 创建新模块或文件。
• 重构文件结构。
• HTML + CSS + JavaScript 等多文件任务。

在 VS Code 中产生的聊天和编辑事件可以同步到桌面版 OrvixCode 历史记录。

同步记录通常会以 VS Code · ... 这样的名称出现；已经应用或撤销的编辑也可能记录在对应的对话历史中。

Viona 可作为 OrvixCode 中的默认或主要模型。可用的模型名称和选项可能随版本或配置变化。

VS Code 面板可显示当前模型及连接状态，例如 已连接 · viona-ti-3.0。

OrvixCode 可通过 Ollama 在本机直接运行受支持的模型。本地模型不需要单独的 AI API 密钥；聊天请求会发送到本地 Ollama 服务。已下载模型会出现在普通模型选择器的 本地 / Ollama 分组中，也可设为默认模型。

本地模型不仅能用于普通聊天，在合适情况下也可用于 Ask / Edit / Agent 流程，以及 Combo 模式中的规划、代码生成或错误检查角色。

推荐本地模型目录

本地模型中心位于 设置 → 本地模型。OrvixCode 会在这里统一管理 Ollama 运行时、硬件检查、剩余磁盘空间和已安装模型。

1. 打开“本地模型” 在设置中的“本地模型”页面检查 Ollama 运行状态。
2. 准备 Ollama 如果未安装 Ollama，OrvixCode 可在受支持的 Windows 环境中启动安装流程；完成后会验证本地服务。
3. 检查硬件兼容性 模型卡片会评估 RAM 和剩余磁盘。资源不足时可能阻止下载，接近下限时会显示性能警告。
4. 下载模型 从目录中选择模型。下载过程中支持暂停、继续和取消。
5. 选择模型 安装完成后，模型会出现在主模型选择器的 本地 / Ollama 下。

本地模型工具

• 启动服务：当 Ollama 未运行时尝试启动它。
• 重新尝试 GPU：在安全 CPU 回退后重新启用 GPU 尝试。
• 打开日志：打开 Ollama 运行日志进行故障排查。
• 模型文件夹：打开本地模型存储位置。
• 兼容性检查：评估 RAM、磁盘和模型要求。

除 Viona 外，OrvixCode 还可在同一提供商中心管理15 个外部 AI 服务。实际模型列表会根据账户/API 权限动态生成，每个提供商最多可显示 5 个适合聊天的模型。

Combo 模式不会把整个任务交给一个模型，而是拆成三个专业阶段：思考/规划、代码生成和错误检查。每个角色都可以使用不同的云端模型或兼容的本地 Ollama 模型。

思考 / 规划：  Viona 或强推理模型
代码生成：      Qwen Coder / Claude / 其他代码模型
错误检查：      Gemini / 本地模型 / 其他审查模型

增强的 Combo 工作流

• 自动角色分配：启用 Combo Auto 后，可以为不同角色自动选择合适模型。
• 本地模型支持：已经下载的 Ollama 模型可用于 Combo 角色。
• 阶段可见：规划、编码和检查阶段可在聊天界面中跟踪。
• Fallback：规划或编码阶段失败时，可通过其他合适阶段/模型恢复流程。
• 检查容错：即使审查模型失败，已经生成的最终答案也不会丢失。
• 回复持久化：防止 Combo 回复因界面动画或状态更新而消失。

把完整文件树、所有文件内容和很长的对话历史一次性发送给模型效率很低。OrvixCode 会根据任务缩小上下文，并优先保留真正相关的信息。

上下文可优先使用选中代码、光标附近代码、当前文件的相关部分、用户明确点名的文件、与任务相关的项目文件，以及必要的对话历史。

如果 Viona 或其他服务达到请求大小限制，OrvixCode 可以用更小的上下文重试。本地模型则会根据可用内存自动平衡 context。

即使提示词很短，只要明确要求大量输出，OrvixCode 也会单独识别。长代码支持不限于 Python，也覆盖 HTML/CSS/JavaScript/TypeScript、Go、Rust、PHP、Ruby、Java/Kotlin、C/C++/C#、Swift、Dart、Lua、Scala、Elixir、F#、Solidity、Bash、PowerShell、SQL 等。

长输出与续写

• 本地模型可在合适情况下使用更高输出预算。
• 如果受 token/context 限制而截断，可从缺失位置继续请求。
• 合并续写片段时会清理重复重叠。
• 未闭合 fenced code block 的内容仍可保留为代码。

大型项目规划

1. 分析请求并规划项目结构。
2. 创建 manifest / 文件计划。
3. 逐文件生成并跟踪依赖与接口。
4. 如果 import 暴露缺失本地模块，可扩展计划。
5. 达到输出限制时继续生成。
6. 最后执行基础一致性检查。

可在创建项目流程中使用 GitHub 导入功能，把仓库下载到本地 OrvixCode 工作区。

导入完成后，仓库会像普通本地项目文件夹一样使用，并可在相关任务中加入 AI 上下文。

OrvixCode 可在文件修改过程中保留备份数据，以降低数据丢失风险。根据编辑类型，旧内容可以保留用于恢复。

VS Code 端还提供撤销最近一次 AI 修改的流程。

对话与已打开的标签页是独立的。关闭对话标签并不会自动删除历史记录。

• 可从左侧面板重新打开旧对话。
• 可通过右键菜单或设置删除对话。
• 可以同时保持多个对话标签页打开。
• 从 VS Code 同步的对话可在历史记录中以独立标题显示。

OrvixCode 的设置主要包括：

• 通用：默认模型、创意度/temperature、打字动画、声音、左侧面板和应用语言。
• 自定义：主题、字体和文字颜色。
• AI 提供商：Viona 与外部提供商、模型刷新和 Combo 设置。
• 本地模型：Ollama 服务、硬件兼容性、模型下载/管理和日志。
• 存储与备份：数据目录和自动文件备份。
• 对话管理：查看和批量删除对话。
• 安装 / VS Code：桌面端与 Visual Studio Code 集成选项。
• 故障排查：本地系统和连接检查。
• 键盘快捷键：可重新分配发送、新建聊天/项目、保存、撤销/重做、运行、终端、停止 AI 回复、Combo 与主要导航等操作。

在设置 → 键盘快捷键中可以重新分配主要应用操作。选择一个操作后会打开按键捕获窗口以记录新的组合。

可配置操作示例

• 发送消息 / 新行
• 聚焦消息输入框
• 新建聊天与新建项目
• 添加文件与保存
• Ctrl+Z 撤销 / Ctrl+Y 重做
• 运行代码与打开终端
• 停止 AI 回复
• 切换 Combo Mode
• 文档、反馈与主要页面导航
• 最小化、最大化、关闭或发送到后台/托盘

可从 设置 → 自定义 修改 OrvixCode 外观。

OrvixCode 的目标是让 AI 驱动的文件修改保持可见。被修改的文件以及修改结果可显示在对话或变更报告中。

关闭自动应用后，编辑包可先等待用户确认，再写入文件。

外部 AI 提供商需要对应服务提供的 API 密钥或账户访问权限。

VS Code 扩展会通过 OrvixCode 的连接系统复用现有提供商配置，而不是要求用户把每个密钥分别复制到扩展中。

多文件任务可能影响项目中更大的范围。根据 OrvixCode 版本和设置，可以针对单个文件或整个修改方案提供确认流程。

AI 没有响应

1. 确认当前模型已选中并且可用。
2. 使用云端模型时，检查提供商 API 密钥或会话权限。
3. 使用本地模型时，在“设置 → 本地模型”中确认 Ollama 服务正在运行。
4. 在 VS Code 中运行测试连接。
5. 查看扩展面板或 OrvixCode 故障排查工具中的错误详情。

文件修改没有应用

1. 检查编辑包状态。
2. 如果 Auto Apply 已启用，修改可能已经应用。
3. 确认文件具有写入权限。
4. 在 VS Code 中检查 Workspace Trust。
5. 通过 Diff / 预览检查 AI 建议，然后重新应用。

当当前文件、项目上下文和对话历史合并后过大时，可能出现这个错误。

当前 OrvixCode 上下文系统可以自动缩小大型上下文，并在 Viona 返回 413 后使用更小级别重试。

扩展搜索不到

刷新扩展页面，检查网络连接，然后再次搜索 OrvixCode。新版本发布后，Marketplace 索引可能需要一点时间。

扩展提示“workspace is not trusted”

项目可能处于 Restricted Mode。通过 Workspace Trust 信任该项目后，文件编辑功能才会启用。

面板能打开，但 AI 没有响应

先运行“测试连接”。云端模型请检查网络和提供商访问；本地模型请检查桌面版 OrvixCode 连接以及 Ollama 服务状态。

输入“你好”后却显示了项目/system prompt

当前扩展会把简单聊天与项目上下文隔离。当前文件、workspace 和内部 orvix-edit 指令不会附加到无关的问候消息。如果更新后仍出现旧行为，请完全重启 VS Code，或运行 Developer: Reload Window。

代码修改没有应用

确认项目已被信任、文件不是只读，并且 OrvixCode 有编辑权限。如果 Auto Apply 已开启，修改也可能已经应用。

右键命令打开面板但没有开始执行

确认已经选中代码后再试。如果问题仍存在，在 OrvixCode 面板中新建对话并直接发送相同请求，然后运行“测试连接”。

Ollama 没有运行

打开“设置 → 本地模型”检查运行时状态，并使用启动服务。如果仍失败，请打开日志并确认模型确实已经安装。

“failed to allocate buffer / kv cache”

这通常表示模型或 context 对当前 RAM/VRAM 来说过大。OrvixCode 可以自动降低 context 后重试，并按模型记住可工作的安全值。

8192 → 6144 → 4096 → 3072 → 2048

如果模型本身无法装入内存，就需要选择更小模型。关闭其他占用大量内存的程序也可能有帮助。

CUDA / GPU 错误

检测到 GPU、CUDA 或本地 runner 故障时，OrvixCode 可使用安全 CPU 模式重试。之后可在“本地模型”中使用重新尝试 GPU恢复 GPU 尝试。

本地模型非常慢

• 尝试更小的模型。
• 查看模型卡片上的 RAM/VRAM 建议。
• 关闭其他占用大量内存的应用。
• 如果有兼容 GPU，确认 GPU 重试已启用。

OrvixCode Learn 通过可直接阅读和实践的分步课程补充参考文档，无需视频。

官方状态页显示网站、文档、下载与 AI 服务状态。管理员发布的公告会立即出现在公开页面和机器可读订阅中。

站点下载按钮使用中央发布设置。管理员发布新稳定版本后，版本号与下载目标会在整个平台同步更新。

https://orvixcode.orvixgames.com/download.php?lang=zh-cn

下载最新版本 →