前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。智能体在执行复杂任务时，中间环节往往需要调用一些确定性的工具，例如 JSON 与 YAML 的互转、SQL 语法迁移、正则表达式测试或 JWT 解码。
如果通过提示词让大模型直接处理这些需求，通常速度较慢、Token 消耗更多，且难以保证结果的完全可复现。dsh-devkit 正是为了解决这一问题而生，它提供了一组轻量级的确定性操作工具，让智能体在任务流中间能够快速、低成本地调用。
插件定位¶
该插件由 mario03690 维护，是一个基于 MCP (Model Context Protocol) 的工具集。它不包含任何本地执行代码，仅通过一个配置补丁与 DSH 的 MCP 客户端通信，旨在为智能体提供 JSON/YAML 处理、SQL 转译、文本脱敏、二维码生成等通用能力。
安装与启用¶
使用 DSH 的插件管理器进行安装：
dsh plugin --profile <your-profile> add github:mario03690/dsh-devkit
安装后，插件会向 DSH 的 Cordis 配置中注入必要的 MCP 客户端配置。
核心工具列表¶
插件提供了 14 个工具，覆盖了智能体开发中常见的基础操作：
what_can_you_do: 描述任务（支持任意语言），返回能执行该任务的工具列表及调用示例。redact_text: 从文本中剥离敏感信息，包括邮箱、电话、ID、API Key、JWT、卡号和 IP。json_yaml: JSON 与 YAML 的双向转换，自动识别输入格式。validate_json: 校验文本是否为有效 JSON，并可检查特定 Schema 和顶层类型。diff_text: 计算文本差异，返回新增和删除的行号（基于最长公共子序列算法）。jwt_decode: 解码 JWT 的 Header 和 Payload，将时间戳转换为可读格式，并计算剩余有效期。regex_test: 使用正则表达式测试文本，返回匹配位置、捕获组（支持命名捕获组）。transpile_sql: SQL 语句方言转换，支持 MySQL、PostgreSQL、SQLite、TSQL、Oracle、Snowflake、BigQuery、ClickHouse、Doris、StarRocks 等。make_qr: 生成二维码 PNG，支持文本或 URL。json_format: 验证并格式化 JSON（2 空格缩进），若无效则报错位置。timezone_convert: 时区转换，支持任意 IANA 时区（如 Asia/Shanghai）及当前时间查询。unit_convert: 单位转换，涵盖长度、重量、温度、面积、体积、速度和数据大小。sql_from_description: 根据自然语言描述和表结构生成可直接运行的 SQL 文件。screenshot_url: 对指定 URL 进行全页截图，生成 PNG 图片。
典型用法¶
智能体可以调用这些工具来完成具体任务：
* SQL 转译：将 MySQL 的查询语句转换为 PostgreSQL 语法。
* 敏感信息处理：从一段长文本中提取并清理出邮箱、电话和 API Key。
* 二维码生成：将任意文本或 URL 转换为二维码图片。
* 时间处理：将东八区的时间转换为纽约时间。
* 截图：获取指定网页的完整截图。
成本与隐私¶
- 计费：大多数工具为 $0.001/次。
sql_from_description为 $0.01/次，screenshot_url为 $0.003/次。失败调用不收费。 - 数据保留：文档和提示词仅在内存中处理，不会被存储或持久化。
- 权限：无需任何凭证即可使用免费额度。可选的 AllRouter Key 仅在请求头中传递，不会存储。
兼容性与运行环境¶
- 运行时：依赖 dsh v0.1 developer preview (Cordis v4)。仅依赖
@deepseek-ai/dsh-mcp-client。 - 本地执行：无。插件不包含任何工具代码，不构建本地二进制文件，不包含生命周期脚本。
- 文件系统：无访问权限。
- Shell/进程：无访问权限。
- 网络访问：仅允许出站 HTTPS 到
ainetcafe.com。
总结¶
dsh-devkit 适合需要在智能体工作流中集成格式转换、文本处理、SQL 操作或截图功能的场景。它通过服务端操作解决了本地执行受限的问题，同时保证了极高的确定性和较低的成本。
