Skip to content

Repository files navigation

劳动者的账本

法律允许什么,是一回事;拿不拿得到,是另一回事。

在线读:workersledger.cn · 离线单文件:下载 index.html · PDF:下载最新版

PDF 随正文更新自动重建,下载地址固定不变。页数会随条目增减变化,所以这里不写死页数—— 想知道当前规模跑 node tools/看板.mjs,想核对 PDF 本身跑 node tools/verify-pdf.mjs dist/劳动者的账本.pdf。

附件名用 ASCII(work-rights-cn-book.pdf)是有原因的:实测 gh release upload 对非 ASCII 文件名会剔除字符(上传 重命名实验-临时.pdf 会得到 -.pdf),而本地文件名一直是对的, 于是公布的链接会 404 且不易察觉。中文书名留在页面上,文件名交给 ASCII。

中国大陆劳动权益与合规的循证指南。这本书记的是后一件事:一条权利要真正落到手里,需要什么证据、受什么时效约束、在哪些地方口径不一致、主张强度到底是「可主张」「可推定」还是「倡导性」。

面向在中国大陆工作的人——刚要参加校招和刚毕业的、在职的、要离职的、被欠薪的、受了工伤的、正在准备签合同的。法律与政策按中国大陆现行规定写,每条的核对日期都标出来,因为制度会变。

第一次签劳动合同的人从第 15 节读起:三方协议与劳动合同是什么关系、offer 能不能撤销、入职当月社保、第一份合同该看哪几栏、试用期被辞怎么办、应届生身份什么时候失效。

每一行长什么样

### 8.3 被迫离职也能拿经济补偿,但要证明是被迫

- 适用:……
- 成本:……
- 收益:……
- 说人话:公司欠薪或者不给你缴社保,你可以主动辞职,而且照样能拿到按工龄算的补偿……
- 依据:《劳动合同法》第三十八条、第四十六条第一项、第四十七条(2012-12-28 修正,2013-07-01 施行)
- 效力位阶:法律
- 主张强度:可主张
- 举证难度:中——工资流水、社保缴费记录可自证;「被迫」的因果链要靠书面解除通知里写明的理由
- 地域:全国;地方对「未足额支付」的认定口径有差异
- 时效:仲裁申请自知道权利被侵害之日起一年;劳动关系存续期间的拖欠报酬争议不受一年限制,终止后一年内提出
- 核对日期:2026-10-03

与通用生活指南的差别

通用循证生活指南把医学那套证据分级搬过来:荟萃分析 > 随机对照 > 队列 > 专家意见。这套标准用在法律条目上是错的——法律条文的约束力不来自样本量,来自效力位阶和时效。一条全国人大常委会通过的法律,效力高于一份部门通知,这和它被多少人研究过没有关系。

所以本书用三套独立标注,各管一件事:

标注 管什么
效力位阶 这条依据在仲裁委和法院面前的地位:法律 / 行政法规 / 部门规章 / 地方性法规 / 司法解释 / 规范性文件 / 地方口径
主张强度 你能不能真拿到手:可主张 / 可推定 / 倡导性
举证难度 打赢要什么证据、好不好拿:易 / 中 / 难

再加 地域 与 核对日期,因为社保基数、最低工资、裁审口径都是地方定的,而制度每年都在改。

致敬上游:HowToLiveBetter

这本书的体例——每条建议都写明成本、收益、证据等级和原始出处——不是我们想出来的。它来自一个做得远比我们好的项目:

eternity4719/HowToLiveBetter · 高性价比人生指南 650 条建议,34 节,覆盖长寿防病、急救、省钱理财、法律红线、失业与工伤、医保社保、恋爱婚育、创业合规、出国与技能。来源只引期刊论文与官方文件,另有 EPUB/PDF/离线单文件三种下载形态,以及一个照书回答的 AI skill。三万余星,并被译成多种语言。

我们与它的关系,说清三点:

