pi-opencc

pi Fullscreen 輸入框的繁簡轉換與兩階段送出

Packages

Package details

extension

Install pi-opencc from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-opencc
Package
pi-opencc
Version
0.1.0
Published
Oct 14, 2026
Downloads
not available
Author
cwz-dev
License
MIT
Types
extension
Size
18.8 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-opencc

Pi 套件頁 · GitHub · npm

這是什麼

pi-opencc 是一個 Pi 套件,用來在輸入框中轉換繁體中文為簡體中文。

為什麼需要這個套件

因為目前 LLM 使用的 tokenizers,對簡體中文的分詞效率比繁體中文更高,換句話說,使用簡體中文更省 token。

為什麼不轉成英文

轉成英文會有以下主要問題:

  1. 難以保證語意相同
  2. 需要本地安裝翻譯模型
  3. 翻譯速度比繁轉簡慢

我認為承受這些問題僅僅只是為了省 token 是完全沒必要的。如果你真的想要轉換成英文,可以使用其他人實作的 package,例如 @pmlpm/pi-translate-zh-en

安裝

需要 Node.js 22.19.0 以上,pi v1.1.0 以上,互動 TUI 設為 Fullscreen。

pi install npm:pi-opencc

移除套件:

pi remove npm:pi-opencc

如何使用

  1. 在輸入框撰寫訊息,按第一次 Enter。
  2. pi-opencc 會在原輸入框把文字轉成簡體,不會送出。
  3. 檢查或修改內容,再按一次 Enter 送出。

輸入框邊框會提示目前 Enter 的作用:「Enter 轉簡體」或「Enter 送出」。一般 TUI、print、JSON 和 RPC 模式不會啟用本功能。

英文、已是簡體或轉換前後相同的非空草稿,也需要按兩次 Enter;空白草稿不會送出。OpenCC 使用台灣用詞轉大陸用詞,例如「軟體、滑鼠、網路」會轉成「软件、鼠标、网络」。

修改與復原

轉換後可以直接修改;第二次 Enter 會原樣送出,不會再轉一次。pi 原生 undo 也能復原轉換:轉換後立即 undo 可還原原稿;若先修改,undo 會先撤銷修改,再撤銷轉換。當確實發生轉換,而草稿之後完整恢復成原稿時,下一次 Enter 會重新轉換。

若轉換結果與原文相同,仍會進入確認階段,但不會新增多餘的 undo 紀錄。

哪些文字會轉換?

一般文字會轉換;程式碼、Markdown 連結目標、圖片引用、URL 與 HTML 等內容會盡量保留。一般 Markdown 連結的顯示文字仍會轉換。

目前無法保證裸露的 @檔名 或檔案路徑維持原樣。 例如 @測試檔案 可能被轉成 @测试文件,使 pi 找不到原檔。含中文的檔名或技術路徑,也請勿在未確認引用結果前直接送出;保護 pi 的 @檔案 引用仍是待辦。

需要原樣保留的路徑或技術字串,可用 Markdown inline code 包住,例如 `資料夾/測試檔案.ts`。這只保護文字轉換,不代表它仍會被 pi 當成可點選或附加的檔案引用。

轉換失敗時,草稿會保持原樣並留在輸入框,不會送出。

原生操作與限制

  • / 命令與 !/!! shell 操作沿用 pi 原生行為,不經繁簡轉換。
  • autocomplete 開啟時,Enter 先交給 pi 確認選項;Shift+Enter 與一般換行也維持原樣。
  • 其他送出快捷鍵(例如 follow-up)不受兩階段保護,可能直接送出尚未轉換的草稿。
  • 不會轉換附件內容;附件仍由 pi 原生處理。
  • 本套件需要自己的 custom editor,不能與其他提供 custom editor 的 extension 一起使用。若啟動時已偵測到衝突,本功能會停用並提示。

開發與測試

npm ci
npm run verify
npm pack --dry-run

自動測試不呼叫真實模型。實際 Fullscreen、中文輸入法與終端操作仍需人工確認;請查看 TODO.md 的驗收項目。

專案連結