Metadata-Version: 2.4
Name: wb-clouddoc-suite-mcp
Version: 1.0.0
Summary: 一站式文档套件：云端文档协作 + 本地 Office 深度处理 + 免密钥生成与 OCR
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.2.0
Requires-Dist: requests
Requires-Dist: python-docx
Requires-Dist: python-pptx
Requires-Dist: openpyxl
Requires-Dist: Pillow
Requires-Dist: PyYAML

# 云文档协作助手（clouddoc-suite）—— 云端协作 + 本地 Office 深度处理

**开发者：牛魔科技工作室**

一站式文档套件连接器：
- **云端协作**：对接**开放平台**（`open.feishu.cn`，应用身份零交互），自然语言创建、编辑、
  搜索、协作在线文档（云文档 / 云空间文件 / 多维表格 / 消息通知）；
- **本地 Office 深度处理**（od_* 工具族）：Word / Excel / PPT / PDF 的创建、编辑、排版、
  长文档自动化（目录/页眉/编号/图表索引/交叉引用）、深度分析与图表、文档翻译、
  Markdown 互转、发票识别台账、模板管理与批量格式转换——文件不出本机，零密钥可用；
- **本地免密钥生成**：DOCX/PPTX/思维导图/流程图生成与 OCR。

## 工具族总览（130 个）

| 家族 | 前缀/代表工具 | 是否需要 Key |
|------|------|--------------|
| 云文件/文件夹 | `cdoc_file_*` `cdoc_folder_*` | 需要 |
| 多维表格/电子表格（云） | `cdoc_dbt_*` `cdoc_et_*` | 需要 |
| 权限/分享/消息 | `cdoc_file_permission` `cdoc_notification_send` | 需要 |
| 本地免密钥生成 | `cdoc_local_*` `cdoc_ocr_*` | **无需** |
| 本地 Office 深度处理 | `od_word_*` `od_excel_*` `od_ppt_*` `od_convert` `od_template` `od_engine` | **无需** |
| 智能画布/对比/合规/协同 | `cdoc_element_*` `cdoc_compare_*` `cdoc_compliance_*` | 部分 |

> **云端未提供等效 REST 接口的能力**（回收站、版本历史、表单、格式转换等）调用会明确报错；
> 其中格式转换、回收站整理等需求可直接用 od_* 本地工具族完成。

## 首次配置（仅云端能力需要）

> 云端层对接开放平台，需自建应用获取凭证（注册入口见连接器配置页的帮助链接）。

1. 从连接器配置页的帮助链接进入开放平台开发者后台，登录后点击「创建应用 → 企业自建应用」
   （个人用户可顺手建一个免费「企业/组织」，无需营业执照）；
2. 复制 **App ID**（cli_ 开头）与 **App Secret**；
3. 「权限管理」勾选所需权限（云文档/云空间/多维表类）；部分权限需发布版本后生效；
4. 将 `config.example.json` 复制为连接器根目录的 `config.json`，填入真实值；
   或直接在连接器配置表单填入（凭证仅存本机）。

鉴权：`tenant_access_token` 应用身份，`App ID`+`App Secret` 直接换取，无需浏览器回调。
也可用环境变量 `CLOUDDOCS_CONFIG` 指定 config 路径；缺少 config 时云端工具返回中文指引，
本地能力（cdoc_local_* / od_* 全族）不受影响。

## 运行

由 WorkBuddy 按 `mcp.json` 自动拉起（`uvx wb-clouddoc-suite-mcp==1.0.0`）。

## 安全

- Token 仅存内存，不落盘；明文 App Secret 只来自本地 config/连接配置，绝不进入源码
- 429 限流自动指数退避重试（最多 5 次）
- 默认拦截 `.exe/.bat/.ps1/.zip` 等上传类型
- 按本机 CPU/内存自动分配并发，不拖累电脑

## 反馈

有更好建议：njskills@agent.qq.com
