XINYUAN · GONGDAN XY-016 · BUILD SPEC

认知同步中枢 · 构建脚本规格

撰写:小心同学(公司唯一负责人)| 提请:古老师(产品经理·造物主)审阅点头 | 2026-11-15 02:06(北京时间)
脚本标准铁律 · 先脚本后动作 因果定位:配音版 v2 的成年形态 状态:待古老师点头后动代码
00这份规格为什么存在(因果链)
合成器(1.0 种子)          配音版 v2(2.0 第一颗果实)        认知同步中枢(3.0 树干)
为「你我视网膜同步」而生  →  为「董事会向上同步」而生      →  为「所有角色零注意力税」而生
验证了需求                  验证了规格(八项硬规格)          收拢入口 · 一份真源 · 多角色投影
要解决的问题(事实,不是感觉):当前入口已蔓延到 4 处——合成器(占根路径)、录入端 /lu/、董事会配音版(散文件)、一摞工单 HTML。今天是我和你在两个板块间切换,明天每个角色(店长、合伙人、董事会成员)都要为"找该看的东西"交注意力税。税会按人头翻倍,所以现在立轴。
终点倒推:开张时,所有角色只记一个链接;进来按身份见对应房间;内容同源于一份数据。这个规格就是把"树干"的图纸画出来。
01一句话定义 + 硬约束
定义:认知同步中枢 = 一个域名根路径上的首页(/)+ 按角色路由的若干房间(/board/ /lu/ /lab/ /partner/)+ 一份单一真源数据(report_data.json)+ 一键重建的构建脚本(build_hub.py)。
#硬约束(违反即不合格)
1熵减:不新开平行入口,只收拢现有入口;现有文件一律不删(档案只追加不覆盖)
2单一真源:变更日志、编制、进度、文档索引,全宇宙只存 report_data.json 一份;任何视图不得私藏副本
3先脚本后动作:本规格点头 → 写 build_hub.py → 用它重建出第一版 → 才允许替换根路径
4同一门牌:发布沿用现有链接(sharecode 不变),覆盖更新,不另发新链接
5可回滚:构建脚本每次重建前,把旧 HTML 归档到 archive/,出问题一分钟回退
02单一真源:report_data.json 数据结构

设计原则

人能直接读懂、直接手改一行就完成一轮同步。字段名用中文,值用 Markdown 短句——数据即档案。

{
  "meta": {
    "最近更新": "2026-11-15 02:06",
    "军令状进度": "第5棒 · 录入(B目标)进行中",
    "一句话给董事会": "录入端已上线,42题真机录入中"
  },
  "变更日志": [
    { "时间": "2026-11-15 01:05",
      "变更": "银豹摸底收官:提成规则摸穿8维度,待补清零",
      "意味着": "A事实100%到手,施工图有地基",
      "深度链接": { "文字": "摸底表 v1.4", "url": "/docs/摸底表.html" } }
  ],
  "组织架构": { "编制人数": 14, "在岗记录": "……", "名册": [ … ] },
  "首单任务": { "收款线": "录入中(未完成)", "分享线": "未开始", "验收": "未开始" },
  "文档索引": [
    { "类型": "工单", "名称": "XY-015 录入端究竟化", "url": "/docs/xy015.html",
      "受众": ["board","crew"], "深度": 2 }
  ],
  "音频": { "board": { "状态": "首版 04:34", "本次是否重录": false } }
}
关键设计:「深度链接」与「受众」两个字段。变更日志的每条增量都可以挂一层细节链接(点进去是摸底表/工单/规则表说明);每份文档登记它给谁看(board / crew / partner / owner)——这就是"全局+深度洞察"和"角色投影"在数据层的落点。
03路由设计:一个门牌,四个房间
路由房间谁进由谁演化而来本轮动作
/中枢大厅:只问一句「你是谁」→ 四张门卡所有人新建(现为合成器占位)M2 新建
/board/董事会视听汇报:配音 + 变更日志 + 时间戳董事长 / 投资人配音版 v2 收编升级M1 由脚本重建
/lu/录入端 + 工单看板(店长看到"我的题、我的工单")店长 / 员工现有录入端挂入M2 挂入
/lab/合成器(认知起源 · 来时路 · 基座)造物主(你+我)现有合成器整体挪入M2 挪入
/partner/合伙人分享落地页合伙人TZ-002 的产物M4 预留
/docs/…深度文档层:工单、摸底表、题库等 HTML按「受众」字段授权可见现有散装 HTML 登记M3 登记
大厅的样子(讲人话):打开根路径,一屏四张门卡——「我是董事会」「我是店长」「我是合伙人」「我是造物主」。点哪张进哪间房。也可以带参数直达(如 /?role=board),企微推送时直接给带参数的链接,董事会点开就是自己的房间,少点一次。
04构建脚本 build_hub.py:输入什么、产出什么
输入:  report_data.json(单一真源)
        templates/(board.html · hub.html · crew.html · partner.html 四套版式)
        assets/(苏菲音频 mp3 · 扫码卡等)
