功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

知识管理工具(免费版)

概述

本工具是基于文件的知识组织工具,实现"快速捕获、后续检索、自动整理"的工作流。用户可将 URL、视频、文章、论文、社交帖子与研究笔记快速保存到本地知识库,通过标签与全文检索随时找回。免费版面向个人用户,提供核心的捕获、检索与整理能力。

与其他工具的定位差异

核心能力

命令总览

输出: 返回命令总览的执行结果,包含操作状态和输出数据。

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：基于文件的知识捕、获与检索工具、社交内容收藏与搜、基于文件的知识组、织工具、实现快速捕获、后续检索与自动整、论文摘要、社交帖子与研究笔、记管理、Use、when、SEO、关键词分析、排名提升、搜索流量优化时使、不适用于黑帽、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:快速收藏 URL

浏览时发现有用的网页,快速收藏并打标签。

# 收藏一个 URL,附带标题、标签与摘要
know add url https://example.com/article \
  --title "AI 智能体入门指南" \
  --tags "ai,agent,tutorial" \
  --summary "介绍 AI 智能体的基础概念与开发流程"

# 收藏一个视频
know add video https://example.com/video \
  --title "Python 异步编程教程" \
  --tags "python,async,tutorial" \
  --summary "讲解 asyncio 与 async/await 的使用"

场景二:检索历史知识

需要找回之前保存的内容,按关键词或标签检索。

# 全文搜索
know search "智能体"

# 按标签筛选
know list --tags ai,agent

# 查看最近条目
know recent --limit 10

场景三:添加研究笔记

将研究过程中产生的内容保存为知识条目。

know add research \
  --title "2026 年 AI 智能体市场调研" \
  --tags "research,ai,market" \
  --summary "调研 2026 年 AI 智能体市场规模、主要玩家与趋势"

快速开始

1. 存储位置

默认存储路径:$HOME/.knowledge-base/(可通过环境变量 KNOWLEDGE_DIR 配置)。

knowledge/
├── INDEX.md      # 自动维护的浏览索引
├── urls/         # 收藏的 URL
├── extracts/     # 视频/文章/论文摘要
├── posts/        # 社交内容(推文/帖子)
└── research/     # 研究笔记

2. 添加内容

# 收藏 URL
know add url <url> --title "标题" --tags "标签1,标签2" --summary "摘要"

# 添加文章摘要
know add extract --source <url> --type article --title "标题" --tags "标签"

# 添加研究笔记
know add research --title "标题" --tags "标签" --summary "摘要"

每次 add 操作都会:

1. 生成一个带 YAML frontmatter 的 Markdown 文件
2. 自动更新 INDEX.md 索引

3. 检索与浏览

# 全文搜索
know search "查询关键词"

# 查看最近条目
know recent --limit 10

# 按标签筛选
know list --tags security,ai

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

数据模型(frontmatter)

每个知识条目以 Markdown 文件存储,带 YAML frontmatter:

## 正文内容
...

配置文件

# $HOME/.config/know/config
KNOWLEDGE_DIR=$HOME/.knowledge-base
DEFAULT_TAGS=personal
INDEX_FORMAT=markdown

索引文件(INDEX.md)

# 知识库索引

## 最近添加
- [AI 智能体入门指南](urls/2026-02-26-ai-agent-guide.md) - ai,agent,tutorial
- [Python 异步编程](extracts/2026-02-26-python-async.md) - python,async

## 按标签
### #ai
- [AI 市场调研](research/2026-02-26-ai-market.md)

### #python

优选实践

知识捕获纪律

1. 有用就立即保存:发现可能有用的内容,立即 know add,不要只留在记忆里。
2. 每条必带标签与摘要:标签便于检索,摘要便于快速判断相关性。
3. 不要只存链接:尽量提取完整内容或摘要,避免链接失效后无法找回。
4. 定期整理:运行 know tidy --fix 规范化标签与文件位置。

检索技巧

1. 用语义搜索:不必记忆精确关键词,用概念性查询即可。
2. 组合标签筛选:know list --tags ai,agent 交集筛选。
3. 按时间浏览:know recent --limit 20 查看最近添加。
4. 定期回顾:每周浏览索引,重新发现有用内容。

维护规范

1. 自动整理:将 know tidy --fix 加入定时任务,定期执行。
2. 校验完整性:know validate 检查 frontmatter 规范。
3. 重建索引:大量变更后 know reindex 重建索引。
4. 查看配置:know config 确认当前配置路径。

常见问题

Q1: 如何备份知识库?

知识库是纯 Markdown 文件,直接备份目录即可:

# 备份到云盘或版本控制
cp -r $HOME/.knowledge-base/ /backup/knowledge-$(date +%Y%m%d)/
# 或纳入 Git 管理
cd $HOME/.knowledge-base && git add . && git commit -m "知识库更新"

Q2: 标签如何规范化?

运行 know tidy --fix 自动规范化标签(统一小写、去重、合并同义词)。

Q3: 搜索结果太多怎么办?

• 增加标签筛选:know list --tags specific-tag
• 使用更精确的查询词
• 按时间范围缩小:know recent --limit 5

已知限制

免费版提供核心知识捕获与检索能力,适合个人用户。如需团队共享、全文语义检索、自动摘要生成、知识图谱等高阶能力,请升级至专业版。

Q5: 如何迁移到其他工具?

知识库是标准 Markdown 文件,可直接导入 Obsidian、Notion、Logseq 等支持 Markdown 的工具。

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Shell: Bash / Zsh(用于运行 know 脚本)

依赖详情

API Key 配置

• 本 Skill 基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)

可用性分类

• 分类: MD+execute(纯Markdown指令,部分功能需exec命令行执行)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据