# v24 说明

`v24` 是在 `v23` 基础上的整理升级版本。

主要变化：

1. **移除 `new/` 目录**：`v23/new/` 中 27 份讨论材料不再作为未整理的草图池保留，而是按主题分流到正式补充文章中。
2. **新增四篇 v24 补充专题**：
   - `supplement-v24-core-patch.md`：核心概念补丁
   - `supplement-v24-toolbox.md`：制度工具箱
   - `supplement-v24-personhood.md`：人格与生命关怀
   - `supplement-v24-meta.md`：元框架与哲学反思
3. **`supplement-boundary-pilot.md` 追加**：`new/22.md`（公共决策容错）与 `new/24.md`（17% 阈值与悬崖效应）的完整讨论已追加到该文件末尾。
4. **主干文章新增应用案例**：`main.md` 新增第二十二部分“四把尺子的应用——以县城经济为例（主干提示）”，主文只保留五条主干判断和阅读路径，完整论证与具体制度设计抽离为独立应用文章 [`application-county-economy.md`](application-county-economy.md)。这样既保持主干的清晰，也方便单独发给 AI 继续讨论应用层面。
5. **主干文章保持稳定**：`main.md`、`main-tech.md` 等主干文章继续作为 v23 的母本升级基础，未因 `new/` 材料无限膨胀。

---

`v23` 延续方案 A：双主文并存，不用技术版替代理论母本。

## 文件结构

- `main.md`
  - 定位：理论母本
  - 用途：保留完整制度论证、边界分析、防滥用护栏、失败模式与压力测试
  - 来源：以前一版 `main.md` 为直接母本升级

- `main-tech.md`
  - 定位：技术演绎版
  - 用途：用更集中的方式回答“元规则与四把尺子如何在数字时代获得技术肉身”
  - 重点：RWA、链上登记簿、智能合约、公民审计接口、双循环的可编程实现

- `structure-map.md` / `structure-map.html`
  - 定位：结构索引
  - 用途：集中说明 `v23` 目前的“主骨架 + 补充专题 + 想法池”分层，以及 `new/` 目录的整理状态
  - 重点：方便继续拆专题、继续发给 AI 讨论、继续决定新材料该并到哪里

- `popular.md`
  - 定位：通俗版主文
  - 用途：用“先讲问题、再接方案”的更顺口叙事，服务第一次接触者和转发场景
  - 重点：从普通人的困境切入，把动态兜底、劳动承认、货币分轨、元规则、数据治理与误伤修复讲得更易读，并已补入劳动者经济防御工事、优劳直通、新工会行业攻防职能等更具体的制度抓手

- `popular-short.md`
  - 定位：通俗超短版
  - 用途：服务群聊、朋友圈、第一次转发时的快速理解场景
  - 重点：几分钟内抓住主线，先理解“这套理论到底想解决什么问题”

- `popular-share.md`
  - 定位：一段式转发文案
  - 用途：适合复制到微信群、朋友圈、私聊对话中直接发送
  - 重点：用一段话把“问题是什么、这套理论想做什么”讲明白

- `supplement-boundary-pilot.md`
  - 定位：边界与试点补充文
  - 用途：集中承接主文不宜继续膨胀的护栏、边界问题、冷启动与试点模板
  - 重点：三个最难边界问题、潜在张力与未尽之问、冷启动路径、试点实施模板、样板方向、公共决策容错、悬崖效应缓冲、外部安全的底盘
  - v24 追加：`new/22.md`、`new/24.md` 完整讨论

- `supplement-personhood.md`
  - 定位：人格与生命关怀补充文
  - 用途：集中承接主文已经引入、但不宜无限展开的人文底层、叙事主权与人格保护结构
  - 重点：人格与德、兜底为什么是生理基础设施、叙事主权、无尺之地、退后一步、身体连续性、共情与制度传感器

- `seventeen-percent-recalculation.md`
  - 定位：专题补充文
  - 用途：集中讨论 17% 法则的再核算与延展问题，避免主文被单一专题拖长