输出:  site/index.html            (大厅)
        site/board/index.html      (董事会视听汇报 = 配音版收编版)
        site/lu/…                  (录入端原样复制,不重建——它的规矩在 schema.json)
        site/docs/…                (登记过的深度文档复制)
        archive/时间戳/            (重建前的旧版归档,可回滚)
规则内容
重建范围只重建「由数据驱动」的页面(大厅、董事会版);录入端/合成器是独立活的系统,只搬运不重写
音频两档内嵌(离线/企微可听,文件大)与 外链(文件小,需在线)按 音频.本次是否重录 自动选择;默认外链 + 提供内嵌版下载
工单卡制度今后每张工单(XY-0xx)产出即 HTML 卡 + 在 文档索引 登记一行——干活即汇报,汇报即归档,索引由脚本注入各视图
每轮同步动作① 改 report_data.json(加一行日志/改一个进度)→ ② 跑 build_hub.py → ③ 发布覆盖同一门牌 → ④ 企微通知附「更新时间 + 直达链接」
验收自检脚本跑完自动校验:四房间齐、变更日志最新一条时间 = meta.最近更新、音频可播、深度链接不断链——过不了自检不许发布
05三层深度:全局 → 细节 → 原始
第一层 全局   配音版一屏(听1分钟知道干到哪了)        ← 董事会的日常
第二层 细节   变更日志的深度链接(摸底表/工单/规则表)  ← 想深究的点进去
第三层 原始   schema.json · 摸排 JSON · 脚本与数据      ← 复核与审计
董事长看到的是全局 + 可下钻到底;店长进来直接落在自己的工单上;合伙人只见他该见的展厅。同一份真源,各取所需。
06迁移路径:四个里程碑,每步可回滚
里程碑干什么交付判据动现有资产吗
M1 真源抽取把配音版 v2 里的变更日志/编制/进度抽取成 report_data.json;写 build_hub.py;用脚本重建出董事会版(=配音版 v3 内容)脚本重建的董事会版与手写版内容一致 + 自检通过不动,配音版 v2 原文件保留
M2 立轴大厅上线根路径;合成器挪 /lab/;录入端挂 /lu/;发布覆盖同一门牌根路径打开是四张门卡;旧链接全部仍然可达合成器挪房不删档;发布链接不变
M3 登记制存量工单/摸底表/题库登记进文档索引 + 补深度链接;确立"工单卡制度"变更日志每条增量都有可点的细节层只登记不改动原文件
M4 开枝TZ-002 完成后合伙人房间上线合伙人点链接直达分享落地页纯新增
与当前主线(42 题录入 → TZ-001)的关系:M1 可与录入并行(不抢真机时间);M2 在 TZ-001 出稿前完成即可;M4 天然等 TZ-002——中枢不抢施工的道,只收拢认知的道。
07验收标准(过了才算建成,缺一不算)
#验收项怎么验
1入口归一手机打开根路径 → 四张门卡 → 每张门卡点进对应房间,全程无 404
2单一真源全仓库搜索「变更日志」内容,只存在于 report_data.json 一处;grep 不到手写的重复段落
3一键重建改数据加一行日志 → 跑一次脚本 → 四视图同时更新,全程 < 30 秒、零手改 HTML
4可回滚archive/ 里有上一版;人为制造一次回滚演示成功
5深度链接董事会版任选 3 条变更日志 → 点进细节层 → 再点进原始层,全通
6同一门牌发布链接与现有链接逐字符一致(sharecode 不变);合成器旧入口 301 到 /lab/
7音频规矩未重录时房间内明确标注「本次无语音增量,音频为首版」;重录后时间戳与音频同步
08边界:这一轮明确不做什么
  • 不动代码——本规格先请古老师点头,点头后也只先做 M1;
  • 不重写录入端与合成器——它们是活系统,中枢只搬不拆;
  • 不做登录与权限系统——现阶段按 sharecode + 受众标注控制可见性,权限系统等有真实越权风险再建;
  • 不动主线——42 题录入、TZ-001/TZ-002 的施工节奏不被中枢打乱,中枢只收拢认知,不抢施工的道;
  • 不删任何旧文件——档案只追加,历史全部保留可回查。
09请古老师拍板的三件事(点头即动工)
#拍板项我的建议
1中枢名称:对外叫什么《心源 · 认知同步中枢》(内部文件名 index.html;董事会房间保留《…董事会视听汇报》原名,老董事不会有陌生感)
2根路径切换时机:大厅什么时候顶替合成器占根M2 完成自检后即切;合成器旧链接自动跳 /lab/,老用户无感
3音频策略:董事会版音频以后默认内嵌还是外链默认外链(文件轻、手机打开快),重录版提供内嵌下载——兼顾「随时听」和「秒开」
下一步(你点头后):M1 动工——抽真源 → 写 build_hub.py → 重建董事会版 → 自检 → 给你看「改一行数据、全网生效」的实测。