Artificialwhale/session-reader-plugin

插件Plugin 原生Native ⭐ 2 MIT cat_label.dshcat_label.dsh

允许代理从其他会话中获取上下文。

项目介绍Project Overview

dsh-session-reader 是 DSH 插件,用于在会话内读取其他会话:提供 session_list、session_read 工具与 /sessions 命令,可查看消息、工具调用/结果、thinking、压缩后 surface 及压缩前 raw 事件。适用于跨会话查阅上下文、追溯推理或排查日志。所有访问只读且有截断上限;依赖宿主 sessionQuery 服务,安装后需重启 DSH 生效。

dsh-session-reader is a DSH plugin for reading other sessions from within a session. It provides session_list and session_read tools plus /sessions commands to inspect messages, tool calls/results, reasoning chunks, compressed surface messages, and raw pre-compression events. Use it to cross-reference context, trace reasoning, or inspect logs. All reads are read-only and bounded by truncation limits; it requires the host sessionQuery service and a DSH restart after installation.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dsh-session-reader

Artificialwhale/session-reader-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-session-reader

在 DSH 会话内读取其他会话的内容:消息、工具调用/结果、推理过程(thinking)、压缩前的原始事件流。支持 agent 工具调用与 /sessions 斜杠命令两种使用方式,所有读取都是只读有界的。

由实际使用需求驱动开发:让一个会话里的 agent 能查阅别的会话(比如查另一个会话的上下文再继续讨论)。已在 DSH 0.1.0-rc.6 上验证。

功能

agent 工具

  • session_list — 列出未归档会话(id、标题、工作区、创建时间、预设),支持按 id/工作区过滤、limitincludeArchived
  • session_read — 按 id 读取会话内容,4 种模式:
    • io — 用户/助手消息与工具调用/结果(默认)
    • thinking — 推理分块(reasoning chunks)
    • surface — 压缩后的当前模型可见消息
    • raw — 原始日志事件(含压缩前的事件)

斜杠命令(无需模型回合,直接输出)

  • /sessions list [query] [--limit N] [--archived]
  • /sessions read <id> [io|thinking|surface|raw] [--query text] [--limit N]

安装

# 从 npm
dsh plugin --profile web add dsh-session-reader

# 或从 GitHub
dsh plugin --profile web add github:Artificialwhale/session-reader-plugin

# 或本地目录
dsh plugin --profile web add /path/to/dsh-session-reader

本包声明了 dsh.bundle,安装后会自动追加进 dsh.profile.bundles 层栈并激活;重启 dsh 后生效。

使用示例

# 发现会话 id
/sessions list
/sessions list 爱丽丝 --limit 5

# 读取某个会话
/sessions read session-xxxx-xxxx io
/sessions read session-xxxx-xxxx thinking --limit 20
/sessions read session-xxxx-xxxx raw --query "step/start"

兼容性

  • 纯 JS,无构建步骤、无原生依赖、无运行时依赖
  • 依赖宿主提供的 sessionQuery 服务以及随 dsh 发行版自带的 @deepseek-ai/dsh-tools@deepseek-ai/dsh-llm无需单独安装
  • 输出有截断保护:单条内容与总数都有上限,避免污染上下文

License

MIT

上一个 Prev dsh-langfuse 下一个 Next dsh-sidechat