前言¶
在 DeepSeek Harness（DSH）裏，工作區、會話、文件管理器和編輯器之間經常需要來回切換。常見操作包括查看工作區絕對路徑、在文件管理器中打開目錄、用編輯器打開工作區、在長會話中定位某條提問、標記空閒會話，以及在服務狀態異常時重啓 DSH。
dsh-niao-quick-open 是一個面向 DSH Web 界面的插件，把這些常用操作集中到界面上，減少離開頁面後再手工查找目錄、編輯器或會話位置的步驟。
這是什麼¶
dsh-niao-quick-open 是一個 DSH 客戶端插件，包名爲 dsh-niao-quick-open，維護者爲 dsh-niao，許可證爲 MIT。
它主要提供以下能力：
- 工作區一鍵打開：複製路徑、在文件管理器中顯示、用常用編輯器打開。
- 編輯器自動發現：宿主端掃描可用編輯器，列出能生成有效打開命令的編輯器。
- 用戶消息導航條：在長會話右側標記用戶提問，便於快速定位。
- 會話待辦標記：在空閒會話前顯示可點擊標記。
- 單列表增強：把單列表視圖中的會話卡片調整爲三行佈局。
- 硬性重啓：在頁面內重啓 DSH 服務，並在服務恢復後刷新頁面。
核心功能¶
會話區域頂部快捷按鈕¶
打開任意工作區會話後，會話區域頂部第一行會顯示當前工作區文件夾名，並提供三個圖標按鈕：
- 複製絕對路徑
- 在文件管理器中顯示
- 用常用編輯器打開
第二行顯示當前會話名稱。
工作區菜單快捷操作¶
在每個工作區的 ⋯ 菜單底部，插件會提供一行快捷按鈕，用於：
- 複製路徑
- 在訪達 / 文件管理器中顯示
- 用常用編輯器打開工作區文件夾
用戶消息導航條¶
在會話右側，插件會顯示一條用戶消息導航條。每條用戶消息對應一個標記，支持：
- 懸停標記查看提問摘要
- 點擊標記跳轉到對應提問
- 當前閱讀位置高亮
- 底部顯示用戶消息總數徽標
該導航條在會話用戶消息不少於 2 條，且內容超過一屏時出現，並受「界面功能 → 用戶消息導航條」開關控制。
會話待辦標記¶
空閒會話前會顯示一個可點擊的待辦標記。用戶可以將其標記爲完成，也可以再次點擊取消。
待辦標記狀態保存在瀏覽器本地，不佔用服務配置。
單列表視圖增強¶
開啓後，單列表視圖中的會話卡片會升級爲三行佈局：
- 狀態圖標、工作區名、相對時間
- 會話標題
- 最後一條對話預覽
列表頭部快捷切換¶
工作區 / 會話列表頭部會增加一個「切換分組方式」快捷圖標。點擊後，可以在工作區分組與單列表之間切換。
界面功能設置面板¶
插件會在 DSH 設置面板中註冊「界面功能」頁，把配置項按以下區域分組：
- 側邊欄
- 會話區域
- 系統工具
配置項可即時生效。部分需要重啓才能生效的修改完成後，頁面頂部會顯示「重啓以生效」橫幅。
配置持久化到：
~/.dsh/dsh-niao-quick-open.config.json
編輯器自動發現¶
編輯器由宿主端掃描，包括：
- 已知編輯器品牌
- 系統應用
- 常見編輯器 CLI
插件會列出能夠生成有效打開命令的編輯器。列出的編輯器都用於打開當前工作區文件夾。
硬性重啓¶
界面左下角設置按鈕旁邊會新增一個重啓圖標。點擊後進入二次確認流程。
確認後，插件會以當前進程相同的命令拉起一個脫離終端的新實例，等待舊進程退出、端口釋放後啓動新實例，再退出當前進程。前臺頁面會顯示等待層，服務恢復後自動刷新頁面。
安裝與啓用¶
推薦安裝命令：
dsh plugin --profile web add dsh-niao-quick-open
也可以把包加入當前 profile 的 package.json 的 dependencies，以及 dsh.profile.bundles，然後重啓 DSH Web：
dsh web
典型用法¶
下面這些操作都可以在 DSH Web 界面中完成：
-
打開任意工作區會話後，在會話區域頂部第一行使用「複製絕對路徑」「在文件管理器中顯示」或「用常用編輯器打開」。
-
進入 DSH 設置，打開「界面功能」頁，按需開關各項功能，並配置「常用編輯器」。
-
在長會話中，將鼠標懸停在會話右側用戶消息導航條上查看提問摘要，點擊標記跳轉到對應提問。
-
在空閒會話前點擊待辦標記，標記爲完成或取消。
-
需要重啓服務時，點擊左下角設置按鈕右側的重啓圖標，經過二次確認後執行硬性重啓。
技術信息¶
插件聲明爲 Web 客戶端插件：
platform: web
client inject: @deepseek-ai/dsh-client-runtime
dependency: @deepseek-ai/schemastery ^3.18.1
它通過 DSH 客戶端運行時注入界面增強邏輯，並在宿主端完成編輯器掃描、服務重啓等操作。
適用場景與注意¶
適合使用 DSH Web 界面的開發者，尤其是經常需要：
- 在 DSH 與文件管理器之間切換目錄
- 用編輯器快速打開工作區
- 在長會話中定位歷史提問
- 標記空閒會話
- 在頁面內重啓 DSH 服務
安裝前請注意：
- 該插件運行在 DSH 當前進程環境中，具有該進程相應權限。
- 它會向 DSH Web 客戶端注入代碼，並在宿主端執行掃描、重啓等操作。
- 安裝前建議檢查源碼、依賴與 MIT 許可證。
- 硬性重啓會重啓 DSH 服務，請按需使用。
鏈接¶
GitHub 倉庫：
https://github.com/dsh-niao/dsh-niao-quick-open
