# 编导专业提词器

**Repository Path**: ssdjjs/directors-script-assistant

## Basic Information

- **Project Name**: 编导专业提词器
- **Description**: 专为短视频批量口播拍摄打造的一站式脚本提词 + 素材整理工具。 从「脚本导入 → 分场景管理 → 现场提词 → 镜号标注 → 一键导出 → 后期对素材」全流程打通。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 编导专业提词器, 提词器, 专业提词器, 短视频提词器

## README

# 帅帅的口播提词器 · 自动分素材

> 专为短视频批量口播拍摄打造的一站式**脚本提词 + 素材整理**工具。
> 从「脚本导入 → 分场景管理 → 现场提词 → 镜号标注 → 一键导出 → 后期对素材」全流程打通。

微信小程序 · 支持云同步 · 支持投屏监看 · 免费使用

<!--
【放截图用】把功能截图放到 docs/images/ 目录，然后取消下面注释即可在 Gitee / GitHub 显示：

## 功能截图

| 首页 · 日期分组 | 提词板 · 横屏提词 |
|---|---|
| ![首页](docs/images/home.png) | ![提词板](docs/images/teleprompter.png) |

| 批量导入 | 一键导出 |
|---|---|
| ![导入](docs/images/import.png) | ![导出](docs/images/export.png) |
-->

---

## 目录

