feat: add docs website

website/zh-CN/api/cordis/fiber.md

@@ -0,0 +1,108 @@
+# Fiber
+
+Fiber（作用域）是插件实例的运行时容器，管理其生命周期和效果。
+
+## 状态机
+
+```
+PENDING → LOADING → ACTIVE → UNLOADING → DISPOSED
+                 ↘ FAILED
+```
+
+| 状态 | 数值 | 含义 |
+|------|------|------|
+| PENDING | 0 | 依赖未就绪，等待中 |
+| LOADING | 1 | 正在执行 `apply` |
+| ACTIVE | 2 | 运行中 |
+| FAILED | 3 | `apply` 抛出异常 |
+| UNLOADING | 4 | 正在撤销效果 |
+| DISPOSED | 5 | 已完全卸载 |
+
+## 实例属性
+
+### fiber.uid
+
+- **类型:** `number`
+
+Fiber 的唯一标识符。
+
+### fiber.status
+
+- **类型:** `number`
+
+当前状态（见状态机）。
+
+### fiber.config
+
+- **类型:** `object`
+
+传递给插件的配置对象。
+
+### fiber.error
+
+- **类型:** `Error | undefined`
+
+如果状态是 FAILED，包含导致失败的异常。
+
+## 实例方法
+
+### fiber.effect(callback) {#fiber-effect}
+
+- **callback:** `() => (() => void) | void`
+- **返回值:** `() => void`
+
+注册一个效果。`callback` 在 Fiber 激活时执行；如果返回函数，该函数在 Fiber dispose 时执行。
+
+```typescript
+ctx.effect(() => {
+  const timer = setInterval(tick, 1000)
+  return () => clearInterval(timer)
+})
+```
+
+等价地可以通过 `ctx.effect()` 调用（ctx 代理到当前 fiber）。
+
+### fiber.dispose()
+
+- **返回值:** `Promise<void>`
+
+手动 dispose 该 Fiber。按注册逆序撤销所有效果，递归 dispose 所有子 Fiber。
+
+```typescript
+const child = ctx.plugin(somePlugin)
+// 之后:
+await child.dispose()
+```
+
+### fiber.update(config)
+
+- **config:** `object` 新配置
+- **返回值:** `void`
+
+热更新配置。如果新旧配置不同，触发 dispose + 重新 apply。
+
+### fiber.restart()
+
+- **返回值:** `void`
+
+强制重启：dispose 后重新加载。
+
+### fiber.then(resolve, reject?)
+
+- **返回值:** `Promise<void>`
+
+使 Fiber 可以被 `await`：等到状态进入 ACTIVE 或 FAILED。
+
+```typescript
+const fiber = ctx.plugin(myPlugin)
+await fiber  // 等待插件加载完成
+```
+
+## 访问当前 Fiber
+
+```typescript
+export function apply(ctx: Context) {
+  const fiber = ctx.fiber  // 当前插件的 Fiber
+  console.log(fiber.status)  // 1 (LOADING, 因为正在 apply 中)
+}
+```