docs: product-facing README; archive CST theory notes (0.9.34)

Rewrite the homepage for day-to-day use, move paper/eval drafts under
docs/archive, and add a docs index so theory no longer leads the project.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/README.md

@@ -0,0 +1,16 @@
+# 文档索引
+
+面向日常使用的说明。二进制名仍是 `cst-agent`，配置目录默认 `~/.config/cst-agent/`。
+
+| 文档 | 内容 |
+|---|---|
+| [env_openai.md](env_openai.md) | Provider、模型、API Key、环境变量 |
+| [parliament.md](parliament.md) | 多设备议会（Realm / 席位 / 同步） |
+| [workers.md](workers.md) | 后台任务、worker、job 完成报告 |
+| [webui.md](webui.md) | 内置 HTTP + SSE WebUI |
+| [plugins.md](plugins.md) | Skills、插件、MCP |
+| [compat.md](compat.md) | 平台兼容与验收清单 |
+| [README-windows.md](README-windows.md) | Windows 安装、沙箱、构建 |
+| [android.md](android.md) | Android / APK |
+| [windows_selftest.md](windows_selftest.md) | Windows 自测步骤 |
+| [archive/](archive/) | 历史设计笔记（非产品文档） |

docs/archive/README.md

@@ -0,0 +1,10 @@
+# 归档
+
+历史设计笔记与评测草稿，**不是**面向用户的产品文档，也不再作为论文素材维护。
+
+| 文件 | 说明 |
+|---|---|
+| `theory_tool_cst.md` | 早期工具调用确认流设计笔记 |
+| `eval_tool_cst.md` | 早期协议/夹具评测草稿 |
+
+日常使用请看仓库根目录 [README.md](../../README.md) 与同级其它 `docs/*.md`。

docs/archive/eval_tool_cst.md

@@ -1,9 +1,8 @@
 # Tool-loop CST 评测笔记（反哺论文素材）
 
-> 本文是 **CST-Agent** 侧的评测/案例记录，供写入 SD 主论文附录或独立 TR 时粘贴。  
-> **不**替代 [`SD/paper/sections/eval_zh.tex`](../../SD/paper/sections/eval_zh.tex) 中 Markdown→HTML 主实验。
+> **归档。** 早期评测草稿，已停止维护；请勿当作当前产品说明。
 
-理论锚点见 [theory_tool_cst.md](theory_tool_cst.md)。
+理论锚点见同目录 [theory_tool_cst.md](theory_tool_cst.md)。
 
 ## 命题分工
 

docs/archive/theory_tool_cst.md

@@ -1,5 +1,7 @@
 # Tool-loop CST：确认前沿推广到工具调用
 
+> **归档。** 早期设计笔记，已停止维护；请勿当作当前产品说明。见 [README.md](README.md)。
+
 ## 命题
 
 在 agent 工具环中，对模型输出做**确认流式转导**：只在 \(O_{\mathrm{conf}}\) 内不可逆地发射「可执行工具调用 / 可应用补丁 / 可提交会话状态」。相对「拼到合法 JSON 再执行」的缓冲基线，这能降低注意力饥渴导致的残缺工具帧（未闭合括号、半截 arguments）被过早执行或整轮失败的问题。

docs/compat.md

@@ -22,7 +22,7 @@ adds Homebrew's keg-only `ncurses`/`curl` to `PKG_CONFIG_PATH`; without
 Homebrew it falls back to the system `-lncurses` (wide-character capable).
 
 Verified so far: NixOS x86_64 with gcc, clang and TinyCC (`-Werror` except
-tcc, `make check`, `make asan`, ctest). CI (`.gitea/workflows/ci.yml`, restored)
+tcc, `make check`, `make asan`, ctest). CI (`.gitea/workflows/ci.yml`)
 checks with TinyCC and builds the static musl releases for x86_64, x86 and
 aarch64 with gcc `-Werror` (`make check` on both x86 targets, a qemu smoke
 test on aarch64). macOS and WSL are checked by hand with the list below.