feat(wecom): 企微 MCP 增加开发计划版本与任务查询

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/企微API插件-配置手册.md

@@ -130,6 +130,7 @@ HQ 页也会展示 Base URL 与 Header 名（不含密钥）。
 | `promo.read` | `/promo-codes`、`/promo-codes/{code}/stats` | `query_promo_codes`、`query_promo_code_stats` |
 | `store.audit.read` | `/store-audits`、`/store-info-audits`、`/store-info-audits/{id}`、`/store-package-audits`、`/store-package-audits/{id}` | `query_store_audits` 等 5 个 |
 | `partner.read` | `/partners`、`/partners/{partnerId}/users|stores|orders` | `query_partners` 等 4 个 |
+| `dev_plan.read` | `/versions`、`/tasks` | `query_versions`、`query_tasks` |
 
 **实例建议：**
 
@@ -138,6 +139,7 @@ HQ 页也会展示 Base URL 与 Header 名（不含密钥）。
 | 日常运营 | metrics + order + user + store + promo + redeem |
 | 审核值班 | 上表 + store.audit.read |
 | 合伙人分析 | 上表 + partner.read |
+| 开发计划 | `dev_plan.read`（已有实例需在 HQ 补勾才会出现这两个工具） |
 
 ---
 
@@ -379,6 +381,49 @@ HQ 页也会展示 Base URL 与 Header 名（不含密钥）。
 
 ---
 
+### 5.16 查询开发版本
+
+| 项 | 值 |
+|----|-----|
+| 权限 | `dev_plan.read` |
+| 路径 | `/versions` |
+| MCP | `query_versions` |
+
+**输入（均可选）：**
+
+| 参数 | 位置 | 类型 | 模型可见 | 说明 |
+|------|------|------|----------|------|
+| q | Query | String | 是 | 版本号或说明，如 `v3.5.18` |
+| status | Query | String | 是 | `PENDING` 待启动 / `IN_PROGRESS` 开发中 / `TESTING` 测试 / `RELEASED` 已上线 / `STOPPED` 已停止 |
+| page / pageSize | Query | Integer | 否 | 分页 |
+
+**`data.items[]`：** versionNo、content、status、statusLabel、createdAt、releasedAt
+
+---
+
+### 5.17 查询开发任务
+
+| 项 | 值 |
+|----|-----|
+| 权限 | `dev_plan.read` |
+| 路径 | `/tasks` |
+| MCP | `query_tasks` |
+
+按**任务状态**筛选。可同时用 `q`、`versionNo`。
+
+**输入（均可选）：**
+
+| 参数 | 位置 | 类型 | 模型可见 | 说明 |
+|------|------|------|----------|------|
+| status | Query | String | **是** | `TODO` 待开发 / `IN_PROGRESS` 开发中 / `DEVELOPED` 已开发 / `RELEASED` 已上线 / `STOPPED` 已停止 |
+| q | Query | String | 是 | 任务编号或内容 |
+| versionNo | Query | String | 是 | 精确版本号，如 `v3.5.18`；传入则只返回该版本下任务 |
+| page / pageSize | Query | Integer | 否 | 分页 |
+
+**`data.items[]`：** taskNo、content、type、typeLabel、status、statusLabel、creatorName、supportTicketNo、versions[]、createdAt、completedAt。不含附件 URL。
+
+---
+
 ## 7. OpenAPI 导入
 
 | 项 | 值 |

docs/杜康好客-v3-现状对照.md

@@ -74,6 +74,7 @@
 
 | 日期 | 说明 |
 |------|------|
+| 2026-09-08 | 企微 MCP/REST 插件增加 `dev_plan.read`：`query_versions` / `query_tasks`（按任务状态筛选） |
 | 2026-09-08 | v3.5.18：企微插件增加 Streamable HTTP MCP 端点 `/api/v1/wecom/plugin/mcp`，与 REST/OpenAPI 并存 |
 | 2026-09-08 | HQ「门店账户」主账号详情可 CRUD 店员子账号（`/admin/store-accounts/:id/staff`） |
 | 2026-09-06 | v3.5.17：企微 API 插件迁入 HQ「企微机器人 → API 插件」；多实例 Key + 工具权限；不再依赖 `WECOM_PLUGIN_*` env |

docs/杜康好客-v3.5.17-开发文档.md

@@ -56,6 +56,7 @@
 | `store.read` | `/stores`（名称搜索 + 评分/核销/累计核销/合伙人） |
 | `store.audit.read` | `/store-audits`、`/store-info-audits`、`/store-package-audits` 及 `/{id}` 对比详情 |
 | `partner.read` | `/partners`、`/partners/{id}/users|stores|orders`（可选 `from`/`to` 时间筛选） |
