xrk-botutil
Installation
SKILL.md
权威文档与入口
- 文档:
docs/botutil.md - 代码:
src/utils/botutil.js
你要掌握的要点
- BotUtil 是“基础设施工具箱”:日志(makeLog/makeLogID)、缓存(getMap/cache)、文件(readFile/writeFile/fileToUrl)、命令/异步控制(exec/promiseEvent/sleep)、时间/大小格式化等。
- 推荐优先使用 BotUtil 封装的方法,而不是在业务代码里直接乱写 fs/fetch/child_process,保证行为统一、可观测。
- Bot 通过代理透传 BotUtil 静态方法:如
Bot.makeLog、Bot.fileToUrl、Bot.exec、Bot.promiseEvent。 - 用户目录(跨平台桌面默认):
src/utils/user-dirs.js(getDefaultDesktopDirSync/resolveUserDesktopDirAsync),供BaseTools、tools/desktop工作流复用;避免写死~/Desktop。
权威入口
- 项目概览:
PROJECT_OVERVIEW.md - 代码入口:
src/与core/对应子目录 - 相关文档:
docs/下对应主题文档