CodePartner

本地化、隐私优先的 VSCode AI 编程助手。基于 Ollama + Qwen3.5:9b，完全离线运行，零云端依赖。

支持功能

对话与交互

• 💬 侧边栏对话 —— 流式打字机回复，跟随 VSCode 主题
• 🗂️ 多会话隔离 + 重命名 —— 每个工作区独立的会话列表
• 🎚️ 三种模式 —— Craft（全自动）/ Ask（纯问答，不动工具）/ Plan（先出 markdown 计划再执行，可中断）
• 🧠 模型自动 + 手动选择 —— 启动默认选中配置的默认模型（Qwen3.5:9b）；点顶部刷新即可拉取本地 Ollama 已安装模型列表，下拉手动切换任意模型，即时生效
• ⏹️ 可中断 / 可清空当前会话

代码能力

• 🔍 搜代码 —— 在工作区里按关键字检索（ripgrep，缺失自动降级）
• 📁 读文件 / 列目录 —— 支持按行号范围读，路径越界自动拦截
• 🧩 代码理解 —— 找定义 / 找引用 / 看文件结构（不依赖 LSP）
• ✍️ 写文件 + Diff 预览 + 确认 —— 落盘前红绿高亮预览，确认后才执行；同一文件单次只写一次，不重复打扰
• 📎 选区 / 文件加入上下文 —— 右键或快捷键加入，供对话引用
• 🌐 联网搜文档 —— 无需 API Key

配置

• 🧩 Skill 配置 —— 导入 .md / 文件夹技能，供 AI 按需查用
• 🔌 MCP 配置 —— 可导入 mcp.json（持久化）

使用方式

1. 前置：启动本地后端

插件依赖本地后端（Ollama + Python server），必须先把后端跑起来，否则对话会连不上。

cd codepartner
./scripts/start.sh          # macOS / Linux
# 或 Windows: scripts\start.bat

看到 Application startup complete 即就绪，可用 curl http://127.0.0.1:8765/health 验证。

2. 安装插件

• 应用商店 / vsix 安装后，左侧活动栏会出现 CodePartner 图标（对话气泡 + 括号）。
• 也可本地打包安装：

  cd extension
  npm install            # 需要 Node 18+
  npm run package        # 生成 codepartner-0.1.0.vsix
  code --install-extension codepartner-0.1.0.vsix
  

3. 开始使用

1. 打开一个文件夹（不是裸文件），否则代码类工具拿不到工作区。
2. 点击活动栏 CodePartner 图标打开 Chat 面板。
3. 顶部选模式（Craft / Ask / Plan）、选模型，直接输入提问。
4. 选中代码 Cmd/Ctrl+Alt+S、或对文件 Cmd/Ctrl+Alt+F，把内容加入上下文再提问。
5. 当 AI 要写文件时，会弹出 Diff 确认框，确认后才落盘。

命令面板（Cmd/Ctrl+Shift+P）

配置项（Settings 搜 "codepartner"）

仓库位置

待补充。

故障排查