# 议核

**Repository Path**: fiagainster/MUN_Core

## Basic Information

- **Project Name**: 议核
- **Description**: 送给所有模联人的礼物！
“议核”是一款专为模联爱好者打造的AI驱动训练软件，通过沉浸式的多边辩论体验，帮助模联新手快速提升外交辩论技能，为资深代表提供针对性专项训练。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MUN Core

## 🚀 项目概述

**议核** 是一款专为模拟联合国（Model United Nations）爱好者打造的AI驱动训练软件，通过沉浸式的多边辩论体验，帮助模联新手快速提升外交辩论技能，为资深代表提供针对性专项训练。

## ✨ 核心功能

### 🎯 训练模块

#### 多剧本支持
- **预设剧本库**：包含全球治理、经济发展、环境议题、科技治理等11+种预设模拟场景
- **自定义剧本**：支持创建、编辑和删除个性化剧本，设置议题、角色、背景和规则
- **剧本详情展示**：查看完整的剧本背景、角色配置和规则设置
- **议题多样性**：涵盖全球治理、安全合作、经济发展、环境可持续等多个领域的议题
- **角色配置系统**：为每个AI角色设置详细的立场、性格和优先事项

#### 多边AI辩论
- **AI角色系统**：3-4个AI代表同时参与，每个角色具有独特的立场、性格和优先事项
- **真实博弈环境**：AI角色之间会相互回应、辩论，模拟真实模联会议的复杂互动
- **动态发言顺序**：支持多种发言顺序模式
- **发言质量控制**：AI发言符合外交辞令规范，长度适中，内容紧扣议题

#### 实时状态反馈
- **满意度指标**：0-100%的满意度评分，直观反映AI角色对当前讨论的满意程度
- **立场强度**：0-100%的立场强度，显示AI角色坚持自身立场的程度
- **立场变化追踪**：记录AI角色立场的历史变化
- **可视化展示**：使用进度条和颜色变化，直观呈现AI角色的状态变化

#### 自动摘要系统
- **智能摘要生成**：每10轮自动生成精准摘要
- **上下文管理**：摘要与最近对话结合，有效管理对话内容
- **关键信息提取**：自动识别讨论中的核心观点、分歧点和共识
- **历史摘要保存**：所有生成的摘要自动保存，方便用户回溯讨论历程

#### 综合评估报告
- **星级评分**：训练结束后生成1-5星的综合评分
- **多维评估**：从发言质量、立场一致性、策略有效性等多个维度进行评估
- **详细改进建议**：针对用户的不足提供具体、可操作的改进建议
- **历史报告对比**：支持查看历史评估报告，追踪个人进步情况

### 🧠 参谋模块

#### 文件智能分析
- **多格式支持**：支持上传TXT、PDF、Word等多种格式的会议文件
- **6类文件分类**：背景文件、立场文件、工作文件、决议草案、修正案、危机文件
- **结构化解析**：自动提取文件中的关键信息、数据和观点
- **智能关联**：自动关联不同文件之间的相关内容，形成完整的信息网络

#### 策略深度解析
- **关键信息识别**：自动识别文件中的核心论点、数据和依据
- **分歧点分析**：精准定位不同立场之间的主要分歧和争议焦点
- **盟友/对手识别**：基于立场相似度，自动推荐潜在合作方和识别主要讨论对象
- **风险评估**：分析提案可能面临的挑战和风险，提供风险规避建议

#### 对话式咨询
- **自然语言交互**：支持以自然语言提问，获取专业模联建议
- **思考框架提供**：帮助用户建立系统化的思考模式，提升分析能力
- **话术思路指导**：提供发言结构和话术建议，不生成具体文件内容
- **实时咨询支持**：随时回答用户在训练过程中遇到的问题

#### 个性化建议
- **角色适配**：根据用户扮演的角色提供定制化建议
- **会议阶段适配**：根据会议进展阶段调整建议内容
- **议题聚焦**：针对当前讨论的具体议题提供针对性策略
- **风格适配**：可根据用户偏好调整建议的语气和风格

### 🏆 专项训练

#### 立场陈述训练
- **开场发言训练**：练习模联会议中的开篇立场陈述
- **立场清晰度评估**：AI自动评估立场的明确性和连贯性
- **结构优化建议**：提供发言结构的改进建议
- **语言表达提升**：帮助用户掌握外交辞令的规范和技巧

#### 有主持核心磋商
- **限时发言模拟**：设置发言时长限制，模拟真实磋商场景
- **主题聚焦训练**：要求发言紧扣特定子议题，提升议题聚焦能力
- **问答环节训练**：模拟其他代表的提问和反驳，锻炼应变能力
- **主席角色模拟**：AI扮演主席角色，维持会议秩序和流程

#### 自由磋商训练
- **游说技巧训练**：练习如何说服其他代表支持自己的立场
- **合作策略指导**：学习如何识别潜在合作方并建立合作关系
- **多边谈判模拟**：模拟多组代表同时进行的复杂谈判场景
- **妥协与让步艺术**：掌握何时妥协、如何让步的策略技巧

#### 文件起草训练
- **决议草案规范学习**：熟悉国际组织决议草案的格式和撰写规范
- **修正案撰写训练**：学习如何撰写符合规则的修正案
- **条款逻辑审核**：AI自动审核条款之间的逻辑关系和一致性
- **语言精准性提升**：帮助用户提高文件语言的准确性和专业性

