时间线组 = 对话轮次
agent 干活前建「输入预览」组让人确认对象，完成后建「结果」组并写明理由。每一轮都可回溯、可局部采纳、可基于它继续。
多时间线 · agent 无状态接入 · 免费
几十集短剧，
一屏看全部标记。
每个视频 = 一条独立时间线；agent 一步步提交结构化操作，你在时间线上写备注、标问题、画选区。 本项目是人与 agent 对话的扩展——用于精准可视化的沟通。对话即工程记录，任何 agent 说"继续"就能接手。
素材与成片全程不离开你的电脑。下载、部署、安装、测试都是 agent 的事——分发只含核心程序与说明，依赖（ffmpeg/.NET 8/ASR 等）由 agent 按本站说明自行部署或对接。
80 集短剧 · 组视图每集一行 · agent 标记实时上屏
!
测试版（BETA）：更新是破坏性的
本项目处于测试阶段，版本间不保证工程文件与接口兼容。官网只提供最新版本。
更新前请把现有安装目录改名为 <目录>-bak-<日期> 保留回退——
agent 也被要求这样做（见 agent 接入页 的回退策略）。
工程目录 workspace/ 独立于程序目录，升级程序时不要动它。
TlAgent 是什么
把"几十条时间线的 agent 协作剪辑"变成看得见、可追溯、可接手的工程
1导入剧目录一键导入：每个视频 = 一条独立时间线（80 集 = 80 条）
2索引本地 ASR 语音索引（字级时间戳），生成字幕轨供人与 agent 检索
3对话你在 agent 对话框说需求；agent 作为无状态管道读写本项目工程
4操作agent 提交结构化操作计划：批量标记/切分/备注——人与 agent 走同一条命令通道
5可视时间线画布实时显示标记/字幕/备注/问题；组视图一屏看全部时间线
6反馈你在片段上标问题/写约束——下轮 agent 自动读到并遵守
7交付时间线渲染成片；完整历史（操作+对话）沉淀在工程里，换 agent 无缝接手
对话即工程记录
人与 agent 的工程相关讨论、每次操作、每条备注都沉淀在 workspace/journal.jsonl（完整不丢失）。agent 只说"继续"就能从任何断点接手。
无状态 agent，随便换
agent 不存任何会话状态：每次被调用读 /api/brief 拿增量（你的新消息+你的操作）。换一个 agent？读 /api/brief?full=1 完整重放即可接手。
防破解与数据收集
强制全部在 Go 闭源核心（Ed25519 验签 + 设备指纹 + 服务器白名单，免费无时间窗限制）。数据收集仅对话与操作，加密上传（服务器无法解密），私钥仅在开发者机器。
上手
五分钟：导入 → 索引 → 让 agent 干活 → 在结果上反馈
① 让 agent 安装
把 https://v17.100000.plus 扔给你的 agent 并说"用它来干活"。它按 /agent 自举页 完成检测、下载、依赖部署、安装、启动与验证——你不用动手。人想手动装也可以：依赖部署 + 下载。
② 一键启动
运行 scripts\start_all.cmd：ASR(8082) + 授权/日志服务(19130) + 后端(8617) + GUI 全部拉起，免费无需注册。
③ 导入与索引
GUI 左上「导入目录」选剧目录（每个视频 = 一条时间线）；点「ASR 语音索引」等字幕轨填满（本地 CPU，约 7 秒/集）。
④ 让 agent 干活
把 https://v17.100000.plus 扔给你的 agent（任何能执行 HTTP 调用的 agent 都行），说"用它来干活"。agent 会按 /agent 自举页 检测/安装/接入，然后按操作标准工作。
⑤ 在工程上反馈
点击片段写备注（intent=意图 / constraint=约束 / suggestion=建议），或「标记问题」——agent 下轮按规则 R5 读取并遵守。选区：播放器上勾选「画框选区」画框，「把选区发给 agent」。
⑥ 渲染交付
选一条时间线 →「渲染当前时间线」→ 成片输出到 workspace\render\。
agent 接入
对 agent 说："用它来干活 https://v17.100000.plus"
agent 被人扔来这个网址后，应抓取 /agent（机读自举页，纯文本）： 从 0 完成检测 → 下载 → 校验 sha256 → 安装 → 启动 → 验证 → 按操作标准接入。 测试版破坏性更新与"自留回退版本"的要求就写在那一页里，agent 必须照做。
- /agent — 机读自举页（检测/下载/安装/启动/接入/回退，纯文本，任何 agent 可执行）
- /latest.json — 最新版元数据（version/url/sha256/size/note/updated），官网只放最新版
- /download/latest — 最新版 zip
- /api/protocol — 运行中的后端提供的操作标准（机读权威；含 18 种操作与 R1–R10 规则）
- /api/brief — 增量简报；?full=1 完整重放（"继续"/接手）
接口手册（摘要）
完整版以运行中后端的 GET /api/protocol 为权威 · 文档版见包内 docs/AGENT_PROTOCOL.md
| 端点 | 说明 |
|---|---|
| GET /api/workspace | 工作区全量快照（素材/时间线/组/备注/问题/选区/消息/ASR/播放头） |
| GET /api/brief | agent 增量简报（推进读指针）；?full=1 完整重放 |
| POST /api/ops | 结构化操作计划（核心写通道；author=agent；baseRevisions 并发保护） |
| POST /api/messages | 对话记录（人/agent 共用；对话即工程记录） |
| POST /api/import/scan · /api/asr/index · /api/render | 导入 / 语音索引 / 渲染（异步任务） |
| GET /api/media/thumb · frame · crop · waveform | 缩略图 / 帧图 / 区域裁剪（人脸选区取证）/ 波形 |
| GET /api/events | SSE 实时事件（可选；无状态 agent 用 brief 即可） |
18 种操作（在 /api/protocol 有完整字段说明）：timeline.create clip.add/move/trim/delete
marker.add（批量跨全部时间线）note.add/status issue.add/status
group.create（inputPreview/result/mockPreview/reference/working/checkpoint）
selection.create message.add 等。
依赖部署（agent 自行部署/对接）
分发只含核心程序与说明，不含任何依赖——下载、部署、安装、测试全部由 agent 完成
ffmpeg / ffprobe 必须
媒体探测、缩略图、波形、场景检测、渲染全部依赖它。
winget install Gyan.FFmpeg 或 gyan.dev 下载解压、bin 入 PATH。
验证：ffmpeg -version、ffprobe -version
.NET 8 Desktop Runtime 必须
GUI 运行需要。winget install Microsoft.DotNet.DesktopRuntime.8
验证：dotnet --list-runtimes 含 WindowsDesktop 8.x
HEVC 视频扩展 按需
播放 HEVC 素材需要；H.264 素材可跳过。
Microsoft Store（9N4WGH0Z6VHQ）或把素材转码 H.264。
验证：Get-AppxPackage Microsoft.HEVCVideoExtension
ASR 语音索引 可选能力接口
能力接口全部由 agent 自行部署或对接。本项目只定义 HTTP 契约：
POST {ASR_URL}/asr?lang=zh&itn=1（body=音频字节 → segments 秒级时间戳）。
自部署：Python 3.12 + pip install sherpa-onnx soundfile numpy + 公开模型（HuggingFace sherpa-onnx-sense-voice + silero_vad），参考实现 services/asr/asr_server.py；或对接任何同契约现成服务（TLA_ASR_URL）。无 ASR 时语音检索不可用，其余功能正常。
OCR 等其余能力接口同理：契约化、外部化——本项目不含任何能力实现，agent 按契约部署或对接。 逐项验证命令与安装细节见 /agent 自举页（机读，含完整步骤）。
测试版说明（重要）
免费，但破坏性更新
!
① 免费：无时间限制的免费期（当前授权服务默认免费至 2029 年，可配置），
功能全部可用；未来若转收费，提前在官网与公告通知。
② 更新是破坏性的：工程文件格式与接口都可能在版本间变化。官网只保留最新版本。
更新前把现有安装目录改名 <目录>-bak-<日期>，新版本验证后再删。
③ 工程目录独立：workspace/（含完整历史 journal.jsonl）与程序分离，
升级程序不要动它。
④ agent 被标准要求自留可用版本并照做回退流程——这是对 agent 的硬规则，不是建议。
FAQ
必须要 agent 才能用吗？
不是。GUI 本身是完整的手动工具：导入/索引/查看/标记/备注/渲染。agent 是放大器——几十条时间线的批量活才需要它。
用哪个 agent / 哪个模型？
任意。agent 侧只要能执行 HTTP 调用即可，本项目不对接、不内置任何 LLM。对话发生在 agent 自己的对话框里，工程相关的讨论它必须写回本项目（操作标准 R6）。
素材会离开我的电脑吗？
不会。解码、索引、渲染全在本机。上传的只有加密的协作数据（对话与操作记录），服务器无法解密。
支持哪些视频格式？
ffmpeg 可读的均可导入（mp4/mkv/mov/flv/webm…）。GUI 播放依赖系统 HEVC/AV1 扩展；渲染输出 H.264 mp4。
ASR 索引是必须的吗？
可选。没有索引也能剪辑与打标记；有索引 agent 才能按台词精准标记（如"标记提到离婚的片段"）。本地 CPU 即可跑。
升级后打不开工程怎么办？
回退：把升级目录删掉/改名，恢复 <目录>-bak-<日期>。workspace/ 未动则数据无恙。
下载（面向 agent）
本下载不再针对人 —— 推荐 agent 直接下载并完成部署安装测试 · 官网只有最新版本 · 更新是破坏性的
推荐路径：把 https://v17.100000.plus 扔给你的 agent，说"用它来干活"。
agent 抓取 /agent 自举页自行完成：下载（校验 sha256）→ 依赖部署 → 安装 → 启动 → 测试接入。
分发包内只有核心程序与说明，不含任何依赖。
加载中…（若长时间无内容请确认网络）
agent 直接下载最新版（zip）
人也可以手动下载（解压到纯英文路径 → scripts\start_all.cmd），但依赖仍需按 依赖部署 自行安装。