docs: import product-definition docs alongside the front-end

.gitignore

@@ -1,6 +1,36 @@
-node_modules
-dist
-dist-ssr
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build outputs
+dist/
+dist-ssr/
+build/
+.next/
+out/
+*.tsbuildinfo
+
+# Environment
+.env
+.env.local
+.env.*.local
 *.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Editor / OS
 .DS_Store
-*.tsbuildinfo
+.idea/
+.vscode/
+*.swp
+*~
+
+# Misc
+.cache/
+coverage/
+*.tmp

README.md

@@ -1,8 +1,14 @@
-# rumu · 老树
+# 入木 · Rumu · 老树
 
-> 一个千年经典的活体年轮库:AI 长出土壤,人类在上面刻下署名的批注,时间让它们入木。
+> **千年经典的活体年轮库。AI 长出主干，人类刻下署名的年轮，时间让它们入木。**
+>
+> A living annotation grove for canonical books: AI grows the trunk, humans carve the rings, time drives them into the wood.
 
-不是读书 App,不是笔记工具,不是 AI 聊天产品 —— 更接近一座**可以走进去的、还在生长的碑林**。
+入木不是一个内容站,也不是一个论坛。不是读书 App,不是笔记工具,不是 AI 聊天产品——更接近一座**可以走进去的、还在生长的碑林**。在 AI 洪水里,仍然亲自读的人,在一句话的两千年里,留下自己那一圈不可磨灭的年轮。
+
+- **免登录看全部**:阅读、地层、故事,对所有人(和所有机器)开放。
+- **落笔有门槛**:抄经解锁 → 锚定选体 → 苏格拉底守门 → 时间与同侪确认「入木」。
+- **AI 只有结构,没有声音**:AI 长主干、做向导、挖故事、连图谱,但作者永不开口,AI 永不替你读书。
 
 This repository holds the 老树 product front-end: a shelf of books (`/`), each with
 its own biography (`/book/:id`) and one cultivated chapter to actually read
@@ -21,6 +27,20 @@ Two books are live:
 ghosts — not yet cultivated, per the product's own rule that emptiness should
 read as room to grow, not a bug to hide.
 
+## 文档
+
+产品的完整设计见 [`docs/`](./docs/):
+
+| 文档 | 内容 |
+|------|------|
+| [00 概览](./docs/00-overview.md) | 一页读懂入木 |
+| [01 愿景与命题](./docs/01-vision-and-thesis.md) | 为什么做、名字的含义、GEO 分发论题 |
+| [02 信息架构](./docs/02-information-architecture.md) | 免登录、时间书架、书籍传记页 |
+| [03 产品形态](./docs/03-product-form.md) | 阅读页、时间滑杆、句子房间、故事集 |
+| [04 AI 与 Agent](./docs/04-ai-and-agents.md) | AI 铁律、五个接入点、守树人 |
+| [05 社区与质量](./docs/05-community-and-quality.md) | 五层归属、留存玩法、倒逼优质评论 |
+| [06 设计委托书](./docs/06-design-brief.md) | 「墨字朱批」视觉系统(给设计的 prompt) |
+
 ## 我的树 (My Tree)
 
 Each reader grows a tree:
@@ -67,6 +87,7 @@ npm run preview  # serve the production build
 | `src/theme.css` | Design tokens (墨字朱批 palette), day/night themes, keyframes |
 | `APP_NOTES.md` | Detailed notes on 我的树 specifically |
 | `design/` | The original Claude Design handoff bundle — chat transcript + all page prototypes. |
+| `docs/` | Product definition: vision, information architecture, product form, AI rules, community, design brief. |
 
 ## Not yet built
 

docs/00-overview.md

