perseidsproject/morpheus-api

Morpheus API镜像说明

镜像概述

Morpheus API镜像为https://github.com/perseids-tools/morpheus%E5%BD%A2%E6%80%81%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E6%8F%90%E4%BE%9BAPI%E6%8E%A5%E5%8F%A3%EF%BC%8C%E6%94%AF%E6%8C%81%E5%AF%B9%E5%8F%A4%E5%B8%8C%E8%85%8A%EF%BC%88Beta Code编码）和拉丁语文本进行词形还原与形态分析，便于集成到各类古典语言相关应用中。

核心功能

1. 接收古希腊或拉丁语文本输入（希腊语需Beta Code编码）
2. 执行词形还原，获取单词原型（lemma）
3. 返回形态分析结果，包含词性、格、数、时态等语法属性
4. 支持多种输出选项（如忽略重音、显示词干、切换输出格式等）

使用场景

• 古典语言教学平台：辅助学生理解单词形态变化
• 学术研究：支持古希腊/拉丁语语料库的自动化分析
• 应用集成：嵌入到词典、翻译工具或文献数字化系统中

配置说明

Docker Compose部署

独立运行服务器

bash
docker-compose build
docker-compose up

集成到其他Compose文件

在docker-compose.yml中添加服务：

yaml
version: '3'
services:
  morph:
    image: perseidsproject/morpheus-api:v1.0.10
    ports:
      - "1315:1315"

自定义端口

通过环境变量PORT修改运行端口：

yaml
version: '3'
services:
  morph:
    image: perseidsproject/morpheus-api:v1.0.10
    environment:
      - PORT=3000
    ports:
      - "3000:3000"

Unix/Linux环境运行

依赖

• Ruby（~2.5版本）
• Bundler工具

执行命令

bash
bundle install
MORPHLIB=/path/to/stemlib EXECUTABLE=/path/to/cruncher bundle exec ruby app.rb

使用示例

古希腊语分析（Beta Code编码）

请求：http://localhost:1315/greek/a)%2Fnqrwpos
响应：

a)/nqrwpos
<NL>N a)/nqrwpos  masc nom sg			os_ou</NL>

拉丁语分析

请求：http://localhost:1315/latin/cactus
响应：

cactus
<NL>N cactus  masc nom sg			us_i</NL>

带选项的分析（忽略重音）

请求：http://localhost:1315/greek/a)%2Fnqrwpou?opts=n
响应：

a)/nqrwpou
<NL>N a)nqrw/pou,a)/nqrwpos  masc gen sg			os_ou</NL><NL>V a_)nqrwpou=,a)nqrwpo/omai  imperf ind mp 2nd sg	doric aeolic	contr	ow_pr,ow_denom</NL><NL>V a)nqrwpou=,a)nqrwpo/omai  pres imperat mp 2nd sg		contr	ow_pr,ow_denom</NL><NL>V a)nqrwpou=,a)nqrwpo/omai  imperf ind mp 2nd sg	homeric ionic	contr unaugmented	ow_pr,ow_denom</NL><NL>N a)nqrwpou=,a)nqrwpw/  fem nom/voc/acc dual		contr	w_oos</NL>

路由与选项说明

路由

• /greek/:word：分析古希腊语单词（需Beta Code编码）
• /latin/:word：分析拉丁语单词

输出选项

通过?opts=:options参数传递组合选项：