Projects Manager Pro（完整版 VSCode 插件）

面向多模块/多服务工程的"项目管家 + AI 助手"一体化插件：模块树视图、工作区/模块的 zip 导入导出、远端 Git 资产仓双向同步，并内置完整 AI 对话能力（CodeBuddy / MCP / Skill / Rule）。

为什么用它

如果你在维护一个多模块、多服务的工程仓库（每个模块一个文件夹、模块下若干 Git 子仓服务），并且：

想在 VSCode 里一眼看清所有模块与服务，不用反复打开文件管理器
需要把整个工作区或某些模块打包发给同事 / 跨设备迁移，且能自动 git clone 服务源码
团队希望把工作区的文档资产同步到一个 Git 仓库，但不想破坏既有的服务源码仓结构
想在 VSCode 里直接和 AI 一起改代码，并把当前模块/服务/选区作为上下文传给 AI

这个插件就是为这些场景设计的——它和「工程项目管理（轻量版）」共享同一套模块树/导入导出能力，并额外把桌面端的 AI 对话整套搬进 VSCode 侧边栏。

功能一览

🤖 AI 助手（侧边栏）

独立活动栏图标「Projects Manager Pro - AI 助手」，提供完整的 AI 对话面板：

多会话管理：新建对话、历史对话切换，按工作区持久化
服务/模块上下文：右键模块或服务可"在此模块/服务创建对话"，AI 自动绑定该路径作为工作目录
选区入对话：编辑器内 Cmd+Shift+L / Ctrl+Shift+L（或右键菜单「将选区加入 AI 对话」）一键把当前选区/整文件抛进对话框
MCP 工具集成：内置 MCP 配置面板，可接入任意符合 Model Context Protocol 的工具服务
Skill / Rule 管理：项目级技能（.codebuddy/skills/<name>/SKILL.md）与规则（.codebuddy/rules/*.mdc）通过设置面板可视化管理
首次使用会引导登录 CodeBuddy 账号；token 落在 VSCode globalStorage 下，与桌面端互不污染

🌲 模块树视图

按工作区根目录下的 module.json 自动发现模块；每个模块下展示其服务，并标出缺失的关键文档。

左键：在文件管理器中定位
右键模块：在此模块创建 AI 对话、导出此模块、在文件管理器中显示
右键服务：在此服务创建 AI 对话、在终端打开、在文件管理器中显示
视图标题栏：刷新、打开 AI 助手、导入工作区/模块包、导出整个工作区

📦 工作区 / 模块导入导出

把工作区或选定模块打包成一个 zip，内含：

工作区总览文档（WorkspaceOverview.md 等）
模块配置 (module.json) 与文档（架构总览、技术决策知识库）
各服务的 feature_desc.md
各服务的 Git remote 地址（凭证已自动剥离）

导入时插件会：

解压 zip、分析与目标工作区的冲突
让你逐项决定「覆盖 / 跳过」
写入文档 + 并发 git clone 自动拉取服务源码

☁️ 远端 Git 资产仓双向同步

把工作区文档（manifest + 各级 md/json）双向同步到一个 Git 仓库，免去手工传 zip。

绑定向导：输 URL 后自动列出远端分支供选择；空仓自动首推、非空仓让你选订阅哪些模块
拉取：智能 rebase，远端无新提交直接短路返回
推送：自动新建 feature/<用户名>_<时间戳> 分支并 push，由你在 git 平台发起 MR 合入主分支（不会直接污染绑定分支）
订阅管理：full 双向 / partial 只读订阅；全选自动转 full 模式
状态感知：本地与远端 HEAD 差异时主动提示「远端有更新，建议先拉取」

快速上手

前置要求

VSCode ≥ 1.85
系统已安装 Git（git --version 可用）
Git 凭证已配好（SSH key 或 git credential helper），插件不持有任何凭证
使用 AI 对话需要可访问 CodeBuddy 服务的网络环境

安装

VSCode 扩展面板（Cmd+Shift+X / Ctrl+Shift+X）搜索 Projects Manager Pro 或 peirongyan，点击安装。

工作区约定

插件以 module.json 为事实源，工作区结构需符合：

<工作区根>/
├── WorkspaceOverview.md            # 可选：工作区总览
├── workspace-overview.json         # 可选：总览版本记录
├── <模块文件夹>/
│   ├── module.json                 # 必需：声明模块名、服务列表
│   ├── EngineeringArchOverview.md  # 推荐：模块架构总览
│   ├── TechnicalDecisionKB.md      # 推荐：模块技术决策
│   └── <服务仓库>/
│       └── feature_desc.md         # 推荐：服务功能描述

module.json 最小示例：

{
  "name": "支付模块",
  "folderName": "payment",
  "services": ["payment-api", "payment-worker"]
}

使用

在 VSCode 中打开工作区根目录
左侧活动栏会出现两个图标：
- 「Projects Manager Pro」：模块/服务树，导入导出入口
- 「Projects Manager Pro - AI 助手」：AI 对话面板
推荐分屏布局：模块树在左、AI 助手在右（视图标题栏「分屏布局提示」会指引）
在模块/服务上右键即可一键开启对应上下文的 AI 对话

命令列表

均可在命令面板（Cmd+Shift+P / Ctrl+Shift+P）中搜索 Projects Manager Pro 触发：

打开 AI 助手 / 新建对话 / 打开历史对话 / 打开设置面板
刷新工作区
导出整个工作区... / 导出此模块... / 导入工作区/模块包...
在文件管理器中显示 / 在终端中打开
在此模块创建对话 / 在此服务创建对话
触发工作区模块汇总检查
将选区加入 AI 对话（空选区则整文件）（默认快捷键 Cmd+Shift+L / Ctrl+Shift+L）

与轻量版的关系

本插件与「工程项目管理」（peirongyan.manage-vscode-extension）共享同一套模块树 / 导入导出 / 资产仓实现（来自 monorepo 的 packages/*），并在此基础上额外内置了完整 AI 对话能力（CodeBuddy / MCP / Skill / Rule）。

只需要项目管理 → 装轻量版即可
需要在 VSCode 内一站式 "项目管理 + AI 编码" → 装本插件
不要同时安装两者，活动栏会出现重复入口

隐私与安全

插件不上传任何工作区文件到外部服务器；AI 对话内容仅发往用户登录的 CodeBuddy 账号
Git 凭证仅由系统的 git credential helper 处理，插件不接触
导出 zip 时会自动剥离 Git URL 中的 user:token@ 凭证段，避免误传他人
CodeBuddy 登录 token 落在 VSCode globalStorage/peirongyan.projects-manager-pro/codebuddy/auth.json，受 VSCode 扩展沙箱隔离

反馈与问题

发现问题或希望新增功能，欢迎提 issue 或联系作者。

License

MIT

Projects Manager Pro

peirongyan