dsh-zhipu-codingbar

Readme

# dsh-zhipu-codingbar

DSH Web 会话头部状态栏：显示 **智谱 GLM Coding Plan** 额度。

样式与交互模仿 [dsh-codingbar](https://github.com/AnnanRen/dsh-usage-suite)，数据源只保留智谱。

## 显示

- 智谱 Coding Plan：5 小时 / 每周 / MCP 工具额度，剩余百分比、重置时间、倒计时
- 剩余 <20% 变黄，<5% 变红

窄条在会话头部，点击在胶囊下方展开详情卡。右侧边栏打开时，卡片会保持宽度并左移，避免被挡住。

## 安装

```bash
dsh plugin --profile web add github:cesarX-AI/dsh-zhipu-codingbar --config.minimumReleaseAge=0
```

然后重启 `dsh web`。确认层已挂上：

```bash
dsh --profile web --dump-config | grep -A20 zhipu-codingbar
```

本地开发（clone 后用路径安装，改源码只需重启 `dsh web`）：

```bash
git clone https://github.com/cesarX-AI/dsh-zhipu-codingbar.git
dsh plugin --profile web add ./dsh-zhipu-codingbar --config.minimumReleaseAge=0
```

## 配置

`cordis.patch.yml` 插入 `id: zhipu-codingbar` 行。后一层 patch 会**整行替换** `config`，不会深合并，所以覆盖时要把需要保留的键一起写上。schema 会补未提供的默认值。

| 字段 | 默认 | 说明 |
|---|---|---|
| `refreshMs` | `60000` | 智谱额度轮询间隔（毫秒，≥1000） |
| `zaiQuotaUrl` | 智谱官方额度接口 | 一般不用改 |
| `zaiApiKey` | 空 | 可选；空则读 `ZAI_CODING_CN_API_KEY` 或 `~/.dsh/.credentials.yaml` |

在 profile 的 `cordis.patch.yml` 覆盖示例：

```yaml
- id: zhipu-codingbar
  config:
    refreshMs: 30000
```

## 凭据

| 数据 | 接口 | 密钥 |
|---|---|---|
| 智谱额度 | `open.bigmodel.cn/api/monitor/usage/quota/limit` | `ZAI_CODING_CN_API_KEY` |

密钥只在服务端使用，路由只返回派生数字。

## License

[MIT](./LICENSE)