# Persistent Chat · 持久对话 MCP 插件

> **AI 安装**：先读 **[AGENTS.md](AGENTS.md)** → 执行 **`bash install.sh [工作区路径]`**  
> **人类安装**：同上，或看 `docs/prd/PersistentChat_安装说明.md`

[![Gitea](https://img.shields.io/badge/Gitea-persistent--chat--plugin-blue)](http://192.168.110.101:3000/fnvtk/persistent-chat-plugin)
[![Version](https://img.shields.io/badge/Version-v1.1--CO-green)](#)
[![Hub](https://img.shields.io/badge/Hub-13458-purple)](#)

---

## 快速开始

```bash
git clone http://192.168.110.101:3000/fnvtk/persistent-chat-plugin.git
cd persistent-chat-plugin
bash install.sh /path/to/your/workspace
# Cmd+Q 重启 Cursor
```

| 入口 | URL |
|:---|:---|
| Hub 面板 | http://127.0.0.1:13458 |
| 增强向导 | http://127.0.0.1:13458/enhance |

---

## 根目录指引（AI / 人类）

| 文件 | 用途 |
|:---|:---|
| **[AGENTS.md](AGENTS.md)** | **AI 第一入口**：完整安装协议 + 排错决策树 |
| **[install.sh](install.sh)** | 一键安装 Hub + Cursor 配置 + 冒烟 |
| [cursor-config/](cursor-config/) | MCP / rules 真源 |
| [docs/prd/](docs/prd/) | PRD · 经验 · 模块说明 |

---

## 仓库结构

```
persistent-chat-plugin/
├── AGENTS.md              # AI 必读安装指引
├── install.sh             # 一键安装
├── cursor-config/         # MCP + rules → deploy-cursor-config.sh
├── src/                   # hub.js · server.js · cursor-title.js
├── lib/                   # enhance · bridge · smoke · retire
├── web/                   # panel.html · panel-enhance.html
├── vendor/                # cochat-engine 3.3.34
├── scripts/               # ensure-hub.sh · co-integration/
├── mcp-config/            # MCP JSON 模板
└── docs/                  # 架构 · 部署 · PRD
```

---

## MCP 工具（4 个）

| 工具 | 用途 |
|:---|:---|
| `init_conversation` | 新建 ct_ 会话 |
| `select_conversation` | 恢复会话 |
| `wait_for_user_input` | 真挂起续跑 |
| `merge_conversation` | 合流上下文 |

---

## 链接

- **Gitea**：http://192.168.110.101:3000/fnvtk/persistent-chat-plugin
- **PRD**：`docs/prd/PersistentChat_整合CO-Chat_需求PRD_v1.md`
- **排错**：`docs/prd/PersistentChat_经验汇总.md`

私有项目 © 2026 卡若AI