> For the complete documentation index, see [llms.txt](https://ceramic-zhong-wen-wen-dang.gitbook.io/ceramic-zhong-wen-wen-dang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ceramic-zhong-wen-wen-dang.gitbook.io/ceramic-zhong-wen-wen-dang/ceramic-ji-ben-jie-shao/kuai-su-kai-shi.md).
# 快速开始
## Ceramic 基本概念
这是关于 Ceramic 基本概念的简单介绍。您可以通过使用 Ceramic CLI 学习基础知识。
## 设置
### **预备条件**
Ceramic 需要 Node.js v16 和 npm v6。虽然 npm v7 并未官方支持，但你可能还是能让它运行起来。你需要全局安装 node-pre-gyp 包。在 IPFS 依赖的 node-webrtc 升级之前，这是必须的。
```Plain
npm install -g node-pre-gyp
```
### **安装 Ceramic**
打开控制台，使用 npm 安装 CLI：
```Plain
npm install --global @ceramicnetwork/cli @glazed/cli
```
现在，Ceramic CLI 可以通过 `ceramic` 访问，Glaze CLI 可以通过 `glaze` 访问。运行 `ceramic help` 和 `glaze help` 来列出可用的命令。
### **启动 Ceramic**
启动一个与 Clay Testnet 连接的本地 Ceramic 节点，访问地址：[https://localhost:7007：](https://ceramic-zhong-wen-wen-dang.gitbook.io/ceramic-zhong-wen-wen-dang/ceramic-ji-ben-jie-shao/https:/localhost:7007：)
```Plain
ceramic daemon
```
### **创建账户**
Ceramic 交易必须由一个账户（DID）签名。Glaze CLI 可以为你创建一个 DID，只需生成一个 32 字节的随机种子：
```Plain
glaze did:create
```
你的输出应该类似于这样，`...` 用于简洁：
```Plain
✔ Created DID did:key:z6Mk... with seed ab...f0
```
然后，可以在运行其他命令时使用这个种子：
```Plain
glaze [command] --key=ab...f0
DID_KEY=ab...f0 glaze [command]
```
注意：输入 `--key` 时，应该是你的编码种子，而不是 `did:key` 本身。
## Streams 数据流
Ceramic 的使用取决于你正在与之交互的特定类型的 streams，因为它们各自有自己的 API。在这个例子中，Glaze CLI 与 tile documents 交互，streams 存储可变的 JSON。
### **创建**
使用你的账户创建一个新的 tile document：
```Plain
glaze tile:create --key ab...f0 --content '{"Foo":"Bar"}'
```
更多选项 `--metadata`: 设置流的元数据 运行 `glaze tile:create -h` 查看所有可用选项
### **查询**
使用 `tile:show` 与 StreamID 加载 tile document 的当前状态：
```Plain
glaze tile:show kjzl6cwe1jw147ww5d8pswh1hjh686mut8v1br10dar8l9a3n1wf8z38l0bg8qa
```
你应该使用你自己的 StreamID，而不是这里包含的 StreamID。\
使用 `stream:state` 与 StreamID 加载 stream 的整个状态：
```Plain
glaze stream:state kjzl6cwe1jw147ww5d8pswh1hjh686mut8v1br10dar8l9a3n1wf8z38l0bg8qa
```
你应该使用你自己的 StreamID，而不是这里包含的 StreamID。
### **更新**
使用 `tile:update` 更新 tile document。注意，你的 DID 必须被指定为流的控制器（作者），才有权限更新它。
```Plain
glaze tile:update kjzl6cwe1jw147ww5d8pswh1hjh686mut8v1br10dar8l9a3n1wf8z38l0bg8qa --key ab...f0 --content '{"Foo":"Baz"}'
```
你应该使用你自己的 StreamID，而不是这里包含的 StreamID。更多选项 您可以使用CLI更改内容和元数据。运行 `glaze tile:update -h` 获取更多信息。
## 数据模型（Schemas）
### **创建数据模型**
Tile documents 可以强制其内容符合数据模型。这些数据模型本身实际上也存储在 tile documents 中，其中的内容是 json-schema。让我们创建一个需要标题和消息的数据模型：
```Plain
glaze tile:create --key ab...f0 --content '{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Reward",
"type": "object",
"properties": {
"title": {"type": "string"},
"message": {"type": "string"}
},
"required": [
"message",
"title"
]
}'
```
### **选择版本**
首先，使用 `stream:commits` 命令列出 schema stream 中包含的 commits。找到你想使用的特定 commit（版本）。
```Plain
glaze stream:commits kjzl6cwe1jw1472as4pj3b3ahqmkokbmwc7jchqcob6pcixcoo4kxq6ls8uuxgb
```
你应该使用你想强制执行的 json-schema 的 stream 的 StreamID，而不是这里包含的 StreamID。如果一个流包含多个 commits，你不确定你想要哪一个，使用 `tile:show` 命令显示给定 commit 时流的内容。
### **使用数据模型**
当创建一个使用此数据模型的 tile document 时，我们需要使用 commitID 而不是 StreamID，以强制我们使用数据模型的特定版本，因为数据模型的Stream是可变的，可以被更新。要创建符合你的数据模型的Stream，请使用 `tile:create` 命令，并传递 `--metadata` 选项以及你的 commitID：
```Plain
glaze tile:create --key ab...f0 --content '{
"title": "My first document with schema",
"message": "Hello World"
}' --metadata '{"schema":"k3y52l7qbv1frxu8co1hjrivem5cj2oiqtytlku3e4vjo92l67fkkvu6ywuzfxvy8"}'
```
你应该使用你自己的 commitID，而不是这里包含的 commitID。
### **确认**
让我们使用上面的 `stream:state` 命令查看我们刚刚创建的 tile document。我们会看到在 metadata 中正确设置了模式。
```Plain
glaze stream:state kjzl6cwe1jw14b5sr79heovz7fziz4d
xcn8upx3bcesriloqcui137k6rq6g2mn
```
你应该使用你自己的 StreamID，而不是这里包含的 StreamID。