🏗️ 架构概览

Thread Manager v2.0.1 引入了全新的向量检索层：

graph TD
    User[用户] -->|自然语言查询| Agent[Claude AI 助手]
    Agent -->|调用工具| MCP[Thread Manager MCP Server]
    
    subgraph "Thread Manager Core"
        MCP -->|解析请求| TM[Thread Manager]
        TM -->|语义搜索| Search[Vector Search Engine]
        TM -->|添加消息| MsgDAO[Messages DAO]
        
        MsgDAO -->|生成向量| Embed[Embedding Service]
        Embed -->|加载模型| LocalModel[📦 本地内置模型]
        LocalModel -.->|Xenova/all-MiniLM-L6-v2| Embed
        
        Search -->|查询| DB[(SQLite Database)]
        MsgDAO -->|存储| DB
    end
    
    DB -->|返回结果| Search
    Search -->|相关消息列表| TM
    TM -->|格式化上下文| MCP
    MCP -->|精准回复| Agent

📦 安装指南

快速安装（3 步完成）

⚠️ 重要：v2.0.0 引入 Thread Manager 记忆系统，需要完成以下 3 个步骤才能使用完整功能！

┌─────────────────────────────────────────────────┐
│  第 1 步: npm install -g ai-agent-team         │
│  ↓ 安装 AI 智能体团队                          │
└─────────────────────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────┐
│  第 2 步: ai-agent-team init                   │
│  ↓ 初始化配置（全局或项目）                    │
└─────────────────────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────┐
│  第 3 步: claude mcp add thread-manager        │
│  ↓ 启用 Thread Manager MCP 服务器              │
└─────────────────────────────────────────────────┘
                      ↓
              ✅ 安装完成！

第 1 步：安装 AI Agent Team

npm install -g ai-agent-team

第 2 步：初始化配置 ⭐ 必须执行

选择 A：全局初始化（推荐 - 所有项目共享）

ai-agent-team init

这将在 ~/.claude/ 创建全局配置，所有项目都可使用 AI 智能体团队。

选择 B：项目本地初始化（项目独立配置）

cd your-project
ai-agent-team init

这将在项目的 .claude/ 创建本地配置，仅当前项目可用。

第 3 步：启用 Thread Manager MCP 服务器 ⭐ 关键步骤

claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

为什么需要这一步？

• Thread Manager 作为 MCP 服务器运行，提供持久化记忆功能
• 只需配置一次，永久生效
• 不执行此步骤将无法使用 /threads、/pm-start 等线程管理命令

✅ 验证安装

重启 Claude Code 后测试：

# 1. 查看所有线程
/threads

# 2. 创建第一个任务线程
/pm-start "我的第一个任务"

# 3. 查看当前线程信息
/thread info

如果看到线程列表输出，说明安装成功！🎉

🎯 两种初始化方式对比

| 特性 | 全局初始化 | 项目本地初始化 | |------|-----------|---------------| | 配置位置 | ~/.claude/ | ./.claude/ | | 适用范围 | 所有项目 | 仅当前项目 | | 团队协作 | 个人使用 | 可提交到 Git | | 数据隔离 | 共享线程数据 | 项目独立线程 | | 推荐场景 | 个人开发者 | 团队项目 |

💡 提示：大多数情况推荐使用全局初始化，除非你需要在不同项目间完全隔离线程数据。

❓ 常见问题

原因：未启用 Thread Manager MCP 服务器

解决：

# 1. 执行 MCP 服务器配置
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

# 2. 重启 Claude Code
exit
claude

# 3. 验证
/threads

| 特性 | 全局初始化 | 项目初始化 | |------|-----------|-----------| | 配置位置 | ~/.claude/ | ./.claude/ | | 线程数据 | 所有项目共享 | 项目独立 | | 适用场景 | 个人开发 | 团队协作 |

推荐：个人使用选全局，团队项目选本地。

# 方法 1: 查看线程列表
/threads

# 方法 2: 查看当前线程
/thread info

# 方法 3: 创建测试线程
/pm-start "测试线程"

如果以上命令正常工作，说明 Thread Manager 运行正常。

可以！Claude Code 会优先使用项目本地配置（./.claude/），如果不存在则使用全局配置（~/.claude/）。

这意味着你可以：

• 全局配置作为默认
• 特定项目使用独立配置

