mn-docs-mcp 0.6.2 → 1.0.0

package/src/content/docs/reference/foundation/ns-set.md

@@ -3,7 +3,7 @@ title: NSSet
 description: 不可变无序集合（集合/去重容器）。
 ---
 
-`NSSet` 是不可变集合，适合表示“去重后的元素集合”。在插件环境中，你会在很多 API 里见到它（例如返回一组对象、或用于 membership 判断）。
+`NSSet` 是不可变集合，适合表示“去重后的元素集合”。你会在很多 API 里见到它（例如返回一组对象、或用于 membership 判断）。
 
 ## 类成员 (Class members)
 

package/src/content/docs/reference/foundation/ns-simple-c-string.md

@@ -3,7 +3,7 @@ title: NSSimpleCString
 description: 内部字符串类型（可当作 NSString 使用）。
 ---
 
-`NSSimpleCString` 是一种内部字符串类型。在插件环境中你通常**不需要关心它本身**：它按“字符串”语义工作，可当作 `NSString`/JS 字符串的等价载体来使用。
+`NSSimpleCString` 是一种内部字符串类型。你默认**不需要关心它本身**：它按“字符串”语义工作，可当作 `NSString`/JS 字符串的等价载体来使用。
 
 ## 实例成员 (Instance members)
 
@@ -11,10 +11,9 @@ description: 内部字符串类型（可当作 NSString 使用）。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `NSSimpleCString` 的类成员。
+当前接口未额外暴露 `NSSimpleCString` 的类成员。
 
 ## 说明
 
 - **没有额外可调用成员**：它不额外暴露独有方法/属性。
-- **使用建议**：把它当作普通字符串传递/拼接/比较即可。
-
+- **使用规范**：把它当作普通字符串传递/拼接/比较即可。

package/src/content/docs/reference/foundation/ns-time-zone.md

@@ -3,7 +3,7 @@ title: NSTimeZone
 description: 时区对象。
 ---
 
-`NSTimeZone` 表示时区信息，通常与 `NSDateFormatter` 配合使用。
+`NSTimeZone` 表示时区信息，默认与 `NSDateFormatter` 配合使用。
 
 ## 类成员 (Class members)
 

package/src/content/docs/reference/foundation/ns-ubiquitous-key-value-store.md

@@ -0,0 +1,61 @@
+---
+title: NSUbiquitousKeyValueStore
+description: iCloud键值存储对象。用于跨设备同步少量配置数据。
+---
+
+`NSUbiquitousKeyValueStore`用于iCloud键值同步。适合存放小体积配置，不适合大数据或强一致事务。
+
+## 类成员 (Class members)
+
+### `defaultStore`
+
+获取默认iCloud键值存储实例。
+
+```javascript
+static defaultStore(): NSUbiquitousKeyValueStore
+```
+
+## 实例成员 (Instance members)
+
+### 读取
+
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `objectForKey(key)` | key: string | any | 读取任意对象。 |
+| `stringForKey(key)` | key: string | string \| null | 读取字符串。 |
+| `arrayForKey(key)` | key: string | NSArray \| null | 读取数组。 |
+| `dictionaryForKey(key)` | key: string | NSDictionary \| null | 读取字典。 |
+| `dataForKey(key)` | key: string | NSData \| null | 读取二进制数据。 |
+| `longLongForKey(key)` | key: string | number | 读取long long。 |
+| `doubleForKey(key)` | key: string | number | 读取double。 |
+| `boolForKey(key)` | key: string | boolean | 读取布尔值。 |
+
+### 写入
+
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `setObjectForKey(value, key)` | value: any, key: string | void | 写入对象。 |
+| `setStringForKey(value, key)` | value: string, key: string | void | 写入字符串。 |
+| `setArrayForKey(value, key)` | value: NSArray, key: string | void | 写入数组。 |
+| `setDictionaryForKey(value, key)` | value: NSDictionary, key: string | void | 写入字典。 |
+| `setDataForKey(value, key)` | value: NSData, key: string | void | 写入二进制数据。 |
+| `setLongLongForKey(value, key)` | value: number, key: string | void | 写入long long。 |
+| `setDoubleForKey(value, key)` | value: number, key: string | void | 写入double。 |
+| `setBoolForKey(value, key)` | value: boolean, key: string | void | 写入布尔值。 |
+
+### 其他
+
+| 方法 | 参数 | 返回值 | 说明 |
+| --- | --- | --- | --- |
+| `removeObjectForKey(key)` | key: string | void | 删除键。 |
+| `dictionaryRepresentation()` | — | NSDictionary | 获取当前键值快照。 |
+| `synchronize()` | — | boolean | 触发同步。 |
+
+## 使用规范
+
+- 缺失key时，读取默认返回`nil/0/false`。
+- `synchronize()`不保证强一致即时成功，受iCloud账号、网络和系统同步时机影响。
+
+## 相关
+
+- [NSUserDefaults](/reference/foundation/ns-user-defaults/)

