Distill And Archive

Overview

将网络文章或内容提炼为精炼知识点，并归档到用户的笔记系统中。工作流程包含：内容提取与 distill、笔记系统调研、归档计划制定、用户确认、执行归档和提交。

Workflow

Step 1: Distill 内容

当用户提供 URL 时：

1. •使用 web-reader 工具获取文章内容
2. •进行中英文网络搜索，补充背景信息和拓展资源
3. •将内容分段整理为精炼的知识点（takeaways）

输出格式：

#### [标题]

[内容：使用朴素的单词，精确术语，符合认知习惯，融入轻微情感表达]

见：[链接标题](链接地址)

Step 2: 调研笔记系统

探索用户的笔记系统结构：

1. •首先读取 content/6.maps/Agents.md 获取笔记系统规范（如有）
2. •使用 Glob 查找笔记目录（常见模式：content/**/maps/**/*, **/*.md）
3. •读取关键索引文件（如 0.index.md, index.md, <dirname>/<dirname>.md）
4. •分析现有分类结构和文件命名规范
5. •确定知识点的最佳归档位置

参考文档：

• •content/6.maps/Agents.md - 笔记系统智能体档案，包含目录结构和格式规范

常见笔记系统结构：

• •content/6.maps/_topic/subtopic/file.md - 三级分类
• •content/notes/ - 扁平或层级结构
• •docs/knowledge-base/ - 文档型结构

Step 3: 制定归档计划

基于调研结果制定计划：

1. •确定每个知识点的归档位置（文件路径）
2. •确定归档格式（新增小节 vs 新建文件）
3. •检查是否需要更新索引
4. •用 mermaid 图表展示计划结构

计划模板：

## 归档计划

| 知识点 | 归档位置 | 操作 |
|--------|----------|------|
| [标题] | `[路径]` | 新增/修改 |

### 文件变更清单
- [ ] `[文件1]` - [改动描述]
- [ ] `[文件2]` - [改动描述]

Step 4: 等待用户确认

必须等待用户明确确认后才能执行。

向用户展示：

1. •Distill 后的知识点
2. •归档计划（包含路径和操作）
3. •询问是否执行

确认话术： "以上是将知识点归档到笔记系统的计划，确认后我将执行归档并提交。"

Step 5: 执行归档

用户确认后：

1. •使用 TodoWrite 跟踪进度
2. •按需编辑或新建 markdown 文件
3. •更新相关索引文件
4. •保持与现有笔记格式一致

Step 6: 提交更改

归档完成后：

1. •git add 相关文件
2. •git commit 使用清晰的提交信息
3. •git push 推送到远程

格式规范

Frontmatter 格式

---
title: [标题]
description: [简介]
---

知识点格式

沿用 distill-takeaways 的输出风格：

• •使用 #### 作为知识点标题
• •内容简洁，保留关键信息
• •包含链接，链接数量规则：
  • •简单知识点（常识性概念）：无需链接
  • •普通知识点：1 个链接
  • •极少数情况（需对比不同视角）：2 个或多个不同方向的链接

人物笔记格式

---
title: [姓名]
description: [身份/职业]
---

#### 简介？

[简介内容]

#### 主要贡献/观点？

[要点]

见：[链接](URL)

注意事项

• •质量优于速度：Distill 时充分搜索，确保信息准确
• •格式一致性：遵循目标笔记系统的现有格式
• •索引更新：新建文件时必须更新索引
• •原子提交：一次归档一个主题，便于追溯