OPENChat Cut
返回博客

从源码运行 OpenChatCut

Node.js 版本、安装依赖、启动 Web 开发服务与桌面开发模式的简明指南。

2026年7月21日OpenChatCutOpenChatCut
从源码运行 OpenChatCut

从源码运行适合开发、排障与贡献。桌面安装包适合快速体验，见 桌面版安装指南。

环境

  • Node.js 24.x（以仓库 package.json / .nvmrc 为准）
  • npm（随 Node 提供）
  • macOS / Windows / Linux 开发机

使用 nvm / fnm / mise 时，先切换到仓库指定主版本。

安装与启动

git clone https://github.com/0xsline/OpenChatCut.git
cd OpenChatCut
npm install
npm run dev

浏览器打开开发地址（常见为 http://localhost:5199，以终端输出为准）。

桌面壳开发：

npm run desktop:dev

具体脚本名称以仓库 package.json 为准。

配置 AI 能力

基础时间线、本地工程与手动剪辑不依赖云服务。需要 Agent、转写、在线生成时，再在应用设置中配置对应供应商与密钥。

密钥应只保存在本机服务侧，不要提交到 git，也不要写进前端可打包的环境变量。

验证改动

仓库约定的最低检查：

npx tsc --noEmit

跨域或发布面改动再运行测试与构建（见仓库 AGENTS.md / README）。模板或沙箱相关改动需跑仓库提供的检查脚本。

工程与数据

  • 本机工程库默认在用户目录下的 OpenChatCut 数据路径
  • 浏览器模式使用 IndexedDB 等本地缓存
  • 删除 node_modules 不会删除你的工程媒体

下一步