CodeBaseAsk

利用闲余时间开发的一款基于 代码库+AI智能交互 的一个免费桌面软件，支持自定义配置 LLM, 并且所有代码/LLM数据均在本地不上传云端，对企业或者个人注重数据隐私安全的推荐使用。

目前只是一个 MVP 版本，内部还有许多 bug, 请见谅，先凑合用(毕竟目前只有利用闲余时间去开发和修复bug)，等后面有时间会持续优化。

AI 驱动的代码库问答与文档生成软件

✨ 产品简介

CodeBaseAsk 是一款桌面端 AI 智能代码助手，帮助开发者快速理解和分析任意代码仓库。无论是开源项目还是本地项目，只需简单操作即可生成详细的项目文档 Wiki，并通过自然语言与 AI 进行深度问答交互。

🚀 核心功能

📚 智能 Wiki 文档生成

自动分析代码结构，生成结构化的项目文档，帮助快速了解项目全貌。

• 快速模式：5-10 分钟生成简要概览文档
• 详细模式：30 分钟生成完整技术文档
• 自动目录：智能提取章节结构，支持跳转导航
• 图表渲染：支持 Mermaid 流程图、时序图等可视化展示
• 收藏功能：一键收藏常用项目，快速访问

💬 AI 智能问答

基于代码库上下文，与 AI 进行深度对话，快速获取代码相关问题的答案。

• 上下文感知：AI 理解整个代码库结构和逻辑
• 实时流式响应：打字机效果，即时查看回答
• 工具调用展示：透明展示 AI 调用的分析工具
• Markdown 渲染：代码高亮、表格、图表完美呈现
• 历史记录：保留对话历史，随时回顾

🔍 多源仓库支持

灵活添加各类代码仓库，满足不同场景需求。

🔥 热门项目探索

发现 GitHub 热门开源项目，紧跟技术趋势。

• 多维度筛选：按语言（Python、Go、JavaScript 等）筛选
• 时间范围：今日、本周、本月热门
• 一键分析：直接生成 Wiki 或进入问答
• 无限滚动：流畅加载更多项目

📊 图表全屏查看

Mermaid 图表支持全屏沉浸式查看，细节清晰呈现。

• 点击放大：悬浮显示放大图标，点击进入全屏
• 毛玻璃背景：现代化视觉效果
• 缩放控制：按钮控制或滚轮缩放（25%-300%）
• 快捷键支持：+ 放大、- 缩小、0 重置、Esc 关闭

⚙️ LLM 模型自定义配置

完全自定义 AI 模型设置，支持接入各类大语言模型服务。

• 模型支持：兼容 OpenAI 模型，后续会适配更多模型
• 自定义 API：配置任意兼容 OpenAI 协议的 API 端点
• 灵活参数：
• Base URL：自定义 API 服务地址
• API Key：配置访问密钥
• Model：选择或指定模型名称
• 本地配置：所有配置信息安全存储在本地

🏆 产品优势

与其他代码分析产品对比

🔒 数据安全优势

CodeBaseAsk 采用本地优先架构：

• 代码不上传：所有代码分析在本地完成，代码内容不会传输到第三方服务器
• 隐私可控：仅将必要的问答请求发送给您配置的 LLM 服务
• 适合企业：满足企业级代码安全合规要求

⚡ 实时问答优势

不同于静态文档，CodeBaseAsk 提供真正的代码感知问答：

• 代码上下文理解：AI 能够读取和分析代码文件内容
• 跨文件关联：理解函数调用、模块依赖等代码关系
• 实时更新：代码修改后问答结果实时反映最新状态
• 精准定位：可以指向具体的代码位置和实现细节

🖥️ 界面预览

侧边栏导航

• 探索：搜索和添加仓库
• 趋势：浏览热门项目
• 私有仓库：管理本地/私有项目
• 收藏夹：快速访问收藏项目
• 最近查看：历史访问记录

📦 安装

macOS

下载链接: https://github.com/yangkun19921001/CodeBaseAsk/releases/tag/v1.0.0

1. 下载 DMG 安装包：
• Intel 芯片：CodeBaseAsk-1.0.0.dmg
• Apple Silicon：CodeBaseAsk-1.0.0-arm64.dmg
2. 打开 DMG 文件，将应用拖入 Applications 文件夹
3. 首次运行时右键选择"打开"

Windows(后续支持)

1. 下载 CodeBaseAsk-Setup-1.0.0.exe
2. 双击运行安装程序
3. 按提示完成安装

Linux(后续支持)

1. 下载 CodeBaseAsk-1.0.0.AppImage
2. 添加执行权限：chmod +x CodeBaseAsk-1.0.0.AppImage
3. 双击或命令行运行

🛠️ 快速开始

1. 启动应用：首次启动会自动初始化后端服务
2. 配置 LLM: 生成 wiki 之前必须要配置 llm 大语言模型，目前仅仅支持 openai 格式的 api
3. 添加仓库：
• 输入 GitHub/Gitee 仓库 URL，或
• 点击"添加本地项目"选择文件夹
4. 生成 Wiki：选择快速/详细模式，等待生成完成
5. 开始问答：点击右上角"Ask AI"按钮，输入问题

💡 使用技巧

• 快速搜索：输入仓库名称自动搜索 GitHub 仓库
• URL 解析：直接粘贴完整 URL 自动识别仓库信息
• 键盘快捷键：Enter 发送问题，Shift+Enter 换行
• 图表缩放：鼠标滚轮或双指捏合手势

用 AI 理解代码，让开发更高效