使用指南更新 导入metadata 的说明

文档/使用指南/使用指南2024.md

@@ -46,8 +46,62 @@
 ## 添加关联题
 
 
-## 汇入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等)
+## 导入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等)
 
+在``工具v2/文本文件``目录中有一个名为``metadata.txt``的文件, 其一般结构如下:
+
+```txt
+ans
+
+10235
+$1$
+
+2235
+真命题
+
+usages
+
+021146
+20231222	2025届高二11班	1.000
+
+021147
+20231222	2025届高二11班	0.952
+```
+
+其中``ans``表示答案, ``usages``表示使用记录.
+
+这个``metadata.txt``文件如果导入题库, 会
+- 把第``10235``题的答案用``$1$``覆盖, 
+- 把第``2235``题的答案用``真命题``覆盖, 
+- 在``21146``的``usages``字段中添加``20231222	2025届高二11班	1.000``, 
+- 在``021147``的``usages``字段中添加``20231222	2025届高二11班	0.952``.
+
+每一个字段(如``ans``或``usages``等)及每一条记录之间都用多于一个换行符分隔(很多情况下换行之类的格式都是自动生成的), 其他``metadata.txt``可以接受的字段有:
+
+- ``content``: 题目内容(``str``类型), 导入时将**覆盖**原内容
+- ``objs``: 课时目标(目标代码, ``list``类型), 导入时将**新增**项目
+- ``tags``: 题目标签(``list``类型), 导入时将**新增**项目
+- ``genre``: 题目类型(填空题/选择题/解答题), 导入时将**覆盖**原内容
+- ``ans``: 答案(``str``类型), 导入时将**覆盖**原内容
+- ``solution``: 解答或提示(``str``类型), 导入时将**覆盖**原内容
+- ``duration``: 所需时间(单位为分钟, 暂时均赋值``-1``, ``int``类型), 导入时将**覆盖**原内容
+- ``usages``: 使用记录(``yyyymmdd<tab>班级代号<tab>得分率``), 导入时将和之前的记录作比对, 如果确认是新的则**新增**项目
+- ``edit``: 编辑记录(``list``类型), 导入时将**新增**项目
+- ``same``: 相同题号(指内容和类型均相同的题目, ``list``类型), 导入时将**双向新增**项目(a与b相同当且仅当b与a相同, 导入时会在两道题的记录中同时添加题号)
+- ``related``: 相关题号(指题目和做法都基本一致或者某一题是另一题的一部分, ``list``类型), 导入时将**双向新增**项目(a与b相关当且仅当b与a相关, 导入时会在两道题的记录中同时添加题号)
+- ``unrelated``: 无关题号(指字符串意义上相近, 容易被自动找出, 但实际上无关的题目, ``list``类型), 导入时将**双向新增**项目(a与b无关当且仅当b与a无关, 导入时会在两道题的记录中同时添加题号)
+- ``remark``: 备注(``str``类型), 导入时将**新增**字符串
+- ``space``: 题后的空间(单位一般为``em``, 大部分解答题默认为``4em``, ``str``类型), 导入时将**覆盖**原内容
+
+准备好``metadata.txt``文件之后, 在工具面板上按``维护``-``批量添加字段数据``
+
+![批量添加字段数据](http://wwylss.synology.me:48089/i/2024/02/08/65c4dfc8bf93e.png)
+
+在``vscode``界面会打开``文本文件/metadata.txt``, 编辑完成后**保存关闭**(重要, 不关闭的话面板会处于假死状态), 面板会生成一个绿色的``运行``按钮, 按动按钮, 系统会自动导入数据到``题库0.3/Problems.json``.
+
+![运行按钮](http://wwylss.synology.me:48089/i/2024/02/08/65c4e0ba11e72.png)
+
+随后如果有必要, 可保存``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.
 
 ## 两种编辑题库中已有题目的方式