Won · revisions

저장소가 얼마나 고쳐졌는지

revisions 는 revised 와 total 로 답합니다. 저장소에 든 기억 가운데 몇 개가 쓰인 뒤에 바뀌었는지입니다. 중요한 일을 기억에 기대기 전에, 또는 떠올린 사실이 지금 사용자가 하는 말과 어긋날 때 물어볼 만합니다. 열에 셋이 갈아치워진 저장소는 아무도 손대지 않은 저장소보다 덜 믿는 것이 맞습니다.

Tablet 2 이상에서 지원합니다. HTTP API, Python·TypeScript·Rust SDK, 그리고 MCP 도구로 호출할 수 있습니다. 이전 엔진은 501 을 내고, 어떤 모델이 못 하는지 이름으로 알려줍니다.

세기

고쳐 쓴 것을 셉니다 - 대체·수정·철회, 그리고 이미지 삭제입니다.

mem.revisions()
# {"revised": 3, "unrevised": 37, "total": 40, …}
await mem.revisions();
mem.revisions(None).await?;
curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" -d '{"user_id":"alice"}'
필드뜻
revised변형이 건드린 기억 수입니다.
unrevised쓰인 뒤로 아무것도 건드리지 않은 기억입니다. revised + unrevised 는 항상 total 과 같습니다. 따로 세지 않고 빼서 얻으므로, 동시에 쓰기가 들어와도 셋이 어긋나지 않습니다.
total저장소에 든 기억 수입니다.
counts / excludes플래그가 아니라 문장으로, 그 숫자가 무엇까지 덮는지 적혀 옵니다. 읽는 쪽이 대개 모델이기 때문입니다.

목록 읽기

include 를 주면 개수가 아니라 기억 자체가 옵니다. 빼면 개수만 오고, 그쪽이 싼 호출입니다.

page = mem.revisions(include="revised", limit=20)
page["memories"], page["matched"], page["has_more"]
const page = await mem.revisions(undefined, { include: "revised", limit: 20 });
let page = mem.revisions_page(None, "revised", 20, None, None).await?;
curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" \
  -d '{"user_id":"alice","include":"revised","limit":20}'
필드하는 일
include"revised" 또는 "unrevised". 다른 값은 개수만 돌려주는 대신 400 으로 거절합니다. 오타 때문에 목록이 조용히 빠지면 빈 저장소와 구분이 안 됩니다.
limit5에서 20, 기본 20. 범위 밖이거나 타입이 틀리면 깎지 않고 거절합니다.
matched이 페이지 뒤에 있는 전체 행 수입니다. 페이지 크기가 아닙니다.
ordered_by서비스가 자기 정렬 기준을 말해줍니다. 저장된 순서로 최신이 먼저이고, 최근에 고쳐진 순서가 아닙니다.
next_before다음 쪽 커서이며 next_skip_ids 와 짝입니다. 둘 다 되돌려주면 되고, id 는 쪽을 넘기며 누적됩니다.
목록은 고쳐진 시각이 아니라 저장된 시각 순입니다. "최근에 고쳐진 것부터" 로 읽으면 페이지를 잘못 읽게 되고, 그래서 응답이 어느 쪽인지 스스로 밝힙니다.
지운 것은 세지 않습니다. 지워진 기억은 셀 것이 남지 않아서, 많이 덜어낸 저장소도 revised 는 낮게 나옵니다. 이 숫자는 얼마나 고쳐졌는지를 말할 뿐, 얼마나 사라졌는지는 말하지 않습니다.