Knora One
详细使用教程与软件说明书

• 你的正文、素材、模板、字段和数据库都保存在本机的 KnoraOne.library 资源库文件夹中。
• 账号只负责登录、订单、授权刷新和客户端更新；你的资源内容不会上传到 Knora One 服务器。
• Knora One 不提供内置云同步、数据库合并或实时协作。需要跨设备时，可自行用第三方文件同步工具传输整个资源库，但必须按单设备顺序使用。

1. 1

   打开 Knora One

   首次启动会看到“选择 Knora One 资源库”页面。软件会给出一个推荐位置。

2. 2

   决定保存位置

   只在当前电脑使用，选择“使用推荐位置”即可；准备使用第三方文件同步工具，选择“选择其他位置”，把资源库放在该工具完整落盘的本地同步目录中。

3. 3

   确认并开始

   检查页面显示的完整路径，点击“开始使用”。Knora One 会创建或打开一个以 .library 结尾的完整资源库文件夹。

未登录时，本地资源库仍然保留在电脑上。登录的作用是取得或刷新当前设备的桌面授权、恢复订单以及检查客户端更新，不会改变资源库的保存位置。

1. 1

   打开账号入口

   点击左下角账号区域，选择“登录 / 注册”。

2. 2

   完成登录

   使用购买授权的账号登录。成功后可在“授权中心”查看永久授权或试用授权状态。

3. 3

   确认离线授权

   进入“设置 → 关于”，检查“桌面授权”是否有效。取得离线票据后，短时断网不会影响本地工作。

KnoraOne.library（整套本地数据）
└── 资产库组：工作
    ├── 资产库：产品研究
    │   ├── 文件夹：竞品资料
    │   │   ├── PDF 资产
    │   │   └── 链接资产
    │   └── Markdown 资产：调研结论
    └── 资产库：品牌素材

KnoraOne.library/
  library.json        # 资源库身份信息
  libra_space.db      # 资产、模板、字段与关系
  managed_assets/     # 导入后的原始文件与受管内容
    workspaces/
    thumbnails/
    derivatives/

• library.json、libra_space.db 和 managed_assets 必须作为一个整体移动、由第三方工具传输和备份。
• managed_assets 中的原始文件属于正式数据，不是可以随意删除的缓存。
• 缩略图和部分派生预览可以重新生成，但不要手动进入资源库内部挑选文件清理。
• 需要检查数据时，优先使用“设置 → 本地数据 → 检查资源库完整性”。

1. 1

   点击“新建组”

   在资产库首页右上区域点击“新建组”。

2. 2

   填写名称

   输入容易辨认的名称，例如“工作”“个人写作”或“摄影”。资产库组名称之后可以修改。

3. 3

   创建分组

   点击“创建”。新分组会出现在首页筛选器中，之后创建资产库时可以选择它。

1. 1

   打开新建窗口

   在首页点击“新建资产库”。

2. 2

   填写基本信息

   填写资产库名称和摘要，选择所属资产库组。摘要会展示在首页卡片和列表中。

3. 3

   选择封面

   封面可选。你可以点击选择图片，也可以把图片拖到封面预览区。

4. 4

   完成创建

   点击“创建资产库”。创建后打开卡片，即可进入资产详情页继续添加内容。

• 使用搜索框按资产库名称、摘要或资产库组查找。
• 通过资产库组筛选器，只查看当前分组或切回“全部”。
• 编辑资产库时可以修改名称、摘要、所属分组和封面。
• 删除资产库会把资产库及其下级内容移入回收站，不会立刻永久清除。
• 删除资产库组的影响更大：组内资产库、内容、模板和字段会进入删除状态，请先确认范围。

需要整理层级时，可以在当前文件夹中新建子文件夹，并通过拖拽移动资产。右键菜单还提供重命名、删除、在左侧树中定位、打开原文件所在位置和另存为等操作。

