20:"$Sreact.view_transition" 21:I[9754,["/_next/static/chunks/2t36f5p4pjzlb.js","/_next/static/chunks/1gyqeidjm5eoa.js","/_next/static/chunks/0_fjnxc4tt_l_.js","/_next/static/chunks/1ymt1shyhmu-4.js","/_next/static/chunks/3kv2zf0i7s2wc.js","/_next/static/chunks/1vs_3g_g75zmk.js","/_next/static/chunks/2g4dh802s8oz3.js","/_next/static/chunks/1bc3f0shukf1j.js","/_next/static/chunks/192kgs9v_t14j.js","/_next/static/chunks/0z6pw0v5c_lx5.js","/_next/static/chunks/08r60e6icmtkc.js","/_next/static/chunks/3trx6c0i7_x-3.js","/_next/static/chunks/40sro5bzp9bi_.js","/_next/static/chunks/1wgf3tk38y6cf.js"],"ProjectDetail"] 22:T4da7, drf-haystack —— Haystack 与 Django REST Framework 的字段桥

Haystack × Django REST Framework

为 DRF API 架一座通往 Haystack 索引的字段桥

drf-haystack 是一条位于搜索索引与 Django REST Framework 之间的映射通道：每条搜索能力都被落实为一对字段映射，左边是索引里的字段，右边是 API 响应里的字段，中间由序列化器完成转译。

Python 库 /MIT / pip install drf-haystack 单命令接入

索引字段index

titleautocomplete

geolocationgeo

highlighted_texthighlight

category_facetfacet

textmore like this

API 字段response

suggestionautocomplete

distancegeo

highlighthighlight

facetsfacet

similarmore like this

桥接线箭头指向 API 侧 autocomplete能力标签 serializer 转录

中断处

搜索能力不该重新造一遍

索引侧

Haystack 索引 · 未整理

Haystack 把搜索结果组织成索引字段，但字段本身并不属于 API。做搜索想用它们，就要先把字段结构搬进 Django REST Framework 的世界。

serializer→mapping

API 侧

Django REST Framework · 序列化

DRF 靠序列化器和视图集定义响应结构。若没有那道映射，两个世界之间隔着一张需要手工反复抄录的表。

装配

两条零件，组成一座桥

01 / Serializer

字段转录

Serializer 把索引字段翻译成 API 响应里成型的内容，自动补全、高亮等各有其对应的字段出口。

haystack_serializer(fields="title", autocomplete_field)

02 / ViewSet

端点出口

ViewSet 把搜索通道接上视图层，让 DRF 视图把翻译好的字段作为响应交出去。

SearchViewSet(index_models=[...], serializer_class=...)

能力

每条能力都是一对字段

autocomplete → suggestion

自动补全

边输入边给出补全建议，本质是把索引里的 autocomplete 字段映射成 API 的 suggestion 字段。

index → api

geolocation → distance

地理空间搜索

把带坐标的索引字段映射为带距离的 API 字段，支持按位置约束结果范围。

index → api

highlighted_text → highlight

高亮

命中片段以高亮字段返回，让界面能把命中的关键词直接标出来。

index → api

category_facet → facets

分面

把索引里的可分面字段映射成 facets，用于对结果按类别或属性分组。

index → api

text → similar

相似推荐

借助索引里的文本字段映射出 similar 输出，提供“更多同类”的推荐。

index → api

接入

接入就是一条命令

pip install drf-haystack

install

定义 serializer 与 viewset

marshal 索引字段 → API 字段

现状

一座需要新守桥人的桥

项目在寻找新的维护者

原维护者已不再使用 drf-haystack，正寻找接手的开发者。当前仍在做最低限度的依赖更新，但若在 2026 年 1 月 1 日前无人接手，项目将按计划归档。

README #146 接手话题实验性 boost

正在使用的开发者被邀请接手

若你的项目正在使用 drf-haystack，付出维护投入就能决定这座桥能否延续。仓库与讨论见下方链接。

https://github.com/ulgens/drf-haystack

23:T4e5a, drf-haystack — a field bridge from Haystack indexes into Django REST Framework

Haystack × Django REST Framework

A field bridge from Haystack indexes into DRF APIs

drf-haystack is a mapping channel between your search index and Django REST Framework: every search capability becomes one field mapping — an index field on the left, an API field on the right, and a serializer doing the translation in between.

Python library /MIT / pip install drf-haystack to connect

Index fieldsindex

titleautocomplete

geolocationgeo

highlighted_texthighlight

category_facetfacet

textmore like this

API fieldsresponse

suggestionautocomplete

distancegeo

highlighthighlight

facetsfacet

similarmore like this

arrows point toward the API side autocompletecapability label serializer does the translation

The gap

Search capability should not be rebuilt

The index side

Haystack index · raw

Haystack organizes results into index fields, but those fields do not belong to an API. To use them in search, you first have to carry that field structure into the Django REST Framework world.

serializer→mapping

The API side

Django REST Framework · serialized

DRF defines response shape through serializers and viewsets. Without some mapping, the two worlds sit on opposite sides of a table you must keep copying by hand.

Assembly

