Delete CLAUDE.md

2026-03-10 21:20:35 +08:00
parent c2adab4340
commit e1be33c0ec
1 changed files with 0 additions and 97 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,97 +0,0 @@
-# CC-Web
-
-Claude Code Web Chat UI - 轻量级 Web 聊天界面，通过 WebSocket 与 Claude Code CLI 交互。
-
-## 目录与发布约定
-
- 开发与运行目录固定为：`/home/cc-dan/cc/cc-web`
- 当前提交 GitHub 的脱敏目录为：`/home/cc-dan/cc/cc-web_v1.2.3`
- 脱敏目录命名规则：`/home/cc-dan/cc/cc-web_v<主版本>.<次版本>.<修订版本>`
- 版本发布时，必须保持以下信息一致：
-  1. 脱敏目录实际名称（如 `cc-web_v1.2.3`）
-  2. 本文件中的“当前提交 GitHub 的脱敏目录”路径
-  3. `/home/cc-dan/cc/项目清单.md` 中 CC-Web 的发布副本路径
-  4. 脱敏目录 `README.md` 的“更新记录”版本号与说明
- 标准发布流程：
-  1. 先在开发目录完成修改并验证
-  2. 将变更同步到脱敏目录并完成脱敏处理
-  3. 如版本升级，先重命名脱敏目录，再同步更新上述 4 处版本信息
-  4. 在脱敏目录提交并上传 GitHub
- GitHub 鉴权使用用户提供的临时 token（有效期 30 天）；出于安全考虑，不在仓库文件中保存明文 token
-
-## 架构
-
- `server.js`: Node.js 后端 (HTTP 静态文件 + WebSocket + Claude 进程管理)
- `public/`: 前端 (原生 HTML/CSS/JS，无构建步骤)
- `sessions/`: JSON 格式对话历史 + 运行时 `-run` 目录
- `logs/process.log`: 进程生命周期日志
-
-## 关键设计
-
- 每条消息 spawn `claude -p --output-format stream-json --verbose --dangerously-skip-permissions`
- 使用 `--resume SESSION_ID` 实现会话续接
- 用户输入通过 stdin 传入（防注入）
- spawn 时删除 CLAUDECODE 环境变量（避免嵌套检测）
- 密码认证 + token 会话
- **Detached 进程**: `detached: true` + `proc.unref()`，Claude 进程独立于 Node.js
- **文件 I/O**: stdin/stdout/stderr 走文件（`sessions/{id}-run/`），不走 pipe
- **PID 持久化**: PID 写入 `sessions/{id}-run/pid`，服务重启后通过 `recoverProcesses()` 恢复
- **systemd KillMode=process**: 服务重启只杀 Node.js，不杀 Claude 子进程
-
-## 进程生命周期日志
-
-日志文件: `logs/process.log`（JSONL 格式，自动轮转 2MB）
-
-记录事件:
-| 事件 | 说明 |
-|------|------|
-| `server_start` | 服务启动 |
-| `ws_connect` / `ws_disconnect` | WebSocket 连接/断开，含影响的活跃进程列表 |
-| `process_spawn` | 进程创建（PID、模式、模型、参数） |
-| `process_exit_event` | 进程退出（exitCode、signal） |
-| `process_complete` | 进程完成处理（含 wsConnected、wsDisconnectTime、disconnectToDeathGap、stderr 摘要） |
-| `pid_monitor_detected_exit` | PID 监控发现进程已退出（服务重启后场景） |
-| `user_abort` | 用户主动停止 |
-| `process_spawn_fail` | 进程启动失败 |
-| `recovery_start/alive/dead` | 启动时恢复进程 |
-| `ws_resume_attach` | 客户端重连并挂载到运行中的进程 |
-| `heartbeat` | 每 60 秒活跃进程状态快照 |
-
-关键诊断字段（`process_complete` 事件）:
- `wsDisconnectTime`: WS 断开时间
- `disconnectToDeathGap`: WS 断开到进程结束的时间差
- `exitCode` / `signal`: 退出码和信号（0=正常，非0/SIGTERM/SIGKILL=异常）
- `stderr`: 错误日志末尾 500 字符
-
-查看日志: `cat logs/process.log | jq .` 或 `tail -f logs/process.log | jq .`
-
-## 端口
-
- 本地监听: 127.0.0.1:8002
- 外部访问: https://cc.02370237.xyz (Nginx 反向代理)
-
-## 模型配置系统
-
-配置文件: `config/model.json`
-
-支持两种模式（通过设置面板切换）：
-
-| 模式 | 说明 |
-|------|------|
-| `local` | 依赖 `~/.claude/settings.json` 已有配置（由 cc-switch-web 等工具管理），仅从中读取模型名称更新 MODEL_MAP |
-| `custom` | 使用命名模板，spawn 前将模板凭据写入 `~/.claude/settings.json` 的 `env` 字段 |
-
-关键实现：
- **配置优先级**：Claude CLI 读取 `~/.claude/settings.json` > 环境变量 > `~/.claude.json`
- `applyModelConfig()` 仅更新 MODEL_MAP 模型名称映射（不写环境变量）
- **spawn 环境隔离**：子进程 env 中删除所有 `ANTHROPIC_*` 变量，让 CLI 直接读取 `~/.claude/settings.json`
- **custom 模式 spawn**：将模板的 apiKey/apiBase/model 写入 `~/.claude/settings.json` 的 `env` 字段，保留非 API 相关字段（如 `API_TIMEOUT_MS`）
- **模型验证**：spawn 时检查 `session.model` 是否在当前 `MODEL_MAP` 值中，无效则不传 `--model` 参数
- API Key 脱敏：前4后4，中间 `****`
- 保存时若 API Key 含 `****` 则保留旧值（防止脱敏值覆盖真实密钥）
- **前端**：模板配置字段通过弹窗编辑（点击"编辑"按钮），local 模式显示覆盖警告
- WS 消息：`get_model_config` → `model_config`；`save_model_config` → `model_config` + `system_message`
-
-## /compact 修复记录
-
-`pendingCompactRetries` 新增 `reason` 字段（`'normal'` | `'auto'`），区分用户手动 `/compact` 与自动触发，避免补发重复提示消息。