dsh-plugin-deck-studio 0.2.2 → 0.2.4

package/seeds/samples/deckline-intro/README.md

@@ -0,0 +1,41 @@
+# Sample deck：Deckline 产品说明手册
+
+这是随仓库分发的**示例 deck 源**（10 页 image deck）：介绍 Deckline 是什么、为什么做、
+工作台怎么用、怎么安装配置、边界与路线图。
+
+**跑通流程请用弹窗字段速查：[`popup.md`](popup.md)**（对应 [docs/sample-deck.md](../../docs/sample-deck.md)）。
+
+用途：
+
+1. **看着像什么**：`script.md` 是逐页脚本（标题 / 副标题 / 页面内容 / 画面说明），
+   `intent.md` 是给谁讲、讲什么、成功标准；配一份风格（示例用 `FYI` 高端深色，也可以换任意预设）。
+2. **跑通流程**：把这个目录的 `script.md` 内容作为素材，粘贴进 Deckline 的 Chat，
+   按 [docs/sample-deck.md](../../docs/sample-deck.md) 的三步走完
+   「新建 deck → Agent 起草 intent/script → 确认 → 逐页出图 → 导出」。
+3. **公开演示**：公开仓库里可以直接把本目录注册成一个 deck（profile patch `decks[]`）。
+
+## 这份示例里有什么
+
+```
+samples/deckline-intro/
+  README.md            # 本文件
+  intent.md            # 意图（给谁讲 / 讲什么 / 带走什么 / 成功标准）
+  script.md            # 10 页逐页脚本（标题 / 副标题 / 主张 / 正文 / 画面说明）
+  prompts/p01..p10.txt # 每页实际用的 visualBrief（参考写法，可改写）
+  pages/p01..p10.png   # 每页渲染结果（1280×720，示例输出长什么样）
+  deckline-intro.pptx  # 同一份结果的 PPTX（每页一张整页图，方便直接翻）
+  assets/              # 封面用到的 logo 参考图（Deckline 字标 / mark）
+  materials/           # 参考截图与项目说明（运行 deck 时可作资料）
+  materials.md · popup.md  # 资料清单 / 新建弹窗字段速查
+```
+
+> `pages/` 与 `deckline-intro.pptx` 是**示例产物**，不是源文件：Deckline 每次出图都会留版本，
+> 源 deck 仍然只有 md；图片可以直接看，也可以删掉后自己按脚本重出一遍。
+> `assets/` 里的 logo 仅作参考，替换成你自己的品牌时改这里即可。
+
+## 怎么用
+
+- **只想看**：打开 `deckline-intro.pptx`，或翻 `pages/`。
+- **想复刻**：把 `script.md` 内容作为素材粘进 Deckline 的 Chat，按
+  [docs/sample-deck.md](../../docs/sample-deck.md) 的三步跑「新建 deck → 起草 → 确认 → 逐页出图 → 导出」。
+- **想注册成现成 deck**：在 profile patch 的 `decks[]` 里指向本目录（源只读，编辑产物写 `.deck/`）。

package/seeds/samples/deckline-intro/assets/deckline-logo.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 392 96" width="392" height="96" role="img" aria-label="Deckline">
+  <rect width="96" height="96" rx="22" fill="#0c4651"/>
+  <g fill="none" stroke-linejoin="round">
+    <path d="M28 66V38c0-3 2-5 5-5h26c3 0 5 2 5 5v28" stroke="#faf8f2" stroke-width="4.5" stroke-linecap="round"/>
+    <path d="M38 30V24c0-2 1.5-3.5 3.5-3.5h22c2 0 3.5 1.5 3.5 3.5v28" stroke="#1496a8" stroke-width="4" stroke-linecap="round" opacity=".9"/>
+    <path d="M37 47h17" stroke="#faf8f2" stroke-width="4" stroke-linecap="round"/>
+    <path d="M37 56h11" stroke="#c5882f" stroke-width="4" stroke-linecap="round"/>
+  </g>
+  <circle cx="63" cy="60" r="5.5" fill="#c5882f"/>
+  <text x="116" y="58" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif" font-size="34" font-weight="650" fill="#0c4651" letter-spacing=".5">Deckline</text>
+  <text x="117" y="78" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif" fill="#5d777b" letter-spacing="1.8" font-size="10.5">IMAGE DECK STUDIO · DSH PLUGIN</text>
+</svg>

package/seeds/samples/deckline-intro/intent.md

