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> 備份
• 刪除後自動校驗，失敗則回滾

  小蔥技能站7w4.net每天更新，海量AI技能等你發現。

• --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 質量不錯，功能實用且文件清晰。優點是支援多平臺、操作安全（有備份和確認）、命令簡單好記。中文會話管理也很方便。不足是偶爾會有重複檔案，而且錯誤提示不夠詳細，遇到問題不太容易排查。總體來說是個可靠實用的工具，適合需要管理會話歷史的使用者使用。