Channek 风格卡开发
风格卡是什么,一句白话:一张卡描述「这类创作怎么做」——分几步、什么风格、文件放哪、
要用到哪些能力。它像一份菜谱:写清步骤和要用的工具,但菜谱本身不含锅也不含火(卡是纯数据,
永远不含代码;能力由插件提供,卡只声明「我要用哪些」)。
一张卡落到一个文件夹上就是一个频道:频道 = 文件夹 × 卡。分发形态是 .channekcard
包,收卡人导入后一键复刻整套创作方式。
怎么带用户(先读这段)
来找你写卡的多半是创作者,不是工程师。守住四条:
- 说人话。术语第一次出现给一句白话解释(如「pipeline,就是你从想法到发布的那几步」)。
用户听不懂不是用户的问题,是你的问题。
- 一次只问一两个问题,别一口气抛一张问卷。用户答不上来就给 2~3 个带推荐的选项让他挑
(「多数口播频道是:选题 → 写稿 → 配音 → 剪辑 → 发布,你也差不多?哪里不一样?」)。
- 用户说的是想法,不是字段名。把「我想让我的视频都是那种手绘风」翻译成对应的卡段
(画风锁
locks + 生成默认 generation),不要反问他术语。
- 动手前复述方案(「你要的是一个 X 频道,流程五步…我准备这样写,对吗?」),确认后再写文件;
写完要交代:每个文件是干嘛的、怎么装进 app 看效果、下一步能做什么。
工作流
0. 先判断用户要干哪件事
- 从零建一张卡 → 走完整访谈(下一步)。
- 改现有的卡 → 先读他的 card.json,复述你理解的现状,再问要改哪里。
- 把频道打包分发 → 跳到第 5 步,重点过可移植红线。
1. 访谈:问清创作系统的形状
四组问题,按顺序聊(不是一次全问),每组给出建议默认值:
| 问什么 |
白话问法 |
答不上来时的默认 |
| 流程 |
「从一个想法到发出去,你平时分几步?哪些步想让 AI 自动干,哪些你要亲手做?」 |
五步:选题 → 写稿 → 配音 → 剪辑 → 发布 |
| 风格 |
「有没有固定的品牌色 / 声音 / 字幕样子 / 画风?」 |
全部留空——风格段都是可选的,以后随时补 |
| 目录 |
「你的稿子、成片这些文件,习惯放什么目录结构?」 |
用内核默认布局,不写 layout |
| 依赖 |
「哪几步要靠外部能力(出图 / 配音 / 转写 / 发布)?有没有指定想用哪家?」 |
只声明能力不点名插件,由收卡人机器上的候选顶上 |
新手路线:只填 5 个必填字段 + 一个三五步的 pipeline 就是一张合法的卡——先跑起来,
风格与布局以后再加。不要一上来就把所有段都填满。
2. 写 card.json
骨架从 references/card-template.jsonc 抄,字段表查 references/card-schema.md。要点:
- 顶层必填只有 5 个:
schema: "channek.stylecard" · formatVersion: 2 · id · name · slug。
其余全部可选;某段一旦写了,段内引用会被严格校验(如写了 voice,那 voice.default
必须是 voice.profiles 里真实存在的一个)。
id 用 <发布者>.<名字> 点分小写(如 acme.talkfast);channek.* 前缀是官方保留,不可用。- 流程写进
pipeline(步序 + 每步配置)、目录写进 layout(含工件落点覆盖)、
界面写进 presentation(启用哪些功能区)、依赖写进 requires——细则见
references/pipeline-and-artifacts.md 与 references/requires-and-secrets.md。
3. 过可移植红线(每次保存前自检)
卡要在别人的机器上活,所以「只在你这台机器上成立的东西」一律不进卡:
4. 过流程体检(写完 pipeline 后自查)
5. 交付与验证
先教用户把卡用起来(比打包更优先):
- 在 app 里「新建频道 → 选这张卡」,或把卡应用到他现有的文件夹;
- 打开频道看灯轨:步骤序和他描述的一致吗?缺插件的步会显示占位卡(「由插件 X 提供 · 未安装」),
这是正常的诚实降级,不是坏了。
要分发才做打包:
- 上架物料写
meta 段,市场长文写 STOREFRONT.md(规范见 references/storefront.md);
- 不想带出门的大资产声明进
bundle.omit(带 reason,导入时会原样告诉收卡人「这块要你自己补」);
- 导出用 app 的卡导出功能(设置 → 风格卡 → 导出),绝不手工 zip——导出器会自动剥掉
本机路径、按
requires 收携带插件;
- 验收标准:在干净机器上导入这张卡包,体检报告正确列出缺插件 / 缺能力 / 缺密钥三张清单,
补齐后频道可以正常创作。
常见判断
| 问题 |
答案 |
| 这个配置放卡里还是插件设置里? |
因机因人而异的(路径、端点、密钥)→ 插件设置;描述创作方式本身的(步序、风格、提示词)→ 卡 |
| 想锁死某家能力提供方不许降级? |
requires.providers[].fallback: false;缺省是「建议优先,没装就用别家顶上」 |
| 步骤没装会怎样? |
灯轨照常显示 + 占位卡提示装哪个插件;标了 optional: true 的步会被跳过——只降级不崩溃,但要在 requires.plugins 里声明,导入向导才知道引导用户装什么 |
| 提示词放哪? |
卡内 prompts/ 目录(纯文本),prompts 段登记相对路径,步骤配置引用它 |
References
references/card-schema.md——card.json 全字段表(按层)references/pipeline-and-artifacts.md——pipeline / layout / 工件契约与解耦原理references/requires-and-secrets.md——requires 依赖声明、能力偏好链、密钥推导references/card-template.jsonc——可抄的完整示例卡(口播快剪 6 步频道)references/storefront.md——meta 段与 STOREFRONT.md 上架规范
1---2name: channek-card-dev3description: 开发、修改、校验并打包一张 Channek 风格卡（card.json / .channekcard）。当用户要「写一张风格卡 / style card」「做一个 Channek 频道模板」「声明出片流程 pipeline」「把频道打包分发 / 一键复刻」「修卡的 requires / layout / presentation」时使用。Use when developing a Channek style card, channel template, or packaging a .channekcard bundle.4---56# Channek 风格卡开发78**风格卡是什么,一句白话**:一张卡描述「这类创作怎么做」——分几步、什么风格、文件放哪、9要用到哪些能力。它像一份菜谱:写清步骤和要用的工具,但菜谱本身不含锅也不含火(卡是纯数据,10永远不含代码;能力由插件提供,卡只声明「我要用哪些」)。1112一张卡落到一个文件夹上就是一个频道:**频道 = 文件夹 × 卡**。分发形态是 `.channekcard`13包,收卡人导入后一键复刻整套创作方式。1415## 怎么带用户(先读这段)1617来找你写卡的多半是**创作者,不是工程师**。守住四条:18191. **说人话**。术语第一次出现给一句白话解释(如「pipeline,就是你从想法到发布的那几步」)。20 用户听不懂不是用户的问题,是你的问题。212. **一次只问一两个问题**,别一口气抛一张问卷。用户答不上来就给 2~3 个带推荐的选项让他挑22 (「多数口播频道是:选题 → 写稿 → 配音 → 剪辑 → 发布,你也差不多?哪里不一样?」)。233. **用户说的是想法,不是字段名**。把「我想让我的视频都是那种手绘风」翻译成对应的卡段24 (画风锁 `locks` + 生成默认 `generation`),不要反问他术语。254. **动手前复述方案**(「你要的是一个 X 频道,流程五步…我准备这样写,对吗?」),确认后再写文件;26 **写完要交代**:每个文件是干嘛的、怎么装进 app 看效果、下一步能做什么。2728## 工作流2930### 0. 先判断用户要干哪件事3132- **从零建一张卡** → 走完整访谈(下一步)。33- **改现有的卡** → 先读他的 card.json,复述你理解的现状,再问要改哪里。34- **把频道打包分发** → 跳到第 5 步,重点过可移植红线。3536### 1. 访谈:问清创作系统的形状3738四组问题,按顺序聊(不是一次全问),每组给出建议默认值:3940| 问什么 | 白话问法 | 答不上来时的默认 |41|---|---|---|42| **流程** | 「从一个想法到发出去,你平时分几步?哪些步想让 AI 自动干,哪些你要亲手做?」 | 五步:选题 → 写稿 → 配音 → 剪辑 → 发布 |43| **风格** | 「有没有固定的品牌色 / 声音 / 字幕样子 / 画风?」 | 全部留空——风格段都是可选的,以后随时补 |44| **目录** | 「你的稿子、成片这些文件,习惯放什么目录结构?」 | 用内核默认布局,不写 `layout` |45| **依赖** | 「哪几步要靠外部能力(出图 / 配音 / 转写 / 发布)?有没有指定想用哪家?」 | 只声明能力不点名插件,由收卡人机器上的候选顶上 |4647**新手路线**:只填 5 个必填字段 + 一个三五步的 `pipeline` 就是一张合法的卡——先跑起来,48风格与布局以后再加。不要一上来就把所有段都填满。4950### 2. 写 card.json5152骨架从 `references/card-template.jsonc` 抄,字段表查 `references/card-schema.md`。要点:5354- **顶层必填只有 5 个**:`schema: "channek.stylecard"` · `formatVersion: 2` · `id` · `name` · `slug`。55 其余全部可选;**某段一旦写了,段内引用会被严格校验**(如写了 `voice`,那 `voice.default`56 必须是 `voice.profiles` 里真实存在的一个)。57- `id` 用 `<发布者>.<名字>` 点分小写(如 `acme.talkfast`);`channek.*` 前缀是官方保留,不可用。58- 流程写进 `pipeline`(步序 + 每步配置)、目录写进 `layout`(含工件落点覆盖)、59 界面写进 `presentation`(启用哪些功能区)、依赖写进 `requires`——细则见60 `references/pipeline-and-artifacts.md` 与 `references/requires-and-secrets.md`。6162### 3. 过可移植红线(每次保存前自检)6364卡要在**别人的机器**上活,所以「只在你这台机器上成立的东西」一律不进卡:6566- [ ] **密钥值**不进卡——卡只声明「要哪把钥匙」,钥匙本身由每个用户自己在 app 里填。67- [ ] **本机绝对路径**(`/Users/...`、`C:\...`、`~` 开头)不进卡——别人机器上没有这个路径。68 这类因机而异的配置属于插件设置,不属于卡。69- [ ] `runtime.endpoints` 段**只声明需要哪些端点**,URL / 端口 / 模型路径等真值写了会被70 schema 直接拒(这是校验红线,不是风格建议)。71- [ ] 卡内相对路径不含 `..`、不是绝对路径(防路径逃逸,校验会拒)。72- [ ] 卡目录里**没有可执行代码**——要代码就拆成独立插件,卡用 `requires` 引用它。7374### 4. 过流程体检(写完 pipeline 后自查)7576- [ ] 每步 `key` 唯一(key 是这一步在这个频道里的名字,进度记账、文件归属都认它)。77- [ ] 引用的步骤 id、工件类型、功能区 id 都真实存在(来自内置或 `requires.plugins` 声明的插件)。78- [ ] 每步要吃的工件,上游有步骤产出它(步骤之间只靠文件衔接——断链在导入时就会被体检报出来,79 不会等用户跑到第 5 步才炸)。80- [ ] 每步 `config` 符合那一步声明的配置结构。81- [ ] `presentation.defaultSection`(若写)必须在 `presentation.sections` 里。8283### 5. 交付与验证8485**先教用户把卡用起来**(比打包更优先):86871. 在 app 里「新建频道 → 选这张卡」,或把卡应用到他现有的文件夹;882. 打开频道看灯轨:步骤序和他描述的一致吗?缺插件的步会显示占位卡(「由插件 X 提供 · 未安装」),89 这是正常的诚实降级,不是坏了。9091**要分发才做打包**:9293- 上架物料写 `meta` 段,市场长文写 `STOREFRONT.md`(规范见 `references/storefront.md`);94- 不想带出门的大资产声明进 `bundle.omit`(带 `reason`,导入时会原样告诉收卡人「这块要你自己补」);95- 导出用 app 的卡导出功能(设置 → 风格卡 → 导出),**绝不手工 zip**——导出器会自动剥掉96 本机路径、按 `requires` 收携带插件;97- 验收标准:在干净机器上导入这张卡包,体检报告正确列出缺插件 / 缺能力 / 缺密钥三张清单,98 补齐后频道可以正常创作。99100## 常见判断101102| 问题 | 答案 |103|---|---|104| 这个配置放卡里还是插件设置里? | 因机因人而异的(路径、端点、密钥)→ 插件设置;描述创作方式本身的(步序、风格、提示词)→ 卡 |105| 想锁死某家能力提供方不许降级? | `requires.providers[].fallback: false`;缺省是「建议优先,没装就用别家顶上」 |106| 步骤没装会怎样? | 灯轨照常显示 + 占位卡提示装哪个插件;标了 `optional: true` 的步会被跳过——**只降级不崩溃**,但要在 `requires.plugins` 里声明,导入向导才知道引导用户装什么 |107| 提示词放哪? | 卡内 `prompts/` 目录(纯文本),`prompts` 段登记相对路径,步骤配置引用它 |108109## References110111- `references/card-schema.md`——card.json 全字段表(按层)112- `references/pipeline-and-artifacts.md`——pipeline / layout / 工件契约与解耦原理113- `references/requires-and-secrets.md`——requires 依赖声明、能力偏好链、密钥推导114- `references/card-template.jsonc`——可抄的完整示例卡(口播快剪 6 步频道)115- `references/storefront.md`——meta 段与 STOREFRONT.md 上架规范
garveyhu