Daviani MCP

🤖 完整指南-带QWEN3的本地IA-代码：30B

配置： M3 Pro 36GB内存| 型号： QWEN3-代码：30B（本地、免费、私人）| 外壳： 鱼| 日期： 2025-11-10

______________________________________________________________________

🆕 用作Git存储库

1. 克隆或初始化

   git clone  ~/LLM   # ou: mkdir ~/LLM && cd ~/LLM && git init
   cd ~/LLM

1. 配置链接和文件夹

   bash bootstrap.sh
   exec fish

1. 安装Python依赖项（带网络）

   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

   cd mcp
   ./test-mcp.sh
   ./test-interactive.sh

1. Lancer la stack

   qwen-mcp                         # alias conseillé dans ~/.config/fish/config.fish
   agents                           # menu interactif des scripts IA

📅 查看 ROADMAP.md 了解下一步（多MCP支持、代理集成、多机器打包）。

______________________________________________________________________

📋 目录

• 用作Git存储库
• 超快速启动
• 档案结构
• 可用代理
• 现有鱼类功能
• 助手（代码修改）
• Continue.dev（IDE）
• 工作流
• 配置
• 故障排除
• 路线图

______________________________________________________________________

⚡ 超快速启动

# 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

git-agent.sh "Comment annuler mon dernier commit ?"
git-agent.sh "Différence entre merge et rebase ?"

2.security-agent.sh-安全审计

security-agent.sh fichier.js       # Fichier
security-agent.sh ./src            # Dossier
security-agent.sh .                # Projet

检测：SQL注入、XSS、CSRF、暴露凭证

3.db-agent.sh-专家SQL/PPostgreSQL

psql mydb -c "\d+ users" > schema.sql
db-agent.sh schema.sql "Crée une procédure de migration avec rollback"

4.代码审查-agent.sh-代码审查

code-review-agent.sh app.js        # Fichier
code-review-agent.sh               # Changements git

5.重构代理.sh-重构

refactor-agent.sh app.py "Réduire complexité cyclomatique"
refactor-agent.sh utils.js "Appliquer SOLID"

6.debug-agent.sh-调试

debug-agent.sh app.js "TypeError ligne 42"

7.agent-manager.sh-菜单交互

agents                             # Alias
# ou
agent-manager.sh

______________________________________________________________________

🐟 现有鱼类功能

你已经有了很好的功能 ~/.config/fish/config.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

什么时候使用什么？

两者是互补的！

______________________________________________________________________

🔧 教唆者

使用IA编辑代码的CLI工具。

使用

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扩展。

安装

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：功能开发

# 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：调试

# 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：安全审计

# 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_add_path -g ~/LLM/agents
alias agents='agent-manager.sh'

已存在（您的功能）：

# 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)

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

- 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)

{
  "models": [{
    "provider": "ollama",
    "model": "qwen3-coder:30b",
    "apiBase": "http://localhost:11434"
  }]
}

______________________________________________________________________

🆘 故障排除

“找不到命令：git agent.sh”

exec fish                          # Recharger Fish

“无法连接到ollama”

ollama serve                       # Démarrer Ollama

代理商lents

ollama list                        # Vérifier Ollama
top                                # Vérifier charge CPU

帮助不是开始的

cat ~/LLM/aider/aider.conf.yml    # Vérifier config
ollama run qwen3-coder:30b "test" # Tester Ollama
pip install --upgrade aider-chat  # Réinstaller

______________________________________________________________________

📊 替代比较

节省：约240-600美元/年

______________________________________________________________________

🗑️ 卸载

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 :

alias sec='security-agent.sh'
alias review='code-review-agent.sh'
alias fix='debug-agent.sh'
alias githelp='git-agent.sh'

______________________________________________________________________

✅ 清单

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