Cursor/Trae 持久对话 MCP 插件 v1.6.37

垂直绑定 · 真挂起 · 永不断开
一个让 Cursor / Trae / VSCode 与 Agent 之间实现"可持续对话"的 MCP 插件。

---

🎯 一句话描述

普通 MCP 调一次就结束对话；本插件用 4 个工具 + Hub 长连接，让 agent 与用户的对话永不中断，适合长跑学习清单 / 跨天多计划 / 自动续跑任务。

---

📦 仓库内容

persistent-chat-plugin/
├── lib/                          # CO-Chat 整合模块（enhance/bridge/smoke/retire）
├── vendor/                       # cochat-engine 3.3.34（无卡密补丁引擎）
├── docs/prd/                     # PRD + 安装说明 + 经验汇总 + 模块说明
├── scripts/co-integration/       # 冒烟 / 同步 / 退役脚本
│
│   ├── server.js        (42KB)   # MCP Server 端，4 个工具入口
│   ├── hub.js           (89KB)   # Hub 主服务（HTTP + WebSocket）
│   └── cursor-title.js  (4KB)    # Cursor 标题解析器
│
├── web/                          # 持久对话面板（浏览器 UI）
│   ├── panel.html       (84KB)   # 主面板 v1.6.37
│   ├── panel.remote.html         # 远端 NAS 面板（panel_remote_v1637）
│   └── panel.html.local          # 本地备份面板
│
├── scripts/                      # 部署与运维脚本
│   ├── ensure-hub.sh             # 启动器（MCP stdio → http）
│   ├── mongo_sync.py             # 会话 → MongoDB 同步
│   └── (deploy scripts...)
│
├── mcp-config/                   # MCP 配置模板
│   ├── trae.mcp.json             # Trae CN 配法
│   └── cursor.mcp.json           # Cursor 配法
│
├── docs/                         # 完整文档
│   ├── INSTALL.md                # 安装
│   ├── DEPLOY.md                 # 部署
│   ├── MCP_SETUP.md              # MCP 配置
│   ├── ARCHITECTURE.md           # 架构
│   └── QUICKSTART.md             # 5 分钟上手
│
├── Cursor持久对话-安装包-v1.6.37_20260607.zip  # 原始安装包（备查）
└── README.md                     # 本文件

---

⚡ 三种部署形态

形态	端口	适用	关键
本地备份	127.0.0.1:13458	单机	launchd 守护，挂了自动起
远端 NAS	192.168.110.101:13458	多人 / 跨机	Node 守护，跨网段访问
Trae 插件	MCP stdio	与 IDE 集成	ensure-hub.sh 起 4 工具

可同时跑，三者共享同一 Hub 协议。

---

🔧 MCP 工具

#	工具	用途
1	init_conversation	起新 session（支持 newPlan:true 换计划）
2	select_conversation	复用旧 session（垂直绑定校验）
3	wait_for_user_input	真挂起，等用户下一条
4	merge_conversation	合流两个 session 的上下文
5	quota_status	读取本地限额状态与阈值预警
6	prepare_continuity_handoff	生成续接摘要，保护连续线

核心机制：Hub 把 session 存在内存 + 周期 save，token (ct_xxx) 垂直绑定到「工作区 + Cursor 标签 + IP」三件指纹。

🛡 合法增强

• 本地 quota-status.json 可作为限额状态输入源
• 到阈值时只做预警和续接摘要，不自动重置
• 面板会提示先调用 prepare_continuity_handoff

---

🚀 5 分钟上手

# 1. 克隆
git clone http://192.168.110.101:3000/fnvtk/persistent-chat-plugin.git
cd persistent-chat-plugin

# 2. 部署到 ~/.persistent-chat-local
mkdir -p ~/.persistent-chat-local
cp src/* scripts/ensure-hub.sh ~/.persistent-chat-local/
cp web/panel.html ~/.persistent-chat-local/panel.html

# 3. 编辑 mcp.json，填到 Trae/Cursor
cat mcp-config/trae.mcp.json
# 复制内容到 ~/.trae/mcp.json

# 4. Trae Cmd+Q 退出重开，让 MCP 重新加载
# 5. 在 SOLO Agent 窗口发"开始测试"或"继续"

详细见 QUICKSTART.md。

---

🔒 垂直绑定

每个 session 用「工作区::Cursor 标签 @ IP」做绑定指纹：

/Users/karuo/Documents/个人::持久对话永久续跑-20260626@192.168.110.101

换工作区 / 换标签 / 换 IP 都不会复用 session，避免串台。

---

📊 核心指标

指标	值
Hub 进程	Node 22 (/usr/local/opt/node@22/bin/node)
端口	13458
协议	HTTP + 短轮询（10s 续约）
保活档	10s / 30s / 60s / 2min / 4min / 9min / 15min / 30min
校验频率	每次 wait 触发一次
单 session 容量	无限制（内存 + JSON 周期 save）

---

🆘 常见问题

Q: 提示"Token未获取, 未登录"？
A: Trae 需 Cmd+Q 完全退出重开，让 MCP 配置生效。

Q: "任务完成" 是不是对话死了？
A: 不是。Hub 上 session 仍 holding，等用户下一条自动续跑。可在 http://192.168.110.101:13458/ 看到。

Q: 如何真正关掉对话？
A: 在对话里说"结束持久对话"，agent 会主动 merge。

---

📜 许可证

私有项目 · 仅公司内部使用 © 2026 卡若AI

---

🔗 相关链接

• 默认主链：http://192.168.110.101:13458/
• Gitea 仓库：http://192.168.110.101:3000/fnvtk/persistent-chat-plugin
• 增强向导：http://127.0.0.1:13458/enhance
• PRD 真源：docs/prd/PersistentChat_整合CO-Chat_需求PRD_v1.md
• 远端主链面板：http://192.168.110.101:13458/
• 本地兜底面板：http://127.0.0.1:13458/
• Trae 配置：~/.trae/mcp.json
• Cursor 配置：~/Documents/个人/.cursor/mcp.json