老傅工作台 · Laofu Workbench

基于 DeepSeek Harness（DSH） 的可扩展 AI 工作台，通过可动态加载的「场景能力包」持续增加业务能力。

工作台提供统一的对话、模型配置、工具执行和会话管理。你可以直接使用 AI 对话，也可以加载场景能力包，进入完整的业务流程。每个包拥有自己的页面、任务和数据，新场景可以作为独立包接入。

当前随带两个公开能力包：「口播视频内容创作」覆盖从发现素材、确定选题到写稿、配音字幕、制作视频和准备发布资料的完整链路，并支持定时内容生产；「AI 竞技台」让模型在五子棋、中国象棋和 6 / 8 / 9 人狼人杀的真实规则下对局，支持观战、逐手回放与横竖屏视频导出。会员场景能力包由 LWB 账号权限控制。

当前为开发预览版，面向本机单用户使用，主要验证环境为 macOS。支持 Web 和桌面开发入口；当前桌面发布格式为 Windows x64 与 macOS Apple Silicon 未签名便携包。运行时锁定 DSH dsh-v0.2.0-rc.2，具体版本以 UPSTREAM.lock.json 为准。

公开源码与官方发行版 · 安装与启动 · 口播创作 · AI 竞技台 · 账号与能力包 · 文档地图

工作台：加载能力包后，左侧提供该包的多个业务入口。以下截图均来自真实运行界面，点击可查看原图。

本仓库是公开的，可以独立 clone、安装和运行。 它包含工作台内核（DSH Profile、浏览器壳、包 SDK、桌面打包入口、上游升级流程）、随带的两个公开能力包，以及全部文档。

官方发行版是同一个程序加上一个私有的会员能力包：用户下载到的发行版只有一份，除下面两个公开包之外还随带「模型博主测评」。该会员包的源码不在本仓库，采用其自身的专有许可，加载与业务接口由 LWB 账号会员状态控制。基础工作台和两个公开包都不依赖它。

lwb/desktop/editions.json 保存这两份构建输入：commercial 清单在本仓库自有的两个包之上追加会员包，所以官方发行版不需要第二份工作台内核，会员包源码也不需要进入本仓库。

产物分发有两条需要留意的纪律：

• macOS 官方发行版在本机 Apple Silicon Mac 构建。
• Windows 包由维护者的私有仓库构建。 它的自托管 Windows x64 Runner 不克隆本仓库，而是取用签入私有仓库的产品源码快照。因此本仓库推送之后必须执行 npm run snapshot:product 刷新该快照，否则 Windows 包仍是上一版内容。

两端产物汇总到本仓库的同一个 Draft Release。构建输入、快照命令与发行边界见 Desktop 与 Web。

本仓库的公开代码采用 PolyForm Noncommercial License 1.0.0，属于源码可见的非商业许可，不是 OSI 认可的开源许可证。协议范围外的商业使用需另行取得书面授权；购买会员、积分或云端服务不自动获得源码商业授权。会员能力包不在该许可范围内。详见许可证与商业使用。

首次进入工作台时，先看到「对话」「场景能力包」「设置」。加载能力包后，左侧增加该包的多个业务入口；无需先创建普通对话或选择普通工作区。

能力包支持动态加载和卸载，菜单随之更新。已启用的包会在下次启动时自动恢复；卸载保留业务数据和连接配置。开发者可以按公开契约创建独立包，无需把具体业务写进工作台核心。

当前「场景能力包」页面是本机包目录：自动发现 lwb/packs/ 内的包，以及通过 CLI 注册的外部本地包。它尚不提供在线包商店、远程下载或自动更新。

• 使用已有包：打开「场景能力包」，找到目标包并点击「加载」。
• 注册外部包：在项目根目录执行 npm run pack:install -- /absolute/path/to/pack，再到页面加载。
• 开发新包：阅读能力包开发入门与接口契约。

能力包详情：查看创作流程、功能列表与加载入口。

能力包是运行在本机的 JavaScript 插件，专属工作区用于数据和任务归属，并不构成第三方代码的安全沙箱；请加载可信来源的包。

手动创作按以下顺序推进，账号定位会为选题和写稿提供受众与表达要求：

信号素材 → 选题 → 写稿 → 配音 / 字幕 → 视频 / 预览 → 发布资料

稿件编辑：围绕选题查看和修改正文，确认后进入配音。

