CodeNova
在 VS Code 里解释、生成和改进代码的轻量 AI 助手
Light up your code. · 点亮你的代码。
CodeNova 是什么
CodeNova 是一个运行在 VS Code 内的轻量 AI 编程助手插件（BYOK）。主入口是活动栏里的对话面板：提问、解释代码，或切到智能体模式让它读写文件、执行命令。
模型通道内置 小米 MiMo、Kimi、DeepSeek、MiniMax、跃迁AI（StepFun） 五家云端供应商预设（端点与上下文参数都已配好），你在模型管理里选供应商、填 API Key、一键拉取模型列表即可接入；本地推理服务 LM Studio 也已内置为预设，localhost 地址自动免密钥直连。此外支持任意 OpenAI 兼容端点与本地服务（Ollama 等，模型管理里选「自定义（OpenAI 兼容 · Chat Completions）」手填）。密钥存入系统凭据库，不写进配置文件。
如果 CodeNova 用起来还不错，欢迎点亮一颗 ⭐。
功能
| 能力 |
说明 |
| 侧边栏对话 |
活动栏 CodeNova 面板内流式问答，思考过程与工具调用记录可见，可随时「停止生成」（也支持 Esc） |
| 发送与队列 |
输入框右侧单按钮：空闲发送、生成中带内容加入队列、空输入变停止；停止当前后队列自动接上下一条，Esc 随时停 |
| 智能体模式 |
10 个工具：读文件、列目录、搜文本、符号检索、写文件、批量替换、删文件（移入回收站）、执行命令、读后台输出、停止后台进程。智能问答模式只分配只读工具，物理上无法改动工程；读取记录可点击跳转并选中 AI 查看的行区间，目录结果可展开后逐文件跳转 |
| 改动即写即用 |
AI 写/改/删直接落盘，文件立即可见；多文件生成时逐文件出 diff，不必等全部写完；落盘前原文备份到磁盘备份区，文本按行、二进制（证书/图片）按原始字节备份，可逐文件或整批接受定稿或回滚，点文件名用 VS Code 原生 diff 查看；关窗口或崩溃后重启仍可回滚 |
| 失败可感知 |
命令非零退出、超时、取消一律按失败上报，界面显示 ✕ 而不是绿色对勾；输出过长会标注已截断；连续失败自动熔断，不再围着同一个错误空转 |
| 危险命令拦截 |
执行层命令白名单：不在开发命令列表里的可执行文件直接拒绝；rm -rf/format/git reset --hard/git push -f/fork 炸弹、shell 解释器等危险特征先标红，不可逆命令需手动勾选确认；普通命令可勾选「本窗口内不再询问」，危险命令永远逐次确认；命令链按 &&/||/|/;/单个 & 逐段校验，超时按整棵进程树回收，不留孤儿 |
| 长任务与后台 |
dotnet run、dev server、watch 这类常驻进程用后台模式启动，立即返回任务 id；AI 可读增量日志、按进程树停止，扩展停用或重载时统一回收，不留占端口孤儿 |
| 解释代码 |
选中代码后右键「CodeNova: 解释代码」或执行命令面板命令，结果进入对话面板，标题标明解释的具体行范围 |
| 多模态图片 |
支持视觉的模型可拖拽或粘贴图片发送，发送前自动压缩；能力由端点声明 + 保存时 1×1 实测 + 实际请求反馈自动判定，未知不再一刀切拦截；发出的图片显示在对话气泡里，重开不丢 |
| 文件作为上下文 |
文本/代码文件作为附件读取内容并入提问（所有模型可用），气泡以卡片展示，排队/编辑重发不丢 |
| 长文本粘贴 |
终端日志、报错堆栈等超长粘贴折成「长文本」卡片：可展开预览原文、一键还原回输入框、单独删除；多段粘贴各自成卡，短文本直接插到光标处；从资源管理器复制的文件按文本附件读取 |
| 上下文引用 @ |
输入 @ 实时搜工作区文件/目录，选中即并入上下文（目录附文件清单），当前/最近文件优先推荐 |
| 本地代码索引 |
启动后在本地扫描符号（函数、类、接口、方法），零 API 成本、可离线；AI 按名字找定义与文件，遵守 .gitignore、跳过二进制，索引存插件缓存不污染仓库，保存/删除后增量更新 |
| 代码补全 |
打字时 AI 续写下一句（灰色影字，Tab 接受 / Esc 忽略），默认跟随当前对话模型、也可在「代码补全」里单独指定一条模型管理通道；支持仅手动触发（Alt+\）与按语言点选排除，关闭后零请求零消耗 |
| 项目规则 |
用户级 ~/.codenova/user-rules.md 跨项目 + 项目级 AGENTS.md / .codenova/rules.md 等自动注入 AI 提示词，[规则] 页管理，兼容 .cursorrules / CLAUDE.md；改完下一条消息即生效（含未保存的编辑器内容），长对话不用重开 |
| Slash 命令 |
输入 / 弹下拉：/commit 读 staged diff 生成提交信息、/review 审查代码、/test 生成单测、/fix 按诊断修复，自动携带上下文 |
| 消息分支 |
编辑重发 / 重新生成不覆盖旧历史，新回答作为可切换的兄弟分支（‹ 1/2 ›），旧路径完整保留随时可回 |
| 联网搜索 |
配好搜索 API Key 后 AI 可 web_search 搜最新资料、fetch_url 读网页（Tavily / Serper / Exa / Bing）；抓取拒绝本机/内网地址 |
| 模型管理 |
「CodeNova: 管理模型」面板含通用 / 模型管理 / 规则 / 代码补全 / 联网五页；可增删通道、测试连通性、动态拉取模型列表、按启用状态过滤 |
| 会话留存 |
对话、思考与操作记录写入 VS Code globalStorage，重启后可继续 |
| 双语界面 |
界面语言与 AI 回复语言可分别配置（简体中文 / English） |
| 安全存储 |
API Key 使用 VS Code SecretStorage，不写入任何配置文件 |
安装
环境要求：VS Code 1.93 及以上（集成终端依赖 Shell Integration）；从源码构建需要 Node.js 18+。
从 GitHub Release 安装（推荐）
- 到 Releases 下载最新的
code-nova-x.y.z.vsix
- VS Code 里：
扩展面板 → ⋯ → 从 VSIX 安装，选择下载的文件；或命令行：
code --install-extension code-nova-0.8.0.vsix
从源码构建
仓库不含构建产物（dist/ 已被忽略），需要先构建再打包；vsce 未列入 devDependencies，用 npx 调用：
npm install
npm run build
npx @vscode/vsce package
code --install-extension code-nova-0.8.0.vsix
快速开始
- 活动栏点开 CodeNova 面板，从面板入口打开「管理模型」，选择供应商（小米 MiMo / Kimi / DeepSeek / MiniMax / 跃迁AI），填 API Key 后点刷新拉取模型列表。
- 命令面板执行「CodeNova: 设置 API Key」，密钥写入系统凭据库。
- 命令面板执行「CodeNova: 打开对话」，按需选择智能问答或智能体模式。
本地调试需自行创建 .vscode/launch.json（仓库已忽略该目录），preLaunchTask 指向 npm run build，否则 dist/extension.js 不存在、扩展无法激活。
使用注意
- 改动即时写入磁盘，文件树与编辑器中立即可见；AI 后续命令（测试、lint、编译）能读到新版本。
- 未定稿的改动在磁盘备份区留有原文快照，关闭窗口或崩溃后重启仍可接受定稿或逐个回滚；无 git 项目同样支持。
- 二进制文件（证书、图片、压缩包等）的备份与回滚按原始字节处理，不会因文本编码而损坏；删除仍走系统回收站。
- 单条前台命令默认 5 分钟超时，可在设置
codenova.command.timeoutSeconds 调整（10–1800 秒）；常驻服务请让 AI 用后台模式启动，不要靠调大超时硬扛。
- 普通命令可在确认卡勾选「本窗口内不再询问」，只在当前窗口生效、重载即清空；安装依赖、shell 解释器与不可逆命令不提供该选项。
反馈
遇到问题或有功能建议，欢迎在 Issues 中提出。
免责声明
本工具为个人开发自用，不保证完全无缺陷。使用前请自行评估风险并备份工程文件，开发者不对使用过程中产生的任何数据丢失或功能异常承担责任。
许可证
MIT © 2026 Yu_April，完整条款见 LICENSE。
最新版更新记录
版本号采用 主版本.次版本.修订号 规则。本块只保留最新一版的更新记录，历史版本变更见 CHANGELOG.md。
v0.8.0（2026-10-30）
审阅体验版本。改动 diff 改成单栏直接看删除线，底部加了逐个切换与接受/拒绝的控制条，@ 引用发出后也能原样嵌在句子里。
- 单栏 diff：点待审阅文件不再左右两栏对比，改成原生单栏内联视图——删除行红色删除线、新增行绿色，一屏看清单个文件改了什么；想回到左右对比可在设置里把「对比视图布局」改成 sideBySide。
- 状态栏审阅条：窗口底部出现「← 1/3 → 拒绝 接收」，多个文件改动时左右切换逐个审阅，接收即定稿、拒绝即回滚，全部处理完自动收起。
- @ 引用更好带：正在打开的文件排在「常用」最前，常用上限从 5 提到 8；发出后 @文件 / @技能 胶囊原样嵌在气泡文字里（不再堆在上方），关窗口重开、翻历史也保持内联；排队和「立即发送」时 @ / 不再丢失。
- 首页最近对话收紧到 3 条，视线更聚焦。
- 稳定性：模型空闲计时只在“等待网络”时挂表，工具执行期间不再误判为超时，
restore、install 这类慢命令能跑完；面板操作里的意外报错不再被静默吞掉，会记日志并给出提示。
- 修复：点待审阅文件没反应的问题；排队消息丢失 @ / 胶囊与命令的问题。
让每一次代码灵感，都像新星一样亮起来。
