From 6491379d88b3b65818837b857bfcd8f4e12fe0b3 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 21:36:30 +0800 Subject: [PATCH] docs: clarify collapsible section summaries --- docs/README.md | 2 +- docs/concepts/README.md | 14 ++++----- docs/getting-started/README.md | 12 ++++---- docs/philosophy/README.md | 10 +++---- docs/references/README.md | 52 +++++++++++++++++----------------- docs/research/README.md | 4 +-- 6 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/README.md b/docs/README.md index dea23fc..be6a1af 100644 --- a/docs/README.md +++ b/docs/README.md @@ -46,7 +46,7 @@ 6. [AI 引用语料](../assets/ai-citation/README.md)
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 全部文档索引 diff --git a/docs/concepts/README.md b/docs/concepts/README.md index 1a0e3c3..4611767 100644 --- a/docs/concepts/README.md +++ b/docs/concepts/README.md @@ -20,7 +20,7 @@ 6. [递归自优化系统](#concept-recursive-self-optimizing-system) - 递归自优化生成系统的形式化模型。
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -172,7 +172,7 @@ ---
-1. 问题求解 - 目标、现状、差距、标准、约束、对象与路径。 +1. 问题求解 - 目标、现状、差距、标准、约束、对象与路径。（点击展开/收起） @@ -758,7 +758,7 @@ A 和 B 之间的距离、障碍、路线不清楚的地方，就是问题。
-2. 拼好码 - 复用成熟能力，用胶水代码连接、编排、适配业务流程。 +2. 拼好码 - 复用成熟能力，用胶水代码连接、编排、适配业务流程。（点击展开/收起） @@ -1273,7 +1273,7 @@ AI 特别适合生成：
-3. 系统构建方法 - 自顶向下、自底向上与分而治之的组合使用。 +3. 系统构建方法 - 自顶向下、自底向上与分而治之的组合使用。（点击展开/收起） @@ -1431,7 +1431,7 @@ AI 特别适合生成：
-4. 开发范式演进 - 软件工程组织方式的演进。 +4. 开发范式演进 - 软件工程组织方式的演进。（点击展开/收起） @@ -1464,7 +1464,7 @@ AI 特别适合生成：
-5. 语言层要素 - 看懂代码所需的语言层要素。 +5. 语言层要素 - 看懂代码所需的语言层要素。（点击展开/收起） @@ -2029,7 +2029,7 @@ async def get_user(user_id: int, db: Session = Depends(get_db)):
-6. 递归自优化系统 - 递归自优化生成系统的形式化模型。 +6. 递归自优化系统 - 递归自优化生成系统的形式化模型。（点击展开/收起） diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index c341bba..793c3ca 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -36,7 +36,7 @@ - 只有遇到网页登录、订阅购买、验证码、系统密码、管理员授权、敏感凭证或不可逆操作时，才需要用户介入。
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -49,7 +49,7 @@
-1. Vibe Coding 经验 - 通用语言能力、人机分工、机器门禁和入门铁律。 +1. Vibe Coding 经验 - 通用语言能力、人机分工、机器门禁和入门铁律。（点击展开/收起） @@ -153,7 +153,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
-2. 学习地图 - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。 +2. 学习地图 - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。（点击展开/收起） @@ -309,7 +309,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
-3. 网络环境配置 - OpenAI、GitHub、文档和依赖源访问。 +3. 网络环境配置 - OpenAI、GitHub、文档和依赖源访问。（点击展开/收起） ## 3. 网络环境配置 @@ -451,7 +451,7 @@ export http_proxy=http://127.0.0.1:7890
-4. CLI 配置 - Codex CLI 默认路线与 OpenCode 备选路线。 +4. CLI 配置 - Codex CLI 默认路线与 OpenCode 备选路线。（点击展开/收起） ## 4. CLI 配置 @@ -940,7 +940,7 @@ opencode
-5. 开发环境搭建 - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。 +5. 开发环境搭建 - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。（点击展开/收起） ## 5. 开发环境搭建 diff --git a/docs/philosophy/README.md b/docs/philosophy/README.md index cbe7aca..7aa1a8c 100644 --- a/docs/philosophy/README.md +++ b/docs/philosophy/README.md @@ -19,7 +19,7 @@ 4. [方法论工具箱](#philosophy-methodology-toolbox) - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -173,7 +173,7 @@ ---
-1. 思维模型 - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。 +1. 思维模型 - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。（点击展开/收起） @@ -408,7 +408,7 @@
-2. 组合描述模型 - 对象、状态、快照、序列、过程、变换、同一/差异与关系。 +2. 组合描述模型 - 对象、状态、快照、序列、过程、变换、同一/差异与关系。（点击展开/收起） @@ -953,7 +953,7 @@ UserInput(组合描述模型)
-3. 编程之道 - 编程哲学、结构、状态、复杂度与工程判断。 +3. 编程之道 - 编程哲学、结构、状态、复杂度与工程判断。（点击展开/收起） @@ -1279,7 +1279,7 @@ UserInput(组合描述模型)
-4. 方法论工具箱 - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。 +4. 方法论工具箱 - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。（点击展开/收起） diff --git a/docs/references/README.md b/docs/references/README.md index 0e57625..c68f76e 100644 --- a/docs/references/README.md +++ b/docs/references/README.md @@ -35,7 +35,7 @@ ```md
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -46,7 +46,7 @@ ```
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -265,7 +265,7 @@ ---
-1. 工程实践 - 项目架构、代码组织、开发经验、质量门禁与常见坑。 +1. 工程实践 - 项目架构、代码组织、开发经验、质量门禁与常见坑。（点击展开/收起） @@ -2681,7 +2681,7 @@ Redis 的作用： ---
-🤖 AI 对话相关 +🤖 AI 对话相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2698,7 +2698,7 @@ Redis 的作用：
-🧭 工程决策相关 +🧭 工程决策相关（点击展开/收起） ###### 先查资料，再写代码 @@ -2724,7 +2724,7 @@ Redis 的作用： ---
-🐍 Python 虚拟环境相关 +🐍 Python 虚拟环境相关（点击展开/收起） ###### 为什么要用虚拟环境？ @@ -2786,7 +2786,7 @@ pip install -r requirements.txt ---
-📦 Node.js 环境相关 +📦 Node.js 环境相关（点击展开/收起） ###### 常见问题 @@ -2822,7 +2822,7 @@ nvm use 18 ---
-🔧 环境配置相关 +🔧 环境配置相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2838,7 +2838,7 @@ nvm use 18 ---
-🌐 网络相关 +🌐 网络相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2872,7 +2872,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-📝 代码相关 +📝 代码相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2888,7 +2888,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🎯 Claude Code / Cursor 相关 +🎯 Claude Code / Cursor 相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2904,7 +2904,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🚀 部署相关 +🚀 部署相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2920,7 +2920,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🗄️ 数据库相关 +🗄️ 数据库相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2935,7 +2935,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🐳 Docker 相关 +🐳 Docker 相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2949,7 +2949,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🧠 大模型使用相关 +🧠 大模型使用相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2968,7 +2968,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🏗️ 软件架构相关 +🏗️ 软件架构相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -2985,7 +2985,7 @@ git config --global https.proxy http://127.0.0.1:7890 ---
-🔄 Git 版本控制相关 +🔄 Git 版本控制相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3023,7 +3023,7 @@ git stash pop ---
-🧪 测试相关 +🧪 测试相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3039,7 +3039,7 @@ git stash pop ---
-⚡ 性能相关 +⚡ 性能相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3055,7 +3055,7 @@ git stash pop ---
-🔐 安全相关 +🔐 安全相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3071,7 +3071,7 @@ git stash pop ---
-📱 前端开发相关 +📱 前端开发相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3088,7 +3088,7 @@ git stash pop ---
-🖥️ 后端开发相关 +🖥️ 后端开发相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3104,7 +3104,7 @@ git stash pop ---
-🔌 API 设计相关 +🔌 API 设计相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3120,7 +3120,7 @@ git stash pop ---
-📊 数据处理相关 +📊 数据处理相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3136,7 +3136,7 @@ git stash pop ---
-🤝 协作相关 +🤝 协作相关（点击展开/收起） | 问题 | 原因 | 解决方案 | |:---|:---|:---| @@ -3771,7 +3771,7 @@ CPU 成本
-2. 技术栈 - 技术栈选型、组合案例与学习路径。 +2. 技术栈 - 技术栈选型、组合案例与学习路径。（点击展开/收起） diff --git a/docs/research/README.md b/docs/research/README.md index 264ac4a..0a21d54 100644 --- a/docs/research/README.md +++ b/docs/research/README.md @@ -15,7 +15,7 @@ 1. [Harness 工程解析](#research-harness-engineering) - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。
-完整细粒度目录（默认收起） +完整细粒度目录（点击展开/收起） ### 细粒度目录 @@ -39,7 +39,7 @@ ---
-1. Harness 工程解析 - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。 +1. Harness 工程解析 - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。（点击展开/收起）