Nexa
Nexa 是一款 VS Code AI 编程助手扩展，提供侧边栏对话、工具调用、Diff 审阅、MCP 集成与 SubAgent 委派等能力。
功能
- AI 对话：侧边栏 Webview 聊天，支持多轮对话与历史会话
- 代码编辑：Agent 可读写文件、执行命令、审阅 Diff（Keep / Undo）
- MCP 工具：通过
.nexa/mcp.json 接入外部 MCP Server
- SubAgent：支持 Task 委派与子 Agent 配置（
.nexa/agents/）
- Skills：项目级与全局技能定义（
.nexa/skills/）
对话持久化
- 在工作区根目录下使用
storages/nexa-chat/ 保存侧边栏对话快照（index.json + sessions/<sessionId>.json）
- 当前活动会话 id 记在扩展的 workspaceState（
nexaChat.activeSessionId）
- 命令面板：
Nexa: 新建对话、Nexa: 打开历史对话
- 隐私：
storages/ 已默认加入 .gitignore，可能包含工具输出或路径信息
配置目录
| 路径 |
说明 |
.nexa/mcp.json |
MCP Server 配置 |
.nexa/ai.json |
本地 AI 配置（含 API Key，仅开发用，勿提交） |
.nexa/agents/ |
SubAgent 定义 |
.nexa/skills/ |
项目级 Skills |
~/.nexa/skills/ |
全局 Skills |
.nexa/todos.json |
Agent 任务列表 |
开发
pnpm install
pnpm run dev
在 VS Code 中按 F5 启动扩展调试。
AI 配置（发布前必读）
扩展不会内置任何 API Key 或私有模型配置。安装后请按以下方式配置：
- 命令面板执行
Nexa: 配置 AI 服务，按引导选择服务商并填写 API Key
- 在设置中填写：
nexa.ai.baseURL — OpenAI 兼容接口地址nexa.ai.model — 模型名称
本地开发可复制 .nexa/ai.json.example 为 .nexa/ai.json 填入配置（该文件已加入 .gitignore）。
扩展设置
| 设置项 |
默认值 |
说明 |
nexa.mcp.enabled |
true |
是否启用外部 MCP 工具 |
nexa.mcp.configFile |
.nexa/mcp.json |
MCP 配置文件路径 |
nexa.subagent.allowNested |
false |
是否允许子 Agent 嵌套委派 |
nexa.subagent.maxDepth |
2 |
SubAgent 嵌套深度上限 |
nexa.subagent.injectOnComplete |
false |
Async 子 Agent 完成后是否注入摘要 |
nexa.ai.baseURL |
"" |
AI 服务 Base URL |
nexa.ai.model |
"" |
默认 AI 模型 |
nexa.ai.temperature |
0.7 |
AI 采样温度 |
nexa.ai.maxRetries |
3 |
AI 请求最大重试次数 |
nexa.ai.retryDelay |
3000 |
AI 重试间隔（毫秒） |
| |
