配置凭据

推荐写进 DSH 凭据库（与 DSH 其他密钥同一处，不落 settings.yaml）：

## 🚀 首次使用

1. **直接发消息**：不做任何选择就发一条消息，插件会自动新建会话（回执只报工作区名），这条消息就是该会话的第一个 prompt。
2. **选工作区**：`/切换` 列出所有工作区 → `/切换 ` 选中（**会清空当前控制目标，防误发**）。
3. **选会话**：`/会话` 列出该工作区会话 → `/会话 ` 接管，之后发消息就是在那个会话里说话。

一个 openid 同时只有一个控制目标；换会话用 `/会话`，换工作区用 `/切换`。

## ⚙️ 配置

| 参数                   | 说明                                                         | 默认值                |
| ---------------------- | ------------------------------------------------------------ | --------------------- |
| `app_id`               | QQ 机器人 AppID（留空则从环境变量 / `refs.QQ_BOT_APP_ID` 读取） | `''`                  |
| `app_secret`           | QQ 机器人 AppSecret（**建议留空**，走 `refs.QQ_BOT_SECRET`） | `''`                  |
| `default_workspace`    | 默认工作区路径；留空则用 `$DSH_HOME/workspace/default`（首次用到时自动创建并注册） | `''`                  |
| `stream_enabled`       | 整回合正文走 QQ 流式消息（关闭则用普通 Markdown 消息）       | `true`                |
| `stream_throttle_ms`   | 流式分片节流间隔（毫秒）                                     | `1000`                |
| `allow_create_session` | 允许 QQ 侧新建会话（管住 `/新建` 与「未选中态直接发消息」的自动新建） | `true`                |
| `media_dir`            | 入站附件落盘目录（相对 `$DSH_HOME`；也可写绝对路径）         | `qqbot/media`         |
| `media_max_bytes`      | 单个入站附件落盘上限（字节）                                 | `209715200`（200 MB） |
| `reply_max_chars`      | 命令回执最大字符数（超出截断）                               | `1500`                |
| `list_page_size`       | 列表分页大小                                                 | `10`                  |
| `status_show_usage`    | `/状态` 是否显示上下文用量                                   | `true`                |
dsh-qqbot-bridge

同名套件的其他儲存庫

安裝

說明文件

配置凭据
