raylee-ai/lancer

选用指南

AI 根据 README 整理 · 2026/10/31 21:16:36

使用方式

通过命令行启动开发环境，使用 pnpm 命令安装依赖并运行。

查看 README 依据

npm install && npm run dev ``` ## Develop 要求 Node **>=22.19.0 <26**（推荐 24）、pnpm **10.34.9**、Git。macOS 还需要 Xcode Command Line Tools。 ```sh npx --yes pnpm@10.34.9 run doctor npx --yes pnpm@10.34.9 install --frozen-lockfile npx --yes pnpm@10.34.9 dev ``` 以上命令不需要 `corepack enable` 或全局安装 pnpm。已有 pnpm 10.34.9 时，可直接使用 `pnpm`。 Linux 还需要 Python 3、make 和 C++ 编译器，用于原生终端依赖；Debian / Ubuntu 可先安装 `build-essential python3`，其他发行版安装对应开发工具。Linux 图形会话及系统运行库仍需按平台验证。 若安装时跳过了依赖脚本，Electron 二进制不会自动存在。确认网络可访问 Electron 下载源后，运行 `npx --yes pnpm@10.34.9 run setup:electron`，再启动；不要通过关闭全部依赖脚本检查来修复。

部署要求

需要 Node.js >=22.19.0 <26、pnpm 10.34.9 和 Git；macOS 需要 Xcode Command Line Tools，Linux 需要 Python 3、make 和 C++ 编译器。

查看 README 依据

npm install && npm run dev ``` ## Develop 要求 Node **>=22.19.0 <26**（推荐 24）、pnpm **10.34.9**、Git。macOS 还需要 Xcode Command Line Tools。 ```sh npx --yes pnpm@10.34.9 run doctor npx --yes pnpm@10.34.9 install --frozen-lockfile npx --yes pnpm@10.34.9 dev ``` 以上命令不需要 `corepack enable` 或全局安装 pnpm。已有 pnpm 10.34.9 时，可直接使用 `pnpm`。 Linux 还需要 Python 3、make 和 C++ 编译器，用于原生终端依赖；Debian / Ubuntu 可先安装 `build-essential python3`，其他发行版安装对应开发工具。Linux 图形会话及系统运行库仍需按平台验证。 若安装时跳过了依赖脚本，Electron 二进制不会自动存在。确认网络可访问 Electron 下载源后，运行 `npx --yes pnpm@10.34.9 run setup:electron`，再启动；不要通过关闭全部依赖脚本检查来修复。

- macOS: Xcode Command Line Tools (`xcode-select --install` if absent). - Linux: Python 3, make and a C++ compiler (Debian/Ubuntu: `sudo apt-get install build-essential python3`). A graphical desktop and Electron system libraries are required; headless CI needs its own display setup. - Windows: Python and Visual Studio Build Tools with the C++ workload may be required for native dependencies. Native Windows behavior has not been validated in this release round. ### Install and start Extract into a new directory, open a terminal in its `lancer` folder, then run: ```sh

已知限制

当前为开发中的 Alpha，macOS Apple Silicon 是主要验证平台，Linux/Windows 的打包配置不代表所有原生功能已验证；自动复刻不能保证与模板 1:1 一致。

查看 README 依据

# Lancer <p align="center"> <img src="docs/branding/lancer-readme-banner.png" alt="Lancer — agent-native desktop workspace" width="100%" /> </p> Lancer 是基于 [pi-gui](https://github.com/minghinmatthewlam/pi-gui) 和 [pi](https://github.com/earendil-works/pi) 的桌面 AI 工作区。把会话、并行分支、运行过程和交付文件放在一起，方便追溯一次任务从开始到结束的过程。 **当前为开发中的 Alpha。** 源码仓库：https://github.com/raylee-ai/lancer 。macOS Apple Silicon 是主要验证平台，Linux / Windows 的打包配置不代表所有原生功能已经验证。 - **会话与模块**：常态会话独立使用；模块会话可配置阶段、模型、Skill、目标和交付要求。 - **并行工作**：一个助手可管理多个会话；任务可派生子分支和孙分支，结果回到父会话汇总。

- **GitTree**：右侧同时查看多条会话线、分支、合并和交付节点；可聚焦当前会话。它是任务事件图，节点不都代表 Git 提交。 - **运行反馈**：活动气泡和过程行有流动边框，模型和交付动作向对应节点发送同色光线。 - **模型与账号**：通过 pi 接入订阅账号、API 密钥和自定义端点。模型品牌与网关分别管理。 - **豆包接管**：macOS 上关联一个已打开的豆包 App 会话，接收回复和视频。需要本机辅助功能权限，桌面版 UI 更新可能影响兼容性。 视频工作流能够下载或接收视频、提取关键帧、生成带证据的分析和交接文件。**自动复刻尚不能保证与模板 1:1 一致**；豆包接管、模型分析、代码动画与最终剪辑是不同环节，需要分别验收。 ## 单独复用光线 UI 只想使用模型 / 气泡到工作树的光线？见 [Lancer Light UI](packages/light-ui/README.md) 和 [可复制提示词](packages/light-ui/PROMPT.md)。它不依赖 Electron、CLI 或模型服务，提供单线、分叉合并与多会话并行示例。 ```sh pnpm export:light-ui /absolute/new/lancer-light-ui cd /absolute/new/lancer-light-ui