@@ -0,0 +1,48 @@
+---
+title: Deckline 产品说明手册
+owner: Deckline
+created: 2026-10-21
+confidential: public
+deck-type: handbook
+render: image
+pages: 10
+status: draft
+---
+
+# 意图
+
+## 讲给谁
+
+第一次接触 Deckline 的人：会用 DSH / 会做分享材料的产品、咨询、培训、内容创作者。
+他们大概率已经有一堆 PPT/Keynote，也都试过让 AI 直接生成整页图，但被「改稿、返工、找不到版本」折磨过。
+
+## 讲什么
+
+一句话：**Deckline 不是又一个 PPT 编辑器，而是把「讲给谁、讲什么、怎么出图」变成一条可追踪的产线。**
+
+- 对话在 DSH 原生 Chat 里继续，deck 的每次改动有 script / diff / revision / 治理文档撑底；
+- 出图按页：可点名多页 / 整份连续出，每页保留 prompt、图片、版本、QA 和事件，随时能回到任意一版；
+- 风格（design）是独立资产：登记一次，换 deck 也能复用，还能直接贴样张；
+- 源 deck 目录只读，所有编辑产物落在本地 `.deck/`——客户资料不会因为一次误操作被覆盖。
+
+## 希望大家带走什么
+
+1. 记住三句话：**Chat 里讨论、工作台里出图、源文件只读**；
+2. 愿意按 README 的花 5 分钟装一个，跑通第一个 deck；
+3. 知道这件事有边界：一期只做 image deck，出图按页、可点名批量连出，不碰 HTML deck。
+
+## 成功标准
+
+听众看完能向同事复述：「Deckline 是 DSH 上的 image deck 工作台，用对话改 deck、按页出图（可批量）、
+风格可以复用，安装就是一条 `dsh plugin add`。」
+
+## 不讲的
+
+- 不讲实现细节（代码结构 / 数据 schema / 工具名）；
+- 不讲客户案例细节；
+- 不承诺「一键出整套 deck」。
+
+## 风格
+
+示例用 **FYI · 高端深色（玻璃质感）**：近黑炭底、玻璃面板、紫青极光、香槟金。
+也可以换 `BIZ`（商务蓝灰）或 `SWS`（瑞士极简黑白红）。

package/seeds/samples/deckline-intro/materials/project-summary.md

