DeepSeek-Keeper：离线浏览DeepSeek对话记录

项目简介：一个轻量级工具，用于导入、存储和离线浏览DeepSeek网页端导出的对话数据，支持终端和浏览器两种查看方式。

📌 项目概述

开发者：urumchi 项目性质：开源（MIT许可证） 核心功能：将DeepSeek导出的对话数据导入本地，以Markdown格式存储，并提供终端CLI和Web两种浏览界面。

解决的问题：DeepSeek网页端导出数据后，缺乏方便离线浏览和管理的工具。DeepSeek-Keeper填补了这一空白。

✨ 主要功能

功能模块	说明
数据导入	支持导入DeepSeek导出的ZIP文件、解压后的目录或JSON文件。
数据存储	对话以Markdown文件形式存储，包含YAML元数据和完整消息历史。默认存储目录：~/.dskeeper/。
终端浏览	通过 dskeeper list 列出对话，dskeeper stats 查看统计信息。
Web服务	通过 dskeeper serve 启动本地Web服务，在浏览器中直观浏览对话。
数据管理	支持按ID 删除对话，可自定义数据目录，支持JSON格式输出便于脚本处理。

🛠️ 安装与快速开始

安装

pip install deepseek-keeper
# 或
uv tool add deepseek-keeper

快速开始（四步走）

1. 导出数据：在DeepSeek网页端 系统设置 → 数据管理 → 导出所有历史对话，下载ZIP文件。
2. 导入数据：

   dskeeper import ~/Downloads/deepseek_data.zip
   

3. 终端浏览：

   dskeeper list      # 列出所有对话
   dskeeper stats     # 查看统计信息
   

4. 浏览器浏览：

   dskeeper serve     # 启动Web服务，默认 http://127.0.0.1:8080
   

📂 数据存储结构

导入后，数据按以下结构组织：

~/.dskeeper/
├── config.toml          # 配置文件
├── metadata.json        # 元数据索引
└── conversations/
    ├── 对话标题1-7f5516cd.md
    └── 对话标题2-8a1234ef.md

每个Markdown文件包含YAML前置元数据（如时间、模型信息）和完整的消息历史，便于阅读和备份。

🔧 高级用法与配置

常用命令详解

命令	作用	示例
dskeeper import <路径>	导入数据	dskeeper import data.zip --force (强制覆盖)
dskeeper list	列出对话	dskeeper list --limit 10 (限制条数)
dskeeper stats	查看统计	dskeeper stats
dskeeper serve	启动Web服务	dskeeper serve --port 3000 --host 0.0.0.0
dskeeper delete <ID>	删除对话	dskeeper delete session-id -y (跳过确认)
dskeeper config	管理配置	dskeeper config set data-dir /custom/path

全局选项

• --data-dir, -d：指定自定义数据目录
• --verbose, -v：显示详细输出
• --json：输出JSON格式，便于脚本解析

数据目录优先级

1. 命令行参数 --data-dir
2. 环境变量 DSKEEPER_DATA_DIR
3. 本地目录 ./.dskeeper/
4. ~/.dskeeper/config.toml 中的配置
5. 默认目录 ~/.dskeeper/

💻 开发与贡献

项目使用Python开发，依赖uv工具链。

克隆与开发环境设置：

git clone https://github.com/urumchi/deepseek-keeper.git
cd deepseek-keeper
uv sync

# 从源码运行
uv run dskeeper --help

# 运行测试
uv run pytest

📊 与同类工具对比（个人观察）

特性	DeepSeek-Keeper	DeepSeek网页端	手动管理JSON
离线访问	✅ 支持	❌ 需联网	✅ 支持
浏览体验	终端/Web界面	原生界面	需自行解析
数据持久化	Markdown+元数据	在线存储	JSON文件
搜索与管理	基础CLI管理	强大在线搜索	需手动处理
数据隐私	完全本地	云端存储	完全本地

🔗 相关链接

• GitHub仓库：https://github.com/urumchi/deepseek-keeper
• 许可证：MIT

注：DeepSeek-Keeper是一个专注于离线数据管理的实用工具，适合需要长期保存、备份或本地分析DeepSeek对话的用户。项目刚刚发布（最新提交2026年8月10日），功能相对简洁，未来可能有更多扩展。以上信息整理自项目README，具体使用请以官方文档和最新代码为准。