LiveStream Agent Studio
面向直播电商团队的 Windows 本地优先 AI 工作台
A local-first AI workspace for livestream commerce teams on Windows
把主播发现、直播拆解、直播复盘和短视频编导放进一个统一入口。
Bring creator discovery, livestream breakdown, performance review, and short-form video planning into one unified workspace.
[!IMPORTANT]
请先使用非敏感素材验证环境、账号权限和输出结果，再投入正式业务。
Before using LiveAgent Studio in production, validate your environment, account permissions, and output quality with non-sensitive test materials.
LiveStream Agent Studio 是面向直播电商团队打造的 Windows 本地优先 AI Agent 工作台。
LiveStream Agent Studio is a local-first Windows AI Agent workspace built for livestream commerce teams.
本版本将主播发现、直播拆解、话术与流量复盘、短视频内容编导整合到统一入口，帮助直播运营、投放、内容和复盘团队，将榜单、录屏、逐字稿、流量数据与脚本资产沉淀为可追踪、可复用的完整工作流。
It brings creator discovery, livestream breakdown, speech-and-traffic review, and short-form video planning into a single interface. The goal is to help operations, media-buying, content, and review teams turn rankings, recordings, transcripts, traffic data, and scripts into traceable and reusable workflows.
这是项目的首个公开版本，适合体验、测试和内部研究使用。
This is the project's first public release. It is intended for evaluation, testing, and internal research.
✨ 核心能力 Core Capabilities
01 · Creator Scout Agent｜主播发现
管理关注领域、候选主播和达人研究任务，读取用户账号正常可见的蝉妈妈榜单或主播页面，生成结构化达人拆解，并将候选主播加入后续可选录制流程。
Manage research categories, candidate creators, and creator-analysis tasks. The Agent can read Chanmama rankings or creator pages normally visible to the signed-in user, generate structured creator profiles, and add selected creators to an optional recording workflow.
02 · Live Breakdown Agent｜直播拆解
将完整直播视频转化为带秒级时间戳的结构化逐字稿，自动完成音频提取、云端转写和内容整理，并输出可继续分析的 Excel 文件。
Convert full-length livestream recordings into structured transcripts with second-level timestamps. The workflow extracts audio, submits it for cloud transcription, organizes the content, and exports an Excel workbook ready for further analysis.
03 · Live Review Agent｜直播复盘
对齐直播逐字稿与同场分钟级流量数据，分析不同话术阶段对应的进入、离开、在线、停留、互动、商品曝光与点击变化，输出 Excel 和 Word 复盘报告。
Align a livestream transcript with minute-level traffic data from the same session. Analyze how different speech stages relate to changes in entries, exits, concurrent viewers, watch time, engagement, product impressions, and product clicks. Results are exported as Excel and Word reports.
04 · Video Director Agent｜短视频编导
根据用户提供的参考短视频链接提取真实逐字稿，在保留内容逻辑而非复制原文的前提下，生成原创口播脚本、内容结构、分镜与拍摄建议。
Extract a verified transcript from a short-video reference link supplied by the user. Based on the reference's underlying content logic—without copying its wording—the Agent generates an original spoken script, content structure, storyboard, and production recommendations.
Unified Task Center｜统一任务中心
集中查看任务进度、运行状态、失败原因和输出文件，减少在多个脚本、文件夹和工具之间反复切换。
Track task progress, runtime status, failure reasons, and output files in one place, reducing the need to switch repeatedly between scripts, folders, and tools.
Local Settings Hub｜本地设置中心
统一配置用户自己的阿里云百炼 DashScope、OSS、平台登录状态，以及可选的直播录制助手路径。
Configure your own Alibaba Cloud Model Studio (DashScope), OSS storage, platform sign-in state, and the optional path to a local livestream recording assistant.
四个 Agent Four Agents
| Agent |
输入 / Input |
主要工作 / What It Does |
输出 / Output |
主播发现
Creator Scout |
关注领域、用户账号可见的蝉妈妈榜单或主播主页
Research categories and Chanmama rankings or creator pages visible to the user's account |
管理候选主播、生成达人拆解、加入可选录制流程
Manages candidates, produces creator profiles, and optionally adds creators to a recording workflow |
候选主播库、达人报告、录制名单
Candidate library, creator reports, and recording list |
直播拆解
Live Breakdown |
完整直播视频
Full-length livestream video |
提取音频、云端语音转写、按内容组织事件和逐字稿
Extracts audio, runs cloud speech transcription, and organizes events and transcripts |
带秒级时间戳的拆解 Excel
Breakdown workbook with second-level timestamps |
直播复盘
Live Review |
直播视频、同场巨量百应分钟流量表
Livestream video and minute-level Ocean Engine E-commerce traffic data from the same session |
对齐逐字稿与进入、离开、在线、停留、互动、商品曝光和点击变化
Aligns speech with entries, exits, concurrent viewers, watch time, engagement, product impressions, and clicks |
复盘 Excel、Word 和处理说明
Excel and Word review reports, plus processing notes |
视频编导
Video Director |
用户主动粘贴的参考短视频链接
Short-video reference links submitted by the user |
提取真实参考逐字稿，基于有效素材生成原创方案
Extracts a verified reference transcript and creates an original content plan from valid source material |
原创脚本、分镜和拍摄建议
Original script, storyboard, and production guidance |
快速开始 Quick Start
1. 下载
1. Download the Release
在仓库右侧进入 Releases，下载：
Open Releases on the right side of the repository and download:
LiveAgent-Studio-Windows-x64.zipLiveAgent-Studio-Windows-x64.zip.sha256
不要只下载源码，也不要只复制 EXE。完整运行需要 ZIP 内的 .runtime 和各 Agent 目录。
Do not download only the source archive or copy only the executable. The application requires the .runtime directory and the bundled Agent directories included in the ZIP package.
2. 校验文件
2. Verify the Download
在 ZIP 所在目录打开 PowerShell：
Open PowerShell in the directory containing the ZIP file:
(Get-FileHash .\LiveAgent-Studio-Windows-x64.zip -Algorithm SHA256).Hash
确认结果与 .sha256 文件中的值一致。无法确认下载来源或校验不一致时，请不要运行。
Confirm that the resulting hash matches the value in the .sha256 file. Do not run the package if the hash does not match or if you cannot verify the download source.
3. 解压并启动
3. Extract and Launch
完整解压 ZIP，然后双击：
Extract the entire ZIP archive, then double-click:
LiveAgentStudio.exe
程序准备好后会自动在默认浏览器打开 http://127.0.0.1:4173/。
When the local service is ready, the application opens http://127.0.0.1:4173/ in your default browser.
当前 Beta 启动器尚未使用商业代码签名证书，Windows 可能显示 SmartScreen 提示；请只运行从本仓库 Releases 下载且校验一致的文件。
The current Beta launcher is not signed with a commercial code-signing certificate, so Windows SmartScreen may display a warning. Only run packages downloaded from this repository's official Releases page and verified against the published SHA-256 checksum.
4. 完成首次设置
4. Complete the Initial Setup
进入左侧 设置与连接，根据页面引导配置：
Open Settings & Connections from the sidebar and configure:
- 自己的阿里云百炼 DashScope API Key。
Your Alibaba Cloud Model Studio DashScope API key.
- 私有 OSS Bucket。
Your private OSS bucket.
- 仅覆盖指定 Bucket/对象前缀的 RAM AccessKey。
A RAM AccessKey restricted to the required bucket and object prefix.
- 如需“加入快抖录制”，再粘贴本机录制助手 EXE 的完整路径；这是可选项。
Optional: paste the full local path to the recording assistant executable if you want to use Add to Kuaidou Recording.
保存后点击“实际验证 Qwen 与 OSS”。验证通过后，再开始直播拆解或复盘任务。
Save the settings and select Verify Qwen & OSS. Start a breakdown or review task only after the verification succeeds.
数据如何流动 How Data Flows
| 数据 / Data |
默认位置或去向 / Default Location or Destination |
任务记录、数据库、输出文件
Task history, database, and generated files |
当前电脑的项目 workspace
The project's local workspace directory |
蝉妈妈、抖音登录状态
Chanmama and Douyin sign-in state |
当前电脑的专用浏览器 Profile
A dedicated browser profile on the local machine |
API Key 与 OSS 凭据
API keys and OSS credentials |
当前电脑被 Git 忽略的 .env，Windows 下限制为当前用户和 SYSTEM 访问
A Git-ignored local .env file, restricted on Windows to the current user and SYSTEM |
转写音频
Audio used for transcription |
临时上传到用户自己的 OSS，再交给 DashScope 读取
Temporarily uploaded to the user's own OSS bucket, then accessed by DashScope |
OSS 临时音频
Temporary OSS audio |
任务结束后程序尝试删除
The application attempts to delete it when the task finishes |
抖音下载 Cookie 文件
Douyin download cookies |
仅在处理期间临时生成，使用后立即删除
Generated only while needed and deleted immediately after use |
LiveAgent Studio 不附带任何开发者 API Key、Cookie、浏览器 Profile 或真实业务数据。云端转写会使用用户自己的阿里云账号并产生相应费用。
LiveAgent Studio does not include developer API keys, cookies, browser profiles, or real business data. Cloud transcription and model calls use the user's own Alibaba Cloud account and may incur charges.
🧩 使用前需要准备什么 Prerequisites
LiveAgent Studio 提供本地工作台和工作流编排，但不会附带第三方账号、会员、云服务额度或外部录制软件。
LiveAgent Studio provides the local workspace and workflow orchestration layer. It does not include third-party accounts, subscriptions, cloud-service credits, or external recording software.
基础运行环境
Basic System Requirements
- Windows 10 或 Windows 11，64 位系统。
Windows 10 or Windows 11, 64-bit.
- Microsoft Edge、Google Chrome 或其他现代浏览器。
Microsoft Edge, Google Chrome, or another modern browser.
- 稳定的网络连接。
A stable internet connection.
- 足够的磁盘空间，用于直播视频、逐字稿、临时文件和复盘报告。
Sufficient disk space for livestream recordings, transcripts, temporary files, and review reports.
- Microsoft Excel、Word，或能够打开
.xlsx、.docx 的 WPS Office 等兼容软件。
Microsoft Excel and Word, WPS Office, or other software capable of opening .xlsx and .docx files.
阿里云服务
Alibaba Cloud Services
直播拆解、转写和部分 AI 分析功能需要用户自行准备：
Livestream breakdown, transcription, and selected AI analysis features require users to provide:
- 阿里云账号。
An Alibaba Cloud account.
- 阿里云百炼 DashScope API Key。
An Alibaba Cloud Model Studio DashScope API key.
- 用户自己的私有 OSS Bucket。
A private OSS bucket owned by the user.
- OSS Endpoint、AccessKey ID 和 AccessKey Secret。
An OSS endpoint, AccessKey ID, and AccessKey Secret.
- 可用的模型与云服务额度。
Access to the required models and sufficient cloud-service quota.
云端转写和模型调用会使用用户自己的阿里云账号，并可能产生费用。请在阿里云控制台查看实际计费规则和用量。
Transcription and model calls use the user's own Alibaba Cloud account and may incur charges. Refer to the Alibaba Cloud console for current pricing and usage information.
蝉妈妈
Chanmama
主播发现相关功能可能需要：
Creator discovery may require:
- 用户自己的蝉妈妈账号。
The user's own Chanmama account.
- 正常登录状态。
An active sign-in session.
- 对应榜单、主播页面或数据模块的会员权限。
The subscription level required to view the relevant rankings, creator pages, or data modules.
软件只读取当前账号正常可见的页面，不会绕过登录、验证码、会员限制或平台风控。
The application only reads pages normally available to the current account. It does not bypass authentication, CAPTCHA challenges, subscription restrictions, or platform risk controls.
抖音
Douyin
短视频解析、主播页面和部分内容读取可能需要：
Short-video parsing, creator pages, and selected content-reading workflows may require:
- 用户自己的抖音账号。
The user's own Douyin account.
- 正常登录状态。
An active sign-in session.
- 必要时完成验证码或访问状态刷新。
Completion of CAPTCHA verification or a refreshed access session when requested by the platform.
部分链接可能因平台风控、内容权限、地区限制、链接失效或页面变化而无法读取。
Some links may be unavailable because of platform risk controls, content permissions, regional restrictions, expired links, or page changes.
巨量百应
Ocean Engine E-commerce
直播复盘建议准备同一场直播对应的分钟级流量数据，例如：
For livestream review, provide minute-level traffic data from the same livestream session whenever possible, including:
- 进入人数。
Viewer entries.
- 离开人数。
Viewer exits.
- 实时在线人数。
Concurrent viewers.
- 平均停留。
Average watch time.
- 互动数据。
Engagement metrics.
- 商品曝光与点击数据。
Product impressions and clicks.
数据字段越完整，话术与流量的对齐分析越可靠。
More complete input data generally produces more reliable speech-to-traffic analysis.
直播录制工具
如果需要将候选主播加入后续直播录制流程，用户需要自行合法获取并安装：
To add selected creators to a downstream livestream-recording workflow, users must legally obtain and install:
- 快抖直播录制助手。
Kuaidou Livestream Recording Assistant (快抖直播录制助手).
- 对应平台的正常登录状态与使用权限。
Any platform account and permissions required by that tool.
- 足够的本地磁盘空间，用于保存直播录屏文件。
Sufficient local disk space for recorded livestream files.
LiveAgent Studio 不包含快抖直播录制助手，也不会自动下载或安装该软件。
LiveAgent Studio does not include, download, or install Kuaidou Livestream Recording Assistant.
安装完成后，请进入：
After installing it, open:
设置与连接 → 快抖直播录制助手
Settings & Connections → Kuaidou Livestream Recording Assistant
粘贴快抖直播录制助手 EXE 的完整本机路径，例如：
Paste the full local path to its executable, for example:
D:\直播录屏\live-record-monitor\快抖直播录制助手.exe
该功能属于可选的第三方集成。未配置时不会影响其他 Agent 的使用。
This is an optional third-party integration. Leaving it unconfigured does not affect the other Agents.
运行架构 Architecture
flowchart LR
EXE[LiveAgentStudio.exe] --> UI[本地工作台 / Local Workspace]
UI --> GW[本地网关与任务中心 / Local Gateway & Task Center]
GW --> Scout[主播发现 / Creator Scout]
GW --> Review[直播复盘 / Live Review]
GW --> Breakdown[直播拆解 / Live Breakdown]
GW --> Director[视频编导 / Video Director]
Breakdown --> OSS[用户自己的 OSS / User-Owned OSS]
Director --> OSS
OSS --> Qwen[DashScope 转写与分析 / Transcription & Analysis]
网关限制允许访问的 Host 和网页 Origin，不接受普通外部网页直接调用。
The local gateway restricts permitted hosts and web origins. It does not accept requests from arbitrary external web pages.
系统和第三方要求 System and Third-Party Requirements
- Windows 10 或 Windows 11，64 位。
Windows 10 or Windows 11, 64-bit.
- Chrome 或 Edge，用于本地工作台以及需要登录的第三方页面。
Chrome or Edge for the local workspace and third-party pages requiring authentication.
- 用户自己的阿里云百炼与 OSS 账号。
The user's own Alibaba Cloud Model Studio and OSS accounts.
- 蝉妈妈功能取决于用户账号正常可见的页面、会员权限和平台风控。
Chanmama functionality depends on pages visible to the user's account, subscription permissions, and platform risk controls.
- 抖音链接可能要求登录、验证码或刷新访问状态。
Douyin links may require authentication, CAPTCHA verification, or a refreshed access session.
- 快抖直播录制助手不包含在本项目内，需要用户自行合法获取和安装。
Kuaidou Livestream Recording Assistant is not included in this project and must be legally obtained and installed by the user.
本项目不会绕过登录、验证码、会员限制、访问控制或第三方平台风控。
This project does not bypass authentication, CAPTCHA challenges, subscription restrictions, access controls, or third-party platform risk controls.
从源码运行 Running from Source
开发环境要求：
Development requirements:
- Windows 10/11。
Windows 10 or Windows 11.
- Python 3.11+。
Python 3.11 or later.
- Node.js 22.13+。
Node.js 22.13 or later.
- Chrome 或 Edge。
Chrome or Edge.
.\scripts\setup-development.ps1
.\liveagent-studio\01_启动_LiveAgent_Studio.ps1
前端单独开发：
To run the frontend separately:
cd liveagent-studio
npm ci
npm run dev
测试与构建 Testing and Building
前端构建测试：
Run the frontend build tests:
cd liveagent-studio
npm test
Python Agent 测试：
Run the Python Agent tests:
cd live_scout_agent
python -m unittest discover -s tests -v
live_breakdown_agent 和 live_retro_agent 可使用相同命令运行各自测试。
Use the same command from live_breakdown_agent or live_retro_agent to run their respective test suites.
构建便携 Windows 发布包：
Build the portable Windows release package:
.\scripts\build_windows_release.ps1
创建 v* Git 标签也会触发 GitHub Actions，生成 ZIP 和 SHA256 校验文件。完整流程见 GitHub 发布操作手册。
Creating a v* Git tag also triggers GitHub Actions to generate the ZIP package and its SHA-256 ch
LiveStream Agent Studio is a local-first Windows AI workspace for livestream e-commerce teams that combines creator discovery, livestream breakdown, performance review, and short-video script planning into one workflow.