打开目标资产库或文件夹后，使用新建菜单选择要创建的内容。新资产会放在当前文件夹下，因此操作前先确认左侧树和页面标题显示的是正确位置。

1. 1

   选择目标文件夹

   在资产树中进入资料最终要存放的位置，然后打开新建菜单。

2. 2

   选择“智能导入文件…”

   在系统文件选择器中选择一个或多个文件。不同类型可以一起选择。

3. 3

   等待后台处理

   导入任务会复制原文件、读取必要的元数据并生成预览。任务较多时可打开“任务详情”查看进度。

4. 4

   检查结果

   导入完成后，按文件名找到新资产，打开预览并补充字段、附件或更易读的标题。

需要保留一整套目录结构时，选择“导入文件夹…”。确认后 Knora One 会在后台扫描目录，并把文件夹和其中的文件导入当前目标位置。内容较多时可以继续处理其他资产。

• 可以直接把本地文件拖入当前文件夹；多个文件可以一次拖入。
• 文件夹一次只支持拖入一个；文件和文件夹需要分开拖入。
• 系统无法识别或不可读取的项目会被忽略，并在提示中列出。
• 导入是把内容纳入资源库管理，不是只保存指向原位置的快捷方式。

1. 1

   选择模板

   打开“按模板创建资产…”，先确认目标文件夹，再选择需要的模板。

2. 2

   选择创建或导入模式

   创建模式适合手动填写名称；导入模式适合从本地文件生成资产。

3. 3

   填写模板字段

   根据模板填写必填项、标签、评分、日期、封面或关联资产。默认值会自动带入。

4. 4

   批量创建

   文件类模板可以一次选择多个源文件，每个文件创建一个资产，并使用文件名作为标题。

• 点击左侧树中的文件夹，在中间区域查看其直接下级内容；展开箭头只展开层级，不一定切换当前页面。
• 点击具体资产会在标签页中打开。多个标签之间可以来回切换，未关闭的编辑内容会保留现场。
• 常用资产可以“固定标签”，避免批量关闭未固定标签时被关掉。
• 标签页右键菜单支持关闭当前、关闭其他、关闭左侧、关闭右侧和关闭未固定标签。
• 找不到当前资产在树中的位置时，使用“在左侧树中定位”。

1. 1

   进入范围

   先打开需要查找的文件夹。搜索会围绕当前文件夹的内容进行。

2. 2

   输入关键字

   在文件夹上方“搜索资产…”中输入标题等文本条件，结果会立即收窄。

3. 3

   清空搜索

   删除输入内容即可恢复全部结果；没有匹配项时先检查是否处在正确文件夹。

点击文件夹页面中的“筛选”，可以先按模板缩小范围，再按模板里启用了“可用于筛选”的字段继续筛选。文本搜索仍然使用页面上方的搜索框。

• 拖动单个或多个资产到目标文件夹，可以调整它们在资产树中的位置。
• 右键资产选择“重命名”，修改软件内显示的资产名称。
• 文件资产还可打开原文件所在位置、使用系统默认软件打开或另存为副本。
• 删除操作会把内容移入回收站；需要恢复时进入主导航的“回收站”。

1. 1

   创建 Markdown 资产

   在目标文件夹选择“新建 Markdown”，填写名称后创建。

2. 2

   开始输入正文

   在编辑区直接书写。页面顶部会显示字数、行数和保存状态。

3. 3

   观察保存状态

   编辑后状态会显示为草稿或保存中；需要立即落盘时点击工具栏的“立即保存”。

4. 4

   补充结构化信息

   打开右侧“字段”“附件”或“元数据”，补充模板字段与相关文件。

• 打开“查找替换”，输入关键字后可查看匹配数量，并使用上下箭头逐个定位。
• 对当前文本可以执行“替换此处”或“全部替换”。执行批量替换前建议先确认匹配范围。
• 在文件夹上使用查找工具时，可以查看匹配分布在哪些文件中，再打开具体文件精确定位。
• 大文本模式不会展开所有匹配片段，但匹配总数仍会完整统计。
• “统计”工具可以查看当前文本或范围内的文本统计结果。

