mediator

🛡️ 智能情绪防火墙,中性沟通助手

个人开源的情感防火墙,自动过滤困难联系人消息中的情绪化内容,提取事实并生成中性回复,帮助用户避免冲突升级。

收藏
13.3k
安装
2.8k
版本
v1.0.0
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

Mediator Skill 是一款专为困难人际关系设计的"情感防火墙"工具。它通过命令行界面配置需要过滤的联系人(如前任伴侣、难缠客户),支持 Gmail 邮件和 iMessage 短信的实时监控。用户可选择"拦截模式"(完全隐藏原始情绪内容,仅展示事实摘要)或"辅助模式"(同时查看原文和摘要)。系统通过 GPT-4o-mini 模型自动剥离情绪化表述,提取关键事实、待办事项和截止时间,并生成中性、专业的回复草稿。配置完成后,可通过 cron 定时任务或心跳检查实现自动化处理,所有原始消息均被归档保存以便回溯。

该工具的最大价值在于心理边界保护,通过 AI 中间层阻断情绪感染,防止用户在冲动下做出不当回应。其三档摘要模式(仅事实/中性重写/完整标注)提供了灵活的过滤强度,"草稿回复"功能则确保人工最终审核,避免自动化误伤。技术实现上,支持多通道整合(邮件+短信)、完善的日志审计、可恢复的消息归档机制,且完全本地化配置(YAML 文件管理),符合隐私优先的设计理念。对于高冲突情境(如离婚协商、客户纠纷),能显著降低沟通压力。

作为 T3 级个人开源项目,长期维护稳定性存疑,且依赖 imsg、llm、gog-read.sh 等外部 CLI 工具,增加了部署复杂度和故障风险。功能层面,LLM 处理可能遗漏微妙的语境线索或文化特定暗示,导致"事实提取"失真;所有消息需发送至 OpenAI API,对高度敏感内容存在隐私顾虑。此外,自动回复功能虽标注"危险",但仍存在误配置风险,且对法律、财务、育儿等关键领域明确禁用,适用场景受限。

适用于需要与情绪化、操控性或高冲突联系人保持必要沟通,但希望减少心理负担的用户群体,如正在分居/离婚的伴侣、处理棘手客户的自由职业者、或需要与难相处亲属保持联系的人士。特别适合容易受情绪影响、倾向于过度反应或回避冲突的沟通者。技术门槛方面,需要用户具备基本的命令行操作能力和 YAML 配置知识,不适合纯技术小白。

数据合规风险是首要考量,通信内容外泄至第三方 LLM 服务,违反某些企业保密协议或法律保密条款。系统可靠性方面,依赖项版本未锁定(如 PyYAML)、外部工具更新可能导致功能中断。操作风险包括:自动回复模式可能发送不当内容;归档机制虽保护数据,但标签管理错误可能导致"丢失"重要邮件;日志文件积累敏感信息需定期清理。建议仅在非关键通信场景使用,严格禁用 auto-respond,并定期审计处理日志。

安全解读

核心用法

Mediator 是一款面向高冲突人际关系的通信过滤工具,通过技术手段为用户建立"情感防火墙"。其核心工作流程为:

1. 拦截配置:通过 mediator.sh add 将特定联系人(前任、难缠客户等)加入监控列表,绑定邮箱、手机号等渠道
2. 实时监控:依赖 Gmail Pub/Sub 或 imsg watch 捕获新消息

3. 智能处理:调用本地 LLM 将情绪化内容转为事实摘要(facts-only/neutral/full 三档模式)

4. 响应辅助:自动生成中性回复草稿,支持人工审核后发送

典型场景包括:离婚后与前配偶的子女交接沟通、与情绪不稳定客户的商务往来、家庭矛盾中的必要信息传递等。

---

显著优点

  • 心理保护机制:"intercept" 模式可完全隐藏原始邮件的情绪冲击,用户仅接触结构化事实
  • 多通道覆盖:支持 Email(Gmail)、iMessage 双渠道,符合主流通信场景
  • 灵活分级:从纯事实提取到完整内容+情绪标注,满足不同透明度需求
  • 本地优先:原始消息归档至本地(~/.clawdbot/),配置 YAML 化便于版本管理
  • 开源可审计:Python 实现,无黑盒依赖,LLM 调用通过本地 CLI 代理

---

潜在局限与风险

| 维度 | 具体表现 |
|------|---------|
| **功能边界** | 仅支持 Gmail(需 `gog-read.sh`)和 iMessage(需 `imsg` CLI),企业微信、WhatsApp 等未覆盖 |
| **自动化风险** | "auto" 响应模式被明确标记为危险,但配置错误可能导致误发 |
| **上下文丢失** | LLM 摘要可能遗漏微妙语境(如反讽、历史约定),需人工复核 |
| **依赖脆弱性** | 强依赖外部 CLI 工具(`llm`、`imsg`),若上游更新或失效则功能中断 |
| **法律盲区** | 自动归档可能涉及电子证据保全责任,离婚/监护权纠纷中需谨慎 |

---

适合人群

  • 高冲突离婚/分居者:需与前任保持最低限度功能性沟通
  • 情绪敏感型职场人:需应对难缠客户但希望隔离情绪消耗
  • ADHD/焦虑症患者:外部情绪输入可能触发症状,需结构化信息过滤
  • 家庭关系调解期:与情绪不稳定的家庭成员进行必要事务沟通

---

常规风险提示

1. 依赖安全:外部工具(llmimsggog-read.sh)需独立验证来源,建议固定版本使用
2. 配置校验:联系人邮箱/手机号格式未严格验证,错误配置可能导致监控失效

3. 隐私边界:虽然数据本地存储,但 LLM 处理环节需确认是否在本地运行(如使用 Ollama)而非云端 API

4. 法律合规:部分司法管辖区要求保留通信完整记录,"strip emotion" 模式可能被视为篡改证据

5. 维护状态:T3 级个人开发者维护,长期更新承诺不确定,建议 fork 后自主维护关键功能

> 总体而言,Mediator 是一款设计精巧、直击痛点的情感劳动自动化工具,在正确配置和人工监督下,能显著降低高冲突沟通的心理成本。但需清醒认识其作为"辅助"而非"替代"的定位——最终的人际责任仍需人类承担。

mediator 内容

references文件夹
scripts文件夹
手动下载zip · 13.3 kB
prompts.mdtext/markdown
请选择文件