Back to Details

yuque-personal-note-refine

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Note Refine — Restructure & Polish Your Notes

笔记优化 — 重构并润色你的笔记

Help the user transform scattered, rough notes into well-structured, deduplicated, and enriched documents. Turn chaos into clarity.
帮助用户将零散、粗糙的笔记转换为结构清晰、去重且内容完善的文档，将混乱的内容变得条理分明。

When to Use

适用场景

  • User wants to clean up messy notes
  • User says "帮我整理笔记", "refine my notes", "把这些笔记理一下"
  • User has accumulated daily captures and wants to consolidate them
  • User says "这些笔记太乱了", "帮我重新组织一下", "去重整理"
  • 用户想要清理杂乱的笔记
  • 用户说 "帮我整理笔记", "refine my notes", "把这些笔记理一下"
  • 用户积累了很多日常随手记内容想要整合
  • 用户说 "这些笔记太乱了", "帮我重新组织一下", "去重整理"

Required MCP Tools

所需的MCP工具

All tools are from the 
yuque-mcp
server:
  • yuque_search
    — Find the target notes to refine
  • yuque_get_doc
    — Read the full content of notes
  • yuque_list_repos
    — List personal repos
  • yuque_list_docs
    — List documents in a repo
  • yuque_create_doc
    — Create the refined document
  • yuque_update_doc
    — Update the original document in place
所有工具都来自
yuque-mcp
服务端：
  • yuque_search
    — 查找需要优化的目标笔记
  • yuque_get_doc
    — 读取笔记的完整内容
  • yuque_list_repos
    — 列出个人知识库
  • yuque_list_docs
    — 列出某个知识库下的文档
  • yuque_create_doc
    — 创建优化后的新文档
  • yuque_update_doc
    — 直接更新原文档

Workflow

工作流程

Step 1: Identify the Source Notes

步骤1：确定源笔记范围

The user may provide:
  • A specific document to refine
  • A date range of daily captures to consolidate
  • A topic keyword to find related scattered notes
  • Multiple document references to merge
If the user says "整理我最近的笔记":
Tool: yuque_search
Parameters:
  query: "每日捕获"
  type: "doc"
Or for topic-specific notes:
Tool: yuque_search
Parameters:
  query: "<topic keyword>"
  type: "doc"
用户可能提供的信息：
  • 需要优化的某一篇特定文档
  • 需要整合的日常随手记的日期范围
  • 用来查找相关零散笔记的主题关键词
  • 需要合并的多个文档引用
如果用户说 "整理我最近的笔记":
Tool: yuque_search
Parameters:
  query: "每日捕获"
  type: "doc"
如果是特定主题的笔记：
Tool: yuque_search
Parameters:
  query: "<topic keyword>"
  type: "doc"

Step 2: Read All Source Notes

步骤2：读取所有源笔记内容

For each identified document:
Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
Read up to 5-10 source documents. If there are more, prioritize by recency and relevance.
对每一个识别到的文档：
Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
最多读取5-10篇源文档，如果数量更多，按发布时间和相关性优先读取。

Step 3: Analyze and Plan

步骤3：分析并规划整理方案

Before refining, analyze the raw content:
  1. Identify themes — Group related content by topic
  2. Find duplicates — Flag repeated ideas or information
  3. Spot gaps — Note where information is incomplete
  4. Assess structure — Determine the best organizational approach
Present the analysis to the user:
markdown
undefined
优化前，先分析原始内容：
  1. 识别主题 — 按主题对相关内容分组
  2. 查找重复内容 — 标记重复的观点或信息
  3. 定位信息缺口 — 记录信息不完整的位置
  4. 评估结构 — 确定最佳的内容组织方式
将分析结果展示给用户：
markdown
undefined

📋 笔记分析

📋 笔记分析

来源：X 篇文档，共约 XXXX 字
来源：X 篇文档，共约 XXXX 字

主题分布

主题分布

  • [主题 1]：X 条相关记录
  • [主题 2]：X 条相关记录
  • [主题 3]：X 条相关记录
  • [主题 1]：X 条相关记录
  • [主题 2]：X 条相关记录
  • [主题 3]：X 条相关记录

发现

发现

  • 🔄 发现 X 处重复内容
  • 🕳️ 发现 X 处信息缺口
  • 📊 建议整理为 X 篇主题文档
要按这个方向整理吗？
undefined
  • 🔄 发现 X 处重复内容
  • 🕳️ 发现 X 处信息缺口
  • 📊 建议整理为 X 篇主题文档
要按这个方向整理吗？
undefined

Step 4: Refine the Notes

步骤4：优化笔记内容

Based on user confirmation, perform the refinement:
基于用户的确认，执行优化操作：

4a. Single Document Refinement

4a. 单文档优化

Restructure one document:
  • Add clear headings and hierarchy
  • Remove duplicate content
  • Improve wording and clarity
  • Add missing context or transitions
  • Organize chronological notes into logical structure
重构单篇文档：
  • 添加清晰的标题和层级结构
  • 移除重复内容
  • 优化表述，提升清晰度
  • 补充缺失的上下文或过渡内容
  • 将按时间排序的笔记调整为逻辑结构

4b. Multi-Document Consolidation

4b. 多文档整合

