Nexapinode for VS Code

把 Nexapinode 放进 VS Code 与 Cursor：通过 @ 精确引用项目文件、附加图片、流式提问，或先用计划模式梳理任务，再让受限本地 Agent 生成待审阅的多文件改动。

三分钟开始

1. 登录 Nexapinode 并在密钥管理页创建 API Key；
2. 安装扩展后点击右下角状态栏中的 Nexapinode，或执行命令面板中的 Nexapinode: 打开 AI 助手；它默认在当前编辑器右侧打开；
3. 点击“设置 API Key”，粘贴密钥；
4. 选择当前账号可用的模型并开始提问。

Cursor 用户可以安装同一个 .vsix：打开命令面板，执行 Extensions: Install from VSIX...。

能力

• 从 /v1/models 加载 API Key 实际可用的模型，并按 OpenAI、Anthropic、Google 等模型家族分组，长模型列表仍可快速定位；
• 模型加载超时或密钥无效时会进入可恢复状态，明确提供重试与修改密钥入口，并保留输入草稿；
• 面板顶部始终可修改 API Key；填错或更换密钥后无需前往命令面板；
• 使用 /v1/chat/completions 流式对话；
• 在输入框键入 @，可按路径模糊搜索工作区文件；选中后会作为该条消息的上下文附加。文件名含空格时会自动以 @{路径} 插入；
• 只有从 @ 补全菜单中明确选中的文件才会被读取；直接手打 @路径 只是普通文字，不会触发文件读取；
• 选中代码后右键解释、修复或加入上下文；“＋ 文件（可多选）”可从工作区选择多个文件，“＋ 文件夹”会递归列出工作区内的安全文本、代码和受支持图片候选，再由你确认实际附加项；命令面板也提供独立的文件夹入口；
• 点击“＋ 图片”可从电脑手动附加 PNG、JPEG、WebP 或 GIF，让支持视觉输入的模型识别界面截图、报错图或设计稿；
• 截图也可直接粘贴到输入框，或将图片拖入输入框；图片仍需要由你点击发送；
• 默认每次请求都使用受限本地 Agent；输入 /plan 才会临时进入只读计划模式，输出“涉及文件、任务清单、验证方式”；计划可在面板内编辑，只有点击“按此计划实施”才会进入能提出 diff 的 Agent；
• 每个工作区支持本地会话的新建、搜索、重命名、分支与整理；历史不会上传为独立云端数据；
• 长会话会按保守 token 估算在请求前自动压缩较早轮次；Agent 连续调用本地工具时也会在轮次间整理旧结果，并完整保留最近的工具调用与对应结果。重复压缩会重新提取前一份交接中的目标、约束、文件、任务清单和验证证据；本地持久化达到边界时会生成明确交接摘要，而不是静默丢弃前文；
• 单条最新输入本身过长时也会按预算保留首尾并明确标记中间省略，不会因只有一条消息而绕过压缩；
• 发送前检查会合并显示历史消息、当前输入和显式附件的估算负载；普通文本上下文总计最多约 16k token、单份最多约 8k token，长文件保留开头与结尾并显示截断，不会把“只读到前半段”伪装成完整内容；
• 历史保留量会为当前附件、规则、图片和系统提示动态让出空间；若上游私有模型的真实窗口仍更小，会进一步压缩并自动重试一次，同时在界面说明恢复过程；
• 如果模型因为输出长度上限停止，回答下方会明确标记“并非完整结束”，并提供保留当前上下文的继续入口；
• Agent 任务会在请求发出时立即保存；若扩展重载、窗口崩溃、任务取消或请求失败，会显示恢复卡片，可把原任务和最近工具进度放回 Composer 继续；
• Agent 可调用 VS Code/Cursor 的语言服务搜索工作区符号，先定位类型、函数、成员及其位置，再按需读取相关文件；
• Agent 的文本搜索会检查文件的完整可读安全范围，不再只搜开头；单个文件可按 offset / nextOffset 分页续读到 2MB，搜索单次累计扫描最多 24MB，并明确告知是否截断；
• 搜索结果会返回行列、精确字符 offset 与建议 readOffset，Agent 可直接跳到大文件命中附近；单页内容另受约 12k token 保护，任务轨迹明确显示本页起止、文件总长、预计剩余页数与 nextOffset，中文页会更短但不会漏掉中间范围；
• 确需全文读取时，Agent 会按剩余页数使用最大页长并预留最终动作预算；若 24 次调用内无法覆盖全文，会转为符号/文本搜索和精确区间，并明确提示未完整读取；
• 整文件替换必须先读完从 0 到末尾的连续分页，读取一半时会被宿主拒绝并要求沿 nextOffset 续读；局部替换只要求先读相关页面，避免为了改一处而回传整份大文件；
• 分页覆盖同时绑定文件 SHA-256 revision；文件在读取期间即使只做同长度编辑，也会使旧页失效，修改前必须重新读取当前版本；
• 输入 / 可发现 /plan、/agent、/review、/tests、/explain、/new、/compact；
• 模型选择位于 Composer 右下角；左下角“＋”菜单集中添加选择、文件、图片、Problems、符号、终端、Git 与项目规则上下文；
• 可附加当前 Problems 诊断、光标符号的定义/引用/调用链上下文，以及插件启动后由你确认的最近终端输出；
• Agent 的一项任务可产生一个多文件变更集：同一文件的多次局部修改会在待审阅虚拟版本上累计并最终只写入一次；可逐个预览 diff、只勾选并应用部分文件，应用前会创建可恢复的本地检查点；
• Agent 可在已有工作区目录内提议新建文件；宿主会在提议与应用两个时点确认路径不存在，新文件同样进入多文件 diff、二次确认与可撤回检查点；
• 回答使用安全 Markdown 渲染，支持标题、列表、任务清单、GFM 表格、链接、强调与代码块，完整 Markdown 原文可复制/切换；VSIX 内置 KaTeX 与字体，常见行内/块级 LaTeX 会渲染为带 MathML 的可访问公式，行内公式可双击复制、块公式可一键复制 LaTeX 源码；
• Markdown 链接只允许 HTTP(S)、mailto 与 tel 协议，危险协议或控制字符会显示为不可点击文本；
• 公式识别会避开常见货币文本歧义，例如 $5 and tax is $2、$5 + $2 tax 保持价格文本，Cost $5, then use $x+1$ 则只渲染真正的公式；
• Agent 会把查看目录、搜索、读取文件和生成 diff 的执行轨迹逐项显示，并标记成功、失败与目标路径；
• 完成后的工具证据会按会话保存在本机；切换会话或重载窗口后仍可从顶部“任务轨迹”按工具、待审阅和失败筛选，并导出不含命令参数、不能重放副作用的本地 JSON 证据快照；
• 执行卡会按“理解 → 计划 → 执行 → 审阅 → 验证”显示阶段；没有退出码证据时不会把验证标为完成；
• 在受信任工作区，Agent 可请求运行根目录 package.json 中固定的 test、typecheck、lint 或 build 脚本。首次会显示具体命令，可选择仅一次或始终允许当前工作区；工具不接受任意命令、参数或 shell 插值；
• 可主动附加未提交 Git diff 进行审阅，也可用命令面板恢复最近检查点；
• AGENTS.md、CLAUDE.md、.cursorrules、.cursor/rules 与 Copilot 规则不会被静默读取，须在“规则”中由你勾选启用；
• 明确启用的项目规则使用独立的约 8k token 保护预算，并在同一次 Agent 运行自动压缩后继续作为约束注入；
• Agent 模式可列出、搜索和读取非敏感工作区文本文件，不会自动上传整个项目；
• “Nexapinode: 打开 AI 助手”默认以右侧编辑器面板打开；不再显示在 Explorer/文件树同一侧；
• Agent 的任何文件修改都会先在 VS Code diff 中预览，只有你选择文件、点击应用并在弹窗中再次确认后才会写入；
• Agent 不提供任意终端命令、联网、工作区外文件、环境变量或密钥读取能力；验证只通过受限 VS Code Task 执行项目已定义脚本；
• 将最后一次回答复制或插入当前编辑器；
• 对话记录按工作区保存在本机，不上传独立的云端历史；
• API Key 使用 VS Code SecretStorage，不会写入项目设置、源码或 Webview；
• 每条普通任务默认进入受限 Agent；只有在任务需要项目上下文时才会按需调用本地工具，/plan 始终只读；界面不再要求用户先选择聊天或 Agent 模式；
• .env、私钥、证书、凭据目录等敏感文件会被拒绝读取和修改；
• 图片仅在你手动附加并发送时，以模型输入的一部分上传；单张最大 4 MiB，每次最多 4 张；
• 工作区未受信任时，Agent 需每次取得本次只读访问确认；任何写入都要求受信任工作区、diff 预览和双重确认。

计费

扩展本体免费。模型请求通过用户自己的 Nexapinode API Key 发起，按网站公布的模型价格和账号实际用量扣除额度。

隐私与权限

• 顶部“⚙”会集中展示 API Key、工作区信任、只读访问和受限验证状态；可一次性允许或撤销当前工作区权限，不必等到任务运行中逐个处理；
• Webview 永远拿不到完整 API Key；网络请求由扩展宿主发起；
• API 地址只能使用 HTTPS，本机开发地址除外；
• 在不受信任工作区附加代码前会再次请求确认；
• 每次只发送用户输入、最近对话和用户主动选择（包括 @ 补全确认）的代码；
• 可随时运行 Nexapinode: 清除 API Key 删除本机凭据。

完整教程与服务说明：https://ai.nexapinode.site/docs

开发

npm ci
npm run check
npm test
npm run compile
npm run package:vsix