LP Studio — AI skill for Claude Code

LP Studio — 多模型 CLI 桌面助手

本地优先的 **Windows 桌面应用**，不是需要部署的网站。Electron 打包 Chromium 和 Node 运行时，双击 EXE 即可使用；生产版从本机加载 UI，没有 Web 服务或浏览器登录入口。


导航与主题

左侧图标只切换第三栏：工作台显示对话，会话页浏览与搜索当前项目的历史，模型页管理 CLI/API 连接，终端页输入命令，设置页管理外观与本地数据。项目栏和文件预览保持独立，不会被导航弹窗遮挡；执行命令和应用文件修改仍保留操作确认，由跟随主题的应用弹窗展示。

页面切换带有 180ms 淡入与轻微位移动画，遵循系统“减少动画”设置。切换页面保留未发送的对话/命令草稿、未保存的模型表单和后台任务；这些草稿只在当前窗口内保留，刷新或关闭不会保存。Ctrl+L 返回之前的对话或命令输入框。

点击左下角 **设置 → 外观主题**：

• 午夜深蓝：保留原有深色工作区。
• 工业浅色：浅灰白面板、深色终端、青绿选中标记和橙色操作按钮。

主题立即应用并在当前应用配置中保存，重新打开仍生效；Monaco 代码预览与 diff 同步切换明暗配色。开发模式和便携 EXE 使用各自的数据目录，主题选择也分别保存。


UI 页面、布局与配色分别维护：`apps/ui/src/Settings.tsx`、`Sessions.tsx`、`Models.tsx` 为页面组件，`workspace.css` 为中央工作区布局与动画，`theme.ts` 和 `themes.css` 为主题声明、存储与配色；这些修改不涉及 Provider 和桌面 IPC。

启动

• 已打包版本：双击 release/win-unpacked/LP Studio.exe。
• 开发版：安装 Node.js 22.12+（本项目验证环境为 Node 24），在项目目录执行：

npm.cmd run setup:mirror
npm.cmd run dev

也可双击 `启动开发版.cmd`。PowerShell 禁止运行 npm.ps1 时使用 npm.cmd，无需修改系统执行策略。

npm.cmd run check         # 类型、安全/流协议/进程测试、UI 依赖边界
npm.cmd run build         # 本地 UI 与桌面主进程
npm.cmd run test:desktop  # 实际 Electron 窗口测试；先 build
npm.cmd run pack:win      # Windows x64 便携目录

首次安装需联网下载依赖和 Electron；锁文件固定依赖。`pack:win` 使用已经安装的 Electron。不要把开发依赖或缓存作为发布包。

安装时遇到网络问题

双击 `安装依赖-国内镜像.cmd`，或在项目目录执行：

npm.cmd run setup:mirror

此入口同时设置 npm 包源 `https://registry.npmmirror.com/` 和 Electron 下载镜像 `https://npmmirror.com/mirrors/electron/`，缓存放在项目 `.cache` 中；Electron 之前下载不完整时会再次运行其安装程序。只修改项目 `.npmrc`，不修改全局 npm 配置。不删除 node_modules 或锁文件（npm 会在需要时同步锁文件），不自动启动应用。

若镜像不可用，双击 `安装依赖-官方源.cmd` 或执行：

npm.cmd run setup:official

选中的 npm 源会保存在项目 `.npmrc`；Electron 镜像只作用于安装脚本的子进程。因此后续修复依赖请继续使用这两个入口。普通 `npm install` 不会自动获得脚本中的 Electron 镜像设置。脚本使用现有 package-lock.json；需要严格按锁文件全新安装的 CI 环境可显式设置 `ELECTRON_MIRROR` 后使用 `npm ci`。

安装完成后双击 `启动开发版.cmd`。启动不会自动安装依赖；缺少依赖时会显示明确提示。安装日志位于 `.cache/npm/_logs`。

无需开发时可直接运行 `rele