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 | 带秒级时间戳的拆解 ExcelBreakdown 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 | 当前电脑的项目 workspaceThe project's local workspace directory |
| 蝉妈妈、抖音登录状态Chanmama and Douyin sign-in state | 当前电脑的专用浏览器 ProfileA 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.xlsxand.docxfiles.
阿里云服务
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 cur