在 DeepSeek Harness (DSH) 的 Web UI 或開發環境中，處理 JSON、YAML 或 SQLite 數據時，若沒有外部工具配合，解析與查詢會變得繁瑣。該插件通過封裝 jq、yq 和 sqlite3，提供了一套沙箱化的命令行工具集，讓數據過濾與查詢在受限環境中安全運行。
插件概覽¶
這是一個專注於數據解析的工具插件。它不提供新的數據源，而是將常用的數據查詢工具封裝在 DSH 插件中。核心價值在於沙箱化與只讀限制，確保在 WSL 環境下對數據的操作是可控且安全的。
- 名稱：
dsh-wsl-struct - 維護者：173787247
- 類別：admin-security
- 一句話描述：Sandboxed jq / yq / read-only sqlite3.
- 許可證：MIT
安裝¶
通過 DSH 插件管理器進行安裝。該插件需要 dsh 版本 ≥ 0.1.2。
dsh plugin --profile web add github:173787247/dsh-wsl-struct
如果需要使用批量鏈接功能，可以執行以下命令（此步驟爲可選）：
bash dsh-wsl-kit/scripts/link-linux-plugins.sh
核心功能¶
插件提供了四個主要的命令行工具，分別對應不同的數據處理需求：
- struct_status：檢查 CLI 是否在 PATH 中，用於確認工具可用性。
- struct_jq：提供
jq過濾功能，用於處理 JSON 數據。 - struct_yq：提供
yq查詢功能，用於處理 YAML 數據。 - struct_sqlite：提供
sqlite3的只讀 SQL 查詢能力。
典型用法¶
根據不同的數據格式和處理需求，可以使用對應的命令：
- 過濾 JSON 數據：使用
struct_jq對 JSON 輸入進行過濾和提取。 - 查詢 YAML 數據：使用
struct_yq對 YAML 結構進行查詢。 - 運行只讀 SQL：使用
struct_sqlite執行 SELECT 語句，禁止破壞性操作。 - 檢查可用性：使用
struct_status確認相關 CLI 工具已正確加載。
注意事項¶
- 權限限制：
struct_sqlite僅支持只讀操作，禁止破壞性 SQL 語句。 - 默認根目錄：工具的默認運行根目錄包括
$HOME、~/.dsh和/tmp。 - 兼容性：請確保 DSH 版本滿足 ≥ 0.1.2 的要求。
- 生態關係：該插件與 dsh-wsl-kit 生態相關，Kit 批量鏈接爲可選配置。
總結¶
dsh-wsl-struct 爲 DSH 插件體系提供了一套輕量級的數據解析能力。通過沙箱化和只讀限制，它在不增加系統複雜度的情況下，解決了環境內數據查詢的需求。更多細節與源碼，可參考項目目錄頁或 GitHub 倉庫。
