前言¶
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過濾 - 按工作區過濾
limitincludeArchived
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