package/src/content/docs/reference/foundation/ns-url-connection.md

@@ -5,7 +5,7 @@ description: 插件环境中唯一导出的网络请求类（deprecated，但可
 
 完整用法见 [网络请求](/guides/network-requests/) 教程。
 
-`NSURLConnection` 是插件环境中导出的网络请求类（头文件标注为 deprecated，但在当前接口里仍可用）。它通常与 `NSURLRequest`/`NSMutableURLRequest`、`NSOperationQueue`、`NSData`、`NSError`、`NSHTTPURLResponse` 配合使用。
+`NSURLConnection` 是插件环境中导出的网络请求类（头文件标注为 deprecated，但在当前接口里仍可用）。它默认与 `NSURLRequest`/`NSMutableURLRequest`、`NSOperationQueue`、`NSData`、`NSError`、`NSHTTPURLResponse` 配合使用。
 
 ## 类成员 (Class members)
 
@@ -102,7 +102,7 @@ originalRequest(): NSURLRequest
 
 ### `currentRequest`
 
-当前请求（可能经重定向等变更）。
+当前请求（会经重定向等变更）。
 
 ```javascript
 currentRequest(): NSURLRequest

package/src/content/docs/reference/foundation/ns-url-request.md

@@ -3,7 +3,7 @@ title: NSURLRequest
 description: 不可变 URL 请求对象，包含 URL、缓存策略、HTTP header/body 等只读访问。
 ---
 
-`NSURLRequest` 表示一个不可变的 URL 请求。通常在插件里用于读取请求信息，或作为 `NSMutableURLRequest` 的父接口使用。
+`NSURLRequest` 表示一个不可变的 URL 请求。默认在插件里用于读取请求信息，或作为 `NSMutableURLRequest` 的父接口使用。
 
 ## 类成员 (Class members)
 
@@ -221,4 +221,4 @@ HTTPShouldUsePipelining(): boolean
 
 - `boolean`: 是否使用。
 
-> 建议：需要设置 method/header/body 等可变字段时，直接使用 [NSMutableURLRequest](/reference/foundation/ns-mutable-url-request/)。
+> 要求：需要设置 method/header/body 等可变字段时，直接使用 [NSMutableURLRequest](/reference/foundation/ns-mutable-url-request/)。

package/src/content/docs/reference/foundation/ns-url-response.md

@@ -1,9 +1,9 @@
 ---
 title: NSURLResponse
-description: URL 响应对象，包含 MIMEType、编码、建议文件名等元信息。
+description: URL 响应对象，包含 MIMEType、编码、期望文件名等元信息。
 ---
 
-`NSURLResponse` 是 URL 请求的响应对象基类。HTTP 响应通常会是其子类 `NSHTTPURLResponse`。
+`NSURLResponse` 是 URL 请求的响应对象基类。HTTP 响应默认会是其子类 `NSHTTPURLResponse`。
 
 ## 实例成员 (Instance members)
 
@@ -78,7 +78,7 @@ textEncodingName(): string
 
 ### `suggestedFilename`
 
-建议保存文件名。
+保存文件名。
 
 ```javascript
 suggestedFilename(): string
@@ -86,11 +86,11 @@ suggestedFilename(): string
 
 **Return Value:**
 
-- `string`: 建议文件名。
+- `string`: 期望文件名。
 
 ## 类成员 (Class members)
 
-当前运行时未额外暴露 `NSURLResponse` 的类成员。
+当前接口未额外暴露 `NSURLResponse` 的类成员。
 
 ## 相关
 

package/src/content/docs/reference/foundation/ns-url.md

@@ -18,7 +18,7 @@ description: URL 对象，用于网页、文件路径与 Application.openURL。
 
 ## 实例成员 (Instance members)
 
