utils 模块 — 31 个工具子目录分类
路径:
src/utils/子目录数: 31 个 根级文件数: 280+ 总文件数: 500+
子目录清单（按功能分类）
Shell 与进程
| 目录 | 说明 |
|---|---|
shell/ | Shell 提供者（bash/zsh/fish/powershell 多 Shell 支持） |
bash/ | Bash 特定工具（命令解析、安全检查） |
powershell/ | PowerShell 特定工具 |
Git 与版本控制
| 目录 | 说明 |
|---|---|
git/ | Git 核心操作（status/branch/commit/diff/worktree/blame） |
github/ | GitHub API 集成（PR/Issue/App 安装） |
认证与安全
| 目录 | 说明 |
|---|---|
teleport/ | Teleport API 集成（OAuth API 调用） |
secureStorage/ | 安全存储（令牌加密存储） |
permissions/ | 权限规则引擎 |
文件与持久化
| 目录 | 说明 |
|---|---|
filePersistence/ | 文件持久化（原子写入、锁文件） |
消息与对话
| 目录 | 说明 |
|---|---|
messages/ | 消息构建、格式化、搜索、压缩辅助 |
processUserInput/ | 用户输入处理（解析、验证） |
AI 与 Agent
| 目录 | 说明 |
|---|---|
swarm/ | Swarm 模式（多 Agent 协作） |
memory/ | 记忆工具（记忆文件读写） |
suggestions/ | 提示建议生成 |
ultraplan/ | Ultraplan 工具（超级计划模式） |
配置与设置
| 目录 | 说明 |
|---|---|
settings/ | 设置读写（三层合并：user/project/local） |
hooks/ | 钩子执行引擎和运行器 |
skills/ | 技能工具（加载、解析） |
plugins/ | 插件工具（加载、验证） |
MCP 与工具
| 目录 | 说明 |
|---|---|
mcp/ | MCP 工具（客户端辅助、消息转换） |
todo/ | 待办列表工具 |
task/ | 任务管理工具 |
网络与通信
| 目录 | 说明 |
|---|---|
background/ | 后台任务（含 remote/ 子目录） |
deepLink/ | 深度链接处理 |
遥测与分析
| 目录 | 说明 |
|---|---|
telemetry/ | 遥测工具（OpenTelemetry 辅助） |
模型与 AI
| 目录 | 说明 |
|---|---|
model/ | 模型工具（别名解析、能力查询） |
安装与更新
| 目录 | 说明 |
|---|---|
nativeInstaller/ | 原生安装器（桌面应用安装） |
dxt/ | DXT 工具（桌面扩展） |
特殊功能
| 目录 | 说明 |
|---|---|
sandbox/ | 沙箱工具（环境隔离） |
computerUse/ | 计算机使用工具（屏幕操作） |
claudeInChrome/ | Chrome 中的 Claude 工具 |
根级核心文件（精选）
| 文件 | 说明 |
|---|---|
Shell.ts | Shell 抽象层（exec/execStream/which） |
ShellCommand.ts | Shell 命令封装 |
auth.ts | 认证核心 |
config.ts | 配置管理 |
envUtils.ts | 环境变量工具（isEnvTruthy 等） |
debug.ts | 调试日志 |
format.ts | 通用格式化 |
lazySchema.ts | 懒加载 Schema（打破循环依赖） |
memoize.ts | 缓存/记忆化 |
retry.ts | 重试逻辑 |
frontmatterParser.ts | Frontmatter 解析 |
sessionStorage.ts | 会话持久化 |
sessionRestore.ts | 会话恢复 |
fileRead.ts | 文件读取（多格式） |
fileHistory.ts | 文件历史追踪 |
tokenBudget.ts | Token 预算管理 |
proxy.ts | 代理配置 |
mtls.ts | mTLS 配置 |
cleanupRegistry.ts | 清理注册表（进程退出时资源释放） |
agentContext.ts | Agent 上下文 |
teammate.ts | 队友管理 |
sideQuery.ts | 侧查询（轻量级 LLM 调用） |