euparliamentmonitor：AI Agent 工具实践指南

如果把euparliamentmonitor放进候选清单，不能只看热度；它的定位是欧洲议会公共事务情报平台 - 彻底的透明度 - 民主问责 - AI- 以 14 种语言生成新闻。团队若要把它用于日常自动化，应先处理输入边界、依赖和失败处理如果不清楚就很难稳定复用，否则试用结果很容易失真。我的评估方法是用一项范围明确的真实任务完成最小试跑，然后检查配置时间、输出质量、异常信息和维护痕迹是否与文档一致。编辑判断上，愿意先做小范围验证并复查原始文档的团队可以优先研究它；其他团队不必为了热门标签勉强接入。

EU 议会 Monitor

European 议会公共事务情报 Platform

公共事务情报 · 彻底的透明度 · 民主问责 · AI- 在 14 languages 生成新闻

探索实时平台 — euparliamentmonitor.com · 公共事务情报中心 （方法论 + 工件透明度，所有 14 种语言） · 分析与报告 · 站点地图（每页，每种语言） · API 参考

为什么存在

欧洲议会通过的法律影响 27 个成员国的 4.5 亿公民。然而，布鲁塞尔和斯特拉斯堡发生的大部分事情——委员会档案、报告员任命、联盟权衡、修正案之争、紧急文件、三方动态——实际上仍然不为公众所知。新闻报道稀疏，各个国家媒体分散，而且很少将程序点联系起来。

EU 议会监视器将 EP 自己的开放数据转化为可审计的公共事务情报，并每天以 14 种语言将其作为可读新闻发布，来源完全。

该存储库是 euparliamentmonitor.com 背后的开源平台：一个 AI- 驱动的新闻编辑室，用于坚控全体会议、委员会工作、动议、提案和前瞻性事件；每次运行生成经济学家风格分析文章，由 51 个结构化分析工件支持；并公开公开每方法、模板和分析树，以便任何读者、记者、研究人员或 NGO 都可以验证散文背后的分析。

文件和报告

探索直播平台

已发布的网站是此 npm/TypeScript 包的面向受众的配套网站。 两个中心页面提供最快的入口点 - 将它们添加为书签：

文档中心

快速链接：

• 直播站 - 公共新闻平台（14 种语言，每日 AI- 生成文章）
• 公共事务情报中心 - 方法论 + 工件透明层
• 站点地图 - 所有页面涵盖所有 14 种语言
• 架构文档 - 带有 C4 图的完整安全架构
• 安全流程 - 具有安全控制的流程
• 数据模型 - 数据结构和 API 集成
• 发布流程 - 如何创建发布
• API 文档 - TypeDoc-generated API 参考
• 测试覆盖率 - 交互式覆盖率报告

代理管道：

• 代理目录 — 自定义 Copilot 代理（分析生产者/消费者/gh-aw 基础设施）
• 技能库 — 共享技能（安全、合规性、情报、gh-aw）
• 提示库 — 10 个文件有界上下文提示集 (00→09) + npm run lint:prompts 漂移防护
• 工作流程 + WORKFLOWS.md — 15 个 news-*.md 代理工作流程（14 个统一的 news-<type>.md 涵盖 14 种文章类型 — 包括2026 年第二季度添加的长期 quarter-ahead/quarter-in-review/year-ahead/year-in-review/term-outlook/election-cycle 集 — 加上 news-translate.md) + CI 工作流程
• 分析链 — 5 阶段管道（数据→分析→完整性门→文章→单个 PR）、方法、39 个模板、质量阈值

ISMS 合规性：

• Hack23 ISMS 框架 - 信息安全管理系统
• 安全开发正策 - 开发标准
• 分类框架 - CIA 三元组分类

目前状态

MCP 服务器集成：该项目使用 欧洲议会-MCP-服务器 软件包版本 v1.4.0 用于通过模型上下文协议访问真实的 EU 议会数据； .github/workflows/copilot-setup-steps.yml 中的 Copilot 运行程序当前为本地 MCP 环境安装 v1.4.0。

