Red Wisdom Cards (红色智慧卡片)

Don't worry, be fighting. 遇事不决读毛选，把问题带回事实、调查、矛盾分析、行动和复盘。

Red Wisdom 是一个以《毛泽东选集》为核心内容和方法论来源的学习与实践工具网站。

• 不登录时：开放、普惠的毛选阅读与智慧卡片网站。
• 登录后目标形态：持续用毛选方法训练用户分析现实问题、制定行动、完成复盘的个人实践系统。

当前版本已经围绕“问题案例”打通抽卡、阅读、问道、行动和复盘。首页保持简洁抽卡体验；用户可以把长期现实困难记录到「我的问题」，在同一条时间线中积累事实、问答、笔记、行动和结果。核心页面支持移动端导航与 PWA 安装。账户系统使用 Supabase Google 登录；配置完成后会在首次登录时合并本机档案，并持续同步，未配置时自动保持本机私密模式。

🌐 在线访问: redwisdom.xyz

核心功能

1. 智慧卡片

• 抽卡、翻牌、再抽一次的仪式感交互。
• 卡片正面保持简洁，只展示语录和出处，不在卡面加入滚动区域。
• 抽卡结果可在卡片外直接进入完整出处，或把语录作为上下文带到问道页。
• 首页不放训练面板，让抽卡成为第一屏唯一主体验。

2. 问道毛选

• AI 定位为「经过毛选方法论蒸馏的实践教练」。
• 提供「直接解惑」和「逐步分析」两种模式；后者一次只追问一个环节，再综合已有问题材料。
• 回答围绕事实、调查、矛盾分析、行动和复盘展开。
• 输出结构包含：问题复述、问题类型、毛选方法、分析步骤、行动建议、今日实践、复盘问题。
• 发送问题时会检索带段落锚点的原文、精选语录、文章导读和历史案例，要求 AI 标明文章及定位。
• 历史类比必须同时说明相似点、差异和适用边界，不能把历史结果当作现实预测。
• 问答会保存为本机私密历史，并在我的档案页展示最近记录。
• AI 回答可以收藏到本机学习档案，也可以继续保存为实践任务。
• 系统提示词、毛选原文检索和党史案例检索都在服务端完成；浏览器只提交对话内容，不能改写教练提示词，也不再下载 4MB 的全文索引。
• API 代理固定模型和输出 token，限制消息数量与长度，只接受本站页面的请求，按访问者 IP 限流，用户中止回答时同步中止模型请求。

3. 阅读毛选

• 毛泽东选集全 5 卷文章在线阅读。
• 当前收录 229 篇文章和 2656 个可检索正文块，支持全文搜索并直达段落锚点。
• 支持按卷目录浏览。
• 阅读页提供按问题学习的主题路径，并把《实践论》《矛盾论》《论持久战》《反对本本主义》《为人民服务》等热门文章重点推荐。
• 党史时间线页提供 1921 年至今的大事汇总、路线之争决策点、党代会速查，事件可直达对应毛选原文。
• 「毛选思维 · 现代问题」栏目：把毛选思维用在职场打压、精神内耗、迷茫拖延等现代常见困惑上，每个案例附原文引文、思维拆解、行动清单与适用边界。
• 核心文章提供导读：解决的问题、背景、核心观点、应用场景、阅读问题和推荐实践。
• 原文注释（⑴、〔7〕等）点击即在原处弹出，不用翻到文末。
• 概念层：正文中的「实事求是」「主要矛盾」「运动战」等概念可直接点开，查看编辑概括、原文出处、常见篇目和相关党史案例；阅读首页提供概念索引，reading.html?concept=概念 可直达。问道时提到这些概念，AI 会拿到对应释义和原文出处。概念源数据在 data/concepts.source.json，修改后运行 npm run build:concepts。
• 阅读正文支持字号调节，并把字号偏好保存在本机浏览器。
• 每篇文章支持保存一条本机阅读笔记，并在我的档案页展示最近笔记。
• 支持本机阅读进度、文章收藏和原文摘录。
• 当前正文为项目整理的在线文本，并非出版社官方电子版；严肃引用应以人民出版社纸质版本复核。

