chore(lyra): 初始化模块

- 创建独立 Go module

AGENTS.md

@@ -6,27 +6,33 @@
 
 | 目录 | 说明 |
 |---|---|
-| `go/` | Go module `lab`（Go 1.26.2），go.mod 在该目录内 |
+| `go/` | Go 代码：`practice/` 是共用 module（`module lab`）的练习区，`projects/` 各项目为独立 module |
 | `note/` | 个人笔记（非代码），`note/项目/` 被 gitignore |
 | `dart/` | 预留，尚未建立 |
 
 ## Go 约定
 
-- **Module 在 `go/` 目录下，不在仓库根**——所有 go 命令需在 `go/` 内执行
+- Go 代码集中在 `go/`，目录本身不是 module，按用途分两区：
-- 每个叶子目录 = 一个独立小程序（`package main` + `main.go`）
+  - `go/practice/`——共用 module 的练习区，`go.mod` 在该目录内（见 [go/practice/README.md](go/practice/README.md)）
-- 多个小程序可并存，不同目录、各自独立
+  - `go/projects/<项目名>/`——每个项目一个独立 module，自带 `go.mod`（见 [go/projects/README.md](go/projects/README.md)）
-- 主题目录（basics/concurrency/stdlib/patterns/algorithms/web/testing/project）可随时增删
+- **go 命令在对应 module 的根目录执行**：练习代码在 `go/practice/` 内执行；projects 每个项目在自己的目录内执行
-- 测试文件用 `*_test.go`，运行单个测试：`cd go && go test ./testing/ -run TestSliceAppend`
+- 练习区中每个叶子目录通常是一个独立小程序（`package main` + `main.go`），多个小程序并存互不冲突；库包（如算法实现）与只有测试文件的包也是合法形态
+- 主题目录可随时增删；写新程序时挑最贴的主题，在里面建一个新子目录
+- 测试文件用 `*_test.go`，运行单个测试：`cd go/practice && go test ./testing/slice -run TestSliceAppend`
 
 ## 开发命令
 
 ```
-# Go——所有命令在 go/ 目录下执行
+# Go 练习——在 go/practice/ 目录下执行
-cd go
+cd go/practice
-go run ./<主题>/<程序名>/       # 运行单个程序
+go run ./basics/runtime/        # 运行单个程序
-go test ./...                  # 运行全部测试
+go test ./...                   # 运行全部测试（部分练习阻塞/依赖环境，不保证全过）
-go test ./testing/ -v          # 运行 testing 包测试
+go test ./testing/... -v        # 运行 testing 包及其子包测试
-go mod tidy                    # 整理依赖
+go mod tidy                     # 整理依赖
+
+# Go projects——在 go/projects/<项目名>/ 各自目录下执行
+go run .                        # 运行项目（按实际入口调整）
+go mod tidy                     # 整理依赖
 ```
 
 ## 注意事项

README.md

@@ -4,7 +4,7 @@
 
 ## 当前语言
 
-- `go/` — Go（共用一个 module，约定见 [go/README.md](go/README.md)）
+- `go/` — Go（分 `practice/` 练习区与 `projects/` 项目区，约定见 [go/README.md](go/README.md)）
 - `dart/` — Dart
 - `ts/` — TypeScript / JavaScript（每个实验独立 npm 项目，约定见 [ts/README.md](ts/README.md)）
 

go/README.md

@@ -1,24 +1,14 @@
-# Go 练习区
+# Go
 
-本目录是 Go 的学习 / 练手代码，共用一个 module（`go.mod` 在本目录）。
+本目录按用途分两个区，`go/` 本身不是 module：
 
-## 约定
+| 目录 | 定位 |
-
-- **每个叶子目录 = 一个独立小程序**：`package main` + `main.go`。
-- 多个小程序并存互不冲突（不同目录、各自的 `main`）。
-- 某个程序依赖太特殊时，可在它自己的目录单独 `go mod init`，脱离本 module。
-
-## 主题目录
-
-| 目录 | 放什么 |
 |---|---|