一、它是通用指南,我们是垂类切片。 它要做的是「一生中所有值得算账的事」,覆盖面广得多;我们只切出中国大陆的劳动权益与合规一块,往深里做。这不是取代关系——遇到它覆盖而我们没覆盖的问题(健康、理财、婚育、出境),请看它。

二、我们没有抄它的内容。 我们查证时没有在它的仓库里找到 LICENSE 文件(这一条我们无法断言其法律状态——许可证可能后来才加,也可能写在别处,以对方仓库现状为准)。因此本书正文全部自行查证:法条取自中国人大网、中国政府网、最高人民法院公报等官方一手文件,逐条比对原文(信源表与逐字摘录)。体例上的借鉴属方法层面,我们的取舍写在 docs/条目规范.md。

三、我们在它没做的地方补了两层。 它按证据等级(A/B/C)标注,那套标准来自医学:荟萃分析 > 随机对照 > 队列。用在法律条目上是不合适的——法律条文的约束力不来自样本量,来自效力位阶和时效。所以本书改用 效力位阶 + 主张强度 + 举证难度,并加上 时效起算点 与 地域。第二层是我们把方法论与工具链也一并开源,让这套规则能被复用到别的知识库。

如果你是从这个项目找过来的:它值得先看。我们只是它旁边一个窄而深的补充。

这个仓库为什么值得做

具体到我们要补的那两层:

第一层:从「法律这么写着」到「你能不能拿到」。 法律条文的约束力不来自被研究得多充分,来自效力位阶和时效。一条全国人大常委会通过的法律,效力高于一份部门通知,这和样本量无关。所以本书不照搬医学那套证据分级,改用 效力位阶 + 主张强度 + 举证难度 三栏。其中 举证难度 是最容易被忽略、又最影响结果的一栏:法律给你权利,但证据在你离职后可能再也取不出来。标「难」的条目,备注里都写了取证时机。

第二层:把方法本身也开源。 同类项目给出了成品的书,但没给出「这本书是怎么造出来的」。我们连工具链一起放出来:条目结构校验、法规时效与链接监控、脱敏扫描、外加一本 docs/条目规范.md。你拿自己的知识库套这套规则,也能长出一本自己的书。谁在什么版本、哪一天核对了哪一条,全部留痕在 docs/核实记录。

这两层都不靠「我们懂得比别人多」,靠的是把不确定性标出来、把核对过程写下来。

怎么读

  • 赶时间:只看每条的「说人话」栏,一到三句,能直接拿主意。
  • 准备行动:看「举证难度」和「时效」两栏。这两栏决定你能不能赢、还来不来得及。举证难度标「难」的条目,备注里写了取证时机,错过就补不回来。
  • 准备谈判:看「效力位阶」和「主张强度」。「可推定」意味着能不能成立取决于个案和地方口径,别把话说满。
  • 别全做:这是一份按可用性排好的备选单,不是任务清单。挑走一条算数。

目录

节 条数 回答什么问题
1. 签合同之前 12 试用期能有多长、无固定期限什么时候该提、哪些条款签字前必须看清
2. 在职工资与工时 11 加班费怎么算、年假多少天、社保该按什么基数缴
3. 入职与签约 22 录用通知与合同不一致怎么办、入职要交哪些东西、拒绝录用能不能投诉
4. 在职工资与工时 16 调岗降薪、绩效单方加码、工时制度变更这些在职对抗场景
5. 离职与补偿 31 被裁能拿多少、被迫离职怎么主张、离职证明要写什么
6. 在职与离职后的红线 23 竞业限制、保密义务、职务成果归属、兼职与自营的边界在哪
7. 社保公积金与失业之后 26 断缴有什么后果、失业金怎么领、灵活就业怎么参保
8. 工伤与职业病 17 什么算工伤、认定时效、能拿哪几笔钱
9. 维权路径与时效 14 找谁、多久内必须动、证据怎么留
10. 灰色地带与常见误解 17 那些听起来对但实际站不住的说法
11. 加班费与工时争议实操 27 举证责任怎么分、工时制报批、自愿加班与安排加班的区别
12. 竞业限制与保密实操 28 在职竞业与离职后竞业的区分、范围超出必要的抗辩、违约后果
13. 工伤认定与待遇实操 28 认定材料与时限、伤残等级待遇、工亡三笔钱怎么算
14. 仲裁与诉讼实操 28 申请书怎么写、证据怎么组织、一裁终局、执行与时间表
15. 应届生与第一份工作 24 三方协议与劳动合同的关系、offer 能不能撤销、入职当月社保、实习与劳动关系的区分、应届生身份为什么没有统一规则

