dsh-connect

Configuration

Configuration lives in the DSH profile patch (cordis.patch.yml) under each plugin's config:. dsh.shared.config.json in the project root (or its parent) can supply workspace/state defaults that take precedence for those keys.

dsh-connect (core)

Key	Default	Description
agentPreset	roster default	Agent preset id composed into each bound session
workDir	process cwd	Absolute working directory for each bound agent
workspaces	[]	Extra workdirs offered by the /dir picker
visionModel	auto-detected	{ provider, model } used to describe images when the main model can't see them
language	zh	User-facing message language: zh / en
allowUsers	[]	Sender allowlist (open_id). Empty = allow all
allowChats	[]	Chat allowlist (chat_id). Empty = allow all
stateDir	.dsh-connect	Directory holding the bindings.json route store (env DSH_CONNECT_STATE_DIR overrides)
autoMirror	true	Automatically create a Web GUI mirror for every new session
streamHeartbeatMs	60000	Liveness heartbeat interval (ms) for the streaming card; 0 disables it
notifyLevel	important	Default notification level: full (stream everything) / important (key milestones) / result (answer only); per-chat override via settings menu or /notify
progressTimeoutMs	300000	Proactive progress-notice interval (ms): when a turn has sent no standalone card/text for this long, a status card reports the latest milestone; 0 disables; per-chat override via settings menu or /progress

dsh-connect-feishu (adapter)

Key	Default	Description
appId	env FEISHU_APP_ID	Feishu custom app id (secret)
appSecret	env FEISHU_APP_SECRET	Feishu custom app secret (secret)
transport	websocket	websocket = long connection (no public network); webhook needs public HTTPS
verificationToken	—	Webhook verification token (secret)
encryptKey	—	Webhook encrypt key (secret)
requireMention	true	Groups only respond when the bot is @mentioned
dmMode	open	DM policy: open / allowlist / pair / disabled
language	zh	User-facing message language: zh / en

Environment variables

Variable	Purpose
FEISHU_APP_ID / FEISHU_APP_SECRET	Feishu credentials — preferred over putting secrets in config files
DSH_CONNECT_STATE_DIR	Overrides stateDir for the binding store
DSH_HOME	Overrides the ~/.dsh base for credential files

Sensitive items — appSecret, verificationToken, encryptKey, and feishu-credentials.json. Prefer environment variables or one-click onboarding; keep them out of version control.