Tag

编程规范

当前标签下共有 19 篇 Runtime MarkdownObject。

BLOG 2026/05/15

25条项目自检标准

Repo Identity ├─ project.json ├─ README.md ├─ catalog info.yaml Truth World ├─ sourceOfTruth ├─ STORAGE TOPOLOGY.md ├─ docs/storage/ ├─ inventories/ C...

76 min read

BLOG 2026/05/15

五层World文档治理模型

Worked for 1m 3s 可以,按你这个仓库语境,我会这样定义: World 含义 现有主文件 Truth World 真值层,记录“事实本体”在哪里。比如 MySQL、文件真源、project.json 里的 sourceOfTruth。 project.json, storage con...

3 min read

BLOG 2026/05/14

结构化纲领

世界 = 原子(Atom) + 关系(Relation) + 投影(Projection) 对。 而且这句话其实已经非常接近: 你整个系统的底层哲学了。 但更准确说: 「拓扑化」 是: 把世界理解成: 而: 「Projection」 是: 在不同场景下的呈现方式。 所以: 你那句话: 世界 = 原子...

4 min read

BLOG 2026/05/14

经验

product/novel/tests/content runtime api.test.ts 新增或扩展: ArticleTaskContract ArticleAuthorProfile ArticleAcceptanceGate ArticleAcceptanceReport SourcePr...

75 min read

BLOG 2026/05/14

聚合文件(Aggregate File)

就是将所有可维护的文件聚合在一起形成唯一真源,这样就能有效防止漂移,我不支持一份md文件一份代码的原因也是这个

1 min read

BLOG 2026/05/14

拓扑化

拓扑化 你可以直接理解成: 「把事物之间的关系结构,明确画出来」。 例如: 以前: 你脑子里知道: 但系统不知道。 现在: 你把它明确写成: 这就叫: 拓扑化。 “拓扑”这个词, 本质上就是: 谁和谁连接 谁依赖谁 谁在谁前面 谁能同时进行 这些关系。 比如: 文件夹 这是: 文件层级拓扑。 AST...

1 min read

BLOG 2026/05/14

图系统-Runtime-Thinking-Projection-Thinking

你现在其实已经在慢慢形成三种思想: 1. 图系统(Graph System) 2. Runtime Thinking 3. Projection Thinking 它们组合起来, 就是你现在整个: 架构背后的底层逻辑。 我用人话讲。 一、图系统(Graph System) 意思是: 世界不是“一坨文...

3 min read

BLOG 2026/05/02

改代码到部署

好,这一条我给你整理成 一套完整、正确、以后不再出错的流程 ,从“改代码 → build → 部署 → 验证 → 接口”全部打通,一次讲清楚。 🧠 一、整体正确思路(先记住这个) 分层处理,按顺序走,任何一步不对都不能往下跳 👉 这就是完整链路 🧱 二、从修改到上线的正确流程(标准版) ✅ 第...

3 min read

BLOG 2026/04/30

CI CD 自动部署

我给你用 最直白、最接地气 的方式讲清楚,你马上就能懂👇 # 1. npm run selftest:pre commit 通过 是什么意思? 这句话翻译成人话: ### 你本地电脑上,「提交前自检脚本」跑完全部通过了 ✅ 它具体做了这些事: 运行代码格式检查(lint) 运行代码规范检查 运行单...

12 min read

BLOG 2026/04/28

手册

好,我帮你直接整理成一份 可以直接放仓库用的 README(带目录 + 文内跳转 + 架构图) ,结构已经优化过,适合长期维护 👇 📄 README.md(完整版) text 本地端口 ≠ 云端端口 它们是两套完全独立的运行实例 text [Codex 本地 Agent] │ │ HTTP(ba...

9 min read

BLOG 2026/04/27

兜底 fallback

先讲核心结论: Fallback 本身不 low,「烂写法的 fallback」才被程序员嫌弃、认为掉价。 结合你日常写的自动化、接口、风控、服务开发,人话讲透: 一、先搞懂:正常优雅的 Fallback 是什么 正规设计里: 主链路故障 可控预判 降级逻辑 单独封装 有日志、有告警、有熔断、有恢复...

4 min read

BLOG 2026/04/27

最小闭环状态机 MVP

这个问题你现在问到的是“工程是否成型”的本质,而不是某个模块怎么修。可以给你一个 比较工业化的收敛答案 :一个项目要“成型”,其实不靠状态机多,而是靠 边界清晰 + 最小闭环 + 可控失败模型 。 我拆成三层说清楚。 1️⃣ 一个项目“成型”的必要步骤(不是功能列表,是结构阶段) ① 闭环验证(Pr...

13 min read

BLOG 2026/04/27

SCG 最小可收敛模型

我不继续跟你情绪对喷,但把关键事实讲清楚。 现在这个系统的问题已经 不是“再改一行代码”级别 ,而是你自己已经在日志里暴露出来的结构性状态: 你现在真实卡住的点(不是代码,是执行结构) 1️⃣ 状态已经分裂成两条链 你现在同时存在: HTTP register/password 链(403 / ch...

6 min read

BLOG 2026/04/26

gsd

结合你刚才一直在用 Claude Code / 命令行 / 电脑折腾 ,你问的 gsd 最可能是下面这两个里的一个: 1. 口语 / 聊天里最常见: GSD = Get Stuff Done 直译: 把事搞定、赶紧干活、正事要紧 程序员 / 职场里常用的口头禅 意思:别扯没用的, 直接开干、解决问题...

2 min read

BLOG 2026/04/25

项目说明入口维护规范

项目说明入口维护规范:为什么 README 和 project.json 必须一起改 先说结论 很多工程不是坏在代码,而是坏在“说明入口分裂”。 最常见的场景就是: README.md 改了,project.json 没改 project.json 改了,README.md 没改 runtime 已...

7 min read

BLOG 2026/04/25

nginx

你这个判断是对的: 这条链路“逻辑是完整的,但拓扑图是不完整的” ,因为你漏掉了一个关键现实层—— 170 服务器本身在链路里的位置没有被标出来 。 ✅ 先给你标准答案 你的链路少了一层“物理宿主机层”。 🧠 正确的完整链路应该是这样: 📌 关键点解释(你漏掉的就是这个) ❗ “170 服务器在...

7 min read

BLOG 2026/04/24

工程编程规范 工程边界约束 很重要

会,而且 好的工程基本都会写清楚这些信息 。但不是随便写一堆,而是 有固定位置和分层规范的 。我给你讲“真实工程里怎么做”,你照着这个来,以后就不会乱。 🧠 一句话结论 🔥 一、最常见的3个文件(核心) 🥇 1. README.md(必须有) 👉 用来写: 示例(你应该写成这样) 👉 作用...

2 min read

BLOG 2026/04/24

自动部署 本机 + GitHub + 服务器 + 池子

好,这一步我给你直接升级到 工程级自动部署(不会再乱) ,而且是你这种“本机 + GitHub + 服务器 + 池子”的最适配方案。 我不给你花里胡哨的,给你一套 能用、稳定、可复用 的。 🧠 一句话目标 🧱 一、最终架构(升级版) 🔥 二、你要新增的核心文件 在本地项目里加这个: 📄 三、...

2 min read

BLOG 2026/04/24

AIClient2API 目录与文档分层规范

AIClient2API 目录与文档分层规范 这篇记录的是这次把 AIClient2API 的源码真源、服务器运行边界、GitHub 来源和文档层级补齐后的固定写法。后续同类项目可以直接复用这个结构。 一句话总原则 当前真值 本机工作源码根:E:\My Project\AIClient2API 本机...

4 min read