IWE：把 Markdown 笔记变成个人与 AI agent 的共享记忆

项目用途

IWE（iwe-org/iwe）把一组本地 Markdown 文档组织成可互相连接的知识图谱，定位是让个人与 AI agent 使用同一份项目记忆。笔记可以承载规格、计划、决策和经验；人可以直接阅读、修改或删除，agent 也可以在工作过程中读取、写入和整理这些文档。

它不是一个自带模型的 AI 应用。项目 README 明确说明，IWE CLI 和 Mac 应用都不包含 AI 模型；需要 AI 协助时，应连接已有的 Claude、Codex，或其他支持 MCP 的工具。因此，IWE 更像是本地笔记层、编辑器集成和 agent 工具接口的组合，而不是独立的聊天服务。

已知功能与适合人群

IWE 提供四种使用路径：Mac 原生应用、编辑器集成、CLI，以及通过 MCP 连接 agent。编辑器方面，官方列出 Neovim、Helix、VS Code 和 Zed，并提供链接补全、反向链接、搜索和安全重命名。对于已经在这些编辑器中写 Markdown 的开发者、技术写作者、研究者和采用 Zettelkasten 或项目知识库工作流的人，这种方式可以减少切换工具的需要。

CLI 适合终端用户和脚本化流程，可搜索、创建和整理笔记，并支持内容搜索。AI agent 则可以通过 IWE 提供的 MCP 方式读取、保存和组织记忆；同一批 Markdown 文件也能同时被编辑器、CLI 和其他工具使用。Mac 应用还提供本地浏览与编辑、搜索、关联笔记跳转，以及 Mermaid 图表查看等功能。

采用前的限制

首先，IWE 不负责提供模型、模型额度或 agent 账户。Claude、Codex 或其他 MCP 客户端的可用性、认证、权限和数据处理方式，需要单独确认。将 agent 接入本地笔记后，也应审慎决定哪些目录和文件允许它读取或修改；项目资料没有在此处给出足够依据来作出安全保证。

其次，资料没有确认完整的平台矩阵、最低硬件要求、部署规模边界或所有编辑器版本的兼容范围。Mac 应用只在官方 README 中被描述为 Mac 原生应用，其他平台是否有等价图形界面，不能据此推断。使用前应查看官方安装和编辑器文档，并在目标环境中验证工作流。

项目采用 Apache License 2.0，仓库当前未归档。v0.26.1 修复了缺失文档及非 Markdown 链接导致查询崩溃、挂起或返回非文档对象的问题，但这只是特定版本说明，不等于对所有场景作出稳定性承诺。实际部署仍应保留 Markdown 文件备份，并考虑同步、git 冲突和 agent 自动修改带来的审阅流程。

部署考虑

最直接的部署思路是选定一个笔记文件夹，将其作为本地 Markdown 数据源，再根据工作习惯选择编辑器、CLI、Mac 应用或 MCP agent。团队或个人若依赖版本控制，应先设计目录结构、命名和变更审阅规则。若需要 agent 参与，建议从低风险笔记开始，明确工作目录与可修改范围，并保留人工检查。IWE 的价值在于让记忆保持为可见、可迁移的文件；它是否适合你的环境，取决于现有编辑器、agent 账户和本地文件管理方式能否衔接。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-10-16