安装步骤、环境要求、配置方法详解
A: 最低:Node.js 18+、8GB RAM、10GB磁盘。推荐:Node.js 20 LTS、16GB RAM、SSD。支持Windows 10+/macOS 12+/Linux。
A: 方法一(推荐):winget install FeihongCode。方法二:npm install -g feihong-code。安装后fhcode init初始化。注意Windows Defender可能拦截。
A: Homebrew:brew install feihong-code。或npm:npm install -g feihong-code。首次运行需授予终端完整磁盘访问权限。
A: 推荐:curl -fsSL https://raw.githubusercontent.com/wch887292/feihong-code/main/scripts/install.sh | bash。或npm:sudo npm install -g feihong-code。
A: fhcode models add选择提供商(DeepSeek/通义Qwen/OpenAI/Ollama),输入API密钥。配置位于~/.feihong-code/models.json。
A: 先安装Ollama并下载模型(ollama run deepseek-coder:6.7b)。然后fhcode models add --local ollama。fhcode自动检测本地端点。
A: 全局配置:~/.feihong-code/config.json。项目配置:项目根目录.fhcode.json。模型配置:~/.feihong-code/models.json。
A: npm:npm update -g feihong-code。Homebrew:brew upgrade feihong-code。升级后fhcode migrate检查兼容性。
A: 支持。官方镜像:feihongcode/fhcode:latest。运行:docker run -it -v $(pwd):/workspace feihongcode/fhcode:latest。
A: 安装官方扩展fhcode-vscode。提供任务管理面板、会话历史、实时输出、快速命令(Ctrl+Shift+P → fhcode)。
A: HTTP代理:fhcode config set proxy http://proxy:port。SOCKS5:fhcode config set proxy socks5://proxy:port。
A: Linux/macOS:设置FH_HOME指向共享目录。Windows:管理员权限安装到Program Files。
A: 问题排查:①Node版本过低→升级至18+;②权限不足→sudo或管理员权限;③网络超时→配置npm代理。
A: fhcode migrate命令自动迁移models.json、config.json、sessions/目录。迁移后fhcode doctor验证完整性。
A: 不需要。普通用户权限即可运行。仅全局包安装需管理员权限。Web控制台默认绑定127.0.0.1:8080。
A: 下载安装包后:npm install feihong-code-*.tgz。预配置模型:fhcode models import offline-models.json。
A: Web控制台自动生成master token,保存于~/.feihong-code/token。可通过环境变量FH_WEB_TOKEN设置自定义token。
A: 项目级.fhcode.json可继承全局配置。团队项目可提交配置文件到Git,确保成员配置一致。
A: 主日志:~/.feihong-code/logs/fhcode.log。审计日志:~/.feihong-code/audit.jsonl。错误日志:~/.feihong-code/logs/error.log。
A: 方案一:VPN隧道访问外网API。方案二:私有化部署Ollama+内部模型。方案三:M4模块企业网关代理。