Synonyms

环境要求

• Python 环境及 pip（用于安装 synonyms 包）
• 从 Chatopera 证书商店购买的 License ID（v3.x 机器学习模型包必需）
• 可选：word2vec 训练的词向量文件（二进制格式）
• 可选：jieba 中文分词主字典文件

安装与启动步骤

1. 1安装 synonyms 包

   使用 pip 安装并升级到最新稳定版，当前稳定版本为 v3.x。建议在独立虚拟环境中安装。

   pip install -U synonyms

   复制

2. 2配置许可证 ID

   v3.x 的机器学习模型包需要 License。先到 Chatopera 证书商店购买，拿到 license id 后设置为环境变量。

   export SYNONYMS_DL_LICENSE=FOOBAR

   复制

3. 3指定词向量文件

   可选。默认使用内置模型，如需改用自己 word2vec 训练的词向量，用该变量指向二进制模型文件。

   export SYNONYMS_WORD2VEC_BIN_MODEL_ZH_CN_=/your/path/word2vec.bin

   复制

4. 4指定分词主字典

   可选。用该变量替换 jieba 中文分词主字典，扩展或定制分词词表，格式参考 jieba 词典说明。

   export SYNONYMS_WORDSEG_DICT_=/your/path/dict.txt

   复制

5. 5开启调试日志

   可选。设置为 TRUE 时输出调试日志，排查模型加载与查询问题；默认 FALSE。

   export SYNONYMS_DEBUG_=TRUE

   复制

6. 6导入验证

   在 Python 中导入 synonyms，不报错说明包已安装成功；首次使用模型时会按 License 下载模型包。

   python -c "import synonyms"

   复制

关键配置

如何确认成功

在 Python 中执行 import synonyms 不报错即安装成功；已配置许可证和模型文件后即可正常调用近义词查询接口。

常见问题

注意事项

• 本项目是 Python 库，没有独立服务进程和端口，按库方式集成进现有 NLP 流程即可。
• 环境变量通过 export 设置，仅对当前终端会话生效，重启终端需重新设置。
• README 未给出具体 API 调用示例，使用时请以官方文档和 README 的 Usage 章节为准。
• 许可证为春松许可证 v1.0，商用前请确认授权范围。