jacky-creator 0.1.0-beta.6

package/BRAND_ASSETS.md

@@ -0,0 +1,14 @@
+# Jacky Creator 品牌资产说明
+
+本仓库的软件代码按照 [MIT License](LICENSE) 提供。MIT 许可不代表自动授予以下品牌资产的商标、代言或商业品牌使用权：
+
+- `Jacky Creator`、`AI 无限生长星球` 名称与标识。
+- 芽仔 / 太空人 IP 形象及其衍生图像。
+- Jacky 专属 Logo、封面身份图和品牌视觉组合。
+- 明确标记为 Jacky 品牌素材的截图、图片和设计源文件。
+
+你可以在运行、测试、介绍本插件和提交兼容性补丁时合理展示这些资产，但不得暗示获得 Jacky、DeepSeek 或 DSH Desktop 的官方背书，也不得把品牌资产拆出后作为独立 Logo、角色商品、模型训练集或其他产品身份使用。
+
+对软件代码的 fork 应保留 MIT 许可和原始贡献归属。若要重新发行带有 Jacky 品牌的衍生版本，请先获得品牌所有者许可；否则应替换名称、Logo、IP 形象和品牌素材。
+
+DeepSeek、DeepSeek Harness 及相关标识归其各自权利人所有。DSH Desktop 为社区维护项目。本仓库不代表 DeepSeek 官方产品。