@@ -0,0 +1,90 @@
+# Deckline 一页事实摘要
+
+> 给 Agent / 给第一次接触 Deckline 的人。
+> 写《Deckline 产品说明手册》时，**事实只引用本摘要 + [`materials.md`](../materials.md) 里列的材料**；
+> 本摘要没写的内容，回查来源文件或问用户，不要编。
+
+## 1. 一句话
+
+Deckline 是 **DSH（DeepSeek Harness）的 image deck 工作台插件**：左边 DSH 原生 Chat、中间 deck 工作区、
+右边资料库 / 设计风格 / 资源库 / 会话；把「讲给谁、讲什么、怎么出图」做成一条可追踪的产线，
+不是又一个 PPT 编辑器。
+（来源：`README.md`）
+
+## 2. 用户问题（为什么做）
+
+- 想法在聊天、稿子在 PPT、图在另一个工具里，上下文断裂；
+- 改稿频繁，但版本、原因、影响了哪几页说不清；
+- 风格不可复用，每份 deck 都重新描述画面语言；
+- 换人接手要重翻聊天记录，交接成本高。
+（来源：`README.md`、`docs/productization.md`）
+
+## 3. 工作台三段式
+
+- **左**：DSH 原生 Chat —— 讨论、提案、确认，对话就是操作入口；
+- **中**：deck 工作区 —— 整页图片 storyboard、逐页画面说明、版本、样张墙；
+- **右**：资料库 —— 受控源文件、历史 / 事件、Inspector、设置（出图节点 / 模型 / 尺寸）。
+（来源：`README.md`、`docs/sample-deck.md`）
+
+## 4. 核心闭环
+
+`intent（意图）→ script（逐页脚本提案）→ 用户确认 → revision（新版本，不覆盖旧版）→
+单页 image prompt → QA 门禁 → 出图 → 治理文档 / 修改日志 → 导出（PDF / PPTX / 交接包）`。
+
+- 任何改动先提案、看 diff，用户确认后才落版本；
+- 出图**按页留痕**，可点名批量 / 整份连出；
+- 每页保留 prompt、图片、版本、QA 和事件，可回退。
+（来源：`README.md`、`CHANGELOG.md`、`docs/productization.md`）
+
+## 5. 两种实体（别混）
+
+- **deck**：一份交付物 —— 整页图 + 7 份治理文档 + 治理分；
+- **design（风格）**：一份可复用的视觉资产 —— 风格描述 + 样张，有自己的 0 页画布；
+  deck 可以关联一个 design，换 deck 也能复用同一风格。
+（来源：`docs/styles.md`、`docs/sample-deck.md`）
+
+## 6. 一期边界（不做什么）
+
+- 只做 image deck（整页图片）；不做 HTML deck 渲染器（另立项目）；
+- 不做 PPT 原生图层编辑；不默认批量出整套图；
+- 源 deck 目录**只读**；编辑产物写本地 `.deck/`（已 gitignore，不进仓库）；
+- 暂不做多人实时协作 / 云端账户 / 复杂权限。
+（来源：`README.md`、`docs/productization.md`、`CHANGELOG.md`）
+
+## 7. 关键数字（可引用）
+
+- **7 份**治理文档：意图 / 脚本 / Design / 修改日志 / 反馈 / 调研 / 支撑材料；
+- **8 个**预设风格：BIZ / FYI / JPN / EDT / TEC / SKT / SWS / GRD，每个带真实样张；
+- 出图按页、版本 copy-on-write（旧版本保留）；
+- README 安装路径：建 profile → 装插件 → 配置 → 启动，约 **5 分钟**；
+- 许可 **MIT**；npm 包名 **dsh-plugin-deck-studio**；版本 **v0.1.0**。
+（来源：`CHANGELOG.md`、`docs/styles.md`、`README.md`、`docs/productization.md`）
+
+## 8. 安装与配置（给 P08 用）
+
+- 前置：Node.js ≥ 20、pnpm 10+、DSH ≥ 0.1.7；
+- 三条命令：建 `deckline` profile → `dsh plugin add` 装插件 → 启动；
+- 生图 key 放 env 或 key 文件（`apiKeyEnv` / `apiKeyFile`），不进仓库；界面只显示是否配置；
+- 没有 key 也能用 `fake` 模式跑通流程。
+（来源：`README.md`、`docs/install.md`）
+
+## 9. 链接（写 P04 / P07 / P08 时可引用）
+
+| 类型 | 链接 |
+|---|---|
+| 公开仓库 | `https://github.com/yuna78/dsh-deck-studio`（发布后可用；现在真机测试用本仓库相对路径） |
+| 项目摘要 | `samples/deckline-intro/materials/project-summary.md`（本文） |
+| 文档 | `README.md` · `docs/productization.md` · `docs/install.md` · `docs/styles.md` · `docs/sample-deck.md` · `CHANGELOG.md` |
+| 代码入口 | `plugin/deck-studio/index.js`（路由 / 数据契约）· `plugin/deck-studio/lib/`（工作区 / 文档 / 出图 / 风格 / Agent 工具）· `plugin/deck-studio/ui/`（三栏 UI） |
+| 预设风格 | `plugin/deck-studio/seeds/styles/*.json` · `plugin/deck-studio/seeds/samples/*.jpg` |
+| 品牌 | `assets/logo/`（logo svg / png / mark） |
+| 截图 | `samples/deckline-intro/materials/screenshots/01-workbench-deck.png` · `02-home-decks.png` · `03-home-designs.png` · `04-new-deck-popup.png` |
+| 现成逐页稿 | `samples/deckline-intro/script.md` · `samples/deckline-intro/intent.md`（10 页结构参考，可改写） |
+
+## 10. 写作纪律（给 Agent）
+
+- 只引用本摘要、`materials.md` 材料、`script.md` 现成稿里的事实；
+- 缺的数字 / 案例 / 客户 / URL **不要编**：回查来源文件，或写「待补」/问用户；
+- 每页在备注里写来源文件（如 `P05 ← README.md`），方便用户核对；
+- 标题 ≤ 20 字、直接写结论、每页带画面说明；
+- 不写真实客户名、不写内部路径、不写 key。

package/seeds/samples/deckline-intro/materials.md

