LiveAgent Studio

面向直播电商团队的 Windows 本地 AI 工作台

把主播发现、直播拆解、直播复盘和短视频编导放进一个统一入口。

[!IMPORTANT] 请先使用非敏感素材验证环境、账号权限和输出结果，再投入正式业务。

LiveStream Agent Studio 是面向直播电商团队打造的 Windows 本地 AI Agent Studio。

本版本将主播发现、直播拆解、话术与流量复盘、短视频内容编导整合到统一入口，帮助直播运营、投放、内容和复盘团队，将榜单、录屏、逐字稿、流量数据与脚本资产沉淀为可追踪、可复用的完整工作流。

这是项目的首个公开 Beta 版本，适合体验、测试和内部研究使用。

✨ 核心能力

01 · Creator Scout Agent｜主播发现

管理关注领域、候选主播和达人研究任务，读取用户账号正常可见的蝉妈妈榜单或主播页面，生成结构化达人拆解，并将候选主播加入后续录制流程。

02 · Live Breakdown Agent｜直播拆解

将完整直播视频转化为带秒级时间戳的结构化逐字稿，自动完成音频提取、云端转写和内容整理，并输出可继续分析的 Excel 文件。

03 · Live Review Agent｜直播复盘

对齐直播逐字稿与同场分钟级流量数据，分析不同话术阶段对应的进入、离开、在线、停留、互动、商品曝光与点击变化，输出 Excel 和 Word 复盘报告。

04 · Video Director Agent｜短视频编导

根据用户提供的参考短视频链接提取真实逐字稿，在保留内容逻辑而非复制原文的前提下，生成原创口播脚本、内容结构、分镜与拍摄建议。

Unified Task Center｜统一任务中心

集中查看任务进度、运行状态、失败原因和输出文件，减少在多个脚本、文件夹和工具之间反复切换。

Local Settings Hub｜本地设置中心

统一配置用户自己的阿里云百炼 DashScope、OSS、平台登录状态，以及可选的直播录制助手路径。

四个 Agent

快速开始

1. 下载

在仓库右侧进入 Releases，下载：

• LiveAgent-Studio-Windows-x64.zip
• LiveAgent-Studio-Windows-x64.zip.sha256

不要只下载源码，也不要只复制 EXE。完整运行需要 ZIP 内的 .runtime 和各 Agent 目录。

2. 校验文件

在 ZIP 所在目录打开 PowerShell：

(Get-FileHash .\LiveAgent-Studio-Windows-x64.zip -Algorithm SHA256).Hash

确认结果与 .sha256 文件中的值一致。无法确认下载来源或校验不一致时，请不要运行。

3. 解压并启动

完整解压 ZIP，双击：

LiveAgentStudio.exe

程序准备好后会自动打开 http://127.0.0.1:4173/。当前 Beta 启动器尚未使用商业代码签名证书，Windows 可能显示 SmartScreen 提示；请只运行从本仓库 Releases 下载且校验一致的文件。

4. 完成首次设置

进入左侧 设置与连接，根据页面引导配置：

1. 自己的阿里云百炼 DashScope API Key。
2. 私有 OSS Bucket。
3. 仅覆盖指定 Bucket/对象前缀的 RAM AccessKey。
4. 如需“加入快抖录制”，再粘贴本机录制助手 EXE 的完整路径；这是可选项。

保存后点击“实际验证 Qwen 与 OSS”。验证通过后，再开始直播拆解或复盘任务。

数据如何流动

LiveAgent Studio 不附带任何开发者 API Key、Cookie、浏览器 Profile 或真实业务数据。云端转写会使用用户自己的阿里云账号并产生相应费用。

🧩 使用前需要准备什么

LiveStream Agent Studio 提供本地工作台和工作流编排，但不会附带第三方账号、会员、云服务额度或外部录制软件。

基础运行环境

• Windows 10 或 Windows 11，64 位系统。
• Microsoft Edge、Google Chrome 或其他现代浏览器。
• 稳定的网络连接。
• 足够的磁盘空间，用于直播视频、逐字稿、临时文件和复盘报告。
• Microsoft Excel、Word，或能够打开 .xlsx、.docx 的 WPS Office 等兼容软件。

阿里云服务

直播拆解、转写和部分 AI 分析功能需要用户自行准备：

• 阿里云账号。
• 阿里云百炼 DashScope API Key。
• 用户自己的私有 OSS Bucket。
• OSS Endpoint、AccessKey ID 和 AccessKey Secret。
• 可用的模型与云服务额度。

云端转写和模型调用会使用用户自己的阿里云账号，并可能产生费用。请在阿里云控制台查看实际计费规则和用量。

蝉妈妈

主播发现相关功能可能需要：

• 用户自己的蝉妈妈账号。
• 正常登录状态。
• 对应榜单、主播页面或数据模块的会员权限。

软件只读取当前账号正常可见的页面，不会绕过登录、验证码、会员限制或平台风控。

抖音

短视频解析、主播页面和部分内容读取可能需要：

• 用户自己的抖音账号。
• 正常登录状态。
• 必要时完成验证码或访问状态刷新。

部分链接可能因平台风控、内容权限、地区限制、链接失效或页面变化而无法读取。

巨量百应

直播复盘建议准备同一场直播对应的分钟级流量数据，例如：

