Skip to main content

fenci

中文分词模块

本分词器采用基于词典的最大正向匹配算法为主,辅以HMM(隐马尔可夫模型)进行未登录词识别。在 SIGHAN Bakeoff 2005 数据集上的评测结果为:Precision 83.59%、Recall 84.47%、F1 84.03%,处理速度达 1145.6 KB/s。结果表明,该分词器在准确性与处理效率之间取得了良好平衡,适用于对实时性要求较高的通用文本分词场景。

重要提示

  • 模型文件默认是 \AppData\Local\Temp 里面的 fenci_model ,该模型实际就是一个json文件。后续你可以继续训练该模型,也可以回滚该模型 (seg.reset_model())。
  • 推荐将 seg = Segment() 放在一个更全局的位置,而不要频繁创建它。

安装

pip install fenci

使用

lcut or cut

from fenci.segment import Segment
seg = Segment()
res = seg.lcut("这是一段测试文字。")

加载自定义词库

from fenci.segment import Segment
s = Segment()
s.load_userdict('tests/test_dict.txt')

训练模型

指定root和regexp来搜索指定文件夹下的文本,其中的文本格式如下:

’  我  扔  了  两颗  手榴弹  ,  他  一下子  出  溜  下去  。

即该分词的地方空格即可。

from fenci import Segment
seg = Segment()

seg.training('../icwb2-data/training', 'msr_training.utf8', with_hmm=True)

seg.save_model(save_hmm=True)

注意training之后词典库还只是on-fly模式,要保存到模型需要调用方法save_model

只训练HMM模型
from fenci import Segment
seg = Segment()

seg.hmm_segment.traning('../icwb2-data/training', 'msr_training.utf8')

seg.hmm_segment.save_model()
只训练词库
from fenci import Segment
seg = Segment()

seg.traning('../icwb2-data/training', 'msr_training.utf8', with_hmm=False)

seg.save_model(save_hmm=False)

回滚模型

回滚到默认模型

from fenci import Segment
s = Segment()
s.reset_model(model='default')

评估

评测使用 SIGHAN Bakeoff 2005 金标准文件 :

=== 分词评测结果 ===
总词数(金标准): 106873
总词数(预测):   107996
正确词数:       90279
Precision:      83.59%
Recall:         84.47%
F1:             84.03%

=== 速度测试 ===
文本大小:       539.3 KB
重复次数:       3
平均耗时:       0.471 s
速度:           1145.6 KB/s

Release files for fenci 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fenci 0.4.1
File Size Uploaded
fenci-0.4.1.tar.gz 1.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for fenci 0.4.1
File Interpreter ABI Platform
fenci-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 3.8 MB

Release files / fenci-0.4.1.tar.gz

Download URL fenci-0.4.1.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
9c5f97ca2bf8d31068b65233b2ad9a80a0417289f6a1073d4a432fd20d460c39
BLAKE2b-256 checksum
How to use checksums
ab8981308fcb7261e46e324b565268ce796fc9ccf2534fc253674adbb2026cc8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release files / fenci-0.4.1-py3-none-any.whl

Download URL fenci-0.4.1-py3-none-any.whl
Size 1.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
3f8ef398e5722715845438ffe08343a811b0f4972e561d1b08679c379e9c0341
BLAKE2b-256 checksum
How to use checksums
6866ac0ffae11927c502ddf0841e4472c252f99efbb9e20d1266a11963c7dd7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.0

3 release files

0.2.2

3 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page