夜雨聆风一飞开源，介绍创意、新奇、有趣、实用的开源/AI应用、系统、软件、硬件及技术，一个探索、发现、分享、使用与互动交流的开源/AI技术社区平台。致力于打造活力开源/AI社区，共建开源新生态！
一、开源项目简介
SeekCode
桌面客户端 · 本地 Agent · 由 DeepSeek-V4 驱动的 AI 编程工具
A desktop AI coding agent that runs locally on your machine — powered by DeepSeek-V4.
融合 Claude Code（结对编程）与 Codex（任务委派）思路，基于 Electron + Node + React/TypeScript 构建的桌面客户端 AI 编程工具。 Agent 在你本机运行工具循环，深度适配 DeepSeek-V4 的混合推理档位与前缀缓存特性。 集成 Agent 工具循环、本地代码索引检索、记忆系统、Skills / MCP 扩展、内置终端与编辑器——零后端，粘贴一个 API Key 即用。
二、开源协议
使用MIT开源协议
三、界面展示
四、功能概述
为什么选择 SeekCode？
SeekCode | 云端 / 插件式 AI 编程工具 | |
️ 形态 | 桌面客户端，Agent 在本机运行多步工具循环；文件树 / 终端 / 编辑器一体 | 多为网页 / 编辑器插件 |
️ 模型适配 | 深度适配 DeepSeek-V4：混合推理三档 + thinking 解耦 + 前缀缓存 | 通用接入，未针对单模型优化 |
成本 | 仅按 DeepSeek API 计费，实时透明展示花费 / 缓存命中 / 省下金额 | 订阅制 / 不透明计费 |
可扩展 | 内置 Skills / MCP / 扩展市场，按需安装 | 取决于平台 |
️ 代码理解 | 本地 BM25 索引 + 符号大纲（离线零依赖），可选语义向量混合召回 | 多依赖云端向量库 |
上手 | 粘贴一个 API Key 即用，零后端 | 需注册 / 登录 / 配置 |
一句话：想要一个跑在自己机器上、深度适配 DeepSeek-V4 的桌面 Agent 编程工具，SeekCode 就是为你准备的。
常见问题（FAQ）
Q：它和云端 / 插件式 AI 编程工具有什么不同？ A：SeekCode 是桌面客户端，Agent 在你本机运行多步工具循环（读写文件、跑命令、检索代码），文件树 / 终端 / 编辑器一体；并针对 DeepSeek-V4 的混合推理与前缀缓存做了深度适配。
Q：需要自己搭后端吗？ A：不需要。SeekCode 是纯桌面应用，零后端，只需一个 DeepSeek API Key。
Q：大型项目会不会把整个代码库塞进 prompt？ A：不会。本地 BM25 索引 + 符号大纲只注入"代码地图"，正文按需检索；项目较大时还会提示模型优先用 search_code 定位。
Q：支持哪些平台？ A：Windows / macOS / Linux 均可构建打包。
Q：我的代码会上传吗？ A：应用自身默认只与 DeepSeek 通信（你的提问与上下文），代码索引与识图均在本机完成。注意：你或 Agent 通过终端 / run_command 执行的命令（如 git push、npm publish）属于你主动发起的正常开发操作。
五、技术选型
快速开始
前置：Node.js ≥ 18。
git clone https://github.com/kafkazhang/seek_code.gitcd seek_codenpm install # 纯 JS 依赖，无需原生编译工具链npm run dev # 启动开发模式（electron-vite）
首次启动会弹出配置框：
粘贴 DeepSeek API Key（默认接口 https://api.deepseek.com） 点「测试连接」确认可用 →「保存并开始」 点标题栏「打开项目文件夹…」选择一个本地项目 在底部输入框提问，例如："梳理这个项目的整体结构"
开发与质量
npm run typecheck # 类型检查（Node 端 + Web 端）npm run lint # ESLint（扁平配置，覆盖主/渲染层）npm test # Vitest 单元测试npm run format # Prettier 格式化（可选，本地使用）
CI（.github/workflows/ci.yml）在 PR / 主分支推送时跑 typecheck + lint + test 作为质量门。
构建与打包
npm run build # 编译主/预加载/渲染三端到 out/npm run package:win # 打 Windows 安装包npm run package:mac # macOS（支持 --x64 / --arm64）npm run package:linux # Linux（AppImage）
项目结构
src/main/ # 主进程（Node）index.ts 应用入口、窗口与运行配置config.ts 配置与 API Key（safeStorage 加密）gateway.ts DeepSeek 网关 + 缓存优先 Prompt + 成本核算 + FIM 补全retry.ts 瞬时错误重试 / 指数退避（纯逻辑）agent.ts Agent 循环（流式 + 工具调用 + 权限闸门 + 上下文压缩）subagents.ts 子代理编排（并发委派 + 审批上浮 + 进度事件）tools.ts 文件/命令工具（限定项目目录内）editing.ts 编辑纯逻辑：容错匹配/批量编辑/语法体检/glob/大纲（纯逻辑）checks.ts 项目质量门探测（typecheck/lint/test，纯逻辑）symbols.ts 符号导航：定义行识别/词边界引用（纯逻辑）todos.ts 任务清单 todo_write（纯逻辑）bgproc.ts 后台进程（run_background/bg_output/bg_kill）webfetch.ts 受控联网读取（强制审批 + 信任出口注册）htmltext.ts HTML 转纯文本（纯逻辑）cmdsafety.ts 命令安全分类（危险/自杀命令识别，纯逻辑）codeindex.ts 本地代码索引：符号大纲 + BM25 检索（持久化/增量/监听）hybrid.ts 混合召回纯逻辑：分块 / 余弦 / RRF 融合（纯逻辑）vecindex.ts 语义向量索引（embedding 缓存 / 增量 / 混合检索入口）git.ts Git 面板（status/diff/stage/commit + AI 提交信息与评审）gitparse.ts git 输出解析（porcelain/log，纯逻辑）memory.ts 记忆系统（SEEK.md / 全局）skills.ts 技能：扫描 / 安装 / 更新 / 仓库发现mcp.ts MCP 客户端（stdio + Streamable HTTP）marketplace.ts 扩展市场（内置目录 + 在线搜索安装）tasks.ts 后台任务（并发自主 Agent + 队列 + 持久化）terminal.ts 内置终端（流式、UTF-8、stdin 交互）ocr.ts 本地 OCR 识图（tesseract.js）sessions.ts 会话持久化egress.ts 应用出口白名单 + 主进程受控 fetch（guardedFetch）net.ts 渲染层出口白名单（webRequest 拦截）ipc.ts IPC 处理 + 项目文件树 + 审批往返preload/ # 预加载（contextBridge 安全桥）renderer/ # 渲染进程（React + TS）：对话、编辑器、终端、文件树、市场、设置、成本仪表盘shared/ # 主/渲染共享的类型与 IPC 常量
六、源码地址
开源项目地址：
https://github.com/kafkazhang/seek_code
访问一飞开源：https://code.exmay.com/