Two parts make the bridge

01 / Serializer

Field translation

The serializer carries index fields into shaped API content, with autocomplete, highlighting, and friends each reaching their own field in the response.

haystack_serializer(fields="title", autocomplete_field)

02 / ViewSet

Endpoint outlet

A viewset connects that search channel to the view layer, letting DRF hand the translated fields back out as a response.

SearchViewSet(index_models=[...], serializer_class=...)

Capabilities

Every capability is a field pair

autocomplete → suggestion

Autocomplete

Suggestions as you type — an autocomplete index field mapped into a suggestion field on the API.

index → api

geolocation → distance

Geo spatial search

A coordinate-carrying index field maps to a distance-bearing API field, constraining results by location.

index → api

highlighted_text → highlight

Highlighting

Hit snippets return in a highlight field, so a UI can mark exactly which words matched.

index → api

category_facet → facets

Faceting

A facet-able index field maps to a facets output, so results can be grouped by category or attribute.

index → api

text → similar

More like this

A text index field maps to a similar output, offering you more of the same kind of result.

index → api

Getting started

Connecting is one command

pip install drf-haystack

Define a serializer and a viewset, and the library marshals index fields into API fields for you.

install

define serializer + viewset

marshal index fields → API fields

Stewardship

A bridge looking for a new keeper

The project is seeking new maintainers

The original maintainers no longer use drf-haystack and are handing the project to developers who do. Dependencies are still being kept current on a minimum basis, but without a new maintainer by January 1st 2026 the project plans to archive.

README #146 handover thread experimental boost

Developers who use it are invited to take over

If your project depends on drf-haystack, picking up maintenance decides whether this bridge keeps standing. The repository and discussion are linked below.

https://github.com/ulgens/drf-haystack