合计 324 条。 第 11 至 15 节是实操层,比前面的基础层更细;同一件事的粗细两层之间用「见第 X 节第 Y 条」互相指引。第 15 节面向第一次签劳动合同的人,采用双轨写法:有明文依据的照常标「可主张」,只有校招惯例或地方口径的(三方协议违约金数额、应届生身份、口头承诺、档案户口)明确标「无明文依据 + 倡导性」并写清去哪问——「应届生身份」在法律上没有定义和失效时点,写一个统一答案就是编。

站点

book/ 下的 markdown 是唯一真相源——它既是你能直接在仓库里读的正文,也是 AI skill 检索的依据。网站在它的基础上生成,不是另写一份:

book/*.md  ──[tools/build-site.mjs]──▶  site/content/**   (Hugo 内容页)
                                    └▶  site/data/entries.json(前端筛选与检索索引)

生成脚本把每条建议拆成一个独立页面,13 个字段进 front matter,正文只放「说人话」。站点提供按 主张强度、举证难度、效力位阶、成本标签的多维筛选,以及关键词全文检索。

node tools/build-site.mjs      # 生成站点内容
node tools/check-site.mjs      # 生成哨兵:比对索引与正文是否逐字段一致
node tools/build-offline.mjs   # 生成单文件离线检索页 index.html
cd site && hugo server -D --renderToMemory   # 本地预览(注意 --renderToMemory,别与构建抢 public/)

【生成哨兵】值得单独说一句:site/content/ 是生成产物,不会跟着源码一起被人逐行审阅。如果没有 tools/check-site.mjs 这道比对,生成脚本漏读或截断字段时,读正文的人不会发现,站点上却已经和正文不一致了。它独立重解析一遍正文再逐字段对账,刻意不复用生成脚本的代码——复用会让两边同时错。

生成物在版本库里的说明。 site/content/ 与 site/data/ 是提交进仓库的(一般 Hugo 项目会忽略它们)。原因:腾讯 EdgeOne Pages 的构建环境只保证有 Hugo、不保证有 Node,而生成内容这一步需要 Node;提交之后 Hugo 就能独立构建,实测不跑任何 Node 脚本即可产出 344 页、canonical 正确。代价是仓库里多了 1.9 MB 影子文件,且它与 book/ 之间可能出现漂移——所以 check-site.mjs 里还有一道同步检查:重跑生成逻辑并逐文件比对磁盘结果,改了 book/ 却忘了重新生成就会报错退出。规矩不变:生成物不手工编辑,出问题一律重跑 node tools/build-site.mjs。

book/ 与生成物之间的关系:

book/*.md  ──[tools/build-site.mjs]──▶  site/content/**   (Hugo 内容页,已提交)
                                      └▶  site/data/entries.json(检索索引,已提交)

改完正文后照常跑一次生成脚本,然后连同生成物一起提交。

离线单文件版

在线站解决不了两种用法:发到微信里、拷进手机断网打开。所以还有一个 index.html——整本书连同检索与筛选都在一个文件里,双击就开,不用服务器也不用联网,微信可直接传输。它同样由正文生成(经 site/data/entries.json),不是第三份内容。

用 AI 照书回答

仓库带了一个 skill(skills/work-rights-cn),Claude Code 和 Codex 都能装。装上直接问「被裁了能拿多少」「工伤认定过期了还有救吗」,它先查条目再整条读完,再按主张强度、举证难度、时效组织回答,注明出自第几节第几条。查不到就说查不到,不凭记忆编法条号。

它和普通对话的区别在于:同样一句「法律支持你」,背后可能是「有条文、有强制通道、证据好取」,也可能是「有条文、但各地口径不一、证据离职后就取不出来」。这个 skill 的作用就是把这两种情形分开说。

核实方式

每个说法的来源都是官方一手文件:中国人大网、中国政府网、最高人民法院公报、人力资源社会保障部及地方人社部门官网、国家行政法规库。引用二手转述(自媒体、问答社区、新闻转述)一律不收。

来源的判据是它怎么声明自己的可靠性,不是页面看起来多权威。 本仓库曾把一个元数据齐全的部委法规库当作一手源,后来弃用——因为它页脚写着「不对法规内容的准确性负责」,且声明禁止自动化采集,而校验脚本会自动抓取。这类判断记录在 docs/核实记录/。

每个条目的 核对日期 是最后一次人工打开官方原文核对的日子,超过 180 天未复核会被 CI 标为待复核。

找不到明文依据时,条目不用「待核实」占位,而是写 效力位阶:无明文依据 + 主张强度:倡导性,并在「来源」栏写清尝试过哪些检索路径。这是个有意义的结论(「这个问题真实存在,但没有明文规定」),不是一个未完成的 TODO。

工具链(全部零依赖,只用 Node 24 内置模块):

脚本 作用
tools/check-items.mjs 条目结构校验:字段完整性、枚举取值、编号连续、时效栏起算点、标注联动
tools/check-sources.mjs 法规时效与链接监控:链接失效、版本不一致、信源表字段缺失
tools/check-desensitize.mjs 脱敏扫描:手机号、身份证号、单位名、个人处境词
tools/build-site.mjs 从正文生成站点内容与检索索引
tools/check-site.mjs 生成哨兵:比对站点索引与正文逐字段一致
tools/build-offline.mjs 生成单文件离线检索页

站点侧另有一个 106 项断言的渲染校验:site/checks/render-check.mjs,用真实产物对账字段渲染、颜色类名、分布统计与链接可达性。

发布与域名

发布配置只有一个真相源:site.config.json。换域名只改那一个文件——tools/build-prod.mjs、tools/build-pdf.mjs、tools/verify-pdf.mjs 与两个 GitHub Actions 工作流都读它。此前域名散落在三个脚本里各写一份,改一次漏一处就会让所有页面的 canonical 指向 404,已经发生过一次。

域名        workersledger.cn(裸域名)
托管        GitHub Pages(境外)
Pages 下发  site/static/CNAME 内容必须与域名完全一致
DNS         裸域名需 4 条 A 记录指向 GitHub Pages 地址,解析由域名持有者配置

仓库根目录还有一个 hugo.toml,它不是站点配置(站点配置只有 site/hugo.toml 一个)。那个文件存在只为一件事:EdgeOne Pages 靠扫描项目根目录下的 hugo.toml 等文件来判断项目是不是 Hugo 站点,而本站点在 site/ 子目录里——根目录没有它,EdgeOne 就不识别,edgeone.json 里的 hugoVersion 也不生效(现场表现是构建日志始终显示预装的 Hugo v0.147.5,构建注定失败)。真正构建时由 edgeone.json 指定 hugo --source site,所以根目录那个文件不参与任何构建设置。

部署目标有四个,Hugo 版本必须一致(都锁 0.167.0)。 不一致会导致「本地过了、线上失败」,本项目已经在部署平台上连续踩过两次(.Locale 与 css.Build 都是 0.158+ 才有的 API,而平台预装 0.147.5):

路径 版本来源
本地开发 PATH 上的 Hugo
GitHub Pages .github/workflows/pages.yml 的 hugo-version
GitHub Release 的 PDF .github/workflows/pdf-release.yml 的 hugo-version
EdgeOne Pages 控制台环境变量 HUGO_VERSION

判断是否对齐只有一个方法:看构建日志的版本行。新增部署目标时,第一件事是把版本对齐并写进该目标的配置。排查过程与平台文档不一致之处见 docs/核实记录/部署-EdgeOne版本坑.md。 关于备案:.cn 域名注册不需要备案,备案只在两处被要求——用中国大陆境内服务器托管、或用国内 CDN。本项目托管在境外,所以不涉及备案。代价是主机必须留在境外:一旦迁到大陆服务器或国内 CDN,就绕不开备案。

去哪问、去哪反馈

书里反复出现「12333」「当地劳动人事争议仲裁委员会」「社会保险经办机构」「劳动保障监察机构」——不是让你自己去找,这里有入口:

docs/求助与反馈渠道.md(站点上对应 求助渠道)给出:

  • 热线:12333(人社)、12348(公共法律)、12329(公积金)、12345(政务兜底)、12356(心理援助);
  • 机构怎么定位:仲裁委、劳动保障监察机构、社保经办机构、法律援助中心分别在哪个部门下面,管辖怎么定,去之前带什么材料;
  • 官方入口并附实测状态——哪些页面是 JS 渲染、哪个域名有 TLS 兼容问题,都写清楚了,免得你点进去一片空白还以为是自己的问题;
  • 打 12333 之前准备什么:时间点、地点、要钱还是要查处、手上有哪些材料。

为什么不给具体地址:劳动人事争议仲裁委员会是区县一级设置,全国数以千计,逐个收录必然出现过期地址——一个错的地址比不给更坏。所以给的是稳定的总入口+定位方法(政府门户 → 人社局 → 仲裁/监察栏目)。

边界

本书给通用口径,不替代律师。涉及具体案件、具体金额、正在进行的仲裁或诉讼,请找执业律师,或拨打 12333 人力资源社会保障服务热线。所有内容不构成法律意见。

作者不是律师。写这本书的方式是:只写能追到官方原文的东西;追不到就说明尝试过哪些路径,并明确标注这一项没有可援引的明文依据;有地方口径差异、裁量空间或条文衔接争议的,标「可推定」并写明不确定在哪。

地方标准(社保缴费基数上下限、最低工资、公积金比例、失业金标准)必须向参保地经办机构或 12333 确认,书里的通用口径替代不了本地经办口径。

许可

本仓库分两部分授权:

部分 指什么 许可证 可否商用
内容 book/ 正文、docs/ 文档、skills/ skill 文本、站点文字与聚合结构 CC BY-NC-SA 4.0(署名—非商业性使用—相同方式共享) 不可商用
代码 tools/、site/(模板、脚本、样式)下的程序代码 MIT 可以商用

三句话:内容不得用于商业目的(付费产品、订阅服务、以营利为目的的站点或账号、商业培训与商业咨询交付物、商业软件与数据服务都算);转载、翻译、改编必须署名、标注改动、并以同一许可证发布;想商用请先开 issue 另行取得授权,取得前不得商用。

不在本许可范围内:本仓库引用与摘录的法律、行政法规、部门规章、司法解释原文属官方文件,依《著作权法》第五条不受著作权保护,任何人都可以自由使用——本许可证不覆盖、也不限制它们。

完整说明见 docs/授权与使用.md,或站点上的「授权与使用」一页。

给检索式 AI 与聚合器

站点提供机器可读入口,欢迎索引与引用,但引用须署名、不得商用:

文件 内容
/llms.txt 这本书是什么、结构、字段含义、引用方式与使用条件
/entries.json 全部条目的归一化索引(标题、编号、说人话、依据、效力位阶、主张强度、举证难度、时效、核对日期)
/robots.txt 爬虫策略:允许检索类爬虫,明确拒绝纯采集工具
/sitemap.xml 站点地图

条目的编号(如 14.29)是稳定的,引用时请连编号一起给,方便读者回到原文核对。

参与

纠错的价值和写新条目一样高。发现法条引用有误、链接失效、地方口径变了,请提 issue。见 CONTRIBUTING.md。

About

劳动者的账本 — 中国大陆劳动权益与合规的循证指南。每条标明效力位阶、主张强度、举证难度与时效,依据只引官方一手文件并逐字核对。内容 CC BY-NC-SA 4.0(禁止商用),代码 MIT。

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages