with one click
yuque-personal-stale-detector
// Detect stale and potentially outdated documents in your Yuque knowledge bases by analyzing update timestamps and content freshness signals. For personal/individual use — scans your own repos.
// Detect stale and potentially outdated documents in your Yuque knowledge bases by analyzing update timestamps and content freshness signals. For personal/individual use — scans your own repos.
Quickly capture ideas, thoughts, and fleeting notes to your personal Yuque knowledge base. For personal/individual use — saves to your own repos.
Discover connections between documents, build knowledge networks, and establish bidirectional links across your personal Yuque knowledge base. For personal/individual use — operates on your own docs.
Refine and restructure existing notes into well-organized, deduplicated, and enriched documents in your personal Yuque knowledge base. For personal/individual use — reads and writes your own docs.
Quickly distill Yuque documents into structured reading digests with key takeaways, summaries, and reading notes. For personal/individual use — reads from your own knowledge bases.
Generate intelligent summaries for Yuque knowledge bases or multiple documents, providing a quick overview of content landscape and key insights. For personal/individual use — summarizes your own knowledge bases.
Analyze the writing style of Yuque documents and extract style characteristics including structure, tone, vocabulary, and formatting patterns. For personal/individual use — analyzes your own documents.
| name | yuque-personal-stale-detector |
| description | Detect stale and potentially outdated documents in your Yuque knowledge bases by analyzing update timestamps and content freshness signals. For personal/individual use — scans your own repos. |
| license | Apache-2.0 |
| compatibility | Requires yuque-mcp server connected to a Yuque account with personal Token |
| metadata | {"author":"chen201724","version":"2.0"} |
Scan your Yuque knowledge bases to detect documents that haven't been updated for a long time and may contain outdated information, helping you maintain a healthy and accurate knowledge base.
All tools are from the yuque-mcp server:
yuque_list_repos — List personal knowledge basesyuque_get_repo_toc — Get the table of contents with document metadatayuque_get_doc — Read document content to check for staleness signalsIf the user specifies a repo, use it directly. Otherwise, list available repos:
Tool: yuque_list_repos
Parameters:
type: "user"
Let the user pick which repo(s) to scan, or scan all if requested.
For each repo, get the table of contents:
Tool: yuque_get_repo_toc
Parameters:
repo_id: "<namespace>"
Extract from each document entry:
title — Document titleslug — Document identifierupdated_at — Last update timestampcreated_at — Creation timestampCalculate the age of each document (days since last update) and classify:
| Category | Age | Emoji |
|---|---|---|
| 🟢 新鲜 (Fresh) | < 90 days | Recently updated, likely current |
| 🟡 老化 (Aging) | 90-180 days | May need review |
| 🟠 陈旧 (Stale) | 180-365 days | Likely needs update |
| 🔴 过期 (Expired) | > 365 days | High risk of outdated content |
For documents classified as 🟠 or 🔴, optionally read their content to check for additional staleness signals:
Tool: yuque_get_doc
Parameters:
repo_id: "<namespace>"
doc_id: "<slug>"
Look for:
Limit deep scanning to 5-10 documents to avoid excessive API calls.
## 🔍 知识库健康检查报告
### 📚 扫描范围
- **知识库**:「知识库名称」
- **文档总数**:X 篇
- **扫描时间**:YYYY-MM-DD
---
### 📊 整体健康度
| 状态 | 数量 | 占比 |
|------|------|------|
| 🟢 新鲜(<90天) | X 篇 | XX% |
| 🟡 老化(90-180天) | X 篇 | XX% |
| 🟠 陈旧(180-365天) | X 篇 | XX% |
| 🔴 过期(>365天) | X 篇 | XX% |
**健康评分:X/10**
---
### 🔴 需要立即关注(过期文档)
| # | 文档标题 | 最后更新 | 已过天数 | 风险说明 |
|---|----------|----------|----------|----------|
| 1 | [标题](链接) | YYYY-MM-DD | X 天 | [如:包含版本号引用] |
| 2 | [标题](链接) | YYYY-MM-DD | X 天 | [如:含有时间敏感内容] |
### 🟠 建议检查(陈旧文档)
| # | 文档标题 | 最后更新 | 已过天数 |
|---|----------|----------|----------|
| 1 | [标题](链接) | YYYY-MM-DD | X 天 |
| 2 | [标题](链接) | YYYY-MM-DD | X 天 |
### 🟡 可以关注(老化文档)
[列出文档标题和更新时间,简要列表即可]
---
### 💡 维护建议
1. **优先处理**:[具体建议,如"XX 文档引用了 v2.x 版本,当前已是 v4.x"]
2. **批量更新**:[如"XX 板块的 X 篇文档都超过半年未更新,建议集中审查"]
3. **考虑归档**:[如"XX 文档可能已不再适用,建议归档或标记为历史文档"]
4. **定期检查**:建议每 [月/季度] 运行一次过期检测,保持知识库健康
---
### 📈 趋势观察
- **最活跃板块**:[哪个板块更新最频繁]
- **最冷门板块**:[哪个板块最久没动过]
- **更新模式**:[如"大部分更新集中在工作日","XX 板块有周期性更新"]
yuque-group plugin| Situation | Action |
|---|---|
yuque_list_repos returns empty | Ask user for the exact repo name or ID |
yuque_get_repo_toc returns empty | Inform user the knowledge base appears to be empty |
yuque_get_doc fails (404) | Note the document may have been deleted (itself a finding!) |
yuque_get_doc fails (403) | Tell user they may lack permission to access this doc |
| API timeout | Retry once, then inform user of connectivity issue |
| All documents are fresh | Congratulate the user on maintaining a healthy knowledge base! |
| Knowledge base has >100 docs | Use metadata-only analysis (skip deep scan), offer to deep scan specific sections |