在 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 仓库。
