Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Word Tracking & Voice Activated broken for CJK (Chinese/Japanese/Korean) text

オープン 初心者向け
#60 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
swift

調査の方向性

SpeechRecognizer.swift を開き、まず Xcode を使って macOS アプリで報告された CJK Word Tracking と Voice Activated の動作を再現します。短い音声入力の CJK テキストが末尾にジャンプしなくなり、その後も Voice Activated のスクロールが継続することを確認します。修正を確認するため、Xcode で再ビルドします。

索引モデルが issue の本文から書いたものです。

説明

根本原因(两处 Bug):

Bug 1 — isFuzzyMatch 前缀匹配无长度限制
中文文本没有空格,整段稿子被当作一个"词"。你刚说出前6个字,isFuzzyMatch 用前缀匹配判断"今天天气很好" 是 "今天天气很好……全文" 的前缀 → 返回 true → wordResult = 整段文字长度(26)→ 飞跳到末尾。

Bug 2 — isDone 锁死滚动计时器
跳到末尾后 isDone = true,计时器有 guard !isDone → Voice Activated 的计时器也同时被锁死,所以两种模式都不动。


代码修复(需要 Xcode 重编译):

修改 SpeechRecognizer.swift 两处:

// 修复1:isFuzzyMatch 加长度比例限制(防止短词匹配超长句)
// 原来:
if shorter >= 3 && (a.hasPrefix(b) || b.hasPrefix(a)) { return true }
// 改为:
if shorter >= 3 && max(a.count, b.count) <= shorter * 3
&& (a.hasPrefix(b) || b.hasPrefix(a)) { return true }

// 修复2:matchCharacters 里,中文跳过 wordLevelMatch
// 在 charResult 计算后加:
let hasCJK = sourceText.unicodeScalars.contains {
$0.value >= 0x4E00 && $0.value <= 0x9FFF
}
let wordResult = hasCJK ? charResult : wordLevelMatch(spoken: spoken)

主要言語
Swift
スター
3.8k
フォーク
269
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

f/textream のほかの issue

f/textream の issue をすべて見る

似ている issue

Swift の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。