DevProjex 是一款本地优先的代码库上下文构建工具,目标是为 LLM、AI 聊天和编程智能体生成干净、安全、节省 token 的项目上下文。它同时提供桌面应用、终端工作区、CLI 和只读 MCP 服务器,四者共享同一引擎、同一套过滤规则和同一条脱敏管线,支持 Windows、macOS 和 Linux。
用途 复制文件到聊天窗口逐个粘贴无法规模化;打包工具虽然快,但结果要等打包完成后才能看到;而直接给编程智能体文件访问权限,它会像读取普通源码一样读取 .env。DevProjex 的方式是可视化、精确、本地优先:让用户清楚看到哪些内容会离开项目,并控制离开的范围。
主要能力
- 选择与控制:Smart Ignore 会隐藏构建输出、依赖文件夹和缓存,并在隐藏前寻找证据;Hide Secrets 会在导出内容和 MCP 响应中就地屏蔽检测到的凭证值;Hide private data 可选屏蔽邮箱、IP、MAC、电话和用户路径;代码压缩保留声明和签名、清空实现体,纯代码约缩小 3 倍;去除注释和空行基于 20 种语言包进行语法感知清理,不修改源文件。文件树支持复选框、搜索和名称过滤。Git 模式涵盖 .gitignore、已跟踪文件、暂存文件、全部当前改动或 ref 到 ref 的差异。
- 只读 MCP 服务器:提供八个工具,包括 list_projects、get_tree、analyze、search_project、related_files、get_file、pack_context 和 read_pack,可连接 Claude Code、Codex、Claude Desktop、Cursor、Google Antigravity、VS Code 或任意 MCP 客户端。客户端通过 devprojex mcp --root /path/to/project 启动服务器并经 stdio 通信。
- Live Context:在桌面应用中勾选文件后,智能体在下一次调用即可使用该选择,无需重启或重新提问。文件树、搜索、分析、依赖和打包操作都限制在勾选范围内。
- 智能体会话日志:本地记录 MCP 会话的元数据和计数,包括调用次数、字符数、token 估算、已交付文件、屏蔽值和时长,不记录文件内容和检测到的密钥值,可导出 Markdown 或 JSON 上下文收据。
- 预览与导出:实时预览树、内容或两者,并显示行数、字符数和 token 估算;滚动条标记显示搜索匹配和脱敏发现;可导出为 ASCII、Markdown、JSON 或 XML,输出到文件或剪贴板;项目副本可导出为文件夹或 ZIP。
- 命令行:终端工作区适合键盘优先的交互操作,CLI 适合可重复、可脚本化的项目分析和 AI 上下文导出,支持 JSON 报告、stdout 输出、确定性文件、Git 仓库 URL 作为项目来源、CI 密钥预检等。
使用方式 打开或拖入项目文件夹,选择文件夹、文件、过滤器、忽略规则和输出模式,预览后复制或导出,也可从终端运行相同工作流,或通过 MCP 连接编程智能体。桌面应用通过 MCP → Live context 或 MCP → Standard 连接客户端。无桌面应用时,npm 或 NuGet 包可通过 npx -y devprojex 或 dnx devprojex 运行同一服务器。Windows 可通过 winget install OlimoffDev.DevProjex 安装。
适用场景 适用于 AI 助手(ChatGPT、Claude、DeepSeek、Qwen、Kimi)的干净输入、AI 智能体通过 MCP 读取项目、CI 管线在密钥泄漏到打包上下文时使构建失败、不允许 AI 智能体或远程索引的受限环境、大型代码库中只提取一个模块、代码审查与教学时只分享结构和关键文件。
限制与说明 MCP 模式下密钥脱敏始终开启且无法关闭,但检测是启发式的,发布前应人工检查。项目副本在启用脱敏后不是逐字节副本,可能无法构建或运行,且结果不能写入源项目内。服务器只读,工具不能修改项目文件或运行项目代码;除非显式启用 --allow-remote,网络访问默认禁用。关于平台要求、无头归档和非 root Docker 镜像等细节,资料中有安装文档指引,本文未逐一展开。
其他事实 该项目被 Avalonia UI 团队选入 App Showcase。官方基准测试(11 项任务、8 个仓库、6 种语言、每侧 22 个会话,Claude Haiku 4.5 作为智能体和评判者)显示 DevProjex 使用 973,020 tokens,对比 Repomix 的 1,174,907;在 22 对中评判者信任 DevProjex 答案 17 对,对比 3 对;植入的七个凭证两者均未泄漏,但周边代码在 7 个文件中有 7 个通过 DevProjex 保持可读,对比 1 个。任务由作者编写,Repomix 需要更少的工具调用,并在宽泛的“X 如何工作”类问题上胜出。