#### 修正案与投票
- **投票规则学习**：熟悉模联会议中的各种投票规则和程序
- **投票策略训练**：学习如何制定投票策略，包括合作、沟通等
- **修正案流程模拟**：完整模拟修正案的提交、讨论和投票流程
- **投票结果分析**：分析投票结果，理解不同立场的影响力

#### 危机处理训练
- **突发场景模拟**：随机触发各种模拟场景，如自然灾害、公共卫生事件等
- **应急响应训练**：锻炼用户在紧急情况下的快速反应能力
- **危机沟通技巧**：学习如何在复杂情况下有效沟通
- **解决方案制定**：练习制定应对复杂情况的有效解决方案

## 🛠️ 技术栈

### 前端技术
- **React 18.2.0**：现代化前端框架
- **Vite 5.4.21**：快速构建工具
- **Tauri 2**：跨平台桌面应用框架
- **IndexedDB**：本地数据存储
- **CSS3**：样式设计

### 后端技术
- **Rust 1.70.0+**：高性能后端开发语言
- **Tauri 2**：跨平台桌面应用框架
- **reqwest 0.12**：HTTP客户端
- **tokio 1**：异步运行时
- **serde 1**：序列化/反序列化
- **pdf 0.8**：PDF处理
- **docx-rs 0.4.18**：Word文件处理

### AI服务支持
- DeepSeek
- OpenAI
- 豆包
- Kimi
- 通义千问

## 📦 安装与配置

### 环境要求
- **Node.js** ≥ 18.0.0
- **Rust** ≥ 1.70.0

### 快速开始

1. **安装依赖**
   ```bash
   npm install
   ```

2. **启动开发版本**
   ```bash
   npm run tauri dev
   ```

3. **配置API密钥**
   - 首次运行后，在主界面点击"设置API密钥"
   - 选择您偏好的AI服务提供商
   - 输入API密钥并保存

### 打包发布

1. **构建生产版本**
   ```bash
   npm run build
   ```

2. **打包为可执行文件**
   ```bash
   npm run tauri build
   ```

   打包完成后，可执行文件将生成在以下位置：
   - 主程序：`src-tauri/target/release/tauri-app.exe`
   - 安装包：`src-tauri/target/release/bundle/`

## 📖 使用指南

### 开始训练

#### 使用预设剧本
1. 在主界面选择感兴趣的预设剧本
2. 点击剧本卡片查看详细信息
3. 点击"开始训练"按钮进入对话界面
4. 查看分配角色和参与AI代表
5. 输入您的发言内容，点击"发送"
6. 观察AI角色状态变化和回应
7. 训练结束后查看综合评估报告

#### 使用自定义剧本
1. 在剧本选择页面切换到"自定义剧本"选项卡
2. 点击"创建自定义剧本"
3. 配置剧本基本信息、您的角色和AI角色
4. 保存剧本后，点击剧本卡片开始训练

### 使用参谋模块
1. 上传相关会议文件（支持TXT、PDF、Word格式）
2. 等待系统自动解析文件内容
3. 输入您的问题或需求
4. 查看系统生成的策略建议和分析

### 专项训练流程
1. 从专项训练菜单中选择所需模块
2. 根据提示设置训练参数
3. 按照模块指引完成训练任务
4. 查看训练反馈和改进建议

## 🌟 用户体验亮点

### 🎨 简洁直观的界面设计
- 深色主题布局，减轻长时间使用的视觉疲劳
- 清晰的信息层级，重要信息一目了然
- 流畅的动画过渡，提升交互体验

### ⚡ 实时反馈机制
- AI回应即时显示，模拟真实会议节奏
- 角色状态动态变化，直观反馈发言效果
- 错误提示友好，引导用户正确操作

### 📱 响应式设计
- 适配不同屏幕尺寸
- 操作流程简洁，学习成本低
- 支持键盘快捷键，提高操作效率

### 🔒 本地隐私保护
- 数据存储在本地，不依赖云端
- API密钥加密存储，保护用户隐私
- 支持离线使用（需提前配置API密钥）

### 🚀 高性能运行
- 优化的AI调用逻辑，减少等待时间
- 高效的资源管理，降低系统占用
- 支持多线程处理，提升文件分析速度

## ❓ 常见问题

### Q: 训练过程中断网怎么办？
A: 系统支持离线使用，但需要提前配置好API密钥。如果训练过程中断网，已生成的内容不会丢失，但无法继续生成新的AI回应。

### Q: 可以添加自定义剧本吗？
A: 是的，系统完全支持自定义剧本功能，您可以创建个性化剧本，设置议题、角色、背景和规则。

### Q: 文件上传大小限制是多少？
A: 单文件大小建议不超过50MB，过大的文件可能会影响分析速度和效果。

### Q: 如何获取更精准的AI回应？
A: 建议提供详细的背景信息和明确的问题，系统会根据输入内容生成更精准的回应。

## 🤝 贡献指南

欢迎所有模联爱好者和开发者参与项目贡献！

### 开发流程
1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

### 贡献类型
- 功能开发和优化
- 文档完善
- 测试和bug修复
- 建议和反馈

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

---

**感谢使用MUN Core！**
祝您训练愉快，外交技能突飞猛进！ 🎉