# Features — xiangqin 功能清单

最后更新：2026-04-23

每个功能是**一等公民**：一份 FEAT-NNN.md 记录 user story / acceptance / 测试映射 / CLI-API 位置。模板见 [_template.md](./_template.md)。

## 功能树（按 domain）

### auth 认证
- ✅ [FEAT-001 register](./auth/FEAT-001-register.md) — 手机号注册 + SMS 验证码
- ✅ [FEAT-002 verify](./auth/FEAT-002-verify.md) — 验证码换 session
- ✅ [FEAT-003 logout](./auth/FEAT-003-logout.md) — 登出
- ✅ [FEAT-004 me](./auth/FEAT-004-me.md) — 查当前登录态

### profile 资料
- ✅ [FEAT-005 set](./profile/FEAT-005-set.md) — 设置字段（gender/age/city/height/education/tags/bio + agent-gateway）
- ✅ [FEAT-006 show](./profile/FEAT-006-show.md) — 查看自己资料
- ✅ [FEAT-007 clear](./profile/FEAT-007-clear.md) — 清空可空字段
- 🚧 [FEAT-008 avatar](./profile/FEAT-008-avatar.md) — 头像上传（issue #015 做中）
- 📋 [FEAT-009 album](./profile/FEAT-009-album.md) — 相册（issue #015 做中）

### query 查询
- ✅ [FEAT-010 where-dsl](./query/FEAT-010-where-dsl.md) — 受限 WHERE DSL 查匹配

### envelope 信封
- ✅ [FEAT-011 state](./envelope/FEAT-011-state.md) — 查余量 + 今日免费剩余
- ✅ [FEAT-012 buy-mock](./envelope/FEAT-012-buy-mock.md) — mock 买信封（不扣钱）
- 📋 [FEAT-013 buy-real](./envelope/FEAT-013-buy-real.md) — 真付（支付宝 issue #013）

### dm 发信
- ✅ [FEAT-014 send](./dm/FEAT-014-send.md) — 发私信（消耗信封）
- ✅ [FEAT-015 sent-history](./dm/FEAT-015-sent-history.md) — 查发出的信
- ✅ [FEAT-016 show](./dm/FEAT-016-show.md) — 看单条详情 / 5 维状态

### inbox 收件箱
- ✅ [FEAT-017 list](./inbox/FEAT-017-list.md) — 收件箱列表（未读标记）
- ✅ [FEAT-018 show](./inbox/FEAT-018-show.md) — 看单信 + 自动标已读
- ✅ [FEAT-019 reply](./inbox/FEAT-019-reply.md) — 回信（消耗信封）
- ✅ [FEAT-020 delete](./inbox/FEAT-020-delete.md) — 软删（30 天保留）
- ✅ [FEAT-021 report](./inbox/FEAT-021-report.md) — 举报（入库，审核流程 #016）

### moderation 审核 / 管理
- ✅ [FEAT-022 block](./moderation/FEAT-022-block.md) — 用户间单向拉黑
- ✅ [FEAT-023 unblock](./moderation/FEAT-023-unblock.md) — 解除拉黑
- ✅ [FEAT-024 blocklist](./moderation/FEAT-024-blocklist.md) — 查我拉黑了谁
- 📋 [FEAT-025 user-ban](./moderation/FEAT-025-user-ban.md) — 平台封号（issue #017）

### cli 工具层
- ✅ [FEAT-026 version-check](./cli/FEAT-026-version-check.md) — 自动新版本提示（stderr）
- ✅ [FEAT-027 health](./cli/FEAT-027-health.md) — 服务端健康检查

## 状态总览

- **done** 22 个（v0.4.5 已上线）
- **in_progress** 1（FEAT-008 avatar）
- **planned** 4（FEAT-009 album / FEAT-013 buy-real / FEAT-025 user-ban）
- **deprecated** 已下线见 [archive/](./archive/index.md)（exposure 付费置顶系列）

## 关联

- 工作队列 → [../issues/index.md](../issues/index.md)
- 用户场景 → [../scenarios/index.md](../scenarios/index.md)
- 整体设计 → [../blueprints/](../blueprints/)
