dsh-runtime-nutrition-label：DeepSeek Harness 運行時營養標籤插件

前言¶

在 DeepSeek Harness (DSH) 的開發實踐中，區分插件聲明的能力與實際運行時產生的行爲是安全與合規的基礎。插件作者可能聲明支持網絡訪問或文件寫入，但當前進程窗口內並未觸發這些操作。dsh-runtime-nutrition-label 插件旨在解決這一信息不對稱問題，通過觀察 DSH 工具和文件系統的事件接縫，生成包含聲明、觀察和推斷證據的 JSON 快照。

是什麼¶

這是一個社區維護的插件，爲 DeepSeek Harness 的插件和工具命名空間提供基於證據的運行時“營養標籤”。它將作者或部署者的聲明與實際觀測到的指標分離，幫助開發者確認插件在當前會話中的真實行爲模式。該插件使用 MIT 許可證。

核心功能¶

插件主要包含以下能力：

能力聲明與觀測：支持網絡、憑證、子進程、持久性、域等能力的聲明，並收集實際調用的成功/失敗統計。
指標採集：
- 工具指標：記錄 schema 字節數、調用次數、成功率、失敗率、持續時間統計。
- 文件系統指標：記錄讀寫次數、唯一目標數量，並提供隱私控制的路徑樣本。
網絡掃描：僅掃描 HTTP(S) URL 中的主機名，不記錄完整 URL、查詢參數、片段或憑證。
證據記錄：提供包含聲明、觀測和推斷來源的有界證據記錄。
自動集成：通過 dsh.bundle 補丁自動集成到指定 Profile 並掛載服務與命令。

安裝與啓用¶

通過 DSH 命令行安裝插件到指定 Profile：

dsh plugin --profile web add dsh-runtime-nutrition-label

安裝後，插件會自動將自身添加到 dsh.profile.bundles，並掛載 ctx.runtimeNutritionLabels 服務和 /nutrition-label 命令。默認情況下，未配置屬性的工具有效標籤爲 unattributed。

典型用法¶

1. 配置屬性映射¶

在 Profile 的 cordis.patch.yml 中覆蓋 runtime-nutrition-label 行，明確指定插件 ID、工具前綴及其能力聲明和副作用分類：

- id: runtime-nutrition-label
  config:
    plugins:
      - id: mcp-github
        displayName: GitHub MCP
        tools:
          prefixes:
            - mcp__github__
        declared:
          network: true
          credentials: true
          domains:
            - api.github.com
        effects:
          - prefixes:
              - mcp__github__create_
              - mcp__github__merge_
            effect: write

2. 查看快照¶

通過 /nutrition-label [plugin-id] 命令或 API 獲取快照：

/nutrition-label

在代碼中調用：

ctx.runtimeNutritionLabels.snapshot()
ctx.runtimeNutritionLabels.snapshot('mcp-github')

快照包含 ISO 時間戳、單調遞增的 revision、配置的聲明、觀測到的聚合指標以及有界證據記錄。

適用場景與注意¶

隱私優先模型：插件不存儲原始工具參數、原始結果、文件內容或憑證值。網絡掃描僅保留主機名，文件樣本默認爲 omit。
本地診斷：證據記錄有上限，旨在用於本地診斷，而非長期審計存檔。
依賴運行時對等項：由於當前公共 DSH 依賴圖不完整，插件需要特定的 DSH 運行時對等項（如 dsh-tools, dsh-fs 等）才能正常工作。
非官方維護：這是一個社區維護的包，並非 DeepSeek AI 官方組件。在集成前應檢查源碼與許可證。

短結尾¶

該插件通過將聲明與事實分離，爲 DSH 插件的運行時行爲提供了可觀測的骨架。通過 /nutrition-label 命令或 API，開發者可以快速驗證插件在當前會話中的權限使用情況與行爲模式。

GitHub 倉庫: https://github.com/biubiukam/dsh-runtime-nutrition-label
社區目錄: https://www.skillhub.cn/plugins/biubiukam/dsh-runtime-nutrition-label