用途:sessions 是 cloddsbot 提供的会话管理模块,用于管理跨渠道的对话会话、历史记录、检查点与重置。
主要能力:支持会话控制(新建、重置、查看、列出),检查点保存/列出/恢复/删除,历史记录查看、导出为 markdown、清空但保留会话,以及会话设置。作用域包括主会话、按渠道、按用户;可设置每日重置时间和空闲重置分钟数。TypeScript API 提供 createSessionManager、getOrCreateSession、addMessage、getHistory、clearHistory、reset、saveCheckpoint、listCheckpoints、restoreCheckpoint、deleteCheckpoint、export、cleanup、getContextHistory 等方法。支持存储为 sqlite 并指定 dbPath,可启用 encryptTranscripts 并配合 encryptionKey 加密对话记录。
使用方式:可通过聊天命令操作,如 /new、/reset、/session、/session list、/checkpoint save "before refactor"、/checkpoint list、/checkpoint restore <id>、/checkpoint delete <id>、/history、/history export、/history clear、/session scope main|channel|peer、/session reset-time 00:00、/session idle-reset 30。也可在代码中 import { createSessionManager } from 'clodds/sessions'; 后创建管理器并调用各方法。
适用场景:多用户共享渠道、个人使用、需要完整隔离的按用户按渠道会话;需要保存状态后实验或回滚;需要导出或备份重要对话;需要控制上下文窗口以适配 LLM 的场景。
限制:资料未提供收费标准、性能指标或除 sqlite 外的存储支持等信息;加密依赖 process.env.SESSION_KEY 等主密钥配置;具体运行环境与依赖未提供。