@@ -0,0 +1,110 @@
+# Sample deck 的真实材料包（给 Agent 写作用）
+
+写《Deckline 产品说明手册》不要凭空编。下面这些**都是本仓库里的真实文件**：一页事实摘要、
+README、产品文档、代码路径、预设风格定义与样张、品牌 logo、产品截图。
+把清单贴进首页「＋ 新建 Deck」弹窗的**参考资料**字段（或第一次对话时让 Agent 先读这个文件），
+Agent 再据此起草 intent / script。
+
+> 不要再把「我设计好的 10 页大纲」当材料——大纲是设计稿，不是事实来源。材料是下面这些。
+
+## 贴进弹窗「参考资料」的整段（复制即用）
+
+```text
+项目材料（都在本仓库，请先读再写；事实以这些为准，不要编）：
+
+【0. 先读】samples/deckline-intro/materials/project-summary.md —— 一页事实摘要：
+  定位 / 用户问题 / 三段式工作台 / 核心闭环 / deck 与 design / 一期边界 / 关键数字 / 安装 / 许可 / 链接。
+  （摘要每条都标了来源；摘要没写的，回查来源文件或问我，不要自己编。）
+
+【1. 文档（真实链接）】
+  README.md —— 产品定位 / 三段式 / 5 分钟安装 / 命令
+  CHANGELOG.md —— v0.1.0 能力清单与边界
+  docs/productization.md —— 产品化定位、路线图、发布范围、一期边界
+  docs/install.md —— 安装、profile 配置、出图节点与 key 放置、fake 模式
+  docs/styles.md —— 8 个预设风格 + 自定义风格方法
+  docs/sample-deck.md —— 用示例 deck 跑通流程（本页步骤来源）
+
+【2. 代码（真实链接）】
+  plugin/deck-studio/index.js —— 宿主路由与数据契约（workbench / deck-create / page-render / doc / export…）
+  plugin/deck-studio/lib/deck-workspace.js —— deck 工作区与源目录只读规则
+  plugin/deck-studio/lib/deck-docs.js —— 7 份治理文档骨架
+  plugin/deck-studio/lib/render.js —— 出图 / revision / QA 门禁
+  plugin/deck-studio/lib/designs.js —— 风格（design）定义与样张
+  plugin/deck-studio/lib/tools.js —— Agent 工具（deck_* / design sample）
+  plugin/deck-studio/ui/workbench.html · workbench.css · client.js —— 三栏 UI 结构与入口
+  plugin/deck-studio/seeds/styles/*.json · seeds/samples/*.jpg —— 8 份预设风格定义与样张
+
+【3. 品牌与截图】
+  assets/logo/deckline-logo.svg|png · deckline-mark.svg|png —— 品牌 logo（封面 / 内页可用）
+  samples/deckline-intro/materials/screenshots/01-workbench-deck.png —— 工作台（storyboard + 资料库）
+  samples/deckline-intro/materials/screenshots/02-home-decks.png —— 首页 Decks
+  samples/deckline-intro/materials/screenshots/03-home-designs.png —— Designs 风格库
+  samples/deckline-intro/materials/screenshots/04-new-deck-popup.png —— 新建 Deck 弹窗
+
+【4. 现成稿（结构参考，可改写）】
+  samples/deckline-intro/script.md · intent.md —— 这套示例 deck 已写好的 10 页逐页稿
+
+【5. 链接】
+  公开仓库（发布后）：https://github.com/yuna78/dsh-deck-studio
+  现在真机测试：用上面这些「仓库相对路径」即可（Agent 的 cwd 就是本仓库根目录）
+
+写法要求：先复述你读到的产品定位（一句话 + 三个痛点 + 边界），再起 10 页 script；
+每页直接写结论、标题 ≤20 字、带画面说明、备注来源文件（如 P05 ← README.md）；
+不确定的事实回查上面文件或问我，不要编造数字 / 客户 / 案例 / URL。
+```
+
+## 链接怎么给（本地 / 公开后）
+
+| 场景 | 链接形式 |
+|---|---|
+| 现在真机测试 | **仓库相对路径**：`README.md`、`docs/install.md`、`plugin/deck-studio/index.js`…（Agent 的 cwd 就是本仓库根目录） |
+| 公开仓库发布后 | `https://github.com/yuna78/dsh-deck-studio/blob/main/<相对路径>`，例如 `…/blob/main/docs/install.md`；仓库根本身 `https://github.com/yuna78/dsh-deck-studio` |
+| 只想给「总结」 | `samples/deckline-intro/materials/project-summary.md`（一页事实摘要，自带来源标注） |
+
+> 注意：`docs/architecture.md`、`docs/product-brief.md`、`CURRENT.md`、`HANDOVER.md` 是**内部文档，
+> 不随公开包分发**；它们里的关键事实已经浓缩进 `project-summary.md`，公开材料里只链接上面列出的文件。
+> 公开仓库还没 push（负责人发布动作），所以现在先用本地相对路径；发布后把路径替换成 GitHub URL 即可。
+
+## 材料明细（每份用在哪一页）
+
+| 材料 | 真实路径 | 用途 |
+|---|---|---|
+| 一页事实摘要 | [`materials/project-summary.md`](materials/project-summary.md) | P01–P10 的事实底座（先读这个） |
+| README | [`README.md`](../../README.md) | P01 封面定位、P03 一句话定义、P10 上手三步 |
+| CHANGELOG | [`CHANGELOG.md`](../../CHANGELOG.md) | P09 已支持 / 未支持、v0.1.0 |
+| 产品化文档 | [`docs/productization.md`](../../docs/productization.md) | P03 定位、P09 边界、P10 路线图与许可 |
+| 安装文档 | [`docs/install.md`](../../docs/install.md) | P08 安装 / 配置 / key / fake 模式 |
+| 风格目录 | [`docs/styles.md`](../../docs/styles.md) | P06 风格是资产（8 预设 + 自定义） |
+| 示例流程 | [`docs/sample-deck.md`](../../docs/sample-deck.md) | P10 上手三步（本页流程的完整版） |
+| 代码（宿主） | [`plugin/deck-studio/index.js`](../../plugin/deck-studio/index.js) | P04 / P05 的真实路由与数据契约 |
+| 代码（工作区/文档/出图） | [`plugin/deck-studio/lib/`](../../plugin/deck-studio/lib/) | P04 / P05 / P07 只读源、文档骨架、出图与治理 |
+| 代码（UI） | [`plugin/deck-studio/ui/`](../../plugin/deck-studio/ui/) | P04 三栏工作台截图对应实现 |
+| 预设风格定义 | [`plugin/deck-studio/seeds/styles/`](../../plugin/deck-studio/seeds/styles/) | P06 风格卡 / 样张语言 |
+| 预设样张 | [`plugin/deck-studio/seeds/samples/`](../../plugin/deck-studio/seeds/samples/) | P06 配图、也说明「候选图」标准 |
+| 品牌 logo | [`assets/logo/`](../../assets/logo/) | P01 封面 / 页脚 logo |
+| 产品截图 | [`materials/screenshots/`](materials/screenshots/) | P04 / P06 / P08 插图（demo 假数据渲染，不含客户信息） |
+| 示例逐页稿 | [`script.md`](script.md) · [`intent.md`](intent.md) | 结构参考（10 页怎么排） |
+
+## 用法 A：从弹窗新建（推荐）
+
+1. 首页点「＋ 新建 Deck」；
+2. 标题 / 目录名 / 受众 / 话题 / 意图按 [`popup.md`](popup.md) 填；
+3. 参考资料：把上面「贴进弹窗」的整段粘进去；
+4. 风格：选 `FYI`（或 `BIZ` / `SWS`），点「创建并开始对话」。
+
+## 用法 B：已有会话里补材料
+
+在 Chat 里说一句：
+
+```text
+先读 samples/deckline-intro/materials/project-summary.md 和 materials.md，再按里面的真实材料写 10 页 script；
+不要编产品定位，引用事实时回查对应文件，每页备注来源。
+```
+
+## 注意
+
+- 这些材料里没有客户名、客户数据、个人路径、API key —— 可以直接贴给 Agent；
+- 截图是 **demo 模式**用虚构 deck 渲染的，样张取自插件自带的公开预设图，不含任何客户内容；
+- 代码路径按本仓库根目录相对路径读写；Agent 的 cwd 就是本仓库时可直接读；
+- 材料清单里的路径都在公开打包白名单内（`samples/`、`docs/` 四份对外文档、`plugin/`、`assets/logo/`），
+  发布版里同样存在；内部文档不在其中，事实已收进 `project-summary.md`。

