dsh-plugin-sirchmunk

dsh plugin --profile web add dsh-plugin-sirchmunk

dsh-plugin-sirchmunk

DSH 原生 Sirchmunk 只读知识图谱插件 / DSH-native read-only Sirchmunk knowledge graph.

1.1.0 adds an independent graph page, authenticated Host reads, center-layout style controls, node details and current-view export. See [release notes](<CHANGELOG.md>) and [third-party licenses](<THIRD_PARTY_NOTICES.md>).

中文

本版功能

• 左侧顶部面板区提供独立“知识图谱”入口；设置中的图谱标签复用同一页面。
• relation-graph 3.1.2 中心布局：暖色内置圆形/矩形节点，淡灰直线/折线/曲线，普通/沿线关系文字；浮层可移动和折叠，支持间距倍数及各层间距。
• 名称/ID关键词只筛选本次已加载集合；点击节点读取真实知识概述与脱敏证据。节点短标题仅用于显示，不改原始名称。
• 关系按来源、无向端点对和类型分组，保留各原始记录及权重，不平均、不添加方向。没有关系时圆形分散展示，不补造中心节点或连线。
• 当前过滤集合可导出JSON、SVG；浏览器编码能力可用时可导出PNG。图片取实际当前布局坐标，不是屏幕裁剪，也不保证逐像素复制网页样式；JSON保留完整原文。
• 内置 sirchmunk-search 技能。执行检索需要另行连接 Sirchmunk MCP Server；本包不会安装服务端，也不会自动配置MCP连接或凭据。

边界：本版图谱只读，不修改/删除知识数据；全量导出不可用。偏好及拖拽位置只在当前页面生效，不保存。不新增 Agent 图谱工具或 better-sidebar 右侧集成。保留的聚类管理、历史、监控、隐私设置标签仍含旧示例适配器，不属于已验收生产能力。

安装 / 更新

在 DSH Desktop 插件管理界面安装或更新 npm 包 dsh-plugin-sirchmunk@1.1.0（须该版本已发布）。由宿主插件管理器处理 Profile 安装；不要手动编辑 Profile 的package依赖。按管理器收据重启或重新加载，随后完整刷新内嵌页面。

插件遵循 Cordis Host/Client 双入口：Host提供认证GET查询，Client通过Slots注册侧栏/主面板/设置页；复用DSH的React/ReactDOM，不另建React应用或服务器。

服务及读取授权

1. 本版图谱仅支持既有本机 http://127.0.0.1:8584 Sirchmunk，需有以下接口：

• GET /api/v1/knowledge/graph
• GET /api/v1/knowledge/clusters/{id}

2. 公共安装默认 graphReadGranted: false。安装本身不表示同意读取本机知识。本人核验服务、对象范围及隐私风险后才将插件行的此配置设为true；撤回时改回false并重新应用配置。不会继承开发者的本机授权。

3. 可在本人维护的独立本地 Cordis bundle 中覆盖本插件行的完整config（由DSH插件管理器安装该本地bundle，不放进公共npm包）：

   - id: sirchmunk
     name: dsh-plugin-sirchmunk
     config:
       graphReadGranted: true

此配置仅授权本机固定来源API返回范围，不授予管理员或全量导出。本人撤回时将true改为false并重新应用。先安装主插件，再应用覆盖；本包不包含任何私有授权覆盖。

4. 后端若要求Token，通过DSH Host凭证服务提供 SIRCHMUNK_API_TOKEN；不要在浏览器、上述YAML或公共包中填写Token。不要把DSH登录Cookie/聊天Token当后端凭据。

5. 服务/来源未获准、登录失效或API不可用时页面明确降级。插件不提供任意服务URL代理；图谱和详情不绕过Host认证。

兼容性与已知限制

• Host Node.js >=20；源码测试需要支持TypeScript stripping的Node.js 24。
• 依赖宿主 connection.fetch.register / connection.admit、Client main/sidebar.panellist/settings.section、locale/theme。已使用本机DSH Desktop 2.0.17及React18.3.1联调，不保证缺少上述API的旧宿主兼容。
• 本地自动测试61项、类型检查与生产构建通过。用户已验证真实7节点及详情；最新样式版的深色主题、实际PNG下载、有关系大图及其他平台仍需验证。当前真实数据0关系，不能用它验收多重边/沿线文字视觉。
• 图谱以单次返回范围为准，不能宣称已加载全部知识库；大规模布局及图片导出存在上限，失败不交付假格式或部分产物。

开发与打包

在源码仓库中执行（不是在DSH Profile目录）：

npm ci --ignore-scripts --registry=https://registry.npmjs.org
npm test                  # Node 24
npm run build             # 显式执行本项目构建，包含类型检查
npm pack --ignore-scripts # 打包已核验产物，不运行prepack

构建产物为 lib/index.js（Host ESM）与 lib/client.js（DSH module-loader包装的Client）。普通 npm pack 的prepack会重建，需完整源码及构建依赖；建议发布经过审计的tgz归档。无需Vite替代服务器，单独启动开发服务不会更新现有Desktop GUI。

发布由维护者在官方registry执行；不使用cnpm只读镜像。不要把私有deployment、附件、凭据、node_modules或开发测试数据打入包。

English

What ships

An independent top-sidebar Knowledge graph page with authenticated, fixed-loopback Host reads, local filtering, center layout/style controls, real node details and masked evidence. It preserves undirected relation groups and individual raw weights; edgeless datasets contain no invented hubs or links. The sirchmunk-search skill requires a separately connected Sirchmunk MCP server.

Node/line styling, layout center, panel dragging and spacing are view-only. Current-view JSON/SVG and capability-gated browser PNG exports use the complete filtered dataset, not a viewport crop. Image export is a semantic graph, not a pixel-perfect screenshot. Full export and knowledge mutations are not provided. Legacy non-graph management/settings adapters remain examples.

Installation and consent

Install dsh-plugin-sirchmunk@1.1.0 through the DSH plugin manager after npm publication. Follow its restart/reload receipt and refresh the existing page. React/ReactDOM are supplied by DSH.

The graph source is fixed to http://127.0.0.1:8584. Public installs default to no read grant. The human operator must review the local service and authorize graphReadGranted in their own plugin configuration/local override; consent and credentials are not bundled. Optional backend authentication uses the Host credential reference SIRCHMUNK_API_TOKEN, never Client tokens or a public YAML secret.

The Host requires native connection authentication/routing APIs; the Client requires the standard main/sidebar/settings slots. Local verification used Desktop2.0.17 and React18.3.1. Automated tests do not certify cross-platform GUI rendering, dark theme, large real graphs or PNG download. Use Node24 for tests and Node>=20 for Host runtime.

Build

From the source checkout: npm ci --ignore-scripts, npm test, npm run build, then npm pack --ignore-scripts. The published package includes prebuilt Host/Client bundles, skill, public patch, README, changelog and third-party licenses; it excludes private consent configuration. No separate server is needed. Maintainers publish the audited archive to https://registry.npmjs.org themselves.