std-microblock/orange-bot--packages-dsh-plugin-orange ↗★ 0
dsh-plugin-orange
为DSH提供QQ群聊机器人及管理面板 适合需要将DSH智能体接入QQ群聊,实现自动回复和后台任务的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:std-microblock/orange-bot#06352a7a61e165c055a5ac59ce7960df2495806f&path:packages/dsh-plugin-orange说明文档
阅读完整 README ↗配置
插件的 patch 层(cordis.patch.yml)插两行:宿主行 orange(机器人本体 + 面板 API)和 orange agent preset(聊天/任务/子 agent 共用的工具与权限)。静态字段从 cordis 行/环境变量来:
| 配置 | 环境变量 | 说明 |
|---|---|---|
dataDir | ORANGE_DATA | 数据目录,默认 $HOME/.orange(SQLite、表情文件、日志) |
workspace | ORANGE_WORKSPACE | agent 的工作区根目录,默认 $HOME/workspace |
koishi.endpoint / .token | ORANGE_KOISHI_ENDPOINT / _TOKEN | 官方 bot 侧的 Satori 地址与 token |
crossgram.endpoint / .token | ORANGE_CROSSGRAM_ENDPOINT / _TOKEN | userbot 侧的 Satori 地址与 token |
llm.baseURL / .apiKey | ORANGE_LLM_BASE_URL / _KEY | OpenAI 兼容端点与 key |
llm.model / llm.agentModel / llm.provider | — | 默认模型(分类、润色、表情分类都用它)与 agent 用的模型 |
admins | — | 机器人管理员,qq: / cg:;唯一权限来源,默认空 |
errorGroup | — | 出错上报到哪个会话,默认空 = 只写日志 |
agentPreset | — | 聊天/任务用的 preset 名,默认 orange |
运行时可改的设置存在 SQLite 里,全部从面板改:groups(每会话白名单 / dry run / 旁听 / 标签 / 备注 / 对端)、ownProjects(主人维护的项目,分类器据此判断该不该唤醒)、assistTopics、personaExtra、style(主风格 + 子风格池 + 每次抽几条 + 温度 + 润色模型)、stickers(类型表、自动补表情概率与窗口)、sessionIdleMs、wakeMergeMs、classifierEnabled、proactivePerHour。
新装之后
admins是空的、白名单是空的、errorGroup是空的——机器人不回答任何人,也不存任何群的消息。这是故意的:先在面板里(或配置里)把主人和白名单配好。