sutong
750f981c7e
资源中心——从多渠道获取资源链接，转存到夸克网盘并整理归档。 - sources/tencent-doc: 腾讯文档读取 - sources/search: 网盘搜索 - storage/quark: 夸克网盘操作 - ref/: 来源 skill 参考归档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# 腾讯文档 — 维护
|
||
|
||
## 信息来源
|
||
|
||
本文档来源于以下参考项目。当工具调用方式变更时，查阅 `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/` 版本。
|