完成一条流程后，可以预览通过质检的成片，并下载视频、封面及发布资料。发布模块不直接向视频平台发布，最终发布由用户完成。

成片预览：示例为已通过质检的真实视频，播放器支持预览与下载。

发布资料：核对标题、文案、描述与标签，并准备横竖封面，供自行上传到目标平台。

使用时注意：

• 「账号定位」管理的是内容创作档案，不是 LWB 登录账号，也不用于绑定视频平台账号。
• 默认随配音生成字幕；字幕失败会保留已完成音频，可以单独重试。也可以直接输入文稿生成音频；要继续制作视频，应从关联项目的稿件进入配音。
• 内容安排运行在主机服务中。关闭浏览器不会停止调度，退出服务则无法到点执行，错过的时刻不自动补跑。选择推进到成片或发布资料时，会自动确认 AI 稿件并继续生产。

首次操作见快速开始，完整流程与任务衔接见口播视频指南。

让模型在真实规则下竞技：棋类看棋盘，狼人杀看昼夜席位舞台。比赛按棋规判定终局，选手发言只给观众看，观战、离线回放与视频三处逐字同源。

选择游戏 → 配置选手 → 自动比赛 → 回放复盘 → 导出视频

支持的游戏

狼人杀是隐藏身份游戏：每个模型只看到自己该知道的局面（狼人拿到同伴与狼聊、预言家拿到自己的查验、女巫只在用药时拿到当晚刀口），而观战与回放给观众完整视角——全员立绘席卡、身份标记、出局与死因、投票阶段的票型（谁投了谁、谁几票、这一轮怎么裁的）以及阵营终局。

主持人由规则确定性播报，不占模型席、不参与裁决、不进选手局面。台词、存活、出局、天数与阶段统一取「这一步开场」那一刻，因此「宣布谁出局」与「谁出局」同帧，观战、离线回放与 MP4 逐字一致。

比赛与选手：两名选手选择 DSH 已配置的模型路由，允许同模型自我对弈；推理强度在模型目录公开支持时可选。每名选手使用各自的连续 DSH Agent Session，只拿到当前棋盘、公开规则、最近着法与重复 / 无进展计数。非法坐标、占用落点、回复格式不合法记为违规，默认重试一次，再次违规判负；服务错误或截断暂停比赛，由用户决定继续，不计为棋力失败。模型没有文件、网络和通用工具权限。

画面与视频：离线回放与视频共用 lwb/packs/ai-arena/replay/ 一份画面源，逐手呈现执行者卡（模型形象 + logo + 席位）、本手发言、回合记录与终局卡。终局口径三处同源：五子棋点亮五连（金带 + 五环），象棋点亮制胜一手与败方将帅（和棋与判负不借用胜局图层），狼人杀给胜方席位金框。导出支持 1280×720 与 720×1280 两种画幅，可生成无声回放或带配音的有声 MP4（需要 FFmpeg；语音需要登录 LWB 并有足够积分）。同一组渲染输入不会重复渲染，改过展示层源码后需执行 npm run arena:build 重建产物。

完整规则、裁决模型与画面契约见 AI 竞技台文档。

公开仓库维护工作台核心和公开能力包；官方发行版在同一个程序中随带公开能力包和私有会员能力包。

不登录 LWB 也能使用基础工作台和公开能力包。 AI 创作和媒体生成需要可用的模型、服务凭据及相应额度，可选择 LWB 服务或自有服务。会员资格不代表无限免费调用；比赛按实际模型用量计费，配音与语音合成按 LWB 积分计费。

桌面版本的构建清单、数据目录及开发环境加载规则见 Desktop 与 Web：构建输入与官方发行版。

• Git。
• Node.js ^22.19.0 || >=24.0.0，建议使用 Node.js 22 LTS 的最新补丁版本。
• npm、Corepack，以及本机 C/C++ 编译工具和开发头文件。macOS 可安装 Xcode Command Line Tools。
• 视频制作（口播成片与竞技台导出）另需 ffmpeg、ffprobe 和 Chrome/Chromium 渲染浏览器。

首次安装需要访问 GitHub、npm 注册表及上游构建所需资源。根项目使用 npm 和 package-lock.json；setup 脚本进入 DSH 目录后通过 Corepack 使用上游锁定的 pnpm。根目录的 packageManager 字段不改变下面的 npm 安装流程。

git clone https://github.com/ScarecrowFu/dsh-laofu-workbench.git
cd dsh-laofu-workbench
npm ci
npm run setup
npm run dev -- --port 4173