package/seeds/samples/deckline-intro/popup.md

@@ -0,0 +1,87 @@
+# 「＋ 新建 Deck」弹窗：字段速查（复制即用）
+
+首页左下 **＋ 新建 Deck**，按下表填（详细步骤见 [docs/sample-deck.md](../../docs/sample-deck.md)）。
+
+## 主题 / 标题
+
+```text
+Deckline 产品说明手册
+```
+
+## 项目目录名（可选）
+
+```text
+deckline-intro
+```
+
+## 受众 / 用户
+
+```text
+第一次接触 Deckline 的人：会用 DSH、做分享材料的产品 / 咨询 / 培训 / 内容创作者；被「改稿、版本、找不到图」折磨过的人。
+```
+
+## 想讲什么话题
+
+```text
+一句话：Deckline 不是又一个 PPT 编辑器，而是把「讲给谁、讲什么、怎么出图」变成一条可追踪的产线——Chat 里讨论、工作台里逐页出图、风格可复用、源文件只读。
+```
+
+## 意图 / 希望大家带走什么
+
+```text
+① 记住三句话：Chat 里讨论、工作台里出图、源文件只读；② 愿意按 README 花 5 分钟装一个并跑通第一个 deck；③ 知道边界：一期只做 image deck，出图按页、可点名批量连出，不碰 HTML deck。
+```
+
+## 参考资料（一页摘要 + 真材料 + 链接，整段复制）
+
+> 不再给「我设计的 10 页大纲」，而是：**一页事实摘要 + 仓库真实文件 + 代码/文档链接**。
+> 完整说明见 [`materials.md`](materials.md)，摘要见
+> [`materials/project-summary.md`](materials/project-summary.md)。
+
+```text
+项目材料（都在本仓库，请先读再写；事实以这些为准，不要编）：
+
+【0. 先读】samples/deckline-intro/materials/project-summary.md —— 一页事实摘要：
+  定位 / 用户问题 / 三段式工作台 / 核心闭环 / deck 与 design / 一期边界 / 关键数字 / 安装 / 许可 / 链接。
+  （摘要每条都标了来源；摘要没写的，回查来源文件或问我，不要自己编。）
+
+【1. 文档（真实链接）】
+  README.md —— 产品定位 / 三段式 / 5 分钟安装 / 命令
+  CHANGELOG.md —— v0.1.0 能力清单与边界
+  docs/productization.md —— 产品化定位、路线图、发布范围、一期边界
+  docs/install.md —— 安装、profile 配置、出图节点与 key 放置、fake 模式
+  docs/styles.md —— 8 个预设风格 + 自定义风格方法
+  docs/sample-deck.md —— 用示例 deck 跑通流程（本页步骤来源）
+
+【2. 代码（真实链接）】
+  plugin/deck-studio/index.js —— 宿主路由与数据契约（workbench / deck-create / page-render / doc / export…）
+  plugin/deck-studio/lib/ —— deck 工作区 / 7 份治理文档 / 出图与 revision/QA / 风格 / Agent 工具
+  plugin/deck-studio/ui/ —— 三栏 UI 结构（workbench.html · workbench.css · client.js）
+  plugin/deck-studio/seeds/styles/*.json · seeds/samples/*.jpg —— 8 份预设风格定义与样张
+
+【3. 品牌与截图】
+  assets/logo/ —— 品牌 logo（封面 / 内页可用）
+  samples/deckline-intro/materials/screenshots/01~04.png —— 工作台 / 首页 Decks / Designs / 新建 Deck 弹窗
+
+【4. 现成稿（结构参考，可改写）】
+  samples/deckline-intro/script.md · intent.md —— 这套示例 deck 已写好的 10 页逐页稿
+
+【5. 链接】
+  公开仓库（发布后）：https://github.com/yuna78/dsh-deck-studio
+  现在真机测试：用上面这些「仓库相对路径」即可（Agent 的 cwd 就是本仓库根目录）
+
+写法要求：先复述你读到的产品定位（一句话 + 三个痛点 + 边界），再起 10 页 script；
+每页直接写结论、标题 ≤20 字、带画面说明、备注来源文件（如 P05 ← README.md）；
+不确定的事实回查上面文件或问我，不要编造数字 / 客户 / 案例 / URL。
+```
+
+## 风格
+
+- 点选 preset：**FYI · 高端深色（玻璃质感）**（推荐）；或 `BIZ` 商务蓝灰 / `SWS` 瑞士极简黑白红；
+- 自定义：先再点一次取消选中，然后在「自己描述风格」框写，例如：
+  `深色玻璃质感：近黑炭底、半透明玻璃面板、紫青极光、香槟金细线；信息密度低、留白大；不要 3D、不要照片、不要 logo。`
+
+## 提交之后
+
+点 **「创建并开始对话」**：插件会建好源目录 + 7 份文档骨架，并自动把上面这些字段作为整理 prompt 发给 Agent
+（先复述目标 → 补 intent → 起 script 草案，不直接出图）。你只需要确认 intent / script 的 diff，然后一页一页出图。

