# 腾讯文档 — 维护

## 信息来源

本文档来源于以下参考项目。当工具调用方式变更时，查阅 `ref/` 中对应副本获取最新用法：

| 当前模块内容 | 来源（ref/ 路径） | 说明 |
|-------------|------------------|------|
| 安装流程 | `ref/tencent-docs/SKILL.md`、`ref/tencent-docs/references/auth.md` | 腾讯文档 OAuth 授权 |
| 大文档读取（tencentdoc） | `ref/tx-doc-large-reader/SKILL.md` | `doc.resolve_document_structure` 替代方案 |
| Smartcanvas 读取 | `ref/tencent-docs/SKILL.md` | 官方分页读取 |

## 常见故障

### 1. Token 过期

**现象**：`mcporter call tencent-docs` 返回 `400006`

**解决**：重新授权

```bash
bash ref/tencent-docs/setup.sh tdoc_check_and_start_auth
```

→ 浏览器授权 → `bash ref/tencent-docs/setup.sh tdoc_fetch_token`

### 2. 工具调用报错 `-32603`

**现象**：`tool execution failed`

**解决**：
- 检查参数名和类型是否匹配
- `mcporter list tencent-docs --schema` 查看当前工具参数定义

### 3. 大文档读取超时

**现象**：`get_content` 5 秒超时

**解决**：改用 `doc.resolve_document_structure`（见 usage.md）

## 更新检查

腾讯文档 MCP 会更新版本。参考 `ref/tencent-docs/SKILL.md` 中的更新检查流程：

```bash
mcporter call "https://docs.qq.com/openapi/mcp" "check_skill_update" --args '{"version": "<当前版本>"}'
```

当 `ref/tencent-docs/` 有更新时，同步到本模块的 `v2/` 版本。