自定义 Project 模型
套餐:Free 可自定义 Defaults;Plus 可新增 Global 定义;Pro 可定制 Project。
Scroll 将卡片结构分为三个层级。每个条目在列表中只显示一次,并用徽标说明当前生效来源。
| 层级 | 用途 | 可用套餐 |
|---|---|---|
| Defaults | Scroll 随附的出厂定义;不能删除 | Free、Plus、Pro 均可编辑并保存为 Global 自定义设置 |
| Global | 在本机多个 Project 中复用的定义 | Plus、Pro 可新建和管理 |
| Project | 只影响当前 Project 的定义 | Pro 可新建、覆盖和管理 |
编辑 Default 不会改写出厂定义。Scroll 只保存您实际修改的字段,因此应用更新为 Default 增加新字段时,未修改字段仍会自动采用新版内容。选择 Reset override 会移除当前层的自定义设置,并重新显示上游版本。
卡片类型、模板与卡片实例
这三者承担不同职责:
- Card Type 定义抽象分类与约束,例如人物可以有哪些父类型、可以连接哪些目标类型;
- Card Template 定义某类实际卡片需要填写的属性、关系字段、内容区块、外观和创建表单顺序;
- 实际卡片保存用户填写的数据,并同时记录实体类型和卡片模板。
右侧 Schema 面板的 Card Types、Properties 和 Relationships 用于维护可复用定义;主体模板编辑器只维护具体模板。属性或关系在 Card Type 中可用,并不代表每个模板都必须显示它,只有模板明确引用后才会出现在卡片中。
建模顺序
为减少返工,建议按以下顺序设计:
- 先列出要管理的 Card Type;
- 定义可用于这些 Card Type 的共享属性;
- 定义关系类型、关系分组和允许的来源与目标;
- 建立 Card Template,并引用需要实际显示的属性和关系槽位;
- 用少量测试卡片验证 Story 视图;
- 最后再对旧文件执行元数据迁移。
编辑与新建
单击列表条目只会预览。要修改条目,请单击铅笔按钮;属性和关系条目一次只展开一个。离开含有未保存修改的条目时,Scroll 会要求保存或放弃。
- Free:打开 Default 的铅笔编辑器,保存为 Global 自定义设置,或重置该设置;
- Plus:还可以在 Global 新建、复制和导入定义;
- Pro:还可以明确选择 Project,建立只属于当前 Project 的定义或覆盖。
保存后,ID 和会重新解释已有数据的语义字段会锁定。例如 Card Type 的 ID 与类别、Template 的 ID 与 Card Type、Property 的 ID 与数据类型,以及 Relation Type 的方向不能直接改写。需要另一种语义时,请复制成新定义。
自定义卡片模板
打开模板工作区。顶部标签包括 实体模板、事件模板、关系模板 和 文本模板。模板可以设置:
- 稳定的 ID、名称与说明;
- 内容形式与 分类预设;
- 图标、颜色和头像字段;
- 创建表单字段与排列顺序;
- 属性引用;
- 关系槽位;
- 内容区块;
- 模板实例是否可以作为 Story 分组;
- 事件的时间类型、必填字段和关系分组。
Card Type 的父类型和关系目标属于右侧 Schema 面板,不在具体模板中重复定义。模板 ID 一旦保存即锁定;显示名称仍可修改。保存前请先处理界面显示的验证提示。
受管理目录
Card Type 根目录、Template 文件夹和卡片目标目录都通过系统原生目录选择器选择,不能在文本框中随意输入路径。
- 没有打开 Project 时,Global 定义使用 Scroll 生成的安全默认目录;
- Global 自定义设置或 Global 自定义定义第一次用于某个 Project 时,Scroll 会要求确认项目内目录;
- Project Card Type 必须选择 Project 内的根目录;
- Template 文件夹必须是 Card Type 根目录的直接子目录,Scroll 只显示并保存该子目录名称;
- 已绑定的 Project 不会因为 Global 默认目录后来变化而自动移动;移动已有目录需要 Pro,并会先显示迁移预览。
如果选择的目录已经属于另一个 Card Type,Scroll 不会按目录名把两种类型合并。请改为自定义现有 Card Type、在它下面新建 Template,或选择其他目录。
自定义属性
在右侧 Properties 中建立共享属性,指定它适用于哪些 Card Type,再把该属性加入具体模板。可用类型包括短文本、长文本、数字、单选、多选、状态、日期、复选框、链接、邮箱、电话、文件、媒体、公式和汇总。
定义属性时应明确:
- 稳定且可读的属性 ID;
- 显示名称、默认值和是否必填;
- 单选和多选字段的选项与颜色;
- 公式字段的返回类型;
- 汇总字段的来源、目标字段与汇总方式。
不要为含义相同的数据建立多个相近字段,例如同时使用 home、homePlace 和 residence。字段越稳定,表格、筛选和迁移越容易维护。
自定义关系
在右侧 Relationships 中维护关系分组和关系类型。条目默认折叠;单击铅笔按钮后才进入编辑。关系类型可以定义:
- 标签、颜色和实线、虚线、点线等线型;
- 单向、双向或无方向语义;
- 反向关系和反向标签;
- 允许的来源 Card Type 与目标 Card Type;
- 是否允许同一对卡片存在多条关系;
- 是否可用于分组、关系图或模板关系槽位。
模板还会用关系槽位进一步限制某个字段可选择的关系和目标。实际卡片只显示模板定义的关系字段;保存后可到关系图检查方向、反向标签、分组框和筛选结果。
迁移已有卡片
旧卡片不会因为您新建自定义结构就自动获得或重命名字段。需要批量整理时:
- 先备份整个 Project。
- 在 Story 顶部打开 交付(菜单标题为 交付工作流),选择 Metadata 迁移预览(元数据迁移预览)。
- 按 系统、属性、关系、默认值、Unknown(未知分类)与 无需变更 检查建议。
- 使用搜索和勾选,只选择确定要应用的项目。
- 阅读变更摘要,第一次单击 应用已选 patch(应用所选变更)进入确认,再次确认后才执行。
- 完成后重新打开几张代表性卡片,并检查表格与关系图。
迁移会保留无法识别的分类,而不是把未知数据强行改成默认值。若某条建议的含义不清楚,应取消选择并手动检查原 Markdown。
降级与恢复
- Plus 降级到 Free 后,仍可编辑 Default 的 Global 自定义设置;由 Plus 新建的 Global 定义变为只读。
- Pro 降级后,Project 定义变为只读,但仍会参与卡片创建、显示和关系验证。
- 降级不会删除自定义字段、关系、模板或受管理目录绑定。
- 所有套餐都可以继续管理已有属性的选项列表。