• MCP 服务器状态： ✅ 全面运行 — 60 多个 EP 数据工具可用 （提要、直接查找、分析工具、情报关联）
• 代理工作流程：15 个统一的 gh-aw markdown 工作流程 - 14 种文章类型（news-<type>.md，一个会话中的阶段 A → B → C → D → E）+ news-translate.md（14 种语言齐平翻译） - 编译 gh-aw v0.82.3（.github/workflows/compile-agentic-workflows.yml中的引脚）到.lock.yml，用于通过AI-驱动的公共事务自动生成新闻 情报分析。请参见 .github/workflows/README.md。
• 工具链：构建管道以 Node.js 26 为目标，使用 TypeScript 6.0.2 作为默认编译器，并通过 npm run tsc:7 保留专用的 TypeScript 7.0.1-rc 兼容性构建。
• 分析工件驱动的文章管道：代理撰写完整的文章 B阶段分析-工件集（analysis/daily/<date>/<slug>/，39 每次运行的结构化模板；重复当天运行重用文件夹并 追加到 manifest.json.history[]) 并提交；确定性聚合器 （src/aggregator/**，通过调用 npm run generate-article -- --run <analysis-run-dir> 或 npm run generate-article:all 用于批量再生）然后行走 manifest.json， 清理每个工件，并发出最终的 Markdown 源 + HTML 共享站点 chrome（堆叠标题 + 嵌入式 14 种语言切换器 + TOC 侧边栏 + 页脚统计信息）和 14 种语言 <link rel="alternate" hreflang> 条目。没有AI-创作的HTML步骤；文章质量有保证 在对工件降价的 C 阶段完整性审查中进行编辑。 参见 analysis/README.md 和 analysis/methodologies/ai-driven-analysis-guide.md.
• 回退模式：当 EP API 时，新闻生成可以使用减少的数据 端点暂时不可用
• 环境变量：设置 USE_EP_MCP=false 以禁用 MCP 客户端 连接尝试

euparliamentmonitor是一个自动化新闻生成平台，用于坚控 欧洲议会活动并生成多语言新闻文章 覆盖：

• 未来一周：即将举行的议会活动和委员会的预览 会议
• 委员会报告：委员会活动和决定的分析
• 提案：正府和议会立法提案
• 动议：议会动议和决议
• 突发新闻：对重大事态发展的快速反应报道

特点

• 自动新闻生成：生成有关 EU 议会的新闻文章 活动
• 多语言支持：14 种语言，包括英语、瑞典语、德语、 法语、西班牙语、阿拉伯语、日语等
• 未来一周报道：预览即将举行的议会活动
• GitHub 操作集成：自动生成每日新闻
• SEO 优化：正确的元数据、结构化数据和站点地图生成
• ✅ 代码质量：ESLint、Prettier 和自动化质量门
• IMF-grade 经济背景：IMF- 主要引用是 每篇正策文章的编辑标准——参见 analysis/imf/README.md 和 analysis/methodologies/imf-indicator-mapping.md. 世界银彳仅保留非经济指标（健康、 教育、社会、环境、人口、国防、农业、 创新、治理）。

安全架构

EU 议会监视器通过全面的功能实现设计安全 安全控制和 ISMS 合规性。

安全文档

• 安全架构 - 完整的安全性 包含 C4 图、威胁模型和合规性映射的实施概述
• 未来安全架构 - 安全增强路线图（2026-2027）
• 数据模型 - 数据结构和欧洲议会 API 集成
• 安全流程图 - 详细的流程 安全控制

安全态势

项目分类（根据 ISMS 分类框架 和 开源正策)：

• 保密性：公开（1 级）- 欧洲议会公开数据
• 完整性：中（2 级）- 新闻准确性对民主至关重要 透明度
• 可用性：中（2 级）- 预计每日更新，24 小时 RTO 可接受
• RTO：24 小时 | RPO：1天（每日生成时间表）
• 业务影响：财务水平低、运营水平中等、声誉中等
• 战略价值：民主透明度、开放的公民技术领导力

关键安全控制：

• ✅ 最小攻击面：静态站点，无数据库，无服务器端 执行
• ✅ 自动化安全：CodeQL SAST、Dependabot SCA、npm 审计
• ✅ 供应链安全：SHA-固定GitHub操作，SBOM生成
• ✅ 输入验证：多层 XSS 预防、HTML 消毒
• ✅ 基础设施安全：GitHub-hosted 临时运行者，HTTPS 执行
• ✅ 合规性：ISO 27001、GDPR、NIS2、EU CRA 对齐

安全指标：

• 零已知漏洞（npm 审计清理）
• 安全测试代码覆盖率超过 82%
• 100% 依赖性扫描覆盖率
• 0 CodeQL critical/high 调查结果

ISMS 对齐

该项目如下 Hack23 ISMS 安全开发正策：

• ✅ 安全架构文档（带有 Mermaid 的 C4 模型）
• ✅ 威胁建模（STRIDE 分析）
• ✅ 安全测试（SAST、SCA、单元测试）
• ✅ 合规性映射（ISO 27001、GDPR、NIS2）

社区与治理

euparliamentmonitor是一个具有透明治理和社区标准的开源项目。

开源标准

• 贡献指南 - 开发工作流程、代码标准和贡献指南
• 行为准则 - 基于贡献者契约 2.1 的社区标准
• 安全策略 - 漏洞披露和安全实践
• 作者和贡献者 - 项目贡献者的认可
• 许可证 - Apache 许可证 2.0 全文

社区频道

• GitHub 问题：错误报告和功能请求
• GitHub 讨论：问题和社区讨论
• 安全性：[email protected] 用于漏洞报告
• 行为：[email protected] 有关行为准则问题

治理合规性

本项目遵循：

• ✅ OpenSSF 最佳实践：遵循 CII 最佳实践标准
• ✅ ISMS 合规性：与 Hack23 ISMS 正策保持一致
• ✅ 透明开发：公共存储库，公开讨论
• ✅ 安全第一：全面的安全披露正策

代码质量和测试

EU 议会监视器通过全面的内容保持高代码质量标准 测试：

公共事务情报管道

euparliamentmonitor.com 上发布的每篇文章都是 分析运行 的确定性呈现 - analysis/daily/<YYYY-MM-DD>/<article-type>/ 下的目录包含结构化 Markdown 工件（从 51 模板目录中提取：39 个核心强制 + 12 个扩展可选）加上原始 EP MCP / IMF / 世界银彳数据有效负载。该管道分为五个明确定义的阶段：

%%{init: {"theme":"dark","themeVariables":{"primaryColor":"#1565C0","primaryTextColor":"#fff","lineColor":"#90CAF9","fontFamily":"Inter, Helvetica, Arial, sans-serif"}}}%%
flowchart LR
    A[" Stage A
EP MCP data collection
<i>60+ tools, IMF, World Bank</i>"] --> B[" Stage B
AI political intelligence
<i>51 artifacts · 2-pass review</i>"]
    B --> C[" Stage C
Completeness gate
<i>line floors · WEP · Admiralty</i>"]
    C --> D[" Stage D
Deterministic aggregator
<i>npm run generate-article</i>"]
    D --> E[" Markdown source
news/*.en.md"]
    D --> F[" 14-language HTML
news/*-{lang}.html"]
    F --> G[" SEO indexes
sitemap · RSS · JSON-LD"]
    G --> H[" S3 + CloudFront
euparliamentmonitor.com"]
    style A fill:#1565C0,color:#fff
    style B fill:#7B1FA2,color:#fff
    style C fill:#FFC107,color:#000
    style D fill:#2E7D32,color:#fff
    style E fill:#0288D1,color:#fff
    style F fill:#2E7D32,color:#fff
    style G fill:#FF9800,color:#000
    style H fill:#2E7D32,color:#fff

关键架构属性： AI 代理作者Markdown 中的分析工件 — 绝不是 HTML。 src/aggregator/** 下的 TypeScript 代码确定地将提交的工件渲染到 HTML 中。没有 AI- 创作的 HTML 步骤，也没有模板散文泄漏。这就是公共输出可复制、可审计和抵抗幻觉的原因。

完整管道参考： 文章-Generation.md · analysis/README.md · analysis/methodologies/ai-driven-analysis-guide.md

方法库 — 已发布、版本控制、可审计

在 公共事务情报中心 上浏览所有 17 种方法、52 个模板、19 个情报技术参考以及 170 多次每日分析运行中生成的 1,700 多个工件。

实时新闻流

十四个统一的 gh-aw 文章工作流程加上14 种语言的翻译助手按照精确的时间表运行，自动生成经济学家风格的公共事务情报并打开可发布的拉取请求。每个工作流程都遵循 文章 Generation.md 中记录的相同 A → E 阶段合同。每个地平线的数据窗口、节奏、强制性工件、阶段预算、场景深度和选举叠加的唯一事实来源是 ARTICLE_HORIZONS 注册表，位于 src/config/article-horizons.ts 中。

每个统一工作流程在单个 60 分钟会话 (engine.mcp.session-timeout: 65m) 中运行阶段 A–E，并生成一个 PR，其中包含分析工件和渲染的 HTML。早期的拆分对 news-<type>-analysis.md + news-<type>-article.md 布局已在 2026 年 4 月聚合器迁移中停用。请参阅 .github/workflows/README.md 了解编译/锁定文件/安全输出机制，WORKFLOWS.md 了解完整的 CI/CD 目录，以及文章-Generation.md § 前瞻性视野和选举周期 适用于新的长期视野和选举管道。

提示库 (.github/prompts/) — 10 个有界上下文提示文件 (00-scope-and-ground-rules.md → 09-troubleshooting.md) 在每个工作流程相关组织享。 npm run lint:prompts 漂移防护在禁用模式（checkpoint pr、keep-alive、heartbeat、progressive safe output、push_repo_memory）上失败。

代理目录

EU 议会监视器使用分层代理模型：一小组产品域代理拥有新闻管道，而基础设施代理维护工作流程、贡献和 CI 卫生。

产品域代理（拥有新闻关键路径）

基础设施代理（维护工作流程和 CI 卫生）

agentic-workflows.agent.md、news-generation.agent.md、ci-cleaner.agent.md、contribution-checker.agent.md、create-safe-output-type.agent.md、custom-engine-implementation.agent.md、grumpy-reviewer.agent.md、interactive-agent-designer.agent.md、 technical-doc-writer.agent.md，w3c-specification-writer.agent.md。参见 .github/agents/README.md。

快速入门（npm 包）

npm install euparliamentmonitor

import {
  // EP MCP client (60+ open-data tools)
  EuropeanParliamentMCPClient,
  getEPMCPClient,
  // Article generation (deterministic aggregator pipeline)
  generateArticle,
  aggregateAnalysisRun,
  renderMarkdown,
  // Cross-article intelligence index
  buildIndexFromEntries,
  findRelatedArticles,
  generateCrossReferences,
  // Multi-language support (14 languages, RTL aware)
  ALL_LANGUAGES,
  LANGUAGE_NAMES,
} from 'euparliamentmonitor';

// Or import specific modules for tree-shaking
import { EuropeanParliamentMCPClient } from 'euparliamentmonitor/mcp/ep-mcp-client';
import type { ArticleCategory, LanguageCode } from 'euparliamentmonitor/types';

捆绑功能：

• EU 议会 MCP 客户端 — 60 多种工具，涵盖全体会议、委员会报告、投票记录、议会问题、通过的文本、程序、MEPs 和声明，内置回退到 EP 开放数据门户当 MCP 返回空投票有效负载时，/api/v2/decision 端点。
• 确定性文章聚合器 — 遍历 manifest.json，清理每个工件，渲染 Markdown 源 + 14 个 HTML 变体，带有完整的 SEO chrome、JSON-LD NewsArticle、hreflang 替代品，以及isBasedOn 出处列表。
• 公共事务情报分析 — 投票异常检测、联盟动态、MEP 影响力评分、OSINT 相关性（5 框架威胁模型）。
• 14 语言渲染器 — EN、SV、DA、NO、FI、DE、FR、 ES、NL、AR（RTL）、HE（RTL）、JA、KO、 ZH — 具有 WCAG 2.1 AA 可访问性和共享网站镶边。

出处： 使用 npm 出处 和 SLSA 3 级 构建证明发布。

数据源

主要 — 欧洲议会 MCP 服务器（Hack23/European-Parliament-MCP-Server v1.3.12+，完全运行）：

• 全体会议、投票记录、唱名投票
• 通过的文本、动议、决议、紧急文件
• 委员会会议、报告、意见、听证会
• MEPs（主动、传入、传出、谐音），经济利益申报
• ❓ 议会质询 (written/oral)
• 程序、全体文件、外部文件、受控词汇
• 分析工具：投票模式、联盟动态、MEP 影响力、网络分析、情绪跟踪器、预警系统、情报关联

次要——公共经济和社会背景：

• IMF（根据 IMF 指标映射 的主要经济来源） — 世界经济展望 (WEO)、财政监测、国际统计 (IFS)、余额支付（BOP）、回了和主要商品价格体系（PCPS）。
• 世界银彳开放数据（仅限非经济）——健康、教育、环境、人口、治理、创新。

边界：仅使用公开 EP/IMF/World 银彳数据。除公共议会角色外，不得进行个人 MEP 分析。 GDPR-clean 设计。

安全与 ISMS 合规性

EU 议会监视器在 Hack23 ISMS 框架下实现设计安全。

项目分类

合规框架

关键安全控制

• ✅ 最小的攻击面 — 静态站点，无数据库，无服务器端执行
• ✅ 同源 JS 捆绑 — js/vendor/ 下的所有可执行资产，严格 script-src 'self' CSP，无外部 CDN
• ✅ 自动化安全 — CodeQL SAST、Dependabot SCA、npm 审核、OpenSSF 记分卡
• ✅ 供应链 — SHA-固定 GitHub 操作、SBOM (SPDX)、SLSA 3 级证明
• ✅ 输入验证 — 多层 XSS 预防、HTML 清理、带有显式插件白名单的 markdown-it
• ✅ 基础设施 — GitHub-hosted 临时运行器、S3/CloudFront 通过 OIDC GithubWorkFlowRole、HTTPS 强制执行、step-security/harden-runner 出口块

完整的安全架构： SECURITY_ARCHITECTURE.md · SECURITY.md · THREAT_MODEL.md · CLASSIFICATION.md

本地发展

要求

• Node.js 26 或更高
• npm 10 或更高（随 Node.js 26 一起提供）
• 吉特

从源头

git clone https://github.com/Hack23/euparliamentmonitor.git
cd euparliamentmonitor
npm install

构建、lint、测试、渲染

npm run build              # TypeScript compilation
npm run lint               # ESLint (TypeScript in src/)
npm run lint:prompts       # gh-aw prompt drift-guard
npm run htmlhint           # HTML validation
npm run test               # Vitest unit + integration (169+ tests)
npm run test:coverage      # Coverage report (≥80% line, ≥75% branch)
npm run test:e2e           # Playwright cross-browser E2E
npm run validate-analysis  # Stage-C completeness gate
npm run generate-article -- --run analysis/daily/2026-04-24/breaking
npm run generate-article:all                # batch regen every committed run
npm run generate-news-indexes               # 14-language news index pages
npm run generate-sitemap                    # sitemap.xml + 14 sitemap_<lang>.html
npm run docs:generate                       # TypeDoc API docs + index
npm run serve                               # local static-site preview at :8080

可选：实时 MCP 集成

默认情况下，工作流以 USE_EP_MCP=true 运行。要使用 欧洲议会 MCP 服务器 进行本地实验：

git clone https://github.com/Hack23/European-Parliament-MCP-Server.git
cd European-Parliament-MCP-Server && npm install && npm run build
export EP_MCP_SERVER_PATH="$(pwd)/dist/index.js"
# or use the gateway helper:
source scripts/mcp-setup.sh

设置 USE_EP_MCP=false 以禁用 MCP 并回退到 placeholder/test 数据。

文档中心

未来：AI 演进路线图（2026-2037）

“我们不仅仅是跟上 AI 的步伐——我们正在为机器比大多数 MEPs 更好地理解议会程序的时代构建编辑基础设施。”

从当前代理新闻生成到 AGI-enhanced 变革性民主的六阶段路线图，在各个层面上都保持人工监督。

timeline
    title EU Parliament Monitor — AI Evolution Roadmap
    section Phase 1 (2026)
        Agentic News : 14 unified workflows
                     : 14-language generation
                     : Deterministic aggregator
                     : 51-artifact analysis catalog
    section Phase 2 (2027)
        Predictive Analytics : Voting outcome prediction
                             : Legislative impact forecasting
                             : Cross-party coalition detection
    section Phase 3 (2028–2029)
        Multi-Modal Intelligence : Video plenary analysis
                                 : Real-time debate tracking
                                 : Infographic auto-generation
    section Phase 4 (2030–2031)
        Near-Expert Analysis : 50+ parliament coverage
                             : Expert-level policy briefs
                             : Predictive governance models
    section Phase 5 (2032–2033)
        Global Coverage : 100+ parliaments
                        : Pre-AGI capabilities
                        : Cross-jurisdiction analysis
    section Phase 6 (2034–2037)
        AGI Era : Transformative democracy
               : 195 national legislatures
               : Human oversight maintained

FUTURE_MINDMAP.md — 能力演进与系统愿景 · FUTURE_WORKFLOWS.md — CI/CD 演进与自动化路线图