🧠 Thread Manager - AI 团队的记忆系统 ⭐ NEW in v2.0.0

🎉 v2.0.1 更新：语义搜索 & 离线模型

现在，Thread Manager 不仅能记住对话，还能理解对话！

• 语义搜索: 使用自然语言查找历史信息（"找一下关于登录逻辑的讨论"）。
• 离线优先: 内置向量模型，无需联网下载，国内环境安装成功率 100%。

查看 v2.0.1 详细发布说明 & 架构图

🚀 核心亮点

💾 持久化记忆

• ✅ 语义搜索历史消息
• ✅ 对话永久保存
• ✅ 随时恢复上下文
• ✅ 多任务并行管理

🌿 Git 自动集成

• ✅ 自动创建任务分支
• ✅ 文件变更追踪
• ✅ 代码统计分析
• ✅ 完整版本控制

🎯 智能体快启

• ✅ /pm-start 产品设计
• ✅ /fe-start 前端开发
• ✅ /be-start 后端开发
• ✅ /qa-start 质量保证

📊 Thread Manager vs 原生 Claude

| 功能 | 原生 Claude | Thread Manager | 提升 | |------|------------|----------------|------| | 上下文记忆 | ❌ 重启丢失 | ✅ 永久保存 | ∞ | | 多任务管理 | ❌ 单线程 | ✅ 无限并行 | 10x+ | | 任务恢复 | ❌ 无法恢复 | ✅ 完整恢复 | 新增 | | 版本控制 | ⚠️ 手动 | ✅ 自动 | 3x | | 工作效率 | 100% | 200%+ | 2x |

🎮 基础使用

创建任务线程（自动初始化角色）

/pm-start "设计电商购物车功能"
  ↓ 自动创建产品线程
  ↓ AI 立即以产品经理身份分析需求
  ↓ 对话历史永久保存

多任务并行开发

/be-start "实现购物车 API"      # 线程 1: 后端开发
/fe-start "设计购物车UI"         # 线程 2: 前端开发
/qa-start "测试购物车功能"       # 线程 3: QA 测试

/threads                        # 查看所有线程进度

切换线程（完整上下文恢复）

/thread switch abc123
  ↓ AI 立即加载线程 abc123 的所有历史对话
  ↓ 文件变更、代码统计一并恢复
  ↓ 就像从未离开过这个任务

💡 核心命令

| 命令 | 功能 | 示例 | |------|------|------| | /threads | 查看所有线程 | 列出任务、消息数、文件变更 | | /thread switch <id> | 切换线程 | 完整恢复历史上下文 | | /pm-start "任务" | 产品经理线程 | 创建线程 + 需求分析 | | /fe-start "任务" | 前端开发线程 | 创建线程 + UI 开发 | | /be-start "任务" | 后端开发线程 | 创建线程 + API 开发 | | /qa-start "任务" | QA 测试线程 | 创建线程 + 执行测试 |

🔥 实际应用场景

多任务并行开发:

# 同时进行 3 个功能开发
/pm-start "用户认证系统"        # 线程 1: 产品设计
/be-start "支付接口集成"        # 线程 2: 后端开发
/fe-start "数据可视化大屏"      # 线程 3: 前端开发

# 随时切换，零上下文损失
/threads                        # 查看所有任务进度
/thread switch abc123           # 切换到认证系统

长期项目管理:

# 项目周期 3 个月，AI 记住每一次对话
/pm-start "企业 ERP 系统设计"
# ... 3 个月后 ...
/thread switch abc123           # AI 完整恢复 3 个月前的上下文

团队协作共享:

# 开发者 A
/pm-start "新功能设计"          # 线程 ID: abc12345

# 开发者 B（另一台电脑）
clt abc12345                    # 恢复 A 的完整上下文

📝 Changelog Generator Skill - 智能变更日志生成器

# 1. 快速生成 HTML 格式变更日志
changelog-generate generate --all --format html

# 2. 发布新版本并创建 GitHub Release
changelog-generate release --github-release

# 3. 增量更新
changelog-generate update

💡 为什么选择它？

• 零配置启动：内置最佳实践配置，开箱即用
• 完全自动化：从 Git 历史到 GitHub Release，一键完成
• 专业级输出：不仅是 Markdown，更能生成交互式 HTML 报告
• 高度可定制：通过 Handlebars 模板完全掌控输出格式