Merge multiple notes into themed documents:
  • Group by topic
  • Deduplicate across documents
  • Create a coherent narrative
  • Preserve attribution (note original dates/sources)
Refined document template:
markdown
undefined
将多篇笔记合并为主题文档：
  • 按主题分组
  • 跨文档去重
  • 构建连贯的内容逻辑
  • 保留来源信息（标注原始日期/来源）
优化后的文档模板：
markdown
undefined

[主题标题]

[主题标题]

整理自 X 篇笔记，时间跨度：YYYY-MM-DD 至 YYYY-MM-DD 最后整理：YYYY-MM-DD
整理自 X 篇笔记，时间跨度：YYYY-MM-DD 至 YYYY-MM-DD 最后整理：YYYY-MM-DD

概述

概述

[对这个主题的整体概述，2-3 句话]
[对这个主题的整体概述，2-3 句话]

[分类 1]

[分类 1]

[子主题 1.1]

[子主题 1.1]

[整理后的内容]
[整理后的内容]

[子主题 1.2]

[子主题 1.2]

[整理后的内容]
[整理后的内容]

[分类 2]

[分类 2]

[子主题 2.1]

[子主题 2.1]

[整理后的内容]
[整理后的内容]

待补充

待补充

  • [识别出的信息缺口 1]
  • [识别出的信息缺口 2]
  • [识别出的信息缺口 1]
  • [识别出的信息缺口 2]

原始来源

原始来源

  • 原文档 1 标题 — YYYY-MM-DD
  • 原文档 2 标题 — YYYY-MM-DD
本文档由 AI 助手整理，原始笔记已保留。
undefined
  • 原文档 1 标题 — YYYY-MM-DD
  • 原文档 2 标题 — YYYY-MM-DD
本文档由 AI 助手整理，原始笔记已保留。
undefined

Step 5: Save the Refined Document

步骤5：保存优化后的文档

Ask the user's preference:
  • Create new — Save as a new document (recommended for multi-doc consolidation)
  • Update in place — Replace the original document (for single doc refinement)
For new document:
Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "[主题标题]"
  body: "<refined content>"
  format: "markdown"
For in-place update:
Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<refined content>"
询问用户的保存偏好：
  • 新建文档 — 保存为新文档（多文档整合场景推荐）
  • 原地更新 — 替换原文档（单文档优化场景适用）
新建文档的调用方式：
Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "[主题标题]"
  body: "<refined content>"
  format: "markdown"
原地更新的调用方式：
Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<refined content>"

Step 6: Confirm

步骤6：确认结果

markdown
✅ 笔记整理完成！

📄 **[[主题标题]](文档链接)**
📚 已保存到：「知识库名称」
markdown
✅ 笔记整理完成！

📄 **[[主题标题]](文档链接)**
📚 已保存到：「知识库名称」

整理成果

整理成果

  • 📥 输入：X 篇原始笔记，约 XXXX 字
  • 📤 输出：1 篇结构化文档，约 XXXX 字
  • 🔄 去除重复：X 处
  • 🕳️ 标记待补充：X 处
💡 原始笔记已保留，可随时对照。
undefined
  • 📥 输入：X 篇原始笔记，约 XXXX 字
  • 📤 输出：1 篇结构化文档，约 XXXX 字
  • 🔄 去除重复：X 处
  • 🕳️ 标记待补充：X 处
💡 原始笔记已保留，可随时对照。
undefined

Guidelines

使用规范

  • Always preserve the original notes — refine into a new document by default
  • Don't discard information during deduplication; merge and enrich instead
  • Maintain the user's voice and terminology — don't over-formalize casual notes
  • Flag uncertain interpretations with "【待确认】" markers
  • For daily captures, suggest a weekly or bi-weekly refinement cadence
  • If notes span multiple topics, create separate refined documents per topic
  • Add a "待补充" section for identified gaps — this helps the user know what to add later
  • Default language is Chinese
  • 始终保留原始笔记 — 默认将优化内容保存为新文档
  • 去重过程中不要丢弃信息，改为合并和丰富内容
  • 保留用户的表述风格和术语 — 不要将随意的笔记过度正式化
  • 用"【待确认】"标记不确定的解读内容
  • 对于日常随手记，建议每周或每两周整理一次
  • 如果笔记涉及多个主题，按主题分别生成优化后的文档
  • 为识别到的信息缺口添加"待补充"板块 — 方便用户后续知道需要补充什么内容
  • 默认使用中文输出

Error Handling

错误处理

SituationAction
Source notes are too few (<3 items)Refine what's available; suggest capturing more first
Source notes are too many (>10 docs)Focus on most recent or ask user to narrow the scope
Content is already well-structuredTell user honestly; suggest minor improvements only
yuque_update_doc
fails		Fall back to creating a new document
Mixed languages in notesMaintain the dominant language; don't force translation
场景处理方式
源笔记太少（<3条）优化现有内容，同时建议用户先积累更多内容
源笔记太多（>10篇）优先处理最新的内容，或让用户缩小范围
内容已经结构清晰如实告知用户，仅建议做小幅优化
yuque_update_doc
调用失败		降级为新建文档
笔记中混合多种语言保留使用占比最高的语言，不要强制翻译