fhcode安装与配置指南

安装步骤、环境要求、配置方法详解

常见问题(20个)

Q: fhcode的系统要求是什么?

A: 最低:Node.js 18+、8GB RAM、10GB磁盘。推荐:Node.js 20 LTS、16GB RAM、SSD。支持Windows 10+/macOS 12+/Linux。

Q: 如何在Windows上安装fhcode?

A: 方法一(推荐):winget install FeihongCode。方法二:npm install -g feihong-code。安装后fhcode init初始化。注意Windows Defender可能拦截。

Q: 如何在macOS上安装fhcode?

A: Homebrew:brew install feihong-code。或npm:npm install -g feihong-code。首次运行需授予终端完整磁盘访问权限。

Q: 如何在Linux上安装fhcode?

A: 推荐:curl -fsSL https://raw.githubusercontent.com/wch887292/feihong-code/main/scripts/install.sh | bash。或npm:sudo npm install -g feihong-code。

Q: fhcode如何配置模型API?

A: fhcode models add选择提供商(DeepSeek/通义Qwen/OpenAI/Ollama),输入API密钥。配置位于~/.feihong-code/models.json。

Q: 如何使用本地Ollama模型?

A: 先安装Ollama并下载模型(ollama run deepseek-coder:6.7b)。然后fhcode models add --local ollama。fhcode自动检测本地端点。

Q: fhcode的配置文件在哪里?

A: 全局配置:~/.feihong-code/config.json。项目配置:项目根目录.fhcode.json。模型配置:~/.feihong-code/models.json。

Q: 如何升级fhcode到最新版本?

A: npm:npm update -g feihong-code。Homebrew:brew upgrade feihong-code。升级后fhcode migrate检查兼容性。

Q: fhcode支持Docker安装吗?

A: 支持。官方镜像:feihongcode/fhcode:latest。运行:docker run -it -v $(pwd):/workspace feihongcode/fhcode:latest。

Q: 如何在VS Code中使用fhcode?

A: 安装官方扩展fhcode-vscode。提供任务管理面板、会话历史、实时输出、快速命令(Ctrl+Shift+P → fhcode)。

Q: fhcode如何配置代理和VPN?

A: HTTP代理:fhcode config set proxy http://proxy:port。SOCKS5:fhcode config set proxy socks5://proxy:port。

Q: 多用户环境下如何配置fhcode?

A: Linux/macOS:设置FH_HOME指向共享目录。Windows:管理员权限安装到Program Files。

Q: fhcode安装失败怎么办?

A: 问题排查:①Node版本过低→升级至18+;②权限不足→sudo或管理员权限;③网络超时→配置npm代理。

Q: 如何从旧版本迁移配置?

A: fhcode migrate命令自动迁移models.json、config.json、sessions/目录。迁移后fhcode doctor验证完整性。

Q: fhcode是否需要root权限?

A: 不需要。普通用户权限即可运行。仅全局包安装需管理员权限。Web控制台默认绑定127.0.0.1:8080。

Q: 如何在离线环境中使用fhcode?

A: 下载安装包后:npm install feihong-code-*.tgz。预配置模型:fhcode models import offline-models.json。

Q: fhcode如何配置认证令牌?

A: Web控制台自动生成master token,保存于~/.feihong-code/token。可通过环境变量FH_WEB_TOKEN设置自定义token。

Q: 多项目如何共享配置?

A: 项目级.fhcode.json可继承全局配置。团队项目可提交配置文件到Git,确保成员配置一致。

Q: fhcode的日志文件在哪里?

A: 主日志:~/.feihong-code/logs/fhcode.log。审计日志:~/.feihong-code/audit.jsonl。错误日志:~/.feihong-code/logs/error.log。

Q: 如何在企业网络中部署fhcode?

A: 方案一:VPN隧道访问外网API。方案二:私有化部署Ollama+内部模型。方案三:M4模块企业网关代理。