# 内容工作台使用说明

DeepSeek Harness 打开后，左侧切到「内容」，中间是一条片子的检查器，右边继续对话。一条片子对应 `~/Movies/视频项目/` 里的一个文件夹，名字是 `日期_可读标题`。

## 对话工具能不能走完整条片子

不能。片子的正文在影片目录的文件夹里，对话用系统自带的列文件、读文件、写文件去看和改。`oil_*` 只做文件做不到的事：按约定建文件夹、绑工程、等导出、生成或烧录字幕、生成封面、标记发布、同步已发布数据。它们不负责录屏、剪时间线、从 Screen Studio 导出成片、写四平台发布包、把视频上传到创作者后台，也不负责公众号成稿。

人仍然要自己完成这几件：

- 在 Screen Studio 里录制，并亲手导出 MP4
- 在字幕预览里确认专有名词后再烧录
- 看封面标题和错别字，决定要不要再生成
- 在各平台点最终「发表」

剪辑仍走 `screen-studio-editor`。上传优先使用已安装的 `jacky-video-publisher`；没有 Jacky 版时兼容公开的 `video-publisher`，不会把兼容包改名伪装成 Jacky Skill。这两项没有做成 Harness 工具。公众号图文走 `oil-video-article`。

所以对话可以推动一条片子往前走，不能代替录制、导出和最终发表。

## 界面怎么用

左侧列表显示每条片子的阶段和时间。已经在任一视频平台发出去的，显示「已发布」；成片、字幕、封面都齐但还没发出去的，显示「待发布」。

点开一条片子，中间检查器不关右边的对话。检查器按真实资产分成：概览、脚本、演示、视频、字幕、封面、文章。概览只显示状态；演示页调用 Jacky Motion 并保留审稿、分镜、选风格三个确认门；封面页通过 ZenMux 生成 Jacky Cover 三画幅；文章页把 script.md 改写成 `公众号文章/<标题>.md` 并用 Markdown 渲染。中间栏可以拖宽，大约到 800 像素。

右边输入 `@`，可以选择「当前详情」或搜以前的片子。发出去的是那一期的文件夹路径，封面、脚本、字幕都在里面，按 [files.md](files.md) 自己去列、去读。`/current content` 同样只带当前打开那条的文件夹路径。

设置在 Harness 的设置 → 插件 → Jacky Creator。这里会逐项显示 DSH 实际可发现的能力，并配置影片目录、`enabledPlatforms`、脚本规则（人设）和凭据。影片目录默认是 `~/Movies/视频项目`。小红书、抖音、B 站、视频号默认都不勾选；只勾选你确实拥有账号的平台。勾选只代表允许 AI 发布和数据同步，不代表已经登录。点“检测登录状态”会用 Ego Browser 只读访问创作者后台；需要登录或无法确认时，点“打开登录页”，登录完成后重新检测。全部关闭时不执行发布或同步。

环境状态中的“重新检测”会检查内容目录、Screen Studio、字幕、Jacky Cover、自动剪辑、自动发布、Jacky Motion 和 Ego Browser。公开依赖可以在明确确认后安装到 `~/.agents/skills`，不会覆盖已有目录；字幕安装会运行固定版本自带的 `setup.sh`。Jacky Cover 和 Jacky Motion 的品牌私有层没有可验证公开安装源时，页面只说明缺失，不伪造一键安装。自动发布的公开兼容包仍保留 `video-publisher` 身份，首次配置会按已保存的平台写入其发布偏好。

脚本规则是写 `script.md` 时 AI 必须遵循的语气、结构和禁忌，也可以直接在对话里让 AI 记录，AI 会用 `jacky_creator_script_rules` 存到同一个地方。字幕转录使用百炼 `DASHSCOPE_API_KEY`，封面使用 ZenMux `ZENMUX_API_KEY`，两者和视觉识别共用官方凭据；页面只显示已配置或未配置，不会把 Key 读回来。

