discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
Reamd7/notion-zh_CN · source
Snapshot 0 · 2026-11-04T12:47:26Z · JavaScript ·
Content fingerprint
709fb98f54180d088b206d8e740c769bdd9a04b94d88c0da1c2cbe881b975a1eGitHub description at capture
notion 中文化
README at capture
# Window / Mac 版本已经更新3.1.0，请使用更新版本
# notion-zh_CN 是什么？
notion-zh_CN 是对notion的汉化脚本。
## 功能
- 支持 网页端 ( 油猴脚本 ) + 桌面端 ( win / mac ) + 安卓端 汉化脚本
- （很久没有维护）提供cloudflare worker 版本代理 notion.so 域名
这是一个**平台无关**（IOS 上的safari也能直接使用）的汉化方式，只要你自己部署cloudflare worker，就可以使用。附带cf代理**加速**的能力。
> 其实这里应该可以做域名映射到notion.so的访问的。(从而实现全平台汉化)
# 为什么要做这个项目？
Notion 已经有了中文语料，让用户能够提前使用中文语料
# 如何使用?
## 网页端
1. ### 安装油猴插件
此处提供搜索到知乎的一篇教程：https://zhuanlan.zhihu.com/p/128453110
2. ### 安装油猴脚本
打开链接：https://greasyfork.org/zh-CN/scripts/430116-notion-%E5%AE%8C%E5%85%A8%E4%B8%AD%E6%96%87%E5%8C%96-%E5%9F%BA%E4%BA%8E%E9%9F%A9%E8%AF%AD%E7%89%88%E6%9C%AC-%E4%BD%BF%E7%94%A8%E8%85%BE%E8%AE%AFapi%E6%9C%BA%E7%BF%BB 。然后点击安装。
3. ### 体验汉化效果
https://www.notion.so
## 桌面端
notion 客户端迎来了巨大更新，文件结构发生完全不一致的变化（没有了可以注入的preload.js了）
**有问题发issue，最好是贴录屏，gif 能直接贴在issue**
### 预处理版本
[https://github.com/Reamd7/notion-zh_CN/releases/tag/3.0.0](https://github.com/Reamd7/notion-zh_CN/releases/tag/3.1.0)
- `app.win.zip`
- `app.mac.zip`
都已经有了app文件夹
打开 `Notion安装目录/resources`
解压 `预处理压缩包` 到 `Notion安装目录/resources` 下
删除 `app.asar` 或 重命名为其他名字
### **（修改原理）：** windows / mac
打开 `Notion安装目录/resources`
解压 `app.asar` 到相同目录的 `app` 文件夹下
找到 `.webpack/main/index.js`
1. 搜索 `localeHtml`
看到一个 `localeHtml[r]`
将 `r` 替换为 `zh-CN` / `zh-TW`
目的是直接使用缓存资源文件中 zh-CN 的 html
2. 搜索 requestReturnedAsIndexV2
看到 const e = l.default.join(i, u.path); 是文件的绝对路径
在下方直接注入以下代码, 目的是修改 renderer 中 localStorage 的 locale 缓存值
```js
if (u.path.endsWith('.html')) {
const fs = require('fs');
const htmlContent = fs.readFileSync(e, 'utf-8')
if (!htmlContent.includes(`{"id":"KeyValueStore2:preferredLocale","value":"zh-CN","timestamp":Date.now(),"important":true}`)) {
(() => {
fs.writeFileSync(e, htmlContent.replace("</html>", `<script>
// ==UserScript==
try {
const preferredLocaleStr = window.localStorage.getItem(
"LRU:KeyValueStore2:preferredLocale"
);
const preferredLocale = JSON.parse(preferredLocaleStr) || {"id":"KeyValueStore2:preferredLocale","value":"zh-CN","timestamp":Date.now(),"important":true};
if (preferredLocale.value) {
preferredLocale.value = "zh-CN";
}
window.localStorage.setItem(
"LRU:KeyValueStore2:preferredLocale",
JSON.stringify(preferredLocale)
);
} catch (e) {}
</script>
</html>`))
})();
}
}
```
保存
删除 `app.asar` 或 重命名为其他名字
打开应用
### More
如果你不想修改软件源码，还有如下方案（之后可能会写成自动化脚本）
1. 打开Notion的资源缓存文件
windows: `C:\Users\[用户名]\AppData\Roaming\Notion\notionAssetCache-v2`
mac
2. 找到热更新资源最新的版本
基于语义化版本规则可以判断，或者看 `latestVersion.json` 内部 `version` 字段
以下以当前最新版本 `23.13.0.23` 举例子
3. 打开最新版本所在文件夹 `23.13.0.23/assets.json`
搜索到 `localeHtml` 字段，
将下级`en-US` 字段的值改为和 `zh-CN` 或 `zh-TW` 一致
保存
重启
该方案问题是 Notion 经常热更新会更新缓存，那就要一个自动化的脚本自动做如上的事情解决问题
## cloudflare worker
> 不建议使用。不希望推广。有风险。你需要知道你在干什么。
1. 首页：https://workers.cloudflare.com
2. 注册，登陆，`Start building`，取一个子域名，`Create a Worker`。
3. 复制 [worker.js](https://github.com/Reamd7/notion-zh_CN/blob/main/worker.js) 到左侧代码框，修改
```js
const BaseUrl = "xxxx.子域名.workers.dev" // 修改为自己的子域名
```
4. `Save and deploy`。如果正常，右侧应显示提示框：
Mismatch between origin and baseUrl (dev).
好的（这里就证明汉化成功了）
5. 以后可直接访问 `https://xxxx.子域名.workers.dev`。
## 安卓端
- 下载apk：[https://github.com/Reamd7/notion-zh_CN/blob/main/apk/Notion_0.6.1122.beta(7122)_zh_cn.apk](https://github.com/Reamd7/notion-zh_CN/blob/main/apk/Notion_0.6.1122.beta(7122)_zh_cn.apk)
# 大家可以做什么？
1. **优化汉化语言**。都是机器翻译，看到不通畅的句子欢迎提issue/pr直接改了 （修改 **`json/zh.json`** 文件，了解之前，先找到原有的英文，韩文对照一下再更新翻译。）
# 呼吁：
提高付费率，支持你所支持的软让他发展更好，这样国内市场才会更受重视，而不是只是白嫖，买淘宝，搞教育账户。
## Star History
[](https://star-history.com/#Reamd7/notion-zh_CN&Date)
> 风险提示：使用 cloudflare worker 的同学，被官方检测出来并封号与我无关，希望自己看明白代码做了什么，以及为什么会被检测出来。
> 其他方式的，都是使用官方国际化方案进行国际化的，而且在本地进行操作不通过任何服务器——理论上除非故意钓鱼否则不会封你。
> 钓鱼：主动收集你是不是用了中文版国际化字段，而且，对比你并没有中文版权限。
>
> 如果担心有问题，可以等待官方中文版，可以稍微学习网页开发，可以询问网页开发朋友，项目都是开源的。究竟做了什么操作，对notion 应用本体有什么影响，没有理由的担心只能体现对别人的不信任。
>
> 该项目仅用于学习，如有侵权24h内会马上删除。
# 更新日志：
- 2.4.20 补充 window 更新目录文件之后的 自动注入软件 / 手动注入教程
- 2.4.2 **翻译开始跟随着官方中文词条啦!!!!!**
- 2.4.1 支持 ios / macos user script
- 2.3.1 权衡后，安卓版本使用新的 runtime 注入方式，实现全部的（包括键盘都能够汉化的方式）但有首页白屏事件较长的问题。
- 2.3.0 支持使用 cloudflare worker 进行代理 notion.so 域名进行加速及国际化
- 2.2.0 支持 安卓版本notion，与官方版共存 的汉化！
- 2.1.0：支持中文版快捷命令！支持拼音输入的时候显示快捷命令！
- 2.0.4: 彻底支持无论是默认英文还是韩文都会生效的汉化脚本（2021/08/19 油猴剧本 + win 客户端 + mac 客户端测试通过），统一 win mac 网页端实现。
- 2.0.3：支持切换到韩文之后帮助文档还原到默认英文版本
- 2.0.1：支持mac客户端（英文）
- 2.0.0: 支持win客户端（韩文） + 油猴脚本