CueFlow Timeline

在 Obsidian 中编排一场演示：把人员、设备、动作与依赖关系放到同一条秒级时间轴上。

CueFlow 是面向发布会、舞台执行、多设备演示和 Run of Show 的桌面插件。通过泳道组织资源，拖动安排动作，用连线表达前后依赖、同时开始、同时结束或关联目标。项目保存在知识库的 Markdown 文件中，支持完整 JSON / Markdown 导入导出，也可交给外部 AI 优化后回导。

下载 v0.10.0 · 核心功能详解 · 安装指南 · 完整操作手册 · 快捷键 · English

界面示例。v0.10.0 新增同步连线、近距离连线优化和鼠标位置复制粘贴，具体操作见手册。

适合用来做什么

• 发布会与舞台执行：编排主持、画面、灯光、场控等角色，按相对时间排练。
• 无人机与多设备演示：分组管理飞手、无人机、地面设备，标明执行顺序与同步节点。
• 方案讨论与交付：用 SVG 分享时间轴，用 CSV 查看排程，用完整项目文件交换可继续编辑的方案。

插件在本地运行，无需注册账户、API Key、npm 或其他任务插件。AI 优化通过用户自行选择的外部工具完成，插件负责文件交换、约束检查和变化预览。

五分钟开始

1. 从 Release 下载 cueflow-plugin-v0.10.0.zip，解压到 <知识库>/.obsidian/plugins/。
2. 确认最终目录为 .obsidian/plugins/cueflow-timeline/，其中直接包含 main.js、manifest.json、styles.css；重启 Obsidian 并启用插件。
3. 点击侧栏时钟图标，或在命令面板搜索「打开演示脚本时间轴」。首次打开会生成演示项目。
4. 用「+ 项目」「+ 分组」「+ 泳道」建立自己的方案。双击泳道空白处创建动作并直接输入标题。
5. 拖动动作调整时间与泳道，拖动边缘调整时长；从动作节点拖线建立依赖或同步关系。
6. 点击「▶ 排练」核对执行节奏，通过「导入 / 导出」保存完整交换文件，或导出 CSV / SVG。

详细目录结构、升级与回退步骤见 安装指南。GitHub 自动提供的 Source code 压缩包用于查看源码；普通用户下载上面命名的插件安装包。

核心功能怎么用

用分组和泳道回答「谁来执行」

建立导播组、飞手组、设备组，再为导播、飞手 A、无人机各建一条泳道；把动作放在实际执行资源的行上，就能看到每个资源在什么时间忙碌。拖动泳道手柄可跨组排序，拖动分组会带着全部内容一起移动，动作时间与连线保持。分组只是资源分类，放在同一组不会让动作自动同步。

在秒级时间轴上安排「什么时候做、做多久」

双击泳道空白处创建动作并写标题，双击已有动作改标题，右键编辑详情。拖中央改起点，拖边缘改时长：例如 30–50 秒的动作整体后移 10 秒，成为 40–60 秒；只把右边缘拉长 10 秒，则成为 30–60 秒。

总时长决定整场时间范围；缩放只改变屏幕显示大小；紧凑显示让更多泳道同屏；拖宽左栏可显示更长的名称。吸附决定拖动步长，对齐虚线提醒接近的起止点。这些设置与动作本身的时长不同。

用四种连线表达执行规则

把一个动作节点拖到另一个动作的对应节点：右左表示前置完成后开始，左左表示同时开始，右右表示同时结束，上下表示关联或目标。前后依赖与同步可能让相关动作跟随调整，普通关联只显示关系。下方表格给出了具体时间变化；更完整的拖动、时长修改和约束冲突示例见 核心功能详解。

一次移动、拉伸或复制整段流程

空白拖框多选后，拖动其中任一动作可统一延后或跨泳道移动，保留相对时间与泳道间隔；拖选框两端则等比例调整动作时长和内部间隔。例如 A 为 30–50 秒、B 为 60–80 秒，整体后移 60 秒后是 90–110 秒与 120–140 秒，原有时长和 10 秒间隔保持。

需要复用时，选中后 Ctrl+C，鼠标放到目标时间/泳道后 Ctrl+V。副本保留内部依赖、同步、关联和标注，移除与未选中动作的外部关系，原动作保持。一次批量操作或粘贴可用一次 Ctrl+Z 撤销。

标出重点，再按时间排练

选中动作添加金色星标，突出开场、关键演示等重点；将时长设为零则生成里程碑。星标是关注标记，不会锁定时间或自动提升排程优先级。同泳道重叠用红色虚线提示资源可能冲突；动作状态供人工记录计划、进行、完成。

点击「▶ 排练」，通过相对计时、进度红线和当前动作高亮核对节奏，可暂停或归零。排练不发送设备控制指令。编辑自动保存到本地 Markdown，遇到保存冲突时可先保存为副本，再比较或重新读取。

交换完整方案，让 AI 优化后继续编辑

导出完整 JSON / Markdown，保留人员设备、动作、全部关系、备注和星标；交给外部 AI 优化，再导入查看具体变化，确认后保存为新项目，原方案保留。例如要求“保持关键动作时间，减少同一飞手的重叠”，在预览中核对 AI 移动了哪些动作。

插件负责文件交换、约束校验与变化预览，AI 由用户选择的外部工具完成。CSV 用于排程表，SVG 用于图形交付；需要继续编辑或 AI 回导时，使用完整项目文件。

