# lucasshyc/howtolivebetter architecture

> Architecture diagram of the GitHub repository lucasshyc/howtolivebetter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lucasshyc/howtolivebetter
- Repository: https://github.com/lucasshyc/howtolivebetter

## Overview

这是一本中文人生决策指南，主要交付按成本、收益和证据等级组织的建议，覆盖健康、生活资源、法律风险、家庭与人生阶段等主题。读者可从在线检索页按关键词、章节和筛选条件找到条目；也可按章节阅读，或让 AI skill 检索正文后按书中方法回答。README 说明检索页直接取用 book/ 正文、无需后端；本图据此呈现内容与使用方式。未采样 index.html 与 skill 源码，因此其内部实现细节未展开。

Main entry points: [`skills/life-decision-guide/SKILL.md`](https://github.com/lucasshyc/howtolivebetter/blob/main/skills/life-decision-guide/SKILL.md) (决策指南 Skill), [`index.html`](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html) (条目检索), [`book/01-不要早死.md`](https://github.com/lucasshyc/howtolivebetter/blob/main/book/01-%E4%B8%8D%E8%A6%81%E6%97%A9%E6%AD%BB.md) (健康与安全), [`book/03-不要浪费精力.md`](https://github.com/lucasshyc/howtolivebetter/blob/main/book/03-%E4%B8%8D%E8%A6%81%E6%B5%AA%E8%B4%B9%E7%B2%BE%E5%8A%9B.md) (时间金钱精力)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["指南内容"]
  node_book_health["健康与安全<br/>[01-不要早死.md]"]
  node_book_resources["时间金钱精力<br/>[03-不要浪费精力.md]"]
  node_book_law["法律与财产<br/>[08-别把自己搭进去.md]"]
  node_book_life["家庭与人生阶段<br/>[10-恋爱和结婚划不划算.md]"]
  node_longreads["专题长文<br/>[结婚划不划算.md]"]
end

subgraph group_web["在线检索"]
  node_webpage["检索页面<br/>[index.html]"]
  node_search["条目检索<br/>[index.html]"]
  node_filters["条件筛选<br/>[index.html]"]
  node_entry_view["条目阅读<br/>[index.html]"]
  node_crosslinks["条目互链<br/>[index.html]"]
end

subgraph group_assistant["AI 阅读"]
  node_skill["决策指南 Skill<br/>[SKILL.md]"]
  node_skill_guide["Skill 使用说明<br/>[README.md]"]
end

node_reader(("读者"))

node_reader -->|"打开检索"| node_webpage
node_webpage -->|"提供检索"| node_search
node_search -->|"查找正文"| node_book_health
node_search -->|"查找正文"| node_book_resources
node_search -->|"查找正文"| node_book_law
node_search -->|"查找正文"| node_book_life
node_reader -->|"设置条件"| node_filters
node_filters -->|"筛选条目"| node_entry_view
node_entry_view -->|"显示指路"| node_crosslinks
node_reader -->|"提问"| node_skill
node_skill -->|"查找条目"| node_book_health
node_skill -->|"查找条目"| node_book_resources
node_skill -->|"查找条目"| node_book_law
node_skill -->|"查找条目"| node_book_life
node_skill -.->|"读取专题"| node_longreads
node_skill -->|"回答并引用"| node_reader
node_reader -->|"阅读专题"| node_longreads
node_skill_guide -->|"说明安装"| node_skill

click node_book_health "https://github.com/lucasshyc/howtolivebetter/blob/main/book/01-%E4%B8%8D%E8%A6%81%E6%97%A9%E6%AD%BB.md"
click node_book_resources "https://github.com/lucasshyc/howtolivebetter/blob/main/book/03-%E4%B8%8D%E8%A6%81%E6%B5%AA%E8%B4%B9%E7%B2%BE%E5%8A%9B.md"
click node_book_law "https://github.com/lucasshyc/howtolivebetter/blob/main/book/08-%E5%88%AB%E6%8A%8A%E8%87%AA%E5%B7%B1%E6%90%AD%E8%BF%9B%E5%8E%BB.md"
click node_book_life "https://github.com/lucasshyc/howtolivebetter/blob/main/book/10-%E6%81%8B%E7%88%B1%E5%92%8C%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md"
click node_longreads "https://github.com/lucasshyc/howtolivebetter/blob/main/docs/%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md"
click node_webpage "https://github.com/lucasshyc/howtolivebetter/blob/main/index.html"
click node_search "https://github.com/lucasshyc/howtolivebetter/blob/main/index.html"
click node_filters "https://github.com/lucasshyc/howtolivebetter/blob/main/index.html"
click node_entry_view "https://github.com/lucasshyc/howtolivebetter/blob/main/index.html"
click node_crosslinks "https://github.com/lucasshyc/howtolivebetter/blob/main/index.html"
click node_skill "https://github.com/lucasshyc/howtolivebetter/blob/main/skills/life-decision-guide/SKILL.md"
click node_skill_guide "https://github.com/lucasshyc/howtolivebetter/blob/main/skills/life-decision-guide/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_book_health,node_book_resources,node_book_law,node_book_life,node_longreads toneBlue
class node_webpage,node_search,node_filters,node_entry_view,node_crosslinks toneAmber
class node_skill,node_skill_guide toneMint
class node_reader toneIndigo
```

## Components

### 指南内容

- [健康与安全](https://github.com/lucasshyc/howtolivebetter/blob/main/book/01-%E4%B8%8D%E8%A6%81%E6%97%A9%E6%AD%BB.md): `book/01-不要早死.md`
- [时间金钱精力](https://github.com/lucasshyc/howtolivebetter/blob/main/book/03-%E4%B8%8D%E8%A6%81%E6%B5%AA%E8%B4%B9%E7%B2%BE%E5%8A%9B.md): `book/03-不要浪费精力.md`
- [法律与财产](https://github.com/lucasshyc/howtolivebetter/blob/main/book/08-%E5%88%AB%E6%8A%8A%E8%87%AA%E5%B7%B1%E6%90%AD%E8%BF%9B%E5%8E%BB.md): `book/08-别把自己搭进去.md`
- [家庭与人生阶段](https://github.com/lucasshyc/howtolivebetter/blob/main/book/10-%E6%81%8B%E7%88%B1%E5%92%8C%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md): `book/10-恋爱和结婚划不划算.md`
- [专题长文](https://github.com/lucasshyc/howtolivebetter/blob/main/docs/%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md): `docs/结婚划不划算.md`

### 在线检索

- [检索页面](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html): `index.html`
- [条目检索](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html): `index.html`
- [条件筛选](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html): `index.html`
- [条目阅读](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html): `index.html`
- [条目互链](https://github.com/lucasshyc/howtolivebetter/blob/main/index.html): `index.html`

### AI 阅读

- [决策指南 Skill](https://github.com/lucasshyc/howtolivebetter/blob/main/skills/life-decision-guide/SKILL.md): `skills/life-decision-guide/SKILL.md`
- [Skill 使用说明](https://github.com/lucasshyc/howtolivebetter/blob/main/skills/life-decision-guide/README.md): `skills/life-decision-guide/README.md`

### Other components

- **读者**

## Connections

- 读者 → 检索页面: 打开检索 (evidence: `README.md`)
- 检索页面 → 条目检索: 提供检索 (evidence: `README.md`)
- 条目检索 → 健康与安全: 查找正文 (evidence: `README.md`)
- 条目检索 → 时间金钱精力: 查找正文 (evidence: `README.md`)
- 条目检索 → 法律与财产: 查找正文 (evidence: `README.md`)
- 条目检索 → 家庭与人生阶段: 查找正文 (evidence: `README.md`)
- 读者 → 条件筛选: 设置条件 (evidence: `README.md`)
- 条件筛选 → 条目阅读: 筛选条目 (evidence: `README.md`)
- 条目阅读 → 条目互链: 显示指路 (evidence: `README.md`)
- 读者 → 决策指南 Skill: 提问 (evidence: `README.md`)
- 决策指南 Skill → 健康与安全: 查找条目 (evidence: `README.md`)
- 决策指南 Skill → 时间金钱精力: 查找条目 (evidence: `README.md`)
- 决策指南 Skill → 法律与财产: 查找条目 (evidence: `README.md`)
- 决策指南 Skill → 家庭与人生阶段: 查找条目 (evidence: `README.md`)
- 决策指南 Skill → 专题长文: 读取专题
- 决策指南 Skill → 读者: 回答并引用 (evidence: `README.md`)
- 读者 → 专题长文: 阅读专题 (evidence: `README.md`)
- Skill 使用说明 → 决策指南 Skill: 说明安装 (evidence: `README.md`)