-| `basics/` | 语法基础、内置类型（slice / map / chan 行为等） |
+| [`practice/`](practice/README.md) | 练习区：共用一个 module（`go.mod` 在 `practice/` 内），语法 / 算法 / 测试等日常练手代码 |
-| `concurrency/` | 并发：goroutine / channel / select / context |
+| [`projects/`](projects/README.md) | 项目区：每个子目录是独立 module 的完整小应用，自带 `go.mod`、自行管理依赖 |
-| `stdlib/` | 标准库练习（net/http、encoding/json、io…） |
-| `patterns/` | 设计模式 |
-| `algorithms/` | 数据结构与算法 |
-| `web/` | net/http、Gin 等框架 |
-| `testing/` | 练习 Go 测试机制（`*_test.go`、`go test`、table-driven、testify） |
-| `project/` | 完整小项目（多文件） |
 
-> 主题目录可随时增删。写新程序时挑最贴的主题，在里面建一个新子目录放 `main.go` 即可。
+## 边界
+
+- 写小段代码验证语言行为、练语法和标准库 → 放 `practice/` 对应主题目录。
+- 程序长成完整应用，或依赖需要独立于练习区管理 → 在 `projects/` 下新建目录，单独 `go mod init`。
+- 两个区互不包含：`practice/` 的 module 不覆盖 `projects/`，每个 projects 项目也是独立 module。

go/practice/README.md

@@ -0,0 +1,35 @@
+# practice — 练习区
+
+共用一个 module 的练手代码：`go.mod` 在本目录（`module lab`），所有日常练习都放这里。两区定位见 [../README.md](../README.md)。
+
+## 约定
+
+- 每个小程序 = 一个子目录：`package main` + `main.go`，多个小程序并存互不冲突（不同目录、各自的 `main`）。
+- 库包与测试包同样是合法形态：算法实现可以只提供库（如 `algorithms/linkedlist/`），`testing/` 下多为只有 `*_test.go` 的测试包。
+- 测试文件用 `*_test.go`，与被测代码同目录或独立成子包均可。
+- 程序长成完整应用、依赖需要独立管理时，移到 [`../projects/`](../projects/README.md) 单独 `go mod init`。
+
+## 当前主题
+
+| 目录 | 放什么 |
+|---|---|
+| `basics/` | 语法基础、内置类型行为（slice/map、runtime、pprof、goroutine 泄漏等） |
+| `algorithms/` | 数据结构与算法（含可复用的库包，如 `linkedlist/`） |
+| `testing/` | 练习 Go 测试机制，按点分子包：table-driven、regexp、net、crypto、json、error 等 |
+
+主题目录可随时增删：想练并发、标准库、设计模式、Web 时，直接新建 `concurrency/`、`stdlib/`、`patterns/`、`web/` 等目录即可。
+
+## 常用命令
+
+以下示例从仓库根目录开始执行：
+
+```bash
+cd go/practice
+go run ./basics/runtime/                          # 运行单个程序
+go test ./...                                     # 运行全部测试（不保证全过，见下方说明）
+go test ./testing/... -v                          # testing 包及其子包的全部测试
+go test ./testing/slice -run TestSliceAppend -v   # 运行单个测试
+go mod tidy                                       # 整理依赖
+```
+
+> 注意：练习代码中含阻塞（如 channel 永久等待）或依赖环境（如反向 DNS）的测试示例，`go test ./...` 不保证全部通过；验证单个练习可用 `go test ./testing/slice -run TestSliceAppend`。

go/projects/README.md

@@ -0,0 +1,27 @@
+# projects — 独立 module 项目区
+
+每个子目录是一个**完全独立的 Go module**，用于完整的小应用：自带 `go.mod`、自行管理依赖，与 [`../practice/`](../practice/README.md) 的共用 module 互不影响。是否该放这里见 [../README.md](../README.md)。
+
+## 新建项目
+
+以下命令从仓库根目录开始执行：
+
+```bash
+mkdir go/projects/myapp && cd go/projects/myapp
+go mod init example.com/myapp
+```
+
+`example.com/myapp` 仅为示例，需替换：本地练手可任意取名；打算对应真实仓库时按实际路径选择（如 `github.com/<用户名>/lab/go/projects/myapp`）。
+
+之后按需创建 `main.go`（或 `cmd/<名>/main.go` 等布局）即可，不需要额外脚手架。
+
+## 运行与维护
+
+Go 命令一律在**该项目自己的目录**（module 根）下执行；以下示例从仓库根目录开始：
+
+```bash
+cd go/projects/myapp
+go run .          # 运行（按项目实际入口调整）
+go test ./...     # 运行测试
+go mod tidy       # 整理依赖
+```

go/projects/lyra/go.mod

@@ -0,0 +1,3 @@
+module lyra
+
+go 1.27.1