@woosau/dsh-custom-env
DSH 插件：从“设置”管理 $DSH_HOME/.env
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @woosau/dsh-custom-env@0.1.10Custom Env 以 @woosau/dsh-custom-env 发布，当前版本为 0.1.10。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Community DeepSeek Harness plugin for managing environment variables in Settings → Environment. Not an official DeepSeek AI product.
Changes apply to the running app right away, and on Windows / macOS also to the user environment so new terminals can see them. Linux user-environment sync is not supported.
Requires DSH with the dsh CLI (desktop or web).
dsh plugin --profile desktop add @woosau/dsh-custom-env
# or: dsh plugin --profile web add @woosau/dsh-custom-env
# or: dsh plugin --profile desktop add github:ownduck/dsh-custom-env
If install fails because Desktop is locking files, quit Desktop first. After install, restart DSH and open Settings → Environment.
dsh plugin --profile desktop remove @woosau/dsh-custom-env
process.env / OS sync. .env stays NAME=value; group metadata is $DSH_HOME/.dsh-custom-env-groups.json. Create / rename / delete groups from the headers; move a saved row with Move to groupNAME=VALUE lines into an empty row to add or update several variables at once (same names overlay existing rows as drafts and keep their group)NAME=VALUE (input text selection still wins when present)process.env first; writing the user environment (registry / launchctl) is deferred via setImmediate into a child process and is not broadcast. Log off or reboot before other tools need those valuesdsh command into your user PATH (Windows / macOS)System-reserved names (such as PATH and names starting with DSH_ / XDG_) cannot be edited here.
| You save | Variable does not exist yet | Variable already exists |
|---|---|---|
| A non-empty value | Created | Replaced |
| An empty value | Created as empty | Left unchanged |
Call the Host customEnv service (ctx.get('customEnv') or injected ctx.customEnv).
Everyday use — by variable name
const env = ctx.get('customEnv')
await env?.setVar('MY_KEY', 'value') // create → default group; existing keep group
await env?.setVar('MY_KEY', 'value', someGroupId) // also set / move group
await env?.setVar('MY_KEY', '') // create only if missing
await env?.removeVar('MY_KEY')
await env?.setVars([
{ name: 'A', value: '1' },
{ name: 'B', value: '', group: someGroupId }, // no-op if B already exists
])
await env?.removeVars(['A', 'B'])
const group = await env?.createGroup('Social')
await env?.renameGroup(group!.id, 'Social media')
await env?.deleteGroup(group!.id, { moveToDefault: true })
await env?.moveEntry(rowId, group!.id)
Reserved names are rejected (batch calls fail entirely). Unknown group ids raise custom-env/invalid-group.
| Call | Purpose |
|---|---|
setVar(name, value, group?) | Create/replace by name. Omit group: new → default, existing keep group. Pass group to assign/move |
setVars([{ name, value, group? }, ...]) | Same rules per entry; last duplicate name wins |
removeVar(name) / removeVars(names) | Delete by name (clears membership) |
createGroup(title) | Create custom group; returns { id, title } |
renameGroup(id, title) | Rename custom group (not default) |
deleteGroup(id, { moveToDefault }) | Delete custom group; true moves members to default, false deletes their variables |
moveEntry(id, groupId) | Move one row (by Settings row id) to another group |
Settings UI — by row id
| Call | Purpose |
|---|---|
list() | Variables + groups; each entry has groupId |
upsert(id, name, value, groupId?) | Create (id empty; groupId defaults to default) or update/rename by id (omit groupId to keep group) |
deleteEntry(id) | Delete that row |
restore(id) | Restore session-start value, or remove if the row was added later |
CLI helpers
| Call | Purpose |
|---|---|
cliStatus() | Whether this Host’s dsh CLI is ready / can be installed |
cliInstall() | Install or repair that CLI entry |
MIT