thatgfsj-code 0.3.0

package/docs/API_KEY_GUIDE.md

@@ -0,0 +1,236 @@
+# API Key 获取教程
+
+Thatgfsj Code 支持多种 AI 提供商，以下是各提供商 API Key 的获取教程。
+
+## 目录
+
+1. [SiliconFlow (推荐)](#1-siliconflow-推荐)
+2. [MiniMax](#2-minimax)
+3. [OpenAI](#3-openai)
+4. [Anthropic (Claude)](#4-anthropic-claude)
+5. [Google Gemini](#5-google-gemini)
+6. [Kimi (Moonshot AI)](#6-kimi-moonshot-ai)
+7. [DeepSeek](#7-deepseek)
+8. [文心一言 (ERNIE)](#8-文心一言-ernie)
+9. [Ollama (本地模型)](#9-ollama-本地模型)
+
+---
+
+## 1. SiliconFlow (推荐)
+
+**官网**: https://siliconflow.cn
+
+### 步骤
+
+1. 访问 [SiliconFlow](https://siliconflow.cn) 并注册账号
+2. 完成实名认证（可选，部分模型需要）
+3. 进入「API 密钥」页面
+4. 点击「创建新密钥」
+5. 复制生成的 API Key
+
+### 特点
+
+- ✅ 国产模型，性价比高
+- ✅ 支持 Qwen、Kimi、DeepSeek、GLM 等
+- ✅ 免费额度：¥8.8（新用户）
+
+---
+
+## 2. MiniMax
+
+**官网**: https://platform.minimax.io
+
+### 步骤
+
+1. 访问 [MiniMax](https://platform.minimax.io) 并注册账号
+2. 进入「API 密钥」页面
+3. 点击「创建 API Key」
+4. 复制生成的密钥
+
+### 特点
+
+- ✅ Moonshot Kimi 系列模型
+- ✅ Agent 能力强
+
+---
+
+## 3. OpenAI
+
+**官网**: https://platform.openai.com
+
+### 步骤
+
+1. 访问 [OpenAI](https://platform.openai.com) 并注册账号
+2. 进入「API Keys」页面
+3. 点击「Create new secret key」
+4. 复制生成的密钥
+
+### 特点
+
+- ⚠️ 需要海外支付方式
+- ✅ GPT-4o 系列最强模型
+
+---
+
+## 4. Anthropic (Claude)
+
+**官网**: https://www.anthropic.com
+
+### 步骤
+
+1. 访问 [Anthropic](https://www.anthropic.com) 并注册账号
+2. 进入「API Keys」页面
+3. 点击「Create Key」
+4. 复制生成的密钥
+
+### 特点
+
+- ⚠️ 需要海外支付方式
+- ✅ Claude 系列模型能力强
+
+---
+
+## 5. Google Gemini
+
+**官网**: https://aistudio.google.com/app/apikey
+
+### 步骤
+
+1. 访问 [Google AI Studio](https://aistudio.google.com/app/apikey)
+2. 点击「Create API Key」
+3. 选择已有项目或创建新项目
+4. 复制生成的密钥
+
+### 特点
+
+- ✅ 免费额度充足
+- ✅ Gemini 模型能力强
+
+---
+
+## 6. Kimi (Moonshot AI)
+
+**官网**: https://platform.moonshot.cn
+
+### 步骤
+
+1. 访问 [Moonshot AI](https://platform.moonshot.cn) 并注册账号
+2. 进入「API 密钥管理」页面
+3. 点击「创建」
+4. 复制生成的密钥
+
+### 特点
+
+- ✅ 国产模型
+- ✅ 长上下文能力强
+
+---
+
+## 7. DeepSeek
+
+**官网**: https://platform.deepseek.com
+
+### 步骤
+
+1. 访问 [DeepSeek](https://platform.deepseek.com) 并注册账号
+2. 进入「API Keys」页面
+3. 点击「创建 API Key」
+4. 复制生成的密钥
+
+### 特点
+
+- ✅ 性价比高
+- ✅ 编程能力强
+
+---
+
+## 8. 文心一言 (ERNIE)
+
+**官网**: https://login.bce.baidu.com
+
+### 步骤
+
+1. 访问 [百度智能云](https://login.bce.baidu.com) 并注册账号
+2. 进入「文心一言 API」产品页
+3. 创建应用并获取 API Key 和 Secret Key
+4. 使用 Secret Key 获取 Access Token
+
+### 特点
+
+- ✅ 百度 ERNIE 系列
+- ⚠️ 配置稍复杂
+
+---
+
+## 9. Ollama (本地模型)
+
+**官网**: https://ollama.com
+
+### 步骤
+
+1. 下载并安装 [Ollama](https://ollama.com)
+2. 终端运行 `ollama run llama2`
+3. 设置环境变量 `OLLAMA_BASE_URL=http://localhost:11434`
+
+### 特点
+
+- ✅ 完全免费
+- ✅ 本地运行，保护隐私
+- ⚠️ 需要本地有足够配置
+
+---
+
+## 环境变量设置
+
+获取 API Key 后，设置方式：
+
+```bash
+# SiliconFlow
+export SILICONFLOW_API_KEY=你的密钥
+
+# MiniMax
+export MINIMAX_API_KEY=你的密钥
+
+# OpenAI
+export OPENAI_API_KEY=你的密钥
+
+# Anthropic
+export ANTHROPIC_API_KEY=你的密钥
+
+# Google Gemini
+export GEMINI_API_KEY=你的密钥
+
+# Kimi
+export KIMI_API_KEY=你的密钥
+
+# DeepSeek
+export DEEPSEEK_API_KEY=你的密钥
+
+# Ollama
+export OLLAMA_BASE_URL=http://localhost:11434
+```
+
+或者运行 `gfcode init` 交互式配置。
+
+---
+
+## 常见问题
+
+### Q: 哪个 Provider 最推荐？
+
+**A**: SiliconFlow 性价比最高，适合新手入门。
+
+### Q: 为什么我的 API Key 不工作？
+
+**A**: 
+1. 检查环境变量是否正确设置
+2. 确认 API Key 没有过期
+3. 查看账户是否有足够余额
+
+### Q: 可以同时使用多个 Provider 吗？
+
+**A**: 可以，通过配置文件或环境变量切换。
+
+---
+
+如有问题，请提交 Issue: https://github.com/Thatgfsj/thatgfsj-code/issues

package/docs/FAQ.md

@@ -0,0 +1,182 @@
+# 常见问题 FAQ
+
+## 目录
+
+1. [安装问题](#1-安装问题)
+2. [配置问题](#2-配置问题)
+3. [使用问题](#3-使用问题)
+4. [ Provider 问题](#4-provider-问题)
+5. [其他问题](#5-其他问题)
+
+---
+
+## 1. 安装问题
+
+### Q: npm install 失败怎么办？
+
+**A**: 
+- 确保 Node.js 版本 >= 18
+- 尝试清除缓存: `npm cache clean --force`
+- 如果是 Windows 问题，尝试使用 PowerShell 或管理员权限
+
+### Q: npm link 后命令找不到？
+
+**A**:
+- 检查 PATH 环境变量是否包含 npm 全局路径
+- Windows 上通常是: `C:\Users\你的用户名\AppData\Roaming\npm`
+- 或者直接使用 `npx gfcode` 运行
+
+---
+
+## 2. 配置问题
+
+### Q: 如何配置 API Key？
+
+**A**: 两种方式：
+1. 交互式配置（推荐）：运行 `gfcode init`
+2. 环境变量：设置对应的环境变量
+
+### Q: 配置文件在哪里？
+
+**A**: `~/.thatgfsj/config.json`（用户主目录下的 .thatgfsj 文件夹）
+
+### Q: 配置文件格式？
+
+```json
+{
+  "model": "Qwen/Qwen2.5-7B-Instruct",
+  "apiKey": "your_api_key",
+  "provider": "siliconflow",
+  "temperature": 0.7,
+  "maxTokens": 4096
+}
+```
+
+---
+
+## 3. 使用问题
+
+### Q: 交互模式怎么用？
+
+**A**:
+```bash
+# 启动交互模式
+gfcode
+
+# 在交互模式中
+> 帮我写一个函数
+> 解释这段代码
+> /help 查看命令
+> /exit 退出
+```
+
+### Q: 如何解释代码？
+
+**A**:
+```bash
+# 直接解释代码
+gfcode explain "const add = (a, b) => a + b;"
+
+# 从文件解释
+gfcode explain -f src/utils.ts
+```
+
+### Q: 如何调试代码？
+
+**A**:
+```bash
+# 直接调试代码
+gfcode debug "你的代码"
+
+# 带错误信息调试
+gfcode debug -f app.js -e "TypeError: undefined"
+```
+
+### Q: 如何生成代码模板？
+
+**A**:
+```bash
+# React 组件
+gfcode template react -n MyButton
+
+# Express API
+gfcode template express -n my-api
+
+# Python 脚本
+gfcode template python -n scraper
+```
+
+---
+
+## 4. Provider 问题
+
+### Q: 哪个 Provider 最推荐？
+
+**A**: 
+- 新手推荐 **SiliconFlow**，性价比高，支持国产模型
+- 想用 GPT 推荐 **OpenAI**
+- 想用 Claude 推荐 **Anthropic**
+- 想免费用推荐 **Google Gemini**
+
+### Q: API Key 在哪里获取？
+
+**A**: 见 [API Key 获取教程](./API_KEY_GUIDE.md)
+
+### Q: Provider 切换需要重新配置吗？
+
+**A**: 
+- 如果用环境变量，直接改环境变量即可
+- 如果用配置文件，修改配置文件的 `provider` 和 `model` 字段
+
+### Q: 遇到 "API Key 无效" 错误？
+
+**A**:
+1. 检查 API Key 是否正确
+2. 检查环境变量是否设置正确
+3. 检查账户是否有足够余额
+4. 确认 API Key 没有过期
+
+---
+
+## 5. 其他问题
+
+### Q: 如何查看当前版本？
+
+```bash
+gfcode --version
+```
+
+### Q: 如何更新到最新版本？
+
+```bash
+git pull
+npm install
+npm run build
+```
+
+### Q: 遇到其他错误怎么办？
+
+**A**:
+1. 查看错误信息
+2. 尝试 Google 搜索错误
+3. 提交 Issue: https://github.com/Thatgfsj/thatgfsj-code/issues
+
+### Q: 如何贡献代码？
+
+**A**:
+1. Fork 仓库
+2. 创建分支: `git checkout -b feature/your-feature`
+3. 提交修改: `git commit -m 'Add something'`
+4. 推送分支: `git push origin feature/your-feature`
+5. 创建 Pull Request
+
+---
+
+## 联系方式
+
+- GitHub Issues: https://github.com/Thatgfsj/thatgfsj-code/issues
+- 欢迎提交 Bug 和功能请求！
+
+---
+
+如有更多问题，请提交 Issue。

package/install.bat

@@ -0,0 +1,63 @@
+@echo off
+chcp 65001 >nul
+title Thatgfsj Code 安装向导
+echo.
+echo   Thatgfsj Code 一键安装
+echo   =====================
+echo.
+
+echo [*] 检查环境...
+echo.
+
+:: Check PowerShell
+powershell -Version >nul 2>&1
+if %errorlevel% neq 0 (
+    echo [错误] 需要 PowerShell，请升级: https://aka.ms/powershell
+    pause
+    exit /b 1
+)
+echo [OK] PowerShell 已就绪
+
+:: Check Node.js
+for /f "delims=" %%i in ('powershell -Command "node --version 2^>nul"') do set NODE_VERSION=%%i
+if defined NODE_VERSION (
+    echo [OK] Node.js %NODE_VERSION% 已安装
+) else (
+    echo.
+    echo [!] 未检测到 Node.js，开始自动安装...
+    echo.
+    
+    :: Try winget
+    where winget >nul 2>&1
+    if %errorlevel% equ 0 (
+        echo [*] 正在通过 winget 安装 Node.js...
+        winget install OpenJS.NodeJS.LTS --source winget --accept-package-agreements --accept-source-agreements
+        echo.
+        echo [OK] Node.js 安装完成
+        echo [!] 请重新打开一个 CMD 然后再次运行此脚本
+        pause
+        exit /b 0
+    )
+    
+    :: Fallback: manual download
+    echo [*] 正在下载 Node.js 安装包...
+    powershell -Command "Start-Process 'https://nodejs.org/' -Verb Open"
+    echo.
+    echo [!] 请手动安装 Node.js LTS 版本
+    echo [!] 安装完成后，重新运行此脚本
+    pause
+    exit /b 0
+)
+
+:: Download install.ps1
+echo.
+echo [*] 正在下载安装程序...
+powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/Thatgfsj/thatgfsj-code/main/install.ps1' -OutFile '%TEMP%\thatgfsj_install.ps1'"
+
+echo.
+echo [*] 启动安装向导...
+echo.
+powershell -ExecutionPolicy Bypass -File "%TEMP%\thatgfsj_install.ps1"
+
+echo.
+pause

package/install.ps1

@@ -0,0 +1,238 @@
+# Thatgfsj Code Installer for Windows
+# Usage: 
+#   powershell -c "irm https://raw.githubusercontent.com/Thatgfsj/thatgfsj-code/main/install.ps1 | iex"
+#   powershell -c "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Thatgfsj/thatgfsj-code/main/install.ps1)))"
+
+param(
+    [switch]$NoOpen,
+    [switch]$DryRun
+)
+
+$ErrorActionPreference = "Stop"
+
+# Colors
+function Write-Step { param($msg) Write-Host "[*] $msg" -ForegroundColor Yellow }
+function Write-Success { param($msg) Write-Host "[✓] $msg" -ForegroundColor Green }
+function Write-Error { param($msg) Write-Host "[✗] $msg" -ForegroundColor Red }
+function Write-Info { param($msg) Write-Host "    $msg" -ForegroundColor Gray }
+
+Write-Host ""
+Write-Host "  Thatgfsj Code 安装向导" -ForegroundColor Cyan
+Write-Host "  =======================" -ForegroundColor Cyan
+Write-Host ""
+
+if ($DryRun) {
+    Write-Host "[DRY RUN] 仅显示将要执行的操作" -ForegroundColor Yellow
+    Write-Host ""
+}
+
+# ============== Step 1: Check PowerShell ==============
+Write-Step "检查 PowerShell 版本..."
+
+if ($PSVersionTable.PSVersion.Major -lt 5) {
+    Write-Error "需要 PowerShell 5.0 或更高版本"
+    Write-Host "请升级您的 PowerShell: https://aka.ms/powershell" -ForegroundColor Gray
+    exit 1
+}
+Write-Success "PowerShell $($PSVersionTable.PSVersion) 检测正常"
+
+# ============== Step 2: Check/Fetch Node.js ==============
+Write-Step "检查 Node.js..."
+
+function Test-NodeInstalled {
+    try {
+        $nodeVersion = node --version 2>$null
+        if ($nodeVersion) {
+            $version = [int]($nodeVersion -replace 'v(\d+)\..*', '$1')
+            return @{ installed = $true; version = $nodeVersion; major = $version }
+        }
+    } catch {}
+    return @{ installed = $false; version = $null; major = 0 }
+}
+
+$nodeStatus = Test-NodeInstalled
+if ($nodeStatus.installed -and $nodeStatus.major -ge 18) {
+    Write-Success "Node.js $($nodeStatus.version) 已安装"
+} else {
+    Write-Host "    未检测到 Node.js 18+，开始安装..." -ForegroundColor Gray
+    
+    # Try winget first
+    if (Get-Command winget -ErrorAction SilentlyContinue) {
+        Write-Info "使用 winget 安装..."
+        winget install OpenJS.NodeJS.LTS --source winget --accept-package-agreements --accept-source-agreements
+        
+        # Refresh PATH
+        $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+        
+        $nodeStatus = Test-NodeInstalled
+        if ($nodeStatus.installed) {
+            Write-Success "Node.js 安装完成"
+        } else {
+            Write-Host "    需要重启 PowerShell 后重新运行安装" -ForegroundColor Yellow
+            exit 0
+        }
+    }
+    # Try choco
+    elseif (Get-Command choco -ErrorAction SilentlyContinue) {
+        Write-Info "使用 Chocolatey 安装..."
+        choco install nodejs-lts -y
+        Write-Success "Node.js 安装完成 (可能需要重启)"
+    }
+    # Manual fallback
+    else {
+        Write-Host ""
+        Write-Error "未检测到包管理器 (winget/choco/scoop)"
+        Write-Host ""
+        Write-Host "请手动安装 Node.js:" -ForegroundColor Yellow
+        Write-Host "  1. 访问 https://nodejs.org" -ForegroundColor Gray
+        Write-Host "  2. 下载 LTS 版本 (推荐 v20 或 v22)" -ForegroundColor Gray
+        Write-Host "  3. 运行安装程序" -ForegroundColor Gray
+        Write-Host "  4. 重新运行此安装脚本" -ForegroundColor Gray
+        Write-Host ""
+        exit 1
+    }
+}
+
+# ============== Step 3: Clone/Update Repository ==============
+Write-Step "准备安装 Thatgfsj Code..."
+
+$installDir = Join-Path $env:USERPROFILE "thatgfsj-code"
+
+if (Test-Path $installDir) {
+    Write-Info "检测到已有安装，正在更新..."
+    if (-not $DryRun) {
+        Set-Location $installDir
+        git pull origin main 2>$null
+        if ($LASTEXITCODE -ne 0) {
+            # If pull fails, re-clone
+            Remove-Item $installDir -Recurse -Force
+        }
+    }
+} else {
+    if (-not $DryRun) {
+        Write-Info "正在克隆仓库..."
+        git clone https://github.com/Thatgfsj/thatgfsj-code.git $installDir
+        Set-Location $installDir
+    }
+}
+
+if (-not (Test-Path (Join-Path $installDir "package.json"))) {
+    Write-Error "安装目录无效: $installDir"
+    exit 1
+}
+
+Write-Success "代码准备完成: $installDir"
+
+# ============== Step 4: Install Dependencies ==============
+Write-Step "安装依赖..."
+
+if (-not $DryRun) {
+    Set-Location $installDir
+    npm install
+    if ($LASTEXITCODE -ne 0) {
+        Write-Error "npm install 失败"
+        exit 1
+    }
+    
+    Write-Info "编译 TypeScript..."
+    npm run build
+    if ($LASTEXITCODE -ne 0) {
+        Write-Error "编译失败"
+        exit 1
+    }
+}
+Write-Success "依赖安装完成"
+
+# ============== Step 5: Link Command ==============
+Write-Step "设置命令..."
+
+if (-not $DryRun) {
+    npm link
+}
+Write-Success "命令 'gfcode' 已可用"
+
+# ============== Step 6: Setup API Key ==============
+Write-Host ""
+Write-Step "配置 API Key (可选)..."
+
+$apiKeySet = $false
+$providers = @{
+    "1" = @{name="SiliconFlow (推荐)"; var="SILICONFLOW_API_KEY"; url="https://siliconflow.cn"}
+    "2" = @{name="MiniMax"; var="MINIMAX_API_KEY"; url="https://platform.minimax.io"}
+    "3" = @{name="OpenAI"; var="OPENAI_API_KEY"; url="https://platform.openai.com"}
+    "4" = @{name="Anthropic"; var="ANTHROPIC_API_KEY"; url="https://www.anthropic.com"}
+    "5" = @{name="Google Gemini"; var="GEMINI_API_KEY"; url="https://aistudio.google.com/app/apikey"}
+    "6" = @{name="跳过 (稍后配置)"; var=""; url=""}
+}
+
+Write-Host ""
+Write-Host "    选择 AI Provider:" -ForegroundColor White
+Write-Host ""
+foreach ($key in $providers.Keys | Sort-Object) {
+    $p = $providers[$key]
+    Write-Host "    $key. $($p.name)" -ForegroundColor Gray
+}
+Write-Host ""
+
+if ($NoOpen) {
+    Write-Host "    使用 --NoOpen 跳过配置" -ForegroundColor Gray
+} else {
+    $choice = Read-Host "    请选择 (1-6, 直接回车跳过)"
+    
+    if ($choice -and $providers.ContainsKey($choice)) {
+        $selected = $providers[$choice]
+        if ($selected.var) {
+            Write-Host ""
+            Write-Host "    访问 $($selected.url) 获取 API Key" -ForegroundColor Cyan
+            Write-Host "    获取后粘贴到下方" -ForegroundColor Gray
+            Write-Host ""
+            
+            $key = Read-Host "    请输入 API Key (输入后回车)"
+            
+            if ($key) {
+                # Save to config file
+                $configDir = Join-Path $env:USERPROFILE ".thatgfsj"
+                if (-not (Test-Path $configDir)) {
+                    New-Item -ItemType Directory -Path $configDir -Force | Out-Null
+                }
+                
+                $configFile = Join-Path $configDir "config.json"
+                $config = @{
+                    model = "Qwen/Qwen2.5-7B-Instruct"
+                    apiKey = $key
+                    provider = "siliconflow"
+                    temperature = 0.7
+                    maxTokens = 4096
+                }
+                
+                # Set provider-specific defaults
+                switch ($choice) {
+                    "1" { $config.provider = "siliconflow"; $config.model = "Qwen/Qwen2.5-7B-Instruct" }
+                    "2" { $config.provider = "minimax"; $config.model = "MiniMax-M2.5" }
+                    "3" { $config.provider = "openai"; $config.model = "gpt-4o-mini" }
+                    "4" { $config.provider = "anthropic"; $config.model = "claude-3-haiku-20240307" }
+                    "5" { $config.provider = "gemini"; $config.model = "gemini-1.5-flash-8b" }
+                }
+                
+                $config | ConvertTo-Json | Set-Content $configFile -Encoding UTF8
+                Write-Success "配置已保存到: $configFile"
+            }
+        }
+    }
+}
+
+# ============== Done ==============
+Write-Host ""
+Write-Host "  ======================================" -ForegroundColor Cyan
+Write-Success "  安装完成!"
+Write-Host "  ======================================" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "  使用方法:" -ForegroundColor White
+Write-Host "    gfcode init          - 重新配置" -ForegroundColor Gray
+Write-Host "    gfcode               - 启动交互模式" -ForegroundColor Gray
+Write-Host "    gfcode '你的问题'    - 直接提问" -ForegroundColor Gray
+Write-Host "    gfcode explain '代码' - 解释代码" -ForegroundColor Gray
+Write-Host "    gfcode debug '代码'   - 调试代码" -ForegroundColor Gray
+Write-Host ""
+Write-Host "  文档: https://github.com/Thatgfsj/thatgfsj-code" -ForegroundColor Gray
+Write-Host ""