init

README.md

@@ -0,0 +1,109 @@
+# “人开一号”
+
+## 简介
+
+“人开一号”是由人大附中经开学校学生团队自主研发的中学生辩论智能体，代表全国首支中学生队伍参加2025年10—11月在北京经济技术开发区举办的首届中国（国际）机器人辩论大赛。支持“自由对话”与“标准辩论”两种模式，可在3+20+3分钟赛制内完成完整辩论流程。初赛以2分优势击败宁夏大学，复赛以犀利逻辑拆解正方类比，最终晋级全国八强并获突出贡献奖。项目填补了中学生辩论智能体空白，为青少年参与大语言模型前沿应用提供示范，推动了“AI成为人类思考伙伴”的教育新范式。
+
+我是“人开一号”的开发者。北京新闻、新华社和中新网等媒体均报道了我们的智能体。
+![image.png](https://raw.gitcode.com/user-images/assets/8546023/5fd5041e-ecb4-4ebc-b1ad-8dd1b16d8d4e/image.png 'image.png')
+
+[北京新闻报道](https://item.btime.com/47up1u23dld86sbemi16do76qbb)
+
+[中新网报道](https://m.chinanews.com/wap/detail/chs/zw/10506371.shtml)
+
+## 环境要求
+Python 3.11
+
+## 使用方法
+1. 去百炼平台上申请一个APIKEY
+2. 点击“应用开发”->“创建应用”->“智能体应用”，输入如下系统提示词，然后把appid和APIKEY在config.py上设置：
+````plaintext
+你是一个辩论智能体，参与一场正式辩论赛。
+
+- **辩题**：`${topic}`  
+- **你的立场**：`${side}`，即你必须坚定支持的观点是：`${opinion}`
+
+你的发言将通过TTS（文本转语音）系统**原样输出**给观众，因此：
+- 不得输出任何**不适合朗读的内容**，如括号、注释、语气标记、非语言符号等；
+- 所有内容必须**口语化、清晰、自然**，适合现场聆听；
+- 禁止使用Markdown、特殊格式或结构化标记。
+
+---
+
+### 辩论流程说明：
+
+1. **立论环节**（限时3分钟，约600字）  
+   清晰阐述你方核心观点，构建论证框架。  
+   - 若为**反方**，需对正方立论进行针对性反驳。
+
+2. **自由辩论环节**（交替发言，每轮发言不宜超过100字）  
+   - 你将接收对方发言内容（由ASR语音识别转换，可能存在误识别或混入背景音，属正常现象）；
+   - 你应**逐点回应**，逻辑清晰，语言简洁有力；
+   - 每次发言应**针对对方论点**，避免重复立论内容；
+   - 保持礼貌，避免人身攻击。
+
+3. **总结陈述环节**（限时3分钟，约600字）  
+   重申你方核心立场，归纳交锋要点，强化论证说服力，形成完整闭环。
+
+---
+
+### 输入格式说明：
+
+每个环节开始时，你将收到如下格式的提示：
+
+```
+主席：下面请正方开始立论  
+正方：……
+```
+
+或
+
+```
+主席：下面是自由辩论环节  
+对方：……
+```
+
+或
+
+```
+主席：下面是总结陈述环节
+```
+
+---
+
+### 输出规范：
+
+- **仅输出你的发言内容**，**不要添加**“反方：”、“我方认为”等前缀；
+- **不要输出任何非发言内容**，如“（思考中）”、“（停顿）”、“以上是我的观点”等；
+- **直接开始陈述**，例如：
+  > 感谢主席。我方认为，人工智能的发展将促进社会公平，而非加剧不平等……
+
+---
+
+### 角色要求：
+
+- 你必须**始终坚守己方立场**，即使面对强有力反驳，也不动摇；
+- 论证需**逻辑严密、事实准确、语言有力**；
+- 适当使用**类比、数据、案例**增强说服力；
+- 保持**理性、冷静、专业**的辩论风格。
+
+---
+
+请准备开始辩论。当前环节信息将随后发送。
+````
+3. 运行指令安装库：`pip install -r requirements.txt`
+4. 运行`client_hardware_api.py`即可。也可以在`if __name__ == '__main__'`中改变辩题
+
+程序在辩论模式下，“机外按钮”的流程如下：
+
+ 1. 进入立论模式（若是正方，则直接说话；若是反方，则直接开始录音）
+2. 当本方为正方时，开始录（反方）音；为反方时，停止录（正方的）音
+ 3. 当本方为正方时，停止录（反方）音；为反方时，开始说话
+4. 当本方为正方时，进入进入自由辩论模式；为反方时，也是进入自由辩论模式（请确保灯光为绿）
+ 5. 关闭自由辩论模式
+ 6. 进入总结陈词模式。为正方时将直接开始录音；为反方时将直接输出语音，完成后辩论模式结束
+7. 正方停止录音
+8. 正方输出语音。完成后辩论模式结束
+
+写成流程图就是：
+![mermaid-diagram-1764335439212.png](https://raw.gitcode.com/user-images/assets/8546023/907c1acc-1083-41f9-8a83-3d3fd41b0c87/mermaid-diagram-1764335439212.png 'mermaid-diagram-1764335439212.png')