-### 属性（常用）
+### 属性
 
 | 属性 | 类型 | 说明 |
 |------|------|------|

package/src/content/docs/reference/foundation/ns-user-defaults.md

@@ -25,7 +25,7 @@ static standardUserDefaults(): NSUserDefaults
 
 ### `setObjectForKey`
 
-存储任意对象（通常为字符串、数字、数组、字典等可序列化类型）。
+存储任意对象（为字符串、数字、数组、字典等可序列化类型）。
 
 ```javascript
 setObjectForKey(value: any, key: string): void
@@ -203,7 +203,7 @@ integerForKey(key: string): number
 
 **Return Value:**
 
-- `number`: 整数值（若不存在通常返回 0）。
+- `number`: 整数值（若不存在默认返回 0）。
 
 ### `floatForKey`
 
@@ -239,7 +239,7 @@ boolForKey(key: string): boolean
 
 **Return Value:**
 
-- `boolean`: 布尔值（若不存在通常返回 false）。
+- `boolean`: 布尔值（若不存在默认返回 false）。
 
 ### `URLForKey`
 
@@ -281,7 +281,7 @@ synchronize(): boolean
 
 - `boolean`: 是否写入成功。
 
-**Note:** 系统通常会自动保存，仅在需要立即持久化时调用。
+**Note:** 系统默认会自动保存，仅在需要立即持久化时调用。
 
 ### `registerDefaults`
 

package/src/content/docs/reference/foundation/ns-value.md

@@ -1,15 +1,15 @@
 ---
 title: NSValue
-description: 通用值对象封装（CGRect/CGPoint/CGSize/NSRange 等）。
+description: 通用值对象封装（[CGRect](/reference/value-sturct/#cgrect)/[CGPoint](/reference/value-sturct/#cgpoint)/[CGSize](/reference/value-sturct/#cgsize)/[NSRange](/reference/value-sturct/#nsrange)/[CGAffineTransform](/reference/value-sturct/#cgaffinetransform)/[CATransform3D](/reference/value-sturct/#catransform3d)等）。
 ---
 
-`NSValue` 用于封装非对象类型的值（例如 `CGPoint`、`CGRect`、`CGSize`、`NSRange`、`CGAffineTransform`、`CATransform3D` 等），以便在集合中传递或作为返回值使用。
+`NSValue`用于封装非对象类型的值，例如[`CGPoint`](/reference/value-sturct/#cgpoint)、[`CGRect`](/reference/value-sturct/#cgrect)、[`CGSize`](/reference/value-sturct/#cgsize)、[`NSRange`](/reference/value-sturct/#nsrange)、[`CGAffineTransform`](/reference/value-sturct/#cgaffinetransform)、[`CATransform3D`](/reference/value-sturct/#catransform3d)等，以便在集合中传递或作为返回值使用。
 
 ## 类成员 (Class members)
 
 ### `valueWithCGPoint`
 
-从 CGPoint 创建。
+从[CGPoint](/reference/value-sturct/#cgpoint)创建。
 
 ```javascript
 static valueWithCGPoint(point: any): NSValue
@@ -27,7 +27,7 @@ static valueWithCGPoint(point: any): NSValue
 
 ### `valueWithCGSize`
 