package/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# 参与贡献
+
+感谢你为 Jacky Creator 提交问题或改进。安装失败、数据安全、升级兼容和核心工作流问题会优先处理。
+
+## 提交问题
+
+提交 Issue 前请先搜索是否已有同类问题，并提供：
+
+- 操作系统与版本。
+- DSH Desktop / DeepSeek Harness 版本。
+- Jacky Creator Git Tag 或提交号。
+- 最短复现步骤。
+- 预期结果与实际结果。
+- 已脱敏日志或截图。
+
+不要提交 API Key、Cookie、个人内容或未脱敏绝对路径。安全问题请阅读 [SECURITY.md](SECURITY.md)。
+
+## 本地开发
+
+```bash
+git clone https://github.com/Jackywxsz/DSH-Creator.git
+cd DSH-Creator
+pnpm install --frozen-lockfile
+pnpm check
+```
+
+隔离运行 Creator Cockpit：
+
+```bash
+pnpm lab:setup
+pnpm lab:config
+pnpm lab:start
+```
+
+隔离 Profile 不应修改正式 DSH Profile。详细说明见 [docs/lab-development.md](docs/lab-development.md)。
+
+## Pull Request
+
+- 从功能分支提交，不直接在 `main` 上开发。
+- 一次 PR 只解决一个明确问题，避免顺手重构无关代码。
+- 行为变化必须补测试和用户文档。
+- 不能删除上游 MIT 归属，也不能把 Jacky 品牌资产改成通用 MIT 素材。
+- 提交前运行 `pnpm check`；准备版本时再运行 `pnpm release:check`。
+- UI 变化请提供真实宽屏和窄屏截图，并说明对应 DSH 版本。
+
+合并前会进行代码检查、打包检查和对抗式审查。通过测试不等于自动合并。

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 dsh-oil-creator contributors
+Copyright (c) 2026 Jacky Jia, DSH-Creator changes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+<p align="center">
+  <img src="./assets/readme/hero.png" width="100%" alt="Jacky Creator：把对话、内容与运营放进同一块 DeepSeek Harness 创作工作台">
+</p>
+
+<p align="center">
+  <strong>一个面向内容创作者的 DeepSeek Harness 本地工作台。</strong><br>
+  从灵感和脚本，到制作、发布与复盘，都在同一处推进。
+</p>
+
+<p align="center">
+  <a href="https://github.com/Jackywxsz/DSH-Creator/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Jackywxsz/DSH-Creator/actions/workflows/ci.yml/badge.svg?branch=main"></a>
+  <a href="https://github.com/Jackywxsz/DSH-Creator/releases"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/Jackywxsz/DSH-Creator?include_prereleases&label=release"></a>
+  <a href="./LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-1f5fff.svg"></a>
+</p>
+
+<p align="center">
+  <a href="./docs/installation.md">安装指南</a> ·
+  <a href="./docs/usage.md">使用说明</a> ·
+  <a href="./CHANGELOG.md">更新记录</a> ·
+  <a href="./SECURITY.md">安全说明</a>
+</p>
+
+## Jacky Creator 是什么
+
+Jacky Creator 把 DeepSeek Harness 的对话能力和本地创作目录连起来，并增加内容、运营和灵感工作区。每条内容仍是一个普通文件夹，AI、编辑器和你自己都能继续读写。
+
+```text
+灵感 → 选题 → 脚本 → 演示 / 视频 / 字幕 / 封面 → 发布 → 复盘
+  ↑                                                  │
+  └────────── 运营规则、模板和知识回到下一次创作 ────────┘
+```
+
+- **对话**：使用 DSH Agent，并把当前内容和运营知识带进对话。
+- **内容**：管理脚本、视频、字幕、封面、文章和发布状态。
+- **运营**：查看今日推进、档期、内容管线、阶段目标和发布后复盘。
+- **灵感**：记录想法、标签和分级，确认后推进为内容项目。
+
+## 安装
+
+### 1. 安装 DSH Desktop
+
+下载并安装 [DSH Desktop 2.0.2](https://github.com/anywhere-labs/dsh-desktop/releases/tag/v2.0.2)。DSH Desktop 和 Jacky Creator 均为社区项目。
+
+### 2. 安装 Jacky Creator
+
+可以通过插件市场一键安装，也可以在 DSH Desktop 的内置终端直接安装当前版本。
+
+#### 方式一：通过插件市场安装
+
+先打开 DSH Desktop 的内置终端，安装可视化插件市场：
+
+```bash
+dsh plugin --profile web add dshmarket
+```
+
+彻底退出并重新打开 DSH Desktop，然后进入“设置 → 插件市场”，搜索 `DSH-Creator` 或 `Jacky Creator`，打开插件卡片并点击安装。
+
+插件市场目录按周期同步。如果市场显示的版本低于 GitHub 最新版本，可以改用下面的命令行方式。
+
+#### 方式二：通过命令行安装最新版
+
+打开 DSH Desktop 的内置终端，复制下面一行并回车：
+
+```bash
+dsh plugin --profile web add https://github.com/Jackywxsz/DSH-Creator/releases/download/v0.1.0-beta.6/jacky-creator-0.1.0-beta.6.tgz
+```
+
+无论使用哪种方式，安装完成后都要彻底退出并重新打开 DSH Desktop。侧边栏左上角出现 **Jacky Creator**，并能进入“内容 / 运营 / 灵感”，即表示安装成功。
+
+### 3. 完成首次配置
+
+新建会话，选择 `standard` 或 `code` Agent，然后发送：
+
+> 帮我配置 Jacky Creator：选择本地内容目录，先预览准备修改的设置，确认后再保存。
+
+配置完成后，直接告诉 AI 想做的内容主题，就可以新建项目、整理选题并生成脚本初稿。
+
+完整步骤见 [安装与首次使用](docs/installation.md)。
+
+## 本地文件
+
+```text
+内容目录/
+└── YYYY-MM-DD_内容标题/
+    ├── topic.md
+    ├── script.md
+    ├── 内容标题.mp4
+    ├── 内容标题.srt
+    ├── 内容标题_16x9.png
+    └── 公众号文章/
+```
+
+正文和产物保存在你选择的内容目录。Jacky Creator 只在本机保存工作台设置、运营状态和发布记录，不会把正文搬进封闭数据库。
+
+## 核心能力
+
+不安装额外 Skill，也可以使用内容库、运营工作台、灵感库和脚本规则。字幕、封面、演示动画、Screen Studio 和多平台发布属于可选扩展，缺少时不会影响核心工作台。
+
+| 能力 | 说明 |
+| --- | --- |
+| 内容工作流 | 管理选题、脚本、制作资产和发布状态 |
+| 运营工作台 | 管理档期、目标、复盘和内容推进 |
+| 灵感库 | 记录想法并推进为真实内容项目 |
+| 可选制作能力 | 字幕、封面、演示动画和多平台发布 |
+
+详细能力和依赖见 [使用说明](docs/usage.md)。
+
+## 数据与权限
+
+- 正文、视频、字幕、封面和文章留在用户选择的本地目录。
+- API Key 由 DSH 凭据服务保存，界面只显示配置状态。
+- 目录创建、批量重命名和配置保存会先预览，再等待确认。
+- 外部服务只在用户主动启用对应能力时访问。
+- 插件不会在卸载时删除内容目录。
+
+安全问题请按 [Security Policy](SECURITY.md) 私下报告，不要在公开 Issue 中附带密钥、私人路径或未脱敏内容。
+
+## 常见问题
+
+如果侧边栏没有出现 Jacky Creator：
+
+1. 确认安装命令是在 DSH Desktop 内置终端执行的。
+2. 彻底退出并重新打开 DSH Desktop。
+3. 仍然失败时，到 [GitHub Issues](https://github.com/Jackywxsz/DSH-Creator/issues) 提交系统版本、DSH Desktop 版本和脱敏后的安装日志。
+
+不要手动修改 DSH Profile 的 `package.json` 或 `cordis.patch.yml`。
+
+## 兼容性
+
+当前主要环境为 macOS、DSH Desktop 2.0.2 和 DeepSeek Harness 0.1.1-rc.2。Windows x64 暂不作为推荐环境，Screen Studio、Ego Lite 等扩展仅支持 macOS。
+
+## 插件市场
+
+Jacky Creator 已收录到 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)，并由 [dsh-market](https://github.com/dsh-market/dsh-market) 同步市场卡片。安装 `dshmarket` 后，可以在 DSH Desktop 的“设置 → 插件市场”中搜索 `DSH-Creator` 并一键安装。市场版本尚未同步时，请使用上面的固定版本安装命令。
+
+## 文档与开发
+
+- [安装与首次使用](docs/installation.md)
+- [日常使用](docs/usage.md)
+- [内容文件夹约定](docs/files.md)
+- [参与贡献](CONTRIBUTING.md)
+
+本地开发：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm check
+```
+
+## 项目来源
+
+Jacky Creator 基于上游开源项目 [dsh-oil-creator](https://github.com/oil-oil/dsh-oil-creator) 的本地内容工作流继续开发，并融合了 Jacky 原 Creator Cockpit 的运营方法与界面经验。感谢原项目作者和贡献者。
+
+## License 与品牌资产
+
+代码沿用 [MIT License](LICENSE)。Jacky Creator 名称、芽仔形象、Logo 和品牌视觉不随 MIT 代码许可自动授权，具体边界见 [品牌资产说明](BRAND_ASSETS.md)。原项目和上游贡献者的 MIT 归属继续保留。

package/SECURITY.md

@@ -0,0 +1,25 @@
+# Security Policy
+
+## Supported version
+
+安全修复面向最新发布版本。Developer Preview 上游发生破坏性升级时，会先完成兼容验证，再更新支持范围。
+
+## Report a vulnerability
+
+请不要在公开 Issue 中提交 API Key、Cookie、私人内容、本地完整路径或可直接利用的漏洞细节。
+
+优先使用 GitHub 仓库的 Private Vulnerability Reporting。若仓库尚未启用该入口，请通过仓库所有者公开资料中的私下联系方式报告，并只提供：
+
+- 受影响版本和运行环境。
+- 最小复现步骤。
+- 可能影响的数据或权限边界。
+- 已脱敏日志。
+
+维护者确认接收后，再补充必要的私密证据。公开修复前不会要求报告者在 Issue 中披露细节。
+
+## Security boundaries
+
+- 凭据应由 DeepSeek Harness 凭据服务保存，不得写入仓库、内容目录或运营状态文件。
+- 插件不会在卸载时自动删除用户内容或本地状态目录。
+- 外部字幕、封面和发布服务只有在用户主动配置并调用时才启用。
+- 目录创建、重命名、状态恢复和知识沉淀必须保留预览、校验和人工确认边界。

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+- id: ui-sidebar
+  disabled: true
+- insert:
+    - id: jacky-creator
+      name: jacky-creator

package/docs/files.md

@@ -0,0 +1,29 @@
+# 内容文件夹约定
+
+一条片子就是影片目录里的一个子文件夹。默认目录是 `~/Movies/视频项目`。磁盘上的文件是正文、脚本、文章、字幕、封面和发布包的准；插件工具不负责再读一遍这些文件。
+
+## 文件夹
+
+名字是 `YYYY-MM-DD_可读标题`。列出影片目录就能列出所有片子。打开某一期，先列出那个文件夹，再读需要的文件。
+
+## 文件
+
+| 文件 | 含义 |
+| --- | --- |
+| `topic.md` | 选题笔记 |
+| `script.md` | 口播脚本 |
+| `演示/<标题>-16x9.html` | Jacky Motion 横屏录制演示 |
+| `演示/<标题>-3x4.html` | Jacky Motion 竖屏录制演示 |
+| `公众号文章/<标题>.md` | 已转成 Markdown 的文章 |
+| `公众号文章/images/` | 文章配图 |
+| `publish-package.json` | 发布用的标题和 tags，不写平台长文案 |
+| `{标题}.auto-publish.json` | 发布草稿推断 |
+| `*.mp4` / `*.mov` | 成片；带 `_subtitled` 的是烧过字幕的 |
+| `*.srt` / `*.ass` | 字幕稿 |
+| `*_3x4.png` / `*_4x3.png` / `*_16x9.png` | 封面 |
+
+改脚本或选题，直接写对应的 md。不要另存一份到 overlay。
+
+## 插件另外记的东西
+
+Jacky Creator 的本地状态文件只记录影片目录路径、创作者档案、工程绑定、手写发布标记、同步到的播放/赞/评和生成任务，不保存正文。

package/docs/installation.md

@@ -0,0 +1,102 @@
+# 安装与首次使用
+
+## 开始前准备
+
+你需要：
+
+1. 已安装 [DSH Desktop 2.0.2](https://github.com/anywhere-labs/dsh-desktop/releases/tag/v2.0.2)。
+2. 一个存放内容项目的本地文件夹。没有也没关系，首次配置时可以创建。
+3. 推荐使用 macOS。Windows x64 无法使用 Screen Studio、Ego Lite 等 macOS 专属扩展。
+
+DSH Desktop 和 Jacky Creator 均为社区项目。
+
+## 安装
+
+### 1. 打开内置终端
+
+启动 DSH Desktop，打开它提供的内置终端。安装命令要输入终端，不要发送到聊天输入框。
+
+### 2. 运行安装命令
+
+~~~bash
+dsh plugin add https://github.com/Jackywxsz/DSH-Creator/releases/download/v0.1.0-beta.6/jacky-creator-0.1.0-beta.6.tgz
+~~~
+
+等待命令结束，不要在安装过程中重复执行。
+
+如果日志出现 `Issues with peer dependencies found`，先看命令最后是否显示安装完成。只有出现 `dsh: pnpm failed` 或其他明确失败提示时，才需要提交日志排查。
+
+### 3. 重启 DSH Desktop
+
+安装完成后彻底退出 DSH Desktop，再重新打开。只关闭窗口但不退出进程，可能仍然使用旧插件状态。
+
+### 4. 确认安装成功
+
+满足下面三项即表示插件已经加载：
+
+- 侧边栏左上角显示 `Jacky Creator`。
+- 顶部可以切换“对话 / 内容 / 运营”。
+- 侧边栏芽仔按钮可以进入灵感记录。
+
+## 首次配置
+
+新建会话，选择 `standard` 或 `code` Agent，发送：
+
+> 帮我配置 Jacky Creator：选择本地内容目录，先预览准备修改的设置，确认后再保存。
+
+Jacky Creator 会检查内容目录和可选能力，只显示凭据是否已配置，不会把 API Key 读回对话。也可以直接打开“设置 → 插件 → Jacky Creator”：逐项重新检测能力，只选择确实拥有账号的平台，用 Ego Browser 检测/打开各平台登录，并在确认后安装可验证的公开依赖。新安装默认不启用任何发布平台；创建目录、安装依赖或保存设置前都会明确展示或确认。
+
+`minimal` Agent 没有完整的 Skill 和文件工具，不适合首次配置。
+
+## 创建内容
+
+配置完成后，直接告诉 AI 想做的内容主题，并要求它新建内容项目、整理选题或生成脚本初稿。
+
+创建成功后，可以：
+
+- 在“内容”查看脚本、视频、字幕、封面和文章状态。
+- 在“运营”安排推进、档期和发布后复盘。
+- 用芽仔快捷按钮记录新灵感。
+- 把确认过的运营规则和模板带进下一次脚本创作。
+
+## 常见问题
+
+### 终端提示找不到 `dsh`
+
+确认使用的是 DSH Desktop 内置终端。如果使用系统 Terminal、PowerShell 或其他终端，需要先按 DeepSeek Harness 的说明配置 CLI。
+
+### 安装日志提示构建脚本被阻止
+
+这通常说明安装的是 GitHub 源码地址。普通用户不要修改 DSH Profile，重新复制本页的 `.tgz` 安装命令即可。
+
+### 安装完成但侧边栏没有变化
+
+1. 彻底退出并重新打开 DSH Desktop。
+2. 确认 DSH Desktop 版本为 2.0.2。
+3. 仍然失败时提交 Issue，并附上系统版本、DSH Desktop 版本和脱敏后的安装日志。
+
+不要自行编辑 DSH Profile 的 `package.json` 或 `cordis.patch.yml`。
+
+### 缺少字幕、封面或发布功能
+
+这些是可选扩展，不是安装失败。核心的对话、内容、运营和灵感不依赖这些 Skill。
+
+### 从旧版升级
+
+如果安装过 `v0.1.0-beta.2`，先在 DSH Desktop 内置终端运行一次：
+
+~~~bash
+dsh plugin remove dsh-oil-creator
+~~~
+
+然后执行本页的新安装命令并重启 DSH Desktop。Jacky Creator 会把旧工作台状态复制到新目录，不删除旧目录，也不覆盖已经存在的新数据。
+
+## 更新
+
+看到新版本后，打开 [GitHub Releases](https://github.com/Jackywxsz/DSH-Creator/releases)，按该版本说明中的安装命令更新。更新不会主动删除内容目录，重要内容仍建议提前备份。
+
+## 数据保留
+
+Jacky Creator 不会在更新或普通卸载时主动删除内容目录。正文、视频、字幕、封面和文章仍保存在用户选择的本地文件夹。
+
+需要帮助时，到 [GitHub Issues](https://github.com/Jackywxsz/DSH-Creator/issues) 提交问题。不要公开粘贴 API Key、私人路径或未经脱敏的内容。

package/docs/usage.md

@@ -0,0 +1,112 @@
+# 内容工作台使用说明
+
+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 会用 `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](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` | 用 Jacky Cover 品牌补丁和 ZenMux 一键生成 3:4 / 4:3 / 16:9 封面，立刻返回；完成后出现对应 png |
+| `oil_sync_publish` | 用 Ego 翻完启用平台的已发布列表，按标题或已存 id 写回播放 / 赞 / 评 |
+| `oil_creator_profile` | 读或改 `enabledPlatforms`，即 AI 发布和数据同步使用的平台列表 |
+| `oil_organize_library` | 预览或把文件夹改成 `日期_可读标题`，默认只预览 |
+
+长任务都是先启动，再看文件夹里有没有产物，不要把一次启动当成已经完成。
+
+## 新做一条片子
+
+先在右边说清楚内容主题，再让对话新建项目、整理选题或生成脚本初稿。
+
+对应工具是 `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`，调用前按 Jacky Cover 规则提炼主标题传入 `title`。生成后核对标题、人物身份和错别字。
+
+首次 clone `oil-subtitle` 后必须运行 `bash ~/.agents/skills/oil-subtitle/setup.sh`，否则字幕工作流不会就绪。不要在预览前烧录。`oil_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 时，对应按钮会提示去设置里填写。有成片后，检查器里可以生成字幕稿并打开预览，确认后再烧录；封面也可以在检查器里生成，不用再走对话。
+
+文件夹名被连字符弄乱时，可以说：「预览整理影片目录。」确认后再让它真正重命名。`oil_organize_library` 默认只预览，不会删文件。