a:[["$","$20",null,{"enter":{"secondary-forward":"secondary-forward","secondary-back":"secondary-back-enter","default":"none"},"exit":{"secondary-forward":"secondary-forward","secondary-back":"secondary-back-exit","default":"none"},"update":{"secondary-forward":"secondary-forward","secondary-back":"secondary-back-update","default":"none"},"default":"none","children":["$","$L21","cmt2zh3i901td6271mqkfnb6b:zh-CN:beautified",{"project":{"id":"cmt2zh3i901td6271mqkfnb6b","slug":"ulgens-drf-haystack","name":"drf-haystack","description":"简化 Haystack 与 DRF 集成的库","authorName":"ulgens","authorVerification":{"verified":false,"verifiedAt":null},"category":"development_tools","subcategory":"developer_resources","experienceUrl":null,"qualityScore":53,"featured":false,"officialSite":null,"views":{"original":{"available":true},"official":{"available":false,"reason":"disabled_by_policy"},"beautified":{"available":true,"reason":null},"defaultView":"beautified"},"beautifiedView":{"revisionId":"cmt2zh3in01tp6271gcdr87z0","kind":"artifact","artifact":{"schemaVersion":"localized-static-html-v4","kind":"static_html","locales":["zh-CN","en"],"defaultLocale":"zh-CN","documents":{"zh-CN":"$22","en":"$23"},"designDirections":{"schemaVersion":"dodot-design-directions-v1","directions":[{"id":"bridge-field-mapping-v1","name":"Field Bridge — 两者的映射","projectMetaphor":"drf-haystack 是连接 Haystack 索引与 DRF API 的翻译桥：每条搜索能力都被落实为一对字段映射，左边是索引里的字段，右边是 API 响应里的字段，中间是序列化器完成的转译。","signatureVisual":"一条水平字段对账带：左列标注索引字段（title、geolocation、autocomplete），右列标注 API 字段，中间以带箭头的连接线把两栏字段一一勾连；每条连接线随能力不同具有不同端点形态（自动补全、分面、高亮、地理、相似推荐）。","heroGeometry":"双栏平行的字段映射横向分段，两个栏体等高对齐，中部由五条带箭头的桥接横向贯穿，每条桥接线顶部带一个能力标签。","sectionSequence":["hero-field-bridge","the-gap","serializer-and-viewset","search-capabilities","one-file-integration","maintainer-stewardship"],"surfaceModel":"两个并列的平面栏体之间由空气间隙隔开，桥接横线悬空跨越；栏体为实色平面，桥接线为单一描边，无投影堆叠。","palette":"冷炭基调（页面底色 07），暖琥珀描边（桥接线）压深灰蓝，字段标识用高对比白，能力标签用低饱和青绿作点状强调。","typography":"等宽体做字段名（体现 schema 语法），人文无衬线做正文；桥接标题用紧凑大写窄体。","desktopComposition":"Hero 占满整宽，双栏 Field Bridge 是唯一主视觉，各能力作为小标签挂在桥接线上而非卡片；后续章节沿用“左索引/右 API /中连接”的双栏语法但改变行距与连线密度。","mobileTransformation":"桥接线无法横向承载时切换为垂直栈：字段映射折叠为纵向的“索引字段 → 连接线 → API 字段”三明治，桥接线的箭头改为向下卷曲；能力标签收进连接线之间的折叠行。","mediaStrategy":"无本地合格素材，删除媒体区；标志视觉完全由字段对账与桥接几何承担，不伪造列表页或搜索截图。","forbiddenPatterns":["营销大标语 + 三张指标卡","任意项目可套用的功能卡片墙","终端/编辑器/手机/浏览器壳"],"compositionFingerprint":"bridged-field-ledger:paired-planes-with-arrow-bridges"},{"id":"haystack-retrieval-v2","name":"检索找回 — 海中取针","projectMetaphor":"搜索的本质是从成堆文档里把最相关的一条精确提取出来，drf-haystack 让这种“取针”通过统一的 serializer/viewset 通道按字段命中。","signatureVisual":"一片密集堆叠的文档层，其中恰好一条被抽出并抬升至顶端，抽出的那条带检索语义标记（facet / highlight / geo）；其余堆层保持静止减密度。","heroGeometry":"从底部堆叠物向上抬升的单条突出路径，形成一条由从属层到顶点的垂直提取线。","sectionSequence":["hero-retrieval-lift","the-needle","query-channel","what-to-return","weighted-answer","next-maintainer"],"surfaceModel":"前景单条提取元素与背景密集堆层用不同表面密度分离：突出一层立体抬升，其余层为平面序列，层次用堆叠次序而非投影分层。","palette":"纸张米白底减轻堆叠的压迫，突出的那层用单一高饱和红橙“取针”色，检索标记点用中性深色。","typography":"高对比大标题强调“提取”瞬间，正文衬线增强文档/纸张语义，检索字段用等宽体。","desktopComposition":"Hero 中央为抬升的那条检索结果，周边堆层成环绕负空间；章节围绕“命中 → 通道 → 返回结构 → 权重”的动线组织，权重层做成调焦而非卡片。","mobileTransformation":"环绕堆层压缩为单列背景纹理，抬升元素成为全屏主序列；marker 从侧面改为内嵌于顶部一行，动线从横向环绕转成线性下滚。","mediaStrategy":"无本地素材，用文档堆叠与抬升几何表达“取针”叙事；高亮以线段纹理示意，不伪造高亮截图。","forbiddenPatterns":["营销大标语 + 三张指标卡","必换字体才像本项目的功能墙","发光网格/粒子充当装饰"],"compositionFingerprint":"lifted-document:needle-out-of-stack-with-retrieval-markers"},{"id":"token-coercion-column-v3","name":"类型收束 — 从请求到模式的收束柱","projectMetaphor":"drf-haystack 把自由形态的搜索 token 收束成 DRF 认可的类型化 schema：进入的是松散关键词，离开的是结构化的响应对象。","signatureVisual":"一根垂直收束柱：顶部宽散的输入 token 群逐层聚拢，底部收敛成紧凑的类型化结果簇；每一层收束标注一次 coercion（强制类型转换）。","heroGeometry":"从上到下逐渐收窄的锥形柱，顶部水平切面比底部宽，每一层宽度代表一次类型收束。","sectionSequence":["hero-inversion-cone","input-looseness","schema-column","feature-endpoints","lifecycle-archive"],"surfaceModel":"单根收束柱以横向切层表示每一次转换，切层用实色与窄描边交替；柱体悬浮于平面底上，无装饰背景。","palette":"单一主色做柱体的收束渐变（同一色相从宽到窄深），背景近黑，逐层标记用微弱对比中性色；整体只有一色系限制噪点。","typography":"宽体窄距做柱体层标题（压缩感），等宽体做转换层痕迹，正文留白大、行距宽。","desktopComposition":"Hero 左侧为收束柱主结构，右侧跟随其对应层名的注释行；后续章节完全围绕锥形柱的“输入层—schema 层—端点层”自上而下切位，feature 挂在各自切层而非独立模块。","mobileTransformation":"收束锥压缩为细长竖条随滚动拉长，切层标记从侧注改为条内分段线；注释行折叠进切层内部，取消侧栏站位。","mediaStrategy":"无本地素材，收束柱以切层与比例关系表达分层再类型化；端点仅以文本端名标注，不伪造接口输出界面。","forbiddenPatterns":["营销大标语 + 三张指标卡","假标签页/假搜索框/假开关控件","浏览器/API 壳冒充产品截图"],"compositionFingerprint":"narrowing-token-column:vertical-type-coercion-cone"}],"selectedDirectionId":"bridge-field-mapping-v1","selectionRationale":"三个方向都忠于证据，但 bridge 方向最准确表达 drf-haystack 的机制：它不是一个搜索引擎，而是一个把 Haystack 字段与 DRF 序列化的“映射库”，证据中的 serializers、viewset、autocomplete/facet/geo/highlight 都是字段级转译。检索(direction 2)与类型收束(direction 3)更像独立搜索产品，隐喻会夸大项目能力。bridge 的双栏映射既是证据直译，也天然是库而非营销英雄；无本地素材时它的对账几何本身就构成证据驱动的标志视觉，不需要伪造截图。低相似度风险：映射桥结构在近期页面指纹中出现率低。"},"designBrief":{"schemaVersion":"dodot-design-brief-v1","selectedDirectionId":"bridge-field-mapping-v1","projectMetaphor":"drf-haystack 是连接 Haystack 索引与 DRF API 的翻译桥：每条搜索能力都被落实为一对字段映射，左边是索引里的字段，右边是 API 响应里的字段，中间是序列化器完成的转译。","signatureVisual":"一条水平字段对账带：左列标注索引字段（title、geolocation、autocomplete），右列标注 API 字段，中间以带箭头的连接线把两栏字段一一勾连；每条连接线随能力不同具有不同端点形态（自动补全、分面、高亮、地理、相似推荐）。","compositionFingerprint":"bridged-field-ledger:paired-planes-with-arrow-bridges","heroGeometry":"双栏平行的字段映射横向分段，两个栏体等高对齐，中部由五条带箭头的桥接横向贯穿，每条桥接线顶部带一个能力标签。","sectionSequence":["hero-field-bridge","the-gap","serializer-and-viewset","search-capabilities","one-file-integration","maintainer-stewardship"],"surfaceModel":"两个并列的平面栏体之间由空气间隙隔开，桥接横线悬空跨越；栏体为实色平面，桥接线为单一描边，无投影堆叠。","palette":"冷炭基调（页面底色 07），暖琥珀描边（桥接线）压深灰蓝，字段标识用高对比白，能力标签用低饱和青绿作点状强调。","typography":"等宽体做字段名（体现 schema 语法），人文无衬线做正文；桥接标题用紧凑大写窄体。","desktopComposition":"Hero 占满整宽，双栏 Field Bridge 是唯一主视觉，各能力作为小标签挂在桥接线上而非卡片；后续章节沿用“左索引/右 API /中连接”的双栏语法但改变行距与连线密度。","mobileTransformation":"桥接线无法横向承载时切换为垂直栈：字段映射折叠为纵向的“索引字段 → 连接线 → API 字段”三明治，桥接线的箭头改为向下卷曲；能力标签收进连接线之间的折叠行。","mediaStrategy":"无本地合格素材，删除媒体区；标志视觉完全由字段对账与桥接几何承担，不伪造列表页或搜索截图。","evidencePlan":["evidence: summary.evidence[0].claim.zh-CN 描述 drf-haystack 为简化 Haystack 与 DRF 集成的小型库","evidence: summary.evidence[1].claim.en 列明 autocomplete、boost(experimental)、faceting、geo spatial search、highlighting、more like this 等搜索能力","evidence: extraction.facts repository_name=drf-haystack 与 description=Haystack for Django REST Framework","evidence: extraction.facts primary_language=Python 且 license=MIT 佐证其为 Python 库","evidence: extraction.readme.commands[0]=pip install drf-haystack 佐证单命令集成","evidence: summary.evidence[2].claim.zh-CN 佐证项目寻找维护者并计划于 2026 年 1 月 1 日归档"],"localeContract":{"zh-CN":"中文文案以字段桥语比喻，字段名保留英文原词以示 schema 语义；能力标签多用短名词。","en":"English copy keeps the bridge-of-fields metaphor, field names stay as literal identifiers to preserve schema meaning; capability labels use short nouns."},"forbiddenPatterns":["营销大标语 + 三张指标卡","任意项目可套用的功能卡片墙","终端/编辑器/手机/浏览器壳冒充产物","发光网格或粒子替代项目化视觉","装饰性渐变/圆角/阴影泛化所有章节"]},"visualReview":{"schemaVersion":"dodot-automated-design-review-v1","status":"approved","summary":"页面忠实实现所选的 bridge-field-mapping-v1 方向：Hero 为横向双栏字段桥（左索引字段右 API 字段，中间琥珀色箭头桥接线），后续章节沿用同一批语法。所有关键声明均有 material.json 证据支撑（Python 库、MIT、pip install drf-haystack、autocomplete/facet/geo/highlight/more-like-this 能力、寻找维护者并计划 2026-01-01 归档、boost 实验性）。signatureVisual 真实存在于 DOM。移动端以垂直三明治栈重组而非简单堆叠，是重新设计。zh-CN 与 en 结构、内容与自然度等价。未回退到通用 Hero/三卡/卡片墙/设备壳/装饰渐变网格，无假控件。","checks":{"projectFit":{"passed":true,"evidence":"节序 hero-field-bridge → the-gap → serializer-and-viewset → search-capabilities → one-file-integration → maintainer-stewardship 与 design-brief.json 的 sectionSequence 完全一致；板块围绕字段桥、序列化器/视图集、搜索能力、单命令接入、维护者现状组织，符合 material.json projectType=library 与 audienceIntents build/integrate。冷炭底色(#07090c)/暖琥珀桥接线(#e6a24d)/青绿标签(#3f8f86)，等宽字段名+人文无衬线正文+窄体大写标题，均对应 brief palette 与 typography。"},"evidenceBound":{"passed":true,"evidence":"Python 库、MIT、pip install drf-haystack 均有 extraction.facts primary_language/license 与 readme.commands[0] 支持；search-capabilities 章节的五项能力分别对应 summary.evidence[1] 的 autocomplete、boost(experimental)、faceting、geo spatial search、highlighting、more like this；maintainer-stewardship 对应 summary.evidence[2] 寻找维护者并将于 2026-01-01 归档；chip #146 对应 lifecycle excerpt 中 issues/146 接手话题；experimental boost 有证据。字段级命名(geolocation、category_facet 等)为方向声明的合理解释性落地，非无据捏造。"},"signatureVisual":{"passed":true,"evidence":"zh-CN.html 与 en.html 的

实现了设计声明的签名视觉：左 plane 标注索引字段(index/title/geolocation/highlighted_text/category_facet/text)、右 plane 标注 API 字段(response/suggestion/distance/highlight/facets/similar)，中央 .col 用内联 SVG 五条带箭头 .blink 桥接线一一勾连，能力标签(autocomplete/geo/highlight/facet/more like this)随行内嵌，与 brief signatureVisual/heroGeometry 逐项吻合，为真实几何而非通用图形。"},"mobileTransformation":{"passed":true,"evidence":"@media(max-width:820px) 下横向 .bridge 与 SVG 桥接线被移除(display:none)，切换为 .mobile-bridge 垂直三明治栈：每行由 .mb-from(索引字段)、.mb-arr(向下↓箭头+能力标签)、.mb-to(API 字段)组成，箭头向下卷曲、能力标签收进连接行之间，符合 brief mobileTransformation 的纵向重构要求，非单纯堆叠横向布局。"},"localeParity":{"passed":true,"evidence":"zh-CN.html 与 en.html 均含完全对应的六个板块、相同的字段桥 DOM(同样字段/箭头/标签)与相同的 mobile-bridge；lead 与正文互为等价且自然的翻译(如 two parts make the bridge / 两条零件，组成一座桥；a bridge looking for a new keeper / 一座需要新守桥人的桥)，js 块无残留未翻译；en.html 一处 one-file 多一句解释句，属自然表达差异，不影响等价。"},"antiTemplate":{"passed":true,"evidence":"未出现营销大标语+三张指标卡、通用功能卡片墙(search-capabilities 为带 idx/body/map 的分隔行列表而非等宽卡片)、终端/编辑器/手机/浏览器壳、发光网格或粒子装饰；桥接线的 dash 只在 prefers-reduced-motion:no-preference 下为动效描边而非装饰性渐变网格，页面以字段对账与桥接几何承担全部视觉。"},"noFakeUi":{"passed":true,"evidence":"qa-report.json 四个观测(zh-CN/en × desktop/mobile)fakeControlCount=0、consoleErrors=[]、brokenImageCount=0；DOM 中无伪搜索框、伪开关、伪浏览器/API 壳；pip install drf-haystack 为证据支持的安装命令，haystack_serializer/SearchViewSet 为库代码说明，均以只读 pre 呈现而非可交互假控件。"}},"issues":[]},"repairEvidence":[{"attempt":1,"before":{"qaPassed":false,"designReviewApproved":false,"qaEvidence":{"zh-CN":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1796,"cjkCount":606,"latinLetterCount":835,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4056,"h1Top":109.4375,"bottomInset":195.953125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"9dafbd8104340475c4bc340e7d7c5d5ba055d95480a64ee71f814a442312d20d","middle":"8669534a5cd70bd3921b320b2a0b84e5b613ca4d2428c6d55dbbe0a8cb107a03","bottom":"ad6f9cadb32ea049aa09bd7310202893df0f83b888eb29e5a5305822f7b52d36"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":false,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1954,"cjkCount":606,"latinLetterCount":964,"scrollWidth":514,"clientWidth":390,"scrollHeight":5498,"h1Top":93.4375,"bottomInset":196.21875,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"f2ad7b748295cf0b6a016e7cd57e53a86a8c3df772b4b149159d2d870364b8d4","middle":"9151cd738b8a8eade288b86b9d598cf71fa6d4dca3b25aee8653c1198107fb26","bottom":"e7dff289948071bf7417242571efeb0d7b62a8b405bc7e4113c24746c550e3da"},"consoleErrors":[],"networkRequests":[]}],"en":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3419,"cjkCount":0,"latinLetterCount":2747,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4263,"h1Top":109.4375,"bottomInset":196.515625,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"4a060b10bf67cc04f95cac96a9fadde1db9f9a9e9a1a0166826850c2c25acf7b","middle":"f068851102f0d87578b990a8a72657d47ad53fdb214f34138c96e16a02badaab","bottom":"3f7a21728091c0e4620e4b38cb555fba974ab96e56e7189a2879923e5fb329cf"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":false,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3577,"cjkCount":0,"latinLetterCount":2876,"scrollWidth":514,"clientWidth":390,"scrollHeight":5946,"h1Top":93.4375,"bottomInset":196.078125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"a92c7cdd9a7d44bdb7ab57ccec791f8cd1a36e37da1875f50a314142e23f52a1","middle":"7e511ddd248507f3c9c1753ada01d6522c3733ab6e709906295e99a0c9a9fb1d","bottom":"f9e759ee08bd25f3068f856e7ad9c4504fa2cdb33204769ec23bb003de043b26"},"consoleErrors":[],"networkRequests":[]}]},"visualReview":null},"after":{"qaPassed":true,"designReviewApproved":true,"qaEvidence":{"zh-CN":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1796,"cjkCount":606,"latinLetterCount":835,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4056,"h1Top":109.4375,"bottomInset":195.953125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"9dafbd8104340475c4bc340e7d7c5d5ba055d95480a64ee71f814a442312d20d","middle":"8669534a5cd70bd3921b320b2a0b84e5b613ca4d2428c6d55dbbe0a8cb107a03","bottom":"ad6f9cadb32ea049aa09bd7310202893df0f83b888eb29e5a5305822f7b52d36"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":true,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1743,"cjkCount":600,"latinLetterCount":786,"scrollWidth":390,"clientWidth":390,"scrollHeight":5348,"h1Top":93.4375,"bottomInset":196.8125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"962b81dd4442280a1c098877cb0c9a109d6ae239c8a47e332a70c5914eecd79e","middle":"6a888aa75773ea7a4f08221e1439a0a4815556fc4dcd6182ef1f7d880f352842","bottom":"74835a770c13651d0d369bd3339ba4a41f8d3f4cce274c51c244cf69ef56a3ec"},"consoleErrors":[],"networkRequests":[]}],"en":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3419,"cjkCount":0,"latinLetterCount":2747,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4263,"h1Top":109.4375,"bottomInset":196.515625,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"4a060b10bf67cc04f95cac96a9fadde1db9f9a9e9a1a0166826850c2c25acf7b","middle":"f068851102f0d87578b990a8a72657d47ad53fdb214f34138c96e16a02badaab","bottom":"3f7a21728091c0e4620e4b38cb555fba974ab96e56e7189a2879923e5fb329cf"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":true,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3354,"cjkCount":0,"latinLetterCount":2681,"scrollWidth":390,"clientWidth":390,"scrollHeight":5820,"h1Top":93.4375,"bottomInset":196.75,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"484cb9b3eefd99c7166066db503758bd8d154121838bea5719fc69d69e6b8dbc","middle":"5b1b95f17e0009dde7b268fd6f9542477e8ba5773c29e1d703d5c99b2a42deea","bottom":"180acd98c1ca8c697f1ed5fab62105308419e2ed37afec1413e66ad19547ac25"},"consoleErrors":[],"networkRequests":[]}]},"visualReview":{"schemaVersion":"dodot-automated-design-review-v1","status":"approved","summary":"页面忠实实现所选的 bridge-field-mapping-v1 方向：Hero 为横向双栏字段桥（左索引字段右 API 字段，中间琥珀色箭头桥接线），后续章节沿用同一批语法。所有关键声明均有 material.json 证据支撑（Python 库、MIT、pip install drf-haystack、autocomplete/facet/geo/highlight/more-like-this 能力、寻找维护者并计划 2026-01-01 归档、boost 实验性）。signatureVisual 真实存在于 DOM。移动端以垂直三明治栈重组而非简单堆叠，是重新设计。zh-CN 与 en 结构、内容与自然度等价。未回退到通用 Hero/三卡/卡片墙/设备壳/装饰渐变网格，无假控件。","checks":{"projectFit":{"passed":true,"evidence":"节序 hero-field-bridge → the-gap → serializer-and-viewset → search-capabilities → one-file-integration → maintainer-stewardship 与 design-brief.json 的 sectionSequence 完全一致；板块围绕字段桥、序列化器/视图集、搜索能力、单命令接入、维护者现状组织，符合 material.json projectType=library 与 audienceIntents build/integrate。冷炭底色(#07090c)/暖琥珀桥接线(#e6a24d)/青绿标签(#3f8f86)，等宽字段名+人文无衬线正文+窄体大写标题，均对应 brief palette 与 typography。"},"evidenceBound":{"passed":true,"evidence":"Python 库、MIT、pip install drf-haystack 均有 extraction.facts primary_language/license 与 readme.commands[0] 支持；search-capabilities 章节的五项能力分别对应 summary.evidence[1] 的 autocomplete、boost(experimental)、faceting、geo spatial search、highlighting、more like this；maintainer-stewardship 对应 summary.evidence[2] 寻找维护者并将于 2026-01-01 归档；chip #146 对应 lifecycle excerpt 中 issues/146 接手话题；experimental boost 有证据。字段级命名(geolocation、category_facet 等)为方向声明的合理解释性落地，非无据捏造。"},"signatureVisual":{"passed":true,"evidence":"zh-CN.html 与 en.html 的

实现了设计声明的签名视觉：左 plane 标注索引字段(index/title/geolocation/highlighted_text/category_facet/text)、右 plane 标注 API 字段(response/suggestion/distance/highlight/facets/similar)，中央 .col 用内联 SVG 五条带箭头 .blink 桥接线一一勾连，能力标签(autocomplete/geo/highlight/facet/more like this)随行内嵌，与 brief signatureVisual/heroGeometry 逐项吻合，为真实几何而非通用图形。"},"mobileTransformation":{"passed":true,"evidence":"@media(max-width:820px) 下横向 .bridge 与 SVG 桥接线被移除(display:none)，切换为 .mobile-bridge 垂直三明治栈：每行由 .mb-from(索引字段)、.mb-arr(向下↓箭头+能力标签)、.mb-to(API 字段)组成，箭头向下卷曲、能力标签收进连接行之间，符合 brief mobileTransformation 的纵向重构要求，非单纯堆叠横向布局。"},"localeParity":{"passed":true,"evidence":"zh-CN.html 与 en.html 均含完全对应的六个板块、相同的字段桥 DOM(同样字段/箭头/标签)与相同的 mobile-bridge；lead 与正文互为等价且自然的翻译(如 two parts make the bridge / 两条零件，组成一座桥；a bridge looking for a new keeper / 一座需要新守桥人的桥)，js 块无残留未翻译；en.html 一处 one-file 多一句解释句，属自然表达差异，不影响等价。"},"antiTemplate":{"passed":true,"evidence":"未出现营销大标语+三张指标卡、通用功能卡片墙(search-capabilities 为带 idx/body/map 的分隔行列表而非等宽卡片)、终端/编辑器/手机/浏览器壳、发光网格或粒子装饰；桥接线的 dash 只在 prefers-reduced-motion:no-preference 下为动效描边而非装饰性渐变网格，页面以字段对账与桥接几何承担全部视觉。"},"noFakeUi":{"passed":true,"evidence":"qa-report.json 四个观测(zh-CN/en × desktop/mobile)fakeControlCount=0、consoleErrors=[]、brokenImageCount=0；DOM 中无伪搜索框、伪开关、伪浏览器/API 壳；pip install drf-haystack 为证据支持的安装命令，haystack_serializer/SearchViewSet 为库代码说明，均以只读 pre 呈现而非可交互假控件。"}},"issues":[]}},"changedFiles":["artifact/zh-CN.html","artifact/en.html"]}],"provenance":{"executor":"opencode","model":"deepseek/deepseek-v4-flash","opencodeVersion":"1.1.58","promptVersion":"dodot-showcase-deepseek-v4","inputHash":"9eb19d9ddd72406a26450da6502c85fdb874cfca1ca20e1de388173ee7311868","artifactHash":"c4319216dbc9e0da27556acb5e2af6960456490b57d3662d3f32bb8e6313a5d4","designSkill":"dodot-showcase-design"},"qaEvidence":{"zh-CN":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1796,"cjkCount":606,"latinLetterCount":835,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4056,"h1Top":109.4375,"bottomInset":195.953125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"9dafbd8104340475c4bc340e7d7c5d5ba055d95480a64ee71f814a442312d20d","middle":"8669534a5cd70bd3921b320b2a0b84e5b613ca4d2428c6d55dbbe0a8cb107a03","bottom":"ad6f9cadb32ea049aa09bd7310202893df0f83b888eb29e5a5305822f7b52d36"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":true,"localePassed":true,"metrics":{"language":"zh-CN","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":1743,"cjkCount":600,"latinLetterCount":786,"scrollWidth":390,"clientWidth":390,"scrollHeight":5348,"h1Top":93.4375,"bottomInset":196.8125,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"962b81dd4442280a1c098877cb0c9a109d6ae239c8a47e332a70c5914eecd79e","middle":"6a888aa75773ea7a4f08221e1439a0a4815556fc4dcd6182ef1f7d880f352842","bottom":"74835a770c13651d0d369bd3339ba4a41f8d3f4cce274c51c244cf69ef56a3ec"},"consoleErrors":[],"networkRequests":[]}],"en":[{"viewport":"desktop","passed":true,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3419,"cjkCount":0,"latinLetterCount":2747,"scrollWidth":1280,"clientWidth":1280,"scrollHeight":4263,"h1Top":109.4375,"bottomInset":196.515625,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"4a060b10bf67cc04f95cac96a9fadde1db9f9a9e9a1a0166826850c2c25acf7b","middle":"f068851102f0d87578b990a8a72657d47ad53fdb214f34138c96e16a02badaab","bottom":"3f7a21728091c0e4620e4b38cb555fba974ab96e56e7189a2879923e5fb329cf"},"consoleErrors":[],"networkRequests":[]},{"viewport":"mobile","passed":true,"localePassed":true,"metrics":{"language":"en","h1Count":1,"h2Count":5,"sectionCount":6,"textLength":3354,"cjkCount":0,"latinLetterCount":2681,"scrollWidth":390,"clientWidth":390,"scrollHeight":5820,"h1Top":93.4375,"bottomInset":196.75,"brokenImageCount":0,"missingAltCount":0,"fakeControlCount":0,"emptyLinkCount":0},"screenshotHashes":{"top":"484cb9b3eefd99c7166066db503758bd8d154121838bea5719fc69d69e6b8dbc","middle":"5b1b95f17e0009dde7b268fd6f9542477e8ba5773c29e1d703d5c99b2a42deea","bottom":"180acd98c1ca8c697f1ed5fab62105308419e2ed37afec1413e66ad19547ac25"},"consoleErrors":[],"networkRequests":[]}]}},"generatorVersion":"opencode-1.1.58:deepseek/deepseek-v4-flash:dodot-showcase-deepseek-v4","publishedAt":"2026-08-20T09:48:33.143Z"},"rawExtraction":{"projectRevisionId":"cmt2zh3id01tj62717hdevq52","projectVersion":1,"sources":[{"canonicalKey":"github:ulgens/drf-haystack","role":"primary","revisionVersion":1,"url":"https://github.com/ulgens/drf-haystack"}],"facts":[{"key":"repository_owner","value":"ulgens","evidence":[{"path":"repository.owner","excerpt":"ulgens"}]},{"key":"repository_name","value":"drf-haystack","evidence":[{"path":"repository.name","excerpt":"drf-haystack"}]},{"key":"description","value":"Haystack for Django REST Framework","evidence":[{"path":"repository.description","excerpt":"Haystack for Django REST Framework"}]},{"key":"primary_language","value":"Python","evidence":[{"path":"repository.language","excerpt":"Python"}]},{"key":"license","value":"MIT","evidence":[{"path":"repository.license","excerpt":"MIT"}]},{"key":"source_count","value":"1","evidence":[{"path":"projectRevision.sources","excerpt":"github:ulgens/drf-haystack"}]}],"taxonomy":{"category":"development_tools","subcategory":"developer_resources","confidence":0.65,"evidence":[{"path":"repository.description","excerpt":"Haystack for Django REST Framework"}]},"lifecycle":{"stage":"prototype","confidence":0.65,"evidence":[{"path":"readmeExcerpt","excerpt":"🚨 Maintainers wanted 🚨 ======================== **This project urgently needs new maintainers!** The current maintainers are no longer actively using `drf-haystack` and would like to [hand over the project to other developers](https://github.com/rhblind/drf-haystack/issues/146) who are using the package. We will still do the bare minimum maintenance of keeping dependency references up to date with new releases of related packages **until January 1st 2026**. If by that time no new maintainers h"}]},"userIntents":[{"slug":"build_software","label":"构建或改进软件","confidence":0.65,"evidence":[{"path":"repository.description","excerpt":"Haystack for Django REST Framework"}]},{"slug":"analyze_data","label":"分析与理解数据","confidence":0.65,"evidence":[{"path":"repository.description","excerpt":"Haystack for Django REST Framework"}]}],"readme":{"headings":["Serializer","ViewSet"],"commands":["pip install drf-haystack"]},"changeSet":[{"field":"repository","beforeHash":"542c70e699040a56386f35568f17d2db8875353844df6293993d3fdd4ef94dce","afterHash":"6e863a10c1adc17275cfb6ce32838eecab84be229f50db5cc5ee34bd5615aa18"}]},"publishedAt":"2026-08-16T10:41:35.303Z","updatedAt":"2026-08-21T13:26:54.490Z","summary":{"id":"cmt2zh3ig01tl6271r6684icq","projectType":"library","oneLine":"简化 Haystack 与 DRF 集成的库","overview":"drf-haystack 是一个小型 Python 库，旨在简化 Haystack 搜索框架与 Django REST Framework 的集成。它提供序列化器和视图集，让开发者能快速为 DRF API 添加搜索功能，支持自动补全、分面、地理空间搜索、高亮和相似推荐等特性。项目目前需要新的维护者，并计划在 2026 年初若无接手者则归档。","highlights":["简化集成","支持多种搜索特性","活跃维护中"],"bestFor":["Django 开发者","需要为 DRF API 添加搜索功能"],"caveats":["项目正在寻找维护者，未来可能归档","Boost 功能为实验性"],"categorySuggestion":"development_tools","subcategorySuggestion":"libraries_sdks","lifecycleStages":["backend_data"],"audienceIntents":["build","integrate"],"confidence":0.8,"evidence":[{"claim":"drf-haystack 是一个简化 Haystack 与 Django REST Framework 集成的小型库。","sourceType":"readme","locator":"https://github.com/ulgens/drf-haystack"},{"claim":"支持自动补全、加权（实验性）、分面、地理空间搜索、高亮和相似推荐等功能。","sourceType":"readme","locator":"https://github.com/ulgens/drf-haystack"},{"claim":"项目正在寻找新的维护者，并计划在 2026 年 1 月 1 日前若无新维护者加入则归档。","sourceType":"readme","locator":"https://github.com/ulgens/drf-haystack"}],"publishedAt":"2026-08-17T13:49:19.352Z"},"github":{"url":"https://github.com/ulgens/drf-haystack","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/166637?v=4","starsCount":264,"forksCount":81,"language":"Python","syncedAt":"2026-08-17T13:45:55.657Z","license":"MIT","defaultBranch":"main","archived":false,"disabled":false,"lastChangedAt":"2026-08-16T10:25:20.000Z","missing":false},"tags":[],"updates":[]},"entryPoint":"discovery","claim":{"state":"unclaimed","verified":false},"initialView":"beautified","community":{"viewer":null,"state":{"likesCount":0,"creativeCount":0,"followersCount":0,"commentsCount":0,"liked":false,"creative":false,"followed":false},"comments":{"comments":[],"nextCursor":null}}}]}],"$L24"]