# 牛神输入法使用说明

所有日常入口均使用牛神输入法品牌，安装包由本站提供。

## 界面语言

顶部或设置中的「界面语言」支持跟随系统，以及简体中文、繁体中文、英语、日语、韩语、西班牙语、法语、德语、葡萄牙语（巴西）。选择保存在当前设备；切换不会改变中文候选、用户正文和 AI 结果。报告后台、Android 应用及 iOS 工程提供对应语言入口。语言包可离线使用，详见 `docs/MULTILINGUAL.md`。

## 输入与联想

输入全拼或首字母，点击候选词或按空格上屏。工作台支持词库搜索、收藏、自定义词和个人数据备份。词库联想在本机运行，不需要账号或付费接口。当前词库含 86,334 条词音记录，并非全部中文词语的全集。

工作台 0.6.0 默认开启「拼音纠错建议」。例如 `nihoa` 可显示带「纠错」标记的「你好」，保留原始拼音，由你确认后上屏；也可按 Enter 输入原文。点击「撤销本次纠错」会恢复原文和拼音；再次编辑正文后旧撤销入口停用，避免覆盖新内容。设置中可随时关闭。当前只处理一次字母换位、漏键、多键或邻键误按，不保证整句、多处错误和短简拼的纠正。此版本未将该功能移植到原生手机键盘。

## 键盘布局

0.8.0 提供三种屏幕字母键排列：

| 选择 | 第一行 | 第二行 | 第三行 |
| --- | --- | --- | --- |
| 标准 QWERTY（默认） | QWERTYUIOP | ASDFGHJKL | ZXCVBNM |
| 字母顺序 ABCD | ABCDEFGHIJ | KLMNOPQRS | TUVWXYZ |
| 自定义键位 | 10 个字母 | 9 个字母 | 7 个字母 |

工作台在屏幕键盘上方或「偏好设置」选择布局。点击「编辑自定义键位」，按三行填写 A–Z，26 个字母各出现一次；大小写均可，普通空格、制表符和换行会忽略。重复、遗漏、数字、符号、全角字母及其他字符不能保存。可先用标准排序或字母排序填入，检查预览后点击「保存并使用」。关闭编辑窗口不会采用未保存的草稿。

模式和有效自定义在本机保存，刷新后保留；「恢复标准布局」只切回 QWERTY，此前保存的自定义仍可再选。网页个人数据备份包含布局。它只改变屏幕字母键的位置，数字、符号、功能键和实体键盘映射保持原样。不同端不会自动同步布局。

Android 0.8.0 在 App 首页提供对应选择与编辑入口，APK 已构建签名，尚未真机验证。iOS 0.8.0 工程有对应源码，但当前没有 IPA，需要 Mac / Xcode 构建签名及设备验收。详见 [键盘布局说明](KEYBOARD_LAYOUTS.md)。

## 键盘大小与位置

工作台屏幕键盘上方展开「调整大小与位置」，可以修改宽度与按键高度。勾选「悬浮键盘」后，用水平和垂直滑块定位，也可以拖动「拖动键盘」区域移动，拖右下角改变大小；聚焦拖动或缩放按钮后，方向键可微调。键盘会限制在当前页面的可见范围内，关闭悬浮则回到输入页面原来的区域。「恢复显示默认值」只重置显示位置与大小，不删除自定义字母排列。

Android App 首页的「键盘大小与位置」提供高度、宽度、水平位置和底部抬高；「靠左」「居中」「靠右」用于单手定位，恢复按钮回到默认大小和位置。窄屏会限制缩小幅度，横屏会减少可用高度与底部留白，实际显示可能达不到选择的最大幅度。调整在系统输入法窗口内生效，不需要悬浮窗权限；手机键盘不能随意覆盖其他 App 的任意屏幕区域。iOS 工程在键盘扩展内编辑并独立保存这些设置，容器 App 负责启用说明与反馈，尚未设备验证。

