thatgfsj-code 0.2.1

package/dist/utils/project-context.js

@@ -0,0 +1,197 @@
+/**
+ * Project Context - Auto-detect and read project files
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { join, relative } from 'path';
+export class ProjectContext {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    /**
+     * Detect project type and gather context
+     */
+    async detect() {
+        const info = {
+            root: this.root,
+            name: this.getProjectName(),
+            language: this.detectLanguage(),
+            buildTool: this.detectBuildTool(),
+            gitIgnore: this.readGitIgnore(),
+            files: this.listFiles(),
+            hasGit: existsSync(join(this.root, '.git'))
+        };
+        const pkg = this.readPackageJson();
+        if (pkg) {
+            info.packageJson = pkg;
+        }
+        return info;
+    }
+    /**
+     * Get project name
+     */
+    getProjectName() {
+        const pkg = this.readPackageJson();
+        if (pkg?.name) {
+            return pkg.name;
+        }
+        return this.root.split(/[\\/]/).pop() || 'unknown';
+    }
+    /**
+     * Detect primary language
+     */
+    detectLanguage() {
+        const langCounts = {};
+        const scan = (dir, depth = 0) => {
+            if (depth > 3)
+                return;
+            try {
+                const items = readdirSync(dir);
+                for (const item of items) {
+                    if (['node_modules', '.git', 'dist'].includes(item))
+                        continue;
+                    const fullPath = join(dir, item);
+                    try {
+                        const stat = statSync(fullPath);
+                        if (stat.isDirectory()) {
+                            scan(fullPath, depth + 1);
+                        }
+                        else if (stat.isFile()) {
+                            const ext = item.split('.').pop()?.toLowerCase();
+                            if (ext)
+                                langCounts[ext] = (langCounts[ext] || 0) + 1;
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+            }
+            catch { /* skip */ }
+        };
+        scan(this.root);
+        const extToLang = {
+            'ts': 'TypeScript', 'tsx': 'TypeScript',
+            'js': 'JavaScript', 'jsx': 'JavaScript', 'mjs': 'JavaScript',
+            'py': 'Python', 'java': 'Java', 'go': 'Go', 'rs': 'Rust',
+            'c': 'C/C++', 'cpp': 'C/C++', 'h': 'C/C++', 'hpp': 'C/C++',
+            'cs': 'C#', 'rb': 'Ruby', 'php': 'PHP',
+        };
+        for (const [ext, count] of Object.entries(langCounts)) {
+            const lang = extToLang[ext];
+            if (lang && count > 0)
+                return lang;
+        }
+        return 'Unknown';
+    }
+    /**
+     * Detect build tool
+     */
+    detectBuildTool() {
+        if (existsSync(join(this.root, 'package.json')))
+            return 'npm/yarn/pnpm';
+        if (existsSync(join(this.root, 'Cargo.toml')))
+            return 'Cargo';
+        if (existsSync(join(this.root, 'go.mod')))
+            return 'Go';
+        if (existsSync(join(this.root, 'pom.xml')))
+            return 'Maven';
+        if (existsSync(join(this.root, 'build.gradle')))
+            return 'Gradle';
+        if (existsSync(join(this.root, 'Makefile')))
+            return 'Make';
+        return undefined;
+    }
+    /**
+     * Read .gitignore
+     */
+    readGitIgnore() {
+        const path = join(this.root, '.gitignore');
+        if (!existsSync(path))
+            return [];
+        try {
+            return readFileSync(path, 'utf-8').split('\n')
+                .map(l => l.trim()).filter(l => l && !l.startsWith('#'));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Read package.json
+     */
+    readPackageJson() {
+        const path = join(this.root, 'package.json');
+        if (!existsSync(path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List project files
+     */
+    listFiles(maxFiles = 100) {
+        const files = [];
+        const gitIgnore = this.readGitIgnore();
+        const scan = (dir, depth = 0) => {
+            if (depth > 4 || files.length >= maxFiles)
+                return;
+            try {
+                const items = readdirSync(dir);
+                for (const item of items) {
+                    if (files.length >= maxFiles)
+                        break;
+                    if (this.isIgnored(item, gitIgnore))
+                        continue;
+                    const fullPath = join(dir, item);
+                    const relPath = relative(this.root, fullPath);
+                    try {
+                        const stat = statSync(fullPath);
+                        if (stat.isDirectory()) {
+                            files.push(relPath + '/');
+                            scan(fullPath, depth + 1);
+                        }
+                        else if (stat.isFile()) {
+                            files.push(relPath);
+                        }
+                    }
+                    catch { /* skip */ }
+                }
+            }
+            catch { /* skip */ }
+        };
+        scan(this.root);
+        return files;
+    }
+    /**
+     * Check if ignored
+     */
+    isIgnored(name, gitIgnore) {
+        const common = ['node_modules', '.git', 'dist', 'build', '__pycache__', '.env'];
+        if (common.includes(name))
+            return true;
+        return gitIgnore.includes(name);
+    }
+    /**
+     * Get context summary
+     */
+    async getContextSummary() {
+        const info = await this.detect();
+        const lines = [`📁 Project: ${info.name}`, `💻 Language: ${info.language}`];
+        if (info.buildTool)
+            lines.push(`🔧 Build: ${info.buildTool}`);
+        if (info.hasGit)
+            lines.push(`📊 Git: Yes`);
+        if (info.packageJson) {
+            lines.push(`📦 Package: ${info.packageJson.name}@${info.packageJson.version}`);
+            if (info.packageJson.scripts) {
+                lines.push(`   Scripts: ${Object.keys(info.packageJson.scripts).slice(0, 5).join(', ')}`);
+            }
+        }
+        lines.push(`📁 Files: ${info.files.length} files scanned`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=project-context.js.map

package/dist/utils/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/utils/project-context.ts"],"names":[],"mappings":"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"}

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