这是一个“文档仓库”，用于帮助新手更快上手「万象输入法 / rime_wanxiang」。方案文件与实现请前往源项目获取。
- 源项目（方案与实现）：https://github.com/amzxyz/rime_wanxiang
- 本仓库内容（文档）：
docs/
- ⚡ 智能整句输入 - AI筛选的大基数词库 + 语言模型，更精准的整句联想
- 🎵 唯一支持整句拼音串上屏 - 词库全部带声调标注，可显示/输入音调
- 🔧 6种辅助码 - 墨奇/鹤形/自然码/虎码/五笔/汉心码，拼音+辅助码任意组合
- 🔍 强大反查系统 - 支持两分/多分/笔画三种打法，U+Unicode完整覆盖
- 🎨 丰富Lua扩展 - 成对符号、tips提示、手动排序、无感造词等创新功能
- 🧩 错位构词法 - 长期死磕权重最优解、分词片段最优解
💡 核心理念
万象词库中的带声调拼音标注+词组构成+词频是整个万象项目的核心，是使用体验的基石。 方案的其它功能皆可自定义，希望使用者可以基于词库+转写的方式获得输入体验。
| 特性 | 标准版 | 增强版PRO |
|---|---|---|
| 方案文件 | wanxiang.schema.yaml |
wanxiang_pro.schema.yaml |
| 支持类型 | 全拼、任何双拼 | 只支持双拼 |
| 自动调频 | ✅ 默认开启 | ❌ 默认关闭 |
| 用户词记录 | 无差别自动记录 | 需手动造词（``引导） |
| 用户词位置 | wanxiang.userdb |
zc.userdb |
| 辅助码 | 基于声调的辅助 | 7种辅助码可选，兼容声调 |
| 推荐场景 | 日常使用 | 喜欢精准控制、辅助码选字 |
整个rime配置生态都是通的，不了解rime基础的可以参考友情链接，初步了解rime运行的些许特性：
💡 友情提示： 如果你是第一次使用万象，可以不要用你过往经验来定义万象，按如下的步骤将万象跑起来后,体验一下万象的功能，然后学习一下万象的各项内容之后再考虑。
- 将方案文件
rime-wanxiang-base.zip、语法模型wanxiang-lts-zh-hans.gram置于Rime用户目录 - 输入以下指令切换双拼/全拼类型
- 重新部署，完成！
/flypy → 小鹤双拼
/mspy → 微软双拼
/zrm → 自然码
/sogou → 搜狗双拼
/pinyin → 全拼
/wxsp → 万象双拼
# ... 更多指令见下方💡 提示：这些指令能一次性完成4个补丁文件的输入类型修改，无需手动配置！
安装环境可用plum命令简单安装与更新，在保证安装小狼毫、中州韵、鼠须管等前端的前提下。
👇 plum命令安装
环境要求
⚠️ 注意：Windows的PowerShell/CMD不能直接运行东风破，必须用Git Bash。 macOS / Linux | ✅ 已内置bash
步骤1：安装Plum
这是维护在万象仓库plum分支的版本，去掉了默认方案，修改了默认路径。
# 打开终端，执行以下命令
git clone -b plum --depth 1 https://github.com/amzxyz/rime_wanxiang.git
cd plum步骤2：配置用户目录变量
对于小狼毫、鼠须管、Fcitx5已经默认配置了变量：
# 小狼毫
export rime_frontend='rime/weasel'
# 鼠须管
export rime_frontend='rime/squirrel'
# Fcitx5
export rime_frontend='fcitx5/fcitx5-rime'但对于Linux、Mac使用ibus、fcitx前端需要自己设置变量（可终端执行，最好写入~/.zshrc）：
# ibus-rime
export rime_frontend=rime/ibus-rime
# fcitx-rime
export rime_frontend=fcitx/fcitx-rime步骤3：执行安装命令
切换到plum目录，执行对应的安装命令即可实现安装和更新。
基础版（完整）
bash rime-install amzxyz/rime_wanxiang@wanxiang-base:plum/full自然码辅助版（完整）
bash rime-install amzxyz/rime_wanxiang@wanxiang-zrm-fuzhu:plum/full📦 查看全部Plum安装命令
基础版
# 完整版
bash rime-install amzxyz/rime_wanxiang@wanxiang-base:plum/full
# 仅词库
bash rime-install amzxyz/rime_wanxiang@wanxiang-base:plum/dicts辅助码版本
# 自然码辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-zrm-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-zrm-fuzhu:plum/dicts
# 墨奇辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-moqi-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-moqi-fuzhu:plum/dicts
# 小鹤辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-flypy-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-flypy-fuzhu:plum/dicts
# 虎码辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-tiger-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-tiger-fuzhu:plum/dicts
# 五笔辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-wubi-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-wubi-fuzhu:plum/dicts
# 汉心辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-hanxin-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-hanxin-fuzhu:plum/dicts
# 首右辅助
bash rime-install amzxyz/rime_wanxiang@wanxiang-shouyou-fuzhu:plum/full
bash rime-install amzxyz/rime_wanxiang@wanxiang-shouyou-fuzhu:plum/dicts- Windows：wanxiang-tools.exe - 内置在线更新器
- 跨平台脚本：rime-wanxiang-update-tools
万象拼音提供丰富的Lua扩展功能，让输入更高效。
🔧 日期时间快捷输入
引导键：/ 或 o
| 编码 | 功能 | 说明 |
|---|---|---|
/sj 或 osj |
时间 | 显示当前时间 |
/rq 或 orq |
日期 | 显示当前日期 |
/rc 或 orc |
日期差 | /rc26p（加26天）、/rc26-（减26天） |
/nl 或 onl |
农历 | 显示农历日期 |
/xq 或 oxq |
星期 | 显示星期几 |
/ww 或 oww |
周数 | 今年第几周 |
/jq 或 ojq |
节气 | 显示节气信息 |
/dt 或 odt |
日期+时间 | 显示完整日期时间 |
/tt 或 ott |
时间戳 | Unix时间戳 |
/jr 或 ojr |
节日 | 显示节日信息 |
/day 或 oday |
问候模板 | 显示问候语 |
N模式：N0101（月日）或 N20250315（完整年月日）
💡 支持自定义格式和顺序，详见方案配置
wanxiang.schema.yaml
🔧 计算器模式
引导键：V
输入示例：
V3+5→8和3+5=8- 支持
+ - * / % ^ - 支持
sin(x)cos(x)等函数 - 详见
super_calculator.lua
🔧 超级Tips提示
化学式：
上屏触发键：逗号 ,（默认）
支持类型：表情|化学式|翻译|符号|货币|车牌|偏旁部首
快捷键：
Ctrl+T- 开关Tips,- 上屏Tips内容
- 文字和超级提示的映射关系 参考配置文件
lua\tips\tips_show.txt - 如果默认的tips_show.txt 满足不了你，也可以建立自己的配置文件
lua\tips\tips_user.txt(格式和上面文件一致)
🔧 /引导模式
通过输入 /sx 快捷输入关于“数学”的特殊符号，具体能输入什么可以打开 wanxiang_symbols.yaml学习。以及前述提到的日期、时间等的引导都共用斜杠开头，可以理解为一种命令模式。其中/wx可以查询仓库连接和当前版本
🔧 辅助码提示（仅PRO）
Ctrl+A- 循环切换：辅助码提示 → 声调全拼提示 → 关闭注释Ctrl+C- 开启拆分辅助提示（优先级更高）
默认显示1个字的辅助码，可在方案文件中自定义长度。
🔧 快速符号（快符）
输入 a/ 快速上屏"！"符号
可自定义26个字母的映射关系：
repeat- 重复上一次上屏的内容- 修改正则表达式可改变引导策略
配置位置：quick_symbol_text 段落
🔧 输入码音调显示
快捷键：Ctrl+S
实时动态显示全拼并加音调（万象特色功能）
Shift+Enter - 上屏当前显示的编码字符串
🔧 用户按需造词 中文无感造词（仅PRO）
用户按需造词：``
三种造词方式：
``起始的主动造词- 编码后双击
``的主动造词（后触发） - 次选造词 - 次选是词库组合成的，上屏即记录
中文无感造词Lua(仅PRO)
- 关闭调频情况下，通过
逐步选字选词的方式上屏将为你记录整段 - 遵循用户词管理的逻辑
- 直接上屏不造词
💡 PRO版讲究自主可控，避免异常词汇污染词库
🔧 手动排序
快捷键：
Ctrl+J- 向左一步Ctrl+K- 向右一步Ctrl+L（零）- 移除排序信息Ctrl+P- 置顶选中候选
支持：
- 词典候选排序
- 动态Lua候选排序（日期/时间等格式）
数据存储：lua/sequence.userdb 排序后的数据可以同步 参考 排序信息同步
🔧 更多Lua功能
| 功能 | 触发方式 | 说明 |
|---|---|---|
| 输入统计 | /rtj /ztj /ytj /ntj /tj |
日/周/月/年/生涯统计 |
| 翻译模式 | Ctrl+E |
opencc中英文互译 |
| 字符集过滤 | Ctrl+G |
小字集/大字集切换 |
| 输入模式切换 | Ctrl+Q |
中文/英文/混合编码切换 |
| 声调辅助回退 | 直接输入7890 | 在声调间快速切换 |
| 候选切割机 | Ctrl+1~0 |
上屏首选前N个字 |
| Tab循环切换 | Tab |
循环切换音节 |
| Unicode | U + 编码 |
U62fc → 拼 |
| 符号输入 | /sx /yd 等 |
特殊符号快捷输入 |
| 错音错字提示 | 自动触发 | gei yu → jǐ yǔ提示 |
万象拼音支持多种辅助码，让你在拼音基础上快速定位目标字。
📖 直接辅助码（仅PRO）
使用场景：想要"镇"字显示在前面
输入 vf（镇）+ j（金字旁声母）→ 快速出现"镇"字
如果继续输入其他主体字的声母，可以进一步缩小范围。
📖 间接辅助码（仅PRO）
**使用场景**：避免辅助码干扰双拼词语输入 ni/re - 通过 / 引导辅助码
- 不加
/时，与普通双拼无异，如vsg可以输出"中国" - 加
/后，进入辅助码筛选模式
聚拢功能：输入 nire/ 让系统侧重于单字匹配
📖 声调辅助筛选
7890 代表 1234 声（轻声归并到4声）
输入示例：
ni9→ 你（三声）niRE→ 大写字母代表辅助码niR9E→ 混合使用声调和辅助码
📖 输入后反查筛选
使用场景：通过反查字库定位词组或单字
输入主要拼音后，通过 ` 引导进入反查状态：
lkuiuojd`` → 筛选包含"老"字底的词lkuiuogt`` → 筛选包含"实"字的词- 支持
.*t.*b.*g.*的正则匹配逻辑
注意：词组匹配不支持笔画，单字支持两分、多分、笔画
📖 拆字模式
使用场景：不认识的字用部件组合输入
示例：输入"震"字
- 输入
yuif（雨 辰）+`→ 出现"震"字 - 同时给出辅助码提示：
y（雨声母）+i（辰声母）
📖 笔画模式
使用 hspnz 代表横竖撇捺折五笔画
示例：
- 两分：
nire、`ni`rfer - 多分：
muckrida`` - 笔画：
nipspzhpd``
所有混合编码功能统一在 wanxiang_mixedcode.schema.yaml 方案中，无需引导，直接输入。
| 功能 | 输入示例 | 输出 |
|---|---|---|
| 中英混合 | 1000wclips |
1000wclips |
| 混合编码 | AD钙奶 |
AD钙奶 |
| 技术词汇 | PN结、Type-C |
PN结、Type-C |
| 纯英文 | hello |
hello |
| 金额大写 | R1234 |
一千二百三十四、壹仟贰佰叁拾肆元整 |
| Unicode | U62fc |
拼 |
自动上屏： 例如：三位、四位简码唯一时，自动上屏如jjkw岌岌可危 zmhu怎么回事 。默认未开启，方案文件中speller:字段下取消注释这两句开启 # auto_select: true # auto_select_pattern: ^[a-z]+/|^[a-df-zA-DF-Z]\w{3}|^e\w{4}
数字后自动半角： 当中文状态输入数字的时候后面立即输入,。将自动转换为数字分割符，例如科学记数法1000,000 小数点 3.1415,如果你加入冒号:还可以优雅的输入时间12:30，当然你还可以双击输入的符号恢复全角符号的输出。但若你完全没有场景使用该功能，则可以通过patch，将其修改为commit
punctuator/digit_separators: ",." > punctuator/digit_separators: commit
错音错字提示： 例如：输入gei yu给予，获得jǐ yǔ提示，此功能与全拼、双拼类型无关全部支持；
用户词删除： 使用Ctrl+del是rime系统删除用户词,就可以将用户词标记为c<=0，这在rime系统中就表现为不使用，假性删除。
输入模式切换Lua： 使用Ctrl+q来进行中文候选词、英文候选词、混合候选词之间切换，默认为混合编码输入模式。
- Custom文件生效位置：用户目录根目录（与schema同级）
- custom目录仅用于携带和更新不覆盖
- 根目录的
wanxiang.custom.yaml才是你的配置文件
# wanxiang.custom.yaml
patch:
# 方案列表
schema_list:
- schema: wanxiang
# 简繁切换
switches/@0/reset: 1
# Tips快捷键（comma/period等）
key_binder/tips_key: comma
# 自定义短语文件名称
translator/translation_file: custom_phrase.txt
# 关闭自动调频（仅PRO）
# engine/translators/@7/enable_user_dict: false💡 详细配置方法见方案文件
custom/目录下的教程
万象的自定义短语文件名称默认为 custom_phrase.txt，参考文件里的配置示例
万象提供了多设备用户词同步功能，让你在不同设备间保持一致的输入体验。
- 基础配置
📱 单设备用户词编辑
适用场景：只有一个设备，想手动编辑用户词
操作步骤：
- 点击"同步用户数据"，生成
用户目录/sync/设备名/wanxiang.userdb.txt - 使用工具将词库转换为万象格式（声调+辅助码）
- 编辑txt文件，保持格式一致
- 重新点击同步，导入数据库
💡 格式要求：
db_name必须与用户词典文件名一致user_id= 设备文件夹名 =installation_id字段必须保持一致
- 用户词库迁移
⚙️ 同步配置详解
前置知识: 同步是将用户词按时序合并导入导出的本地操作。
同步目录配置
默认同步目录为 用户目录/sync，如需自定义，在 installation.yaml 中添加：
# Linux/Mac/Android
sync_dir: "/home/amz/sync"
# Windows (双引号)
sync_dir: "D:\\home\\amz\\sync"
# Windows (单引号)
sync_dir: 'D:\home\amz\sync'设备ID配置
修改 installation_id 为可辨识的设备名称(建议按系统命名):
installation_id: "windows" # 或 "linux"、"mac"、"ios" 等根据 installation_id 创建设备文件夹:
用户目录/sync/windows
用户目录/sync/linux
用户目录/sync/ios
同步文件说明
点击"同步用户数据"后,系统将用户词库导出为txt文件:
| 数据库文件 | 同步文件名(标准版) | 同步文件名(PRO版) |
|---|---|---|
wanxiang.userdb |
wanxiang.userdb.txt |
- |
zc.userdb |
- | zc.userdb.txt |
txt文件表头格式:
# Rime user dictionary
#@/db_name zc
#@/db_type userdb
#@/rime_version 1.13.1
#@/tick 793
#@/user_id ff9b2823-8733-44bb-a497-daf382b74ca5
关键要求:
db_name必须与用户词典文件名一致user_id= 设备文件夹名 =installation_id三者必须保持一致
🔄 多设备词库同步流程
步骤1：配置设备ID
打开用户目录的 installation.yaml 文件，修改 installation_id 为设备名称：
installation_id: "windows" # 或 "linux"、"mac"、"ios" 等步骤2：创建设备清单
在 /sync 目录中创建 sequence_device_list.txt：
sequence_windows.txt
sequence_linux.txt
sequence_ios.txt
步骤3：同步合并逻辑
重新部署后，系统会自动：
- 导出：将当前设备数据导出到
sequence_设备id.txt - 合并：读取清单中的所有文件，按时序去重合并
- 回写：将合并结果回写到当前设备的sequence文件
- 导入：将合并后的数据导入数据库
步骤4：云同步
- 通过云同步软件（如坚果云、Dropbox）同步
/sync目录 - 在其他设备上，更新
sequence_device_list.txt添加对应设备文件 - 重新部署，完成多端数据合并
📝 单设备编辑与模拟同步
单设备用户词编辑
如果只有一个设备,可以直接编辑用户词:
- 点击"同步用户数据",生成
用户目录/sync/设备名/wanxiang.userdb.txt - 删除用户目录的
userdb(避免冲突) - 使用工具将词库转换为万象格式(声调+辅助码)
- 编辑txt文件,确保格式与万象编码完全一致
- 点击同步,导入数据库
格式要求:
- 编辑的txt文件必须经过预处理
- 必须保持万象编码格式(声调+辅助码)
db_name、user_id等字段必须符合规范
模拟多设备同步
如果想测试多设备同步逻辑:
- 将编辑好的txt文件内的
user_id修改为其他设备名(如linux) - 将文件放入
用户目录/sync/linux/目录 - 点击同步,系统会将其与当前设备数据合并
💡 提示：此功能可用于数据迁移和备份，也是真正的多设备同步逻辑的模拟。
- 同步目录：只同步
/sync目录，不要将整个rime文件夹放入同步软件，会导致数据库锁定 - 文件格式：编辑用户词txt时必须保持万象编码格式（声调+辅助码）
- 设备ID一致性：确保
installation_id、设备文件夹名、user_id三者完全一致 - 可靠性说明：此流程模拟Rime同步方式，为多端数据合并过程，iPhone设备可能遇到更多问题
- 排序信息同步
📊 手动排序数据同步
功能说明：万象的手动排序功能支持词典候选排序和动态Lua候选排序（如日期/时间格式），排序数据存储于 lua/sequence.userdb，可在多设备间同步。
同步方式：排序信息的同步流程与用户词同步完全一致，只需复用上述配置：
- 复用设备ID配置：
installation.yaml中的installation_id（已配置） - 复用设备清单：
sequence_device_list.txt（已创建） - 自动合并同步：重新部署时，排序数据会与用户词一同合并
数据文件说明：
| 数据类型 | 文件位置 | 同步文件名 |
|---|---|---|
| 用户词 | wanxiang.userdb |
wanxiang.userdb.txt (标准版)zc.userdb.txt (PRO版) |
| 排序信息 | lua/sequence.userdb |
sequence_设备id.txt |
快捷键回顾：
Ctrl+J- 向左一步Ctrl+K- 向右一步Ctrl+L- 移除排序信息Ctrl+P- 置顶选中候选
💡 提示：排序信息同步无需额外配置，完成用户词同步配置后自动生效。每次点击"同步用户数据"时，排序信息会与用户词一同导出/导入。
- 相关工具
所有指令格式：/ + 代码
/flypy → 小鹤双拼
/mspy → 微软双拼
/zrm → 自然码
/sogou → 搜狗双拼
/znabc → 智能ABC
/ziguang → 紫光双拼
/pyjj → 拼音加加
/gbpy → 国标双拼
/lxsq → 乱序17
/pinyin → 全拼
/wxsp → 万象双拼
/zrlong → 自然龙（反查全拼）
/hxlong → 汉心龙（反查全拼）
/jjf → 间接辅助
/zjf → 直接辅助
在你的 wanxiang.custom.yaml 中配置：
wanxiang_lookup:
tags: [abc] # 生效的tag
key: "`" # 反查引导符
lookup: [wanxiang_reverse] # 反查数据库
data_source: [comment, db] # 数据源优先级
# comment: 从词库注释(辅助码)提取
# db: 从反查数据库提取- iOS 仓输入法
- 方案下载：仓设置 → 输入方案 → "+" → 万象拼音
- 切换方案：长按
/+ 方案代码（如/flypy） - 关键步骤：文件管理 → 拷贝键盘词库至应用
- 重新部署
- iOS 元书输入法
- 从
RimeSharedSupport复制include_keyboard_rime_files.txt - 修改文件底部新增：
^.*[.]custom.*$ - 重新部署
- Android
- 小企鹅等前端数据位于
data目录 - 需通过系统文件管理器迁移（不是MT文件管理）
- 或通过root修改权限保持一致
❓ 如何更新词库和方案？
推荐方式：
- Plum用户：重新运行安装命令即可自动更新
- 工具用户：使用wanxiang-tools内置更新器
- 手动更新：下载Release包，保留
*.custom.yaml后覆盖
白名单保护：wanxiang-tools支持白名单，保护自定义文件不被覆盖
❓ 自定义词库如何添加？
步骤：
- 使用工具将词库刷成万象格式（声调+辅助码）
- 固定词库（推荐）：
patch: translator/packs/+: - userxx # 你的词库名
- 或重命名
wanxiang.dict.yaml为wanxianguser.dict.yaml
💡 词库工具下载
❓ 按键设置思考
**核心理念：打破习惯，重塑效率**输入法的设计本质是“有舍有得”。很多新手习惯于大厂软件的逻辑，但那些习惯未必是最优解。在 RIME 中，如果不经过逻辑思考就盲目套用旧习惯，很难发挥其真正的威力。
万象方案的按键逻辑：
- 斜杠
/的唯一性：作为核心功能键，不支持挪作他用，请勿尝试修改。 - 高效上屏逻辑：逗号与句号在无提示（Tips）时倾向于随语句直接上屏，减少确认按键；句号在有提示时亦可直接触发。
- 筛选区设计：
-=键位用于翻页，与7890（对应 1234 声调）共同构成高效筛选操作区，复刻经典 ABC 时代的高效逻辑。
💡 建议：万象的键位布局是经过逻辑推演的效率闭环。与其强行修改配置以适配旧习惯，不如尝试适应这套更科学的方案。
❓ 模型文件很大，影响性能吗？
回答：不会！
- 模型是固定的二进制数据，不会增大
- 只占用少量CPU算力，内存占用极少
- 不同于热加载数据，应视为优秀的算法模块
- 非常值得投入，大幅提升整句准确度
- 💬官方文档
- 友情链接
- Oh My Rime - Rime基础入门
- Rime参数配置 - 详细配置说明
- 工具下载
- 自定义数据 在线获取（不随方案包提供）：
jm_flypy.txt- 小鹤简码jm_zrm.txt- 自然码简码tips_user.txt- Tips翻译数据