@@ -0,0 +1,35 @@
+# 00 · 概览
+
+一页读懂入木（Rumu）。
+
+## 一句话
+
+千年经典的活体年轮库：AI 长出主干，人类刻下署名的年轮，时间让它们入木。
+
+## 核心机制（也是名字）
+
+全站唯一的地位叫「入木」。你的批注被时间和同侪确认，采入一句话的正式地层，与王弼、与 Le Guin 并列——「我成了这本书历史的一部分」。名字即激励系统：写得足够深，以至于沉进木头里。
+
+## 一个闭环
+
+AI 长出土壤 → 人往上刻年轮 → 年轮沉淀成个人档案 → 档案凝结成身份，而年轮同时通过两个出口（GEO 引用 + 卡片转发）把新读者拉回来。**流量和归属由同一个东西产生——那圈人的年轮。**
+
+这就是为什么「如何带来流量」和「如何产生归属感」是同一个问题。任何把两者拆开的做法，都会做成「内容站 + 挂了个论坛」的缝合体，那是这类项目的标准死法。
+
+## 三条铁律
+
+1. **免登录看全部**——读是自由的，说是有门槛的。门槛设在落笔，不设在门口。GEO 的前提是机器能爬到全部地层；登录墙 = 在 AI 引用时代自杀。
+2. **AI 只有结构，没有声音**——AI 长主干、做向导、挖故事、连图谱，但作者永不开口，AI 永不给结论、永不替你读书。给了 AI 声音，就进入价值坍塌区（人人都能让模型 cosplay 老子）。
+3. **慢是机制，不只是美学**——一季一书、跨年对话、抄经解锁、时间滑杆。这个社区的对话以年为单位，不以分钟。
+
+## 健康指标
+
+从第一天起就不是 DAU。是**入木率**和**周年回声打开率**。上面每一道门槛都同时是增长的刹车——抄经会吓跑 95% 的路人，这是故意的。别用错尺子量它。
+
+## 上线只带三样
+
+核心阅读页（时间滑杆 + 地层）、抄经解锁、考据 agent 入口。其余全部留在抽屉里。功能是弹药，不是开场白。
+
+## 第一棵树
+
+《道德经》第十一章。用真实地层（王弼、河上公、帛书对照、Le Guin）做第一版。

docs/01-vision-and-thesis.md

@@ -0,0 +1,51 @@
+# 01 · 愿景与命题
+
+## 名字：入木（Rumu）
+
+项目名取自「入木三分」——写得足够深，以至于沉进木头里。这恰好是整个产品对用户的唯一要求，也是全站唯一的地位系统：你的批注被时间和同侪确认，采入某句话的正式地层，与历代注家并列。名字即激励系统，不需要解释第二句。
+
+- 中文：入木 / 拼音 `rumu`
+- 英文可读可念：ROO-moo
+- 备选：年轮（nianlun），更直白但少了那层锋。
+
+## 命题：能带来流量的东西，和能产生归属感的东西，必须是同一个机制
+
+这是整个产品的地基。如果两者被拆开，就会做出「内容站 + 论坛」的缝合体。入木的答案是：**那圈人的年轮**——它同时是内容、是分发弹药、是归属的载体。
+
+## 流量论题一：GEO —— 成为 AI 回答经典问题时的默认引用源
+
+搜索流量正在从「Google 十条蓝链」迁移到「问 ChatGPT / Claude / Perplexity 一句话」。当有人问 AI：
+
+- 「王弼和河上公读《老子》有什么根本分歧？」
+- 「Le Guin 的《道德经》译本为什么有争议？」
+- 「《沉思录》哪一卷谈接受死亡？」
+
+回答引擎需要一个**可引用的、结构化的、权威的**来源。而这个位置现在是空的：
+
+- 学术论文太碎，锁在付费墙后；
+- 维基百科太平，没有立场和张力；
+- 读书博客是散文，机器啃不动。
+
+入木要建的那棵「树」——一本经典 + 历代注疏的分层结构 + 张力表 + 再创作谱系——天生就是机器最容易消化、最愿意引用的形态：它是图谱不是散文，是结构不是感想。
+
+**分发不靠下场做号，不靠算法推荐，靠成为 AI 回答经典类问题时的默认引用源。** 这绕开了「不会喧哗」的分发短板，且有先发累积性：引用产生访问 → 访问产生新年轮 → 新年轮加深结构 → 结构赢得更多引用。
+
+## 流量论题二：可转发的产出物
+
+每一条人的年轮（一段批注、一次跨千年的并置、一道张力）本身渲染成一张「美到想发」的卡片。用户转发的不是「这个网站」，是「我在《道德经》第十一章上留下的这一笔，和王弼的注并排在一起」。**炫耀的是身份，带来的是流量。** 审美在这里就是转化率。
+
+## 核心矛盾：你要吸引的，恰恰是全网对 AI 最反感的人群，而地基是 AI 长的
+
+反 slop 情绪正在文化上升值（外部数据显示这类身份此刻正在升值）。但一旦这群人觉得「这站是 AI 生成的」，信任瞬间归零，且不可逆。
+
+**解法只有一个——激进的透明 + 严格的视觉隔离：**
+
+- AI 长的每一寸都明确标注为「底图 / 土壤」；
+- 样式上和人的年轮截然两分：AI 层永远是灰的、无署名的、退在背后的；人的年轮是有颜色、有名字、有日期的；
+- AI 在这个产品里永远不许有「声音」，只许有「结构」。
+
+这条线守住，AI 是杠杆；守不住，它就是丑闻。
+
+## 需求切入点：带着人生问题进来
+
+没有人早上醒来想读《道德经》；人醒来时带着的是一段该不该结束的关系、一个不敢辞的职。**「带着人生问题进来」是这个产品最强的需求切入点。** 但方向要对：不是「skill 给你答案」，而是守树人接住你的问题，然后只做一件事——领你走进地层（见 [04 AI 与 Agent](./04-ai-and-agents.md)）。

