前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在开发和管理智能体工作流时，开发者通常需要频繁查看知识图谱状态、管理集群资源以及监控运行指标。dsh-plugin-sirchmunk 是一个 DSH 原生 Web 插件，它直接向 DSH 的设置界面注入了一个名为 Sirchmunk 的区域。这个区域集中提供了知识图谱查看、集群管理、运行监控和隐私设置等功能，避免了在多个独立工具间切换的繁琐。
核心功能¶
该插件通过 DSH 的 settings.section 插槽注册，ID 为 sirchmunk，排序为 35。主要包含以下能力：
- 知识图谱展示与导出：在界面中可视化展示图谱节点，并支持将当前图谱导出为 JSON。
- 集群管理：列出集群列表。对删除等破坏性操作，插件增加了全局写权限开关和二次确认步骤，防止误操作。
- 运行时监控：通过适配层读取 Sirchmunk API 数据，实时显示 CPU、内存占用及服务运行时长。
- 共享历史：展示带时间戳的审计日志和活动记录，便于追踪系统状态变更。
- 隐私与脱敏：提供敏感数据脱敏开关、可配置的掩码关键词以及全局写操作权限控制。
- 内置 Agent Skill：提供名为
sirchmunk-search的标准技能。该技能允许 Agent 或用户通过 MCP 工具mcp__sirchmunk__sirchmunk_search检索本地文档库。支持对 PDF、Word、Excel、Markdown、代码等 100+ 种格式进行查询，并提供 FAST（快速匹配）、DEEP（深度分析）和 FILENAME_ONLY（仅文件名）三种模式。
安装与启用¶
在 DSH Host 使用的 Node.js 包环境中安装该插件：
npm install dsh-plugin-sirchmunk
安装完成后，必须重启 DSH Host。重启后，DSH 会应用 bundle patch 并加载浏览器模块，设置界面中会出现 Sirchmunk 区域。
实现细节¶
该插件遵循 DSH 的 Host/Client 分离架构：
- Host 入口：位于
lib/index.js，导出名称和apply(ctx)方法。 - Browser 入口：位于
lib/client.js，通过window.__ModuleLoader__.load注入。
React 和 ReactDOM 被声明为 peer dependency，由 DSH 运行时提供。浏览器构建中这两个包被标记为外部依赖，不会被打包进发布的客户端包中。
注意事项¶
- 依赖本地服务：当前 UI 界面通过本地 Sirchmunk 服务的健康检查端点
http://localhost:8584/api/v1/health获取状态。图谱、历史和监控数据通过src/services/api.ts中的适配层读取，后续可替换为生产后端而无需修改插件入口。 - Agent Skill 使用：内置的
sirchmunk-search技能依赖本地 Sirchmunk 服务运行，用于进行跨格式的本地知识检索。
