快速开始
WesCraft 是 AI 原生信息工作台，帮助你高效地写、收、理、查、出、追。本指南将带你在几分钟内完成安装并开始使用。
安装步骤
系统要求
| 平台 | 最低版本 |
|---|---|
| macOS | 13.0 (Ventura) 及以上 |
| Windows | Windows 10 (21H2) 及以上 |
| Linux | Ubuntu 22.04 / Fedora 38 及以上 |
下载安装
- 访问 weisyn.com/wescraft 下载对应平台的安装包
- macOS 用户：打开
.dmg文件，将 WesCraft 拖入 Applications 文件夹 - Windows 用户：运行
.exe安装程序，按提示完成安装 - Linux 用户：使用
.AppImage或.deb包安装
验证安装
启动 WesCraft 后，你应该看到欢迎页面。如果遇到问题，请参阅 故障排查。
首次配置
配置 AI 模型
WesCraft 需要 AI 模型来驱动智能写作、搜索和整理功能。首次启动时会引导你完成配置：
- 使用 WES 云端模型：注册 weisyn 账号即可使用，按用量计费
- 自有 API Key (BYOK)：支持 OpenAI、Anthropic、DeepSeek 等主流提供商
- 本地部署模型：支持 Ollama、vLLM 等本地推理方案
配置步骤：
- 点击左下角 设置 图标
- 进入 AI 模型 页面
- 选择模型提供商并填入 API Key
- 点击 测试连接 确认可用
- 保存配置
提示：你可以随时在设置中切换模型。不同任务可以选择不同的模型，例如使用轻量模型处理简单任务以节省费用。
设置数据目录
WesCraft 默认将数据存储在以下位置：
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/wescraft/ |
| Linux | ~/.local/share/wescraft/ |
| Windows | %APPDATA%\wescraft\ |
你可以在首次启动时选择自定义存储位置。
设置语言
WesCraft 支持中文和英文界面。在 设置 → 通用 → 语言 中切换。
创建第一篇笔记
方法一：从首页创建
- 在首页点击 新建页面 按钮（或按
Ctrl/Cmd + N） - 输入页面标题
- 在正文区域开始编写
方法二：从侧边栏创建
- 在左侧边栏的页面列表中，点击 + 按钮
- 选择 空白页面 或使用模板
- 开始编写内容
快速编辑
WesCraft 使用块编辑器，每一段内容都是一个独立的"块"：
- 输入
/打开命令菜单，选择块类型（标题、列表、代码块等） - 直接输入文字即为普通段落
- 拖拽块的左侧手柄可以调整顺序
- 按
Tab缩进，Shift + Tab取消缩进
试一试：输入 /h2 创建一个二级标题，然后输入一些文字。再输入 /list 创建一个列表。
界面布局
WesCraft 的界面由以下几个核心区域组成：
┌─────────────────────────────────────────────────────┐
│ 菜单栏 │
├──────────┬──────────────────────────────┬────────────┤
│ │ │ │
│ 侧边栏 │ 编辑区 │ AI 面板 │
│ │ │ │
│ · 页面 │ 标题 │ 对话 │
│ · 收集箱 │ 正文内容（块编辑器） │ 建议 │
│ · 文件 │ │ 工具 │
│ · 数据表 │ │ │
│ · 记忆 │ │ │
│ · 设置 │ │ │
│ │ │ │
├──────────┴──────────────────────────────┴────────────┤
│ Tab 栏（多页面切换） │
└─────────────────────────────────────────────────────┘
侧边栏
- 页面列表：所有笔记按层级展示，支持拖拽排序
- 收集箱：快速收集的内容暂存区
- 文件：本地文件智能索引入口
- 数据表：结构化数据管理
- 记忆：AI 记忆中心，包含学习到的偏好和知识
- 设置：应用配置
编辑区
中央区域是块编辑器，你的主要工作区域。支持：
- 富文本编辑
- 块类型切换
- 拖拽排列
- 嵌入内容
AI 面板
右侧 AI 面板（按 Ctrl/Cmd + L 打开）提供：
- 侧边对话：与 AI 讨论当前文档
- 写作建议
- 内容分析
Tab 系统
WesCraft 采用 Tab 系统管理多个打开的页面：
- 点击侧边栏项目在新 Tab 中打开
- 拖拽 Tab 调整顺序
- 右键 Tab 查看更多操作（关闭、关闭其他、固定等）
核心概念
页面
页面是 WesCraft 的基本内容单元。每个页面由标题和若干块组成。页面可以有子页面，形成层级结构。
块
块是页面中的最小编辑单元。一个段落、一个标题、一张图片、一段代码——都是一个块。块可以独立编辑、移动、转换类型。
收集箱
收集箱是一个特殊的暂存区域，用于快速捕捉想法、链接、剪藏等内容。你可以稍后整理到合适的页面中。
文件智能
WesCraft 可以索引你本地的文件（文档、代码、笔记等），建立语义理解，让 AI 能够在你的文件中搜索和发现关联内容——文件始终留在原地，不会被复制或修改。
数据表
数据表提供了结构化数据管理能力，类似电子表格但更强大——支持多种字段类型、视图切换和 AI 驱动的查询。
AI 助手
AI 助手贯穿 WesCraft 的各个功能，提供写作辅助、内容整理、智能搜索等能力。它通过记忆系统不断学习你的偏好，提供越来越个性化的帮助。
知识管线
WesCraft 的知识管线是一个 6 阶段处理流程，自动将你的内容从原始输入转化为可检索、可关联的知识：
- 采集 → 2. 解析 → 3. 索引 → 4. 理解 → 5. 关联 → 6. 召回
这一切在后台自动进行，你只需要专注于创作。