fix: resolve website issues - deprecated tools, broken links, missing install guides

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "yuque-personal",
-      "description": "语雀个人版 — 个人知识库 AI 集成，25 MCP Tools + 4 Skills",
+      "description": "语雀个人版 — 个人知识库 AI 集成，16 MCP Tools + 8 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"
@@ -20,7 +20,7 @@
     },
     {
       "name": "yuque-group",
-      "description": "语雀团队版 — 团队知识库 AI 集成，25 MCP Tools + 6 Skills",
+      "description": "语雀团队版 — 团队知识库 AI 集成，16 MCP Tools + 6 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,5 @@
 blank_issues_enabled: false
 contact_links:
   - name: Questions
-    url: https://github.com/yuque/yuque-ecosystem/discussions/categories/q-a
+    url: https://github.com/yuque/yuque-ecosystem/issues
     about: Ask questions and get help from the community.
-  - name: Feature Requests
-    url: https://github.com/yuque/yuque-ecosystem/discussions/categories/ideas
-    about: Suggest new features or improvements.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,50 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected Area
+      description: Which part of the ecosystem would this feature apply to?
+      options:
+        - MCP Server (yuque-mcp)
+        - Website
+        - Claude Code Plugin
+        - OpenClaw Plugin
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Is it related to a frustration?
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered?
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or references?
+    validations:
+      required: false

README.en.md

@@ -25,11 +25,11 @@ yuque-ecosystem/
 ├── website/                  # Official website (GitHub Pages)
 ├── plugins/
 │   ├── claude-code/          # Claude Code Plugin (Marketplace)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   ├── opencode/             # OpenCode Plugin (MCP + Skills)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   └── openclaw/             # OpenClaw Plugin (Agent Skills)
 ├── shared/
 │   └── mcp-config/           # MCP config templates for various editors

README.md

@@ -25,11 +25,11 @@ yuque-ecosystem/
 ├── website/                  # Official website (GitHub Pages)
 ├── plugins/
 │   ├── claude-code/          # Claude Code Plugin (Marketplace)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   ├── opencode/             # OpenCode Plugin (MCP + Skills)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   └── openclaw/             # OpenClaw Plugin (Agent Skills)
 ├── shared/
 │   └── mcp-config/           # MCP config templates for various editors

plugins/claude-code/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
   "plugins": [
     {
       "name": "yuque-personal",
-      "description": "语雀个人版 — 个人知识库 AI 集成，25 MCP Tools + 4 Skills",
+      "description": "语雀个人版 — 个人知识库 AI 集成，16 MCP Tools + 8 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"
@@ -23,7 +23,7 @@
     },
     {
       "name": "yuque-group",
-      "description": "语雀团队版 — 团队知识库 AI 集成，25 MCP Tools + 6 Skills",
+      "description": "语雀团队版 — 团队知识库 AI 集成，16 MCP Tools + 6 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"

plugins/claude-code/AGENT-INSTALL.md

@@ -60,7 +60,7 @@ export YUQUE_TOKEN="your_token_here"
 
 ## Installation Method 2: MCP Server Only
 
-Use this if you only need the 25 MCP tools without skills, or if the marketplace is unavailable.
+Use this if you only need the 16 MCP tools without skills, or if the marketplace is unavailable.
 
 ### Install
 
@@ -93,7 +93,7 @@ After either installation method, verify the integration is working:
 ```bash
 claude mcp list
 # Look for "yuque-mcp" in the output
-# Should show ~25 tools available
+# Should show ~16 tools available
 ```
 
 ### Test 2: Quick Functional Test
@@ -126,15 +126,16 @@ cd /path/to/yuque-ecosystem
 
 ## Available After Installation
 
-### MCP Tools (25)
+### MCP Tools (16)
 
 | Category | Tools |
 |----------|-------|
-| Document Management | `yuque_search`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc`, `yuque_delete_doc`, `yuque_get_doc_history` |
-| Knowledge Base | `yuque_list_repos`, `yuque_get_repo`, `yuque_create_repo`, `yuque_update_repo`, `yuque_delete_repo`, `yuque_get_toc` |
-| User & Group | `yuque_get_user`, `yuque_list_groups`, `yuque_get_group`, `yuque_list_group_repos` |
-| Collaboration | `yuque_list_comments`, `yuque_create_comment`, `yuque_delete_comment` |
-| Statistics | `yuque_get_doc_stats`, `yuque_get_repo_stats`, `yuque_get_group_stats`, `yuque_get_group_member_stats`, `yuque_get_trending_docs`, `yuque_get_active_members` |
+| User | `yuque_get_user` |
+| Search | `yuque_search` |
+| Books (知识库) | `yuque_list_books`, `yuque_get_book`, `yuque_create_book`, `yuque_update_book` |
+| Docs | `yuque_list_docs`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc` |
+| TOC | `yuque_get_toc`, `yuque_update_toc` |
+| Notes (小记) | `yuque_list_notes`, `yuque_get_note`, `yuque_create_note`, `yuque_update_note` |
 
 ### Skills (Marketplace install only)
 

plugins/claude-code/README.en.md

@@ -8,13 +8,13 @@
 
 ### Personal
 
-AI-powered personal knowledge base integration — 25 MCP Tools + 8 Skills.
+AI-powered personal knowledge base integration — 16 MCP Tools + 8 Skills.
 
 📂 [`../yuque-personal/`](../yuque-personal/)
 
 ### Group (Team)
 
-AI-powered team knowledge base integration — 25 MCP Tools + 6 Skills.
+AI-powered team knowledge base integration — 16 MCP Tools + 6 Skills.
 
 📂 [`../yuque-group/`](../yuque-group/)
 

plugins/claude-code/README.md

@@ -8,13 +8,13 @@
 
 ### Personal (个人版)
 
-Personal knowledge base AI integration — 25 MCP Tools + 8 Skills.
+Personal knowledge base AI integration — 16 MCP Tools + 8 Skills.
 
 📂 [`../yuque-personal/`](../yuque-personal/)
 
 ### Group (团队版)
 
-Team knowledge base AI integration — 25 MCP Tools + 6 Skills.
+Team knowledge base AI integration — 16 MCP Tools + 6 Skills.
 
 📂 [`../yuque-group/`](../yuque-group/)
 

plugins/openclaw/skills/daily-capture/SKILL.md

@@ -27,7 +27,7 @@ All tools are from the `yuque-mcp` server:
 - `yuque_get_doc` — Read existing capture log or thematic notes
 - `yuque_create_doc` — Create new capture log or thematic notes
 - `yuque_update_doc` — Append to capture log or update thematic notes
-- `yuque_list_repos` — List knowledge bases to find the target repo
+- `yuque_list_books` — List knowledge bases to find the target repo
 
 ## Workflow
 
@@ -209,7 +209,7 @@ Confirm: "主题笔记「[主题标题]」已保存到「[知识库名称]」：
 |-----------|--------|
 | Document not found (404) | Create a new capture log for today |
 | Permission denied (403) | Tell user they may lack permission to access or edit this document |
-| Target repo not found | List user's repos with `yuque_list_repos` and ask them to pick one |
+| Target repo not found | List user's repos with `yuque_list_books` and ask them to pick one |
 | `yuque_create_doc` fails | Present the capture/note in chat and suggest manual saving |
 | No captures found for organization | Inform user: "最近没有找到碎片记录，先随手记几条吧！" |
 | Capture content is empty | Ask user: "你想记录什么？" |

plugins/openclaw/skills/knowledge-connect/SKILL.md

@@ -24,8 +24,8 @@ Analyze documents in your Yuque knowledge base, find hidden connections between
 
 All tools are from the `yuque-mcp` server:
 
-- `yuque_list_repos` — List user's knowledge bases
-- `yuque_get_repo_docs` — List all documents in a knowledge base
+- `yuque_list_books` — List user's knowledge bases
+- `yuque_list_docs` — List all documents in a knowledge base
 - `yuque_get_doc` — Read document content for analysis
 - `yuque_search` — Search for potentially related documents
 - `yuque_update_doc` — Add cross-reference links to documents
@@ -48,13 +48,13 @@ User wants cross-repo connections. Analyze documents across multiple repos.
 For Case B/C, first list available repos:
 
 ```
-Tool: yuque_list_repos
+Tool: yuque_list_books
 ```
 
 Then list documents in the target repo(s):
 
 ```
-Tool: yuque_get_repo_docs
+Tool: yuque_list_docs
 Parameters:
   repo_id: "<namespace>"
 ```

plugins/openclaw/skills/reading-digest/SKILL.md

@@ -24,7 +24,7 @@ Read an article or document, extract core insights, golden quotes, and action it
 All tools are from the `yuque-mcp` server:
 
 - `yuque_get_doc` — Read full document content
-- `yuque_list_repos` — List user's knowledge bases (to find the target repo for saving)
+- `yuque_list_books` — List user's knowledge bases (to find the target repo for saving)
 - `yuque_create_doc` — Create a new document (to save reading notes)
 - `yuque_search` — Search for existing reading notes to avoid duplicates
 
@@ -161,6 +161,6 @@ If the user doesn't want to save, just present the reading notes in the chat.
 | Document not found (404) | Inform user the document may have been deleted or the link is incorrect |
 | Permission denied (403) | Tell user they may lack permission to access this document |
 | Document content is empty | Inform user: "该文档内容为空，无法生成阅读笔记" |
-| Target repo not found when saving | List user's repos with `yuque_list_repos` and ask them to pick one |
+| Target repo not found when saving | List user's repos with `yuque_list_books` and ask them to pick one |
 | `yuque_create_doc` fails | Inform user the save failed, present the notes in chat instead |
 | Article is not text-based (e.g., pure images) | Inform user: "该文档主要是图片内容，无法提取文字进行分析" |

plugins/openclaw/skills/smart-summary/SKILL.md

@@ -24,7 +24,7 @@ Generate summaries at different granularity levels for any Yuque document or ent
 All tools are from the `yuque-mcp` server:
 
 - `yuque_get_doc` — Read full document content by slug/id
-- `yuque_get_repo` — Get knowledge base metadata
+- `yuque_get_book` — Get knowledge base metadata
 - `yuque_list_docs` — List all documents in a knowledge base
 - `yuque_get_toc` — Get the table of contents of a knowledge base
 

plugins/openclaw/skills/stale-detector/SKILL.md

@@ -23,7 +23,7 @@ Scan a Yuque knowledge base to discover documents that haven't been updated in a
 
 All tools are from the `yuque-mcp` server:
 
-- `yuque_list_repos` — List user's knowledge bases
+- `yuque_list_books` — List user's knowledge bases
 - `yuque_list_docs` — List all documents in a knowledge base with metadata
 - `yuque_get_doc` — Read document content for staleness analysis
 - `yuque_get_toc` — Get knowledge base structure
@@ -39,7 +39,7 @@ Extract `repo_id` (namespace) from the provided link or name.
 List all repos first:
 
 ```
-Tool: yuque_list_repos
+Tool: yuque_list_books
 Parameters:
   user_id: "<user_id>"
 ```
@@ -190,7 +190,7 @@ These are suggestions only — do not take action without user confirmation.
 
 | Situation | Action |
 |-----------|--------|
-| Knowledge base not found | Inform user and suggest listing their repos with `yuque_list_repos` |
+| Knowledge base not found | Inform user and suggest listing their repos with `yuque_list_books` |
 | Knowledge base is empty | Inform user: "这个知识库目前没有文档，无需体检" |
 | `yuque_list_docs` returns error | Inform user of the issue, suggest checking the knowledge base link |
 | Too many documents (100+) | Analyze metadata for all, but only deep-read the top 10 stalest documents |

plugins/openclaw/skills/style-extract/SKILL.md

@@ -24,8 +24,8 @@ Analyze your existing Yuque documents to extract your unique writing style — v
 
 All tools are from the `yuque-mcp` server:
 
-- `yuque_list_repos` — List user's knowledge bases
-- `yuque_get_repo_docs` — List documents in a knowledge base
+- `yuque_list_books` — List user's knowledge bases
+- `yuque_list_docs` — List documents in a knowledge base
 - `yuque_get_doc` — Read document content for style analysis
 - `yuque_search` — Find specific types of documents for analysis
 - `yuque_create_doc` — Save the style profile as a document
@@ -46,11 +46,11 @@ User specifies a knowledge base. Sample documents from it.
 If the user isn't sure, search for their most substantial documents:
 
 ```
-Tool: yuque_list_repos
+Tool: yuque_list_books
 ```
 
 ```
-Tool: yuque_get_repo_docs
+Tool: yuque_list_docs
 Parameters:
   repo_id: "<namespace>"
 ```

plugins/opencode/AGENT-INSTALL.md

@@ -195,15 +195,16 @@ Expected: Returns matching documents from your Yuque knowledge base.
 
 ## Available After Installation
 
-### MCP Tools (25)
+### MCP Tools (16)
 
 | Category | Tools |
 |----------|-------|
-| Document Management | `yuque_search`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc`, `yuque_delete_doc`, `yuque_get_doc_history` |
-| Knowledge Base | `yuque_list_repos`, `yuque_get_repo`, `yuque_create_repo`, `yuque_update_repo`, `yuque_delete_repo`, `yuque_get_toc` |
-| User & Group | `yuque_get_user`, `yuque_list_groups`, `yuque_get_group`, `yuque_list_group_repos` |
-| Collaboration | `yuque_list_comments`, `yuque_create_comment`, `yuque_delete_comment` |
-| Statistics | `yuque_get_doc_stats`, `yuque_get_repo_stats`, `yuque_get_group_stats`, `yuque_get_group_member_stats`, `yuque_get_trending_docs`, `yuque_get_active_members` |
+| User | `yuque_get_user` |
+| Search | `yuque_search` |
+| Books (知识库) | `yuque_list_books`, `yuque_get_book`, `yuque_create_book`, `yuque_update_book` |
+| Docs | `yuque_list_docs`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc` |
+| TOC | `yuque_get_toc`, `yuque_update_toc` |
+| Notes (小记) | `yuque_list_notes`, `yuque_get_note`, `yuque_create_note`, `yuque_update_note` |
 
 ### Personal Skills (8)