| name | channek-card-dev |
| description | 开发、修改、校验并打包一张 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. |
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 上架规范
