Onto 空间面板 hope4b/dsh-onto-space-panel

适用于 DeepSeek Harness 的 Onto 空间面板

一个紧凑的 Onto 空间选择器，外加侧边面板，用来管理声明、常驻智能体、记忆产物、模板和对象。选择要放进当前聊天的内容；活动上下文始终显示在输入框上方。

功能

- 首次使用时连接 Onto：填入 MCP 端点和 API key，验证访问权限，然后选择空间。已有的 Harness 连接会自动复用。
- 搜索并选择可用的 Onto 空间。
- 用 Обзор 打开空间面板。
- 读取已接受/当前的 space 声明，并把它附加到聊天。
- 查看常驻智能体及其章程。选中有效的活动常驻智能体后，会把其已接受的章程和宪法加载到当前聊天。
- 搜索并翻页浏览已接受的记忆产物，读取内容，并显式附加或断开它们。
- 浏览模板和对象，然后把选中的对象加入对话。
- 每个聊天、每个选中的 realm 各自保留独立的选项和上下文。
- 用户提出要求时，通过 select_onto_space 和 configure_onto_chat_context 模型工具切换上下文。

界面目前是俄语。名称和描述由 Onto 提供。选中智能体会给当前 Harness 对话赋予常驻角色；它不会启动单独的智能体进程或外部智能体代理。

要求

- 带 Web UI 或桌面应用的 DeepSeek Harness。
- 你的 Onto MCP 端点 URL 和个人 API key，或者一个已认证、名为 onto 的现有 Harness MCP 连接。
- Harness 可写的凭据服务商，用于首次使用的设置表单。标准本地配置档使用 @deepseek-ai/dsh-credentials-local。
- 连接必须暴露 list_available_realms、about_realm、list_realm_agents、get_realm_agent、search_memory_artifacts、get_memory_artifact、get_memory_artifact_by_path、search_templates、search_objects 和 get_entity，才能支持各自的面板功能。

宿主集成是针对 DeepSeek Harness 0.2.0-rc.2 开发的。其他版本尚未验证。Harness 处于开发者预览阶段，其扩展接口可能变化。

安装发布版 tarball

从项目的 release 下载 .tgz 包，安装到支持 Web 的配置档。例如：

dsh plugin --profile web add ./dsh-onto-space-panel-1.2.1.tgz

发布版下载：https://github.com/hope4b/dsh-onto-space-panel/releases

你也可以安装打了标签的 GitHub 源码，其中已经包含构建好的浏览器入口，且没有安装时构建脚本：

dsh plugin --profile web add github:hope4b/dsh-onto-space-panel#v1.2.1

在桌面端，如果你的版本支持，用 Plugins 安装下载好的 bundle。tarball 已包含浏览器 bundle；不需要安装时构建脚本，也不需要额外的构建权限。

如果这个插件之前是通过绝对路径行手动加载的 cordis.patch.yml，先禁用旧的那一行，再启用打包好的 bundle。
不要同时跑两份：它们会注册相同的工具和 API 路由。

安装或替换 bundle 后，重启 Harness。在输入框上方选择一个 Onto 空间，按 Обзор 打开它的面板。用 В контекст 附加声明或记忆产物。想移除角色或素材，点它上下文标签旁边的 ×。

连接 Onto MCP

首次使用配置（推荐）

1. 安装插件并重启 Harness。
2. 点输入框上方的 Onto → Подключить。
3. 填入你的 MCP endpoint URL 和个人 API key，然后按 Подключить。key 字段只填值。粘贴一整行 X-Onto-Api-Key: value 也可以：插件会在发送或存储前去掉 header 名。
4. 保存前，插件会用 list_available_realms 检查访问权限。成功后，从列表里选一个空间。列表为空说明连接正常，但没有返回可访问的空间。

endpoint 和 key 找你的 Onto 管理员要。表单走 HTTPS 和 X-Onto-Api-Key header；开发时支持 localhost HTTP。它要求直连 MCP endpoint，URL 里不能带凭据或查询参数。认证重定向会被拒绝。

连接属于当前活跃的 Harness 配置档。key 通过 Harness 的 credential provider 存储，不放在插件配置、浏览器存储或聊天消息里。用标准本地 provider 时，托管的凭据文件是 $DSH_HOME/.credentials.yaml。这是本地凭据存储，不代表操作系统钥匙串加密。服务器地址和凭据引用存在 $DSH_HOME/storages/onto-connections/ 下，按配置档位置作为键。插件启动时会恢复自己的 MCP 连接，不需要改配置档 YAML。

