发布：学生会策划部工作包（Skills + MCP）

2026-09-29 12:35:04 +08:00
commit 2df696c390
147 changed files with 50777 additions and 0 deletions
@@ -0,0 +1,37 @@
+# MCP 连接器（本包附带的配置与说明）
+
+本目录**只放配置模板与使用说明，不含任何凭据**。
+
+| 文件 | 用途 |
+| --- | --- |
+| `mcp.servers.example.json` | 推荐的 MCP 服务器定义（地址、超时、`${VAR}` 占位符），供迁移或参考 |
+| `connectors-recommended.md` | 推荐清单：优先级、用途、启用方式、暂不建议项 |
+
+## 在 WorkBuddy 中启用（推荐路径）
+
+这些连接器**已经内置**在 WorkBuddy 里——`connectors/default/mcp.json` 中存在对应的
+`connector:*` 条目，默认 `disabled: true`。正确做法：
+
+1. 打开【连接器】面板，搜索连接器名称（如"腾讯文档"）；
+2. 点击启用，按提示在浏览器完成 OAuth 授权；
+3. 授权后回到会话即可调用其工具。
+
+> ⚠️ **不要手改 `~/.workbuddy/mcp.json` 里的令牌字段**。OAuth 类连接器的凭据由宿主下发，
+> 手写常导致 `no_token` / 假 502。排错见 Skill `tencent-docs-mcp`。
+
+## 在 DSH（DeepSeek Harness）中启用
+
+DSH 不读取 WorkBuddy 的连接器面板。若要迁移，把 `mcp.servers.example.json` 中需要条目的
+`mcpServers` 合并进 DSH 的 MCP 配置，并按需去掉 `disabled` 字段；带 `${VAR}` 的项先设置环境变量。
+
+## 凭据与环境变量
+
+- **不放令牌**：本目录任何文件都不得写入 access token、API key、Cookie。
+- `tencent-map` 需要 `TENCENT_MAP_KEY`（腾讯位置服务控制台申请）。
+- 其余 OAuth 连接器由面板授权，无需手工填写。
+
+## 与 Skill 的配合
+
+- 腾讯文档 → Skill `skills/tencent-docs-mcp`
+- 腾讯问卷 → Skill `skills/tencent-survey`
+- 主体工作流（策划书、预算、通知、纪要、新闻稿、总结、PPT 大纲）→ Skill `skills/su-planning-office`
@@ -0,0 +1,31 @@
+# 推荐 MCP 连接器（学生会策划部工作流）
+
+按「先开三个核心，再按需加」的原则。一次启用 **≤ 4 个**——每个 MCP 都会把工具塞进上下文，
+开太多会拖慢判断、诱发误调用；不用的保持 `disabled: true`。
+
+| 优先级 | 连接器 | 给策划部的用处 | 类型 / 启用要点 |
+| --- | --- | --- | --- |
+| ★ 必开 | **腾讯文档** `tencent-docs` | 多人合稿策划书、在线分工表、素材目录；与 Skill `tencent-docs-mcp` 配套 | OAuth；`https://docs.qq.com/openapi/mcp` |
+| ★ 必开 | **腾讯问卷** `tencent-survey` | 报名、签到、满意度回收，替代用 Word 附件做统计；与 Skill `tencent-survey` 配套 | OAuth；`https://wj.qq.com/api/v2/mcp` |
+| ★ 必开 | **扫描全能王** `camscanner` | 发票、签收表、证书扫描 OCR → 报销附件归档，直接压住"缺凭证被退单" | OAuth；`https://ai-tools.camscanner.com/mcp` |
+| 推荐 | **WPS 金山文档** `kdocs` | 学院若统一用 WPS 写公文/表格，可替代腾讯文档（二者取一） | OAuth；`https://mcp-center.wps.cn/skill_hub/mcp` |
+| 推荐 | **创客贴** `chuangkit` | 海报、封面、展板批量出图；本包只负责文案与尺寸清单 | **CLI 型**（非 MCP）：`npm i -g @chuangkit-labs/agent-cli@0.1.3` → `ckt-agent auth login` |
+| 推荐 | **微云** `tencent-weiyun` | 现场照片/视频等大体积素材归档 | OAuth；`https://www.weiyun.com/api/v3/mcpserver` |
+| 可选 | **汉仪字体** `hanyi-fonts` | 海报用字的可商用授权，规避字体版权风险 | OAuth；`https://hanyi-mcp.hellofont.cn/mcp` |
+| 可选 | **腾讯地图** `tencent-map` | 场地导航、交通指引、外出/近岸活动路线 | 需先申请并设置 `TENCENT_MAP_KEY` |
+| 可选 | **Canva** `canva` | 偏国际化风格的设计需求 | OAuth；`https://mcp.canva.cn/mcp` |
+
+## 暂不建议
+
+- `edu-next`、`teacher-assistant`：面向教学场景，对策划部收益不明；
+- `dingtalk`：除非学校统一用钉钉；
+- `ezjoin-meeting`：在线会议 Agent 用不上（直接用腾讯会议客户端）；
+- `notion`：国内校园协作基本用不到。
+
+## 三条使用原则
+
+1. **OAuth 类走【连接器】面板 + 浏览器授权**，不要手改 `~/.workbuddy/mcp.json`——
+   凭据由宿主下发，手写常出现 `no_token` 或假 502（参见 Skill `tencent-docs-mcp` 的排错段）。
+2. **CLI 型**（创客贴、飞书 `lark-cli`）需要 Node ≥ 20 且会做全局 npm 安装；
+   装完先跑一次 `auth status` 确认已登录。
+3. **带环境变量的**（如 `tencent-map` 的 `${TENCENT_MAP_KEY}`）先配置变量再启用，否则连接必然失败。
@@ -0,0 +1,56 @@
+{
+  "_readme": "推荐 MCP 连接器示例（仅作参考/迁移用）。WorkBuddy 已内置这些连接器：其 connectors/default/mcp.json 中为 connector:* 条目且默认 disabled=true，请在【连接器】面板启用并在浏览器完成授权。切勿把真实令牌写进本文件——OAuth 类连接器的凭据由宿主下发。带 ${VAR} 的项需先设置对应环境变量。",
+  "mcpServers": {
+    "tencent-docs": {
+      "type": "streamableHttp",
+      "url": "https://docs.qq.com/openapi/mcp",
+      "timeout": 600000,
+      "disabled": false
+    },
+    "tencent-survey": {
+      "type": "streamableHttp",
+      "url": "https://wj.qq.com/api/v2/mcp",
+      "timeout": 30000,
+      "disabled": false
+    },
+    "camscanner": {
+      "type": "streamableHttp",
+      "url": "https://ai-tools.camscanner.com/mcp",
+      "timeout": 120000,
+      "disabled": false
+    },
+    "kdocs": {
+      "type": "streamableHttp",
+      "url": "https://mcp-center.wps.cn/skill_hub/mcp",
+      "timeout": 600000,
+      "staticHeaders": {
+        "X-Request-Source": "workbuddy"
+      },
+      "disabled": true
+    },
+    "tencent-weiyun": {
+      "type": "streamableHttp",
+      "url": "https://www.weiyun.com/api/v3/mcpserver",
+      "timeout": 60000,
+      "disabled": true
+    },
+    "canva": {
+      "type": "streamableHttp",
+      "url": "https://mcp.canva.cn/mcp",
+      "timeout": 60000,
+      "disabled": true
+    },
+    "hanyi-fonts": {
+      "type": "streamableHttp",
+      "url": "https://hanyi-mcp.hellofont.cn/mcp",
+      "timeout": 30000,
+      "disabled": true
+    },
+    "tencent-map": {
+      "type": "sse",
+      "url": "https://mcp.map.qq.com/sse?key=${TENCENT_MAP_KEY}&format=0",
+      "timeout": 30000,
+      "disabled": true
+    }
+  }
+}