开始使用 Weave

Weave 是一个本地优先的知识工作台。Markdown、笔记、代码和项目资料保留在你选择的本地目录中；本地检索和向量索引也由桌面端管理。登录不会自动上传整个知识库。

1. 安装桌面端

在 macOS 上安装 Weave 后，将应用移动到“应用程序”目录再启动。这样可以避免系统隔离路径变化，并确保 MCP 等随应用分发的本地组件拥有稳定路径。

首次启动时，按系统提示授予你主动选择的目录访问权限。Weave 不需要整个磁盘的默认访问权。

2. 导入知识库

1. 创建知识库并选择一个本地目录。
2. 确认目录中的 Markdown 或其他受支持资料。
3. 等待导入任务完成。导入、全文索引和语义索引是可观察的独立阶段。
4. 从文件树打开资料，确认预览、搜索和引用能够回到原文。

大目录首次导入需要更长时间。关闭应用后，持久化任务会在下次启动时恢复，而不是从头重复整个知识库。

3. 选择语义模型

全文搜索不依赖语义模型。需要语义检索时，可以在设置中安装本地嵌入模型。模型下载会显示真实进度，并优先使用可连接的下载源；下载失败不会影响原始文件或全文搜索。

4. 连接 AI

Weave 支持由用户配置的 AI Provider。模型密钥保存在系统凭据库中，不写入知识库文件。只有在你发起对话、解释或授权的 Agent 工具调用时，相关上下文才会发送给对应模型服务。

5. 连接 Agent

需要让 Codex、Claude、VS Code 或其他支持 MCP 的 Agent 使用知识库时，在目标知识库的“管理 → AI 集成（MCP）”中创建连接。初始连接只包含读取权限，写入能力需要单独开启并受确认流程保护。

数据边界

• 本地目录仍是原始资料的所有者。
• 登录用于账户、会员和按需云能力，不等于上传本地知识库。
• 外部 AI 或 Agent 获得的片段可能会发送给其模型提供方；只授权完成任务所需的知识库。
• 删除应用前，请确认知识库原始目录和需要保留的本地状态已经备份。