Bladeren bron

docs: 完成install.sh和README.md的完整汉化

- 更新install.sh仓库地址和所有中文提示
- 重写README.md为完整中文版本
- 添加"汉化工作正在进行中"声明
Jarvis 2 maanden geleden
bovenliggende
commit
4a91a58264
2 gewijzigde bestanden met toevoegingen van 149 en 149 verwijderingen
  1. 130 130
      README.md
  2. 19 19
      install.sh

+ 130 - 130
README.md

@@ -4,238 +4,238 @@
 
 本项目是 [free-code](https://github.com/paoloanzn/free-code) 的汉化分支,致力于为中文用户提供更好的使用体验。
 
-- 完整的汉化界面与文档
-- 移除了所有遥测和回拨
-- 移除了安全提示限制
-- 解锁所有实验性功能
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/go-enols/Claude-CN/main/install.sh | bash
-```
-
-> 自动检测系统、安装 Bun(如需要)、克隆代码库、构建并启用所有功能,然后将其添加到 PATH 中。只需运行 `export ANTHROPIC_API_KEY="sk-ant-..."` 即可使用。
-
-<p align="center">
-  <img src="assets/screenshot.png" alt="free-code screenshot" width="800" />
-</p>
+> **⚠️ 汉化工作正在进行中** - 部分界面和文档正在逐步汉化,如有问题欢迎提交Issue。
 
 ---
 
-## What is this
-
-This is a clean, buildable fork of Anthropic's [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI -- the terminal-native AI coding agent. The upstream source became publicly available on March 31, 2026 through a source map exposure in the npm distribution.
-
-This fork applies three categories of changes on top of that snapshot:
+## 特性
 
-### 1. Telemetry removed
-
-The upstream binary phones home through OpenTelemetry/gRPC, GrowthBook analytics, Sentry error reporting, and custom event logging. In this build:
-
-- All outbound telemetry endpoints are dead-code-eliminated or stubbed
-- GrowthBook feature flag evaluation still works locally (needed for runtime feature gates) but does not report back
-- No crash reports, no usage analytics, no session fingerprinting
-
-### 2. Security-prompt guardrails removed
-
-Anthropic injects system-level instructions into every conversation that constrain Claude's behavior beyond what the model itself enforces. These include:
-
-- Hardcoded refusal patterns for certain categories of prompts
-- Injected "cyber risk" instruction blocks
-- Managed-settings security overlays pushed from Anthropic's servers
-
-This build strips those injections. The model's own safety training still applies -- this just removes the extra layer of prompt-level restrictions that the CLI wraps around it.
-
-### 3. Experimental features enabled
-
-Claude Code ships with dozens of feature flags gated behind `bun:bundle` compile-time switches. Most are disabled in the public npm release. This build unlocks all 45+ flags that compile cleanly, including:
-
-| Feature | What it does |
-|---|---|
-| `ULTRAPLAN` | Remote multi-agent planning on Claude Code web (Opus-class) |
-| `ULTRATHINK` | Deep thinking mode -- type "ultrathink" to boost reasoning effort |
-| `VOICE_MODE` | Push-to-talk voice input and dictation |
-| `AGENT_TRIGGERS` | Local cron/trigger tools for background automation |
-| `BRIDGE_MODE` | IDE remote-control bridge (VS Code, JetBrains) |
-| `TOKEN_BUDGET` | Token budget tracking and usage warnings |
-| `BUILTIN_EXPLORE_PLAN_AGENTS` | Built-in explore/plan agent presets |
-| `VERIFICATION_AGENT` | Verification agent for task validation |
-| `BASH_CLASSIFIER` | Classifier-assisted bash permission decisions |
-| `EXTRACT_MEMORIES` | Post-query automatic memory extraction |
-| `HISTORY_PICKER` | Interactive prompt history picker |
-| `MESSAGE_ACTIONS` | Message action entrypoints in the UI |
-| `QUICK_SEARCH` | Prompt quick-search |
-| `SHOT_STATS` | Shot-distribution stats |
-| `COMPACTION_REMINDERS` | Smart reminders around context compaction |
-| `CACHED_MICROCOMPACT` | Cached microcompact state through query flows |
-
-See [FEATURES.md](FEATURES.md) for the full audit of all 88 flags and their status.
+- 完整的汉化界面与文档
+- 移除了所有遥测和回拨
+- 移除了安全提示限制
+- 解锁所有实验性功能
 
 ---
 
-## Quick install
+## 快速安装
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/go-enols/Claude-CN/main/install.sh | bash
 ```
 
-This will check your system, install Bun if needed, clone the repo, build the binary with all experimental features enabled, and symlink it as `free-code` on your PATH.
+此脚本将自动检测系统、安装 Bun(如需要)、克隆代码库、构建并启用所有功能,然后将其添加到 PATH 中。
 
-After install, just run:
+安装完成后,运行以下命令启动:
 ```bash
 export ANTHROPIC_API_KEY="sk-ant-..."
-free-code
+claude-cn
 ```
 
 ---
 
-## Requirements
+## 系统要求
 
 - [Bun](https://bun.sh) >= 1.3.11
-- macOS or Linux (Windows via WSL)
-- An Anthropic API key (set `ANTHROPIC_API_KEY` in your environment)
+- macOS 或 Linux(Windows 通过 WSL)
+- Anthropic API 密钥(在环境变量中设置 `ANTHROPIC_API_KEY`)
 
 ```bash
-# Install Bun if you don't have it
+# 如果没有安装 Bun
 curl -fsSL https://bun.sh/install | bash
 ```
 
 ---
 
-## Build
+## 手动构建
 
 ```bash
-# Clone the repo
+# 克隆仓库
 git clone https://github.com/go-enols/Claude-CN.git
-cd claude-code
+cd Claude-CN
 
-# Install dependencies
+# 安装依赖
 bun install
 
-# Standard build -- produces ./cli
+# 标准构建 -- 生成 ./cli
 bun run build
 
-# Dev build -- dev version stamp, experimental GrowthBook key
+# 开发构建 -- 开发版本标识
 bun run build:dev
 
-# Dev build with ALL experimental features enabled -- produces ./cli-dev
+# 启用所有实验性功能的开发构建 -- 生成 ./cli-dev
 bun run build:dev:full
 
-# Compiled build (alternative output path) -- produces ./dist/cli
+# 编译构建(备用输出路径)-- 生成 ./dist/cli
 bun run compile
 ```
 
-### Build variants
+### 构建变体
 
-| Command | Output | Features | Notes |
+| 命令 | 输出 | 功能 | 说明 |
 |---|---|---|---|
-| `bun run build` | `./cli` | `VOICE_MODE` only | Production-like binary |
-| `bun run build:dev` | `./cli-dev` | `VOICE_MODE` only | Dev version stamp |
-| `bun run build:dev:full` | `./cli-dev` | All 45+ experimental flags | The full unlock build |
-| `bun run compile` | `./dist/cli` | `VOICE_MODE` only | Alternative output directory |
+| `bun run build` | `./cli` | 仅 `VOICE_MODE` | 生产级二进制文件 |
+| `bun run build:dev` | `./cli-dev` | 仅 `VOICE_MODE` | 开发版本标识 |
+| `bun run build:dev:full` | `./cli-dev` | 所有45+实验性标志 | 完整解锁构建 |
+| `bun run compile` | `./dist/cli` | 仅 `VOICE_MODE` | 备用输出目录 |
 
-### Individual feature flags
+### 单独启用功能标志
 
-You can enable specific flags without the full bundle:
+您可以在不完全打包的情况下启用特定标志:
 
 ```bash
-# Enable just ultraplan and ultrathink
+# 仅启用 ultraplan 和 ultrathink
 bun run ./scripts/build.ts --feature=ULTRAPLAN --feature=ULTRATHINK
 
-# Enable a specific flag on top of the dev build
+# 在开发构建基础上启用特定标志
 bun run ./scripts/build.ts --dev --feature=BRIDGE_MODE
 ```
 
 ---
 
-## Run
+## 运行
 
 ```bash
-# Run the built binary directly
+# 直接运行构建的二进制文件
 ./cli
 
-# Or the dev binary
+# 或运行开发二进制文件
 ./cli-dev
 
-# Or run from source without compiling (slower startup)
+# 或从源码运行(启动较慢)
 bun run dev
 
-# Set your API key
+# 设置 API 密钥
 export ANTHROPIC_API_KEY="sk-ant-..."
 
-# Or use Claude.ai OAuth
+# 或使用 Claude.ai OAuth 登录
 ./cli /login
 ```
 
-### Quick test
+### 快速测试
 
 ```bash
-# One-shot mode
-./cli -p "what files are in this directory?"
+# 单次执行模式
+./cli -p "当前目录下有哪些文件?"
 
-# Interactive REPL (default)
+# 交互式 REPL(默认)
 ./cli
 
-# With specific model
+# 使用指定模型
 ./cli --model claude-sonnet-4-6-20250514
 ```
 
 ---
 
-## Project structure
+## 核心改动
+
+本项目在原始代码基础上应用了三类改动:
+
+### 1. 移除遥测
+
+上游二进制文件通过 OpenTelemetry/gRPC、GrowthBook 分析、Sentry 错误报告和自定义事件日志向外部发送数据。本构建中:
+
+- 所有出站遥测端点均被消除或存根
+- GrowthBook 功能标志评估仍在本地工作(用于运行时功能门控),但不回报
+- 无崩溃报告、无使用分析、无会话指纹
+
+### 2. 移除安全提示限制
+
+Anthropic 在每次对话中注入系统级指令,超出模型本身的约束,包括:
+
+- 某些类别提示的硬编码拒绝模式
+- 注入的"网络风险"指令块
+- 从 Anthropic 服务器推送的托管设置安全覆盖
+
+本构建剥离了这些注入。模型本身的安全训练仍然适用——这只是移除了 CLI 围绕它的额外提示级限制层。
+
+### 3. 启用实验性功能
+
+Claude Code 附带数十个通过 `bun:bundle` 编译时开关门控的功能标志。本构建解锁了所有能正常编译的 45+ 个标志,包括:
+
+| 功能标志 | 说明 |
+|---|---|
+| `ULTRAPLAN` | Claude Code 网页上的远程多智能体规划(Opus级别) |
+| `ULTRATHINK` | 深度思考模式 - 输入"ultrathink"提升推理努力 |
+| `VOICE_MODE` | 按键通话语音输入和听写 |
+| `AGENT_TRIGGERS` | 后台自动化本地 cron/触发器工具 |
+| `BRIDGE_MODE` | IDE 远程控制桥(VS Code、JetBrains) |
+| `TOKEN_BUDGET` | Token 预算跟踪和使用警告 |
+| `BUILTIN_EXPLORE_PLAN_AGENTS` | 内置探索/规划智能体预设 |
+| `VERIFICATION_AGENT` | 任务验证智能体 |
+| `BASH_CLASSIFIER` | 分类器辅助的 bash 权限决策 |
+| `EXTRACT_MEMORIES` | 查询后自动记忆提取 |
+| `HISTORY_PICKER` | 交互式提示历史选择器 |
+| `MESSAGE_ACTIONS` | UI 中的消息操作入口点 |
+| `QUICK_SEARCH` | 提示快速搜索 |
+| `SHOT_STATS` | Shot分布统计 |
+| `COMPACTION_REMINDERS` | 上下文压缩周围的智能提醒 |
+| `CACHED_MICROCOMPACT` | 通过查询流程的缓存微压缩状态 |
+
+完整的功能标志审计请参阅 [FEATURES.md](FEATURES.md)。
+
+---
+
+## 项目结构
 
 ```
 scripts/
-  build.ts              # Build script with feature flag system
+  build.ts              # 构建脚本与功能标志系统
 
 src/
-  entrypoints/cli.tsx   # CLI entrypoint
-  commands.ts           # Command registry (slash commands)
-  tools.ts              # Tool registry (agent tools)
-  QueryEngine.ts        # LLM query engine
-  screens/REPL.tsx      # Main interactive UI
-
-  commands/             # /slash command implementations
-  tools/                # Agent tool implementations (Bash, Read, Edit, etc.)
-  components/           # Ink/React terminal UI components
+  entrypoints/cli.tsx   # CLI 入口点
+  commands.ts           # 命令注册表(斜杠命令)
+  tools.ts              # 工具注册表(智能体工具)
+  QueryEngine.ts        # LLM 查询引擎
+  screens/REPL.tsx      # 主交互式 UI
+
+  commands/             # /斜杠命令实现
+  tools/                # 智能体工具实现(Bash、Read、Edit 等)
+  components/           # Ink/React 终端 UI 组件
   hooks/                # React hooks
-  services/             # API client, MCP, OAuth, analytics
-  state/                # App state store
-  utils/                # Utilities
-  skills/               # Skill system
-  plugins/              # Plugin system
-  bridge/               # IDE bridge
-  voice/                # Voice input
-  tasks/                # Background task management
+  services/             # API 客户端、MCP、OAuth、分析
+  state/                # 应用状态存储
+  utils/                # 工具函数
+  skills/               # 技能系统
+  plugins/              # 插件系统
+  bridge/               # IDE 桥接
+  voice/                # 语音输入
+  tasks/                # 后台任务管理
 ```
 
 ---
 
-## Tech stack
+## 技术栈
 
 | | |
 |---|---|
-| Runtime | [Bun](https://bun.sh) |
-| Language | TypeScript |
-| Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) |
-| CLI parsing | [Commander.js](https://github.com/tj/commander.js) |
-| Schema validation | Zod v4 |
-| Code search | ripgrep (bundled) |
-| Protocols | MCP, LSP |
+| 运行时 | [Bun](https://bun.sh) |
+| 语言 | TypeScript |
+| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
+| CLI 解析 | [Commander.js](https://github.com/tj/commander.js) |
+| Schema 验证 | Zod v4 |
+| 代码搜索 | ripgrep(已打包) |
+| 协议 | MCP、LSP |
 | API | Anthropic Messages API |
 
 ---
 
-## IPFS Mirror
+## IPFS 镜像
 
-A full copy of this repository is permanently pinned on IPFS via Filecoin:
+此仓库的完整副本通过 Filecoin 永久固定在 IPFS 上:
 
 - **CID:** `bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm`
 - **Gateway:** https://w3s.link/ipfs/bafybeiegvef3dt24n2znnnmzcud2vxat7y7rl5ikz7y7yoglxappim54bm
 
-If this repo gets taken down, the code lives on.
+如果此仓库被删除,代码将永远存在。
+
+---
+
+## 许可证
+
+原始 Claude Code 源代码是 Anthropic 的财产。此分支的存在是因为源代码通过其 npm 分发中的源映射暴露而公开可用。自行决定使用。
 
 ---
 
-## License
+## 参与贡献
 
-The original Claude Code source is the property of Anthropic. This fork exists because the source was publicly exposed through their npm distribution. Use at your own discretion.
+汉化工作正在进行中,欢迎提交 PR 和 Issue!

+ 19 - 19
install.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-# free-code installer
-# Usage: curl -fsSL https://raw.githubusercontent.com/paoloanzn/free-code/main/install.sh | bash
+# Claude-CN Installer (Claude汉化版安装脚本)
+# Usage: curl -fsSL https://raw.githubusercontent.com/go-enols/Claude-CN/main/install.sh | bash
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'
@@ -12,8 +12,8 @@ BOLD='\033[1m'
 DIM='\033[2m'
 RESET='\033[0m'
 
-REPO="https://github.com/paoloanzn/free-code.git"
-INSTALL_DIR="$HOME/free-code"
+REPO="https://github.com/go-enols/Claude-CN.git"
+INSTALL_DIR="$HOME/claude-cn"
 BUN_MIN_VERSION="1.3.11"
 
 info()  { printf "${CYAN}[*]${RESET} %s\n" "$*"; }
@@ -33,7 +33,7 @@ header() {
 
 ART
   printf "${RESET}"
-  printf "${DIM}  The free build of Claude Code${RESET}\n"
+  printf "${DIM}  Claude Code 汉化中文版本${RESET}\n"
   echo ""
 }
 
@@ -120,18 +120,18 @@ install_deps() {
 }
 
 build_binary() {
-  info "Building free-code (all experimental features enabled)..."
+  info "正在构建 Claude-CN (启用所有实验性功能)..."
   cd "$INSTALL_DIR"
   bun run build:dev:full
-  ok "Binary built: $INSTALL_DIR/cli-dev"
+  ok "构建完成: $INSTALL_DIR/cli-dev"
 }
 
 link_binary() {
   local link_dir="$HOME/.local/bin"
   mkdir -p "$link_dir"
 
-  ln -sf "$INSTALL_DIR/cli-dev" "$link_dir/free-code"
-  ok "Symlinked: $link_dir/free-code"
+  ln -sf "$INSTALL_DIR/cli-dev" "$link_dir/claude-cn"
+  ok "Symlinked: $link_dir/claude-cn"
 
   if ! echo "$PATH" | tr ':' '\n' | grep -qx "$link_dir"; then
     warn "$link_dir is not on your PATH"
@@ -161,19 +161,19 @@ build_binary
 link_binary
 
 echo ""
-printf "${GREEN}${BOLD}  Installation complete!${RESET}\n"
+printf "${GREEN}${BOLD}  安装完成!${RESET}\n"
 echo ""
-printf "  ${BOLD}Run it:${RESET}\n"
-printf "    ${CYAN}free-code${RESET}                          # interactive REPL\n"
-printf "    ${CYAN}free-code -p \"your prompt\"${RESET}          # one-shot mode\n"
+printf "  ${BOLD}运行方式:${RESET}\n"
+printf "    ${CYAN}claude-cn${RESET}                          # 交互式REPL模式\n"
+printf "    ${CYAN}claude-cn -p \"你的提示词\"${RESET}            # 单次执行模式\n"
 echo ""
-printf "  ${BOLD}Set your API key:${RESET}\n"
+printf "  ${BOLD}设置API密钥:${RESET}\n"
 printf "    ${CYAN}export ANTHROPIC_API_KEY=\"sk-ant-...\"${RESET}\n"
 echo ""
-printf "  ${BOLD}Or log in with Claude.ai:${RESET}\n"
-printf "    ${CYAN}free-code /login${RESET}\n"
+printf "  ${BOLD}或使用Claude.ai OAuth登录:${RESET}\n"
+printf "    ${CYAN}claude-cn /login${RESET}\n"
 echo ""
-printf "  ${DIM}Source: $INSTALL_DIR${RESET}\n"
-printf "  ${DIM}Binary: $INSTALL_DIR/cli-dev${RESET}\n"
-printf "  ${DIM}Link:   ~/.local/bin/free-code${RESET}\n"
+printf "  ${DIM}源码目录: $INSTALL_DIR${RESET}\n"
+printf "  ${DIM}二进制文件: $INSTALL_DIR/cli-dev${RESET}\n"
+printf "  ${DIM}快捷命令: ~/.local/bin/claude-cn${RESET}\n"
 echo ""