NIANLI|念礼 — AI Gift Discovery & Decision Agent #1

Open
lansijian wants to merge 8 commits from lansijian/nianli-track-161:main into main
Member

NIANLI|念礼

NIANLI 是一个 AI Gift Discovery & Decision Agent。

它不是简单地“搜索礼物”,而是先理解收礼人、关系、场景、明确需求、预算语义、已有物品和购买约束,再完成检索、证据验证、硬约束过滤、排序与解释,最终给出可追溯的商品决策。

在线 Demo

https://beta.nianliai.top

  • 公开内测
  • 无需邀请码
  • 注册即送 5 次免费体验
  • 完整体验约 2–5 分钟

最终生产版本:

a745c9fd3d22ec55446b406f33ad546cb925ec6c

建议体验

  1. 爷爷的手杖用了十几年磨坏了,预算 450 元,想配根新的。
  2. 爸爸是资深木工,预算 720 元,想送一套专业级工具。
  3. 朋友集攒了一整套邮票册,预算 310 元,想送专业护邮用品。

实际运行结果见:

docs/DEMO_SCRIPT.md

Agent 核心链路

Understand → Constrain → Strategize → Retrieve → Verify → Filter → Rank → Explain → Learn

核心原则:

  • 显式需求优先
  • 硬约束先于打分
  • 推荐必须有证据支撑
  • WhyFit / WhyNot 可解释
  • 没有可靠证据时宁缺毋滥,不随机填充

已验证

  • 587/587 自动化测试通过
  • Production migration V1–V8
  • PRAGMA foreign_key_check = []
  • Deliverable 与体验次数扣减原子提交
  • 注册滥用持久化限流
  • Production build application warnings = 0
  • Secret scan = 0
  • Static asset integrity = PASS

Track-161 对齐

NIANLI 当前不声称已经实现社媒自动发布、广告投放或品牌后台。

本项目聚焦于小红书、INS、X、Discord、Reddit 等内容产生消费兴趣后的高意图购买决策层,把碎片化的“送什么、买什么”意图转换成约束明确、证据可解释的商品决策。

详见:

docs/TRACK_ALIGNMENT.md

评委入口

  • 00_NIANLI_START_HERE.md
  • JUDGE_START_HERE.md
  • NIANLI_SUBMISSION.md
  • docs/DEMO_SCRIPT.md
  • docs/KNOWN_LIMITATIONS.md

源码

最终提交源码:

submission/nianli/

来源:

git archive a745c9fd3d22ec55446b406f33ad546cb925ec6c

快照说明:

submission/SOURCE_SNAPSHOT.md

## NIANLI|念礼 NIANLI 是一个 AI Gift Discovery & Decision Agent。 它不是简单地“搜索礼物”,而是先理解收礼人、关系、场景、明确需求、预算语义、已有物品和购买约束,再完成检索、证据验证、硬约束过滤、排序与解释,最终给出可追溯的商品决策。 ## 在线 Demo https://beta.nianliai.top - 公开内测 - 无需邀请码 - 注册即送 5 次免费体验 - 完整体验约 2–5 分钟 最终生产版本: `a745c9fd3d22ec55446b406f33ad546cb925ec6c` ## 建议体验 1. 爷爷的手杖用了十几年磨坏了,预算 450 元,想配根新的。 2. 爸爸是资深木工,预算 720 元,想送一套专业级工具。 3. 朋友集攒了一整套邮票册,预算 310 元,想送专业护邮用品。 实际运行结果见: `docs/DEMO_SCRIPT.md` ## Agent 核心链路 Understand → Constrain → Strategize → Retrieve → Verify → Filter → Rank → Explain → Learn 核心原则: - 显式需求优先 - 硬约束先于打分 - 推荐必须有证据支撑 - WhyFit / WhyNot 可解释 - 没有可靠证据时宁缺毋滥,不随机填充 ## 已验证 - 587/587 自动化测试通过 - Production migration V1–V8 - `PRAGMA foreign_key_check = []` - Deliverable 与体验次数扣减原子提交 - 注册滥用持久化限流 - Production build application warnings = 0 - Secret scan = 0 - Static asset integrity = PASS ## Track-161 对齐 NIANLI 当前不声称已经实现社媒自动发布、广告投放或品牌后台。 本项目聚焦于小红书、INS、X、Discord、Reddit 等内容产生消费兴趣后的高意图购买决策层,把碎片化的“送什么、买什么”意图转换成约束明确、证据可解释的商品决策。 详见: `docs/TRACK_ALIGNMENT.md` ## 评委入口 - `00_NIANLI_START_HERE.md` - `JUDGE_START_HERE.md` - `NIANLI_SUBMISSION.md` - `docs/DEMO_SCRIPT.md` - `docs/KNOWN_LIMITATIONS.md` ## 源码 最终提交源码: `submission/nianli/` 来源: `git archive a745c9fd3d22ec55446b406f33ad546cb925ec6c` 快照说明: `submission/SOURCE_SNAPSHOT.md`
Source product commit: 3c2bbd6 (exported via git archive,
core.autocrlf=false — byte-identical, dataset seals verified).