📜 SoftCopyright Skill - 智能软著材料生成工具

✨ 一键生成软件著作权申请材料，让软著申请变得简单高效！

🌟 核心功能特色

| 📋 智能项目分析 | 📄 HTML文档生成 | 🔄 版本自动识别 | 🖨️ 完美打印支持 | |-------------|--------------|--------------|-------------| | 自动识别项目类型、技术栈和架构模式 | 生成符合要求的软件说明书和源代码文档 | 从package.json等配置文件自动读取版本号 | 支持浏览器打印为PDF，页眉页脚自动添加 | | 支持README解析，无package.json时智能识别项目 | 每页50行代码，符合软著页数要求 | 支持多语言项目（JavaScript、Python、Java等） | 智能注释清理，只保留有效代码 |

🎯 软著申请完全支持

核心功能

• ✅ 软件说明书：自动生成2000-3000字详细说明书，包含项目概述、功能模块、技术架构等
• ✅ 源代码文档：自动生成60页源代码文档，每页50行，完全符合软著申请要求
• ✅ 智能页数控制：≤60页完整显示，>60页显示前30页+后30页，中间省略
• ✅ 注释自动清理：自动移除单行注释、多行注释、空白行、版权声明等
• ✅ 中文完美支持：原生HTML格式，中文显示无乱码，打印支持

技术规格

• 源码展示格式：每页50行，自动分页，行号显示
• 注释处理规则：
  • 多行注释：/\*(.|\r\n|\n)*?\*/
  • 单行注释：//.*
  • 空白行：^\s*(?=\r?$)\n
  • 版权声明：自动移除copyright、author、license等
• 支持语言：JavaScript、Python、Java、C、C++、Go、Rust、Swift、Kotlin等20+语言

💡 使用方法详解

简单三步，生成专业软著材料

1. 📊 扫描分析项目

   用户: "帮我生成软著"
   Claude: 自动扫描项目 → 分析源码 → 识别技术栈 → 生成文档
   

2. 📄 生成申请材料

   自动生成:
   - 软件说明书.html (符合要求的详细描述)
   - 源代码文档.html (60页，每页50行)
   - 版本信息自动识别 (从package.json、README等)
   

3. 🖨️ 导出PDF文档

   浏览器打开HTML文件 → Cmd+P → 勾选"页眉和页脚" → 保存为PDF
   

高级功能

• 项目路径指定：支持任意目录的软著材料生成
• 输出目录自定义：可指定生成文件的保存位置
• README智能解析：没有package.json时，从README读取项目名称和版本
• 批量处理：支持多个项目同时生成软著材料

🎨 使用场景示例

Web开发项目

"帮我生成React电商系统的软著材料"
# 自动识别：
# - 项目类型：React + JavaScript前端
# - 技术栈：React、Redux、Webpack
# - 版本号：从package.json读取
# - 生成完整的软著申请文档

后端项目

"生成Python Django项目的软著材料"
# 自动识别：
# - 项目类型：Python Django后端
# - 源码文件：.py、.html、.css等
# - 页数控制：按软著要求生成
# - 注释清理：移除Python注释和文档字符串

🧹 TidyMyDesktop Skill - 智能桌面整理工具

✨ 让您的桌面和目录焕然一新！智能分类、版本去重、安全整理

🌟 核心功能特色

| 🎯 智能文件分类 | 🔄 版本自动去重 | 🔍 未知软件识别 | 🛡️ 安全整理保障 | |--------------|---------------|----------------|----------------| | 应用程序、文档、图片、视频等自动分类 | 识别软件版本号，保留最新版本，清理旧版本 | 通过网络搜索识别不熟悉软件的用途 | dry-run模式预览，用户确认后执行 | | 创建分类文件夹，整洁有序 | 智能比较版本新旧，避免误删 | 标记需要人工审核的项目 | 所有删除操作需要明确确认 |

💡 实用整理场景

| 🏠 桌面整理 | 📁 目录整理 | 🧹 版本清理 | 📊 整理报告 | |------------|------------|------------|------------| | 一键整理桌面，告别混乱文件 | 整理指定目录，提高工作效率 | 自动识别软件版本，清理冗余文件 | 生成详细报告，记录整理过程 |

🛠️ 使用方法

简单三步，智能整理

1. 🏠 整理桌面

   用