feat: 添加初始项目结构和基础文件

- 添加 Rust GUI 桌面应用程序入口点 - 添加 TypeScript/JavaScript 项目基础结构文件 - 包含组件、工具、命令、服务和工具定义 - 添加配置文件如 .gitignore、.gitattributes 和 LICENSE - 包含图片资源和演示文件 - 为各种功能模块添加占位符和类型定义
2026-04-20 16:58:22 +08:00
commit 1a1254f045
2376 changed files with 585447 additions and 0 deletions
@@ -0,0 +1,215 @@
+# Claude Code Rust 安装指南
+
+本指南将帮助您通过命令行安装和配置 Claude Code Rust 版本。
+
+## 系统要求
+
+- **Rust**：需要安装 Rust 1.70 或更高版本
+- **Git**：需要安装 Git 用于克隆仓库
+- **操作系统**：支持 Windows、Linux、macOS
+
+## 安装步骤
+
+### 1. 克隆仓库
+
+```bash
+git clone https://github.com/lorryjovens-hub/claude-code-rust
+cd claude-code-rust
+```
+
+### 2. 运行安装脚本
+
+#### Windows (PowerShell)
+
+**默认安装（临时目录）：**
+```powershell
+# 使用 PowerShell 运行以下命令
+Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
+.\scripts\install-windows.ps1
+```
+
+**安装到D盘：**
+```powershell
+# 使用 PowerShell 运行以下命令
+Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
+.\scripts\install-windows.ps1 -InstallDir "D:\claude-code\install"
+```
+
+#### Linux / macOS (Bash)
+
+**默认安装：**
+```bash
+# 使用 Bash 运行以下命令
+chmod +x ./scripts/install-linux.sh
+./scripts/install-linux.sh
+```
+
+**指定安装目录：**
+```bash
+# 使用 Bash 运行以下命令
+chmod +x ./scripts/install-linux.sh
+./scripts/install-linux.sh --install-dir "/path/to/install"
+```
+
+### 3. 手动安装（可选）
+
+如果安装脚本出现问题，您可以手动安装：
+
+#### 构建项目
+```bash
+cargo build --release
+```
+
+#### 安装到系统
+
+##### Windows
+```powershell
+# 创建安装目录
+$installDir = "$env:USERPROFILE\.claude-code\bin"
+New-Item -ItemType Directory -Path $installDir -Force
+
+# 复制可执行文件
+Copy-Item ".\target\release\claude-code.exe" "$installDir\claude-code.exe"
+
+# 添加到 PATH
+$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+if (-not $currentPath.Contains($installDir)) {
+    [Environment]::SetEnvironmentVariable("PATH", "$currentPath;$installDir", "User")
+}
+```
+
+##### Linux / macOS
+```bash
+# 创建安装目录
+mkdir -p ~/.claude-code/bin
+
+# 复制可执行文件
+cp ./target/release/claude-code ~/.claude-code/bin/
+chmod +x ~/.claude-code/bin/claude-code
+
+# 添加到 PATH
+echo "export PATH=\"$HOME/.claude-code/bin:\$PATH\"" >> ~/.bashrc
+# 或对于 zsh
+# echo "export PATH=\"$HOME/.claude-code/bin:\$PATH\"" >> ~/.zshrc
+```
+
+## 配置
+
+### 设置 API 密钥
+
+```bash
+# 设置 API 密钥
+claude-code config set api_key "your-api-key"
+
+# 设置 API 基础 URL
+claude-code config set base_url "https://api.deepseek.com"
+
+# 设置模型
+claude-code config set model "deepseek-reasoner"
+```
+
+### 验证配置
+
+```bash
+claude-code config list
+```
+
+## 测试安装
+
+```bash
+# 测试基本功能
+claude-code query --prompt "Hello!"
+
+# 启动交互模式
+claude-code repl
+
+# 查看帮助信息
+claude-code --help
+```
+
+## 升级
+
+### 通过安装脚本升级
+
+重新运行安装脚本即可自动升级到最新版本：
+
+#### Windows
+```powershell
+.\scripts\install-windows.ps1
+```
+
+#### Linux / macOS
+```bash
+./scripts/install-linux.sh
+```
+
+### 手动升级
+
+```bash
+cd claude-code-rust
+git pull
+cargo build --release
+# 然后重新复制可执行文件到安装目录
+```
+
+## 卸载
+
+### Windows
+
+```powershell
+# 删除安装目录
+Remove-Item -Path "$env:USERPROFILE\.claude-code" -Recurse -Force
+
+# 从 PATH 中移除
+$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+$newPath = $currentPath -replace "$env:USERPROFILE\\.claude-code\\bin;?", ""
+[Environment]::SetEnvironmentVariable("PATH", $newPath, "User")
+
+# 删除配置目录
+Remove-Item -Path "$env:USERPROFILE\.config\claude-code" -Recurse -Force
+```
+
+### Linux / macOS
+
+```bash
+# 删除安装目录
+rm -rf ~/.claude-code
+
+# 从 PATH 中移除
+# 编辑 ~/.bashrc 或 ~/.zshrc 文件，删除包含 "~/.claude-code/bin" 的行
+
+# 删除配置目录
+rm -rf ~/.config/claude-code
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **Rust 未安装**
+   - 访问 https://rustup.rs/ 安装 Rust
+
+2. **Git 未安装**
+   - Windows: 访问 https://git-scm.com/ 安装 Git
+   - Linux: 使用包管理器安装 (e.g., `apt install git`)
+   - macOS: 使用 Homebrew 安装 (`brew install git`)
+
+3. **API 密钥配置错误**
+   - 确保使用正确的 API 密钥格式
+   - 确保 API 密钥具有足够的权限
+
+4. **PATH 配置问题**
+   - 安装后重启终端
+   - 手动检查 PATH 环境变量是否包含安装目录
+
+### 查看日志
+
+```bash
+# 设置详细日志
+RUST_LOG=claude_code=debug claude-code query --prompt "Hello!"
+```
+
+## 联系方式
+
+如果您遇到任何问题，请在 GitHub 仓库中创建 issue：
+https://github.com/lorryjovens-hub/claude-code-rust/issues