도움말:S3 연구 메모리 - 편집 역사

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-20T05:08:47Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 20일 (월) 14:08 판
91번째 줄:		91번째 줄:
	\|}		\|}

	검색 기본값은 기존 전체 텍스트·단어 겹침 방식인 <code><nowiki>legacy</nowiki></code>입니다. 서버 담당자가 의미 검색을 켠 환경에서는 <code><nowiki>search_lessons</nowiki></code>나 <code><nowiki>find_analogies</nowiki></code>에 <code><nowiki>retrieval_mode=hybrid_v1</nowiki></code>을 지정해 표현이 다른 후보도 함께 찾을 수 있습니다. 결과의 <code><nowiki>effective_mode</nowiki></code>와 <code><nowiki>semantic_status</nowiki></code>로 실제 적용 여부를 확인하세요. 이 서버의 GPU에서 선택적으로 실행하는 번들 모델과 설정 방법은 [[Help:S3 연구 메모리/설치와 검증#선택적 의미 검색\|설치·설정의 의미 검색]]에 있습니다.		검색 기본값은 기존 전체 텍스트·단어 겹침 방식인 <code><nowiki>legacy</nowiki></code>입니다. 서버 담당자가 의미 검색을 켠 환경에서는 <code><nowiki>search_lessons</nowiki></code>나 <code><nowiki>find_analogies</nowiki></code>에 <code><nowiki>retrieval_mode=hybrid_v1</nowiki></code>을 지정해 표현이 다른 후보도 함께 찾을 수 있습니다. 서버에 설정된 relevance 묶음은 <code><nowiki>scope</nowiki></code>로 선택하며, 호출자 필터와 교집합으로 적용됩니다. scope는 접근 제어가 아니며 Lesson 스키마를 늘리지 않습니다.

			고정 평가셋은 <code><nowiki>make evaluate-retrieval QUERY_FILE=queries.json</nowiki></code>으로 실행합니다. 각 항목은 <code><nowiki>query</nowiki></code>, <code><nowiki>expected_ids</nowiki></code>와 선택적인 <code><nowiki>retrieval_mode</nowiki></code>, <code><nowiki>scope</nowiki></code>를 사용하며 결과에는 query 본문을 포함하지 않은 recall·MRR·nDCG·p50/p95 latency·fallback 수를 출력합니다. 결과의 <code><nowiki>effective_mode</nowiki></code>와 <code><nowiki>semantic_status</nowiki></code>로 실제 적용 여부를 확인하세요. 이 서버의 GPU에서 선택적으로 실행하는 번들 모델과 설정 방법은 [[Help:S3 연구 메모리/설치와 검증#선택적 의미 검색\|설치·설정의 의미 검색]]에 있습니다.

			외부 자료는 먼저 Lesson이 아닌 후보로 수집합니다. 예를 들어 <code><nowiki>make collect-candidates ARGS='--code-root /path/to/repo --docs-root /path/to/docs'</nowiki></code> 또는 Slack export JSON을 지정할 수 있습니다. 후보는 비밀값을 마스킹한 bounded JSON으로만 출력되며, 검토 뒤 중앙 MCP의 <code><nowiki>attach_evidence</nowiki></code> 또는 <code><nowiki>create_lesson_draft</nowiki></code>로 명시적으로 저장해야 합니다.

			여러 검색 facet을 병렬 실행하고 RRF로 합치려면 <code><nowiki>make research-query QUERY='cache stampede'</nowiki></code>를 사용합니다. 선택적인 OpenAI-compatible reranker/synthesis는 <code><nowiki>S3RM_RESEARCH_LLM_URL</nowiki></code>과 <code><nowiki>S3RM_RESEARCH_LLM_MODEL</nowiki></code>을 설정할 때만 활성화되며, synthesis의 인용은 검색된 Lesson ID로 제한됩니다.

	=== 진행 중 프로젝트에서 메모 옮기기 ===		=== 진행 중 프로젝트에서 메모 옮기기 ===

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-19T02:07:46Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 19일 (일) 11:07 판
105번째 줄:		105번째 줄:
	- S3 Research Memory의 MCP 도구만 사용한다. generic MediaWiki API, 별도 위키·DB,		- S3 Research Memory의 MCP 도구만 사용한다. generic MediaWiki API, 별도 위키·DB,
	로컬 MCP 서버는 사용하거나 만들지 않는다.		로컬 MCP 서버는 사용하거나 만들지 않는다.
	- 프로젝트 소개, 진행 현황, 할 일, 일정, ~~회의록이나~~ 실행 로그 ~~자체를~~ 메모로 만들지		- 프로젝트 소개, 진행 현황, 할 일, 일정, 회의록을 메모로 만들지 않는다.
	~~않는다~~. 한 가지 문제와 결론을 메모 한 건으로 만든다.		자동화 작업·워크플로·CI·도구 호출의 성공·실패 상태, 재시도, 인증·연결 오류와 실행 로그
			자체도 메모로 만들지 않는다. 실패 자체가 연구 대상이고 단일 실행을 넘어 재사용할
			원인과 적용 조건을 확인 가능한 근거로 일반화한 독립 주장일 때만 후보로 삼는다.
			한 가지 문제와 결론을 메모 한 건으로 만든다.
	- 과거 대화나 저장 메모리를 실제로 읽을 수 없으면 읽었다고 가정하지 않는다. 접근한		- 과거 대화나 저장 메모리를 실제로 읽을 수 없으면 읽었다고 가정하지 않는다. 접근한
	자료의 범위와 접근하지 못한 범위를 마지막에 구분해 적는다.		자료의 범위와 접근하지 못한 범위를 마지막에 구분해 적는다.

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T10:09:46Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 19:09 판
7번째 줄:		7번째 줄:
	</onlyinclude>		</onlyinclude>

	위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결, 근거 ~~첨부와 같은~~ Lesson의 조건부 수정을 할 수 있습니다. 수정에는 기준 리비전과 기존 근거가 필요합니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.		위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결, 근거 첨부, 근거 검증 기록 추가와 Lesson의 조건부 수정을 할 수 있습니다. 수정에는 기준 리비전과 기존 근거가 필요합니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.

	서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 네 가지 변경 도구를 토큰 없이 사용할 수 있습니다. <code><nowiki>github</nowiki></code> 모드는 GitHub 로그인으로 MCP 전체를 보호합니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.		서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 다섯 가지 변경 도구를 토큰 없이 사용할 수 있습니다. <code><nowiki>github</nowiki></code> 모드는 GitHub 로그인으로 MCP 전체를 보호합니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.

	=== 처음 사용하는 순서 ===		=== 처음 사용하는 순서 ===
16번째 줄:		16번째 줄:
	# 아래에서 운영체제에 맞는 연결 문서를 열고 토큰을 먼저 저장합니다.		# 아래에서 운영체제에 맞는 연결 문서를 열고 토큰을 먼저 저장합니다.
	# 같은 문서의 에이전트 프롬프트를 사용하거나 클라이언트를 직접 연결합니다.		# 같은 문서의 에이전트 프롬프트를 사용하거나 클라이언트를 직접 연결합니다.
	# 도구 아홉 개와 <code><nowiki>search_lessons(limit=1)</nowiki></code> 응답을 확인합니다.		# 도구 열 개와 <code><nowiki>search_lessons(limit=1)</nowiki></code> 응답을 확인합니다.
	# [[#진행 중 프로젝트에서 메모 옮기기\|진행 중 프로젝트에서 메모 옮기기]]를 사용합니다.		# [[#진행 중 프로젝트에서 메모 옮기기\|진행 중 프로젝트에서 메모 옮기기]]를 사용합니다.
	읽기 전용 연결을 기본 경로로 안내하지 않습니다. 메모를 남길 사람은 토큰까지 설정해 쓰기 가능한 상태로 연결하세요. 토큰은 채팅창, 프로젝트 파일과 Git에 붙여넣지 않습니다.		읽기 전용 연결을 기본 경로로 안내하지 않습니다. 메모를 남길 사람은 토큰까지 설정해 쓰기 가능한 상태로 연결하세요. 토큰은 채팅창, 프로젝트 파일과 Git에 붙여넣지 않습니다.
75번째 줄:		75번째 줄:
	</nowiki></pre>		</nowiki></pre>

	정상이라면 다음 아홉 개 도구가 보입니다.		정상이라면 다음 열 개 도구가 보입니다.

	{\| class="wikitable"		{\| class="wikitable"
86번째 줄:		86번째 줄:
	\| <code><nowiki>audit_lessons</nowiki></code> \|\| <code><nowiki>attach_evidence</nowiki></code>		\| <code><nowiki>audit_lessons</nowiki></code> \|\| <code><nowiki>attach_evidence</nowiki></code>
	\|-		\|-
	\| \|\| <code><nowiki>~~revise_lesson~~</nowiki></code>		\| <code><nowiki>find_related_lessons</nowiki></code> \|\| <code><nowiki>record_evidence_verification</nowiki></code>
	\|-		\|-
	\| <code><nowiki>~~find_related_lessons~~</nowiki></code> \|\|		\| <code><nowiki>find_analogies</nowiki></code> \|\| <code><nowiki>revise_lesson</nowiki></code>
	\|-
	\| <code><nowiki>~~find_analogies~~</nowiki></code> \|\|
	\|}		\|}

135번째 줄:		133번째 줄:
	사실만 쓰고 interpretation에는 가능한 원인과 불확실성을 분리해 쓴다.		사실만 쓰고 interpretation에는 가능한 원인과 불확실성을 분리해 쓴다.
	5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 실행한다.		5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 실행한다.
	initial_evidence는 Lesson과 같은 revision에 원자적으로 저장된다. 추가 인용만		initial_evidence는 Lesson과 같은 revision에 원자적으로 저장된다. 추가 인용만
	attach_evidence로 붙인다. 논문 근거에는 실제 확인 범위를		attach_evidence로 붙인다. 논문 근거에는 실제 확인 범위를
	full_text, official_abstract, partial_source, metadata_only 중 정확히 표시한다.		full_text, official_abstract, partial_source, metadata_only 중 정확히 표시한다.
	확인 범위를 기록하지 못한 자료는 새 evidence로 붙이지 않으며, 기술 내용을		확인 범위를 기록하지 못한 자료는 새 evidence로 붙이지 않으며, 기술 내용을
	추측하지 않는다. 근거가 기억뿐이거나 위치를 확인할 수 없으면 쓰지 말고		추측하지 않는다. 근거가 기억뿐이거나 위치를 확인할 수 없으면 쓰지 말고
	'근거 필요' 후보로 남긴다. high ~~confidence 생성에는~~ full_text 또는		'근거 필요' 후보로 남긴다. 실제 자료를 읽은 경우에만 자료 식별자,
	~~official_abstract가 필요하다~~.		검사한 자료의 SHA-256, 위치, 확인 범위, 판정과 연결한 주장 필드를
			검증 기록으로 남긴다. high confidence는 full_text 또는 official_abstract의
			`supports` 검증이 observation, interpretation, reusable_lesson 세 필드를 모두
			뒷받침할 때만 쓴다.
	6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은		6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은
	제목과 중단 이유만 남기고 위키를 변경하지 않는다.		제목과 중단 이유만 남기고 위키를 변경하지 않는다.
	- 네 쓰기 도구 모두 새 작업마다 고유한 operation_id를 쓰고, 결과가 불분명한 재시도에는		- 다섯 쓰기 도구 모두 새 작업마다 고유한 operation_id를 쓰고, 결과가 불분명한 재시도에는
	원래 ID와 요청을 그대로 쓴다. 내부 호환 필드는 서버에 맡기며 삭제와 이동은 하지 않는다.		원래 ID와 요청을 그대로 쓴다. 내부 호환 필드는 서버에 맡기며 삭제와 이동은 하지 않는다.
	같은 Lesson의 정정·보강은 revision으로 남기고, supersedes는 실제로 다른 주장이		같은 Lesson의 정정·보강은 revision으로 남기고, supersedes는 실제로 다른 주장이
153번째 줄:		154번째 줄:
	보고해:		보고해:
	1. 실제로 확인한 자료 범위와 확인하지 못한 범위		1. 실제로 확인한 자료 범위와 확인하지 못한 범위
	2. 생성·근거 추가·관계 추가·중복으로 건너뜀을 구분한 Lesson ID와 제목		2. 생성·근거 추가·검증 추가·관계 추가·중복으로 건너뜀을 구분한 Lesson ID와 제목
	3. 위키에 쓰지 않은 '근거 필요' 후보와 빠진 정보		3. 위키에 쓰지 않은 '근거 필요' 후보와 빠진 정보
	4. 접근 가능한 범위를 모두 확인했는지, 아니면 5건 제한 때문에 남은 후보가 있는지		4. 접근 가능한 범위를 모두 확인했는지, 아니면 5건 제한 때문에 남은 후보가 있는지
	</nowiki></pre>		</nowiki></pre>

	생성·수정한 메모도 바로 검색됩니다. 반환된 <code><nowiki>Lesson:</nowiki></code> ID와 revision을 <code><nowiki>audit_lessons</nowiki></code>로 확인하고, 위키에서 관찰과 해석이 섞이지 않았는지, 인용으로 원본을 다시 찾을 수 있는지, 공개하면 안 되는 내용이 없는지 확인하세요. 문제가 있으면 새 revision으로 고칩니다.		생성·수정한 메모도 바로 검색됩니다. 반환된 <code><nowiki>Lesson:</nowiki></code> ID와 revision을 <code><nowiki>audit_lessons</nowiki></code>로 확인하고, 위키에서 관찰과 해석이 섞이지 않았는지, 인용으로 원본을 다시 찾을 수 있는지, 공개하면 안 되는 내용이 없는지 확인하세요. 문제가 있으면 새 revision으로 고칩니다. 감사는 저장된 구조, digest, 검증 수령 기록의 일관성만 확인하며 외부 자료의 사실 진위를 자동으로 판정하지 않습니다.

	=== 무엇을 남기나 ===		=== 무엇을 남기나 ===

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T08:36:54Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 17:36 판
130번째 줄:		130번째 줄:
	analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만		analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만
	link_lessons로 연결한다. 관련성이 불명확하면 관계를 만들지 않는다.		link_lessons로 연결한다. 관련성이 불명확하면 관계를 만들지 않는다.
	4. 새 메모에는 title, question, attempt, context, observation, interpretation,		4. 새 메모에는 고유한 operation_id, title, question, attempt, context, observation,
	reusable_lesson, applicability, confidence, ~~evidence와~~ 필요하면 안정적인 ~~lesson_id만~~		interpretation, reusable_lesson, applicability, confidence, evidence, 구조화된
	넣는다. observation에는 직접 확인한 사실만 쓰고 interpretation에는 가능한 원인과		initial_evidence와 필요하면 안정적인 lesson_id를 넣는다. observation에는 직접 확인한
	불확실성을 분리해 쓴다~~. applicability에는 적용 조건과 알려진 예외를 적는다~~.		사실만 쓰고 interpretation에는 가능한 원인과 불확실성을 분리해 쓴다.
	5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 ~~실행하고,~~		5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 실행한다.
	~~곧바로~~ attach_evidence로 ~~그 인용을~~ 붙인다. 논문 근거에는 실제 확인 범위를		initial_evidence는 Lesson과 같은 revision에 원자적으로 저장된다. 추가 인용만
			attach_evidence로 붙인다. 논문 근거에는 실제 확인 범위를
	full_text, official_abstract, partial_source, metadata_only 중 정확히 표시한다.		full_text, official_abstract, partial_source, metadata_only 중 정확히 표시한다.
	확인 범위를 기록하지 ~~못하면 not_recorded를 쓰며~~, 기술 내용을 추측하지 않는다.		확인 범위를 기록하지 못한 자료는 새 evidence로 붙이지 않으며, 기술 내용을
	근거가 기억뿐이거나 위치를 확인할 수 없으면 쓰지 말고 '근거 필요' 후보로 남긴다.		추측하지 않는다. 근거가 기억뿐이거나 위치를 확인할 수 없으면 쓰지 말고
			'근거 필요' 후보로 남긴다. high confidence 생성에는 full_text 또는
			official_abstract가 필요하다.
	6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은		6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은
	제목과 중단 이유만 남기고 위키를 변경하지 않는다.		제목과 중단 이유만 남기고 위키를 변경하지 않는다.
	- ~~create_lesson_draft의~~ 내부 호환 필드는 서버에 ~~맡긴다.~~ 삭제와 이동은 하지 않는다.		- 네 쓰기 도구 모두 새 작업마다 고유한 operation_id를 쓰고, 결과가 불분명한 재시도에는
			원래 ID와 요청을 그대로 쓴다. 내부 호환 필드는 서버에 맡기며 삭제와 이동은 하지 않는다.
	같은 Lesson의 정정·보강은 revision으로 남기고, supersedes는 실제로 다른 주장이		같은 Lesson의 정정·보강은 revision으로 남기고, supersedes는 실제로 다른 주장이
	이전 주장을 대신할 때만 사용한다. evidence note나 Technical Review 중복 메모를		이전 주장을 대신할 때만 사용한다. evidence note나 Technical Review 중복 메모를

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T06:30:28Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 15:30 판
124번째 줄:		124번째 줄:
	2. 같은 주장과 적용 범위의 메모가 있으면 새 메모를 만들지 않는다. 출처만 늘어나면		2. 같은 주장과 적용 범위의 메모가 있으면 새 메모를 만들지 않는다. 출처만 늘어나면
	attach_evidence를 사용한다. 기존 핵심 내용을 보강해야 하면 get_lesson으로 현재		attach_evidence를 사용한다. 기존 핵심 내용을 보강해야 하면 get_lesson으로 현재
	revision을 읽고 근거를 먼저 ~~붙인 뒤 revise_lesson을~~ 사용한다.		revision을 읽고 근거를 먼저 붙인다. 이어지는 revise_lesson에는 attach_evidence
			응답의 current_revision_id를 expected_revision_id로 사용한다. 그 사이 다른 변경이
			있었다면 get_lesson을 다시 읽고 변경안을 재계산한다.
	3. 주장이 다르지만 관련 메모가 있으면 새 메모를 만든 뒤 supports, contradicts,		3. 주장이 다르지만 관련 메모가 있으면 새 메모를 만든 뒤 supports, contradicts,
	analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만		analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T04:04:32Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 13:04 판
93번째 줄:		93번째 줄:
	\|}		\|}

	검색 기본값은 기존 전체 텍스트·단어 겹침 방식인 <code><nowiki>legacy</nowiki></code>입니다. 서버 담당자가 의미 검색을 켠 환경에서는 <code><nowiki>search_lessons</nowiki></code>나 <code><nowiki>find_analogies</nowiki></code>에 <code><nowiki>retrieval_mode=hybrid_v1</nowiki></code>을 지정해 표현이 다른 후보도 함께 찾을 수 있습니다. 결과의 <code><nowiki>effective_mode</nowiki></code>와 <code><nowiki>semantic_status</nowiki></code>로 실제 적용 여부를 확인하세요.		검색 기본값은 기존 전체 텍스트·단어 겹침 방식인 <code><nowiki>legacy</nowiki></code>입니다. 서버 담당자가 의미 검색을 켠 환경에서는 <code><nowiki>search_lessons</nowiki></code>나 <code><nowiki>find_analogies</nowiki></code>에 <code><nowiki>retrieval_mode=hybrid_v1</nowiki></code>을 지정해 표현이 다른 후보도 함께 찾을 수 있습니다. 결과의 <code><nowiki>effective_mode</nowiki></code>와 <code><nowiki>semantic_status</nowiki></code>로 실제 적용 여부를 확인하세요. 이 서버의 GPU에서 선택적으로 실행하는 번들 모델과 설정 방법은 [[Help:S3 연구 메모리/설치와 검증#선택적 의미 검색\|설치·설정의 의미 검색]]에 있습니다.

	=== 진행 중 프로젝트에서 메모 옮기기 ===		=== 진행 중 프로젝트에서 메모 옮기기 ===

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T03:30:29Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 12:30 판
2번째 줄:		2번째 줄:
	''이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.''		''이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.''

			<onlyinclude>
	S3 연구 메모리는 연구실이 함께 쓰는 지식 저장소입니다. 프로젝트가 끝난 뒤에도 시행착오를 다시 찾을 수 있게, 시도한 방법과 실제 결과를 짧게 기록합니다. 실험 원본이나 일정표는 여기 쌓지 않습니다.		S3 연구 메모리는 연구실이 함께 쓰는 지식 저장소입니다. 프로젝트가 끝난 뒤에도 시행착오를 다시 찾을 수 있게, 시도한 방법과 실제 결과를 짧게 기록합니다. 실험 원본이나 일정표는 여기 쌓지 않습니다.

			</onlyinclude>

	위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결, 근거 첨부와 같은 Lesson의 조건부 수정을 할 수 있습니다. 수정에는 기준 리비전과 기존 근거가 필요합니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.		위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결, 근거 첨부와 같은 Lesson의 조건부 수정을 할 수 있습니다. 수정에는 기준 리비전과 기존 근거가 필요합니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-18T03:14:11Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 18일 (토) 12:14 판
4번째 줄:		4번째 줄:
	S3 연구 메모리는 연구실이 함께 쓰는 지식 저장소입니다. 프로젝트가 끝난 뒤에도 시행착오를 다시 찾을 수 있게, 시도한 방법과 실제 결과를 짧게 기록합니다. 실험 원본이나 일정표는 여기 쌓지 않습니다.		S3 연구 메모리는 연구실이 함께 쓰는 지식 저장소입니다. 프로젝트가 끝난 뒤에도 시행착오를 다시 찾을 수 있게, 시도한 방법과 실제 결과를 짧게 기록합니다. 실험 원본이나 일정표는 여기 쌓지 않습니다.

	위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 ~~연결과~~ 근거 ~~첨부만~~ 할 수 있습니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.		위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결, 근거 첨부와 같은 Lesson의 조건부 수정을 할 수 있습니다. 수정에는 기준 리비전과 기존 근거가 필요합니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.

	서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 세 변경 ~~도구도~~ 토큰 없이 사용할 수 있습니다. <code><nowiki>github</nowiki></code> 모드는 GitHub 로그인으로 MCP 전체를 보호합니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.		서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 네 가지 변경 도구를 토큰 없이 사용할 수 있습니다. <code><nowiki>github</nowiki></code> 모드는 GitHub 로그인으로 MCP 전체를 보호합니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.

	=== 처음 사용하는 순서 ===		=== 처음 사용하는 순서 ===
13번째 줄:		13번째 줄:
	# 아래에서 운영체제에 맞는 연결 문서를 열고 토큰을 먼저 저장합니다.		# 아래에서 운영체제에 맞는 연결 문서를 열고 토큰을 먼저 저장합니다.
	# 같은 문서의 에이전트 프롬프트를 사용하거나 클라이언트를 직접 연결합니다.		# 같은 문서의 에이전트 프롬프트를 사용하거나 클라이언트를 직접 연결합니다.
	# 도구 일곱 개와 <code><nowiki>search_lessons(limit=1)</nowiki></code> 응답을 확인합니다.		# 도구 아홉 개와 <code><nowiki>search_lessons(limit=1)</nowiki></code> 응답을 확인합니다.
	# [[#진행 중 프로젝트에서 메모 옮기기\|진행 중 프로젝트에서 메모 옮기기]]를 사용합니다.		# [[#진행 중 프로젝트에서 메모 옮기기\|진행 중 프로젝트에서 메모 옮기기]]를 사용합니다.
	읽기 전용 연결을 기본 경로로 안내하지 않습니다. 메모를 남길 사람은 토큰까지 설정해 쓰기 가능한 상태로 연결하세요. 토큰은 채팅창, 프로젝트 파일과 Git에 붙여넣지 않습니다.		읽기 전용 연결을 기본 경로로 안내하지 않습니다. 메모를 남길 사람은 토큰까지 설정해 쓰기 가능한 상태로 연결하세요. 토큰은 채팅창, 프로젝트 파일과 Git에 붙여넣지 않습니다.
72번째 줄:		72번째 줄:
	</nowiki></pre>		</nowiki></pre>

	정상이라면 다음 일곱 개 도구가 보입니다.		정상이라면 다음 아홉 개 도구가 보입니다.

	{\| class="wikitable"		{\| class="wikitable"
	! 읽기 !! 메모 쓰기		! 읽기 !! 쓰기
	\|-		\|-
	\| <code><nowiki>search_lessons</nowiki></code> \|\| <code><nowiki>create_lesson_draft</nowiki></code>		\| <code><nowiki>search_lessons</nowiki></code> \|\| <code><nowiki>create_lesson_draft</nowiki></code>
81번째 줄:		81번째 줄:
	\| <code><nowiki>get_lesson</nowiki></code> \|\| <code><nowiki>link_lessons</nowiki></code>		\| <code><nowiki>get_lesson</nowiki></code> \|\| <code><nowiki>link_lessons</nowiki></code>
	\|-		\|-
	\| <code><nowiki>~~find_related_lessons~~</nowiki></code> \|\| <code><nowiki>attach_evidence</nowiki></code>		\| <code><nowiki>audit_lessons</nowiki></code> \|\| <code><nowiki>attach_evidence</nowiki></code>
			\|-
			\| \|\| <code><nowiki>revise_lesson</nowiki></code>
			\|-
			\| <code><nowiki>find_related_lessons</nowiki></code> \|\|
	\|-		\|-
	\| <code><nowiki>find_analogies</nowiki></code> \|\|		\| <code><nowiki>find_analogies</nowiki></code> \|\|
	\|}		\|}

			검색 기본값은 기존 전체 텍스트·단어 겹침 방식인 <code><nowiki>legacy</nowiki></code>입니다. 서버 담당자가 의미 검색을 켠 환경에서는 <code><nowiki>search_lessons</nowiki></code>나 <code><nowiki>find_analogies</nowiki></code>에 <code><nowiki>retrieval_mode=hybrid_v1</nowiki></code>을 지정해 표현이 다른 후보도 함께 찾을 수 있습니다. 결과의 <code><nowiki>effective_mode</nowiki></code>와 <code><nowiki>semantic_status</nowiki></code>로 실제 적용 여부를 확인하세요.

	=== 진행 중 프로젝트에서 메모 옮기기 ===		=== 진행 중 프로젝트에서 메모 옮기기 ===
113번째 줄:		119번째 줄:
	한 번에 최대 5건만 받고, 필요할 때만 find_related_lessons나		한 번에 최대 5건만 받고, 필요할 때만 find_related_lessons나
	find_analogies로 확인한다.		find_analogies로 확인한다.
	2. 같은 주장과 적용 범위의 메모가 있으면 새 메모를 만들지 않는다. ~~기존 메모에~~		2. 같은 주장과 적용 범위의 메모가 있으면 새 메모를 만들지 않는다. 출처만 늘어나면
	~~새 근거의 영구 인용이 있을 때만~~ attach_evidence를 ~~사용하고, 쓰기 가능 여부는~~		attach_evidence를 사용한다. 기존 핵심 내용을 보강해야 하면 get_lesson으로 현재
	~~서버 판정에 따른다~~.		revision을 읽고 근거를 먼저 붙인 뒤 revise_lesson을 사용한다.
	3. 주장이 다르지만 관련 메모가 있으면 새 메모를 만든 뒤 supports, contradicts,		3. 주장이 다르지만 관련 메모가 있으면 새 메모를 만든 뒤 supports, contradicts,
	analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만		analogous_to, failed_because, works_when, suggests, supersedes 중 정확한 관계만
124번째 줄:		130번째 줄:
	불확실성을 분리해 쓴다. applicability에는 적용 조건과 알려진 예외를 적는다.		불확실성을 분리해 쓴다. applicability에는 적용 조건과 알려진 예외를 적는다.
	5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 실행하고,		5. 다시 찾을 수 있는 인용이 최소 한 개 있을 때만 create_lesson_draft를 실행하고,
	곧바로 attach_evidence로 그 인용을 붙인다. 근거가 기억뿐이거나 위치를 확인할 수		곧바로 attach_evidence로 그 인용을 붙인다. 논문 근거에는 실제 확인 범위를
	없으면 쓰지 말고 '근거 필요' 후보로 남긴다.		full_text, official_abstract, partial_source, metadata_only 중 정확히 표시한다.
			확인 범위를 기록하지 못하면 not_recorded를 쓰며, 기술 내용을 추측하지 않는다.
			근거가 기억뿐이거나 위치를 확인할 수 없으면 쓰지 말고 '근거 필요' 후보로 남긴다.
	6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은		6. 이번 실행에서는 생성 또는 변경한 메모를 합쳐 최대 5건까지만 처리한다. 그 이상은
	제목과 중단 이유만 남기고 위키를 변경하지 않는다.		제목과 중단 이유만 남기고 위키를 변경하지 않는다.
	- create_lesson_draft의 내부 호환 필드는 서버에 맡긴다. 삭제, ~~이동, 기존 본문~~		- create_lesson_draft의 내부 호환 필드는 서버에 맡긴다. 삭제와 이동은 하지 않는다.
	~~덮어쓰기는 하지~~ 않는다~~. supersedes는 관계로만 연결한다~~.		같은 Lesson의 정정·보강은 revision으로 남기고, supersedes는 실제로 다른 주장이
			이전 주장을 대신할 때만 사용한다. evidence note나 Technical Review 중복 메모를
			본문 수정 대신 만들지 않는다.

	별도 확인 질문 없이 위 조건을 만족하는 항목만 처리해. 마지막에는 다음 순서로 짧게		별도 확인 질문 없이 위 조건을 만족하는 항목만 처리해. 마지막에는 다음 순서로 짧게
139번째 줄:		149번째 줄:
	</nowiki></pre>		</nowiki></pre>

	~~생성된~~ 메모도 바로 검색됩니다. 반환된 <code><nowiki>Lesson:</nowiki></code> ~~ID를~~ 위키에서 열고 관찰과 해석이 섞이지 않았는지, 인용으로 원본을 다시 찾을 수 있는지, 공개하면 안 되는 내용이 없는지 확인하세요. 문제가 있으면 ~~'''메모 편집'''에서 바로~~ 고칩니다.		생성·수정한 메모도 바로 검색됩니다. 반환된 <code><nowiki>Lesson:</nowiki></code> ID와 revision을 <code><nowiki>audit_lessons</nowiki></code>로 확인하고, 위키에서 관찰과 해석이 섞이지 않았는지, 인용으로 원본을 다시 찾을 수 있는지, 공개하면 안 되는 내용이 없는지 확인하세요. 문제가 있으면 새 revision으로 고칩니다.

	=== 무엇을 남기나 ===		=== 무엇을 남기나 ===

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-16T14:32:08Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 16일 (목) 23:32 판
169번째 줄:		169번째 줄:
	* [[Help:S3 연구 메모리/보안\|계정·비밀·네트워크 보안]]		* [[Help:S3 연구 메모리/보안\|계정·비밀·네트워크 보안]]
	* [[Help:S3 연구 메모리/아키텍처\|데이터 계약과 아키텍처]]		* [[Help:S3 연구 메모리/아키텍처\|데이터 계약과 아키텍처]]
			* [[Help:S3 연구 메모리/벡터·하이브리드 검색 설계\|벡터·하이브리드 검색 설계]]
	기여:		기여:

S3Admin: S3 연구 메모리 저장소 문서 동기화

2026-07-16T13:12:14Z

S3 연구 메모리 저장소 문서 동기화

← 이전 판		2026년 7월 16일 (목) 22:12 판
6번째 줄:		6번째 줄:
	위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결과 근거 첨부만 할 수 있습니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.		위키 본문과 MCP 검색은 공개될 수 있습니다. 에이전트는 연구실 공용 토큰으로 메모 작성, 관계 연결과 근거 첨부만 할 수 있습니다. 삭제, 이동과 위키 관리 기능은 제공하지 않습니다. 저장한 메모는 바로 검색되고 모든 수정은 MediaWiki 이력에 남습니다.

	서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 세 변경 도구도 토큰 없이 사용할 수 있습니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.		서버가 <code><nowiki>S3RM_MCP_WRITE_AUTH_MODE=open</nowiki></code>으로 운영되는 동안에는 세 변경 도구도 토큰 없이 사용할 수 있습니다. <code><nowiki>github</nowiki></code> 모드는 GitHub 로그인으로 MCP 전체를 보호합니다. 공개 시험이 끝나면 <code><nowiki>token</nowiki></code>으로 되돌립니다.

	=== 처음 사용하는 순서 ===		=== 처음 사용하는 순서 ===