dsh-global-rules

Readme

# dsh-global-rules

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)

在 DeepSeek Harness Web 的设置面板中编辑 `~/.dsh/AGENTS.md`（全局规则）的插件。

Edit your `~/.dsh/AGENTS.md` (global rules) from the DeepSeek Harness web settings panel.

![全局规则设置页](globalrule.png)

## 功能 / Features

- 设置页新增「全局规则」标签：打开即加载 `~/.dsh/AGENTS.md` 当前内容
- 编辑保存，实时生效：**新会话立即生效**；当前会话在下次文件操作后感知新规则（由 DSH 内置的 `dsh-agent-instructions` 动态检测机制完成）
- 文件不存在时保存会自动创建
- 零构建：Client 端为手写 `__ModuleLoader__` bundle，Host 端为纯 Node ESM

## 安装 / Install

```sh
dsh plugin --profile web add dsh-global-rules
```

从 GitHub 源安装（备选）：

```sh
dsh plugin --profile web add github:badai147/dsh-global-rules
```

重启 `dsh web`，然后打开 **设置 → 全局规则**。

## 使用 / Usage

1. 打开设置 → 全局规则
2. 编辑规则内容（Markdown 格式，与 `AGENTS.md` 语法一致）
3. 点击「保存」

保存后：

- 新会话：首次步骤直接读取新内容，立即生效
- 当前会话：下一次文件系统工具调用后，DSH 会检测到文件变化并注入
  "Updated instructions from: ~/.dsh/AGENTS.md"，模型按新规则执行

## 工作原理 / How it works

- **Host**（`lib/index.js`）：注册 `GET /global-rules`（读文件）与 `POST /global-rules`（写文件，同源校验 + 256 KiB 上限）两个 HTTP 路由
- **Client**（`lib/client.js`）：手写 `window.__ModuleLoader__.load` bundle，注册 `settings.section` 的「全局规则」页面
- **生效机制**：DSH 内置 `dsh-agent-instructions` 插件覆盖 `user-global` scope 的动态检测——无需插件做任何热重载

## 目录结构 / Structure

```
dsh-global-rules/
├── cordis.patch.yml   # bundle patch：插入 global-rules 层
├── lib/
│   ├── index.js       # Host：HTTP 路由（Node ESM）
│   └── client.js      # Client：设置页 UI（__ModuleLoader__ bundle）
└── package.json
```

## License

[MIT](LICENSE)