package/seeds/samples/deckline-intro/prompts/p01.txt

@@ -0,0 +1,4 @@
+# 修图（局部修改，其余保持不变）
+只做一处修改：在画面右下角新增一行小字「作者：Yuna」，字号与页脚其他小字一致、同一基线、与左边文字保持等距；其余画面（标题、副标题、面板、背景、留白、文字内容）完全保持原样，不要重排、不要改色、不要新增其他元素。
+
+要求：只改点名的地方；不换整页构图；图里的文字保持可读，不要新增没提到的文字或 logo。

package/seeds/samples/deckline-intro/prompts/p02.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：做 deck 为什么总返工
+这页回答：为什么改到第三版，还是说不清哪版被确认过？
+主张：因为材料散在四个地方：想法在聊天里、稿子在文档里、图在另一个工具里、版本说不清——返工不是水平问题，是结构问题。
+画面要求：信息页（16:9，一页讲清一个因果）。版式：顶部居左一行白色大字标题「做 deck 为什么总返工」，紧随一行 70% 灰度副标题「改到第三版，还是说不清哪版被确认过？」。中部主视觉是四块大小一致、间距相等的圆角面板横向并排（窄屏可 2×2），每块内只有三样东西：一个细线图标、一个中文短标题（≤6 字：想法在聊天里 / 稿子在文档里 / 图在另一个工具里 / 版本说不清）、一行 8–12 字说明；四块用极细的金色线段从底部收拢，汇到底部一块横跨全宽的窄条结论面板，条内一行字：「返工不是水平问题，是结构问题」。层级：标题 > 四面板 > 结论条，字号依次递减，全页中文不超过 40 字。背景材质、极光走向、玻璃与金色细线均由关联风格 GRD 提供，本页不另设配色。禁止：密集小字、卡通涂鸦、便签便条、照片、英文 slogan、虚构数字与署名。

