raylee-ai/lancer

Lancer 是一个处于 Alpha 阶段的桌面 AI 工作区，基于 pi-gui 和 pi 构建。它面向同时推进多个 AI 辅助任务、又需要看清每个任务如何得出结论的人：会话、分支、运行过程和交付文件集中在一个界面里，而不是散落在单条聊天记录中。它更像一个现成的工作应用，而不是供其他 AI 应用嵌入的库。

一次任务如何组织

一个助手可以管理多个会话。任务可以派生子分支和孙分支，结果回到父会话中汇总。右侧 GitTree 同时显示多条会话线、分支、合并和交付节点，也可以只聚焦当前会话。README 特别说明它是任务事件图，并非每个节点都对应 Git 提交。

运行反馈是可视化的：活动气泡和过程行有流动边框，模型和交付动作会向对应节点发送同色光线。模型与账号通过 pi 接入，支持订阅账号、API 密钥和自定义端点；模型品牌与网关分开管理。

文档中的视频工作流可以下载或接收视频、提取关键帧，并生成带证据的分析和交接文件。作者明确提醒，自动复刻不能保证与模板 1:1 一致；豆包接管、模型分析、代码动画和最终剪辑是不同环节，需要分别验收。豆包接管只在 macOS 上提供，需要本机辅助功能权限，桌面版 UI 更新可能影响兼容性。

只使用光线 UI

light-ui 是另一条路径，前置条件也不同：它提供单线、分叉合并和多会话并行示例，不依赖 Electron、CLI 或模型服务。可以导出到新目录后用 npm 运行，因此只想要这部分视觉效果时不需要完整的桌面技术栈。

要求与限制

从源码构建需要 Node >=22.19.0 <26（推荐 24）、Git 和 pnpm 10.34.9；macOS 还需要 Xcode Command Line Tools，Linux 需要 Python 3、make 和 C++ 编译器。macOS Apple Silicon 是主要验证平台，Windows 原生行为在本轮发布中尚未验证。源码压缩包不包含可直接运行的 .app，独立应用下载也尚未发布，不要把源码包当成安装包。

视频处理另外需要可运行的 FFmpeg、FFprobe 和 yt-dlp；只启动对话界面不需要这些媒体工具。

本地构建 macOS 应用时，脚本要求配置持久签名证书，不会自动创建证书、改用临时签名或公证；本地签名不等于已公证的公开发布。安装器会保留可恢复的旧版本且不清空会话数据，但候选版本验证完成前不要替换已安装的应用。

会话和账号数据使用 pi 的 ~/.pi/agent，macOS 界面状态位于 ~/Library/Application Support/Lancer。单独的源码目录不能隔离运行数据，完全隔离的手动测试需要使用独立的操作系统用户。项目采用 MIT 许可，并保留 pi-gui v1.0.1 的上游声明；但第三方模型商标、用户头像、参考视频和 Fate 素材并不因此自动获得再分发许可 README 仓库 平台验证。

HotRepo 点评

现有材料中唯一的记录是 2026-10-31 新项目榜的 101 颗总星，当时在 TypeScript 分类中排第 22 位。这是累计快照而非单日增长，也没有足够的可比历史来判断热度走势。