资源 · 技能市场
01

整个技能就一个文件
清单、界面和资源都在里面

02

清单格式
YAML + 给模型的指令

03

挂件版本
按 requires 支持技能

技能的内部构造。

02包结构

ZIP

整个技能就是一个 .skill 文件。 一个普通 ZIP:清单、界面的 HTML 和 JavaScript,以及媒体。只有 SKILL.md 是必需的。

宣言

SKILL.md

YAML 前置数据:slug、版本、触发语、参数。正文则是给模型的祈使式指令。

动作面板

drawer.html + js

铺满对话的抽屉:表单、日历、按钮。JS 会拿到 drawer、item 和 params。

对话流

card.html + js

对话流里的技能卡 — 一个 HTML 模板加它的脚本。两个文件都是可选的。

行为以声明式定义。 资源、触发语和版本要求都住在包里 — 就在代码旁边。

媒体 · 包

assets/

PNG、JPG、WebP、SVG、GIF — 在模板里通过 {{asset:name}},上传到存储是自动的。

触发语 · 路由

triggers

清单里的一组短语会变成嵌入向量,路由据此找到这个技能。

版本 · 兼容性

requires

parsewise_api 和挂件的最低版本 — 上传时会校验兼容性。

03组件与 API

data

你写标记,挂件负责组装。 组件以 data 属性声明,并通过 MutationObserver 处理 — 即使由 JS 动态创建也照样生效。

组件调用 · 按类型
卡片按钮表单合计
组件
data-card · radio · 图库
按钮
data-action · Heroicons · tel:
JS API
drawer · item · params
样式
Tailwind · 挂件样式类
资源
{{asset}} · 500 KB · 20 个文件
沙箱
隔离 · 挂件代理
04FAQ · 面向开发者

一个装着整个技能的 ZIP:SKILL.md(清单和给大模型的指令)、card.html 和 drawer.html 及各自的 JS,以及放媒体的 assets 目录。只有 SKILL.md 是必需的。

开始使用

上传你的文档和商品目录,然后把别人问你的问题拿去问助手。 这是唯一有意义的检验。