🤖 完整指南-带QWEN3的本地IA-代码:30B
配置: M3 Pro 36GB内存 · 型号: QWEN3-代码:30B(本地、免费、私人) · 外壳: 鱼 · 日期: 2025-11-10
🆕 用作Git存储库
- 克隆或初始化```bash
git clone ~/LLM # ou: mkdir ~/LLM && cd ~/LLM && git init
cd ~/LLM
1. **配置链接和文件夹**```bash
bash bootstrap.sh
exec fish
- 安装Python依赖项(带网络)```bash
python3 -m pip install --user --upgrade litellm mcp modelcontextprotocol huggingface_hub
python3.11 -m pip install --user --upgrade mcp modelcontextprotocol # si vous utilisez Homebrew Python
1. **测试员la pile MCP**```bash
cd mcp
./test-mcp.sh
./test-interactive.sh
- Lancer la stack```bash
qwen-mcp # alias conseillé dans ~/.config/fish/config.fish
agents # menu interactif des scripts IA
📅 查看 `ROADMAP.md` 了解下一步(多MCP支持、代理集成、多机器打包)。
______________________________________________________________________
## 📋 目录
- 用作Git存储库
- 超快速启动
- 档案结构
- 可用代理
- 现有鱼类功能
- 助手(代码修改)
- Continue.dev(IDE)
- 工作流
- 配置
- 故障排除
- 路线图
______________________________________________________________________
## ⚡ 超快速启动```fish
# 1. Recharger Fish (une seule fois)
exec fish
# 2. Utiliser
agents # Menu interactif
git-agent.sh "question" # Agent Git
security-agent.sh ./projet # Audit sécurité
code-review-agent.sh fichier.js # Review de code
# 3. Ou utiliser vos fonctions Fish existantes
ask "question rapide" # Question simple
gen-tests fichier.js # Générer des tests
📂 档案结构```
~/LLM/
├── README.md → Ce guide complet
├── agents/ → 7 scripts d'agents IA
├── aider/ → Config + état d'Aider
│ ├── aider.conf.yml → Thème & options dev
│ ├── model-settings.yml → Paramètres avancés (num_ctx, t°)
│ └── state/ → Cache Aider (ancien ~/.aider)
├── ollama/ → Modèles, logs & clés Ollama
└── qwen/ → Notes & profils Qwen3
**自动符号链接:**
- `~/.aider.conf.yml` → `~/LLM/aider/aider.conf.yml`
- `~/.aider.model.settings.yml` → `~/LLM/aider/model-settings.yml`
- `~/.aider` → `~/LLM/aider/state`
- `~/.ollama` → `~/LLM/ollama`
➡️ 所有本地堆栈(Ollama、Qwen3、Aider)现在都在 `~/LLM`,便于备份或iCloud/时间机器同步。
______________________________________________________________________
## 🤖 可用代理
### 1.git-agent.sh-专家git```fish
git-agent.sh "Comment annuler mon dernier commit ?"
git-agent.sh "Différence entre merge et rebase ?"
2.security-agent.sh-安全审计```fish
security-agent.sh fichier.js # Fichier
security-agent.sh ./src # Dossier
security-agent.sh . # Projet
检测:SQL注入、XSS、CSRF、暴露凭证
### 3.db-agent.sh-专家SQL/PPostgreSQL```fish
psql mydb -c "\d+ users" > schema.sql
db-agent.sh schema.sql "Crée une procédure de migration avec rollback"
4.代码审查-agent.sh-代码审查```fish
code-review-agent.sh app.js # Fichier
code-review-agent.sh # Changements git
### 5.重构代理.sh-重构```fish
refactor-agent.sh app.py "Réduire complexité cyclomatique"
refactor-agent.sh utils.js "Appliquer SOLID"
6.debug-agent.sh-调试```fish
debug-agent.sh app.js "TypeError ligne 42"
### 7.agent-manager.sh-菜单交互```fish
agents # Alias
# ou
agent-manager.sh
🐟 现有鱼类功能
你已经有了很好的功能 ~/.config/fish/config.fish :
可用功能```fish
ask "question" # Question rapide à Qwen3
ai # Session interactive Qwen3
qwen # Alias de 'ai'
code-review fichier # Review basique
gen-tests fichier # Générer des tests
explain-code fichier # Expliquer du code
### 什么时候使用什么?
|需要|鱼函数|代理|
|--------|--------------|--------|
快速问题|✅ `ask "question"` | - |
|审查基础| `code-review` | ✅ `code-review-agent.sh` (更详细)|
|测试|✅ `gen-tests` | - |
|解释|✅ `explain-code` | - |
|问题Git |-|✅ `git-agent.sh` |
安全审计|-|✅ `security-agent.sh` |
|SQL/DB|-|✅ `db-agent.sh` |
|调试|-|✅ `debug-agent.sh` |
|重构|-|✅ `refactor-agent.sh` |
**两者是互补的!**
______________________________________________________________________
## 🔧 教唆者
使用IA编辑代码的CLI工具。
### 使用```fish
cd projet
aider fichier.js # Éditer un fichier
aider --read doc.md src/app.js # Avec contexte read-only
帮助命令```
/add fichier.js → Ajouter un fichier
/read fichier.md → Contexte read-only
/ls → Lister fichiers
/exit → Quitter
### 例子```
> Crée une API REST pour gérer des utilisateurs avec validation
> Corrige le bug TypeError ligne 42 dans app.js
> Refactorise utils.js : applique DRY et ajoute gestion erreurs
> Génère des tests Jest pour user.service.js
💻 Continue.dev
用于自动完成和聊天的IDE扩展。
安装```fish
code --install-extension continue.continue # VS Code
brew install --cask cursor # Cursor (intégré)
### 捷径
- `Cmd+L` :聊天
- `Cmd+I` :在线版
- `Tab` :接受自动完成
**已配置** 在 `~/.continue/config.json` 使用QWEN3-编码器:30B
______________________________________________________________________
## 🎯 工作流
### 工作流1:功能开发```fish
# 1. Question rapide
ask "Comment implémenter un WebSocket ?"
# 2. Créer avec Aider
aider src/websocket.js
> Implémente un serveur WebSocket avec reconnexion
# 3. Review détaillée
code-review-agent.sh src/websocket.js
# 4. Audit sécurité
security-agent.sh src/websocket.js
# 5. Tests
gen-tests src/websocket.js
# 6. Commit
git commit -m "feat: add WebSocket server"
工作流程2:调试```fish
1. Identifier
debug-agent.sh app.js "TypeError ligne 42"
2. Fix
aider app.js
> Applique le fix suggéré
3. Vérifier
code-review-agent.sh app.js
### 工作流3:安全审计```fish
# 1. Scan
security-agent.sh .
# 2. Fix
aider vulnerable.js
> Corrige les vulnérabilités détectées
# 3. Re-vérifier
security-agent.sh vulnerable.js
⚙️ 配置
鱼(~/.config/fish/config.fish)
添加:```fish
fish_add_path -g ~/LLM/agents
alias agents='agent-manager.sh'
**已存在(您的功能):**```fish
# Fonctions Ollama
function ask
function code-review
function gen-tests
function explain-code
# Alias
alias ai='ollama run qwen3-coder:30b'
alias qwen='ollama run qwen3-coder:30b'
助手(~/LLM/aider/aider.conf.yml)```yaml
model: ollama_chat/qwen3-coder:30b
git: true
auto-commits: false
dirty-commits: false
dark-mode: false
watch-files: true
show-diffs: true
map-tokens: 2048
code-theme: nord
suggest-shell-commands: true
analytics: false
➡️ 适用于输入/输出+完成菜单的北方主题,以及 `commit-prompt` 强制使用联合国消息au格式 *常规承诺*.重要提示:通行证 `dark-mode: false`否则,请使用其fluo配置文件帮助重写颜色。
**`model-settings.yml`**```yaml
- name: ollama_chat/qwen3-coder:30b
extra_params:
num_ctx: 131072
➡️ 是这个文件(链接到 ~/.aider.model.settings.yml)谁真正传播 num_ctx 在奥拉玛。仅设置特定于模型的选项(温度、保持活动等)。
Qwen&Ollama(~/LLM/qwen, ~/LLM/ollama)
~/LLM/ollama现在包含其中的所有内容~/.ollama(模板、SSH密钥、日志)。符号链接确保:ollama run …继续工作。~/LLM/qwen/Modelfile提供个人资料qwen3-coder-dev(温度0.2+系统提示)。用它建造ollama create qwen3-coder-dev -f ~/LLM/qwen/Modelfile.~/LLM/qwen/system-prompt.md您可以作为家庭指示的记事本:将其复制到您的Modelfile或者将其粘贴到帮助/代理中。
> 提示:考虑排除 ~/LLM/ollama/models 如果空间不足,请使用iCloud/Dropbox,但保留其余空间,以便快速恢复堆栈。
Continue.dev(~/.continue/config.json)```json
{
"models": [{
"provider": "ollama",
"model": "qwen3-coder:30b",
"apiBase": "http://localhost:11434"
}]
}
______________________________________________________________________
## 🆘 故障排除
### “找不到命令:git agent.sh”```fish
exec fish # Recharger Fish
“无法连接到ollama”```fish
ollama serve # Démarrer Ollama
### 代理商lents```fish
ollama list # Vérifier Ollama
top # Vérifier charge CPU
帮助不是开始的```fish
cat ~/LLM/aider/aider.conf.yml # Vérifier config
ollama run qwen3-coder:30b "test" # Tester Ollama
pip install --upgrade aider-chat # Réinstaller
______________________________________________________________________
## 📊 替代比较
你的设置 · Copilot · ChatGPT · Cursor
**成本** 免费 · $10/月 · $20/月
**韦特里斯** · 3-15s · 瞬间 · 10-30s · 5-20s
**私人** · ✅ 100% · ❌ 云 · ❌ 云 · ❌ 云
**上下文** · 262K · ~8K · 128K · ~128K
**离线** · ✅ · ❌ · ❌ · ❌
**节省:约240-600美元/年**
______________________________________________________________________
## 🗑️ 卸载```fish
rm -rf ~/LLM
rm ~/.aider.conf.yml ~/.aider ~/.ollama
# Éditer ~/.config/fish/config.fish : supprimer les 2 lignes agents
exec fish
📅 路线图
v0.1–初始化(✅ 进行中)
- [x]记录本地堆栈(主自述)。
- [x] 脚本
bootstrap.sh以创建必要的符号链接。 - [x]添加LiteLLM+主机MCP代理(
~/LLM/mcp).
v0.2–扩展MCP(🔜)
- []本机支持多个MCP服务器(
--extra-server开箱即用:Git、浏览器、HTTP)。 - []自动化测试(
test-mcp.sh,test-interactive.sh)集成到CI工作流中。 - []系统提示规范化(助手、代理和MCP之间共享的单个文件)。
v0.3–统一代理(🧪 设计)
- []转换Bash代理(
agents/*.sh)在专用MCP服务器中,以便能够自动调用它们。 - []添加共享提示/食谱库(提交样式、评论等)。
- []提供一个独特的TUI/CLI界面(菜单),用于启动帮助、MCP和测试。
v0.4–配电多机(📦)
- []完整安装脚本(brew/pip)+Ollama检查。
- []Gabarit de configuration Fish(别名
qwen-mcp,函数,tmpdir)。 - []简化导出/备份(
make package或tar脚本)以移动堆栈。
💡 推荐别名
添加到 ~/.config/fish/config.fish :```fish
alias sec='security-agent.sh'
alias review='code-review-agent.sh'
alias fix='debug-agent.sh'
alias githelp='git-agent.sh'
______________________________________________________________________
## ✅ 清单```fish
ollama list # ✅ qwen3-coder:30b présent
git-agent.sh "test" # ✅ Réponse reçue
aider --version # ✅ aider 0.82.3
agents # ✅ Menu s'ouvre
你有:
- ✅ 7名专业人员
- ✅ 快速鱼类功能
- ✅ 助浇改性剂du代码
- ✅ 继续开发IDE
- ✅ 所有本地、免费、私人
总计:68 KB |型号:QWEN3-编码器:30B 124配置:M3 Pro 36GB
