Files

cc-dan c2adab4340 feat: model config system with settings.json integration

- Add local/custom mode switching for API configuration
- Custom mode patches ~/.claude/settings.json env section before spawn
- Strip ANTHROPIC_* from child process env for clean config isolation
- Add spawn-time model name validation against MODEL_MAP
- Move template config fields to modal dialog for cleaner UI
- Show warning when custom templates may overwrite local API config

2026-03-10 13:15:27 +00:00

4.8 KiB

Raw Blame History

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 与自动触发，避免补发重复提示消息。

4.8 KiB Raw Blame History Unescape Escape