session-reader-plugin
其他 活跃维护

session-reader-plugin

Artificialwhale/session-reader-plugin

轻量级会话上下文读取插件,可直接集成到智能体框架中,支持跨会话读取历史对话上下文,快速补充当前交互所需信息,保障多轮对话的信息连贯性。

2
Stars 标星
0
Forks 分支
2
Watchers 关注
0
Open Issues
JavaScript
主要语言
MIT
开源协议
8 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:Artificialwhale/session-reader-plugin
git clone https://github.com/Artificialwhale/session-reader-plugin.git
git clone git@github.com:Artificialwhale/session-reader-plugin.git
README.md main

dsh-session-reader

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

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

功能

agent 工具

  • session_list — 列出未归档会话(id、标题、工作区、创建时间、预设),支持按 id/工作区过滤、limit、includeArchived
  • 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