网页显示设置与字母布局都保存在当前浏览器并包含在个人数据备份中。手机设置分别保存在本机，不跨端自动同步。

## 安卓手机版

下载本站的「牛神输入法安卓 APK」，在手机打开安装，按系统提示允许当前来源安装。打开牛神输入法，先启用键盘，再切换到牛神输入法，在试玩框中输入 nihao 或 nh。

最低系统版本为 Android 8.0。0.8.0 为原生系统键盘预览版，已构建并通过签名校验，尚未完成真机验收。支持离线拼音、简拼、候选、搭配联想、个人词频、三种字母布局以及中英和标点切换；手机键盘暂未接入 AI。

## 电脑工作台

在牛神输入法网站直接使用，或下载离线体验文件在现代浏览器打开。支持的浏览器可将工作台安装为独立窗口应用。工作台里的输入仅作用于当前页面。

Windows 原生系统输入法 0.2.1 开发预览安装包为 `oxgod-windows-setup-v0.2.1.exe`，发布者品牌 OXGOD，包含 x64 与 x86 程序及普通话、粤语两套离线词库。官网 Windows 下载页会校验并合成为一个 EXE。双击打开安装界面，点击「安装」后请求管理员权限。安装完成后在系统键盘设置选择牛神输入法，按 Win + 空格切换；程序不会更改默认键盘。

已安装旧版时，先切换到其他输入法、关闭使用牛神输入法的应用，在 Windows 已安装应用中卸载旧版，再运行新版安装包。安装器不会自动覆盖正在使用的旧版或强制关闭应用。

0.2.1 修正常用单字与生僻字同权重造成的排序问题：普通话模式下，在空白输入处输入 `niu`，首选为「牛」，按空格或数字 1 上屏。普通话单字排序参考逐读音频次；粤语只使用字形常用级作补充，不套用普通话读音频次。生僻字和已有读音仍保留，可翻页选择；前文联想可能改变候选顺序，频率数据不能保证所有场景下首选都符合用户意图。

普通话库包含 465,323 条词音、44,365 个不同汉字；粤语库包含 134,266 条词音、26,983 个不同汉字。计数包含同一词的不同读音，来源与固定版本见 `data/SOURCES.md`，不代表任何一本大字典的完整原书。支持全拼、首字母简拼、全拼与简拼混用；例如普通话 `nihao`、`nh`，粤语 `neihou`、`nh` 可选「你好」。Ctrl + Shift + J 在普通话和粤拼之间切换，候选窗口显示当前模式。粤拼暂不输入声调数字，数字用于选候选。

单字候选与词语候选独立检索，常见词不会挤掉低频单字；Tab 切换单字 / 词语栏，左右方向键翻页，上下方向键选择，空格或数字选词。撇号明确分隔普通话音节，例如 `xi'an`；未收录的长串可先选择已识别前段，剩余拼音继续输入。此版本仍不保证任意整句自动转换质量。

此安装包尚无可信代码签名，未完成实际安装、卸载或微信、Word、浏览器等跨应用验收。当前仅供受控测试，不代表稳定正式版。不要关闭系统安全防护来安装。支持桌面 TSF 离线候选分页和有限逐字联想；Ctrl + 空格切换中英文。原生 Windows 版尚未接入工作台的 AI、翻译聊天、校对、统计报告或屏幕键盘自定义功能。macOS 原生系统输入法仍在开发。

## 苹果手机版

牛神 iOS 原生键盘正在开发中，等待构建、签名和设备验证。目前没有 IPA 或其他可安装版本，工程源码不提供公开下载。

## 牛神本地 AI

下载本地 AI 运行包。运行环境和模型配置完成后，Windows 双击 start.cmd，macOS 在终端执行 bash start.sh，打开 http://127.0.0.1:4173 。

在「牛神本地 AI」区域点击重新检测，看到「已连接」后即可使用。选中写作区的文字再选择润色、精简或其他改写方式；先查看建议，再决定是否采用。自动联想需要手动开启。