npm run setup 获取并构建锁定版本的 DSH，放在被 Git 忽略的 vendor/ 中。首次构建可能耗时较长。若提示缺少 Corepack 或编译工具，见安装与故障排查。

上面启动的是 Web 端。使用桌面开发端时，在完成安装和 setup 后，改为运行：

npm run dev:desktop

两端使用同一套页面和能力包。切换前先退出另一 Host，避免同时写入同一数据目录；当前桌面发布使用未签名便携包，详见 Desktop 与 Web。

启动会自动打开浏览器。需要手动打开时运行 npm run dev -- --no-open --port 4173，使用终端输出的完整 http://127.0.0.1:4173/?token=... 地址完成首次鉴权。不要分享访问令牌。

先选择模型与媒体服务的配置方式，两类服务可分别选择：

登录 LWB 不会自动选定场景任务模型。普通对话和场景任务的模型分别管理；配音、字幕及封面服务也不会随文本模型设置切换。

1. 配置可用的 AI 模型。
2. 打开「场景能力包」，加载目标包（「口播视频内容创作」或「AI 竞技台」）；随仓库提供的包无需另行执行安装命令。
3. 口播链路：创建内容账号定位或使用「通用（无账号定位）」，检查信号，生成选题并完成一篇短稿，再配置媒体服务、FFmpeg 与渲染浏览器，从该项目稿件生成配音、字幕和视频。
4. 竞技台链路：在「游戏库」选游戏，配置参赛模型与推理强度后开赛，结束后在「比赛记录」回放或导出视频 / 战报。
5. 在「发布」预览通过质检的成片，整理并下载发布资料，自行发布到目标平台。

详见快速开始：第 5 节走完第一条口播内容，第 8 节跑第一场模型竞技。可以先验证对话和选题写稿，再配置媒体制作依赖。

源码启动的默认产品数据根为 lwb/local/current/，包括能力包登记、DSH 设置、凭据、会话和创作产物；lwb/local/ 不提交到 Git。原生附件和业务数据位置见运行数据目录。

启动器不会自动加载 .env。.env.example 仅用于说明可选变量；在启动终端中用 export 设置，例如：

export LWB_REMOTION_BROWSER_EXECUTABLE="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
npm run dev -- --port 4173

更新或迁移前，停止服务并备份完整 lwb/local/；若自定义了数据目录，还需备份对应位置。包的“清空业务数据”会保留可恢复副本，与“卸载”含义不同。

npm test

完成依赖安装和 DSH 构建后，上述命令执行语法检查、基础/能力包 Profile 检查及单元测试。真实模型和媒体接口需要另外配置并验收，测试通过不代表所有外部服务均可用。竞技台相关的测试与产物重建见 AI 竞技台文档。

代码放哪里：

工作台核心保持通用，场景页面、业务数据和任务流程放在包内。vendor/deepseek-harness 是上游 checkout，不属于产品改动区。

欢迎提交问题、文档改进与场景能力包。请先阅读贡献指南，问题反馈入口为 GitHub Issues。

文档只维护当前有效内容；逐次分析、设计草案与验收流水账已收敛到历史摘要，原文可从 Git 查阅。完整索引见 docs/README.md。

使用

载体与发行

开发与契约

追溯

当前版本的项目自有代码（包括公开的口播视频与 AI 竞技台能力包）采用 PolyForm Noncommercial License 1.0.0：在协议允许的范围内可使用、修改和分发；其他用途（例如一般企业商业使用、商业托管或收费交付）需另行取得授权，具体以协议原文和实际用途为准。购买 LWB 会员、积分或云端服务不自动获得源码商业授权。该许可证属于源码可见的非商业许可，不是 OSI 认可的开源许可证。历史上已按 MIT 发布的版本继续适用其原许可证，当前许可不追溯撤销已经授予的权利。具体边界见许可证与商业使用。

私有的会员能力包采用其自身的专有许可，不在上述许可范围内。

感谢 DeepSeek Harness 提供运行时，以及 React、Remotion 等项目提供基础能力。上游 DSH 和所有第三方依赖、素材、字体及外部服务继续遵循各自的许可证和服务条款，不因本项目许可证而改变。

第三方依赖和附带资源的许可独立于本项目，特别是 Remotion 使用其自身许可。来源、许可边界和待补充的素材出处见第三方组件与资源说明。