oil-oil
0992d04b27
Status labels use official Pill and StateDot, 待发布 stays static, and overview no longer repeats subtitle actions. Sync copy is 「已发布，同步数据」; publish still goes through @ in the composer.
9.6 KiB
内容工作台使用说明
DeepSeek Harness 打开后，左侧切到「内容」，中间是一条片子的检查器，右边继续对话。一条片子对应 ~/Movies/视频项目/ 里的一个文件夹，名字是 日期_可读标题。
对话工具能不能走完整条片子
不能。片子的正文在影片目录的文件夹里，对话用系统自带的列文件、读文件、写文件去看和改。oil_* 只做文件做不到的事：按约定建文件夹、绑工程、等导出、生成或烧录字幕、生成封面、标记发布、同步已发布数据。它们不负责录屏、剪时间线、从 Screen Studio 导出成片、写四平台发布包、把视频上传到创作者后台，也不负责公众号成稿。
人仍然要自己完成这几件：
- 在 Screen Studio 里录制，并亲手导出 MP4
- 在字幕预览里确认专有名词后再烧录
- 看封面标题和错别字，决定要不要再生成
- 在各平台点最终「发表」
剪辑和四平台上传仍然走原来的 skill：screen-studio-editor、video-publisher。这两项没有做成 Harness 工具。公众号图文走 oil-video-article。
所以对话可以推动一条片子往前走，不能代替录制、导出和最终发表。
界面怎么用
左侧列表显示每条片子的阶段和时间。已经在任一视频平台发出去的，显示「已发布」；成片、字幕、封面都齐但还没发出去的，显示「待发布」。
点开一条片子，中间检查器不关右边的对话。检查器有五个页：概览、视频、脚本、字幕、文章。概览用封面旁的状态标明阶段，只展开当前步骤的按钮；封面并排显示 3:4 和 4:3。视频页播放带字幕成片，没有带字幕成片时播放原片。字幕和烧录由对话里的工具完成。文章页用 Markdown 渲染 公众号文章/ 里的成稿和配图。中间栏可以拖宽，大约到 800 像素。
右边输入 @，可以选择「当前详情」或搜以前的片子。发出去的是那一期的文件夹路径，封面、脚本、字幕都在里面，按 files.md 自己去列、去读。/current content 同样只带当前打开那条的文件夹路径。
设置在 Harness 的设置 → 插件 → 内容工作台。这里可以配置影片目录、enabledPlatforms、脚本规则（人设）和凭据。影片目录默认是 ~/Movies/视频项目。enabledPlatforms 有小红书、抖音、B 站、视频号四个开关，默认全部启用；AI 发布和数据同步只处理启用的平台，全部关闭时不执行这两项操作。脚本规则是写 script.md 时 AI 必须遵循的语气、结构和禁忌，也可以直接在对话里让 AI 记录，AI 会用 oil_script_rules 存到同一个地方。字幕转录使用百炼 DASHSCOPE_API_KEY，封面使用 ZenMux ZENMUX_API_KEY，两者和视觉识别共用官方凭据；页面只显示已配置或未配置，不会把 Key 读回来。
首次使用推荐选 Harness 的 standard 或 code Agent preset，再直接说「检查并配置内容工作台」。内置 creator-workbench Skill 会让 AI 先调用 oil_creator_setup 检查环境。AI 能从系统发现的目录和能力不再逐项追问；任何写入都会先预览，用户确认后才应用。minimal preset 没有 Skill 和文件工具，不适合首次引导、自动整理目录或修改正文。
装完不知道能做什么时，直接问「这个插件怎么用」。AI 会调用 oil_creator_guide，拿到带当前能力状态的完整指引后告诉你：哪些环节现在就能用，哪些还缺依赖。自动发布和已发布数据回收都依赖 Ego Browser；没装的时候 AI 会明说这两项不可用，片库、脚本、字幕、封面不受影响。
候选影片目录不存在时，先让 AI 展示准备创建的完整路径；确认后创建目录，再重新预览配置并确认应用。oil_creator_setup 只接受已经存在的目录，不会暗中创建文件夹。
对话里怎么读片子
先列出影片目录（默认 ~/Movies/视频项目），再打开 日期_标题 那个文件夹。脚本是 script.md，选题是 topic.md，文章在 公众号文章/。完整约定见 files.md。
插件工具只做这些：
| 工具 | 作用 |
|---|---|
oil_creator_guide |
自举指引：返回完整工作流和当前能力状态，用户问「这个插件怎么用」时先调它 |
oil_script_rules |
读或写脚本规则（人设）；写改 script.md 前先读 |
oil_creator_setup |
只读检查环境，或先预览、确认后保存目录和启用平台 |
oil_create_content |
按今天的日期新建文件夹 |
oil_update_content |
标记待录制、绑定工程、改某一平台的发布标记 |
oil_open_studio |
打开已绑定的 Screen Studio 工程 |
oil_wait_export |
等到文件夹里出现稳定的 MP4 / MOV |
oil_generate_subtitles |
转录、自动校对、排版；立刻返回；完成后打开预览，出现 subtitle-transcript.json，不烧录 |
oil_open_subtitle_preview |
在浏览器打开字幕预览编辑器 |
oil_burn_subtitles |
用户预览确认后再烧进成片；立刻返回；完成后出现 *_subtitled.mp4 |
oil_generate_cover |
一键生成 3:4 / 4:3 / 16:9 封面，立刻返回；完成后出现对应 png |
oil_sync_publish |
用 Ego 翻完启用平台的已发布列表，按标题或已存 id 写回播放 / 赞 / 评 |
oil_creator_profile |
读或改 enabledPlatforms，即 AI 发布和数据同步使用的平台列表 |
oil_organize_library |
预览或把文件夹改成 日期_可读标题，默认只预览 |
长任务都是先启动，再看文件夹里有没有产物，不要把一次启动当成已经完成。
新做一条片子
先在右边说这一期讲什么。可以让对话新建内容，例如：「今天做一期 DeepSeek Harness 安装上手，建文件夹，把选题写进笔记。」
对应工具是 oil_create_content。选题写进这一期的 topic.md，脚本写进 script.md，也可以之后在中间「脚本」页自己改。
录制用 Screen Studio。录完把 .screenstudio 工程绑到这一期，可以说：「把刚才的工程绑到这条，然后打开。」检查器里也可以点绑定或打开。
剪辑在对话里喊 screen-studio-editor，对照绑定的工程清理停顿和误讲。工作台只负责打开工程，不替你改时间线。预览满意后，在 Screen Studio 里亲手导出 MP4，导出目标就是这一期的文件夹。
导出开始后说：「等这条的成片落盘，落盘后生成字幕和封面。」oil_wait_export 会等到文件大小稳定。成片到了再用 oil_generate_subtitles 出字幕稿并打开预览；用户确认后再 oil_burn_subtitles。封面用 oil_generate_cover，调用前先按 oil-cover 提炼主标题传入 title。生成后要在对话里核对标题和错别字，不对就再说一次生成。
首次 clone oil-subtitle 后必须运行 bash ~/.agents/skills/oil-subtitle/setup.sh，否则字幕工作流不会就绪。不要在预览前烧录。oil_burn_subtitles 不会覆盖已经带字幕的成片文件名习惯，产物文件名里带 _subtitled。
成片、字幕、封面齐了，阶段会变成「待发布」。四平台上传仍然用 video-publisher，但只处理 enabledPlatforms 中启用的平台；做到各平台的最终发表按钮前停下，你自己点发表。在右侧输入框 @ 这条片子，再说用 video-publisher 发布。「已发布，同步数据」从创作者后台回收播放、赞和评论。同步只翻启用平台的已发布列表，再对到本地片子；90 秒内再点一次会直接用刚才的结果。每次同步开一个新的 Ego 空间，采完就关掉。平台上有、本地没有文件夹的，不会自动新建一条片子。
公众号不是第五个视频平台。需要图文时，另外喊 oil-video-article。工作台只显示文件夹里有没有 公众号文章/。
把一条没做完的旧片子收尾
先打开那条，或 @ 它，或者说出文件夹路径，例如 ~/Movies/视频项目/2026-08-13_DeepSeek Harness 安装上手。让对话列出这个文件夹，看缺的是工程、成片、字幕、封面、文章还是发布标记。
常见说法：
- 「这条还缺什么，缺的就做。」
- 「绑定这个工程：
~/Screen Studio Projects/...」 - 「生成字幕，完了打开预览。」
- 「字幕我看过了，烧进去。」
- 「再生成一版封面。」
- 「把脚本改成下面这一版，写进 script.md。」
- 「小红书标成已发布。」
- 「同步四个平台的播放和点赞。」
列表阶段会跟着变。已经在平台发出去的，左侧会显示「已发布」，不再显示「待发布」。
同步之后数据在哪里
同步成功后，播放、赞、评论和链接写在 ~/.dsh-oil-creator/overlay.json。检查器的视频平台卡会显示这些数字，并提供「打开作品」。同步会翻完各平台创作者后台的已发布列表；平台上有、本地没有文件夹的不会自动建条目。视频号需要 Ego 里已经登录创作者后台。
设置和目录
第一次用先让 AI 检查环境，再确认影片目录。字幕、封面、Screen Studio 和 Ego Lite 都是可选能力，缺少时不会影响片库和脚本管理。字幕和封面没有 Key 时，对应按钮会提示去设置里填写。有成片后，检查器里可以生成字幕稿并打开预览，确认后再烧录；封面也可以在检查器里生成，不用再走对话。
文件夹名被连字符弄乱时，可以说：「预览整理影片目录。」确认后再让它真正重命名。oil_organize_library 默认只预览，不会删文件。