0.6.0 的「整理成文」「提炼要点」「纠正语病」作用于当前选中的最多 4,000 字。它们属于实验功能，实际效果取决于本地模型：长文整理必须返回分段，提纲必须返回多个要点；数字、时段或格式检查失败时提示重试，不改动正文。检查并不能保证含义、姓名和事实完整，采用前请阅读预览。较旧的本地服务会禁用不支持的新模式，需下载并重启新的运行包。

模型在自己的设备上运行，不使用收费 API。静态网站、单个离线文件和目前的手机键盘不会自动运行 AI。首次安装所需的技术配置说明随本地运行包提供；模型权重需另行下载，未包含在安装包中。

## 全球聊天

工作台 0.7.0 新增「全球聊天」。选择你使用的语言和对方的语言，默认中文与日语；支持九种语言任意互译，聊天语言与界面语言分别设置。

在「我的消息」输入中文，点击「翻译给对方」，检查或编辑日语译文后复制到聊天软件发送。收到日语消息后粘贴到「对方的消息」，点击翻译查看中文，再生成中文回复建议。采用建议只是填入草稿，你可以继续编辑、翻译和复制；不会自动发送。写作区底部的「翻译聊天」也能带入选区或全文。

「回译核对」将译文翻回你的语言；「停笔后自动翻译」需要主动开启。每条原文最多 2,000 字；聊天文本不保存到设备或报告，刷新前请自行保留需要的内容。可手动加入最多 6 条本次记录，再勾选允许回复建议参考它们。

本功能需要新版本地 AI 运行包与已安装的本地模型；公开网站、单个离线文件和手机键盘不运行聊天 AI。不能自动读取其他应用的聊天，模型译文仍需核对。完整说明见 `docs/GLOBAL_CHAT.md`。

## 使用报告与改进反馈

工作台的「使用报告」可查看今日、最近 7 天、最近 30 天的词频排行、采用次数、字数、使用时段和输入来源，支持 JSON / CSV 导出。统计从升级后开始，只记录在本程序中实际采用的候选词、联想和词库条目；不扫描输入正文、粘贴文本或其他应用。单日最多保留 500 个排名条目，超过后仍累计总量。

报告默认留在本机。访问输入法产品站 `https://input.oxgod.ai` 后，可以主动开启汇总分享、查看提交摘要再提交；官方词频分享和自动每日汇总需要分别开启。自定义词、组合句、正文、草稿和 AI 内容不上传。关闭分享停止后续上传，已提交数据可通过「删除服务器报告」删除。浏览器关闭期间不会自动上传；请在清除浏览器数据前删除不再保留的服务器报告，以免丢失本机删除凭据。

安卓 App 提供本地报告、导出和主动提交汇总；本版安卓不会上传具体词频。iOS 工程暂未接入使用报告。详见 `docs/USAGE_REPORTS.md`。

## 提交问题与建议

在官网打开「用户反馈」，选择问题类别与使用平台，填写最多 3,000 字的内容后点击「提交反馈」。标题和联系方式可选。反馈只提交你在表单填写的内容、平台与版本，不附带写作草稿、聊天内容或使用报告；提交后以显示的收件编号为准。

服务暂时不可用时会保留当前页面里的表单内容，并提示未确认成功，可重新连接后重试。刷新或关闭页面前请自行保存需要保留的反馈草稿。本地版和离线版提供「打开官网反馈」入口，反馈需联网提交。Android App 的「意见反馈」也会由你主动打开官网，不会把键盘正文传入网页。

## 数据与许可

个人学习、收藏、自定义词和键盘布局保存在当前设备。更换浏览器或清理数据前，请导出个人数据备份，其中包含网页键盘模式、已保存的自定义排列、大小与位置；未保存的编辑草稿不在备份内。不同端的数据暂不自动同步。

品牌和日常入口统一为牛神输入法；词库与运行组件的原始来源、版权和许可仍保存在「数据来源与许可」及下载包许可文件中。品牌统一不表示所有依赖和模型均为自主研发。