dsh-prism

dsh-prism

DeepSeek Harness (DSH) 本地会话与工作区管理工具。支持历史对话检索、工作区残留清理、批量删除与安全恢复。

解决的问题

在长期使用 DeepSeek Harness 时，容易遇到几个实际问题：

• 会话归档后在 Web 界面不易跨工作区快速检索；
• 在界面移除工作区后，~/.dsh 磁盘目录下仍残留大量旧会话数据；
• 官方界面没有提供会话多选批量清理与回收站机制，误删后难以找回；
• 无法将历史长对话直接导出为本地 Markdown 文档保存。

dsh-prism 通过读取本地磁盘数据，提供了一个直观的本地 Web 控制台来集中处理这些需求。

主要功能

• 会话检索与查看：按标题、提问内容、模型或工作区物理路径搜索；支持查看对话详情与完整问答轮次。
• 工作区对话管理：直观展示已注册工作区与已移除残留目录；支持按“活跃/已归档”状态筛选，支持多选并批量移至回收站。
• 安全回收站：所有删除操作均放入 ~/.dsh/_trash/ 目录中按工作区分层备份，支持一键原样恢复，避免误删数据丢失。
• 导出 Markdown：浏览任意会话时，可一键将其导出为结构完整的 .md 文件，方便归档到知识库。
• 纯原生零依赖：基于 Node.js 原生模块开发，无第三方运行时依赖，免下载体积膨胀的 node_modules。

快速使用

免安装运行

只要安装了 Node.js (>= 18，推荐 >= 22 以支持原生 zstd 物理日志解压)，直接在终端运行：

npx dsh-prism

系统会自动分配空闲端口并在默认浏览器中打开控制台。

可选参数

# 指定端口运行
npx dsh-prism --port 8080

# 静默启动（不自动弹出浏览器，适合远程服务器或 SSH）
npx dsh-prism --port 8080 --no-open

# 查看帮助
npx dsh-prism --help

全局安装

npm install -g dsh-prism
dsh-prism

目录与数据结构

工具默认读取用户主目录下的 ~/.dsh 数据：

~/.dsh/
├── sessions/             # DSH 物理会话数据流
├── storages/
│   ├── workspace.json    # 工作区注册信息
│   └── session_projcache/ # 会话独立快照缓存
└── _trash/               # 安全回收站
    └── workspaces/       # 按工作区分层存放已删会话
        └── <工作区名>/
            ├── meta.json
            └── sessions/
                └── <会话标题>/

开源协议

本项目采用 MIT License 协议。