name: chat-history-manager description: 列出会话、预览并删除最新问答对，自动备份，提示刷新UI。触发：删除对话/聊天/最后、对话管理、会话管理

chat-history-manager

管理 OpenClaw .jsonl 会话历史文件。删除/预览最新一轮问答，自动备份。 跨平台：Windows / macOS / Linux（基于 Node.js，无需 PowerShell）。

脚本一览

<skill-dir> = ~/.qclaw/skills/chat-history-manager

命令速查

列出所有会话

node <skill-dir>/scripts/list-sessions.cjs
node <skill-dir>/scripts/list-sessions.cjs --quiet
node <skill-dir>/scripts/list-sessions.cjs --filter "关键字"

删除最新一轮问答

# 按名称
node <skill-dir>/scripts/delete-last-turn.cjs --label "会话名称" --yes

# 按 UUID 片段（中文标签推荐用此方式）
node <skill-dir>/scripts/delete-last-turn.cjs --label "a1b2c3d4" --yes

# 批量删除（匹配所有含关键字的会话）
node <skill-dir>/scripts/delete-last-turn.cjs --pattern "test" --yes

预览（不删除）

node <skill-dir>/scripts/preview-last-turn.cjs --label "会话名称"
node <skill-dir>/scripts/preview-last-turn.cjs --label "会话名称" --detail

从备份恢复

# 自动列出备份，选索引0（最新的）
node <skill-dir>/scripts/restore-session.cjs --label "会话名称" --backup-index 0 --yes

清理旧备份

# 预览30天前的备份
node <skill-dir>/scripts/cleanup-backups.cjs --days-older-than 30 --dry-run

# 实际删除
node <skill-dir>/scripts/cleanup-backups.cjs --days-older-than 30 --yes

导出会话为 txt

# 导出到当前目录（默认）
node <skill-dir>/scripts/export-txt.cjs --label "会话名称" --yes

# 指定输出路径
node <skill-dir>/scripts/export-txt.cjs --label "会话名称" --out "D:/output/chat.txt" --yes

匹配规则

--label 按评分匹配，分高者优先：

歧义保护：多个候选得分接近时（差距 < 20），脚本报错中止并列出所有候选，需用更精确的名称或 UUID 重试。

中文标签注意：纯中文标签建议先用 list-sessions.cjs --quiet 查到 UUID 片段，再用 UUID 匹配。

安全机制

• 删除前自动创建 .bak.<timestamp> 备份
• 删除后自动校验，失败则回滚
• --yes 跳过确认，无 --yes 则退出
• 删除后需关闭并重新打开 Tab 刷新 UI

输出格式

所有脚本输出精简（1-4 行）：

[OK] 48 -> 45 lines | 116365 -> 108764 B | BOM=false
  backup   : <uuid>.jsonl.bak.<timestamp>
[DONE] Close & reopen this tab to refresh.

依赖

• Node.js（所有依赖均为内置模块，无需 npm install）

回退方案

如果 .cjs 脚本在特定环境中运行异常（如路径解析、编码问题），可回退使用同名的 .ps1 版本（PowerShell 脚本），命令参数略有不同（详见旧版 SKILL.md 或 scripts/ps1_backup/ 中的参考）。

这个 Skill 质量不错，功能实用且文档清晰。优点是支持多平台、操作安全（有备份和确认）、命令简单好记。中文会话管理也很方便。不足是偶尔会有重复文件，而且错误提示不够详细，遇到问题不太容易排查。总体来说是个可靠实用的工具，适合需要管理会话历史的用户使用。