+| `dev_plan.read` | `/versions`、`/tasks`（MCP：`query_versions`、`query_tasks`，任务可按 status 筛选） |
 
 ---
 

docs/杜康好客-v3.5.18-开发文档.md

@@ -23,6 +23,7 @@
 | 响应 | JSON-RPC；**无** `{code,message,data}` 信封 |
 | 工具结果 | `JSON.stringify(查询结果)` |
 | 权限 | `tools/list` 只注册已勾选权限；QueryService 仍 `requirePerm` |
+| 开发计划 | `dev_plan.read` → `query_versions`、`query_tasks`（任务按 TODO/IN_PROGRESS/DEVELOPED/RELEASED/STOPPED 筛选） |
 
 生产：`https://api.dukanghaoke.com/api/v1/wecom/plugin/mcp`  
 测试：`https://api-test.dukanghaoke.com/api/v1/wecom/plugin/mcp`

docs/杜康好客-v3编码手册.md

@@ -48,7 +48,7 @@ C 端购酒核销 · 门店扫码核销+打款 · 合伙人拓店履约 · WebAd
 
 **HQ 企微报告（v3.5.15）**：企微机器人下「报告」与「消息推送」分开。日报/周报/月报各配 Webhook 与发送时刻；走群机器人 markdown。账期截在发送日北京 0 点（前一天 24 点），不含发送当天：日报=昨日存量+当日新增；周报/月报=上一自然周/月期末存量+本期新增。用户=有效未合并；合伙人=主账号；订单笔数与金额均排除待支付 / 已取消 / 退款中；订单金额=已付 `payAmount`（`paidAt`）；核销=`RedeemRecord`。
 
-**企微 API 插件（v3.5.17 / MCP v3.5.18）**：实例在 HQ「企微机器人 → API 插件」维护；共用 Header `X-Api-Key`。REST `GET /api/v1/wecom/plugin/*` 与 MCP `POST /api/v1/wecom/plugin/mcp`（Streamable HTTP 无状态）并存；MCP 按权限自动 `tools/list`。经营指标含新增门店（`newStores`）；门店搜索含经营数据；支持门店/信息/套餐审核对照只读查询；支持按合伙人查关联用户/门店/订单（`from`/`to` 时间筛选）。
+**企微 API 插件（v3.5.17 / MCP v3.5.18）**：实例在 HQ「企微机器人 → API 插件」维护；共用 Header `X-Api-Key`。REST `GET /api/v1/wecom/plugin/*` 与 MCP `POST /api/v1/wecom/plugin/mcp`（Streamable HTTP 无状态）并存；MCP 按权限自动 `tools/list`。经营指标含新增门店（`newStores`）；门店搜索含经营数据；支持门店/信息/套餐审核对照只读查询；支持按合伙人查关联用户/门店/订单（`from`/`to` 时间筛选）；`dev_plan.read` 可查开发版本（`query_versions`）与按任务状态筛选的任务列表（`query_tasks`）。
 
 **HQ 列表（v3.5.9）**：主表不省略号、可横滑；最左序号；列设置（显隐/顺序）与列宽（拖表头）存 `hq_account.list_column_prefs`。主展示列下划线，点击进编辑或详情。门店列表「累计核销好客权益」= 该店 `RedeemRecord.amount` 合计。用户列表昵称只读（点击进详情）；双击「备注」离开即保存（`hq_remark`）；列表手机号不脱敏。
 

docs/杜康好客-知识库.md

@@ -151,7 +151,7 @@ HQ 账号/角色(`hq-permissions`，生效=(角色∪追加)−撤销；可绑
 |------|------|
 | 智能机器人 | `/wecom/bots` 长连接指令 |
 | API 插件 | HQ `/wecom/plugins` 多实例；`/api/v1/wecom/plugin` Header `X-Api-Key` 只读查询（与长连接独立） |
-| MCP 插件 | 同上 Key；`POST /api/v1/wecom/plugin/mcp` Streamable HTTP；`tools/list` 按权限过滤 |
+| MCP 插件 | 同上 Key；`POST /api/v1/wecom/plugin/mcp` Streamable HTTP；`tools/list` 按权限过滤；`dev_plan.read` → `query_versions` / `query_tasks` |
 | 消息推送 | `/wecom/pushes` Webhook+eventKey |
 | 日志 | `/logs/wecom-bots` |
 | C 端微信客服 | 系统设置 `CUSTOMER_SERVICE_WECOM_URL` + `WECOM_CORP_ID`；小程序须已关联该企业微信客服 |