better-basicfun
An installable, cross-platform DSH bundle that fills a small set of missing host-side fundamentals: a persistent default Workspace, complete resource inspection, and synchronization of CLIProxyAPI's rich model catalog into native DSH Provider settings.
It is not a Codex plugin, does not read ~/.codex, does not inject or modify DSH frontend code, and does not proxy inference. DSH's native model and reasoning selector remains authoritative.
Source: https://github.com/CDeZT/better-basicfun · Release: https://github.com/CDeZT/better-basicfun/releases/latest · Community: https://github.com/deepseek-ai/deepseek-harness/discussions/5344
Features
- Creates and registers
$DSH_HOME/workspace as the default Workspace.
- Creates
AGENTS.md, MEMORY.md, and .dsh/skills/ without overwriting user files.
- Loads persistent memory for sessions in the default Workspace.
- Adds the read-only
dsh_resources tool for plugins, skills, memory, sessions, storage, settings, credentials, and files below DSH_HOME.
- Synchronizes CLIProxyAPI's rich model catalog on the host so DSH's native selector receives dynamic capability metadata.
- Contains no React dependency, DOM injection, frontend slider, or static model-name capability guesses.
This plugin deliberately exposes sensitive DSH data to the model. dsh_resources can return unredacted settings, resolved credentials, complete sessions, and files below DSH_HOME; tool results may be sent to the configured model provider. Read SECURITY.md before installing.
CLIProxyAPI native catalog bridge
Configure a DSH custom Provider with the real CLIProxyAPI inference URL. The plugin only synchronizes the catalog:
GET {baseURL}/models?client_version=pi
→ CLIProxyAPI rich models[] catalog
→ DSH models[] (id/name/contextWindow/maxTokens/input/reasoningEfforts)
→ llm-pi-ai settings
→ native DSH model/reasoning selector
Inference remains direct: DSH → configured CLIProxyAPI Base URL → model service.
Example:
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 currently cannot save a custom Provider with no models. During initial setup, use DSH's Fetch available models action and select at least one result before saving; no hand-written placeholder is needed. The bridge enriches the selected list after the Provider is saved.
The bridge refreshes at startup, after llm-pi-ai changes, after a relevant API key changes, and every 15 minutes by default. Plain OpenAI {"data": [...]} responses are ignored. Empty or failed responses never erase a working model list. API keys are resolved on the DSH host and sent only to the configured Provider catalog endpoint, never to the browser.
Enter only the normal inference Base URL, such as http://127.0.0.1:8317/v1. Do not append /models or ?client_version=pi; the bridge constructs the rich catalog URL itself.
Reasoning levels are mapped from the remote catalog only: none becomes DSH off; canonical levels remain unchanged; and ultra occupies DSH's current max position only when no real max is advertised. The bridge never guesses capabilities from model names. default_reasoning_level is not written because DSH currently has no safe equivalent per-model default field.
Install in 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"
Restart DSH Desktop after installation.
Workspace and permission boundary
The Workspace is $DSH_HOME/workspace; its skills are in .dsh/skills, while user-level skills remain in $DSH_HOME/skills. Profiles, sessions, storage, settings, and credentials stay outside the Workspace write boundary.
Do not use all of $DSH_HOME as a Workspace: workspace-write would then allow changes to private DSH state. This plugin provides read-only discovery through native host services without widening that boundary. No customSkillDirs change is needed.
dsh_resources supports overview, plugins, skills, memory, sessions, storage, settings, credential, cliproxyapi, list, and file. The cliproxyapi view reports synchronization status without returning credentials.
Configuration
Defaults require no configuration. Example override:
- 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
An empty cliProxyRoutes probes custom OpenAI-compatible Base URLs but only writes when a rich models[] response is recognized. Use cliProxyRoutes: [cliproxyapi] to restrict probing to named routes.
Uninstall
& "$env:APPDATA\DSH Desktop\host-commands\desktop\bin\dsh.cmd" plugin --profile desktop remove better-basicfun
Uninstalling leaves user-authored Workspace files, memory, and skills intact.
