文件星标与字段

星标与字段

两种再次找到重要内容的方式：个人为自己加的星标，以及你的应用关联到自身记录的字段。

个人

星标

在文件或文件夹的详情或菜单中点击加星标：它在任何显示的位置都会带有星标，并出现在已加星标中，最近加星标的排在前面。
仅限自己：其他人看不到某人加了哪些星标。已在回收站、已删除或已无权读取的内容不会显示。
作为个人设置保存（starred:<id>），最多一千个：GET /starred，PUT 和 DELETE /entries/:id/star。

const starred = await client.starred();   // the last starred first
await client.star(file.id);                // and client.star(file.id, false) to take it out

你的记录

自有字段

条目上按名称保存的文字，由你的应用或用户设置，并可据此查找：把合同关联到 CRM 中的客户，把扫描件关联到案件。

// The files of a client of your CRM, tied to it by a field of your own:
await client.setFields(file.id, { client: 'acme', stage: 'won' });
await client.setFields(file.id, { stage: null });          // taken away
const ofAcme = await client.withField('client', 'acme');   // of what the one asking may read

// In the drive: shown in the details, and changed there with fields="edit".
<FileDrive base="/api/files" fields="edit" />

名称由字母、数字和 _ . - 组成，最多 64 个字符；值为文字，最多 1000 个字符；每个条目最多五十个。由有重命名权限的人设置（PATCH /entries/:id，带 fields）。
GET /fields?name=&value= 查找具有该字段值且请求者可读取的内容：SQLite 和 Postgres 直接查询每个条目的 JSON，因此数千个条目的网盘不必整个读取。
详情中会显示这些字段，除非设置 fields={false}；fields="edit" 允许有重命名权限的人在详情中修改，每行一个字段。