submission/nianli/ = independently runnable Next.js app (451 files):
V4 gift-decision engine (11-stage pipeline, strong-signal domain
fidelity, EXACT_NEED dominance, honest CONCEPT_ONLY fallback),
DeepSeek + Taobao TOP providers, 548/549 clean-room tests green
(1 test depends on uncommitted local runtime/wave1 seed data,
excluded per privacy rules — documented in docs/KNOWN_LIMITATIONS.md).

Judge docs: NIANLI_SUBMISSION.md, docs/{ARCHITECTURE,DEMO_SCRIPT,
SECURITY_AND_PRIVACY,KNOWN_LIMITATIONS}.md, submission/SOURCE_SNAPSHOT.md.

Official track files untouched. SECRET_SCAN=0. PRIVATE_RUNTIME_ARTIFACT=0.
Clean-room: install --frozen-lockfile OK, lint 0, tsc 0, build OK.
Source product commit: 6a35183 (hermetic founder-ab fixture b82e780,
env docs 704564c, mock-provider null-safe profile reads — zero-config
demo path no longer crashes on fresh users).

- Refresh submission/nianli from 6a35183: clean-room 549/549 tests,
  lint 0, tsc 0, build OK.
- docs/TRACK_ALIGNMENT.md: go-global story with implemented vs
  NEXT-STAGE/PLANNED strictly separated; no fabricated traction.
- NIANLI_SUBMISSION.md: business section split into MEASURED ENGINEERING
  EVIDENCE (reproducible) vs BUSINESS HYPOTHESIS (unverified); judge
  entry + screenshot table.
- JUDGE_START_HERE.md: 2-3 minute judge onboarding with mermaid
  architecture, three demo missions, limitations.
- docs/DEPLOYMENT_PLAN.md: demo deployment plan (NOT executed; pending
  explicit approval). docs/ARCHITECTURE.md: mermaid pipeline diagram.
- docs/screenshots/: 6 real-UI captures (home / mission / clarification
  / slate / whyFit / lab) taken from a live run of the snapshot itself.
- docs/DEMO_SCRIPT.md: three demo cases re-verified against the live
  pipeline; outputs quoted verbatim.

Official track files untouched. SECRET_SCAN=0 (transient screenshot
.env.local used only for a live-provider capture was deleted and never
staged). No PR yet. Not deployed.
docs/SUBMISSION_COPY.md — exact SynNovator form text (title / short /
full description), repo identifier, DEMO_URL_PENDING and
PR_URL_PENDING slots; no invented data.

docs/DEPLOYMENT_PLAN.md — reality check: production Beta lives at
beta.nianliai.top (43.161.199.184, /var/lib/nianli, port 3200); demo
port moved to 3300 to avoid collision; deployment access gap from this
machine documented with three unlock options.
Live-beta remote audit (no server access needed):
- beta.nianliai.top serves a DEV-mode process (turbopack chunk names),
  not a production build
- live tree provably >= 58542dd (landing redesign copy matches) but the
  running SHA is unverifiable anonymously; ALL competition engine work
  (V4 core, V4.2 evidence retrieval, V4.3 strategy layer, V4.4.1
  CONCEPT_ONLY, V4.5.x domain fidelity, V4.5.5.2 EXACT_NEED) sits in the
  46 commits between 1351794 and 6a35183