这组设置会立即应用到当前文本编辑区，并自动记住偏好。文本以外的资产不会显示全部编辑器选项。

• “使用系统默认软件打开”适合交给 Word、Photoshop、播放器等专业软件查看。
• “打开文件所在位置”会在 Finder 或资源管理器中定位受管文件。请以查看为主，不要手动移动或重命名。
• “另存为…”会导出一份副本到你选择的位置，适合发送给他人或交给外部软件处理。
• 图片预览还提供“复制图片”；Word 等文档预览可复制所选文本。

1. 1

   不要反复重建或导入

   先关闭当前资源库，避免在文件仍未同步完成时继续写入。

2. 2

   检查第三方云盘

   如果资源库由第三方工具传输，确认对应文件不是“仅在线”，并让整个 KnoraOne.library 完整下载到本地。

3. 3

   重新打开并检查

   文件传输完成后重新打开 Knora One。如果仍缺失，进入设置执行资源库完整性检查。

4. 4

   从备份恢复

   从完整备份或云盘历史版本恢复资源库。不要只恢复数据库而漏掉 managed_assets。

如果一类内容总要填写相同信息，就适合使用模板。例如“研究卡片”都需要来源、作者、主题和评分；“图片素材”都需要版权状态、色调和项目标签。

1. 1

   进入模板管理

   在主导航选择“模板管理”，确认当前资产库组范围。

2. 2

   点击“新建模板”

   填写模板名称，例如“研究卡片”；模板分组可填写“学习”或“资料”，用于列表归类。

3. 3

   选择资产类型与正文格式

   根据内容选择文本、文件夹、文件或链接。文本模板还要选择普通文本、Markdown 或富文本格式。

4. 4

   配置工具

   决定右侧显示哪些工具，例如字段、附件、元数据、编辑器、查找替换、统计和写作。

5. 5

   创建模板

   保存后继续添加字段定义。模板会出现在当前范围的创建菜单和模板选择器中。

1. 1

   选中自定义模板

   在模板详情中找到字段区域，点击新建字段。

2. 2

   选择字段模式

   普通字段保存文本、数字等值；封面图字段用于图片封面；关联资产字段连接当前资产库中的其他资产。

3. 3

   选择字段类型

   按信息性质选择字符串、数字、评分、布尔、日期、日期时间、枚举、标签或 JSON。

4. 4

   设置规则

   按需要设置默认值、必填、显示在资产卡片中，以及是否可用于文件夹筛选。

5. 5

   保存并试用

   创建一条样本资产，确认输入控件、卡片展示和筛选效果都符合预期。

• 字段名称可以修改；字段 Key 会保持稳定，不会因为改名而改变。
• 枚举选项使用固定值，适合状态流程；标签可以自由添加，更适合开放式分类。
• “显示在资产卡片中”只适合少量关键信息，字段太多会让卡片难以浏览。
• 启用“可用于筛选”后，该字段会出现在文件夹筛选面板中。
• 必填字段会在保存资产时校验，批量导入前要确认默认值是否足够。

• “数据根目录”展示当前资源库文件夹，可切换资源库、打开目录或复制路径。
• “数据库文件”展示资源库内 SQLite 数据库的位置，可打开所在目录或复制路径。
• “检查资源库完整性”是只读检查，不会修改数据。它会检查路径、数据库结构和受管文件引用。
• 检查结果分为通过、警告和失败。出现问题时先阅读具体项目，再决定是否从备份恢复。

1. 1

   确保当前内容已经保存

   查看顶部状态，等待“保存中”结束；有草稿时先点击“立即保存”。

2. 2

   打开本地数据设置

   进入“设置 → 本地数据”，点击“切换资源库”。