详细的场景、操作、数值前后对比与边界，见 核心功能详解；按按钮一步步操作，见 完整操作手册。

功能与操作速查

功能	操作与效果
秒级时间轴	相对时间从 T+00:00 开始；1 / 5 / 10 / 30 / 60 秒吸附；项目总时长 1 分钟至 24 小时
缩放与紧凑显示	加减按钮、Ctrl+滚轮、适应窗口；人员/设备可紧凑展示，左栏可拖动调整宽度
自定义分组与泳道	命名、改色、折叠；泳道组内或跨组拖动；整组连同内容一起排序
动作编辑	单击选中，双击改标题，右键编辑详情；拖动移动，边缘拉伸时长
对齐提醒	移动与拉伸时显示虚线时间参考线和目标泳道提示
框选与批量调整	空白拖框多选；整体移动时间/泳道，整体等比例拉伸
关键动作	单个或批量添加金色星标，保留在项目文件及导出中
前后依赖	右节点 → 左节点表示前置结束后开始；可启用后续动作自动顺延
同时开始 / 结束	左左连接同步开始，右右连接同步结束，拖动与改时长继续保持约束
关联 / 目标	上下节点连接只表达关系，不参与排期
连线显示与标注	默认无文字；双击添加标注；短线自适应，长线竖段可从动作下方穿过，横段避让
复制粘贴	Ctrl+C/V 在鼠标位置粘贴，保留相对布局和内部关系，移除外部关系
里程碑与排练	零时长里程碑；相对计时、暂停、归零和进度红线
保存与恢复	Markdown 本地存储、保存状态与冲突提示；视图内最多 60 次撤销快照
文件交换	完整 JSON / Markdown、AI 修改预览与导入为新项目；CSV 排程表、SVG 矢量图

四种连接，如何选择

连接方式	含义	操作后的具体例子
A 右 → B 左	A 完成后，B 才能开始	开启顺延，A 结束从 30 改为 50 秒，原 30 秒开始、持续 60 秒的 B 推后为 50–110 秒
A 左 ↔ B 左	A 与 B 同时开始	A 为 30–50 秒，B 持续 40 秒；从 A 起拖连线后 B 为 30–70 秒
A 右 ↔ B 右	A 与 B 同时结束	A 为 30–50 秒，B 持续 40 秒；从 A 起拖连线后 B 为 10–50 秒
上/下节点 → 上/下节点	关联、目标或配合关系	只显示关系，两个动作的起点与时长均保持

同步线使用橙色与双端菱形；关联线为虚线；依赖线为实线。上述同步例子假设没有其他约束。关闭「依赖顺延」只停止前后依赖自动推后，同时开始/结束仍生效；无法满足的约束会拒绝修改。连线默认无文字，双击可见线段可添加或修改标注，详见 连线与排程。

文档导航

文档	内容
核心功能详解	每项功能解决的问题、怎样操作、实际结果与易混淆规则
安装、升级与回退	环境要求、三文件安装、备份、版本升级、卸载
完整操作手册	从建项目到排练交付，覆盖全部主要交互与设置
鼠标与快捷键速查	选择、框选、复制、删除、撤销、缩放与输入框行为
项目文件与 AI 优化	JSON / Markdown 格式、同步字段、AI 提示词和回导流程
常见问题与故障处理	插件不出现、连线失败、粘贴失败、保存冲突与性能
版本更新记录	各版本功能与修复
v0.10.0 发布说明	下载、改动、兼容性与验证范围
验收记录	已完成的测试、实际环境与覆盖边界
贡献指南	反馈问题、修改源码与提交改进

示例与 AI 工作流

示例 Markdown 项目 可放入知识库的项目目录后打开；完整 AI 项目包 可通过「导入 / 导出 → 导入项目文件」载入。

推荐流程：编排原方案 → 导出完整项目并填写优化目标 → 交给 AI → 导入并比较变化 → 保存为新项目 → 人工排练确认。 完整文件保留分组、泳道、动作、备注、依赖、同步、关联、标注、关键星标和项目正文。CSV 用于排程表，继续编辑或 AI 往返请使用完整项目文件。

支持范围与数据

项目	当前说明
插件版本	0.10.0
Obsidian	manifest 声明最低 1.5.0；本轮实测 Windows / Obsidian 1.14.4
平台	桌面端；macOS / Linux 未完成同等客户端验收；不支持移动端
项目数据	格式 5；旧项目可读取，保存后使用格式 5
可移植包	cueflow.project / 1，JSON 或 Markdown
导入上限	5 MB、3000 动作、500 泳道、关联与同步连线合计 10000 条；上限不代表已验证的日常容量
开源许可	MIT

排程保存为知识库内的 Markdown；显示偏好保存在插件配置中。插件不内置远程 AI 调用或遥测上传。选择外部 AI、云盘或知识库同步服务时，由用户决定分享哪些文件。

当前用于桌面端、单人本地编排与人工排练。帧级/毫秒级时间、多人实时编辑、设备自动控制不在当前功能内。同泳道重叠会提示，但最终资源可行性需人工核对。v0.10.0 已通过相关本地检查及 23 项客户端增量检查，未进行全量回归；详见 验收记录。

反馈与开发

问题反馈和功能建议请提交到 GitHub Issues。请附版本、操作步骤和经过脱敏的最小示例。

开发使用 Node.js 18+。源码直接以 main.js 发布，无额外构建依赖；相关检查命令与发布流程见 贡献指南 和 维护者发布指南。