- `supplement-v24-core-patch.md`（新增）
  - 定位：v24 核心补丁包
  - 用途：汇总 `v23/new/` 中最接近四把尺子主轴的认知升级，供继续讨论是否并入 `main.md`
  - 来源：`new/1.md`、`new/2.md`、`new/6.md`、`new/16.md`、`new/20.md`

- `supplement-v24-toolbox.md`（新增）
  - 定位：v24 制度工具箱
  - 用途：把 `v23/new/` 中已具雏形的具体机制集中收纳，供与 `main-tech.md` 对照打磨
  - 来源：`new/3.md`、`new/4.md`、`new/5.md`、`new/7.md`、`new/8.md`、`new/10.md`、`new/11.md`、`new/12.md`、`new/13.md`、`new/14.md`、`new/17.md`

- `supplement-v24-personhood.md`（新增）
  - 定位：v24 人格与生命关怀补充
  - 用途：继续展开心理支持、身体叙事、德与秩序、生命关怀等人文维度
  - 来源：`new/9.md`、`new/25.md`、`new/26.md`、`new/27.md`

- `supplement-v24-meta.md`（新增）
  - 定位：v24 元框架与哲学反思
  - 用途：供 AI 讨论框架自洽性、博弈论启示、阅读结构与自我质疑
  - 来源：`new/15.md`、`new/18.md`、`new/19.md`、`new/21.md`

- `index.html`
  - 定位：总入口页
  - 用途：同时链接母本整稿、母本章节目录、技术版整稿、技术版细化目录、公司治理分支、工具箱、阅读路线图、概念词典与升级说明

- `reading-map.html`
  - 定位：阅读路线图
  - 用途：按读者身份、阅读目标和进入阶段，给出“先从哪里进、再往哪里走”的最短路径

- `glossary.html`
  - 定位：概念词典 / 术语索引
  - 用途：集中解释任务池、共享岗位、无尺之地、增量价值合约、生存月数阈值等高频术语，降低第一次阅读门槛

- `issue-diagnosis.html`
  - 定位：社会问题四尺子定位表
  - 用途：把热点事件、现实冲突和组织病灶快速拆成“哪把尺子失效、哪个刻度被篡改、哪条元规则被绕过”

- `intro.html`
  - 定位：对外介绍页
  - 用途：适合第一次转发，先用一页版摘要和极简版总纲建立理解，再分流到阅读路线图、总导航图或公司治理分支

- `animation/platform-flow/`
  - 定位：平台总图动画专题页
  - 用途：用分幕动画把“公开流程、学习考试、科研实验、问题聚合、制度讨论、社会模拟”这条链先图示化，再回母本阅读

- `site-map/`
  - 定位：总站导航图专题页
  - 用途：按阅读目标、现实症状和进入顺序，为整站提供最短路线图

- `company/`
  - 定位：公司治理分支子站
  - 用途：把理论落到组织治理，现已形成“目录页 + 子导航图 + 角色页 + 岗位页 + 症状页 + 正文页 + 工具箱”的多入口结构

- `toolbox/`
  - 定位：制度工具箱目录
  - 用途：按施工场景集中整理反腐与吹哨、安全气囊与新工会、创新风险分担等制度工具
  - 重点：这一层正在承接母本里新增的更细制度接口，例如新工会的行业攻防职能、优劳直通的可施工化展开等

- `upgrade-notes/`
  - 定位：版本升级说明页
  - 用途：集中说明在场之尺、校准权约束、信的资产化、增量价值合约等本轮补丁如何并回母本与应用页

- `parts-tech/`
  - 定位：技术版细化章节目录
  - 用途：把 `main-tech.md` 拆成更细颗粒度的单章页面，便于局部继续改写

## 入口分层

如果你只是想先知道“应该点哪一层”，可以直接按这个顺序判断：

