前言¶

DeepSeek Harness（DSH）在默認狀態下缺乏持久化工作區配置、完整的資源讀取權限以及與外部模型目錄的同步機制。開發者通常需要手動維護這些環境。better-basicfun 旨在通過一個可安裝的插件包，填補這些 host-side（主機端）的基礎功能缺口。

插件介紹¶

better-basicfun 是一個 Native DSH default workspace with complete paged read-only access to plugins, skills, memory, sessions, storage, settings, credentials, and DSH_HOME files。

• 所有者：CDeZT
• 分類：客戶端
• 許可證：MIT

核心功能¶

該插件主要提供以下能力：

1. 默認工作區註冊：創建並註冊 $DSH_HOME/workspace 作爲默認 Workspace。
2. 文件初始化：創建 AGENTS.md、MEMORY.md 和 .dsh/skills/ 目錄，且不會覆蓋用戶已有的文件。
3. 持久化內存：爲默認 Workspace 中的會話加載持久化內存。
4. 資源訪問工具：添加只讀的 dsh_resources 工具，支持查看 plugins、skills、memory、sessions、storage、settings、credentials 以及 $DSH_HOME 下的文件。
5. CLIProxyAPI 目錄橋接：同步主機端的 CLIProxyAPI rich model catalog，使 DSH 原生選擇器能夠接收動態的能力元數據。

安裝與啓用¶

通過 DSH Desktop 的命令行接口安裝插件包。安裝完成後需重啓 DSH Desktop。

& "$env:APPDATA\DSH Desktop\host-commands\desktop\bin\dsh.cmd" plugin --profile desktop add "C:\path\to\better-basicfun-1.3.0.tgz"

CLIProxyAPI 目錄橋接¶

該插件充當主機 CLIProxyAPI 與 DSH 原生設置之間的橋樑，用於同步模型目錄。

同步流程：
1. 主機 CLIProxyAPI 返回 rich models[] 目錄（通過帶 client_version=pi 的 GET 請求）。
2. 插件解析目錄並映射爲 DSH 格式的模型列表。
3. 將能力數據寫入 llm-pi-ai 設置及原生 DSH 模型/推理選擇器。

注意：
* 推理保持直接連接：DSH → 配置的 CLIProxyAPI Base URL → 模型服務。
* 插件不猜測模型能力；推理級別（如 ultra）僅根據遠程目錄映射。
* 默認每 15 分鐘刷新一次，並在啓動時以及 llm-pi-ai 或 API 密鑰變更時刷新。

示例配置：
在 DSH 的 Provider 設置中，使用真實的 CLIProxyAPI 推理 URL 配置自定義 Provider。插件僅同步目錄，不代理推理。

llm-pi-ai:
  providers:
    cliproxyapi:
      displayName: CLIProxyAPI
      apiKeyEnv: CLIPROXYAPI_KEY
      api: openai-responses
      baseURL: http://127.0.0.1:8317/v1
      models:
        - id: placeholder

注意：DSH 目前無法保存沒有任何模型的自定義 Provider。在初始設置時，必須使用 DSH 的“獲取可用模型”操作並至少選擇一個結果後再保存，無需手動編寫佔位符。插件會在 Provider 保存后豐富模型列表。

配置¶

默認配置無需手動干預。以下爲覆蓋配置的示例：

- id: better-basicfun
  config:
    workspacePath: 'D:\DSH\Default'
    title: 'Default workspace'
    pinFirst: true
    memoryMaxBytes: 32768
    defaultListLimit: 50
    defaultContentLimit: 32768
    maxBinaryReadBytes: 67108864
    cliProxySync: true
    cliProxyProbeAllCustomProviders: true
    cliProxyRoutes: []
    cliProxyRefreshMinutes: 15
    cliProxyRequestTimeoutMs: 10000

使用 cliProxyRoutes: [cliproxyapi] 可限制探測僅針對命名路由。

適用場景與注意事項¶

適用場景：
* 需要一個穩定的、默認的 Workspace 來管理智能體會話。
* 需要模型通過只讀工具訪問系統資源和配置（需注意安全性）。
* 使用 CLIProxyAPI 作爲推理後端，希望 DSH 能自動獲取最新的模型目錄。

重要提示：
* 安全性：該插件故意將敏感的 DSH 數據暴露給模型。dsh_resources 可以返回未脫敏的設置、解析後的憑證、完整的會話以及 $DSH_HOME 下的文件。請務必在安裝前閱讀 SECURITY.md。
* 權限範圍：Workspace 路徑爲 $DSH_HOME/workspace，不會將 $DSH_HOME 的寫權限授予 Workspace，從而保護私有 DSH 狀態不被意外修改。
* 獨立性：這不是 Codex 插件，不讀取 ~/.codex，不注入或修改 DSH 前端代碼，也不代理推理。DSH 的原生模型和推理選擇器保持權威地位。

總結¶

better-basicfun 通過提供默認工作區初始化、只讀資源發現工具以及 CLIProxyAPI 目錄同步，增強了 DSH 的基礎功能。它讓開發者能夠更安全地管理本地智能體環境，同時保持 DSH 原生推理路徑的獨立性。

• 源碼：https://github.com/CDeZT/better-basicfun
• 社區討論：https://github.com/deepseek-ai/deepseek-harness/discussions/5344