-从 CGSize 创建。
+从[CGSize](/reference/value-sturct/#cgsize)创建。
 
 ```javascript
 static valueWithCGSize(size: any): NSValue
@@ -45,7 +45,7 @@ static valueWithCGSize(size: any): NSValue
 
 ### `valueWithCGRect`
 
-从 CGRect 创建。
+从[CGRect](/reference/value-sturct/#cgrect)创建。
 
 ```javascript
 static valueWithCGRect(rect: any): NSValue
@@ -63,7 +63,7 @@ static valueWithCGRect(rect: any): NSValue
 
 ### `valueWithCGAffineTransform`
 
-从 CGAffineTransform 创建。
+从[CGAffineTransform](/reference/value-sturct/#cgaffinetransform)创建。
 
 ```javascript
 static valueWithCGAffineTransform(transform: any): NSValue
@@ -81,7 +81,7 @@ static valueWithCGAffineTransform(transform: any): NSValue
 
 ### `valueWithRange`
 
-从 NSRange 创建。
+从[NSRange](/reference/value-sturct/#nsrange)创建。
 
 ```javascript
 static valueWithRange(range: any): NSValue
@@ -99,7 +99,7 @@ static valueWithRange(range: any): NSValue
 
 ### `valueWithCATransform3D`
 
-从 CATransform3D 创建（若环境中提供）。
+从[CATransform3D](/reference/value-sturct/#catransform3d)创建。
 
 ```javascript
 static valueWithCATransform3D(transform3d: any): NSValue
@@ -119,7 +119,7 @@ static valueWithCATransform3D(transform3d: any): NSValue
 
 ### `CGPointValue`
 
-取 CGPoint 值。
+取[CGPoint](/reference/value-sturct/#cgpoint)值。
 
 ```javascript
 CGPointValue(): any
@@ -131,7 +131,7 @@ CGPointValue(): any
 
 ### `CGSizeValue`
 
-取 CGSize 值。
+取[CGSize](/reference/value-sturct/#cgsize)值。
 
 ```javascript
 CGSizeValue(): any
@@ -143,7 +143,7 @@ CGSizeValue(): any
 
 ### `CGRectValue`
 
-取 CGRect 值。
+取[CGRect](/reference/value-sturct/#cgrect)值。
 
 ```javascript
 CGRectValue(): any
@@ -155,7 +155,7 @@ CGRectValue(): any
 
 ### `CGAffineTransformValue`
 
-取 CGAffineTransform 值。
+取[CGAffineTransform](/reference/value-sturct/#cgaffinetransform)值。
 
 ```javascript
 CGAffineTransformValue(): any
@@ -167,7 +167,7 @@ CGAffineTransformValue(): any
 
 ### `rangeValue`
 
-取 NSRange 值。
+取[NSRange](/reference/value-sturct/#nsrange)值。
 
 ```javascript
 rangeValue(): any
@@ -179,7 +179,7 @@ rangeValue(): any
 
 ### `CATransform3DValue`
 
-取 CATransform3D 值。
+取[CATransform3D](/reference/value-sturct/#catransform3d)值。
 
 ```javascript
 CATransform3DValue(): any
@@ -191,4 +191,4 @@ CATransform3DValue(): any
 
 ## 相关
 
-- `CGPoint` / `CGRect` / `CGSize` / `NSRange`（作为值类型）
+- [`CGPoint`](/reference/value-sturct/#cgpoint) / [`CGRect`](/reference/value-sturct/#cgrect) / [`CGSize`](/reference/value-sturct/#cgsize) / [`NSRange`](/reference/value-sturct/#nsrange) / [`CGAffineTransform`](/reference/value-sturct/#cgaffinetransform) / [`CATransform3D`](/reference/value-sturct/#catransform3d)作为值类型

package/src/content/docs/reference/global/agent-tools.md

@@ -0,0 +1,91 @@
+---
+title: AgentTools
+description: 全局工具对象。用于注册、获取、列举与执行工具。
+---
+
+**[Deprecated]** `AgentTools`是全局对象，不是原生类。用于注册工具并统一调用。
+
+已被弃用，不建议使用。
+
+## 实例成员 (Instance members)
+
+`AgentTools`是全局对象，默认不以实例化方式使用。
+
+## 类成员 (Class members)
+
+### 方法
+
+### `register`
+
+注册工具对象。
+
+```javascript
+register(tool: object): void
+```
+
+<details>
+<summary>目前内置的mn.search工具的注册源代码</summary>
+
+```javascript
+register({
+      name: 'mn.search',
+      info: {name:'mn.search', kind:'search', scopes:['topic','all','page'], description:'Search notes or pages via SearchManager'},
+      run: function(input){
+        input = input || {};
+        var app2 = null;
+        try { app2 = Application.sharedInstance(); } catch (e2) {}
+        var mgr2 = app2 && app2.searchManager ? app2.searchManager : null;
+        if (!mgr2) { throw new Error('search_manager_unavailable'); }
+        var q = normalizeString(input.query, '');
+        var scope = normalizeString(input.scope, 'topic').toLowerCase();
+        if (scope !== 'topic' && scope !== 'all' && scope !== 'page') { scope = 'topic'; }
+        var titleOnly = !!input.titleOnly;
+        var beginsWith = !!input.beginsWith;
+        var limit = (input.limit != null) ? input.limit : 50;
+        var noteOnly = (input.noteOnly != null) ? !!input.noteOnly : false;
+        var topicid = normalizeNullable(input.topicid);
+        if (scope === 'page') {
+          return mgr2.searchPage(q, beginsWith, limit);
+        }
+        if (input.useFts) {
+          return mgr2.searchFts3Text(q, titleOnly, topicid, limit, noteOnly);
+        }
+        return mgr2.searchText(q, titleOnly, topicid, beginsWith, limit);
+      }
+});
+```
+</details>
+
+### `get`
+
+按名称获取工具。
+
+```javascript
+get(name: string): object | null
+```
+
+### `list`
+
+列出已注册工具。
+
+```javascript
+list(): object[]
+```
+
+### `run`
+
+执行指定工具。
+
+```javascript
+run(name: string, input: any): Promise<any>
+```
+
+## 使用规范
+
+- `register`时缺少名称会被忽略，同名注册会覆盖。
+- `run`找不到工具时会抛错；工具对象没有`run`实现时常见返回`null`。
+- 目前会内建工具`mn.search`，执行前可先`list/get`检查。
+
+## 相关
+
+- [SearchManager](/reference/global/search-manager/)

package/src/content/docs/reference/global/application.md

@@ -58,7 +58,7 @@ studyController(window: UIWindow): StudyController
 
 | Name | Type | Description |
 | :--- | :--- | :--- |
-| `window` | `UIWindow` | 目标窗口（通常传 `self.window`）。 |
+| `window` | `UIWindow` | 目标窗口（默认传 `self.window`）。 |
 
 **Return Value:**
 
@@ -163,7 +163,7 @@ queryCommandWithKeyFlagsInWindow(command: string, keyFlags: any, window: UIWindo
 
 该接口用于查询某个内建command在“当前窗口+修饰键(keyFlags)”上下文里是否可用，以及是否处于勾选态。你可以用它来：
 
-- 判断某个command当前是否能执行（例如编辑态/无焦点时可能禁用）。
+- 判断某个command当前是否能执行（例如编辑态/无焦点时会禁用）。
 - 在调用`processCommandWithKeyFlagsInWindow(...)`之前做保护性判断。
 
 已确认返回值至少包含：
@@ -193,7 +193,7 @@ processCommandWithKeyFlagsInWindow(command: string, keyFlags: any, window: UIWin
 
 这里的command同样是MarginNote内建命令的字符串标识（可理解为某个菜单动作/操作的ID）。只要command字符串是系统可识别的命令标识，就可以直接调用执行（例如已确认`ZoomToFit`可执行）。
 
-可用的command列表没有单一集中枚举，建议参考内建command清单页，并在运行时用`queryCommandWithKeyFlagsInWindow`确认`disabled:false`后再执行：
+可用的command列表没有单一集中枚举，参考内建command清单页，并用`queryCommandWithKeyFlagsInWindow`确认`disabled:false`后再执行：
 
 - [内建command清单](/reference/global/builtin-commands/)
 
@@ -288,7 +288,7 @@ unregsiterHtmlCommentEditor(commentTag: string): void
 
 ### `importDocument`
 
-导入文档（由运行时实现决定入库位置与返回值含义）。
+导入文档，使得在MN可访问到的范围内的文档在文档库中可见。
 
 ```javascript
 importDocument(fileUrl: string): string

package/src/content/docs/reference/global/builtin-commands.md

@@ -3,12 +3,12 @@ title: 内建command清单
 description: MarginNote内建command字符串速查表（用于query/processCommand调用）。
 ---
 
-本页汇总一些常见内建command字符串。它们通常用于：
+本页汇总一些常见内建command字符串。它们默认用于：
 
 - `Application.queryCommandWithKeyFlagsInWindow(command,keyFlags,window)`查询可用性与checked状态。
 - `Application.processCommandWithKeyFlagsInWindow(command,keyFlags,window)`执行内建命令。
 
-注意：该清单可能随版本变化；当某个command在运行时表现为`disabled:true`，可能是当前上下文不可用，也可能是版本差异导致不存在。
+注意：该清单会随版本变化；当某个command表现为`disabled:true`，是当前上下文不可用，也是版本差异导致不存在。
 
 ## Root（全局分发）
 

package/src/content/docs/reference/global/database.md

@@ -3,7 +3,7 @@ title: Database
 description: MarginNote 核心数据库访问对象（MbModelTool），用于获取/修改笔记、笔记本与文档。
 ---
 
-`Database` 即底层类型 `MbModelTool` 的单例，用于访问 MarginNote 的笔记与文档数据。通过 `Database.sharedInstance()` 获取。修改数据后建议使用 [UndoManager](/reference/utility/undo-manager/) 的 `undoGrouping(title, topicid, fn)` 包裹，并调用 `Application.sharedInstance().refreshAfterDBChanged(topicid)` 刷新界面。
+`Database` 即底层类型 `MbModelTool` 的单例，用于访问 MarginNote 的笔记与文档数据。通过 `Database.sharedInstance()` 获取。修改数据后使用 [UndoManager](/reference/utility/undo-manager/) 的 `undoGrouping(title, topicid, fn)` 包裹，并调用 `Application.sharedInstance().refreshAfterDBChanged(topicid)` 刷新界面。
 
 ## 类成员 (Class members)
 
@@ -176,7 +176,7 @@ allDocuments(): NSArray
 
 ### `savedb`
 
-手动保存数据库到磁盘。慎用，通常由系统自动管理。
+手动保存数据库到磁盘。慎用，默认由系统自动管理。
 
 ```javascript
 savedb(): void
@@ -371,7 +371,7 @@ getSketchNotesForMindMap(topicid: string): NSArray
 
 ### `transDictionaryToJSCompatible` / `transArrayToJSCompatible`
 
-将原生容器转换为更易于 JS 使用的结构（行为以运行时实现为准）。
+将原生容器转换为更易于 JS 使用的结构。
 
 ```javascript
 static transDictionaryToJSCompatible(dic: NSDictionary): NSDictionary
@@ -387,7 +387,7 @@ static transArrayToJSCompatible(arr: NSArray): NSArray
 
 **Return Value:**
 
-- `any`: 导入结果（通常为导入的笔记本对象或状态）。
+- `any`: 导入结果（为导入的笔记本对象或状态）。
 
 ## 相关
 

package/src/content/docs/reference/global/document.md

@@ -0,0 +1,21 @@
+---
+title: Document
+description: 全局别名对象。语义上等同于MbBook。
+---
+
+`Document`是插件环境的全局导出别名，语义上等同于[MbBook](/reference/marginnote/mb-book/)。
+
+## 关系说明
+
+- `Document`与`MbBook`是同一文档对象在全局入口层的别名语义，不是两套模型。
+- 主键语义为`docMd5`。
+- 对象生命周期由宿主数据层管理，不把投影字段当强一致缓存长期持有。
+
+## 用法
+
+完整属性与方法请直接参考[MbBook](/reference/marginnote/mb-book/)。
+
+## 相关
+
+- [MbBook](/reference/marginnote/mb-book/)
+- [Database](/reference/global/database/)

package/src/content/docs/reference/global/global-variables.md

@@ -1,8 +1,8 @@
 ---
 title: 全局入口对象（Global Variables）
-description: MarginNote插件运行时直接注入到JS环境的全局变量清单与用法入口。
+description: MarginNote插件环境直接注入到JS环境的全局变量清单与用法入口。
 ---
-本页列出MarginNote插件运行时可直接使用的全局变量名。这些全局名对应的对象通常是单例、工厂对象、或系统级入口。
+本页列出MarginNote插件环境可直接使用的全局变量名。这些全局名对应的对象默认是单例、工厂对象、或系统级入口。
 
 > 说明：本页仅做索引。每个对象的完整属性/方法请进入对应参考页。
 
@@ -42,6 +42,16 @@ description: MarginNote插件运行时直接注入到JS环境的全局变量清
       <td>数据库访问</td>
       <td><a href="/reference/global/database/">Database</a></td>
     </tr>
+    <tr>
+      <td><code>Document</code></td>
+      <td>文档入口别名（等同MbBook）</td>
+      <td><a href="/reference/global/document/">Document</a></td>
+    </tr>
+    <tr>
+      <td><code>Notebook</code></td>
+      <td>笔记本入口别名（等同MbTopic）</td>
+      <td><a href="/reference/global/notebook/">Notebook</a></td>
+    </tr>
     <tr>
       <td><code>Note</code></td>
       <td>创建笔记</td>
@@ -59,9 +69,14 @@ description: MarginNote插件运行时直接注入到JS环境的全局变量清
     </tr>
     <tr>
       <td><code>SearchManager</code></td>
-      <td>搜索与索引（<code>Application.sharedInstance().searchManager</code>）</td>
+      <td>搜索与索引</td>
       <td><a href="/reference/global/search-manager/">SearchManager</a></td>
     </tr>
+    <tr>
+      <td><code>AgentTools</code></td>
+      <td>工具注册与执行</td>
+      <td><a href="/reference/global/agent-tools/">AgentTools</a></td>
+    </tr>
   </tbody>
 </table>
 
@@ -207,15 +222,16 @@ description: MarginNote插件运行时直接注入到JS环境的全局变量清
 
 ## 其它对象
 
-本页不再列出Foundation/UIKit/QuartzCore与JavaScript原生环境的全量对象清单；它们的参考条目请在侧边栏对应分组中查阅。下面仅给出常见入口与例子。
+MarginNote插件环境还可用绝大部分的Foundation/UIKit/QuartzCore与JavaScript原生环境，它们的参考条目请在侧边栏对应分组中查阅，下面仅给出常见入口与例子。
 
 ### Foundation
 
-多数Foundation类可直接使用（通常以类/单例形式导出）。例：
+多数Foundation类可直接使用（默认以类/单例形式导出）。例：
 
 - [NSFileManager](/reference/foundation/ns-file-manager/)
 - [NSData](/reference/foundation/ns-data/)
 - [NSTimer](/reference/foundation/ns-timer/)
+- [NSUbiquitousKeyValueStore](/reference/foundation/ns-ubiquitous-key-value-store/)
 
 ### UIKit
 
@@ -232,6 +248,7 @@ description: MarginNote插件运行时直接注入到JS环境的全局变量清
 - [CALayer](/reference/quartzcore/calayer/)
 - [CAShapeLayer](/reference/quartzcore/cashape-layer/)
 - [CATransaction](/reference/quartzcore/catransaction/)
+- [CAEmitterLayer](/reference/quartzcore/caemitter-layer/)
 
 ### JavaScript原生环境
 

package/src/content/docs/reference/global/jsb.md

@@ -1,12 +1,12 @@
 ---
 title: JSB
-description: JavaScript 桥接核心，连接插件 JS 与运行时对象的入口对象。
+description: JavaScript 桥接核心，连接插件 JS 与宿主对象的入口对象。
 ---
-JSB（JavaScript Bridge）是插件运行时的桥接核心对象：类定义、插件入口、日志与包内脚本加载都通过它完成。
+JSB（JavaScript Bridge）是插件环境的桥接核心对象：类定义、插件入口、日志与包内脚本加载都通过它完成。
 
 ## 实例成员 (Instance members)
 
-`JSB` 是全局对象，通常不以“实例化”的方式使用。
+`JSB` 是全局对象，默认不以“实例化”的方式使用。
 
 ## 类成员 (Class members)
 
@@ -14,7 +14,9 @@ JSB（JavaScript Bridge）是插件运行时的桥接核心对象：类定义、
 
 ### `defineClass`
 
-定义一个可被运行时识别并回调的类，**所有插件的入口**。
+定义一个可被插件环境识别并回调的类，只在插件入口处使用。
+
+注意：该方法定义的类非js的类，this并不会指向该类的实例，而应使用[self](/reference/global/self/) 替代
 
 ```javascript
 defineClass(declaration: string, instanceMembers: object, classMembers?: object): any

package/src/content/docs/reference/global/note.md

@@ -3,13 +3,13 @@ title: Note
 description: 全局注入的笔记工厂对象，用于创建新笔记（MbBookNote）。
 ---
 
-`Note` 是 MarginNote 运行时注入到 JavaScript 环境中的**全局对象**之一，用于创建新笔记。
+`Note` 是 MarginNote 宿主注入到 JavaScript 环境中的**全局对象**之一，用于创建新笔记。
 
 需要特别注意：创建笔记的方法**不在** `MbBookNote` 类上，而是在全局 `Note` 对象上（这是由 MarginNote 的 JSExport 导出方式决定的）。
 
 ## 实例成员 (Instance members)
 
-`Note` 是全局对象，通常不以实例形式使用。
+`Note` 是全局对象，默认不以实例形式使用。
 
 ## 类成员 (Class members)