std-microblock/orange-bot--packages-dsh-plugin-orange ↗★ 0

dsh-plugin-orange

橘波特 (Orange): a QQ group chat bot for DeepSeek Harness. Satori bridge (official QQ bot via koishi + userbot via crossgram), message store, trigger merging and classifier, chat agent + background task agents, agent tools, and a Web panel. 适合需要将DSH智能体接入QQ群聊,实现自动回复和后台任务的用户。

패키지
dsh-plugin-orange
호환성
미검증
Harness peer 범위
*
Cordis peer 범위
*
버전
0.1.0
라이선스
MIT
최근 업데이트
2026. 10. 13.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:std-microblock/orange-bot#06352a7a61e165c055a5ac59ce7960df2495806f&path:packages/dsh-plugin-orange

配置

插件的 patch 层(cordis.patch.yml)插两行:宿主行 orange(机器人本体 + 面板 API)和 orange agent preset(聊天/任务/子 agent 共用的工具与权限)。静态字段从 cordis 行/环境变量来:

配置环境变量说明
dataDirORANGE_DATA数据目录,默认 $HOME/.orange(SQLite、表情文件、日志)
workspaceORANGE_WORKSPACEagent 的工作区根目录,默认 $HOME/workspace
koishi.endpoint / .tokenORANGE_KOISHI_ENDPOINT / _TOKEN官方 bot 侧的 Satori 地址与 token
crossgram.endpoint / .tokenORANGE_CROSSGRAM_ENDPOINT / _TOKENuserbot 侧的 Satori 地址与 token
llm.baseURL / .apiKeyORANGE_LLM_BASE_URL / _KEYOpenAI 兼容端点与 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 是空的——机器人不回答任何人,也不存任何群的消息。这是故意的:先在面板里(或配置里)把主人和白名单配好。