(\n (self, data) => ({\n Method: 'POST',\n Url: new URL('https://api.example.com/endpoint'),\n Body: data,\n HeaderFn: self.DefaultHeaders\n })\n)\n\n// 调用 API\nconst response = await myApi.request({\n ltuid: 'xxx',\n cookie: 'xxx',\n type: MysAccountType.cn,\n // 其他请求参数...\n})\n```\n\n**内置 API**\n\n```typescript\nimport {\n fetchQRcode, // 获取二维码\n queryQRcode, // 查询二维码状态\n getTokenByGameToken, // 通过游戏 Token 获取 Token\n getCookieTokenBySToken, // 通过 SToken 获取 CookieToken\n getUserGameRolesByCookie // 获取用户游戏角色\n} from 'karin-plugin-mys-core/mys'\n```\n\n#### 配置常量\n\n```typescript\n// 米游社应用配置\nMysApp.version // { cn: '2.70.1', os: '1.5.0' }\nMysApp.appId // 游戏 ID\nMysApp.salt // 签名盐值\n\n// 米游社主机地址\nMysHosts.bbs // 社区 API\nMysHosts.web // Web API\nMysHosts.record // 记录 API\nMysHosts.hk4e // 原神 API\n// 更多主机地址...\n```\n\n---\n\n### 渲染模块 (render)\n\n渲染模块提供了基于 React 的模板渲染功能，可以将 React 组件渲染为图片。\n\n#### 导入方式\n\n```typescript\nimport { ReactRender, React } from 'karin-plugin-mys-core/render'\n// 或者单独导入\nimport React from 'karin-plugin-mys-core/render'\n```\n\n#### ReactRender 类\n\n用于将 React 组件渲染为图片的核心类。\n\n**类型定义**\n\n```typescript\ninterface RenderCfg {\n /** 插件名称 package.json 的 name */\n name: string\n /** 插件版本 package.json 的 version */\n version: string\n /** 根目录绝对路径 */\n pluginDir: string\n /** 插件资源目录 @karinjs/karin-plugin-xxx/resources */\n ResourcesDir: string\n}\n\nclass ReactRender, K extends string>\n```\n\n**构造函数**\n\n```typescript\nconst render = new ReactRender(\n {\n name: 'karin-plugin-example',\n version: '1.0.0',\n pluginDir: '/path/to/plugin',\n ResourcesDir: '/path/to/@karinjs/karin-plugin-example/resources'\n },\n {\n // 自定义插件参数（可选）\n customOption: 'value'\n }\n)\n```\n\n**主要属性**\n\n```typescript\n// 获取插件信息\nrender.plugin\n// 返回:\n// {\n// name: string // 插件名称\n// version: string // 插件版本\n// resources: {\n// default: string // 插件内部资源路径（绝对路径）\n// download: string // 插件外部资源路径（@karinjs 目录，绝对路径）\n// }\n// ...customOptions // 自定义选项\n// }\n```\n\n**template 方法**\n\n将 React 组件渲染为图片。\n\n```typescript\nasync template>(\n template: K, // 模板名称\n component: C, // React 组件\n props: React.ComponentProps, // 组件 props\n options?: {\n type?: 'png' | 'jpeg' | 'webp' // 图片格式，默认 'jpeg'\n plugin?: Record // 额外插件参数（当前未使用）\n render?: { // 渲染选项\n name?: string // 文件名（不含后缀），默认使用模板名+随机字符串\n setViewport?: {\n deviceScaleFactor?: number // 设备缩放比例，默认 3\n }\n // 更多 karin.render 选项...\n }\n }\n): Promise\n```\n\n**返回值**\n\n- 成功：返回 `'base64://...'` 格式的 base64 图片字符串\n- 失败：返回 `null`\n\n**渲染流程**\n\n1. 将 React 组件渲染为 HTML 字符串\n2. 生成完整的 HTML 文档，自动引入 CSS 文件\n3. 保存 HTML 到临时目录\n4. 使用 Puppeteer 将 HTML 渲染为图片\n5. 返回 base64 格式的图片数据\n\n**CSS 文件要求**\n\nCSS 文件应放置在 `resources/styles/{插件名}.css` 路径下，会自动被引入到渲染的 HTML 中。\n\n**完整示例**\n\n```typescript\nimport { ReactRender, React } from 'karin-plugin-mys-core/render'\nimport path from 'path'\n\n// 定义模板名称类型\ntype Templates = 'userCard' | 'stats'\n\n// 定义自定义插件选项（可选）\ninterface PluginOptions {\n theme: string\n}\n\n// 创建渲染器实例\nconst render = new ReactRender(\n {\n name: 'karin-plugin-example',\n version: '1.0.0',\n pluginDir: path.resolve(__dirname, '..'),\n ResourcesDir: path.resolve(__dirname, '../resources')\n },\n {\n theme: 'light' // 自定义选项\n }\n)\n\n// 定义组件的 Props 类型\ninterface UserCardProps {\n username: string\n level: number\n avatar: string\n}\n\n// 创建 React 组件\nconst UserCard: React.FC = ({ username, level, avatar }) => {\n // 访问插件信息\n const plugin = render.plugin\n \n return (\n \n
\n
{username}
\n
等级: {level}
\n
主题: {plugin.theme}
\n {/* 使用插件资源 */}\n
\n
\n
{nickname}
\n
UID: {uid}
\n
等级: {level}
\n
\n
标题
\n {data.map((item, idx) => (\n
\n {item.name}\n
\n ))}\n