使用说明
📘 本地离线AI开发助理
使用DeepSeek Coder 1.3B和Ollama构建的完全离线、注重隐私的人工智能开发助理。 此工具可以解释代码、调试错误、搜索整个项目、读取文件、分析函数和回答编码问题，所有这些都可以在没有互联网的情况下在您的计算机上本地运行。
🚀 特性
🔹 1.代码说明
解释任何Python/JS/TS/文本文件
总结逻辑、函数、类
重点介绍关键运营和结构
🔹 2.调试协助
分析代码
检测潜在的漏洞
解释错误发生的原因
以清晰的推理提出解决方案
🔹 3.项目范围内的代码搜索
搜索：
函数
变量
模式
关键词
显示文件名+行号+匹配文本
🔹 4.功能定义定位器
找出项目中定义函数的确切位置。
🔹 5.文件系统工具
读取文件
列出项目文件
显示元数据（大小、扩展名、位置）
跳过不需要的文件夹(__pycache__、.git等）
🔹 6.问人工智能问题
询问一般编程问题或与文件上下文相关的问题。
🔹 7.完全离线
没有API密钥
没有云
无外部依赖性
100%隐私
所有推理都在Ollama内部本地运行
🧠 为什么DeepSeek编码器1.3B？
DeepSeek编码器1.3B比Gemma3-270M更受欢迎，因为：
更好的代码理解
更精确的调试
更可靠的解释
更大的训练数据
仍然足够小，可以在CPU上脱机运行
非常适合Python+一般编码任务
该型号在保持快速和轻便的同时提供高质量的输出。
| 组件 | 目的 |
|---|---|
| Python 3.10+ | 主CLI逻辑 |
| 奥拉玛 | 本地LLM运行时 |
| DeepSeek编码器1.3B | 离线以代码为中心的人工智能模型 |
| 立体色 | 彩色CLI输出 |
| 模型上下文协议（MCP） | 刀具包装系统 |
| 自定义工具 | 文件操作和代码搜索 |
项目结构
本地离线AI开发助理/
│── cli.py#命令行界面
│── ollama_client.py#与DeepSeek编码器的通信
│── mcp_server.py#（可选）mcp服务器文件
│── config.json#允许的扩展名，排除的文件夹
│── requirements.txt#Python依赖项
│── test.py#测试示例文件
│── 工具/
│ ├── file_ops.py#文件读取/列出助手
│ └── search.py#项目范围内的代码搜索
└── .gitignore#忽略不必要的文件
🔒 离线隐私保障
此项目100%在您的本地系统上运行。 没有数据发送到任何服务器。 无需API密钥或互联网。 非常适合机密代码库。
🏁 结论
该项目表明，即使是轻量级的1.3B模型也可以作为强大的离线编码助手。 它提供有用的代码解释、调试、搜索和项目理解——所有这些都不需要互联网，完全在您的本地机器上。
