前言¶
在 DeepSeek Harness（DSH）裏做智能體或 Web 側開發時，經常要在對話、腳本和配置之間切換，再去單獨的客戶端查表結構或跑 SQL。DSH 社區主張「一切皆插件」，右側欄可以掛能力面板；若能在同一界面裏維護連接、瀏覽 schema、執行查詢並預覽結果，日常調試會少很多窗口切換。下面介紹維護者 lidaiyue 開源的 dsh-database：定位爲 DSH 右側欄裏的數據庫工具，在 Harness 界面內提供連接樹、SQL 控制台、結果網格與導入導出等能力。插件在 SkillHub 分類爲「記憶」，當前 GitHub 星標爲 0；源碼與說明以倉庫爲準。
這是什麼¶
dsh-database（npm 包名 dsh-database，當前版本 1.1.2）是掛在 DSH Web 右側欄的數據庫探索與 SQL 工具。README 用一句話概括：A database tool in the DeepSeek Harness right column.
package.json 中的描述更接近產品形態：IDEA 風格的數據庫資源管理器，包含連接、schema/表、可內聯編輯的預覽、導入導出，以及 SQL/Redis 控制台。
維護者：lidaiyue。許可證：MIT。
社區目錄頁：SkillHub - dsh-database（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。源碼：github.com/lidaiyue/dsh-database。
核心功能¶
以下能力均來自倉庫 README 與 package.json 披露的實現範圍（依賴含 pg、mysql2、ioredis，Oracle 通過可選依賴 oracledb）。
連接與資源樹¶
- 支持 PostgreSQL、MySQL、Oracle、Redis 連接樹。
- 可按名稱或註釋過濾，拖拽排序，摺疊樹節點；錶行在存在註釋時會顯示註釋。
SQL 控制台與結果¶
- SQL 高亮與關鍵字補全隨當前連接變化。
- 可執行選中片段或整段腳本；控制台標籤可重命名、固定、關閉與重新打開。
- 結果網格：默認每頁 50 行，或一次加載全部（上限 5000 行）。
- 雙擊單元格可編輯、增行並提交；單表結果可寫回，JOIN 結果只讀。
- 可複製選中單元格爲純值，或將選中行復製爲
INSERT語句；可將可見行導出爲 CSV。
表結構與可見 schema¶
- 查看列、可空性、默認值與註釋；可從樹中表節點打開，也可在控制台選中表名打開。
- Visible schemas：選擇樹中展示的 schema；留空表示顯示全部。此設置僅過濾樹，不限制 SQL 能訪問的對象。
導入導出與安全提示¶
- 支持對連接、schema 或表做 SQL 導入導出；Redis 導出爲 JSON。
- 若導入內容包含
DROP或TRUNCATE，會列出這些語句並等待確認後再繼續。
Redis¶
- 雙擊 key 可預覽類型、TTL 與值；可複製名稱或刪除 key。
快捷鍵與打開方式¶
- 打開數據庫標籤：
⌘2/Ctrl+2；執行 SQL：⌘Enter/Ctrl+Enter；表結構：F1；關閉當前控制台：⌘W/Ctrl+W；可在頁腳重新綁定。README 註明不依賴其他插件。 - Open mode：狀態欄可在全屏與分欄之間切換，選擇與編輯器共用並立即生效。
憑據與 Oracle 連接¶
- 密碼保存在 Harness 憑據存儲中，不寫在連接文件裏；編輯時空密碼字段表示保留原密碼。可選對等依賴
@deepseek-ai/dsh-credentials。 - Oracle 12.2 及以上以 Thin 模式連接；更舊版本需在連接配置中指定 Instant Client 目錄。
安裝與啓用¶
官方 README 給出的安裝方式爲本地路徑添加（須將路徑換成你本機克隆或解壓後的絕對路徑）：
dsh plugin --profile web add /absolute/path/to/dsh-database
完成後重啓 dsh web，再刷新頁面。插件通過 cordis.patch.yml 注入 Web 客戶端，並掛載到 @deepseek-ai/dsh-client-ui-sidebar-right。
典型用法¶
- 按上一節安裝並重啓 Web 後，用
Ctrl+2（macOS 爲⌘2）打開右側數據庫標籤。 - 在連接樹中配置 PostgreSQL / MySQL / Oracle / Redis；密碼通過憑據存儲管理，勿期待明文寫在連接配置文件中。
- 在 SQL 控制台編寫腳本，用
Ctrl+Enter執行選中或全文；在單表結果網格中雙擊編輯並提交，或使用結構視圖（F1）覈對列定義。 - 需要備份或遷移時，對連接、schema 或表使用導入/導出；含破壞性語句的導入會先列出
DROP/TRUNCATE再等待確認。 - 樹節點過多時，在 Visible schemas 中限定展示範圍，僅影響左側樹，不影響可執行的 SQL 範圍。
適用場景與注意¶
適合誰：已在 DSH Web 環境內開發、希望把查庫、改數、看結構和輕量遷移收進右欄的開發者；需要同時接觸關係庫與 Redis 的團隊也適合用同一面板切換。
運行與安全：
- 插件隨當前 dsh 進程權限訪問數據庫與文件系統；安裝前應閱讀源碼與 MIT 許可證，並確認連接目標與憑據策略符合你的環境規範。
- 不要用本文臆造的安裝命令；除 README 所示的
dsh plugin --profile web add <絕對路徑>外，資料未給出其他一鍵安裝方式。 - SkillHub 上的分類「記憶」描述的是目錄歸類；具體能力以 GitHub README 爲準。
結尾¶
dsh-database 把多引擎連接樹、SQL 控制台、可編輯結果網格、結構視圖與導入導出放進 DSH 右側欄，並配合快捷鍵與分欄/全屏切換，減少在 Harness 與外部數據庫工具之間的來回切換。進一步瞭解與獲取源碼：
- 目錄頁：https://www.skillhub.cn/plugins/lidaiyue/dsh-database
- GitHub：https://github.com/lidaiyue/dsh-database