3. 3

   选择完整的 .library 文件夹

   不要选择其中的数据库文件或 managed_assets 子目录。

4. 4

   等待重新加载

   切换完成后确认首页的资产库组、资产库和数量是目标资源库的内容。

进入“设置 → 关于”，可以查看当前版本、Build、平台、系统架构、发布渠道、桌面授权和最新版本。点击“检查更新”获取发布清单。

• macOS 或 Windows 支持应用内更新时，可按提示下载新版并“安装并重启”。
• 安装前软件会保存当前编辑内容，并校验安装器。
• 在线服务暂不可用时，已经取得的离线授权仍然有效，本地工作不受影响。
• 即使版本被标记为必须更新，也可以取消并稍后处理，应用不会因此锁定本地资料。

1. 1

   把整个资源库放入本地同步目录

   资源库路径应类似“云盘目录/KnoraOne.library”，不要只同步数据库或 managed_assets。

2. 2

   确保始终保留在本地

   对资源库文件夹启用“始终保留在此设备”“离线可用”或同等设置。

3. 3

   一台设备用完后完全退出

   等待保存完成并完全退出 Knora One，再等待第三方工具上传完成。

4. 4

   另一台设备等待下载完成

   确认第三方工具已完成下载且整个资源库离线可用后，再打开同一资源库。

设备 A：等待保存完成 → 退出 Knora One → 等第三方工具上传完成
                                            ↓
设备 B：等第三方工具下载完成 → 确认文件离线可用 → 打开 Knora One

• 看到活跃锁提示时，先确认另一台设备或另一个进程是否仍在使用资源库。
• 只有确定旧进程已经退出且文件传输完成，才考虑接管资源库；不要把锁提示当作普通弹窗直接忽略。
• 第三方工具出现冲突副本时，先复制一份完整资源库作为现场备份，再停止所有设备上的写入。
• 传输后数量或内容异常时，关闭应用、等待传输完成，再只在一台设备上检查。

同步不是备份：同步会把误删、损坏或错误修改传播到其他设备。可靠做法是定期保存资源库的独立历史副本。

1. 1

   在旧电脑退出 Knora One

   等待所有编辑和导入任务完成，完全退出应用。

2. 2

   复制整个资源库

   把 KnoraOne.library 复制到移动硬盘、局域网或云盘。不要拆分内部文件。

3. 3

   在新电脑完整落盘

   复制到最终位置，并确认文件夹不是仅在线状态。

4. 4

   安装并打开 Knora One

   首次启动或“设置 → 本地数据 → 切换资源库”中选择该 .library 文件夹。

5. 5

   验证迁移结果

   抽查资产数量、几种文件预览、模板字段和附件，再执行一次资源库完整性检查。

1. 1

   打开回收站

   从主导航进入“回收站”，选择查看当前资产库组或全部资产库组的已删除内容。

2. 2

   查找条目

   按标题、摘要搜索，或按资产、模板、文本、音频、视频、文件、链接、文件夹筛选。

3. 3

   选择恢复或彻底删除

   恢复会让内容重新可用；彻底删除会永久清除，无法从回收站恢复。

1. 1

   确认选择的是 .library 文件夹

   不要选择 libra_space.db 或 managed_assets。

2. 2

   检查三个核心位置

   确认 library.json、libra_space.db 和 managed_assets 都存在且可读取。

3. 3

   检查云盘状态

   让整个资源库离线可用，并等待同步结束。

4. 4

   检查是否仍被占用

   确认其他电脑和进程已经退出；看到锁提示时不要盲目强制接管。

5. 5

   使用完整备份

   如果核心文件损坏或缺失，恢复同一时间点的完整资源库副本。

停止写入
  ↓
完全退出所有设备上的 Knora One
  ↓
复制当前整个 .library 作为现场备份
  ↓
确认云盘同步状态与核心文件
  ↓
只在一台设备上运行完整性检查
  ↓
必要时从同一时间点的完整备份恢复