update

dev/hook.md

@@ -9,10 +9,10 @@ import { Context, Time } from 'hydrooj';
 
 export async function apply(ctx: Context) {
     // handler 表示路由事件
-    // after 表示在主逻辑完成后运行
+    // after 表示在主逻辑完成后运行，同时支持 before, before-operation, 参照 【插件编写】 章节 【请求流程】
     // RecordDetail 为需要捕获的路由名
-    // get 表示仅捕获 GET 请求
-    ctx.on('handler/after/RecordDetail#get', (h) => {
+    // #get 表示仅捕获 GET 请求，若无此后缀表示捕获该路由的所有请求
+    ctx.on('handler/after/RecordDetail#get', (h) => { // handler 系列钩子的一参数为对应的 Handler 实例
         if (h.rdoc._id.getTimestamp() < new Date(Date.now() - Time.day) {
             h.rdoc.code = '';
         }

dev/typescript.md

@@ -22,6 +22,17 @@ question private:
 success Saved package.json
 ```
 
+## 可选：在本机环境编写插件
+
+有时我们希望使用本机的 IDE 编写插件上传到服务器（我们也推荐这么做，编辑器提供的代码补全可以很大程度简化开发流程），可以进行如下操作：  
+
+1. 在本机安装 NodeJS 和 yarn 。
+2. 参照步骤 1 使用 `yarn init` 创建一个项目。
+3. 使用 VSCode 打开插件文件夹。
+4. 使用 `yarn add hydrooj -D` 安装相关开发组件。
+5. 参照下文进行插件开发工作
+6. 将本地的文件夹上传至服务器，并使用 `hydrooj addon add 插件绝对路径` 启用上传的插件。
+
 ## Step2 准备编写组件
 
 分析：剪贴板组件需要以下功能：