• 进入人数。
• 禚开人数。
• 实时在线人数。
• 平均停留。
• 互动数据。
• 商品曝光与点击数据。

数据字段越完整，话术与流量的对齐分析越可靠。

直播录制工具

如果需要将候选主播加入后续直播录制流程，用户需要自行合法获取并安装：

• 快抖直播录制助手
• 对应平台的正常登录状态与使用权限
• 足够的本地磁盘空间，用于保存直播录屏文件

LiveStream Agent Studio 不包含快抖直播录制助手，也不会自动下载或安装该软件。

安装完成后，请进入 LiveStream Agent Studio 的：

设置与连接 → 快抖直播录制助手

粘贴快抖直播录制助手 EXE 的完整本机路径，例如：D:\直播录屏\live-record-monitor\快抖直播录制助手.exe 如果需要从主播发现流程继续加入直播录制，还需要用户自行合法获取并安装直播录制工具。

当前支持在“设置与连接”中填写可选的快抖直播录制助手 EXE 路径。该软件属于第三方依赖，不包含在本项目和 Release 中；未配置时不会影响其他 Agent 的使用。

运行架构

flowchart LR
    EXE[LiveAgentStudio.exe] --> UI[本地工作台]
    UI --> GW[本地网关与任务中心]
    GW --> Scout[主播发现]
    GW --> Retro[直播复盘]
    GW --> Breakdown[直播拆解]
    GW --> Director[视频编导]
    Breakdown --> OSS[用户自己的 OSS]
    Director --> OSS
    OSS --> Qwen[DashScope 转写与分析]

网关限制允许访问的 Host 和网页 Origin，不接受普通外部网页直接调用。

系统和第三方要求

• Windows 10 或 Windows 11，64 位。
• Chrome 或 Edge，用于本地工作台以及需要登录的第三方页面。
• 用户自己的阿里云百炼与 OSS 账号。
• 蝉妈妈功能取决于用户账号正常可见的页面、会员权限和平台风控。
• 抖音链接可能要求登录、验证码或刷新访问状态。
• 快抖直播录制助手不包含在本项目内，需要用户自行合法获取和安装。

本项目不会绕过登录、验证码、会员限制、访问控制或第三方平台风控。

从源码运行

开发环境要求：

• Windows 10/11
• Python 3.11+
• Node.js 22.13+
• Chrome 或 Edge

.\scripts\setup-development.ps1
.\liveagent-studio\01_启动_LiveAgent_Studio.ps1

前端单独开发：

cd liveagent-studio
npm ci
npm run dev

测试与构建

前端构建测试：

cd liveagent-studio
npm test

Python Agent 测试：

cd live_scout_agent
python -m unittest discover -s tests -v

live_breakdown_agent 和 live_retro_agent 可使用相同命令运行各自测试。

构建便携 Windows 发布包：

.\scripts\build_windows_release.ps1

创建 v* Git 标签也会触发 GitHub Actions，生成 ZIP 和 SHA256 校验文件。完整流程见 GitHub 发布操作手册。

项目结构

liveagent-studio/        统一工作台与本地网关
live_scout_agent/        主播发现、达人拆解和录制编排
live_breakdown_agent/    长直播转写与事件拆解
live_retro_agent/        逐字稿与分钟流量复盘
launcher/                Windows EXE 启动器
scripts/                 开发环境和发布包构建脚本
docs/                    架构、FAQ、发布与隐私说明
.github/                 CI、Release、Issue 与依赖更新配置

当前限制

• 当前只提供 Windows x64 发布包。
• EXE 尚未使用商业代码签名证书。
• 抖音和蝉妈妈页面发生变化时，相关读取流程可能需要更新。
• 超长直播的转写速度和费用取决于文件大小、网络和云服务状态。
• 严格 ESLint 仍有存量类型与无障碍问题，现阶段以构建测试作为前端 CI 门槛。
• 当前复盘聚焦话术与分钟流量变化，不把 GMV、成交或订单字段作为结论依据。

Roadmap

• Windows 代码签名与更清晰的安装体验
• 缩小便携包体积并固定第三方运行时校验值
• 补充界面截图、演示视频和脱敏示例结果
• 清理前端类型与无障碍告警
• 增加任务数据保留时间和一键清理设置
• 扩展更多经过验证的直播复盘输入格式

参与项目

欢迎提交可复现的 Bug、文档改进和范围清晰的 Pull Request。提交前请阅读 CONTRIBUTING.md。

请勿在 Issue、截图或日志中上传 API Key、AccessKey、Cookie、浏览器 Profile、真实业务数据或包含个人信息的完整本机路径。

安全问题请按照 SECURITY.md 私密报告，不要公开披露漏洞细节。

使用边界

用户应确保有权访问、下载、转写和分析所提交的直播或短视频内容，并遵守抖音、蝉妈妈、阿里云及其他相关服务的条款。项目提供的是本地工作流工具，不对第三方账号权限、内容授权、云服务费用或平台规则变化作保证。

License

项目源码采用 MIT License。Windows 发布包同时包含 Python、Node.js、FFmpeg 及其他第三方组件，它们分别遵循自己的许可证，详见 THIRD_PARTY_NOTICES.md。

版本变化见 CHANGELOG.md，常见问题见 docs/常见问题.md。