- security surface verified: /internal/* and /api/internal/* masked 404,
  /api/admin/* 401, /admin 307, /lab is a public bench explainer page
  (server data gated), register is invite-gated
- mobile 375x812 homepage: no overflow, CTAs visible (PASS)

Verdict: upgrade of the existing beta IS required (version provability
+ production-build form); per corrected instructions NO second instance.

docs/BETA_UPGRADE_PLAN.md — founder-executed in-place upgrade to 6a35183
(backup -> checkout -> build -> NIANLI_INTERNAL_TOOLS=false -> smoke
account compdemo -> restart; domain/Caddy/port untouched; rollback incl.)

DEMO URL backfilled to https://beta.nianliai.top across all judge docs
(DEMO_URL_PENDING = 0). docs/DEPLOYMENT_PLAN.md (3300 instance) marked
superseded. docs/SUBMISSION_COPY.md judge-entry switched to published
demo account (FOUNDER_SMOKE cohort — zero REAL_USER_BETA touch).
Product source SHA: e8a3a6a (sole Production-approved release; deployed
and accepted on beta.nianliai.top). 6a35183 marked SUPERSEDED / NOT
production-approved in provenance docs.

- submission/nianli/ re-exported from e8a3a6a (454 tracked files,
  autocrlf=false): P0 production-safe MIGRATION_V3, delete-cascade
  hardening + deterministic route mapping, pnpm release:gate, two
  production-shaped regression suites.
- Clean-room on the snapshot: 558/558 tests (60 files), lint 0,
  typecheck 0, production build OK with ZERO Turbopack application
  warnings, dataset seals verified.
- Live verification on e8a3a6a: Demo A (cane, 2 domain products,
  DIRECT evidence), Demo B (woodworker, domain-correct tools), Demo C
  (philately, honest CONCEPT_ONLY fallback) — all PASS with real
  providers; scarf/generic pollution 0.
- Public QA on https://beta.nianliai.top: HTTPS 200; incognito flow to
  invite-gated register wall; mobile 375x812 no overflow; internal
  routes fully masked (/internal/* + /api/internal/* 404, /api/admin/*
  401, founder routes 404).
- Screenshots: all 6 recaptured from the e8a3a6a build (home / mission
  / clarification / slate / whyFit / lab); transient .env.local deleted,
  never staged.
- Docs updated: SOURCE_SNAPSHOT (e8a3a6a provenance + 6a35183 incident
  record), BETA_UPGRADE_PLAN marked EXECUTED, judge docs numbers
  refreshed (558 tests / 60 files), demo URL beta.nianliai.top.

Official track files untouched. SECRET_SCAN=0. PRIVATE_RUNTIME_ARTIFACT=0.
SUBMISSION FROZEN at Product Source SHA a745c9f (sole Production-approved
release, live on beta.nianliai.top with full production acceptance).
All prior SHAs (6a35183/e8a3a6a/f85ecad/fa36411/f18e0da) marked
superseded in the provenance history table.

- submission/nianli/ regenerated via git archive a745c9f (465 files,
  autocrlf=false); audit: .env.local=0, node_modules/.next/runtime=0,
  sqlite=0, secret scan=0.
- Clean-room on the frozen snapshot: release:gate 13/13 ALL GREEN —
  587/587 tests (66 files) incl. migration fixture V1-V8, delete
  cascade, public registration + credits, concurrent quota, atomic
  finalizer fault injection, registration abuse throttle, static asset
  integrity; lint 0; tsc 0; build 0 application warnings.
- JUDGE_START_HERE rewritten judge-first: 60-second answer of what
  NIANLI is, demo URL/public-beta facts up front, official scoring map
  (15/25/20/25/10/5 -> evidence -> where to look), verified metrics
  strictly separated from business hypotheses (no invented conversion/
  GMV/ROI numbers).
- docs/TRACK_ALIGNMENT.md calibrated to code reality: NIANLI is NOT a
  social-post generator; positioning = high-intent conversion layer
  behind content-driven interest; channel integrations (XHS/INS/X/
  Discord/Reddit) marked extension/future integration; /share/local
  described as browser-local preview only (server-side sharing not
  implemented).
- docs/screenshots/: all 6 judge screenshots recaptured from the
  a745c9f same-source production build with real providers (home /
  register-no-invite / mission input with quota chip / clarification /
  slate+whyFit / remaining-4 chip); README records exact provenance.
- docs/DEMO_SCRIPT.md refreshed with live a745c9f outputs (cane:
  2 domain products; woodworker: domain-correct; philately: verified
  product + honest CONCEPT_ONLY; invariants all 0 per run).
- docs/SUBMISSION_COPY.md rewritten judge-first (title / one-liner /
  problem / agent flow / demo / value / reliability / URLs; PR slot
  intentionally pending).
- Official track files untouched (diff=0); PR not created.

PR_URL_PENDING remains the only pending slot, intentionally.
Repo-face cleanup for judges: the fork now reads as a finished entry,
not 'official template + phase files'.

- NEW 00_NIANLI_START_HERE.md (sorts first on Forgejo): project-home
  entry — what NIANLI is, demo URL, public beta facts, one-minute flow,
  three demo missions, frozen SHA, judge entry list.
- JUDGE_START_HERE.md rewritten as the detailed judge entry: first
  screen = what/demo/registration/5-trials/three demos/SHA; then pain
  point, decision chain, evidence/whyFit/whyNot, 宁缺毋滥, then the
  official scoring map; historical phases/waves/old SHAs removed from
  the judge path.
- NIANLI_SUBMISSION.md rewritten as a 2-3 minute final summary
  (project/problem/solution/architecture/demo/cases/verified/value/
  alignment/security/limitations/SHA) — no dev-log content.
- docs/history/ created: BETA_UPGRADE_PLAN.md + DEPLOYMENT_PLAN.md
  archived with a clear 'Historical development record — not current
  submission state' banner (their mission is complete).
- scripts/check-markdown-links.ts: repo link integrity check — 50
  references verified, 0 broken.
- Fact scan: old SHAs exist only in docs/history/ (banned flagged) and
  inside the frozen product snapshot; PR_URL_PENDING only in
  docs/SUBMISSION_COPY.md.

Official files vs upstream/main: README/CONTRIBUTING/SUBMISSIONS/
submissions.json/.forgejo = 0 diff. Product snapshot untouched
(a745c9f frozen export).
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u main:lansijian-main
git switch lansijian-main

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff lansijian-main
git switch lansijian-main
git rebase main
git switch main
git merge --ff-only lansijian-main
git switch lansijian-main
git rebase main
git switch main
git merge --no-ff lansijian-main
git switch main
git merge --squash lansijian-main
git switch main
git merge --ff-only lansijian-main
git switch main
git merge lansijian-main
git push origin main
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
hfhahkjfdhakfhf/track-161!1
No description provided.