🤖 mini_bot

# 安裝 pyenv 並設定 Python 3.11.9
brew install pyenv
pyenv install 3.11.9
pyenv local 3.11.9

# 確認版本
python3 --version

# 安裝 zsh（推薦）與必備工具
sudo apt update && sudo apt install -y zsh curl wget git python3 python3-pip python3-venv

# 設定 Python 3.11
sudo apt install -y python3.11 python3.11-venv python3.11-dev
pyenv install 3.11.9
pyenv local 3.11.9

# 確認版本
python3 --version

# 安裝 Oh My Zsh（可選 but 推薦）
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# 推薦外掛：歷史搜尋 + 自動補全
# 在 ~/.zshrc 中添加以下內容（需在 source $ZSH/oh-my-zsh.sh 之前）：
plugins=(git z sudo history-substring-search)

# 歷史記錄與自動補全配置（添加在 source $ZSH/oh-my-zsh.sh 之前）
HISTSIZE=10000
SAVEHIST=10000
setopt SHARE_HISTORY
setopt HIST_IGNORE_ALL_DUPS
setopt HIST_FIND_NO_DUPS
autoload -Uz compinit
compinit

# 安裝 minibot (開發模式)
# Linux/macOS/WSL
python3 -m pip install -e .

# Windows (PowerShell 7)
python -m pip install -e .

# 初始化設定資料夾 (~/.minibot)
# 如果是第一次執行，請先手動建立資料夾並複製設定
# Linux/macOS/WSL
mkdir -p ~/.minibot
cp config.example.json ~/.minibot/config.json

# Windows (PowerShell 7)
New-Item -ItemType Directory -Force -Path ~/.minibot
Copy-Item config.example.json ~/.minibot/config.json

# 執行系統初始化 (建立 workspace 等)
minibot onboard

# 編輯 API Key (支援開源模型或各大 Provider)
# macOS 使用 open -e, Linux/WSL 使用 nano/vim/code
code ~/.minibot/config.json
# 或
nano ~/.minibot/config.json

# Windows 使用 notepad 或 code
notepad $HOME/.minibot/config.json
# 或
code $HOME/.minibot/config.json

# 初始化 Workspace 範本
# Linux/macOS/WSL
cp workspace/AGENTS.md.example workspace/AGENTS.md
mkdir -p workspace/memory
cp workspace/memory/MEMORY.md.example workspace/memory/MEMORY.md

# Windows (PowerShell 7)
Copy-Item workspace/AGENTS.md.example workspace/AGENTS.md
New-Item -ItemType Directory -Force -Path workspace/memory
Copy-Item workspace/memory/MEMORY.md.example workspace/memory/MEMORY.md

# 啟動 CLI 互動模式
minibot agent

# 或是直接下指令
minibot agent -m "你好，請幫我列出目前目錄下的檔案"

# 查看系統狀態與設定
minibot status

# 顯示所有設定值（除錯用）
minibot config-show

# 英文（預設）
export MINIBOT_LOCALE=en

# 繁體中文
export MINIBOT_LOCALE=zh_TW

# 簡體中文
export MINIBOT_LOCALE=zh_CN

# 執行單元測試
python -m pytest tests/ -v

# 測試 i18n 切換
python -c "from minibot.i18n import t, set_locale, init; init(); print('EN:', t('cli.agent.welcome', version='1.0')); set_locale('zh_TW'); print('TW:', t('cli.agent.welcome', version='1.0'))"

# Linux/macOS/WSL
minibot telegram

# Windows (PowerShell 7)
minibot telegram

# 統計總行數 (Linux/macOS)
find minibot -name "*.py" -type f | xargs wc -l | tail -1

# 列出各檔案行數排行榜
find minibot -name "*.py" -type f -exec wc -l {} + | sort -rn | head -20