dsh-ctl

Readme

# dsh-ctl

DeepSeek Harness (dsh) Web control plugin. Adds two features to the dsh web
Settings panel:

- **系统控制** — 一键 **重启 / 关闭** dsh web。重启按原启动命令重新拉起进程，端口 3080 重新监听；关闭则结束 dsh 主进程。
- **小鱼干补给** — 给内置的「鲸鱼娘」宠物输入数字增加小鱼干（库存上限 20），并显示当前库存。

Host 端提供 `/api/dsh-ctl/*` JSON 端点；Client 端注册两个设置页。

## 安装

该插件是一个标准的 dsh bundle 包。在已装好的 dsh web 环境里，任选其一：

**方式 A：本地克隆后 link 安装**

```sh
git clone https://github.com/w2831120407/dsh-ctl.git
dsh plugin --profile web add link:$(pwd)/dsh-ctl
```

**方式 B：作为 git 依赖加入 profile**

在 `~/.dsh/profiles/web/package.json` 的 `dependencies` 增加并执行安装：

```json
"dsh-ctl": "git+https://github.com/w2831120407/dsh-ctl.git"
```

然后在 `dsh.profile.bundles` 里追加 `"dsh-ctl"`。

安装后**重启 dsh web**，刷新浏览器，在 **设置** 里即可看到 **「系统控制」** 与 **「小鱼干补给」**。

## 使用

- 设置 → 系统控制：「重启」「关闭」为两步确认按钮（第一次点击变「确认重启？/确认关闭？」），防止误触。
- 设置 → 小鱼干补给：输入数量点「增加」，将小鱼干库存加上对应数量（受宠物库存上限截断）。

## 说明与注意事项

- 重启/关闭是**进程级操作**：通过分离的 PowerShell helper 定位 dsh 主进程并按原命令行处理。操作会断开当前页面，需要手动刷新。
- 小鱼干补给通过运行时扩充 `@linxin666/dsh-pet` 服务（不改动 pet 包文件），因此随 pet 更新不会丢失；若 pet 内部结构变化，可能暂时失效（返回错误而非崩溃）。
- 默认端口按 `3080` 识别，首选按命令行 `deepseek-ai` + `bin.js` 匹配 dsh 主进程。

## License

MIT