package/seeds/samples/deckline-intro/prompts/p03.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：一条产线，不是编辑器
+这页回答：那 Deckline 到底解决哪一段？
+主张：把「讲给谁、讲什么、怎么出图」串成一条可追踪的产线：Chat 里讨论 → 工作台里出图 → 治理文档留痕；一期只做整页图片 deck。
+画面要求：中央一行三段流程：「讨论 → 出图 → 留档」，三个节点各一个细线图标，下方各一行 6 字注释（讲给谁 / 怎么出图 / 有出处）；上下大量留白；底部一行小字「一期只做整页图片 deck」。

package/seeds/samples/deckline-intro/prompts/p04.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：工作台三栏与分工
+这页回答：三栏分别做什么、数据从哪来？
+主张：工作台一屏三栏：Chat 讨论与确认、工作区出图与版本、资料库查证素材，三栏共用同一份 deck 数据。
+画面要求：三栏版式，16:9 整页。顶部居左一行标题「工作台三栏与分工」，标题下不另起副标行。主体横向分三栏：左栏宽约 22%，顶部一行小标签「Chat」，下方竖排 3 条对话摘要行，每行为一段短句占位、行高一致；中栏宽约 50%，顶部一行小标签「工作区」，下方放一张 16:9 的整页缩略矩形，矩形右下角标页码「01」，矩形下方一行说明小字；右栏宽约 28%，顶部一行小标签「资料库」，下方竖排 3 条资料条目，每条由一行短标签加一行说明组成。三栏之间各画一道 1px 细竖线，栏间距相等，三栏底边对齐。页脚左侧一行小字「同一屏内完成讨论、出图与查证」，右侧一行页码。留白不少于 35%，每栏内部元素不超过 4 个，不用图表、照片与人物，单个标签不超过 6 字。

package/seeds/samples/deckline-intro/prompts/p05.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：版本机制：提案、确认、新版本
+这页回答：改动如何记录、如何回退？
+主张：Deckline 的所有改动都走同一条路径：Agent 先生成提案并展示 diff，你确认后才写成新版本；新版本以副本方式保存，旧版本不被覆盖。每页的 prompt、出图结果、QA 记录与事件都随版本存档，因此可以回退到任意一版，也能查清某一版为什么改。出图默认按页进行；在对话里要求整批出图时，Agent 仍逐页生成，每页各自成版本。版本号从 v001 递增，出图失败不产生新版本，也不覆盖已有版本。
+画面要求：横向流程版式，16:9 整页。顶部居左一行标题「版本机制：提案、确认、新版本」。主体是一条由五枚等大卡片组成的横向链条：五卡等距排列、底边与顶边对齐，卡间用短箭头连接；五卡标签依次为「提案 / 确认 / 落版本 / 单页出图 / 留档」，每卡内上方一个两位编号 01–05，下方一行标签文字。第二张卡片外再描一圈轮廓，作为全页唯一强调点。链条上方一行小字「v001 → v002 → v003」；链条下方放一张单页矩形示意，代表一次只出一页，不画多页堆叠或多宫格缩略。页脚一行小字「旧版本保留，可回退」。留白不少于 35%，每卡内文字不超过 4 字，不用图表坐标、照片与人物。

package/seeds/samples/deckline-intro/prompts/p06.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：风格（design）与复用
+这页回答：风格怎么定义、怎么换、换完影响什么？
+主张：风格是独立资产：一段画面描述 + 若干样张，关联到 deck 后出图自动带上，换风格不影响页面内容。
+画面要求：矩阵画廊版式，16:9 整页。顶部居左一行标题「风格（design）与复用」。主体为 2 行 ×4 列共 8 张等大卡片，卡片间距相等、四边对齐；每张卡片上方一块占位图形区（代表样张的抽象矩形），下方一行风格名，依次为「商务 / 深色 / 纸感 / 杂志 / 蓝图 / 白板 / 极简 / 渐变」。第 9 个位置（第三行左侧）放一张虚线描边卡片，内写「＋ 自定义风格」，尺寸与其余卡片一致。八张卡片等权，不突出其中任何一张，卡片上不放真实界面内容。卡片区之外不添加其他元素；页脚一行小字「同一风格可在多份 deck 复用」。留白不少于 30%，不用照片、真实 logo 与人物。

