前言¶

在 DSH 工作流裏，會話歸檔後通常會落到本地目錄中。如果只依賴 shell 命令處理歸檔會話，需要分別確認標題、創建時間、所屬目錄、磁盤文件路徑和佔用空間。dsh-archived-sessions 把這類操作集中到 DeepSeek Harness 的 Web 設置頁中，作爲一個可安裝的設置頁擴展使用。

這是什麼¶

dsh-archived-sessions 是 MuWinds 維護的 DeepSeek Harness Web 界面設置頁擴展，以單 bundle 包分發，一條命令即可安裝。它用於查看已歸檔會話、釋放歸檔會話、刪除會話文件，並預覽會話內容。

包名與倉庫信息如下：

• npm 包名：@muwinds/dsh-archived-sessions
• GitHub 倉庫：MuWinds/dsh-archived-sessions
• 目標 Harness 版本：0.1.0-rc.6（web profile 組合結構）
• 許可證：MIT

核心功能¶

在 Harness 的「設置 → 歸檔會話」頁面中，該插件提供以下能力：

• 查看所有已歸檔會話，包括標題、創建時間、所屬目錄、磁盤上的實際文件路徑。
• 顯示每個會話佔用的磁盤空間與總佔用。
• 釋放歸檔會話，即取消歸檔並回到原工作區，支持單個、批量、一鍵全部。
• 從硬盤刪除會話文件，支持單個、批量、一鍵清空，並有兩步確認。
• 點擊會話標題展開查看會話內容，包括用戶 / 助手 / 工具消息預覽。

宿主端提供 POST /dsh-archived/* 路由，覆蓋 list、unarchive、delete、detail 四類操作。該路由爲同源、無鑑權，適合本地 Web 設置頁環境使用。

安裝與啓用¶

從 GitHub 安裝：

dsh plugin --profile web add github:MuWinds/dsh-archived-sessions

安裝後重啓 Harness：

npx @deepseek-ai/dsh web

設置面板底部會出現「歸檔會話」頁面。

從本地目錄安裝，適合開發調試：

dsh plugin --profile web add ./dsh-archived-sessions

卸載：

dsh plugin --profile web remove @muwinds/dsh-archived-sessions

如果包已發佈到 npm registry，可用包名安裝：

dsh plugin --profile web add @muwinds/dsh-archived-sessions

只走 GitHub 也可以：

dsh plugin add github:MuWinds/dsh-archived-sessions

如果需要鎖定版本，可以將倉庫來源指定爲：

github:MuWinds/dsh-archived-sessions#<sha>

這個包是純 JavaScript 包，沒有 prepare 構建腳本，因此不需要 pnpm allowBuilds 授權。宿主端插件無第三方運行時依賴，純 ESM，不 import 任何 @deepseek-ai/*，所需能力全部從 ctx 獲取；瀏覽器端僅依賴 react，由 Harness 前端運行時提供，屬於 platform seed。

典型用法¶

1、安裝插件並重啓 Harness：

dsh plugin --profile web add github:MuWinds/dsh-archived-sessions
npx @deepseek-ai/dsh web

2、進入 DSH Web 界面，打開設置面板，在底部找到「歸檔會話」頁面。

3、在列表中查看會話標題、創建時間、所屬目錄、磁盤文件路徑和磁盤佔用。

4、點擊會話標題，展開預覽用戶 / 助手 / 工具消息。

5、如果要把會話恢復到原工作區，使用釋放（取消歸檔）。如果需要清理磁盤空間，使用刪除。刪除前需要兩步確認，且刪除不可恢復。

適用場景與注意¶

適合使用 DSH web profile 的本地開發者，尤其是需要集中查看和清理歸檔會話的使用者。使用前需要注意：

• 本插件包含「從硬盤刪除會話文件」能力，刪除不可恢復。
• 安裝即代表信任本倉庫代碼會在你的機器上以你的權限運行，安裝前請審閱源碼和 MIT 許可證。
• 宿主端 API 爲 POST /dsh-archived/*，無鑑權、同源，僅適合本地 Web 設置頁環境。
• 目標 Harness 版本爲 0.1.0-rc.6，對應 web profile 組合結構。
• 國內鏡像只讀，發佈時需顯式帶官方源。

結尾¶

dsh-archived-sessions 的價值是把歸檔會話管理從文件系統操作里拉回到 DSH Web 設置頁：查看、釋放、刪除和詳情預覽都在同一頁面完成。倉庫地址：https://github.com/MuWinds/dsh-archived-sessions