rise-cped

rise-cped 是一个基于 CPED 数据 的本地可视化与数据更新工具。
它将 Electron 桌面壳、Next.js 前端和本地数据处理流程打包在一起，支持：

• 官员履历与级别演化可视化
• 地理流动与地区分布图
• 关系网络分析（单人网络 / patronage）
• 借助本地 Claude Code 进行数据采集与增量更新
• 采集合并版本管理（提交、对比、回滚）

数据来源

• 基础数据来源：CPED（China Political Elite Database）
• 数据入口页面：https://www.junyanjiang.com/data.html
• 本项目在 CPED 结构基础上增加了本地采集与合并能力，用于研究流程中的增量更新

功能概览

1. 数据可视化（/）

• 多条件筛选（姓名、籍贯、省份、级别）
• 官员详情卡片与履历表
• 级别分布、性别占比、全国分布图
• 晋升时间线、地理流动地图
• 当前筛选结果导出 CSV

2. 关系网络（/network、/patronage）

• 单人网络视图
• Patronage 关系视图

3. 数据采集与更新（/collect）

• 三类工作流：更新已有人物、采集新人物、按范围采集（人/市/省）
• 自动重试、覆盖率评估、失败目标重试
• 支持将采集结果合并回 cped_data.json
• 支持版本历史和回滚

本地 Claude Code 更新数据

本项目支持调用本机 Claude Code Runtime 进行采集。典型流程如下：

1. 在本机安装并可执行 claude（或配置可发现的 Claude Code 可执行文件）
2. 配置认证

• 可使用 ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY
• 或在应用内配置 Provider API Key

3. 启动应用并进入 /collect
4. 在 Runtime Probe 中检查 Claude Runtime 连通性
5. 提交采集任务并在完成后执行 ingest commit 写回数据

安装与启动

# 直接通过 npx 启动
npx rise-cped

# 或显式调用 bin
npx -y -p rise-cped rise-cped

CLI 常用参数：

rise-cped --check
rise-cped --port 3000 --host 127.0.0.1
rise-cped --skip-native-check

开发脚本

# Web 开发
npm run dev
npm run dev:web

# Electron 开发
npm run electron:build:main
npm run electron:dev

# 构建与打包
npm run build
npm run electron:build
npm run electron:pack
npm run electron:dist

# npm / 运行时检查
npm run prepare:npm-runtime
npm run cli:check
npm run smoke

关键 API（采集与版本）

• POST /api/ingest/commit
  • 将采集结果合并进本地数据并生成版本
• GET /api/ingest/versions
  • 查看版本历史、diff 与冲突摘要
• POST /api/ingest/revert
  • 回滚到指定版本（或最近版本）

技术栈

• Electron
• Next.js App Router
• React + TypeScript
• better-sqlite3
• ECharts

说明

• 本项目主要面向研究用途与本地分析流程。
• 使用 CPED 及其他外部来源数据时，请遵循原始数据提供方的使用条款与引用规范。