whorl
一个将个人文档集中管理，用于个性化AI交互的工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：whorl。 它的用途是：一个将个人文档集中管理，用于个性化AI交互的工具。 完整的 Skill 内容见：https://321skill.com/skills/whorl/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“根据我上个月读的关于市场趋势的笔记，帮我起草一份新产品创意的提纲。”，它会通过Whorl的MCP接口查询你相关的读书笔记和日记，生成一份融合了你个人见解和过往学习内容的创意草案。或者，当你上传一篇新的技术博客草稿后，配置好的工作流会自动运行，提取文中的待办事项并汇总到`tasks.md`中。
介绍
Whorl 解决了个人数据分散、难以被AI有效利用的问题。它是一个中心化的个人知识库，你可以将所有个人文档（如日记、笔记、阅读材料）上传到其中，并授权你交互的AI模型（通过MCP协议）访问这些信息，从而使AI的回答更贴合你的个人背景和需求。
使用方式非常直观：通过命令行安装后，运行本地服务器，即可通过Web界面或CLI上传文件。Whorl的核心是一个文件系统目录（~/.whorl/docs），你可以直接移动文件进去，或使用whorl upload命令批量导入。上传后，AI模型（如Claude Code）就能通过集成的MCP服务器查询你的个人知识库。
它非常适合那些希望AI助手能基于个人历史、偏好和知识进行深度对话的用户，例如内容创作者、学术研究者、开发者或任何有大量个人笔记和文档需要管理的人。通过让AI“了解你”，可以显著提升从创意写作到项目规划等各种任务的效率和质量。
需要注意的是，Whorl默认在本地运行且无密码，方便开发，但在部署到公网环境时，务必设置密码以保护你的个人数据安全。其AI增强功能（如自动摘要、提取任务）依赖Anthropic API，需要配置相应的API密钥。
核心特点
与单纯的文件同步或笔记软件不同，Whorl原生集成了MCP（Model Context Protocol）服务器，让AI模型能主动查询你的个人知识库，实现了“AI读懂你”的个性化交互。同时，它通过可配置的工作流，能在你上传文档后自动触发AI处理，如提取待办事项、汇总想法，实现知识库的自动结构化。
注意事项
不适合需要复杂权限管理、团队协作或在线实时编辑的场景，它更侧重于个人本地知识库的管理与AI集成。
常见问题
Whorl 如何保护我的隐私？
默认在本地运行，数据存储在本地目录，且可通过设置密码保护服务器访问。
支持哪些类型的文件？
主要处理文本文件（如.md, .txt），通过工作流和AI可以处理其中的内容。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/whorl/raw/index.md 读取 whorl 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/whorl/raw/index.md（查看排版版本）