使用说明

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

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

🆕 用作Git存储库

克隆或初始化

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

配置链接和文件夹
```
bash bootstrap.sh
exec fish
```

安装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

测试员la pile MCP

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

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

什么时候使用什么？

需要	鱼函数	代理
快速问题	✅ `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工具。

使用

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

📊 替代比较

	你的设置	Copilot	ChatGPT	Cursor
成本免费	$10/月	$20/月
韦特里斯	3-15s	瞬间	10-30s	5-20s
私人	✅ 100%	❌ 云	❌ 云	❌ 云
上下文	262K	~8K	128K	~128K
离线	✅	❌	❌	❌

节省：约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