前言¶

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