@woosau/dsh-custom-env 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ownduck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-custom-env
+
+English | [中文](README.zh-CN.md)
+
+Community DeepSeek Harness plugin: manage `$DSH_HOME/.env` from **Settings → Environment**. Not an official DeepSeek AI product.
+
+Edits apply to the Host immediately and sync to the Windows / macOS user environment (new terminals pick up OS changes). Linux user-env sync is not supported.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Features
+
+- CRUD for `$DSH_HOME/.env` in Settings
+- Hot-apply to the current Host process
+- Sync to Windows / macOS user environment
+- Rejects bootstrap names (`PATH`, `DSH_*`, `XDG_*`, …)
+- Optional **Install** for the `dsh` CLI used by this Host (Windows / macOS)
+
+## Install
+
+Requires a working DSH install with the `dsh` CLI. Use profile `desktop` or `web`.
+
+```powershell
+dsh plugin --profile desktop add @woosau/dsh-custom-env
+```
+
+```powershell
+dsh plugin --profile web add @woosau/dsh-custom-env
+```
+
+GitHub: `dsh plugin --profile desktop add github:ownduck/dsh-custom-env`
+
+Close Desktop first if `plugin` hits `EPERM` on the profile `package.json`. GitHub installs may need `allowBuilds.koffi: true` in the profile `pnpm-workspace.yaml` (native `koffi`). Then restart DSH and open **Settings → Environment**.
+
+## Uninstall
+
+```powershell
+dsh plugin --profile desktop remove @woosau/dsh-custom-env
+```
+
+## Usage
+
+1. Open **Settings → Environment**
+2. Edit as a draft: **Confirm** writes `.env` and live Host/OS; **Cancel** reverts the inputs
+3. After Confirm, restart tips appear for new/changed rows; **Restore** writes back the Host-start value
+4. Restart DSH or open a new terminal for the full OS effect
+5. Use **Install** in the dsh block only when offered (Windows user PATH / macOS `/usr/local/bin/dsh`; may replace Desktop’s link on macOS)
+
+Do not put bootstrap names (including `PATH`) in `.env`.
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,53 @@
+# dsh-custom-env
+
+[English](README.md) | 中文
+
+社区 DeepSeek Harness 插件：在 **设置 → 环境变量** 管理 `$DSH_HOME/.env`。非 DeepSeek AI 官方产品。
+
+保存后立即作用于 Host，并同步到 Windows / macOS 用户环境（新开终端可见 OS 侧变更）。不同步 Linux 用户环境。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## 功能
+
+- 设置页管理 `$DSH_HOME/.env`
+- 热写当前 Host 进程
+- 同步 Windows / macOS 用户环境
+- 拒绝 bootstrap 名（`PATH`、`DSH_*`、`XDG_*` 等）
+- 可选为本 Host **安装** `dsh` CLI（Windows / macOS）
+
+## 安装
+
+需已安装 DSH 且可用 `dsh` CLI。profile 选 `desktop` 或 `web`。
+
+```powershell
+dsh plugin --profile desktop add @woosau/dsh-custom-env
+```
+
+```powershell
+dsh plugin --profile web add @woosau/dsh-custom-env
+```
+
+GitHub：`dsh plugin --profile desktop add github:ownduck/dsh-custom-env`
+
+若 `plugin` 报 profile `package.json` 的 `EPERM`，先退出 Desktop。从 GitHub 安装时，profile 的 `pnpm-workspace.yaml` 可能需要 `allowBuilds.koffi: true`（原生依赖 `koffi`）。然后重启 DSH，打开 **设置 → 环境变量**。
+
+## 卸载
+
+```powershell
+dsh plugin --profile desktop remove @woosau/dsh-custom-env
+```
+
+## 使用
+
+1. 打开 **设置 → 环境变量**
+2. 草稿编辑：**确定** 写入 `.env` 并热写 Host/OS；**取消** 只恢复输入框
+3. 确定后新增/修改行旁有重启提示；**恢复** 可写回 Host 启动时的值
+4. 完整生效请重启 DSH 或新开终端
+5. **dsh** 区块仅在出现按钮时点 **安装**（Windows 用户 PATH / macOS `/usr/local/bin/dsh`；macOS 上可能覆盖 Desktop 的链接）
+
+不要把 bootstrap 名（含 `PATH`）写进 `.env`。
+
+## 许可证
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: custom-env
+      name: '@woosau/dsh-custom-env'