mn-docs-mcp 0.1.0

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

@@ -0,0 +1,302 @@
+---
+title: NSUserDefaults
+description: 持久化存储少量键值配置，用于插件设置。
+---
+
+用于持久化存储少量用户/插件配置。通过 `NSUserDefaults.standardUserDefaults()` 获取标准实例。适合保存开关、计数、字符串等简单类型。
+
+## 类成员 (Class members)
+
+### `standardUserDefaults`
+
+获取标准用户默认设置实例。
+
+```javascript
+static standardUserDefaults(): NSUserDefaults
+```
+
+**Return Value:**
+
+- `NSUserDefaults`: 单例对象。
+
+## 实例成员 (Instance members)
+
+### 写入
+
+### `setObjectForKey`
+
+存储任意对象（通常为字符串、数字、数组、字典等可序列化类型）。
+
+```javascript
+setObjectForKey(value: any, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `any` | 要存储的值。 |
+| `key` | `string` | 键名。 |
+
+### `setIntegerForKey`
+
+存储整数。
+
+```javascript
+setIntegerForKey(value: number, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `number` | 整数值。 |
+| `key` | `string` | 键名。 |
+
+### `setFloatForKey`
+
+存储浮点数。
+
+```javascript
+setFloatForKey(value: number, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `number` | 浮点数值。 |
+| `key` | `string` | 键名。 |
+
+### `setDoubleForKey`
+
+存储双精度浮点数。
+
+```javascript
+setDoubleForKey(value: number, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `number` | 双精度数值。 |
+| `key` | `string` | 键名。 |
+
+### `setBoolForKey`
+
+存储布尔值。
+
+```javascript
+setBoolForKey(value: boolean, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `boolean` | 布尔值。 |
+| `key` | `string` | 键名。 |
+
+### `setURLForKey`
+
+存储 URL。
+
+```javascript
+setURLForKey(url: NSURL, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | URL 对象。 |
+| `key` | `string` | 键名。 |
+
+### 读取
+
+### `objectForKey`
+
+读取任意对象。
+
+```javascript
+objectForKey(key: string): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `key` | `string` | 键名。 |
+
+**Return Value:**
+
+- `any`: 存储的对象（若不存在则返回 undefined/null）。
+
+### `stringForKey`
+
+读取字符串。
+
+```javascript
+stringForKey(key: string): string | null
+```
+
+**Return Value:**
+
+- `string | null`: 字符串值。
+
+### `arrayForKey`
+
+读取数组。
+
+```javascript
+arrayForKey(key: string): NSArray | null
+```
+
+**Return Value:**
+
+- `NSArray | null`: 数组对象。
+
+### `dictionaryForKey`
+
+读取字典。
+
+```javascript
+dictionaryForKey(key: string): NSDictionary | null
+```
+
+**Return Value:**
+
+- `NSDictionary | null`: 字典对象。
+
+### `dataForKey`
+
+读取二进制数据。
+
+```javascript
+dataForKey(key: string): NSData | null
+```
+
+**Return Value:**
+
+- `NSData | null`: 数据对象。
+
+### `stringArrayForKey`
+
+读取字符串数组。
+
+```javascript
+stringArrayForKey(key: string): string[] | null
+```
+
+**Return Value:**
+
+- `string[] | null`: 字符串数组。
+
+### `integerForKey`
+
+读取整数。
+
+```javascript
+integerForKey(key: string): number
+```
+
+**Return Value:**
+
+- `number`: 整数值（若不存在通常返回 0）。
+
+### `floatForKey`
+
+读取浮点数。
+
+```javascript
+floatForKey(key: string): number
+```
+
+**Return Value:**
+
+- `number`: 浮点数值。
+
+### `doubleForKey`
+
+读取双精度浮点数。
+
+```javascript
+doubleForKey(key: string): number
+```
+
+**Return Value:**
+
+- `number`: 双精度数值。
+
+### `boolForKey`
+
+读取布尔值。
+
+```javascript
+boolForKey(key: string): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 布尔值（若不存在通常返回 false）。
+
+### `URLForKey`
+
+读取 URL。
+
+```javascript
+URLForKey(key: string): NSURL | null
+```
+
+**Return Value:**
+
+- `NSURL | null`: URL 对象。
+
+### 其他
+
+### `removeObjectForKey`
+
+移除指定键的值。
+
+```javascript
+removeObjectForKey(key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `key` | `string` | 键名。 |
+
+### `synchronize`
+
+强制立即写入磁盘。
+
+```javascript
+synchronize(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否写入成功。
+
+**Note:** 系统通常会自动保存，仅在需要立即持久化时调用。
+
+### `registerDefaults`
+
+注册默认值（在未设置值时生效）。
+
+```javascript
+registerDefaults(registrationDictionary: NSDictionary): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `registrationDictionary` | `NSDictionary` | 包含默认键值对的字典。 |
+
+## 相关
+
+- [教程：存储与文件](/guides/storage-and-files/)、[Cookbook：插件设置页](/guides/cookbook/addon-settings/)

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

@@ -0,0 +1,52 @@
+---
+title: NSUUID
+description: UUID 对象（生成与字符串化）。
+---
+
+`NSUUID` 表示一个 UUID。常用于生成唯一标识，或把已有 UUID 字节/字符串传递到系统 API 中。
+
+## 类成员 (Class members)
+
+### `UUID`
+
+生成新的 UUID。
+
+```javascript
+static UUID(): NSUUID
+```
+
+**Return Value:**
+
+- `NSUUID`: 新 UUID 实例。
+
+## 实例成员 (Instance members)
+
+### `UUIDString`
+
+返回形如 `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX` 的字符串。
+
+```javascript
+UUIDString(): string
+```
+
+**Return Value:**
+
+- `string`: UUID 字符串。
+
+### `getUUIDBytes`
+
+取出 16 字节 UUID 数据（高级用法）。
+
+```javascript
+getUUIDBytes(uuid: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `uuid` | `any` | 目标缓冲区（16 字节）。 |
+
+**Return Value:**
+
+- 无。

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

@@ -0,0 +1,194 @@
+---
+title: NSValue
+description: 通用值对象封装（CGRect/CGPoint/CGSize/NSRange 等）。
+---
+
+`NSValue` 用于封装非对象类型的值（例如 `CGPoint`、`CGRect`、`CGSize`、`NSRange`、`CGAffineTransform`、`CATransform3D` 等），以便在集合中传递或作为返回值使用。
+
+## 类成员 (Class members)
+
+### `valueWithCGPoint`
+
+从 CGPoint 创建。
+
+```javascript
+static valueWithCGPoint(point: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `point` | `any` | 点（如 { x, y }）。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+### `valueWithCGSize`
+
+从 CGSize 创建。
+
+```javascript
+static valueWithCGSize(size: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `size` | `any` | 尺寸（如 { width, height }）。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+### `valueWithCGRect`
+
+从 CGRect 创建。
+
+```javascript
+static valueWithCGRect(rect: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `rect` | `any` | 矩形（如 { x, y, width, height }）。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+### `valueWithCGAffineTransform`
+
+从 CGAffineTransform 创建。
+
+```javascript
+static valueWithCGAffineTransform(transform: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `transform` | `any` | 仿射变换。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+### `valueWithRange`
+
+从 NSRange 创建。
+
+```javascript
+static valueWithRange(range: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `range` | `any` | 范围（如 { location, length }）。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+### `valueWithCATransform3D`
+
+从 CATransform3D 创建（若环境中提供）。
+
+```javascript
+static valueWithCATransform3D(transform3d: any): NSValue
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `transform3d` | `any` | 3D 变换。 |
+
+**Return Value:**
+
+- `NSValue`: 新实例。
+
+## 实例成员 (Instance members)
+
+### `CGPointValue`
+
+取 CGPoint 值。
+
+```javascript
+CGPointValue(): any
+```
+
+**Return Value:**
+
+- `any`: 点（如 { x, y }）。
+
+### `CGSizeValue`
+
+取 CGSize 值。
+
+```javascript
+CGSizeValue(): any
+```
+
+**Return Value:**
+
+- `any`: 尺寸（如 { width, height }）。
+
+### `CGRectValue`
+
+取 CGRect 值。
+
+```javascript
+CGRectValue(): any
+```
+
+**Return Value:**
+
+- `any`: 矩形（如 { x, y, width, height }）。
+
+### `CGAffineTransformValue`
+
+取 CGAffineTransform 值。
+
+```javascript
+CGAffineTransformValue(): any
+```
+
+**Return Value:**
+
+- `any`: 仿射变换。
+
+### `rangeValue`
+
+取 NSRange 值。
+
+```javascript
+rangeValue(): any
+```
+
+**Return Value:**
+
+- `any`: 范围（如 { location, length }）。
+
+### `CATransform3DValue`
+
+取 CATransform3D 值。
+
+```javascript
+CATransform3DValue(): any
+```
+
+**Return Value:**
+
+- `any`: 3D 变换。
+
+## 相关
+
+- `CGPoint` / `CGRect` / `CGSize` / `NSRange`（作为值类型）