OpenPoem

简体中文 · 繁體中文 · English

默认语言：简体中文。无语言后缀的文档是默认入口。

OpenPoem 是一个开放、可校验、可追溯的中国古典诗词数据社区。

项目使用 ResonA Open Poem Package（ROPP）描述单首诗词的：

• 声：现代普通话、真人演绎、历史音候选与环境声元数据。
• 字：底本、简繁展示、异文与字形说明。
• 境：作者处境、心境解释和现代艺术化意境。
• 解：注释、直译、文学译文、意象与文化概念。
• 校：证据、争议和待补充问题。

OpenPoem 的目标不是宣告唯一正确版本，而是让每项内容都能看到来源、贡献者、版本、许可和已知争议。

重要边界

• Pull Request 合并表示数据包进入开放候选数据集。
• 合并不等于响古平台发布、推荐、专家审核或学术认定。
• 本仓库不保存响古用户评分、声望、编辑结论和平台发布状态。
• 音频、图片、扫描件和字体必须提供独立授权；古代正文属于公版不代表现代整理或数字资产也可自由使用。

仓库结构

openpoem/
  schema/
    v0.1/
      poem-package.schema.json
    v0.2/
      poem-package.schema.json
  templates/
    theme-prompt-package-v1/
      dingfengbo.json
  poems/
    tang/
      dufu/
        denggao/
          poem.json
  docs/
    spec.md
  tools/
    validate.mjs
  .github/

快速开始

要求：Node.js 20 或更高版本。

npm run validate

校验指定数据包：

node tools/validate.mjs poems/tang/dufu/denggao/poem.json

新增诗词：

1. 阅读 贡献指南。
2. 复制一个现有诗词目录。
3. 修改稳定 ID、底本、简繁正文、来源、许可和贡献者。
4. 本地运行校验。
5. 提交 Pull Request。

当前规范

• 当前 ROPP Schema：0.2.0，校验器继续兼容 0.1.0
• Theme Prompt Package：1.0.0
• 首批 30 首及补充的《大风歌》《满江红》共 32 个诗词包均已升级到 ROPP 0.2.0，每首内嵌诗句级提示词包、三种画面规格和环境声分层提示
• 每条图片/环境声 Prompt 均声明语义段、诗句、至少两个内容锚点与 grounding 说明；校验器拒绝只替换题名的通用套话
• 规范：简体中文 · 繁體中文 · English
• Schema：schema/v0.2/poem-package.schema.json
• 提示词样板：templates/theme-prompt-package-v1/dingfengbo.json

0.x 为试行阶段。破坏性修改会提供迁移说明，不静默改变既有字段含义。

ROPP 0.2.0 允许使用 AI 离线生成背景图和现代艺术化环境声候选。生成结果必须保留提示词、模型、哈希和内容凭据，经过权利、安全及人工审核后才能由平台发布；运行时生成和自动发布仍被禁止。

许可

• 校验工具和自动化代码：MIT。
• Schema、规范和社区结构化整理成果：CC BY 4.0，除非文件或数据包另有声明。
• 古代作品、现代整理、翻译、录音、图片、扫描件和字体分别遵循各自 rights 声明。

详见 LICENSE。

社区

• 新诗提交：Pull Request。
• 纠错与资料补充：Issue 或 Pull Request。
• 贡献指南：简体中文 · 繁體中文 · English。
• 安全政策：简体中文 · 繁體中文 · English。
• 行为规范：简体中文 · 繁體中文 · English。