dsh-session-recorder

Readme

# dsh-session-recorder

Auto-record your DeepSeek Harness conversations as Markdown files — one file per session, kept up to date automatically, with one click to open the save folder in your OS file manager.

· 自动把 DeepSeek Harness 会话对话记录为 Markdown 文件：每会话一个文件、实时更新、一键在系统文件管理器中打开保存目录。

## Features / 功能

- **Auto-recording on by default** — install it and recording starts for the current session immediately; any session that produces messages is recorded automatically. No buttons to press. / **默认开启自动记录** — 安装即记录当前会话，任何产生消息的会话都会被自动记录，无需任何手动操作。
- **One Markdown file per session** — named `会话标题_YYYYMMDD-HHmmss.md`, with the DSH session title used in the file name (illegal characters sanitized). / **每会话一个 md 文件** — 文件名 `会话标题_YYYYMMDD-HHmmss.md`，自动使用 DSH 会话标题（非法字符已清理）。
- **User + assistant messages with timestamps** — `## 用户 · 2026-08-29 10:28:08` sections; tool calls and system-injected context are not recorded. / **用户+助手消息带时间戳** — 以 `## 用户 · 2026-08-29 10:28:08` 分节；工具调用与系统注入的上下文不记录。
- **Click the path to open the folder** — a "open folder" button and a clickable path in the UI open the save directory in Finder / Explorer / file manager via the platform's native command. / **点击路径打开文件夹** — UI 中的"打开文件夹"按钮与可点击路径，通过系统原生命令在 Finder / 资源管理器 / 文件管理器中打开保存目录。
- **Configurable save root** — default `~/.dsh/conversations/`, changeable in the panel (runtime, in-memory; resets to default after restart). / **保存目录可配置** — 默认 `~/.dsh/conversations/`，可在面板中修改（运行时内存态，重启后恢复默认）。

## Install / 安装

```sh
dsh plugin --profile web add dsh-session-recorder
```

Restart `dsh web` (or let the plugin market hot-load it). / 重启 `dsh web`（或由插件市场热加载）。

## Usage / 使用

Once installed, recording is already running — nothing to enable. Two UI surfaces:

1. **Session-header button** (`📄 <count>`) — shows the recorded message count of the current session; click to open the save folder.
2. **Composer-dock panel** (below the input box) — shows title, status, file name, full save path, a configurable save-root input, and an "open folder" button.

安装即自动记录，无需任何开启操作。界面有两处：

1. **会话头部按钮**（`📄 <数量>`）— 显示当前会话已记录消息数；点击打开保存文件夹。
2. **输入框下方面板** — 显示标题、状态、文件名、完整保存路径、可配置的保存根目录输入框，以及"打开文件夹"按钮。

## File format / 文件格式

```markdown
## 用户 · 2026-08-29 10:28:08

给我实现一个插件用来记录对话…

## 助手 · 2026-08-29 10:28:11

我先加载技能，然后核对需求。
```

## Requirements / 环境要求

- DeepSeek Harness web profile (`dsh web`)
- macOS / Linux / Windows (folder-open command is chosen per platform)

## License

Apache-2.0 — © luoghong