feat: user-annotated experience rating + ranking boost#5
Merged
Mola-maker merged 1 commit intomainfrom Apr 20, 2026
Merged
Conversation
Adds POST /api/experience/rate for users to star or assign 0-5 rating
to experience entries from the Experience page. Annotations persist
to knowledge_base/experience_log.json on the matched entry (by id).
get_relevant_experience now boosts scores based on user annotations:
- rating contributes +rating (0-5) to the keyword-match score
- starred adds +3
Additive rather than multiplicative so a 5-star entry with no keyword
hits can't override a direct-match entry — ratings guide, not override,
relevance.
UI changes (Experience page):
- per-card 5-star widget; click a star to set rating, click the same
star again to clear it
- ☆ 收藏 / ★ 已收藏 toggle on the right
- card re-renders after a successful save so state reflects the server
Endpoint validation: rejects out-of-range rating (400), missing id
(400), unknown id (404), non-int rating (400). Missing log file
returns 404.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds POST /api/experience/rate for users to star or assign 0-5 rating to experience entries from the Experience page. Annotations persist to knowledge_base/experience_log.json on the matched entry (by id).
get_relevant_experience now boosts scores based on user annotations:
UI changes (Experience page):
Endpoint validation: rejects out-of-range rating (400), missing id (400), unknown id (404), non-int rating (400). Missing log file returns 404.