kaustubh-dot/SentinelSwarm
GitHub: kaustubh-dot/SentinelSwarm
一款 Slack 原生的危机协调代理，将分散的灾害现场信息整合为带证据链和人工审批的行动计划，支持多级降级保障持续运行。
Stars: 0 | Forks: 0
# SentinelSwarm
SentinelSwarm 是一个为 Slack Agent Builder Challenge 打造的原生 Slack 危机协调代理。其演示场景是 B 区的季风性洪水响应：将零散的现场报告、路线更新、避难所容量、志愿者和物资整合为一个在 Slack 内部通过证据链接且经人工批准的行动计划。
## 核心演示
```
@SentinelSwarm analyze Zone B risk
-> Incident Control Room appears
-> Evidence Ledger shows why the plan was created
-> Approve Plan
-> Post to Coordination
-> #coordination receives the final action plan
```
## 为何能保障无阻碍运行
该应用程序在设计上即便外部服务发生故障也能正常工作：
- Real-Time Search 故障 -> 本地 `mockContext.json`
- Weather API 故障 -> 本地 `mockWeather.json`
- Flood API 故障 -> 本地 `mockFlood.json`
- LLM 故障或缺失密钥 -> 确定性回退规划器
## 设置
1. 根据 `manifest.yaml` 创建一个 Slack 应用。
2. 启用 Socket Mode 并创建一个具有 `connections:write` 权限的应用级 token。
3. 将该应用安装到你的 Slack 开发者沙盒中。
4. 邀请该机器人进入演示频道。
5. 将 `.env.example` 复制为 `.env` 并填入 Slack token。
6. 安装依赖并运行：
```
npm install
npm run dev
```
请参阅 [docs/SLACK_SETUP.md](docs/SLACK_SETUP.md) 和 [docs/MANUAL_SETUP.md](docs/MANUAL_SETUP.md)。
## 测试
```
npm test
npm run build
```
## MCP 立场
MCP 是可选的。黑客松主要必须使用的技术是 Real-Time Search API。只有在 Slack 演示稳定之后，才添加一个小型的 SentinelSwarm 资源 MCP server。
标签：GNU通用公共许可证, MITM代理, Node.js, Slack应用, 协作工具, 库, 应急响应, 灾害管理, 自动化攻击