Skip to content

docs(search): 拼音召回 — 明确 sys_user/选人器覆盖与存量数据回填(#2486 文档补遗)#3057

Merged
os-zhuang merged 1 commit into
mainfrom
claude/vibrant-euler-of05nx
Jul 16, 2026
Merged

docs(search): 拼音召回 — 明确 sys_user/选人器覆盖与存量数据回填(#2486 文档补遗)#3057
os-zhuang merged 1 commit into
mainfrom
claude/vibrant-euler-of05nx

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

#3034 合并后的文档补遗:回答读者(以及维护者实际问到的)两个已有文档没写清的问题。

补充内容(2 个文件,+18 行,纯文档)

queries.mdx → Pinyin recall 小节新增两段:

  • Coverage:所有带可解析名称字段的对象都有伴随列,明确包括 sys_user —— 选人器只发 $search,零配置即可拼音搜人;经任何写路径(sign-up / 管理员改名 / engine 写入)创建的用户立即可搜。
  • 存量数据:开关首次开启后的下一次启动自动分批幂等回填;运行期绕过 hook 的批量导入可用 @objectstack/plugin-pinyin-search 导出的 rebuildSearchCompanion 按需重建。

environment-variables.mdx → Search 章节:同样补一段 sys_user 覆盖 + 回填说明,并互链到 queries 文档。

依据(非推测,已实测)

在最新 main 的 showcase 真机上验证过:通过 better-auth sign-up 注册中文名用户"张伟",行上 __search 立即物化为 "zhangwei zw",$search=zhangwei / zw 无需重启即命中;管理员把用户改名为"王小明"后 wxm / wangxiaoming 同样立即命中。

纯文档改动,无需 changeset。

Refs #2486, #3027, #3034, ADR-0097

🤖 Generated with Claude Code

https://claude.ai/code/session_01RMugRriiNv3nsnmLczfhuY


Generated by Claude Code

…existing-row backfill

Answers the two questions the merged docs left open (#2486): whether the
people picker (sys_user) is covered automatically (yes — verified against a
live showcase: sign-up, admin rename, and engine writes are all searchable
immediately), and how pre-existing rows get their companion value (automatic
paged backfill on the first boot after the switch turns on;
rebuildSearchCompanion for hook-bypassing bulk imports).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RMugRriiNv3nsnmLczfhuY
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jul 16, 2026 12:39pm

Request Review

@github-actions github-actions Bot added size/s documentation Improvements or additions to documentation and removed size/s labels Jul 16, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 16, 2026 12:44
@os-zhuang
os-zhuang merged commit 8bb3f51 into main Jul 16, 2026
14 of 15 checks passed
@os-zhuang
os-zhuang deleted the claude/vibrant-euler-of05nx branch July 16, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants