🚀
快速上手
10 分钟内创建你的第一个 WPX 文档
- 安装与首次启动
- 创建/打开/保存文档
- 基础快捷键速查
- 切换界面语言
文档
从这里开始你的 WPX 之旅
6 大类共 31 主题 · 全随 v0.1.26 同步
🧩
核心功能
把多窗口、虚拟纸张、Skills 用到极致
- 多窗口独立编辑
- 虚拟纸张与分页
- Skills 启用与提示词
- 图片编辑器（去背景）
🛠️
进阶技巧
把 WPX 改造成最懂你的工作台
- 自定义 Skill 提示词
- 字体管理（导入 / 商用）
- 本地指令 64 条
- 命令行与脚本化导出
文档章节索引
已覆盖 markdown / 多窗口 / Skills / 本地指令 / OCR / 大模型接入 等全部桌面端能力。
📘 入门指南 4 项
✍️ 编辑器核心 6 项
🧩 Skills 与指令 9 项
- 指令菜单面板浮窗 ↔ 贴边（IDE 风格右侧栏）双模切换
- Skills 与指令体系总览32+ Skills + 64 条本地指令全景，按用户群分类
- 内置 Skills 清单学生 16 + 教师 16 + 通用 8 + 自定义
- 自定义 Skill写自己的模板与脚本，让 Skills 按你的流程改稿
- 大模型接入教程（DeepSeek / 智谱 / 通义 等，v0.1.10+ 新增）兼容 OpenAI Chat Completions，覆盖 8+ 国产大模型预设
- 本地指令系统 64 条（v0.1.13 新增）输入 `/focus` `/export` `/paper-a4` 等立即生效
- Hermes Agent 可选智能体（v0.1.26 新增）本地 sidecar · 复杂任务自动路由 · 未安装透明降级
- SKILL.md 技能标准（v0.1.26 新增）导入 / 导出技能包，与社区生态互通
- 四层本地 AI 记忆（v0.1.26 新增）会话 / 项目 / 偏好 / 长期摘要 · 隐私开关
📤 导出与压缩 4 项
📥 导入与转换 5 项
章节详情
以下是上方索引项的完整要点速览。点击上方分类卡片 / 全站锚点链接 / 本页内 #项名称 都会滚动到对应位置。
📘 入门指南 4 项
安装与系统要求
Windows 10/11 · Electron 28+ · 推荐 8GB 内存
- 操作系统：Windows 10 1909+ 或 Windows 11 任意版本（x64 / ARM64 均支持）
- 运行时内置 Electron 28，无需用户预装 Node.js / .NET / Python
- 内存建议 ≥ 8GB；处理 100+ 页文档 / Skills 输出建议 16GB
- 初始安装约 280MB；首次启动后约 500MB（含 Skills 与字体缓存）
- 完全离线可用；联网仅用于可选的字体下载与版本更新检查
被 Windows Defender 拦截时选「更多信息 → 仍要运行」即可
项 ID：
install↑ 返回索引首次启动配置
3 分钟跑通：从安装到第一篇文档
- 首次启动会进入 3 步引导：选择工作区目录 → 选择主题 → 勾选启用默认 Skills
- 工作区目录建议选本地磁盘（如 D:\WPX-Workspace），避免同步盘或网络盘
- 后续可在「设置 → 通用」随时修改工作区、主题与默认 Skills
跳过引导也能后续手动在「设置」重新开启 3 步教程
项 ID：
first-run↑ 返回索引创建与管理文档
本地文件树、命名规范、自动保存策略
- 本地文件树保存于工作区根目录下，原生支持 .md / .wpxdoc / .docx / .txt
- 文件默认 5 秒自动保存；手动保存 Ctrl+S；Ctrl+Shift+S 另存为
- 重命名 / 删除 / 移动均可通过侧边文件树右键操作，支持拖拽排序
- 默认每篇文档独立窗口，多窗口可同时打开多份文档（见 #multi-window）
.wpxdoc 是 WPX 原生 JSON 格式，含文档元数据与多窗口状态
项 ID：
documents↑ 返回索引界面与快捷键
Ctrl+S 保存、Ctrl+Shift+H 源码、Ctrl+K 唤起指令菜单
- Ctrl+S 保存当前文档；Ctrl+Shift+S 另存为 / 导出
- Ctrl+Shift+H 唤起 HTML 源码分屏编辑（与编辑器双向同步）
- Ctrl+K 唤起指令菜单面板；上下方向键选择，Enter 执行
- Ctrl+P 快速搜索文档；Ctrl+Shift+F 文件内全文搜索
- Esc 关闭当前浮窗 / 指令菜单 / Skills 弹层
项 ID：
shortcuts↑ 返回索引✍️ 编辑器核心 6 项
Markdown 语法与富文本
Tiptap 为核心，MathJax / Mermaid / 代码块均有专门扩展
- 编辑器内核采用 Tiptap，基于 ProseMirror 的可扩展富文本框架
- 原生支持标准 Markdown 语法：**加粗** *斜体* `代码` > 引用 + 列表
- 内置扩展：MathJax（行内 / 块级公式）、Mermaid（流程图 / 时序图）、代码块高亮
- 工具栏可一键切换“所见即所得 / Markdown 源码”双模（Ctrl+Shift+H）
不熟悉的语法可在 Skills 菜单一键插入模板
项 ID：
markdown↑ 返回索引虚拟纸张与排版
A4 / Letter / 自定义尺寸，母版 + 分页 + 页码
- 虚拟纸张支持 A4 / A5 / Letter / 自定义尺寸（可在「设置 → 纸张」调整）
- 自动分页 + 页码 + 页眉页脚，导出 PDF 时完整保留
- 母版概念：同系列文档（如论文 / 报告）可套用一个母版统一格式
本地指令：
/paper-a4/paper-letter/paper-a5项 ID：
paper↑ 返回索引多窗口工作流
同时打开多份文档，跨窗口拖拽素材，指令菜单可贴边
- 同时打开多份文档，各窗口独立焦点与光标位置
- 跨窗口拖拽素材：图片 / 表格块 / 引用片段可直接拖到另一窗口
- 指令菜单面板可贴边于任意窗口，作为常驻助手面板
- Ctrl+1~9 一键切换已打开的文档窗口
多窗口与 Skills 面板配合可实现「一边大纲、一边 Skills 生成」
项 ID：
multi-window↑ 返回索引图片与媒体
去背景、滤镜、对齐、批量插入
- 插入图片：拖拽 / Ctrl+V 粘贴 / 菜单插入（支持 jpg / png / webp / gif）
- 本地去背景：rembg 离线推理，一键移除背景，隐私无忧
- 图片对齐：左 / 中 / 右 / 两端对齐四档，支持多张同步对齐
- 批量插入：选中多张图片后插入可一键插入到同一行
项 ID：
media↑ 返回索引HTML 源码分屏编辑（v0.1.13 新增）
CodeMirror 6 + Tiptap 双向同步，拖拽宽度，Ctrl+Shift+H 唤起
- 代码编辑器采用 CodeMirror 6，与 Tiptap 双向同步（任一侧改动都会同步到另一侧）
- 分屏宽度可拖拽调整；Ctrl+Shift+H 一键唤起 / 隐藏
- 支持语法高亮（HTML / CSS / JS）、括号匹配、折叠、自动缩进
- 适合需要精细控制样式、嵌入复杂 HTML 结构的场景（如看板 / 公式块）
项 ID：
html-source↑ 返回索引Focus 模式 MD 排版模板（v0.1.13 新增）
进入 Focus 自动应用 5 套 MD 排版模板
- 进入 Focus 模式后自动应用 5 套 MD 排版模板之一（可在「设置」指定）
- 5 套模板：经典 / 学术 / 极简 / 暖黄护眼 / 杂志风
- Focus 模式同时隐藏工具栏与文件树，进入“只看到纸与笔”的状态
本地指令：
/focus项 ID：
focus↑ 返回索引🧩 Skills 与指令 9 项
指令菜单面板
浮窗 ↔ 贴边（IDE 风格右侧栏）双模切换
- 浮窗（默认）与贴边（IDE 风格右侧栏）两种呈现模式可一键切换
- 贴边后与多窗口配合：窗口 A 写大纲，窗口 B 打开 Skills 输出窗口
- 支持自定义面板位置：左侧 / 右侧 / 浮动 / 隐藏（快捷键 Ctrl+B）
- 面板中可触发全部 Skills 与 64 条本地指令
项 ID：
commands-panel↑ 返回索引Skills 与指令体系总览
32+ Skills + 64 条本地指令全景，按用户群分类
- 32+ 内置 Skills + 64 条本地指令 = 96 项开箱即用能力
- 按用户群分类：学生专用 16 + 教师专用 16 + 通用 8
- Skills 输出可直接插入文档，也可以「另存为新文档」独立编辑
查看完整列表见 Skills 市场（/skills）
项 ID：
skills-overview↑ 返回索引内置 Skills 清单
学生 16 + 教师 16 + 通用 8 + 自定义
- 学生 16：论文大纲 / 文献综述 / 查重降重 / 开题报告 / GB/T 7714 引用 / 学术排版 / 答辩 PPT / 错题复盘 / 考前冲刺 / 作文批改 / 单词速记 / 实验报告 …
- 教师 16：教案生成 / 课件 PPT / 作文批改 / 试卷命题 / 学情分析 / 听课记录 / 教学反思 / 学生评语 …
- 通用 8：图片去背景 / 数据洞察 / 翻译 / 总结 / 引用 / 改写 / 演讲稿 / 周报生成
- 自定义：无上限，可在「Skills 市场 → 自定义」创建
项 ID：
built-in-skills↑ 返回索引自定义 Skill
写自己的模板与脚本，让 Skills 按你的流程改稿
- 创建入口：「Skills 市场 → 自定义 → 新建」
- 模板由三部分组成：名称 + 提示词（Prompt） + 输出变量（可选）
- 提示词中可使用 {selection} 占位，自动取当前选中的文本
- 输出变量可定义 JSON Schema，WPX 会按结构解析为表格 / 列表插入文档
优秀的提示词模板可在社区 GitHub Discussions 分享
项 ID：
custom-skill↑ 返回索引大模型接入教程（DeepSeek / 智谱 / 通义 等，v0.1.10+ 新增）
兼容 OpenAI Chat Completions，覆盖 8+ 国产大模型预设
- 入口：「设置 → 我的模型 → 添加模型」
- 预设 8+ 国产 / 国外大模型：DeepSeek / 智谱 GLM / 通义千问 / 文心一言 / 豆包 / Kimi / 腾讯混元 / SiliconFlow / OpenAI / Anthropic / Ollama / LM Studio
- 兼容 OpenAI Chat Completions 协议（含 /v1/chat/completions 与 /v1/embeddings）
- API Key 仅本机 AES 加密存储，不上传 WPX 服务器
- 支持本地推理：Ollama（http://localhost:11434）、LM Studio
推荐 DeepSeek-V3 / 智谱 GLM-4-Flash：中文能力强、价格低
项 ID：
ai-models↑ 返回索引本地指令系统 64 条（v0.1.13 新增）
输入 `/focus` `/export` `/paper-a4` 等立即生效
- 入口：编辑器中输入 / 触发；或 Ctrl+K 唤起指令面板
- 全部 64 条指令本地执行，不依赖网络 / 不调用任何 AI
- 分为 6 类：文件 / 编辑 / 排版 / 视图 / 导出 / 实验
- 常用指令：/focus · /paper-a4 · /export · /img-bg · /img-ocr · /7z-pack
输入 /help 查看完整指令列表
项 ID：
local-commands↑ 返回索引Hermes Agent 可选智能体（v0.1.26 新增）
本地 sidecar · 复杂任务自动路由 · 未安装透明降级
- 可选 Python sidecar：自行安装 Hermes / Python 后，WPX 可检测并启停
- 设置页可开关；复杂任务自动路由到 Hermes，简单请求仍走原有助手链路
- 任务进度以 SSE 任务卡展示，过程可观察
- 未安装或未启用不强制：透明降级，不影响日常写字
Hermes 是加分项，不是门槛——不装也能用完 WPX 全部本地能力
项 ID：
hermes-agent↑ 返回索引SKILL.md 技能标准（v0.1.26 新增）
导入 / 导出技能包，与社区生态互通
- 遵循 SKILL.md 技能标准，便于与社区 / 其他工具互通
- 支持从文件导入技能包，也支持导出当前技能为 SKILL.md
- 与内置 Skills、自定义 Skill 同一套能力面，减少重复造轮子
项 ID：
skill-md↑ 返回索引四层本地 AI 记忆（v0.1.26 新增）
会话 / 项目 / 偏好 / 长期摘要 · 隐私开关
- 四层本地 AI 记忆：会话 / 项目 / 用户偏好 / 长期摘要分层存放
- 记忆仅存本机，不上传 WPX 服务器
- 隐私开关可随时关闭或清空，关掉就不记
- 与 Hermes / 自备大模型共用，写得越久越懂你的口吻
介意痕迹就关隐私开关——本地优先不是口号
项 ID：
ai-memory↑ 返回索引📤 导出与压缩 4 项
PDF / DOCX / Markdown 互转
中文字体子集化，PDF 体积下降 60%
- 双向互转：Markdown ↔ PDF ↔ DOCX ↔ Markdown
- 中文字体子集化：PDF 体积自动下降 60%（仅嵌入文档用到的字符）
- PDF 导出可指定纸张（A4 / A5 / Letter）、页码位置、页眉页脚
- PDF 导入自动识别章节结构、转换为编辑器可编辑内容
项 ID：
pdf↑ 返回索引演示文稿 PPT 导出（v0.1.15 新增）
从教案大纲一键生成 PPT，自动配色与配图
- 从教案大纲一键生成 PPT（含标题页 / 章节页 / 总结页）
- 自动配色：根据课题类型选 6 套主题色（语文 / 数学 / 英语 / 物理 / 化学 / 生物）
- 配图：自动从教材插图 / Skill 输出中提取可用图位
- 导出格式：.pptx（可在 PowerPoint / Keynote / WPS 演示中继续编辑）
本地指令：
/lesson-ppt项 ID：
lesson-ppt↑ 返回索引HTML 导出弹窗（v0.1.10 新增）
可打包 ZIP / 嵌入资源 / 一键部署到静态托管
- 一键导出 HTML 单文件 / 完整站点（含 / 不含资源文件夹）
- 支持打包为 ZIP / 嵌入所有资源到单一 HTML
- 可选一键部署到 Vercel / Netlify / GitHub Pages 等静态托管
- 导出后文件完全可离线浏览，不依赖 WPX 运行时
适合作为项目文档 / 个人博客 / 课程主页发布
项 ID：
html-export↑ 返回索引7z 压缩 / 解压
AES-256 加密，分卷打包，双击 .7z 直接预览
- 7z 压缩 / 解压（AES-256 加密，支持分卷）
- 双击 .7z 文件可在 WPX 内直接预览压缩包内容
- 批量压缩：选中多个文件右键「压缩为 7z」
- 压缩算法可选：LZMA / LZMA2 / Bzip2 / PPMd
本地指令：
/7z-pack/7z-unpack项 ID：
compress↑ 返回索引📥 导入与转换 5 项
网页导入与智能排版（v0.1.10 新增）
粘贴 URL 自动抓取正文 + 去广告 + 智能排版
- 粘贴 URL 自动抓取正文（基于 Mozilla Readability 提取算法）
- 智能排版：自动去除广告 / 侧边栏 / 评论区，保留章节结构
- 可选保留图片 / 代码块 / 引用块，按需转换为本地图存储
- 支持微信公众号 / 知乎 / Medium / Substack 等主流平台
部分需要登录的页面可复制正文后在编辑器内 Ctrl+V 直接导入
项 ID：
web-import↑ 返回索引PDF OCR 离线处理（v0.1.10 新增）
pdfjs + tesseract.js，本地推理 0 上传
- 基于 pdfjs 解析 + tesseract.js 本地推理，完全离线，0 上传
- 支持中 / 英 / 日 / 韩 / 法 / 德 / 俄等 100+ 语言
- 扫描版 PDF 自动识别为可编辑文本，保留原始排版位置
- 批量 OCR：文件夹内多份 PDF 一键识别并保存为新文档
推荐使用 300 DPI 以上的扫描文件以获得最佳识别率
项 ID：
pdf-ocr↑ 返回索引Excel / WPS 表格导入（v0.1.16 新增）
支持 .xls / .xlsx，解析为表格块
- 支持 .xls（兼容旧版） / .xlsx（OOXML） / .csv
- 表格块解析为原生表格块，可在编辑器中继续编辑
- 大表格自动启用虚拟滚动，万行表格也不会卡顿
- 支持导入后转置 / 排序 / 筛选（v0.1.17+）
项 ID：
excel↑ 返回索引Markdown 双向同步
编辑器和源码同步，写一次两边都对
- 编辑器与源码视图双向同步（任一侧改动后另一侧立即更新）
- 支持段落级 / 行级光标同步，切换不丢焦点位置
- 保留自定义样式：嵌入 HTML / 数学公式 / Mermaid 在两侧均能渲染
- 适配 GitHub Flavored Markdown 规范
项 ID：
md-sync↑ 返回索引jcode 高性能 AI 引擎（v0.1.10 新增）
Rust 内核加速，本地推理比纯 JS 快 5-10x
- 本地推理引擎（Rust 内核 + N-API 绑定），比纯 JS 快 5-10x
- 用于本地 Markdown 智能排版 / 表格识别 / 公式转换
- 不调用任何云端 AI，数据完全在本地处理
- 可在「设置 → 实验」中开启 / 关闭
是「本地优先」体验的重要支撑之一
项 ID：
jcode↑ 返回索引🧪 开发者参考 3 项
本地 API 与 IPC
主进程 / 渲染进程通信协议一览
- 主进程 / 渲染进程通信基于 Electron IPC，封装为 wpx.ipc.* API
- 内置通道：wpx.ipc.fs（文件系统）/ wpx.ipc.shell（外链）/ wpx.ipc.dialog（对话框）
- 新增自定义通道：见「electron/ipc.js」与「preload/index.js」
- 调试工具：Ctrl+Shift+I 打开 DevTools，IPC 日志在 Console
项 ID：
ipc↑ 返回索引扩展插件开发
自定义 Skill · 自定义指令 · 自定义导出格式
- 插件以 npm 包形式提供，需在「设置 → 插件」加载
- 可扩展点：自定义 Skill / 自定义指令 / 自定义导出格式 / 自定义面板
- 插件 API 文档：见 GitHub Wiki「插件开发」章节
- 官方示例插件：wpx-plugin-todo / wpx-plugin-word-count / wpx-plugin-git
项 ID：
plugins↑ 返回索引命令行工具
脚本化批量导出 / 测试 / 部署
- 命令行工具：wpx-cli（随桌面端安装包附带，位于安装目录 /bin）
- 支持：批量导出 / 批量转换 / 运行 Skills / 执行测试
- 脚本化部署：可结合 GitHub Actions 实现文档自动构建
- 查看帮助：wpx-cli --help
项 ID：
cli↑ 返回索引