想更新插件创建的连接，打开空间选择器里的 Подключение，或侧边面板里的 Подключение Onto。只有 endpoint 不变时，留空 key 才会复用已保存的 key。改 endpoint 或账号 key 后，需要重新选空间、重新附加上下文；旧的聊天上下文不会自动套用到新连接。

如果 Harness 已经提供了名为 onto 的服务器，插件会复用它并跳过引导。那些外部设置仍由 Harness 管理；面板不会覆盖或迁移该连接。已配置但不可用的连接会显示为已配置，加载空间时报错。

手动配置 Harness（备用）

当你的部署集中管理 MCP，或没有提供可写的 credential provider 时，用这个方式。如果配置档里已经有 Onto 连接，不要再加第二个。

1. 找你的 Onto 管理员要 Onto MCP endpoint URL 和个人 API key。用 MCP endpoint，不要用普通的 Onto 网站 URL。
2. 打开当前活跃配置档的 cordis.patch.yml：通常在 ~/.dsh/profiles/web/cordis.patch.yml（Web 端），或者 Windows Desktop 端用 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml。
自定义 DSH_HOME 会改变 .dsh 的位置。
3. 追加下面的补丁，替换掉占位 URL。如果已经存在 Onto 条目，更新它，不要重复创建。服务器名必须严格为 onto。

- insert:
- id: mcp-onto
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: onto
transport: streamable-http
url: https://YOUR-ONTO-MCP-HOST/mcp
headers:
X-Onto-Api-Key: !!js process.env.ONTO_API_KEY

这个示例用的是 Onto 的 X-Onto-Api-Key 请求头。如果你的部署方式不同，请找服务器管理员确认认证方案。
副本见 examples/onto-mcp.patch.yml。

4. 在启动 Harness 的进程环境里设置 ONTO_API_KEY。
Windows 上的 Web 端，从同一个 PowerShell 窗口启动：

$env:ONTO_API_KEY = 'YOUR_PERSONAL_API_KEY'
dsh --profile web

Windows Desktop 端，先完全退出 Harness，设置上面的变量，然后从同一个 PowerShell 窗口启动可执行文件。默认安装位置：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\DeepSeek Harness.exe"

通过已有的桌面快捷方式启动，不会继承只在这个 PowerShell 窗口里设置的变量。每次启动都必须能读到这个变量。
在本地填入真实密钥；不要提交它，也不要分享包含它的终端历史。

5. 打开输入框上方的空间选择器。你有权访问的空间应该会出现。你也可以让模型调用 mcp__onto__list_available_realms。

如果连接失败，先检查端点和网络访问。返回 401 或 403 通常说明认证或访问权限有问题。如果工具在聊天里能用，但面板找不到它们，检查 serverName 是否为 onto。
缺少智能体或记忆工具会分别影响对应区块；列表为空也可能说明你的账号无权访问这些资源。

传输方式和环境变量语法遵循官方 Harness MCP client configuration。

隐私与上下文

插件通过 Harness 的 MCP 客户端发起只读 Onto 调用。
它不会发布 Onto 数据，也不会执行产物生命周期变更。
附加的文档会作为上下文发送给 Harness 聊天所用的模型。

选择项和文档快照会持久化在本地：

$DSH_HOME/storages/onto-space-selections/
$DSH_HOME/storages/onto-chat-contexts/

未设置 DSH_HOME 时，使用通常的 ~/.dsh 主目录。上下文目录里存放你附加文档的副本。它不属于分发包的一部分。上下文变更做了防护，可避免过期修订和 realm 切换带来的问题。
缺失的声明、不可用的智能体治理和空记忆集合都会明确显示。不可用的常驻项无法选中。已连接的素材是附加时的快照，不会实时同步它们后续的修订。

本地打包

已检入的 client.js 可直接加载，因此打包无需编译：

npm run check
npm pack

从源码检出运行合成公开测试，用 npm test。

这个包在宿主端使用 Node 内置模块，在浏览器端使用 Harness 的共享 React 运行时。它自身没有运行时依赖，也没有安装脚本。

验证

开发检查覆盖了真实的 Onto 响应格式、声明读取、常驻项校验与已接受的治理加载、记忆列表/正文读取、上下文投影、持久化、按聊天/按领域隔离、过期修订，以及附加过程中的领域切换。浏览器检查覆盖了空间选择、面板导航、上下文附加，以及会话之间的隔离。

私有示例数据和开发夹具不包含在此次发布中。

许可证

MIT。这是社区集成，不是 DeepSeek 官方产品。