首次使用推荐选 Harness 的 `standard` 或 `code` Agent preset，再直接说「检查并配置内容工作台」。内置 `jacky-creator-workbench` Skill 会让 AI 先调用 `jacky_creator_setup` 检查环境。AI 能从系统发现的目录和能力不再逐项追问；任何写入都会先预览，用户确认后才应用。`minimal` preset 没有 Skill 和文件工具，不适合首次引导、自动整理目录或修改正文。

装完不知道能做什么时，直接问「这个插件怎么用」。AI 会调用 `jacky_creator_guide`，拿到带当前能力状态的完整指引后告诉你：哪些环节现在就能用，哪些还缺依赖。自动发布和已发布数据回收都依赖 Ego Browser；没装的时候 AI 会明说这两项不可用，片库、脚本、字幕、封面不受影响。

候选影片目录不存在时，先让 AI 展示准备创建的完整路径；确认后创建目录，再重新预览配置并确认应用。`jacky_creator_setup` 只接受已经存在的目录，不会暗中创建文件夹。

## 对话里怎么读片子

先列出影片目录（默认 `~/Movies/视频项目`），再打开 `日期_标题` 那个文件夹。脚本是 `script.md`，选题是 `topic.md`，文章在 `公众号文章/`。完整约定见 [files.md](files.md)。

插件工具只做这些：

| 工具 | 作用 |
| --- | --- |
| `jacky_creator_guide` | 自举指引：返回完整工作流和当前能力状态，用户问「这个插件怎么用」时先调它 |
| `jacky_creator_script_rules` | 读或写脚本规则（人设）；写改 script.md 前先读 |
| `jacky_creator_setup` | 只读检查环境，或先预览、确认后保存目录和启用平台 |
| `jacky_creator_create_content` | 按今天的日期新建文件夹 |
| `jacky_creator_update_content` | 标记待录制、绑定工程、改某一平台的发布标记 |
| `jacky_creator_open_studio` | 打开已绑定的 Screen Studio 工程 |
| `jacky_creator_wait_export` | 等到文件夹里出现稳定的 MP4 / MOV |
| `jacky_creator_generate_subtitles` | 转录、自动校对、排版；立刻返回；完成后打开预览，出现 `subtitle-transcript.json`，不烧录 |
| `jacky_creator_open_subtitle_preview` | 在浏览器打开字幕预览编辑器 |
| `jacky_creator_burn_subtitles` | 用户预览确认后再烧进成片；立刻返回；完成后出现 `*_subtitled.mp4` |
| `jacky_creator_generate_cover` | 用 Jacky Cover 品牌补丁和 ZenMux 一键生成 3:4 / 4:3 / 16:9 封面，立刻返回；完成后出现对应 png |
| `jacky_creator_sync_publish` | 用 Ego 翻完启用平台的已发布列表，按标题或已存 id 写回播放 / 赞 / 评 |
| `jacky_creator_profile` | 读或改 `enabledPlatforms`，即 AI 发布和数据同步使用的平台列表 |
| `jacky_creator_organize_library` | 预览或把文件夹改成 `日期_可读标题`，默认只预览 |

长任务都是先启动，再看文件夹里有没有产物，不要把一次启动当成已经完成。

## 新做一条片子

先在右边说清楚内容主题，再让对话新建项目、整理选题或生成脚本初稿。

对应工具是 `jacky_creator_create_content`。选题写进这一期的 `topic.md`，脚本写进 `script.md`，也可以之后在中间「脚本」页自己改。

录制用 Screen Studio。录完把 `.screenstudio` 工程绑到这一期，可以说：「把刚才的工程绑到这条，然后打开。」检查器里也可以点绑定或打开。

剪辑在对话里喊 `screen-studio-editor`，对照绑定的工程清理停顿和误讲。工作台只负责打开工程，不替你改时间线。预览满意后，在 Screen Studio 里亲手导出 MP4，导出目标就是这一期的文件夹。

导出开始后说：「等这条的成片落盘，落盘后生成字幕和封面。」`jacky_creator_wait_export` 会等到文件大小稳定。成片到了再用 `jacky_creator_generate_subtitles` 出字幕稿并打开预览；用户确认后再 `jacky_creator_burn_subtitles`。封面用 `jacky_creator_generate_cover`，调用前按 Jacky Cover 规则提炼主标题传入 `title`。生成后核对标题、人物身份和错别字。

