前言¶
在 DeepSeek Harness（DSH）裏和模型對話時，若業務知識、聲明、常駐智能體章程和記憶工件都在 Onto 側維護，常見做法是手動複製粘貼，或在聊天裏反覆讓模型調 MCP 工具查 realm、記憶和對象。上下文容易混在同一條會話裏，換空間或換聊天后也不清楚當前到底掛了哪些材料。
dsh-onto-space-panel 由 hope4b 維護，面向已使用 Onto 與 Harness 的開發者：在輸入框上方提供緊湊的空間選擇器，並用側欄集中查看聲明、常駐智能體、記憶工件、模板與對象，把選中項顯式掛到當前聊天；活躍上下文會顯示在 composer 上方，且按聊天、按所選 realm 分別保存。
這是什麼¶
插件全名對應倉庫 hope4b/dsh-onto-space-panel（npm 包名 dsh-onto-space-panel，當前發佈版本 1.2.1，MIT 許可證）。它不改變 Harness 核心，而是在 Web 端注入 UI，並通過 Onto MCP 讀取空間與實體；選中 resident agent 是爲當前 Harness 對話賦予角色並加載其章程與 constitution，不會單獨拉起外部 agent 進程或 broker。
界面文案目前爲俄語（如側欄 Обзор、掛上下文 В контекст）；空間與實體的名稱、描述來自 Onto 服務端。
核心功能¶
下面能力均來自項目 README，且依賴 MCP 暴露對應工具（見後文「要求與 MCP 工具」）。
- 連接 Onto：首次使用可填 MCP endpoint 與 API key 並校驗；若 profile 裏已有名爲
onto的 Harness MCP 連接，則自動複用。 - 空間選擇與側欄：搜索並選擇可用 Onto space；用 Обзор 打開空間面板。
- 聲明（declarations）：讀取當前/已接受的空間聲明，並掛到聊天。
- 常駐智能體（resident agents）：查看 agent 與其 charter；選擇有效的 active resident 時，將其已接受的 charter 與 constitution 載入當前聊天。
- 記憶工件（memory artifacts）：搜索、分頁瀏覽已接受的記憶，讀取內容，顯式 attach 或 disconnect。
- 模板與對象：瀏覽 templates 與 objects，將選中 object 納入對話。
- 按聊天隔離上下文：不同聊天、不同 realm 的選擇與上下文分開保存。
- 模型工具：用戶提出換空間或改上下文時，可通過
select_onto_space、configure_onto_chat_context調整。
環境與要求¶
- DeepSeek Harness 的 Web UI 或 Desktop 應用。
- Onto MCP endpoint URL 與個人 API key，或已認證的 Harness MCP 連接
onto。 - 首次使用引導表單需要 Harness 可寫的 credential provider；標準本地 profile 常用
@deepseek-ai/dsh-credentials-local。 - 與 Host 的集成在 DeepSeek Harness 0.2.0-rc.2 上開發驗證；其他版本未聲明兼容。Harness 處於開發者預覽，擴展接口可能變動。
- 插件
package.json要求 Node >= 22（主要影響開發與打包環境；安裝 release 包時通常由 Harness 加載已構建的 browser bundle）。
MCP 連接需至少提供以下工具，面板各區塊才完整可用：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。
安裝與啓用¶
安裝或替換 bundle 後需重啓 Harness。若曾用 cordis.patch.yml 絕對路徑手動加載同一插件，應先禁用舊條目，避免兩套實例註冊相同工具與 API 路由。
從 release 安裝 tgz¶
在 Releases 下載 .tgz，對支持 Web 的 profile 執行：
dsh plugin --profile web add ./dsh-onto-space-panel-1.2.1.tgz
從 GitHub 標籤安裝¶
倉庫已包含構建好的 browser 入口，無需安裝期 build：
dsh plugin --profile web add github:hope4b/dsh-onto-space-panel#v1.2.1
Desktop 可在 Plugins 中安裝下載的 bundle（視版本支持而定）；tgz 內已含 browser bundle，不需要額外 build 權限。
連接 Onto MCP¶
推薦：首次使用嚮導¶
- 安裝插件並重啓 Harness。
- 在 composer 上方點擊 Onto → Подключить。
- 填寫 MCP endpoint URL 與個人 API key，點擊 Подключить。key 字段只需值；若粘貼整行
X-Onto-Api-Key: value，插件會去掉 header 名再存儲或發送。 - 插件用
list_available_realms校驗通過後保存；再從列表選 space。列表爲空表示連接成功但無可見 space。
endpoint 與 key 向 Onto 管理員索取。表單走 HTTPS 與 X-Onto-Api-Key；開發可用 localhost HTTP。URL 須爲直接 MCP endpoint，不能帶憑證或 query，且不接受認證重定向。
密鑰經 Harness credential provider 存儲（非插件配置、非瀏覽器 storage、非聊天記錄）。標準本地 provider 下，託管文件爲 $DSH_HOME/.credentials.yaml；服務器地址與憑證引用在 $DSH_HOME/storages/onto-connections/（按 profile 位置區分）。插件啓動時會自行恢復 MCP 連接，不修改 profile YAML。
在 space picker 打開 Подключение，或在側欄 Подключение Onto，可更新由插件創建的連接。endpoint 不變且 key 留空時複用已存 key；更換 endpoint 或賬號 key 後需重新選 space 並掛上下文，舊聊天上下文不會自動遷移到新連接。
備選：手動配置 Harness¶
適用於集中管理 MCP、或無可寫 credential provider 的部署。若 profile 已有 Onto 連接，不要重複添加。
- 向管理員索取 MCP endpoint URL 與個人 API key（不是普通 Onto 網站 URL）。
- 編輯當前 profile 的
cordis.patch.yml（Web 常見路徑~/.dsh/profiles/web/cordis.patch.yml；Windows Desktop 爲%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml；DSH_HOME會改變.dsh位置）。 - 追加或更新 patch，
serverName必須爲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
- 在啓動 Harness 的進程環境中設置
ONTO_API_KEY。例如 Windows Web：
$env:ONTO_API_KEY = 'YOUR_PERSONAL_API_KEY'
dsh --profile web
Desktop 需完全退出後再從同一 PowerShell 啓動可執行文件，快捷方式不會繼承僅在該窗口設置的變量。
- 打開 composer 上方的 space 選擇器，應能看到可訪問的 space；也可在聊天中讓模型調用
mcp__onto__list_available_realms。
連接失敗時先查 endpoint 與網絡；401/403 多爲認證或權限。聊天裏工具可用但面板找不到時，檢查 serverName 是否爲 onto。
典型用法¶
經過安裝與連接後，可按下面順序操作（UI 爲俄語，含義如下）。
- 在 composer 上方選擇 Onto space。
- 點擊 Обзор 打開該 space 的側欄面板。
- 在面板中查看聲明、resident agents、記憶、模板與對象；需要納入本輪對話時，使用 В контекст 掛聲明或記憶工件。
- 已掛上的角色或材料會出現在上下文標籤旁；點擊標籤旁的
×可移除。 - 換聊天或換 realm 時，選擇會按會話隔離；需要時可讓模型調用
select_onto_space或configure_onto_chat_context。
適用場景與注意¶
適合誰：已在 Onto 中維護 space、聲明、resident agent、記憶與對象，並在 DSH Web/Desktop 中希望「看得見、選得着、按聊天掛上下文」的團隊或個人。
權限與安全：插件與當前 DSH 進程同權限運行；安裝前應閱讀倉庫源碼與 MIT 許可證，確認 endpoint、API key 與 $DSH_HOME 下憑證存儲策略符合本機與組織要求。勿將真實 key 提交倉庫或分享含 key 的終端歷史。
生態說明：DSH 社區插件目錄（如 SkillHub 上的條目）由社區維護，與 DeepSeek / 幻方無官方從屬關係；本文安裝命令與行爲以 GitHub README 爲準。
結尾¶
dsh-onto-space-panel 把 Onto 的空間導航、聲明、常駐智能體章程、記憶與對象選擇收進 Harness 輸入區與側欄，並保留按聊天、按 realm 的上下文隔離。需要細節、release 與 issue 時，見目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/hope4b/dsh-onto-space-panel
- GitHub：https://github.com/hope4b/dsh-onto-space-panel