- [一、这是什么](#一这是什么)
- [二、解决什么问题](#二解决什么问题)
- [三、核心功能](#三核心功能)
- [四、快速上手（3 步）](#四快速上手3-步)
- [五、使用说明](#五使用说明)
  - [5.1 导入脚本](#51-导入脚本)
  - [5.2 场景与台词管理](#52-场景与台词管理)
  - [5.3 拍摄提词](#53-拍摄提词)
  - [5.4 镜号与备注](#54-镜号与备注)
  - [5.5 一键导出](#55-一键导出)
  - [5.6 投屏接收](#56-投屏接收)
  - [5.7 云同步与备份](#57-云同步与备份)
  - [5.8 回收站与归档项目](#58-回收站与归档项目)
  - [5.9 主题与设置](#59-主题与设置)
  - [5.10 使用统计](#510-使用统计)
- [六、脚本导入模板（可直接复制）](#六脚本导入模板可直接复制)
- [七、常见问题 FAQ](#七常见问题-faq)
- [八、技术栈与项目结构](#八技术栈与项目结构)
- [九、更新记录](#九更新记录)
- [十、反馈与联系](#十反馈与联系)

---

## 一、这是什么

**帅帅的口播提词器**是一款专门服务于短视频批量拍摄场景的提词工具。

和市面上通用提词器最大的区别：它不只是「把字滚动起来」，而是把**编导写词 → 现场提词 → 拍完分素材**这条完整链路做进了一个工具里。

编导发来的 Word 台词文档，直接粘贴进小程序，系统会**自动识别场景、自动拆分台词**；拍摄现场用横屏大字提词；拍完一键导出带镜号的文档，后期按镜号直接对素材，不用再翻聊天记录找词。

适用人群：

- 短视频编导、导演、拍摄团队
- 口播博主、探店达人、知识类创作者
- 需要批量拍多条、且要保证脚本与素材一一对应的团队

---

## 二、解决什么问题

| 真实痛点 | 这个工具的做法 |
|---|---|
| 编导发来几千字没分段的 Word，现场找不到词在第几段 | 批量粘贴，**自动按场景拆分**，一秒建好目录 |
| 一条条手动录入台词，整理比拍还累 | 支持一次性导入整篇脚本，**智能分场景 + 分台词** |
| 拍完不知道哪条拍了、哪条没拍，容易漏拍重拍 | 台词卡片实时显示**已拍 / 未拍 / 待修改 / 已作废**状态 |
| 后期对素材全靠人肉翻聊天记录 | 台词可标注**镜号**，导出后与实拍素材一一对应 |
| 脚本没法给后期，剪辑要重新抄词 | **一键导出 Word**，格式规整、带镜号，直接对接剪辑 |
| 电脑上改词，手机上还要重新复制一遍 | **多端云端同步**，电脑改完手机直接刷新 |
| 误删脚本找不回来 | **永久回收站**，随时恢复误删内容 |
| 提词器字太小、反光、看不清 | 字号 / 加粗 / 行距 / 颜色 / 背景 / 镜像翻转全可调 |
| 导演在监视器位置看不到提词内容 | **投屏接收**，另一台设备实时同步提词画面 |

---

## 三、核心功能

| # | 功能 | 说明 |
|---|---|---|
| 1 | **多场景素材分类管理** | 按日期／项目分组拍摄，单个场景可容纳多条台词，自动分组展示、清晰归类 |
| 2 | **批量脚本智能自动拆分** | 粘贴整篇脚本，自动识别「（场景一）」等标记，智能分场景拆分导入 |
| 3 | **拍摄进度状态可视化** | 已拍 / 未拍 / 待修改 / 已作废四态，一眼看清待拍内容，避免漏拍重拍 |
| 4 | **台词快速编辑与复用** | 拍摄现场随时改词，支持撤回、标记重点、一键复制成品台词 |
| 5 | **提词板快捷操作** | 一键回顶 / 一键回底 / 隐藏界面，超长台词无需手动滑 |
| 6 | **镜号自定义标注** | 每条台词可加多个镜号（如 `#2` `#3`），精准匹配机位与素材片段 |
| 7 | **多场景脚本一键导出** | 单选或批量多选，导出带镜号的完整 Word 脚本，直接对接后期剪辑 |
| 8 | **永久回收站** | 删除的脚本自动进回收站，可随时恢复，也可彻底清理 |
| 9 | **电脑手机实时云同步** | 电脑端改完手机端实时同步，无需反复复制导入；另支持导出 / 导入备份文件 |
| 10 | **完整创作数据统计** | 自动统计场景 / 脚本 / 拍摄条数与提词时长，支持自定义时间范围 |
| 11 | **投屏接收** | 一台发起、一台接收，设备码一机一码，导演位可实时看到提词内容 |
| 12 | **多主题外观** | 浅色 / 深色 / 暖色三套主题，深色护眼、暖色柔和 |

---

## 四、快速上手（3 步）

### 第一步：导入脚本，自动拆分场景

把编导的台词文档复制粘贴进「批量拆分」，系统自动识别场景与台词，一键建好目录。

> 格式要求很简单：场景用 `（场景一）` 标记，台词用 `1.` 或 `#标题#` 标记。详见[第六节模板](#六脚本导入模板可直接复制)。

### 第二步：现场拍摄提词

进入「拍摄提词」或场景详情，点「开始提词」进入横屏提词板：大字滚动、可调速度、可镜像翻转、音量键翻页。

拍摄过程中随手标记状态（已拍 / 未拍）、补镜号、写备注。

### 第三步：一键导出，对接后期

拍完在「我的 → 一键导出」里勾选需要的场景／台词，导出 Word 文档。
导出的脚本带镜号，和视频素材放同一个文件夹，用配套的分素材工具即可自动归档。

---

## 五、使用说明

### 5.1 导入脚本

入口：首页 →（或）场景页 → **批量拆分场景台词** → 粘贴文本 → 一键拆分

系统识别的规则：

| 你写的格式 | 识别结果 |
|---|---|
| `（场景一）产品介绍` | 新建一个场景，标题为「产品介绍」 |
| `1.#开场白#` | 新建一条台词，标题「开场白」，其下的子序号行合并进这条正文 |
| `1. 大家好，今天……` | 新建一条台词，内容为整行 |
| `#开场白#`（整行，≤50 字） | 一条台词的开始标记 |
| 普通文本行 | 自动并入上一条台词正文（支持一条台词多行） |

> 小技巧：
> - 场景标记支持全角 `（）` 和半角 `()`，也支持 `（场景1）` 这种阿拉伯数字。
> - `#标题#` 超过 50 个字不会被识别为标题，避免长句被误判。
> - 导入前建议把文档里的多余空行删掉，正文更干净。

### 5.2 场景与台词管理

- **首页**：按日期分组的「日期卡片」，标题栏显示该日期的场景数、台词数与已拍／未拍统计；点击标题栏可**折叠 / 展开**。
- **多项目**：顶部项目胶囊可切换项目，支持新建项目、归档项目（归档项目入口在设置页）。
- **场景详情**：可改场景标题、增删台词、进入批量模式（多选批量改状态 / 删除）。
- **搜索**：首页与场景详情页右下角均有搜索按钮，可按标题或台词内容实时过滤。
- **台词编辑**：支持正文编辑、撤回、清空、标记重点、一键复制、添加镜号与备注。

### 5.3 拍摄提词

入口：底部「拍摄提词」标签，或从场景／台词页点「开始提词」。

提词板可调项：

| 类别 | 可调内容 |
|---|---|
| 滚动 | 播放速度、播放 / 暂停、一键回顶、一键回底 |
| 文字 | 字体大小、字体加粗、字间距、行间距、左右边距 |
| 颜色 | 背景色、字体颜色 |
| 操作 | 音量键翻页、防误触、提词计时 |
| 特殊 | 镜像翻转（贴提词镜 / 反光板拍摄）、隐藏界面、显示 / 隐藏 |

> 镜像翻转：开启后文字左右翻转，用于配合提词镜、反光板等物理提词方案。
> 防误触：开启后需长按才响应，避免拍摄中手滑打断提词。

### 5.4 镜号与备注

在台词编辑页 →「添加镜号」，可新增多行镜号（如 `#2` `#3`）。

- 镜号用于把**台词**和**实拍视频片段**对应起来。
- 导出文档时，镜号信息会体现在 `#标题#` 后方（形如 `#开场白#（0001）`）。
- 同一编号在后续素材整理工具中会被识别，自动把对应素材归入该文件夹。

另支持**添加备注**，用于记录拍摄注意事项；以及**记录转写**（现场录音自动转文字，最多保留三条，长按可删）。

### 5.5 一键导出

入口：我的 → **一键导出** → 选择导出内容 → 导出 Word 文档

- 支持单选、批量多选场景或台词。
- 导出格式为真正的 `.docx`（Word / WPS 可直接打开），文字**左对齐**，排版规整。
- 文件名规则：`提词导出_日期_时分_条数.docx`
  例：`提词导出_2026-09-14_1630_12条.docx`
  （日期 + 导出时间 + 实际台词条数，同一天多次导出也不会重名）

### 5.6 投屏接收

入口：我的 → **投屏接收**

两种角色：

- **我是主播（发起投屏）**：选择设备码，把你正在提词的内容投过去。
- **我是观众（接收投屏）**：显示本机设备码与二维码，把码给对方即可被投屏。

使用步骤：

1. 接收方打开「我是观众」，看到「我的设备码」与二维码。
2. 主播方点「添加设备」→「扫码填入」扫对方二维码，或手动输入设备码，可加备注（如「客厅平板」）。
3. 点「开始投屏」，接收方即可实时看到提词画面（同步显示标题、正文、播放状态，可切横竖屏、可断开）。

> 设备码是**一微信账号一码**，保存在云端，清缓存、重装小程序、换手机（同一微信）都不会变。

### 5.7 云同步与备份

入口：设置 → **同步与备份**

| 功能 | 说明 |
|---|---|
| 云同步 | 连接云端后，手机 / 电脑端数据实时同步，显示环境与最近同步时间，可手动「立即同步」 |
| 导出备份 | 把全部数据导出为备份文件，可分享到「文件传输助手」长期保存 |
| 导入恢复 | 选择备份文件恢复数据（换机、误删后的兜底方案） |

> 未开通云空间时会自动使用本地存储，功能不受影响，只是不能跨设备同步。

### 5.8 回收站与归档项目

- **回收站**：删除的台词 / 场景自动进入回收站，可查看、恢复或一键彻底清理。入口在「我的」页面。
- **归档项目**：不常用但不想删的项目可归档，入口在设置页，归档后可随时取回。

### 5.9 主题与设置

入口：我的 → 设置

| 设置项 | 说明 |
|---|---|
| 主题 | 浅色 / 深色 / 暖色 三套，全局生效 |
| 首页搜索 | 开 / 关首页搜索按钮（关闭后两页搜索都会隐藏） |
| 拍摄提词 | 多机位等相关选项 |
| 题词自动录音 | 进入提词板时自动录制现场音频 |
| 同步与备份 | 见 5.7 |
| 归档项目 | 见 5.8 |
| 软件功能 | 应用内功能说明 |
| 软件反馈 | 提交意见反馈 |
| 使用文档 | 查看完整图文使用手册，可保存 / 分享 |
| 联系客服 | 扫码添加客服 |

### 5.10 使用统计

入口：我的 → 数据统计

- 展示场景数、脚本数、拍摄数、提词时长四项指标。
- 支持按时间范围查看（今日 / 本周 / 本月 / 自定义起止日期）。
- 点击可进入「使用统计」详情页，查看场景 / 脚本 / 拍摄 / 时长的图表概览与明细列表。

---

## 六、脚本导入模板（可直接复制）

把下面的内容替换成你的台词，粘贴进「批量拆分」即可：

```
（场景一）开场介绍

1.#开场白#

大家好，我是帅帅。今天给大家分享三个拍摄小技巧。

2.#技巧一#

第一个技巧，拍摄前先对好白平衡。

（场景二）产品演示

1.#产品特写#

镜头推近产品，展示细节质感。

2.#使用场景#

我们在真实场景中演示产品的使用方法。

（场景三）结尾引导

1.#关注引导#

觉得有用的话，点个关注，下期见。
```

对应的识别结果：

- 3 个场景：开场介绍 / 产品演示 / 结尾引导
- 每个场景下 2 条台词，标题分别是 `开场白`、`技巧一`、`产品特写`、`使用场景`、`关注引导`

> 如果文档本身已经是 `1. 2. 3.` 的编号格式，也可以直接粘贴，系统会按序号自动分段。

---

## 七、常见问题 FAQ

**Q1：导入后没有正确分成多个场景？**
检查场景标记是否写成 `（场景一）` 的形式（全角或半角括号都可以，`场景` 二字不能少）。如果整篇都没有场景标记，所有台词会被归到同一个场景里，可在导入后手动拆分。

**Q2：`#标题#` 没有被识别成标题？**
标题内容不能超过 50 个字，且必须**整行**只有 `#标题#`。超长或被其他文字包围都不会识别。

**Q3：提词时字太小 / 看不清？**
提词板 →「设置」里可调字体大小、字体加粗、行距、左右边距，还能换背景色和字体颜色。深色背景下建议用浅色字并开启加粗。

**Q4：投屏一直提示失败？**
按提示排查：
- 提示「房间集合未创建 / 无权限」→ 需要在云端创建投屏房间数据集合，并把权限设为「所有用户可读，仅创建者可读写」。
- 提示「设备码被占用」→ 让对方在接收页点「断开」结束旧连接后重试。
- 提示「云开发未开通」→ 检查云开发服务是否到期或欠费。

**Q5：设备码会每天变吗？**
不会。设备码保存在云端、按微信账号隔离，属于「一微信一码」。清缓存、重装小程序、同一微信换手机都不会变。
（前提：云端服务正常、数据未被清理。）

**Q6：删掉的台词还能找回来吗？**
能。删除的内容进入「回收站」，在「我的 → 回收站」里恢复即可。

**Q7：换手机数据会不会丢？**
只要开启并完成过云同步，换机登录同一微信后同步即可恢复；也可以用「导出备份 / 导入恢复」手动迁移。

**Q8：导出文件名后面的数字是什么？**
是导出时间和条数，格式为 `提词导出_2026-09-14_1630_12条.docx`，表示 9 月 14 日 16:30 导出的 12 条台词。

**Q9：使用收费吗？**
功能全部免费开放，没有功能锁。

**Q10：邀请码有什么用？**
使用满 30 天后可在「我的 → 邀请码」生成专属邀请码。好友填写后：
- 好友获得 **1 年 VIP**
- 你获得 **3 个月 VIP**（可累计叠加）

---

## 八、技术栈与项目结构

**运行平台**：微信小程序（另有一套 uni-app 工程可打包 Android / iOS）

**技术栈**：微信原生小程序 + uni-app (Vue 3) 双引擎、JavaScript (ES6+)、微信云开发（云数据库 / 云函数 / 云存储）

**核心模块**：

```
utils/
├── store.js        数据存储（场景 / 台词 / 项目 / 回收站）
├── batchParse.js   脚本批量解析（自动分场景、分台词）
├── titleExtract.js #标题# 标题提取
├── docx.js         纯前端生成 .docx（OOXML）
├── export.js       导出流程与文件命名
├── cast.js         投屏（云端房间 + 设备档案）
├── sync.js         云同步
├── recorder.js     录音与语音转写
├── theme.js        主题（浅色 / 深色 / 暖色）
└── stats.js        使用统计
```

**目录说明**：

| 目录 | 说明 |
|---|---|
| `shuaishuai-uni/` | uni-app (Vue 3) 工程，同一套代码可出小程序 / 安卓 / iOS |
| `shuaishuai-prompter/` | 微信原生小程序工程 |
| `shuaishuai-prompter/cloudfunctions/` | 云函数（语音转写、文档导出、邀请码、反馈管理等） |

> 两个工程功能保持同步，共享同一套业务逻辑与数据格式。

---

## 九、更新记录

### v1.0.0（2026-09）

- 场景 / 台词管理，支持批量导入自动拆分场景
- 横屏提词板：速度、字号、加粗、行距、边距、颜色、镜像翻转、音量键翻页、防误触、计时
- 镜号标注与备注，导出对接后期分素材
- 一键导出 Word（左对齐，文件名含日期 + 时间 + 条数）
- 多项目与归档项目管理
- 永久回收站
- 云同步与备份 / 恢复
- 投屏接收（设备码一机一码，可加设备备注）
- 使用统计（场景 / 脚本 / 拍摄 / 时长）
- 浅色 / 深色 / 暖色三套主题
- 邀请码（邀请双方得 VIP）

---

## 十、反馈与联系

- 小程序内：**我的 → 设置 → 软件反馈**，可直接提交问题与建议
- 小程序内：**我的 → 设置 → 联系客服**，扫码添加客服微信
- 项目仓库：欢迎提交 Issue 反馈问题或建议

---

<p align="center">如果这个工具帮到了你，欢迎给个 Star ⭐</p>