# Xrk Runtime Util

> Xrk Runtime Util

- Skill: `sunflowermm/xrk-runtime-util` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sunflowermm/xrk-runtime-util`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sunflowermm/xrk-runtime-util/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sunflowermm (https://skillmd.com/u/sunflowermm)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sunflowermm/xrk-runtime-util

---


## 文档与代码

`docs/runtime-util.md`、`src/utils/runtime-util.js`

## 要点

- 日志 `makeLog`、缓存 `getMap`（`Map.getOrInsertComputed`）/`cache`、文件与网络封装；优先用 RuntimeUtil 而非裸 `fs`/`fetch`。
- `RuntimeUtil.Buffer` / 网络下载：内部已用全局 `fetch` + `AbortSignal.timeout`。
- 二进制：`toBase64()` / `Uint8Array.fromBase64()`，勿 `toString('base64')`。
- `AgentRuntime.*` 代理部分静态方法（`AgentRuntime.makeLog`、`AgentRuntime.exec` 等）。
- 用户桌面路径：`src/utils/user-dirs.js`（勿写死 `~/Desktop`）。
- Shell：`#utils/exec-async.js`，勿在业务里 `promisify(exec)`。

## Node 26

详见 skill **`xrk-node-runtime`**。