前言¶

DSH 的插件机制允许在宿主能力之上扩展 agent 工具、斜杠命令和会话相关能力。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解成官方应用商店。

对使用 DSH 做智能体开发或会话管理的人来说，一个具体问题是：当前会话里的 agent 有时需要查看另一个会话已经产生的上下文，例如用户/助手消息、工具调用与结果、推理过程，或者压缩前的原始事件流。

Artificialwhale/session-reader-plugin 提供这样一个插件：在 DSH 会话内读取其他会话的内容。它既可以作为 agent 工具调用，也可以通过 /sessions 斜杠命令直接输出结果。所有读取都是只读且有界的。

插件定位¶

• 仓库：Artificialwhale/session-reader-plugin
• 维护者：Artificialwhale
• 许可证：MIT
• 验证版本：DSH 0.1.0-rc.6
• 核心价值：在 DSH 会话内读取其他会话的消息、工具调用/结果、thinking 与 raw 事件流

核心功能¶

session_list¶

session_list 用于列出未归档会话。

返回内容包括：

• id
• 标题
• 工作区
• 创建时间
• 预设

支持的过滤与控制参数包括：

• 按 id 过滤
• 按工作区过滤
• limit
• includeArchived

session_read¶

session_read 用于按会话 id 读取内容。

支持四种模式：

• io：用户/助手消息与工具调用/结果，默认模式
• thinking：推理分块
• surface：压缩后的当前模型可见消息
• raw：原始日志事件，包含压缩前的事件

斜杠命令¶

插件提供两个斜杠命令：

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

斜杠命令无需模型回合，直接输出结果。

只读与有界输出¶

所有读取都是只读且有界的。

输出带有截断保护：单条内容与总数都有上限，用于避免污染上下文。

安装与启用¶

已核实的 GitHub 安装命令为：

dsh plugin --profile web add github:Artificialwhale/session-reader-plugin

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

重启 dsh 后生效。

典型用法¶

发现会话 id¶

下面两个示例用于查找会话：

/sessions list
/sessions list 爱丽丝 --limit 5

第一个命令列出会话。第二个命令使用 爱丽丝 作为查询条件，并限制返回数量为 5。

读取某个会话¶

下面示例中的 session-xxxx-xxxx 是会话 id 占位符：

/sessions read session-xxxx-xxxx io

读取默认的 io 模式，即用户/助手消息与工具调用/结果。

/sessions read session-xxxx-xxxx thinking --limit 20

读取 thinking 模式，并限制返回数量为 20。

/sessions read session-xxxx-xxxx raw --query "step/start"

读取 raw 模式，并使用 step/start 作为查询文本。

依赖与兼容¶

• 纯 JS
• 无构建步骤
• 无原生依赖
• 无运行时依赖
• 依赖宿主提供的 sessionQuery 服务
• 使用随 dsh 发行版自带的 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-llm，无需单独安装
• 已在 DSH 0.1.0-rc.6 上验证

适用场景与注意¶

适合这类使用方式：

• 在当前 DSH 会话里查看另一个会话已经产生的上下文
• 排查 agent 在不同会话中的消息、工具调用/结果和推理过程
• 读取压缩前的原始事件流，用于理解更早的会话状态
• 基于另一个会话的已有上下文继续讨论或继续开发

注意：

• 插件以当前 dsh 进程权限运行
• 安装前应检查源码与 MIT 许可证
• 输出有截断保护，但不等于无限制读取全部会话内容
• 不要把社区目录理解为官方应用商店；本文材料未提供可确认的目录页地址

链接¶

本文材料未给出可确认的目录页地址，因此不列目录页链接。

GitHub 仓库：

https://github.com/Artificialwhale/session-reader-plugin.git