党史沙盘地图

• timeline.html 默认打开「沙盘地图」：在全国立体地图上，用一条可拖动的时间轴浏览 1919 年五四运动到 1949 年新中国成立的 53 件大事（之后的大事在「时间线」列表中）。时间轴按事件排列，标出建党与大革命、土地革命、全民族抗战、解放战争四个阶段和重大节点。
• 手机上地图只显示当前事件的标签，时间轴吸附在底部导航上方，事件简介以底部抽屉弹出。
• 拖动或播放时，地图在事件发生地立起标注，当前事件高亮，镜头可跟随；已发生的事件留下小红点。点击地图标注、时间轴刻度或左上角的当前事件，可看简介、启示、相关毛选篇目，长征战役可直达沙盘推演。
• 事件地点写在 js/timeline-data.js 的 place（可多个）和 PLACES 坐标表中；全国性或图外的事件用 placeNote 说明，只出现在时间轴上。major: true 标记重大节点。
• 渲染复用长征沙盘的地图引擎；tests/timeline-map.test.js 校验日期解析、事件排序、每条事件都有地点或说明、坐标都在地图范围内。

4. 长征沙盘

• 首页有「党史时间线」和「长征沙盘推演」两个单独入口。
• campaign.html 默认打开「长征全图」：在整幅中国地形图上推演中央红军从瑞金到陕北的全程（附南海诸岛附图），图上的战役标记和简报中的按钮可直接进入各战役沙盘。
• 战役沙盘按时间顺序收录湘江战役、四渡赤水、巧渡金沙江、强渡大渡河 · 飞夺泸定桥、激战腊子口、直罗镇战役 6 场，右下角小地图标出战役在长征全图中的位置。
• 沙盘使用原生 WebGL2 渲染（无第三方 3D 库），地形是真实高程，叠加国界、省界、海岸线和河流，采用 Albers 等积圆锥投影，边缘渐隐到底色；可拖动旋转、缩放、切换全景/俯视/低空/跟随红军视角，并调节垂直夸张。
• 时间轴逐日推进：红军路线、各路国民党军（按派系分色）的动向与轨迹、渡口、战斗和关键注记同步变化。
• 右侧简报按章节列出各方的命令、判断与决策，并提供各方档案和《毛选》原文对照（直达阅读页段落锚点）。
• 决策点互动：推演到关键时刻自动暂停，先让用户自己选择，再揭晓历史上的选择、各选项的利弊和对应的毛选原文；作答记录保存在本机，并在复盘区汇总。历史选择不当作标准答案（例如湘江战役是反面教训）。
• 页面底部用毛选方法复盘：主要矛盾、关键判断、可迁移方法和适用边界，可带着原文上下文跳转问道。
• 时间线中的相关事件和「路线之争」决策点带有「沙盘推演」入口。
• 战役数据集中在 js/campaign-data.js，新增战役只需按同一格式补充地理、部队关键帧、章节和复盘；tests/campaign-data.test.js 会校验坐标范围、时间顺序、派系引用和毛选引文锚点。
• 战役内容目前为「史实初核 · 待编辑终审」状态，审核口径参照 docs/content/history-case-editorial-policy.md。
• 地图数据由 scripts/build-map-data.py 预先生成并提交到仓库：data/terrain/*.bin（Int16 高程栅格）和 data/map/*.json（矢量图层）。来源与许可：
  • 高程：GEBCO Compilation Group (2024) GEBCO 2024 Grid（doi:10.5285/1c44ce99-0a0d-5f4f-e063-7086abc0ea0f），公共领域使用需注明来源；中国区域裁剪取自 ggmapcn-data。
  • 国界、南海断续线、省界、海岸线、河流：Natural Earth 1:10m（公共领域），国界采用其中国视角（CHN worldview）版本。
  • 地表颜色：张新时等（2007）《中华人民共和国植被图（1:1000000）》1 公里栅格（经 ggmapcn-data 发布），按 11 个植被型组配色，湖泊等水面单独着色。
  • 战役沙盘的地形插值到约 1 公里，并叠加按局部起伏缩放的分形细节和由高程推算的汇流沟谷，用于立体观感，不代表 1 公里尺度的实测地貌。
  • 行政区划为今日区划，仅作方位参考。本图为教学示意图；如需在中国境内公开发布，请按《地图管理条例》使用自然资源部标准地图或送审取得审图号。
• 修改战役范围后重新生成地图数据：先按脚本说明导出 campaigns.json，再运行 python3 scripts/build-map-data.py --dem gebco_2024_China.tif --vege vege_1km_projected.tif --ne natural-earth-vector/geojson --campaigns campaigns.json --out .。

5. 问题、实践与档案

• 「我的问题」统一保存现实问题、事实与判断、主要矛盾、待调查事项、可用力量和下一步行动。
• 调查清单：把待调查事项做成清单，每条写明要核实的判断、找谁问/看什么、怎么问，记录查到的事实并标为证实、部分证实或推翻；核实结果自动写入问题时间线。
• 矛盾分析画布：列出问题中的各对矛盾，拖动或用箭头排序，第一位即主要矛盾，并填写矛盾的主要方面；可“记录这一版判断”，主要矛盾发生转移时自动标出并写入时间线。
• 实践—认识螺旋：按每次复盘把过程切分成若干轮，自动整理每轮的“认识 → 实践 → 检验 → 再认识”，用螺旋图显示认识的变化，无需额外填写。
• 新增字段已加入云同步；已有 Supabase 数据库需执行 docs/database/migrations/2026-10-04-practice-loop.sql，未执行前这两项只保存在本机，其他字段照常同步。
• 问答、阅读笔记和实践可以关联同一个问题，并在问题时间线中按类型筛选。
• 复盘记录预期、实际、证据、认识修正和下一步，也可以把问题标记为已解决。
• 阅读导读和 AI 回答都可以保存为实践任务。
• 我的档案页训练面板会根据本机档案推荐下一步：先复盘已完成实践，再继续今日实践、阅读或问道；进入实践页后会定位到对应记录。
• 实践页支持手动记录现实问题、主要矛盾、缺少的调查、可用力量、今日行动、复盘标准、实际结果、复盘总结和下一步行动。
• 实践页会展示已保存的主要矛盾、缺少的调查、可用力量和复盘标准，避免从分析向导或 AI 生成实践后丢失方法论上下文。
• 实践页会为每条记录生成复盘提示，引导用户对照预期、核对事实、检查矛盾并确定下一步。
• 我的档案页展示实践数量、复盘状态和常用方法论标签，并把完整本机档案转成下一步训练建议。
• 抽卡、阅读、问道、实践、我的核心页面在移动端提供固定底部导航。
• 当前数据保存在本机浏览器 localStorage 中。
• 登录页接入 Google OAuth；配置 Supabase 并执行数据库 schema 后，首次登录会自动迁移本机档案，之后持续双向合并同步。
• 我的档案页支持导出本机实践、问答历史、AI 回答收藏、阅读笔记、阅读进度、文章收藏、原文摘录和语录收藏，便于迁移和备份。

英文版（English edition）

首页、阅读毛选、问道毛选三个页面右上角有「中 / EN」切换，选择会记在本机；链接上加 ?lang=en 或 ?lang=zh 也可以直接指定。英文模式下导航只保留这三项。

• 原文：外文出版社（Foreign Languages Press, Peking）英译本 Selected Works of Mao Tse-tung 第一至五卷，共 228 篇，取自 Marxists Internet Archive。《反对本本主义》1961 年才重新找到，不在英译本第一卷中；英文版把 marxists.org 第六卷里的译文作为补遗放在第一卷相同位置，共 229 篇，与中文版一一对应。
• 卡片：取自 Quotations from Chairman Mao Tse-tung 的英译语录，筛掉军事和敌我斗争类，只留 260 个字母以内、能在卡片上从容排开的 61 张；大部分可以直接跳到英译本中的原段落。
• 阅读：中英文章一一对照，切换语言时停留在同一篇；支持全文搜索和注释弹窗。专题导读和概念层暂只有中文。
• 问道：服务端在英译本中检索相关段落（把「优先级」「拖延」等现代说法映射到主要矛盾、持久战等方法），回答只引用检索到的英译原文。党史镜鉴暂只有中文。

重新生成英文数据（需要能访问 marxists.org）：

python3 scripts/build-english-edition.py --cache /tmp/mia-cache --out .
node scripts/build-search-index.mjs --edition en

技术栈

类型	技术
前端	HTML5 + Tailwind CSS + Vanilla JS
AI 对话	DeepSeek API V4 Pro（OpenRouter 作为回退）
API 代理	Cloudflare Worker（worker/index.mjs）；迁移完成前 Vercel Serverless Function 并行
账户系统	Supabase Auth (Google OAuth，配置后启用)
数据库	Supabase Postgres + Row Level Security
部署平台	Cloudflare Workers（静态资源 + Worker），迁移步骤见 docs/deploy/cloudflare.md
数据格式	JSON + Markdown
离线能力	Web App Manifest + Service Worker
测试	Node.js built-in test runner

本地运行

git clone https://github.com/kirinzhang/redwisdom.git
cd redwisdom

npm run dev
# 访问 http://127.0.0.1:4173

本地开发服务器会读取仓库根目录的 .env，并提供与线上一致的 /api/chat 路由。也可以用 npm install && npm run cf:dev 以 Cloudflare Workers 方式本地运行（机密写在 .dev.vars）。本地不会注册 PWA Service Worker，避免开发服务器停止后仍显示缓存页面。

AI 对话优先直连 DeepSeek V4 Pro：

DEEPSEEK_API_KEY=你的 DeepSeek API Key

未配置 DeepSeek Key 时，可以使用 OPENROUTER_API_KEY 回退到 OpenRouter 上的 deepseek/deepseek-v4-pro。部署到 Cloudflare 时，在 Worker 的「变量和机密」中配置密钥（Vercel 同理）；本机 .env 不会上传。

问道接口的限流与来源限制（均为可选环境变量）：

CHAT_LIMIT_PER_MINUTE=6          # 每个 IP 每分钟提问次数，默认 6
CHAT_LIMIT_PER_DAY=60            # 每个 IP 每天提问次数，默认 60
CHAT_GLOBAL_LIMIT_PER_DAY=0      # 全站每日总量上限，0 表示不限
UPSTASH_REDIS_REST_URL=...       # 配置后跨函数实例共享计数（推荐生产环境使用）
UPSTASH_REDIS_REST_TOKEN=...
CHAT_ALLOWED_ORIGINS=https://redwisdom.xyz   # 额外允许的来源，本站域名默认允许

未配置 Upstash 时，计数只保存在单个函数实例的内存里，只能挡住连续刷接口；正式环境建议接入 Upstash Redis（Cloudflare 与 Vercel 均可，通过 REST 访问）。

页面样式使用预先生成的 assets/tailwind.css。修改页面里的 Tailwind 类名后运行：

npm run build:css

账户系统需要在 config.js 中填写 Supabase 项目配置：

SUPABASE_URL: 'https://your-project.supabase.co',
SUPABASE_ANON_KEY: 'your-anon-key'

生产环境（Cloudflare Worker 或 Vercel）推荐直接配置以下公开环境变量，前端会通过 /api/public-config 在运行时读取，无需把值写入仓库：

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-publishable-key
SUPABASE_GOOGLE_AUTH_ENABLED=false

只允许公开的 Supabase URL、Publishable Key 和 Provider 状态通过该接口返回；DeepSeek、OpenRouter 等服务端密钥不会暴露。Google Provider 配置完成后，把 SUPABASE_GOOGLE_AUTH_ENABLED 改为 true，并重新部署。

还需要在 Supabase Authentication 中启用 Google Provider。Google Cloud OAuth 客户端的 Authorized redirect URI 是 Supabase Auth 回调：

https://你的项目引用.supabase.co/auth/v1/callback

同时在 Supabase URL Configuration 的 Redirect URLs 中加入网站登录页：

https://你的域名/login.html
https://redwisdom.xyz/login.html
http://127.0.0.1:4173/login.html

数据库表和 RLS 策略见 docs/database/supabase-schema.sql。

测试

node --test tests/*.test.js tests/*.test.mjs
node --check script.js
node --check js/analysis-guide.js
node --check js/auth-utils.js
node --check js/cloud-sync.js
node --check js/conversation-store.js
node --check js/quote-utils.js
node --check js/ai-methodology.js
node --check js/reading-notes-store.js
node --check js/reading-progress-store.js
node --check js/reading-guides.js
node --check js/saved-quotes-store.js
node --check js/saved-answers-store.js
node --check js/practice-store.js
node --check js/practice-review-prompts.js
node --check js/campaign-engine.js
node --check js/campaign.js
node --check api/openrouter-guard.mjs
node --check api/chat.js

项目结构

redwisdom/
├── index.html                  # 首页 - 智慧卡片
├── chat.html                   # 问道毛选 - AI 实践教练
├── reading.html                # 毛选阅读页
├── timeline.html               # 党史时间线与大事汇总
├── campaign.html               # 长征沙盘：战役立体推演
├── modern.html                 # 毛选思维 · 现代问题栏目
├── problems.html               # 现实问题工作台与时间线
├── practice.html               # 实践任务与复盘
├── me.html                     # 个人学习档案预览
├── login.html                  # 登录与账户状态
├── config.js                   # 前端 API 配置
├── script.js                   # 卡片交互逻辑
├── style.css                   # 首页卡片样式
├── js/
│   ├── ai-methodology.js       # AI 方法论 prompt 和 payload
│   ├── analysis-guide.js       # 毛选方法分析向导
│   ├── ai-context.js           # 本地毛选语录/导读上下文检索
│   ├── auth-utils.js           # Supabase 登录状态工具
│   ├── cloud-sync.js           # 学习档案云同步、拉取和合并
│   ├── auto-sync.js            # 首次迁移与持续同步调度
│   ├── conversation-store.js   # 本机私密问答历史
│   ├── problem-case-store.js   # 问题案例与复盘时间线
│   ├── guided-coach.js         # 逐步分析状态机
│   ├── full-text-search.js     # 原文全文检索
│   ├── history-case-retrieval.js # 历史案例检索与边界提示
│   ├── practice-store.js       # 本机私密实践存储
│   ├── practice-review-prompts.js # 实践复盘提示生成器
│   ├── quote-utils.js          # 语录归一化和展示规则
│   ├── reading-notes-store.js  # 本机私密阅读笔记
│   ├── reading-progress-store.js # 本机阅读进度、收藏和摘录
│   ├── saved-quotes-store.js   # 本机私密语录收藏
│   ├── saved-answers-store.js  # 本机私密 AI 回答收藏
│   ├── timeline-data.js        # 党史时间线数据（事件、决策点、党代会）
│   ├── timeline.js             # 党史时间线页渲染与筛选
│   ├── timeline-map.js         # 党史沙盘地图：时间轴与事件标注
│   ├── campaign-data.js        # 长征战役沙盘数据（地理、部队、章节、复盘）
│   ├── campaign-engine.js      # WebGL2 立体沙盘渲染器（Albers 投影、真实高程、小地图）
│   ├── campaign.js             # 长征沙盘页面控制
│   ├── modern-cases.js         # 现代问题案例数据（场景、原文依据、行动清单）
│   ├── modern.js               # 现代问题栏目渲染与筛选
│   └── reading-guides.js       # 阅读导读和主题路径
├── worker/
│   └── index.mjs               # Cloudflare Worker：/api/chat、/api/public-config，其余交给静态资源
├── api/
│   ├── chat.js                 # Vercel API 代理（迁移完成后可删除）
│   ├── chat-context-core.mjs   # 问道提示词与检索（与平台无关）
│   ├── chat-provider.mjs       # DeepSeek/OpenRouter 服务选择
│   └── openrouter-guard.mjs    # AI 请求白名单和长度守卫
├── data/
│   ├── quotes.json             # 精选语录
│   ├── catalog.json            # 文章目录
│   ├── search-index.json       # 带段落锚点的全文检索索引
│   ├── history-cases.json      # 历史问题案例库
│   ├── text-edition.json       # 文本版本与来源说明
│   ├── terrain/                # 长征沙盘高程栅格（GEBCO 2024）与植被类型 PNG
│   ├── map/                    # 长征沙盘矢量图层（Natural Earth）
│   └── articles/               # 毛选文章 Markdown
├── tests/                      # Node 测试
├── docs/database/
│   └── supabase-schema.sql     # Supabase 表结构与 RLS
├── docs/product/
│   └── redwisdom-requirements.md
└── assets/                     # 图片资源

产品路线

阶段 1：游客态增强

• 修复抽卡翻牌错误。
• 卡片回到简洁卡面，只保留语录、出处和时间。
• 阅读页增加热门文章推荐、更多问题路径、核心文章导读和字号调节。
• AI 从角色扮演升级为毛选方法论实践教练。
• API 代理加入基础请求守卫。

阶段 2：账户与保存

• 当前过渡版：使用 localStorage 保存实践和复盘，验证产品闭环。
• 当前已支持：登录页、Supabase 配置检测、Google OAuth 调用骨架。
• 当前已支持：本机问答历史、本机 AI 回答收藏、本机阅读笔记、本机阅读进度、本机文章收藏、本机原文摘录、本机语录收藏、本机实践记录导出。
• 当前已支持：实践、问答、消息、阅读笔记、阅读进度、文章收藏、原文摘录、语录收藏、AI 回答收藏同步到 Supabase 的前端映射、从 Supabase 拉取并按更新时间合并恢复到本机，以及 profiles / practices / conversations / messages / reading_notes / reading_progress / highlights / saved_quotes / saved_answers RLS schema。
• 后续增强：真实 Supabase 项目配置、线上 OAuth 回调验证、线上云端上传/恢复端到端验证。

阶段 3：实践闭环

• 当前已支持：从问答、文章导读生成本机实践任务。
• 当前已支持：从毛选方法分析向导生成结构化提问和本机实践任务。
• 当前已支持：实践页手动创建和展示主要矛盾、缺少的调查、可用力量、复盘标准，并提供对照预期、核对事实、检查矛盾、确定下一步的复盘提示。
• 当前已支持：我的档案页训练面板基于本机档案推荐复盘、继续实践、继续阅读或继续问道，并可跳转定位到对应实践记录。
• 当前已支持：登录后学习档案上传到云端、从云端合并恢复。
• 后续增强：真实云端环境端到端验证、跨设备恢复验证。

阶段 4：多语言

• 中文原文优先。
• 当前已支持：问道页、阅读页和实践页语言偏好、中文/英文基础界面文案，阅读页核心导读与主题路径英文版，阅读字号调节，实践页英文复盘提示，AI 回答语言约束。
• 后续增强：全站英文界面、多语言路由和更多文章导读。
• 术语表。
• 中英对照阅读。
• 多语言 AI 问答。

需求文档

完整产品需求见：

docs/product/redwisdom-requirements.md

---

Powered by Cloudflare & DeepSeek