1. 若只想先复制给别人，先看 `popular-share.md` 或 `popular-share.html`
2. 若只想几分钟抓主线，先看 `popular-short.md` 或 `popular-short.html`
3. 若想先看更通俗、更像故事的版本，先看 `popular.md` 或 `popular.html`
4. 若已经准备继续看，但还不确定自己该从哪条线进入，先看 `reading-map.html`
5. 若是先被术语密度卡住，先看 `glossary.html`
6. 若不是先想通读，而是已经带着现实问题来，先看 `issue-diagnosis.html`
7. 若想先看图示和动态演示，先看 `animation/platform-flow/index.html`
8. 若想先搞清楚整个目录怎么分层、`new/` 材料池该怎么看，先看 `structure-map.html`
9. 若想系统研究整套理论，再进入 `main.md` / `main.html` 和 `main-tech.md` / `main-tech.html`

## 阅读建议

1. 若第一次准备转发给别人，建议顺序是：`popular-share.html` -> `popular-short.html` -> `popular.html` -> `intro.html`
2. 若想完整理解这套理论为什么成立，建议顺序是：`main.html#heading-3` -> `main.html` -> `main-tech.html`
3. 若只想复制一段话先发出去，先读 `popular-share.md`
4. 若只想先抓主线，读 `popular-short.md`
5. 若想先看更顺、更像“问题和方案并排展开”的版本，再读 `popular.md`
6. 若想先看图再回正文，先看 `animation/platform-flow/index.html`，再回 `main.html`
7. 若还不确定整站该从哪条线进入，先看 `site-map/index.html`
8. 若想按“我是谁、我要做什么”来选入口，先看 `reading-map.html`
9. 若手头已有具体事件、组织冲突或热点问题，先看 `issue-diagnosis.html`
10. 若带着现实组织和管理问题来，直接进 `company/index.html` 或 `company/site-map.html`
11. 若想理解它如何被技术化、自动执行，再读 `main-tech.md`
12. 若后面继续扩写，原则上：
   - 制度正当性、边界条件、镜像约束、防滥用机制，优先写入 `main.md`
   - 技术接口、链上流程、自动触发逻辑、数字治理实现，优先写入 `main-tech.md`

## 当前状态

- `main.md`：作为母本已升级到 `v23`
- `popular.md`：已作为通俗版入口加入，适合第一次转发和降低阅读门槛
- `popular-short.md`：已作为超短版入口加入，适合快速转发和几分钟抓主线
- `popular-share.md`：已作为一段式转发文案加入，适合直接复制发送
- `main-tech.md`：已作为技术演绎版同步升级
- `animation/platform-flow/`：已形成独立图解入口，适合先看动态平台总图，再回母本继续阅读
- `reading-map.html`：已形成独立导读页，适合按身份和阅读目标选最短路径
- `glossary.html`：已形成独立术语页，适合第一次阅读前先对齐概念
- `issue-diagnosis.html`：已形成独立诊断页，适合先拆热点事件和现实病灶，再决定回母本、工具箱还是公司治理
- `company/`：已扩成带子导航图、角色分流和岗位分流的公司治理子站
- `toolbox/`：已形成独立制度施工包目录与 3 个子专题
- `main.md` 与 `toolbox/`：已补入劳动者经济防御工事、优劳直通体系和新工会行业攻防职能等新一轮制度补丁
- 本目录的目标不是做“新旧替换”，而是形成“母本 + 技术版 + 子站/工具箱”的并行结构

## 生成方式

- 一键生成全部页面：
  - `build_all_html.bat`
- 只生成转发文案 HTML：
  - `python build_popular_share_html.py`
- 只生成通俗超短版 HTML：
  - `python build_popular_short_html.py`
- 只生成通俗版 HTML：
  - `python build_popular_html.py`
- 只重建 `main.md` 对应的整稿与 `parts`：
  - `python build_parts_html.py`
- 只按现有 `parts/*.md` 重建章节 HTML：
  - `rebuild_parts_html.bat`
- 只生成技术演绎版 HTML：
  - `python build_main_tech_html.py`
- 生成技术版细化章节与 `parts-tech`：
  - `python build_tech_parts_html.py`
- 只按现有 `parts-tech/*.md` 重建技术版章节 HTML：
  - `rebuild_parts_tech_html.bat`