首次 clone `oil-subtitle` 后必须运行 `bash ~/.agents/skills/oil-subtitle/setup.sh`，否则字幕工作流不会就绪。不要在预览前烧录。`jacky_creator_burn_subtitles` 不会覆盖已经带字幕的成片文件名习惯，产物文件名里带 `_subtitled`。

每条内容的概览都固定显示发布状态；还没走到发布阶段时也能看到启用平台的进度，点「展开平台状态」可核对。成片、字幕、封面齐了，阶段会变成「待发布」。上传优先用已发现的 `jacky-video-publisher`，否则使用兼容的 `video-publisher`，并且只处理 `enabledPlatforms` 中启用的平台；做到各平台的最终发表按钮前停下，你自己点发表。在运营的待发布卡片点「去确认发布」，或直接打开内容详情，在真实发布的平台上把状态改成「已发布」。系统会默认记录当天为实际发布日期，也可以手动修改。任一启用平台确认发布后，主流程立即进入「已发布」并出现在复盘页；其余平台显示为分发进度，不会卡住复盘。

「已发布，同步数据」从创作者后台回收播放、赞和评论。同步只翻启用平台的已发布列表，再对到本地片子；90 秒内再点一次会直接用刚才的结果。每次同步开一个新的 Ego 空间，采完就关掉。平台上有、本地没有文件夹的，不会自动新建一条片子。

运营页的六维评分现在是展开策略后才显示的可选发布前诊断，不是发布门槛。评分建议只有点击「采纳首条为下一步」才会写入下一步。复盘页默认可直接人工填写「本次结果、有效做法、存在问题、下一次实验」并保存草稿，不需要 AI 会话；AI 只负责可选起草。无论草稿来自哪里，都必须人工确认后才写入 Markdown，规则和模板还要再确认一次。

公众号不是第五个视频平台。在文章页点击「生成 Markdown 文章」，当前会话会读取 script.md、改写阅读结构并写入 `公众号文章/<标题>.md`。文件使用标准 Markdown 和相对图片路径，可以直接在 Obsidian MDFlow 中排版。

## 把一条没做完的旧片子收尾

先打开那条，或 `@` 它，或者说出文件夹路径，例如 `~/Movies/视频项目/2026-08-13_DeepSeek Harness 安装上手`。让对话列出这个文件夹，看缺的是工程、成片、字幕、封面、文章还是发布标记。

常见说法：

- 「这条还缺什么，缺的就做。」
- 「绑定这个工程：`~/Screen Studio Projects/...`」
- 「生成字幕，完了打开预览。」
- 「字幕我看过了，烧进去。」
- 「再生成一版封面。」
- 「把脚本改成下面这一版，写进 script.md。」
- 「小红书标成已发布。」
- 「同步四个平台的播放和点赞。」

列表阶段会跟着变。已经在平台发出去的，左侧会显示「已发布」，不再显示「待发布」。

## 同步之后数据在哪里

同步成功后，播放、赞、评论和链接写入 Jacky Creator 的本地状态文件。检查器的视频平台卡会显示这些数字，并提供「打开作品」。同步会翻完各平台创作者后台的已发布列表；平台上有、本地没有文件夹的不会自动建条目。视频号需要 Ego 里已经登录创作者后台。

## 设置和目录

第一次用先让 AI 检查环境，再确认影片目录。字幕、封面、Screen Studio 和 Ego Lite 都是可选能力，缺少时不会影响片库和脚本管理。字幕和封面没有 Key 时，对应按钮会提示去设置里填写。有成片后，检查器里可以生成字幕稿并打开预览，确认后再烧录；封面也可以在检查器里生成，不用再走对话。

文件夹名被连字符弄乱时，可以说：「预览整理影片目录。」确认后再让它真正重命名。`jacky_creator_organize_library` 默认只预览，不会删文件。