Skip to content

docs(search)+seed(showcase): 拼音搜索文档 + showcase 中文种子数据(#2486 收尾)#3034

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

docs(search)+seed(showcase): 拼音搜索文档 + showcase 中文种子数据(#2486 收尾)#3034
os-zhuang merged 1 commit into
mainfrom
claude/vibrant-euler-of05nx

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

#3027(拼音搜索,ADR-0097)合并后的文档与示例收尾,三处小改动:

1. showcase 种子数据 —— 让功能开箱可演示

showcase 配了 zh-CN,拼音搜索自动点亮,但原 seed 数据里没有任何中文名称记录 —— 功能开着却演示不出来。新增中文客户 华宁科技 和联系人 张伟/王芳/李雷(带注释说明用途),选人器 / 列表快搜输 zhangwei / zw 即可命中。这也符合 Prime Directive #10 推论:不点亮一个 showcase 展示不了的能力。

2. content/docs/deployment/environment-variables.mdx

新增 "Search" 章节:OS_SEARCH_PINYIN_ENABLED 条目(默认值由 locale 推导、显式设置优先、门控范围:伴随列物化 + 插件加载,关闭时零成本)。

3. content/docs/data-modeling/queries.mdx

Full-Text Search 章节下新增 "Pinyin recall" 小节:何时点亮、zhangwei/zw 如何透明命中 CJK 名称、fields 语义 / searchableFields / 驱动均不变、相关性排序仍属 Tier-2。

验证

本地 fresh 启动 showcase:$search=zhangwei / zw / wf / huaning / hnkj 全部命中对应中文种子记录(同时验证了 seed 的 isSystem 写入路径经 hook/回填正确物化伴随列)。

无发布包代码变更(仅 docs + examples),无需 changeset。

Refs #2486, #3027, ADR-0097

🤖 Generated with Claude Code

https://claude.ai/code/session_01RMugRriiNv3nsnmLczfhuY


Generated by Claude Code

…strable out of the box (#2486)

Follow-ups to the merged pinyin-search feature (ADR-0097, PR #3027):

- environment-variables.mdx: new "Search" section documenting
  OS_SEARCH_PINYIN_ENABLED (locale-derived default, explicit override,
  what it gates).
- queries.mdx: "Pinyin recall" subsection under Full-Text Search — how
  zhangwei/zw match CJK names transparently, what stays unchanged.
- showcase seed: CJK-named account (华宁科技) and contacts (张伟/王芳/李雷)
  so the auto-enabled pinyin search is demonstrable in the picker and
  list quick-search instead of silently finding nothing.

Verified on a fresh showcase boot: $search=zhangwei/zw/wf/huaning/hnkj
all recall the seeded CJK records.

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 Ready Ready Preview, Comment Jul 16, 2026 8:17am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s labels Jul 16, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 16, 2026 08:26
@os-zhuang
os-zhuang merged commit 23fe280 into main Jul 16, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/vibrant-euler-of05nx branch July 16, 2026 08:26
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 size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants