前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。当插件列表逐渐丰富后,开发者常面临两个具体问题:安装的插件是否真的被加载并运行?如何找到公开的评估板进行基准测试?@trapstreet/dsh-trapstreet 旨在解决这两个问题。
这是一个联网工具,由开发者 trapstreet 维护,开源协议为 MIT。它不需要你手动排查配置,而是直接读取 Harness 运行时的内部状态,并对接公开的评估数据。
安装与依赖¶
安装前,请确保环境满足以下依赖项:
@deepseek-ai/cordis@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools
安装命令如下:
dsh plugin --profile <name> add @trapstreet/dsh-trapstreet
也可以跳过 npm,直接从 GitHub 添加:
dsh plugin --profile <name> add github:trapstreet/dsh-trapstreet
注意:安装目录路径可能导致依赖解析失败,建议使用 tarball 打包方式安装。
核心功能¶
该插件提供了两个主要工具和一种分类能力。
1. trapstreet_checkup:本地插件状态检查¶
trapstreet_checkup 是一个无网络、无 API 密钥的工具。它直接读取 Harness 运行时的加载器树,列出已安装的插件条目及其激活状态。
它能发现那些“安装成功但未进入加载器树”或“加载器树中模块加载失败”的插件。通过传入 classify 参数,它还能根据社区目录(如 skillhub.cn)对插件进行分类,识别出会话型或编排型插件。
使用示例:
# 检查插件状态
trapstreet_checkup
# 检查状态并分类
trapstreet_checkup classify
2. trapstreet_boards:公开评估板查询¶
trapstreet_boards 需要网络连接,用于查找 trapstreet.run 上的公开评估板。这是一个只读操作,不涉及账号登录、API 密钥或启动运行。
它会列出评估板总数,并分类显示:包含 DeepSeek 基准的、未测试 DeepSeek 的、以及空的评估板。你可以通过传入板 ID 来获取详情,包括测试内容、代码版本以及哪些条目来自 DeepSeek 模型。
使用示例:
trapstreet_boards
配置项¶
插件支持以下环境变量配置:
TRAPSTREET_BASE_URL:API 主机地址,默认为https://trapstreet.run。TRAPSTREET_CALL_LOG:若设置该路径,每次工具调用都会追加一行日志到该文件,便于排查工具是否被模型正确调用。
注意事项¶
- 仅读取数据:
trapstreet_boards仅从trapstreet.run获取公开数据,不会启动任何运行或写入本地文件。 - 目录关系:社区目录(如 skillhub.cn)与 DeepSeek 官方或 Harness 本身无官方从属关系,仅作为资源索引。
- 安装方式:如前所述,安装目录路径可能导致依赖解析失败,务必使用 tarball 方式。
总结¶
@trapstreet/dsh-trapstreet 提供了从本地插件健康检查到远程评估板查询的完整链路。对于需要验证环境或寻找基准数据的开发者,这是一个务实的辅助工具。