AI 交互模式
WesCraft 内置五种 AI 交互模式，从轻量的自动续写到深度的侧栏对话，覆盖信息工作的全场景需求。每种模式有不同的触发方式、能力边界和适用场景，理解它们的差异有助于你选择最高效的交互方式。
模式概览
| 模式 | 触发方式 | 工具集 | 多轮对话 | 响应速度 | 适用场景 |
|---|---|---|---|---|---|
| Ghost Write | 光标停留 >800ms | 无 | 否 | ⚡ 极快 | 流畅续写 |
| Selection Action | 选中文字 | 无 | 否 | ⚡ 快 | 局部优化 |
| Inline Command | Ctrl+K | 6 个块工具 | 否 | 🔄 中等 | 精准编辑 |
| Sidebar Chat | Ctrl+L | 全部 19 个 | 是 | 🔄 中等 | 深度交互 |
| 后台 AI | 自动触发 | 知识管线工具 | 否 | 🐢 后台 | 自动处理 |
Ghost Write（自动续写）
工作原理
Ghost Write 是最轻量的 AI 交互模式。当你在编辑器中停止输入约 800 毫秒后，AI 会自动分析光标前的上下文，预测你接下来要写的内容，并以灰色文本显示建议。
你输入的文字 ← 已确认内容
建议的续写内容 ← 灰色显示，等待确认
使用方法
- 正常编辑页面内容
- 暂停输入，等待约 800ms
- 灰色建议文本出现在光标后
- 按
Tab接受全部建议 - 或继续输入忽略建议
快捷键
| 按键 | 操作 |
|---|---|
Tab | 接受全部建议 |
Esc | 拒绝建议 |
| 任意字符 | 忽略建议，继续输入 |
特点
- 不经过 Agent 循环：直接调用补全端点，响应速度最快
- 无工具调用：不能搜索文件、修改内容，只做文本续写
- 上下文感知：基于当前页面内容和写作风格
- 非侵入式：不中断你的写作流程，不弹窗、不切换焦点
适用场景
- 撰写长文时的流畅续写
- 代码注释补全
- 常见句式和模板的快速输入
- 列表项的连续补全
配置选项
在设置 → AI → Ghost Write 中：
| 选项 | 说明 | 默认值 |
|---|---|---|
| 启用 Ghost Write | 开关 | 开启 |
| 触发延迟 | 停止输入后多久触发（ms） | 800 |
| 最大建议长度 | 单次建议的最大字符数 | 200 |
| 触发频率 | 每分钟最多触发次数 | 30 |
Selection Action（选中操作）
工作原理
选中一段文字后，AI 对选中内容执行单步操作。这是一个"选中 → 操作 → 替换"的简单流程，不进入多轮对话。
使用方法
- 在编辑器中选中目标文字
- 浮动工具栏出现 AI 操作菜单
- 选择操作类型：
| 操作 | 说明 | 示例 |
|---|---|---|
| 润色 | 优化文字表达 | "这个很好" → "这一方案表现优异" |
| 精简 | 缩短文字长度 | 删除冗余，保留核心 |
| 扩展 | 丰富内容细节 | 添加举例和解释 |
| 翻译 | 翻译为其他语言 | 中文 → 英文 |
| 总结 | 提取核心观点 | 长段落 → 一句话摘要 |
| 解释 | 通俗解释专业内容 | 技术术语 → 白话解释 |
| 改写 | 用不同风格重写 | 口语 → 正式文体 |
| 修正 | 修复语法和拼写错误 | 自动纠错 |
- 操作结果直接替换或插入到选中内容后方
特点
- MaxTurns=1：单次调用，不使用工具
- 操作明确：每次只做一个清晰的操作
- 结果可控：操作前后内容对比清楚
- 速度较快：不需要工具调用和多轮交互
适用场景
- 改善段落表达质量
- 快速翻译某段内容
- 精简冗长的文字
- 修正语法和拼写错误
- 将口语化内容转为正式文体
Inline Command（Ctrl+K）
工作原理
在当前编辑位置唤出命令输入框，输入自然语言指令，AI 使用块操作工具直接修改页面内容。这是 Ghost Write 和 Sidebar Chat 之间的中间地带——比续写更有控制力，比对话更轻量。
使用方法
- 将光标放到目标位置
- 按
Ctrl+K打开命令输入框 - 输入自然语言指令
- 按
Enter执行 - AI 操作完成后命令框自动关闭
指令示例
| 指令 | AI 执行的操作 |
|---|---|
| "把这段改成表格" | 读取当前块，转换为表格块 |
| "在下方插入目录" | 分析页面标题，创建目录块 |
| "用更正式的语气重写这段" | 编辑当前块，替换为正式语气 |
| "给这个列表排序" | 读取列表块，按字母/逻辑排序 |
| "把代码块的语言改成 Python" | 编辑代码块属性 |
| "删除下面三个空白块" | 删除目标块 |
| "将这段文字拆分为要点列表" | 转换文本块为列表块 |
可用工具
Inline Command 模式下 AI 可以使用以下 6 个块操作工具：
| 工具 | 用途 |
|---|---|
read_block | 读取块的内容和属性 |
write_block | 在指定位置创建新块 |
edit_block | 修改现有块的内容 |
delete_block | 删除指定的块 |
move_block | 改变块的位置 |
transform_block | 改变块的类型 |
特点
- 工具有限但精准：只有 6 个块工具，操作范围明确
- 就地执行：在当前编辑位置操作，无需切换界面
- 单次交互：输入一条指令，执行一次操作
- 上下文感知：AI 知道光标位置和周围内容
适用场景
- 格式转换（文本→表格、文本→列表等）
- 内容重组（排序、拆分、合并块）
- 快速编辑（改写某段、修改属性）
- 结构调整（插入分隔、添加标题）
Sidebar Chat（Ctrl+L）
工作原理
打开侧边栏对话面板，与 AI 进行多轮对话。AI 在此模式下拥有全部 19 个 WesCraft 工具，可以执行复杂的跨页面操作、数据查询、内容生成等任务。
使用方法
- 按
Ctrl+L打开侧栏对话面板 - 输入你的需求或问题
- AI 回复并可能执行工具操作
- 继续对话，逐步完善结果
可用工具（全部 19 个）
块操作工具（6 个）：
| 工具 | 用途 |
|---|---|
read_block | 读取块内容 |
write_block | 写入新块 |
edit_block | 编辑块 |
delete_block | 删除块 |
move_block | 移动块 |
transform_block | 转换块类型 |
文件智能工具（5 个）：
| 工具 | 用途 |
|---|---|
search_files | 搜索本地文件 |
read_local_file | 读取本地文件内容 |
find_related_files | 查找相关文件 |
file_overview | 获取文件概览 |
assemble_from_files | 从多个文件组装内容 |
输出工具（3 个）：
| 工具 | 用途 |
|---|---|
export_pdf | 导出为 PDF |
export_docx | 导出为 Word 文档 |
export_wxpub | 导出为公众号格式 |
其他工具（5 个）：
| 工具 | 用途 |
|---|---|
read_page | 读取页面内容 |
search_pages | 搜索页面 |
create_doc | 创建新文档 |
capture_url | 抓取网页内容 |
db_query | 查询数据表 |
对话示例
你：帮我把"项目计划"页面的任务提取出来，整理成一个数据表
AI：好的，我来帮你处理。
[调用 read_page("项目计划")]
[调用 db_insert(...)] × N
已经从"项目计划"中提取了 12 个任务，创建了一个新的数据表。
每个任务包含：名称、负责人、截止日期、优先级。
需要我调整什么吗？
你：把截止日期在本月内的任务标记为高优先级
AI：[调用 db_query("截止日期 < 月底")]
[调用 db_update(...)] × 5
已将 5 个本月到期的任务标记为高优先级。
特点
- 全工具集：可以执行任何 WesCraft 操作
- 多轮对话：可以逐步细化需求，修正结果
- 跨页面操作：可以同时操作多个页面和数据表
- 深度分析：可以阅读、搜索、汇总大量内容
适用场景
- 复杂的内容创作和改写
- 跨页面的信息整合和分析
- 数据查询和报表生成
- 批量操作（如批量修改格式、批量导出）
- 需要多步骤完成的任务
后台 AI（自动处理）
工作原理
后台 AI 在你不直接交互的情况下自动运行，处理知识管线、文件索引、自动分类等任务。它在页面保存或文件变更时异步触发。
自动触发的场景
| 触发事件 | 后台处理 |
|---|---|
| 页面保存 | 更新全文索引、提取关键词、更新关联推荐 |
| 文件变更 | 文件智能重新索引变更的文件 |
| 收集箱新增 | 自动分类、打标签、建议归档位置 |
| 知识库更新 | 重新计算向量索引、更新语义搜索 |
知识管线
后台 AI 通过 6 阶段管线处理新增内容：
1. 元数据提取 → 标题、作者、日期、来源
2. 正文清洗 → 去除噪音、格式化
3. 分段分块 → 按语义切分为块
4. 关键词提取 → 识别核心概念和实体
5. FTS5 索引 → 建立全文搜索索引
6. 关联分析 → 发现与现有内容的关联
配置
在设置 → AI → 后台处理 中：
| 选项 | 说明 | 默认值 |
|---|---|---|
| 启用后台 AI | 开关 | 开启 |
| 自动索引 | 文件变更时自动重新索引 | 开启 |
| 自动分类 | 收集箱内容自动分类 | 开启 |
| 自动关联 | 自动发现内容间的关联 | 开启 |
| 处理优先级 | 后台任务的 CPU 优先级 | 低 |
提示：后台 AI 使用独立的异步队列，不影响前台操作的响应速度。
模式选择指南
按场景选择
| 场景 | 推荐模式 |
|---|---|
| 正在写文章，需要自然续写 | Ghost Write |
| 修改某段的表达方式 | Selection Action |
| 把某段转成表格或列表 | Inline Command |
| 从多个页面汇总信息 | Sidebar Chat |
| 让 AI 自动整理新添加的内容 | 后台 AI（自动） |
| 翻译一段文字 | Selection Action |
| 基于文件生成一份报告 | Sidebar Chat |
| 快速修改某个块的内容 | Inline Command |
按复杂度选择
简单操作 复杂操作
←─────────────────────────────────→
Ghost Write → Selection → Inline → Sidebar Chat
(续写) (单步编辑) (块操作) (多轮对话+全工具)
按响应速度选择
最快 较慢
←─────────────────────────────────→
Ghost Write → Selection → Inline → Sidebar Chat → 后台 AI
(~200ms) (~1s) (~3s) (~5s) (异步)
注意事项
- 模型消耗：Sidebar Chat 由于工具调用和多轮对话，token 消耗最大；Ghost Write 最小
- 上下文窗口：长对话可能超出模型的上下文窗口限制，建议定期开启新对话
- 工具安全：文件智能工具（
read_local_file等）只读取你明确关注的目录中的文件 - 后台资源：后台 AI 可能占用一定 CPU 资源，在性能敏感时可临时关闭
- 操作不可撤销：AI 通过工具执行的写入操作不支持"撤销 AI 的全部操作"，但页面的版本历史可以回滚