@caoruhua/open-claude-remote 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Anthropic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,449 @@
+# Claude Code Remote
+
+**手机远程掌控 PC 终端的 Claude Code**
+
+在局域网内通过手机浏览器实时查看终端输出、发送指令、审批工具调用——离开工位也能继续工作。
+
+---
+
+## 快速开始 (3 步)
+
+### 0. 镜像配置（国内用户）
+
+国内网络可能较慢，建议先配置淘宝镜像：
+
+```bash
+cp .npmrc.example .npmrc
+```
+
+或手动设置：
+
+```bash
+pnpm config set registry https://registry.npmmirror.com
+```
+
+### 1. 安装
+
+```bash
+git clone <repo-url> claude-code-remote
+cd claude-code-remote
+./install.sh
+```
+
+### 2. 启动
+
+```bash
+claude-remote
+```
+
+### 3. 扫码连接
+
+PC 终端显示 ASCII 二维码 → 手机扫码 → 自动填充 Token → 开始使用
+
+---
+
+## 功能亮点
+
+### 实时终端同步
+- PC 终端完整输出实时同步到手机
+- 支持 ANSI 颜色渲染
+- 10K 行历史记录，重连自动恢复
+- **IP 变化通知**：PC 局域网 IP 变化时自动通知，提供新连接地址
+
+### 快捷按键栏
+- 一键发送 Esc、方向键、Ctrl+C 等
+- 自定义快捷键（在设置中配置）
+- 预设常用命令（/help, /clear 等）
+
+### 多实例管理
+- 启动多个claude-remote
+- 浏览器网页打开，顶部Tab切换无需重新认证
+- 实例掉线自动切换到下一个
+- **Web 创建实例**：通过 UI 创建新实例（点击 Tab 栏的 "+" 按钮，工作目录限制`workspaces`白名单和已启动实例的工作目录）
+- **PC Attach**：`claude-remote attach <port|name>` 接管 web 创建的实例
+
+### Claude Code窗口自适应
+
+**优先级**：WebApp（手机端）> Attach（PC 端）> PC 终端
+
+| 场景 | 窗口控制者 | 说明 |
+|------|-------|------|
+| 无客户端连接 | PC 终端 | 正常本地使用 |
+| 仅 WebApp 连接 | WebApp | 手机端调整窗口大小|
+| 仅 Attach 连接 | Attach | PC 端 attach 接管尺寸 |
+| WebApp + Attach | WebApp | 手机端为主控，PC 端跟随 |
+
+**行为说明**：
+- 当 WebApp 在线时，Attach 客户端的 resize 请求会被忽略
+- Attach 连接后会自动同步 WebApp 设置的尺寸
+- 调整 WebApp 窗口大小，Attach 终端会跟随变化
+
+### 通知提醒
+
+Claude 等待输入时，可通过多种方式收到提醒：
+
+#### Web 推送通知（手机浏览器）
+
+手机浏览器接收实时推送通知，即使切换到其他应用或锁屏也能收到。
+
+**启用步骤**：
+1. 手机浏览器访问 Web UI
+2. 浏览器会自动请求通知权限，点击"允许"
+3. 后台自动完成订阅，无需手动配置
+
+**工作原理**：
+- 浏览器使用 Push API 订阅服务器
+- p256dh 密钥由浏览器自动生成（65 字节 ECDH 公钥）
+- 订阅数据存储在 `~/.claude-remote/push-subscriptions.json`
+
+**故障排查**：
+- 确保浏览器已授予通知权限
+- 清理无效订阅：`rm ~/.claude-remote/push-subscriptions.json`，然后重新访问 Web UI
+
+#### 钉钉群通知
+
+配置钉钉群机器人 Webhook，即使手机不在身边也能收到提醒。
+
+**配置步骤**：
+1. 打开钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 自定义
+2. 安全设置选择"自定义关键词"，添加关键词 `Claude`（消息标题已包含此词）
+3. 复制 Webhook URL
+4. 在 Web UI 设置界面 → 钉钉 Tab 中粘贴，或直接写入配置文件：
+
+```json
+{
+  "dingtalk": {
+    "webhookUrl": "https://oapi.dingtalk.com/robot/send?access_token=your-token"
+  }
+}
+```
+
+### Web UI 设置界面
+- 可视化配置快捷键
+- 命令管理（自动补足 `/` 前缀）
+- 配置即时生效
+
+---
+
+## 常见问题
+
+### 安装失败排查
+
+#### 网络超时/连接失败
+
+配置淘宝镜像：
+
+```bash
+cp .npmrc.example .npmrc
+pnpm install
+```
+
+#### node-pty 编译失败
+
+安装编译工具：
+
+| 系统 | 命令 |
+|------|------|
+| macOS | `xcode-select --install` |
+| Ubuntu/Debian | `sudo apt-get install build-essential python3` |
+| Fedora/RHEL | `sudo dnf groupinstall 'Development Tools'` |
+| Arch Linux | `sudo pacman -S base-devel python` |
+
+#### pnpm 未找到
+
+```bash
+npm install -g pnpm@latest
+# 或使用 corepack
+corepack enable && corepack prepare pnpm@latest --activate
+```
+
+#### 清理缓存后重试
+
+```bash
+pnpm store prune
+rm -rf node_modules pnpm-lock.yaml
+pnpm install
+```
+
+### 找不到 `claude-remote` 命令？
+
+确保已执行 `pnpm link -g`，或使用 `node backend/dist/cli.js` 直接运行。
+
+### 二维码扫不出来？
+
+1. 确保手机和 PC 在同一局域网
+2. 手动访问终端显示的 URL，输入 Token
+
+### 手机无法连接？
+
+1. 检查 PC 防火墙是否放行端口（默认 3000）
+2. 检查终端显示的 URL 是否为正确的局域网 IP
+3. 如果使用 VPN，可能需要配置 `host` 选项（见下方配置说明）
+
+### 如何配置 Hook（审批通知）？
+
+首次启动后执行：
+
+```bash
+./scripts/setup-hooks.sh
+```
+
+Hook 配置详情请参见 [ARCHITECTURE.md#routes](./ARCHITECTURE.md#5-routes)。
+
+---
+
+## 基本用法
+
+```bash
+# 直接运行（等同于 claude）
+claude-remote
+
+# 透传参数
+claude-remote chat
+claude-remote -- --dangerously-skip-permissions
+
+# 自定义选项
+claude-remote --port 8080
+claude-remote --name my-project
+
+# 接管 web 创建的实例
+claude-remote attach 3001        # 按端口
+claude-remote attach my-project  # 按名称
+
+# Web 创建实例（无终端模式）
+claude-remote --no-terminal      # 不启动本地终端，仅提供 Web 界面
+```
+
+### 停止服务
+
+- 单次 Ctrl+C：发送给 Claude Code（取消当前任务）
+- **两次 Ctrl+C（间隔 < 500ms）**：停止代理层
+
+停止所有实例：
+
+```bash
+pnpm stop
+```
+
+---
+
+## 安全
+
+- **Token 认证**：32 字节随机 Token，首次启动生成
+- **Session Cookie**：HttpOnly + SameSite=Lax，24 小时有效
+- **网络隔离**：仅绑定局域网 IP，无公网暴露
+- **速率限制**：认证接口 5 次/分钟/IP
+- **Hook 安全**：仅接受 localhost 请求
+
+---
+
+## 配置文件
+
+配置文件位于 `~/.claude-remote/config.json`。项目根目录提供 `config.example.json` 作为模板：
+
+```bash
+cp config.example.json ~/.claude-remote/config.json
+```
+
+### 完整配置项
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `port` | number | 3000 | 服务监听端口（被占用自动递增） |
+| `host` | string | "0.0.0.0" | 绑定地址 |
+| `token` | string \| null | null | 认证 Token，`null` 自动生成共享 Token |
+| `claudeCommand` | string | "claude" | Claude CLI 命令路径（可用绝对路径） |
+| `claudeArgs` | string[] | [] | Claude CLI 额外参数 |
+| `claudeCwd` | string \| null | null | Claude 工作目录，`null` 使用当前目录 |
+| `sessionTtlMs` | number | 86400000 | Session 有效期（毫秒，默认 24 小时） |
+| `authRateLimit` | number | 20 | 认证速率限制（每分钟每 IP 次数） |
+| `maxBufferLines` | number | 10000 | 输出缓冲区最大行数 |
+| `instanceName` | string \| null | null | 实例名称，`null` 使用工作目录名 |
+| `shortcuts` | array | 见下方 | 快捷输入列表（缺失时 API 返回默认值，不写入文件） |
+| `commands` | array | 见下方 | 自定义命令列表（缺失时 API 返回默认值，不写入文件） |
+| `workspaces` | string[] | [] | 预设工作目录列表（Web 创建实例的白名单） |
+| `dingtalk` | object | - | 钉钉通知配置（见下方） |
+
+**优先级**：CLI 参数 > 配置文件 > 默认值
+
+### 快捷输入 (shortcuts)
+
+快捷输入显示在终端下方的快捷栏，用于快速发送常用按键或文本。
+
+**当配置文件中未定义 `shortcuts` 字段时，API 返回时自动填充以下默认值：**
+
+| 按键 | 数据 | 说明 |
+|------|------|------|
+| Esc | `\u001b` | ESC 键 |
+| Enter | `\r` | 回车键 |
+| Tab | `\t` | Tab 键 |
+| ↑ | `\u001b[A` | 上箭头 |
+| ↓ | `\u001b[B` | 下箭头 |
+| ← | `\u001b[D` | 左箭头 |
+| → | `\u001b[C` | 右箭头 |
+| S-Tab | `\u001b[Z` | Shift+Tab |
+
+**自定义示例：**
+
+```json
+{
+  "shortcuts": [
+    { "label": "确认", "data": "y", "enabled": true, "desc": "确认操作" },
+    { "label": "取消", "data": "\u001b", "enabled": true, "desc": "取消操作 (ESC)" },
+    { "label": "继续", "data": "\r", "enabled": true, "desc": "继续执行 (Enter)" },
+    { "label": "Ctrl+C", "data": "\u0003", "enabled": true, "desc": "中断当前操作" },
+    { "label": "是的", "data": "yes", "enabled": false, "desc": "完整 yes 输入" }
+  ]
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `label` | string | 按钮显示名称 |
+| `data` | string | 发送的数据（支持转义字符如 `\u001b` 表示 ESC） |
+| `enabled` | boolean | 是否启用 |
+| `desc` | string | 描述（可选） |
+
+**常用转义值**：
+- `\u001b` - ESC 键
+- `\r` - Enter 键
+- `\u0003` - Ctrl+C
+- `\u0004` - Ctrl+D
+
+### 自定义命令 (commands)
+
+自定义命令显示在快捷栏的命令区域。
+
+**当配置文件中未定义 `commands` 字段时，API 返回时自动填充以下默认值：**
+
+| 命令 | 说明 |
+|------|------|
+| /clear | 清屏 |
+| /compact | 紧凑对话 |
+| /resume | 恢复会话 |
+| /stats | 统计信息 |
+| /exit | 退出 |
+| /commit-commands:commit | Git 提交 |
+| /feature-dev:feature-dev | 功能开发 |
+| /auto-doc | 自动文档 |
+| /code-review-expert | 代码审查 |
+| /systematic-debugging | 系统调试 |
+
+**自定义示例：**
+
+```json
+{
+  "commands": [
+    { "label": "/help", "command": "/help", "enabled": true, "desc": "帮助说明" },
+    { "label": "/clear", "command": "/clear", "enabled": true },
+    { "label": "Git Status", "command": "git status", "enabled": true, "autoSend": false, "desc": "填入输入框编辑后发送" },
+    { "label": "/feature-dev:feature-dev", "command": "/feature-dev:feature-dev", "enabled": false, "desc": "启动feature-dev SKILL" }
+  ]
+}
+```
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `label` | string | - | 按钮显示名称 |
+| `command` | string | - | 要执行的命令 |
+| `enabled` | boolean | - | 是否启用 |
+| `autoSend` | boolean | `true` | `true`=点击直接发送，`false`=填入输入框 |
+| `desc` | string | - | 描述（可选） |
+
+### 工作区白名单 (workspaces)
+
+配置后，通过 Web 创建实例时只能选择这些目录：
+
+```json
+{
+  "workspaces": [
+    "/Users/tom/projects/api",
+    "/Users/tom/projects/web",
+    "/Users/tom/projects/cli"
+  ]
+}
+```
+
+若未配置，Web 创建实例时只能选择 home 目录下的项目。
+
+### 钉钉通知 (dingtalk)
+
+配置钉钉群机器人 Webhook，当 Claude 需要输入时发送通知到钉钉群：
+
+```json
+{
+  "dingtalk": {
+    "webhookUrl": "https://oapi.dingtalk.com/robot/send?access_token=your-token"
+  }
+}
+```
+
+获取 Webhook URL：
+1. 打开钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 自定义
+2. 安全设置选择"自定义关键词"，添加关键词 `Claude`（消息标题已包含此词）
+3. 复制 Webhook URL 到配置文件
+
+也可以在 Web UI 设置界面中配置（推荐）。
+
+> **注意**：修改钉钉配置后需要重启服务才能生效。
+
+### 完整示例
+
+```json
+{
+  "port": 3000,
+  "host": "0.0.0.0",
+  "token": null,
+
+  "claudeCommand": "claude",
+  "claudeArgs": ["--no-telemetry"],
+  "claudeCwd": null,
+
+  "sessionTtlMs": 86400000,
+  "authRateLimit": 20,
+  "maxBufferLines": 10000,
+  "instanceName": null,
+
+  "shortcuts": [
+    { "label": "确认", "data": "y", "enabled": true },
+    { "label": "取消", "data": "\u001b", "enabled": true },
+    { "label": "继续", "data": "\r", "enabled": true },
+    { "label": "Ctrl+C", "data": "\u0003", "enabled": true }
+  ],
+
+  "commands": [
+    { "label": "Git Status", "command": "git status", "enabled": true },
+    { "label": "Git Log", "command": "git log --oneline -10", "enabled": true }
+  ],
+
+  "workspaces": [
+    "/Users/tom/projects/api",
+    "/Users/tom/projects/web"
+  ]
+}
+```
+
+---
+
+## 前置条件
+
+- Node.js >= 20
+- pnpm >= 9
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) 已安装
+
+---
+
+## 开发者文档
+
+参见 [ARCHITECTURE.md](./ARCHITECTURE.md)，包含：
+- 技术栈详情
+- 架构分层
+- 数据流图
+- API 路由
+- 部署说明
+
+---
+
+## License
+
+MIT

package/dist/api/auth-routes.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import { AuthModule } from '../auth/auth-middleware.js';
+export declare function createAuthRoutes(authModule: AuthModule): Router;
+//# sourceMappingURL=auth-routes.d.ts.map

package/dist/api/auth-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-routes.d.ts","sourceRoot":"","sources":["../../src/api/auth-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAM/D"}

package/dist/api/auth-routes.js

@@ -0,0 +1,7 @@
+import { Router } from 'express';
+export function createAuthRoutes(authModule) {
+    const router = Router();
+    router.post('/auth', authModule.handleAuth);
+    return router;
+}
+//# sourceMappingURL=auth-routes.js.map

package/dist/api/auth-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-routes.js","sourceRoot":"","sources":["../../src/api/auth-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,MAAM,UAAU,gBAAgB,CAAC,UAAsB;IACrD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAE5C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/config-routes.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import { AuthModule } from '../auth/auth-middleware.js';
+export declare function createConfigRoutes(authModule: AuthModule): Router;
+//# sourceMappingURL=config-routes.d.ts.map

package/dist/api/config-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-routes.d.ts","sourceRoot":"","sources":["../../src/api/config-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKjC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA0GxD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA4EjE"}

package/dist/api/config-routes.js

@@ -0,0 +1,180 @@
+import { Router } from 'express';
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createAuthRoutes } from './auth-routes.js';
+import { logger } from '../logger/logger.js';
+import { withFileLockAsync } from '../utils/file-lock.js';
+import { fillDefaultShortcuts, fillDefaultCommands, } from '../config.js';
+const CONFIG_DIR = join(homedir(), '.claude-remote');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const CONFIG_LOCK = CONFIG_FILE + '.lock';
+/**
+ * 验证配置结构
+ */
+function validateConfigStructure(config) {
+    if (!config || typeof config !== 'object')
+        return false;
+    const cfg = config;
+    // 所有字段都是可选的，但如果存在必须类型正确
+    // 服务配置
+    if ('port' in cfg && typeof cfg.port !== 'number')
+        return false;
+    if ('host' in cfg && typeof cfg.host !== 'string')
+        return false;
+    if ('token' in cfg && typeof cfg.token !== 'string')
+        return false;
+    // Claude CLI 配置
+    if ('claudeCommand' in cfg && typeof cfg.claudeCommand !== 'string')
+        return false;
+    if ('claudeCwd' in cfg && typeof cfg.claudeCwd !== 'string')
+        return false;
+    if ('claudeArgs' in cfg && !Array.isArray(cfg.claudeArgs))
+        return false;
+    // 运行时配置
+    if ('sessionTtlMs' in cfg && typeof cfg.sessionTtlMs !== 'number')
+        return false;
+    if ('authRateLimit' in cfg && typeof cfg.authRateLimit !== 'number')
+        return false;
+    if ('maxBufferLines' in cfg && typeof cfg.maxBufferLines !== 'number')
+        return false;
+    if ('instanceName' in cfg && typeof cfg.instanceName !== 'string')
+        return false;
+    // shortcuts 可选，如果存在必须是数组
+    if ('shortcuts' in cfg && cfg.shortcuts !== undefined) {
+        if (!Array.isArray(cfg.shortcuts))
+            return false;
+        for (const item of cfg.shortcuts) {
+            if (!item || typeof item !== 'object')
+                return false;
+            const s = item;
+            if (typeof s.label !== 'string' || typeof s.data !== 'string' || typeof s.enabled !== 'boolean') {
+                return false;
+            }
+            if (s.desc !== undefined && typeof s.desc !== 'string')
+                return false;
+        }
+    }
+    // commands 可选，如果存在必须是数组
+    if ('commands' in cfg && cfg.commands !== undefined) {
+        if (!Array.isArray(cfg.commands))
+            return false;
+        for (const item of cfg.commands) {
+            if (!item || typeof item !== 'object')
+                return false;
+            const c = item;
+            if (typeof c.label !== 'string' || typeof c.command !== 'string' || typeof c.enabled !== 'boolean') {
+                return false;
+            }
+            if (c.desc !== undefined && typeof c.desc !== 'string')
+                return false;
+            if (c.autoSend !== undefined && typeof c.autoSend !== 'boolean')
+                return false;
+        }
+    }
+    // dingtalk 可选，如果存在必须是对象且包含 webhookUrl
+    if ('dingtalk' in cfg && cfg.dingtalk !== undefined) {
+        if (typeof cfg.dingtalk !== 'object' || cfg.dingtalk === null)
+            return false;
+        const dt = cfg.dingtalk;
+        if (typeof dt.webhookUrl !== 'string')
+            return false;
+    }
+    return true;
+}
+/**
+ * 读取用户配置文件
+ */
+async function loadUserConfig() {
+    try {
+        if (!existsSync(CONFIG_FILE)) {
+            return null;
+        }
+        const content = await readFile(CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        logger.error({ error, path: CONFIG_FILE }, 'Failed to load user config');
+        return null;
+    }
+}
+/**
+ * 保存配置文件
+ */
+async function saveUserConfig(config) {
+    // 确保目录存在
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    // 直接写入文件
+    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+export function createConfigRoutes(authModule) {
+    const router = Router();
+    // 复用 auth 路由以支持测试认证
+    router.use(createAuthRoutes(authModule));
+    /**
+     * GET /api/config - 获取用户配置
+     */
+    router.get('/config', authModule.requireAuth.bind(authModule), async (req, res) => {
+        try {
+            const config = await loadUserConfig();
+            if (!config) {
+                // 配置文件不存在，返回 null 让前端使用自己的默认值
+                res.json({ config: null, configPath: CONFIG_FILE });
+                return;
+            }
+            // 懒填充默认值（不持久化，仅返回时填充）
+            // 好处：配置文件保持精简，默认值更新时用户自动受益
+            let filledConfig = config;
+            if (!config.shortcuts) {
+                filledConfig = fillDefaultShortcuts(filledConfig);
+            }
+            if (!config.commands) {
+                filledConfig = fillDefaultCommands(filledConfig);
+            }
+            // 安全处理：不暴露完整 webhook URL，只返回是否已配置
+            const { token: _, dingtalk: dtConfig, ...safeConfig } = filledConfig;
+            const responseConfig = {
+                ...safeConfig,
+                dingtalk: {
+                    configured: !!(dtConfig?.webhookUrl),
+                },
+            };
+            res.json({ config: responseConfig, configPath: CONFIG_FILE });
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to get config');
+            res.status(500).json({ error: 'Failed to load config' });
+        }
+    });
+    /**
+     * PUT /api/config - 更新用户配置
+     */
+    router.put('/config', authModule.requireAuth.bind(authModule), async (req, res) => {
+        try {
+            const newConfig = req.body;
+            // 验证配置结构
+            if (!validateConfigStructure(newConfig)) {
+                res.status(400).json({ error: 'Invalid config structure' });
+                return;
+            }
+            // 文件锁保护 read-modify-write，防止与其他模块并发写入冲突
+            await withFileLockAsync(CONFIG_LOCK, async () => {
+                // 合并现有配置和新配置（前端可能只发送部分字段）
+                const existingConfig = await loadUserConfig();
+                const mergedConfig = { ...existingConfig, ...newConfig };
+                await saveUserConfig(mergedConfig);
+            });
+            logger.info({ configPath: CONFIG_FILE }, 'User config updated');
+            res.json({ success: true, configPath: CONFIG_FILE });
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to update config');
+            res.status(500).json({ error: 'Failed to save config' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=config-routes.js.map

package/dist/api/config-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-routes.js","sourceRoot":"","sources":["../../src/api/config-routes.ts"],"names":[],"mappings":"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"}