# 牛神输入法使用说明

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

## 界面语言

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

## 输入与联想

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

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

## 安卓手机版

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

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

## 电脑工作台

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

Windows 和 macOS 的牛神原生系统输入法仍在开发，当前没有可以加入电脑系统语言列表的自有安装包。

## 苹果手机版

牛神 iOS 原生键盘已完成工程源码，正在等待构建、签名和设备验证。目前没有可安装版本。标注「工程」的 ZIP 是开发文件，不能直接安装到手机。

## 牛神本地 AI

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

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

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

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

## 使用报告与改进反馈

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

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

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

## 数据与许可

个人学习、收藏和自定义词保存在当前设备。更换浏览器或清理数据前，请导出备份。不同端的数据暂不自动同步。

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