package/seeds/samples/deckline-intro/prompts/p07.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：治理文档与交接包
+这页回答：一份 deck 还包含哪些文档？
+主张：治理文档 + 交接包让 deck 能换人接手：缺项与评分可见，交付前补齐即可。
+画面要求：环形版式，16:9 整页。顶部居左一行标题「治理文档与交接包」。页面中部偏左放一个圆环，等分为 8 段，段与段之间留细缝，线宽一致；每段外侧引出一条短直线，接到一行文档名，依次为「意图 / 脚本 / Design / 修改日志 / 反馈 / 调研 / 支撑材料 / 审稿」，引线长度与角度均匀。环心放一行小字「治理评分」加一个两位数占位。页面右下角单独放一个方框，框顶标「交接包」，框口露出一叠纸张轮廓，方框高度约为圆环的三分之一，与圆环形成体量对比。页脚一行小字「缺项需在交付前补齐」。不用图表坐标、照片与人物，留白不少于 30%。

package/seeds/samples/deckline-intro/prompts/p08.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：安装与配置
+这页回答：如何安装、key 放在哪里？
+主张：安装三步：建 profile、装插件、启动；出图 key 只从环境变量或本机文件读，不落仓库。
+画面要求：左右分栏版式，16:9 整页。顶部居左一行标题「安装与配置」。左栏宽约 55%，放一个圆角矩形模拟终端窗口，窗口顶部一条标题栏含三个小圆点；窗内竖排三行等宽命令行占位，每行前有提示符，第三行末尾一个方块光标。右栏宽约 45%，上部一个钥匙形轮廓，其上叠加一道斜向划线表示禁用；下部两行说明文字，每行不超过 12 字。两栏顶部与底边对齐，栏间距等于页边距。页脚一行小字「详细步骤见 README 与 docs/install.md」。全页不出现真实域名、token、完整命令文本、照片与人物，留白不少于 30%。

package/seeds/samples/deckline-intro/prompts/p09.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：支持范围与不支持的功能
+这页回答：一期支持什么、不支持什么？
+主张：一期支持：整页图片 deck、逐页修改、版本回退、风格复用、治理文档与交接包导出。出图默认一次一页；在对话里要求整批出图同样支持，Agent 按页逐张生成，每页各自留存版本。一期不支持：HTML deck 渲染、写回客户源目录、PPT 原生图层编辑、多人实时协作与云端账户。界面暂未提供「一键批量」按钮，批量出图通过对话发起。
+画面要求：左右对照版式，16:9 整页。顶部居左一行标题「支持范围与不支持的功能」。页面纵向中缝一道 1px 细竖线，左右两半等宽。左半区顶部一行小标题「支持」，下方四行清单项，每行行首一个勾形标记，行内文字不超过 12 字；右半区顶部一行小标题「不支持」，下方四行清单项，每行行首一个叉形标记，行内文字不超过 12 字。左右行数相同、逐行对齐、行高一致、行间距相等，页面不做第三栏或其他装饰。页脚一行小字「出图一次一页」。不使用图标堆叠、照片与人物，留白不少于 35%。

package/seeds/samples/deckline-intro/prompts/p10.txt

@@ -0,0 +1,6 @@
+深色玻璃极光（编辑感）：近黑炭底 #0B0F12，四角更深；一条紫 #7C3AED 到青 #22D3EE 的低饱和极光丝带从左下向右上缓慢流动，边缘柔化、不刺眼；玻璃质感圆角面板（半透明深色 + 1px 浅白描边 + 轻模糊 + 深投影）承载内容；香槟金 #D8B26A 极细弧线与短线做点缀（0.5–1px）；标题居左、白色无衬线大字重，副标题白色 70%；信息块少而整（1–3 块），中文为主，留白大、层级清楚；整体克制、昂贵、有编辑感。
+不要什么：不要 3D 球体/环、不要满屏高饱和渐变、不要英文营销 slogan/假数字、不要虚构人名或英文署名、不要照片/写实人物、不要卡通插画、不要密集小字、不要商务蓝灰模板感、不要真实品牌 logo。
+页面标题：上手步骤
+这页回答：第一次使用按什么顺序做？
+主张：上手分三步：第一步，在工作台新建 Deck 并写明听众与时长；第二步，与 Agent 确定意图与逐页脚本，每次修改先看 diff 再确认；第三步，逐页出图，不满意可回退到上一版。想先看效果，可直接打开仓库里的 samples/deckline-intro 示例。流程说明在 docs/sample-deck.md，导出支持 PDF、PPTX 与交接包。
+画面要求：竖向步骤版式，16:9 整页。顶部居左一行标题「上手步骤」。左侧约 60% 竖向排列三条步骤，每条由左侧两位编号「01 / 02 / 03」加右侧一行动作说明组成，步骤之间用短竖线连接，三条行高一致、整体左对齐。右侧约 40% 上下排列两张等宽小卡片：上卡片写「README · docs/sample-deck.md」，下卡片写「MIT」，两卡间距与行距一致。左右两区顶部与底边对齐。页脚一行小字「示例 deck 在 samples/deckline-intro」。不用箭头涂鸦堆叠、照片与人物，留白不少于 40%。