# 属性、模板与视图

> 用 dino prop 给笔记加结构化属性，用 dino template 把常用格式做成模板，再用 dino view 建一个按属性筛选的保存视图。

- 网页：https://dinox.info/guides/cli/properties-and-views
- 本页 Markdown：https://dinox.info/guides/cli/properties-and-views.md
- 全部文档索引：https://dinox.info/llms.txt

当笔记多起来，你会想给它们加「字段」：这本书读到哪了、这个项目的负责人是谁、这条灵感的优先级……Dinox 的**属性**就是这些字段；**模板**让新笔记自动带上固定结构和属性；**视图**把符合条件的笔记排成一张表。

这三样在 App 里设置好的，`dino` 都能直接用；反过来，`dino` 建的属性、模板、视图也会同步到 App。

## 案例：搭一个读书清单

我们要做的事：建一个「阅读状态」属性 → 做一张「读书卡片」模板 → 用模板新建读书笔记 → 建一个「我的书单」视图看全部书的进度。

### 第 1 步：建一个「阅读状态」属性

```bash
dino prop create --key 示例阅读状态 --type status \
  --option 想读:gray --option 在读:blue --option 读完:green
```

![截图：新建状态属性（status 类型的属性，三个选项各有颜色）](https://dinox.info/assets/docs/cli/prop-create.webp)

用 `dino prop get 示例阅读状态` 查看定义，每个选项都有稳定的 ID：

![截图：查看属性定义（属性定义：类型、选项、颜色、排序）](https://dinox.info/assets/docs/cli/prop-get.webp)

### 第 2 步：给一本书设置状态

```bash
dino prop set <笔记ID> --set 示例阅读状态=在读
dino prop show <笔记ID>
```

![截图：给笔记设置属性值（直接写选项名「在读」，dino 会校验并换成对应的选项）](https://dinox.info/assets/docs/cli/prop-set.webp)

### 第 3 步：做一张「读书卡片」模板

模板内容就是一份 Markdown，`--property-key` 让用这个模板建的笔记自动带上「阅读状态」属性：

```bash
dino template create --name 示例：读书卡片 \
  --content @./读书卡片.md --property-key 示例阅读状态
```

![截图：新建笔记模板（模板里的 {{date}} 会在新建笔记时替换成当天日期）](https://dinox.info/assets/docs/cli/template-create.webp)

### 第 4 步：用模板新建读书笔记

```bash
dino note create --title "示例：读书卡片《深度工作》" \
  --template <模板ID> \
  --properties '{"示例阅读状态":"想读"}' --tags 文档示例 --type note
```

![截图：用模板新建笔记（template list 找到模板 ID，note create --template 套用结构并设置初始属性）](https://dinox.info/assets/docs/cli/template-use.webp)

### 第 5 步：建一个「我的书单」视图

视图由两部分组成：**筛选**（哪些笔记）和**配置**（怎么展示）。筛选写成 JSON，这里是「阅读状态不为空」：

```bash
dino view create --name 示例：我的书单 --emoji 📚 \
  --filter @./书单筛选.json --config @./书单配置.json
```

![截图：新建保存视图（先 --dry-run 预演，再真正创建；返回视图 ID）](https://dinox.info/assets/docs/cli/view-create.webp)

`书单配置.json` 指定用表格展示、显示哪几列、按更新时间倒序：

```json
{
  "version": 1,
  "layout": "table",
  "columns": [
    { "field": "sys.title" },
    { "field": "prop.示例阅读状态" },
    { "field": "sys.updated_at" }
  ],
  "sort": [{ "field": "sys.updated_at", "direction": "desc" }]
}
```

不知道有哪些字段可以筛选？运行 `dino view fields`，它会列出所有系统字段、属性字段和每个字段支持的筛选条件。

### 第 6 步：查询视图

```bash
dino view query <视图ID>
```

![截图：查询保存视图（视图里的两本书，以及它们各自的阅读状态）](https://dinox.info/assets/docs/cli/view-query.webp)

这个视图也会出现在 App 的视图列表里，在手机上打开就是同一张书单。

## 交给 AI 助手

Codex 用 `dino-manage-views` 技能找到书单视图并查询：

![截图：Codex 查询书单视图（「看看我的书单视图里都有哪些书，分别读到哪了？」）](https://dinox.info/assets/docs/cli/chat-views.webp)

Claude Code 用 `dino-manage-properties` 技能先看属性、预演、再修改：

![截图：Claude Code 修改属性（「我开始读《深度工作》了，把它的阅读状态改成在读」）](https://dinox.info/assets/docs/cli/chat-props.webp)

## 更多命令

| 命令                                      | 作用                       |
| --------------------------------------- | ------------------------ |
| `dino prop list`                        | 列出所有属性定义                 |
| `dino prop update` / `delete`           | 修改 / 删除属性定义（删除后笔记上的值会保留） |
| `dino prop fill <笔记ID>`                 | 只填写笔记上还空着的属性             |
| `dino view count <视图ID>`                | 统计视图里有多少条笔记              |
| `dino view analytics <视图ID>`            | 计算视图里配置的统计、图表和汇总行        |
| `dino template list` / `get` / `update` | 查看、修改模板                  |