CSF

全景图 · CSF GitHub 仓库的发布与维护

版本: v1.0 | 最后修订: 2026-07-08 | 项目: csf-public 承载项目信息: 是（正文=项目实例，规则=框架规则） © 2025 zhanghui. CC BY-NC 4.0. https://github.com/huidev2025/CSF 一张图看清”从哪来、在哪、要去哪”。它是导航，不是进度汇报。 本文件自宿主：规则 + 模板（新项目拷贝即用）；正文 = 本项目实例。

规则（怎么改 + 纪律）

AI 天然会读图，所以规则只讲怎么改和纪律，不讲”怎么读”。

Token（最小集）

一个节点在三个正交维度上各取一值（生命周期 × 焦点 × 是否展开）：

Token 含义
⬜ 待开始
🔴 进行中 · 焦点 = 红点（每主体唯一）
🟡 进行中 · 非焦点（焦点节点的进行中父/祖先节点 / 并行旁线 / 打岔暂停的父线 / 搁置待续）
✅ 完成（终态）
⛔ 废弃（终态，与完成并列；附一句原因）
🧩 散点（选择不再展开的原子节点；无子树，读图时易被忽视）

结构关系 = 树形缩进 + 文字标签 + 一个并行记号： · 顺序（默认）：兄弟节点从上到下 = 时间序，不标记。 · 并行：节点前缀 ‼️ = 不参与时序；同级所有 ‼️ 节点自动属同一并行组（新并行线随时加一个 ‼️ 即可，无需预先成组）。 · 打岔：打岔（原因） + 子线 + 打岔结束 → 回归 [节点] 或 打岔结束 → 计划变迁（原因）。 · 时间断点 // ─── 日期：原因 ───；叙事 （备注）。

红点唯一：全树同一时刻只有一个 🔴（当前焦点叶子）；红点的进行中父/祖先节点（含打岔点）一律 🟡。焦点降到子节点时，父节点由 🔴 降为 🟡。

五操作（怎么改）

  1. 起（冷启动）— 新项目建本文件：写 GP + 已知首批节点（⬜）。
  2. 写未来（立项）— 在红点右侧/下方追加计划节点（⬜）。完整规程见 protocols/立项协议.md。
  3. 跟踪（状态更新）— 红点移动时改 token（🔴 → ✅，🔴 前移）；打岔 / 变迁 / 废弃如实标注 + 一句原因。
  4. 删减同步（两层对账）— cos-context 删内容时，回查本图是否漏跟（漏记是大概率事件）。
  5. 事后整理（散点 → 主题）— 懒散推进产生的散点，事后按主题理成条理。须向 Owner 汇报并获确认。

四纪律

  1. 历史追加不删 — 红点左侧是事实，只追加、只改 token 降级，不删内容；做两遍就记两遍。唯一例外：Owner 明确要求删。
  2. 节点 ↔ 会话 — 历史层一会话 ≤ 1 节点；计划层可自由多节点。
  3. 两层同步 — 全局版（本文件，求全，只增不减）不得滞后于实际进展；§B 缩略版（cos-context，求精，随焦点滚动）可滞后。
  4. 事后整理需确认 — 散点整理改变的是呈现结构，须 Owner 拍板，不是静默重写历史。

建模，不是规定：以上是”你可以这样表达”。画多细、分不分层、标不标废弃，因项目、因人而异。

模板骨架（含体例范例 · 看图可学）

下面一张图用最少体例演示全部结构关系：并行 / 顺序 / 打岔 / 回归 / 废弃 / 变迁。

# 全景图 · {项目名}
> 版本: v1.0 | 创建: @coslog-NNN | 最后更新: @coslog-NNN | 项目: {项目名} | 红点: {焦点叶子}

GP: {项目名} — {总目标}
│
├─ ✅ SP-1 {奠基阶段}
│
├─ ‼️🟡 SP-2 {独立并行线}                    ← 并行：‼️ = 不参与时序；同级所有 ‼️ 自动同组
│   └─ ⬜ TP {待推进}
│
└─ 🟡 SP-3 {主线阶段}                        ← 焦点在子节点 → 父节点 🟡
    ├─ ✅ TP-1 {第一步}                       ← 顺序：一步接一步
    ├─ ✅ TP-2 {第二步}
    │   └─ 打岔（原因：需先修前置 X）          ← 打岔：暂停主线、开出有依赖的子线
    │       ├─ ✅ TP-2a {前置子计划}
    │       └─ 打岔结束 → 回归 [TP-3]         ← 回归：子线完成，焦点回到父线下一步
    ├─ 🔴 TP-3 {当前焦点}                     ← 全树唯一红点（焦点叶子）
    ├─ ⛔ TP-4 {原方案}（废弃：前提失效）       ← 废弃：生命周期终态，与 ✅ 并列
    │   └─ 打岔（原因：验证老方案）
    │       ├─ ✅ TP-4a {验证}
    │       └─ 打岔结束 → 计划变迁 → TP-5      ← 变迁：不回原点，转向新方向（原节点转 ⛔）
    └─ ⬜ TP-5 {新方向}

读法：向下 = 时间前进，向右 = 结构衍生；红点两侧——左/上是事实（不改），右/下是计划（可调）。 拷贝到新项目时：留你用到的行，删示例行与 ← 注释。

体系资产（这套机制由哪些位置组成）

位置 管什么 何时读 / 改
本文件 · 头部 规则 + 模板（自宿主，拷贝即用） 改全景图规则时
本文件 · 正文 本项目实际全景图（全局版，只增不减） 立项 / 跟踪 / 收尾
cos-context §B 缩略版——随焦点滚动的工作地图 每会话
protocols/立项协议.md 立项 =「写未来」的完整规程 立项时
theory/全景图-demo.md 复杂项目范例（拿不准写法时照着写） 按需

正文 · 本项目全景图

GP: CSF GitHub 仓库的发布与维护 — 开源 CSF 体系，帮助有需要的人
│
├─ ✅ S1 基础建设
│   ├─ ✅ csf-minimal 三件套
│   ├─ ✅ 引言 v3 + 英文版宣言
│   ├─ ✅ v1.0.0 发布 + SEO ①②③
│   ├─ ✅ essays/ + Pages + visuals/
│   └─ ✅ case-v3 + paper1
│
├─ ✅ S2 csf-lite 开源
│   ├─ ✅ csf-lite 框架上线 + 介绍页
│   ├─ ✅ clarity-dev 源码入库
│   ├─ ✅ Clarity 说明页面
│   └─ ✅ Release 自举包指引
│
├─ 🔴 S3 外部推广
│   ├─ ⬜ SEO 路径 ④ 外部信号
│   └─ ⬜ SEO 路径 ⑤ 首篇专栏文章
│
└─ ⬜ S4 后续演进
    ├─ ⬜ csf-full 发布
    └─ ⬜ 社区运营
This site is open source. Improve this page.