yuque-ai-mcp 2.7.9 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="https://cdn.nlark.com/yuque/0/2025/png/25689388/1749661212345-avatar/8a3b5c7d-1e2f-4a5b-9c7d-8e1f2a3b4c5d.png" width="120" alt="yuque-ai-mcp" />
2
+ <img src="https://raw.githubusercontent.com/yehuoshun/yuque-ai-mcp/main/assets/banner.png" width="800" alt="yuque-ai-mcp" />
3
3
  </p>
4
4
 
5
5
  <h1 align="center">yuque-ai-mcp</h1>
@@ -8,7 +8,7 @@
8
8
  </p>
9
9
 
10
10
  <p align="center">
11
- <a href="https://github.com/yehuoshun/yuque-ai-mcp"><img src="https://img.shields.io/badge/version-2.7.8-blue" alt="version" /></a>
11
+ <a href="https://github.com/yehuoshun/yuque-ai-mcp"><img src="https://img.shields.io/badge/version-2.8.0-blue" alt="version" /></a>
12
12
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license" /></a>
13
13
  <a href="https://github.com/yehuoshun/yuque-ai-skills"><img src="https://img.shields.io/badge/skills-63%20guides-orange" alt="skills" /></a>
14
14
  </p>
package/README_CN.md CHANGED
@@ -1,3 +1,7 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/yehuoshun/yuque-ai-mcp/main/assets/banner.png" width="800" alt="yuque-ai-mcp" />
3
+ </p>
4
+
1
5
  <p align="center">
2
6
  <h1 align="center">yuque-ai-mcp</h1>
3
7
  <p align="center">
@@ -6,7 +10,7 @@
6
10
  </p>
7
11
 
8
12
  <p align="center">
9
- <a href="https://github.com/yehuoshun/yuque-ai-mcp"><img src="https://img.shields.io/badge/版本-2.7.8-blue" alt="version" /></a>
13
+ <a href="https://github.com/yehuoshun/yuque-ai-mcp"><img src="https://img.shields.io/badge/版本-2.8.0-blue" alt="version" /></a>
10
14
  <a href="LICENSE"><img src="https://img.shields.io/badge/许可-MIT-green" alt="license" /></a>
11
15
  <a href="https://github.com/yehuoshun/yuque-ai-skills"><img src="https://img.shields.io/badge/skills-63%20指导-orange" alt="skills" /></a>
12
16
  </p>
package/SKILL.md CHANGED
@@ -149,6 +149,18 @@
149
149
 
150
150
  完整错误码及处理策略见 `references/api/errors.md`。
151
151
 
152
+ ## 🎯 降级策略(长文档 Fallback)
153
+
154
+ **触发场景**:`yuque_get_doc` 读取超长文档(>1MB 或超时)时 MCP stdio 可能撑爆缓冲区。
155
+
156
+ **自动降级链路**:
157
+
158
+ ```
159
+ yuque_get_doc ──(失败)──→ yuque_export_doc → 读本地文件 → 返回内容
160
+ ```
161
+
162
+ 执行方式:Agent 检测到 get_doc 失败 → 自动调用 `yuque_export_doc` + 本地 read 替代,不回退到直接 curl 语雀 API。
163
+
152
164
  ## 配置
153
165
 
154
166
  ```json
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "yuque-ai-mcp",
3
- "version": "2.7.9",
3
+ "version": "2.8.0",
4
4
  "description": "Full-featured Yuque MCP Server — 62 fine-grained tools covering the entire Yuque OpenAPI",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",