docs/02-information-architecture.md

@@ -0,0 +1,47 @@
+# 02 · 信息架构
+
+## 读写分离：看是自由的，说是有门槛的
+
+- **免登录**：任何人（和任何机器）可以看到全部内容——阅读、地层、故事、年轮。这是命脉，不是可选项。GEO 要求机器能爬到全部地层；归属感产品的正确门槛结构永远是「门槛设在落笔，不设在门口」。
+- **登录换能力**：登录只用于解锁 AI 能力、深度对话、以及落笔（发表年轮）。身份换能力，读写分离。
+
+## 首页：时间书架（Lindy 书架），不是封面墙
+
+首页不是网格封面墙，也不是 feed。它是**一条跨越三千年的横轴**，每本书立在它诞生的年份上，书脊的厚度 = 累积的年轮密度。一眼看去，「时间」这个产品母题就说完了。
+
+排序原理：**越老、越多人读过的书越有价值。** 时间本身是筛选系统（Lindy 效应）——活得越久的文本，越值得往上刻。
+
+## 书籍单元：一本书 = 一个独立的、沿时间线生长的传记页
+
+产品的基本单位不是「文章」，是「那本书本身」。每本书有一个独立网页，是它的「主干」，从诞生走到今天：
+
+```
+诞生（成书）
+  → 历代注疏（王弼、河上公……）
+  → 出土 / 校勘事件（马王堆帛书、郭店竹简……）
+  → 翻译与再创作（Le Guin、Mitchell、Beatles……）
+  → 今天这个社区的年轮
+```
+
+一条垂直时间线走到底，每一站是一个 **StoryAtom**（见 [03 产品形态](./03-product-form.md#故事集)），每一站可以召唤 AI 深聊。
+
+## 优雅的入库逻辑
+
+一本新书第一次进入系统时，有一个优雅的输入处理管线：把原始材料编译为一个「优雅的书籍详情」——一个独立网页，沿时间线把后世名人与这本书的关联不断串起来，一直到今天，组成一个可以逐段与 AI 交互的页面。（编译管线复用 raw→wiki 的方法论，schema 换成 StoryAtom。）
+
+## 检索
+
+产品同时提供两套检索：
+
+1. **最前沿的 AI 产品形态**：自然语言追问、考据、跨文本连线（见 [04](./04-ai-and-agents.md)）。
+2. **传统的书籍筛选系统**：按时间轴、按年轮密度、按注疏谱系浏览。
+
+## 层级总览
+
+```
+时间书架（首页）
+└── 书籍传记页（主干 / 时间线）
+    └── 章 / 节（一屏一章）
+        └── 句（点开 = 一个「房间」）
+            └── 地层（注 / 译 / 帛书对照 / StoryAtom / 人的年轮）
+```

docs/03-product-form.md

@@ -0,0 +1,75 @@
+# 03 · 产品形态
+
+## 铁律：文本即界面，不做「内容站」
+
+一切内容站的死法都从「首页是个 feed」开始。首页不是列表，是一扇进入某本书的门。
+
+## 核心阅读页：原文做中轴，一切挂在字上
+
+以《道德经》为例——81 章，每章一屏。正文用衬线、大字、极大留白。**没有侧边栏、没有推荐位、没有任何 feed。** 这一屏只有五千字里的那几十个字。
+
+## 句子房间：点任何一句，展开成一个「房间」
+
+点一句，这一句展开成一个房间。房间里是这句话的**全部地层**，按时间纵向排列，像剖开的树干：
+
+- 王弼怎么注、河上公怎么注；
+- 帛书本原文有什么不同；
+- Le Guin 怎么译、Mitchell 怎么「篡改」；
+- 这个社区里的人留下的年轮。
+
+用户不是在「看评论区」，是在往一句话的两千年里下潜。
+
+## Signature：时间滑杆
+
+页面顶部一根轴，从公元前 300 年拖到 2026。
+
+- 拖到 250 年，页面上只剩王弼和之前的注；
+- 拖到 1973 之前，你看到的经文是通行本；
+- 拖过 1973（马王堆帛书出土），**经文本身发生变化**，变化的字高亮。
+
+「在不同的历史时刻读同一本书」——一个动作就把「书是活的、被时间加厚的」这个产品命题演示完了，天然是一段会被转发的录屏。
+
+**手感要求：慢而重、有阻尼**——像转动仪器，不像拖视频进度条。产品的气质藏在这种微小的物理感里。
+
+## 一屏的样子（文字稿）
+
+> 顶部一根时间轴；中央一章经文；点亮的那一句下方垂下一条地层——王弼的注、Le Guin 的译、一个今人署名的「证」依次排开；最底下一行小字：「抄录本章，获得落笔资格」。整屏再无他物。
+
+## 三个「想不到」（可独立传播的认知反差）
+
+1. **「这本书居然被改过」**——时间滑杆拖过 1973，经文变字（帛书出土，「德经」在「道经」之前，若干关键字不同）。经典不是死的、固定的，是活的、有伤口的。
+2. **「这句话居然有 14 层」**——一句「当其无，有之用」下面垂着两千年的地层。深度可视化本身就是奇观。
+3. **「居然有个 2026 年的人和王弼并排」**——一个普通读者的批注，署名，和历代注家排在同一条地层里。最强的行动召唤，一个字文案都不用写。
+
+每一层年轮、每一次并置，一键渲染成卡片（分享出口）。
+
+## 故事集
+
+### StoryAtom
+
+一本经典的传播史本身就是一座故事矿。处理方法复用 raw→wiki 编译管线，schema 换成：
+
+```
+StoryAtom = (人物, 时刻, 张力, 锚定的原文句, 来源)
+```
+
+AI agent 负责挖掘和初编（检索文献、抽取事实、生成结构化初稿）；人负责两件机器做不了的事：**判断哪个故事值得讲**，以及**最后那道人声的润笔**。
+
+每个 StoryAtom 锚在具体句子上。用户读到《道德经》第 47 章，右侧地层里就躺着「1968 年，乔治·哈里森把这一章唱进了一首歌」。
+
+### 《道德经》的富矿（示例）
+
+- 1973 年长沙马王堆汉墓改写经文；
+- 郭店竹简把成书时间又往前捅；
+- 托尔斯泰晚年翻译老子；
+- Beatles 的《The Inner Light》歌词直接改写自第 47 章；
+- Mitchell 不懂古汉语却出了最畅销英译，引发「翻译还是亵渎」的骂战；
+- Le Guin 花了几十年「重写」它。
+
+### 一份工，三头吃
+
+StoryAtom 有三重身份：**冷启动内容**（上线第一天不空）、**传播弹药**（每个故事天然是一条小红书 / X 帖子）、**GEO 饵料**（结构化、有出处，正是回答引擎最爱引用的形态）。
+
+## 交付顺序（锁死）
+
+先做**核心阅读页 + 句子房间**。时间滑杆是唯一的 signature，第一版做错它，后面全歪。第一版用《道德经》第十一章的真实地层（王弼、河上公、帛书对照、Le Guin）；占位的今人批注也必须写得像真的。