Plugin SDK 영향 분석은(는) 무엇을 하나요?

현재 ClawHub 인벤토리와 ClawHub에 없는 플러그인을 포함한 모든 번들 OpenClaw 플러그인의 소스 스캔을 결합하여 호환성 결정을 지원합니다. 정적 사용 현황은 종속성을 식별하지만, 실행이나 특정 동작에 대한 의존성을 증명하지는 않습니다. 승인 및 폐기 규칙은 SDK 경계 가이드를 권위 있는 참조로 유지하십시오.

조사

대체 SDK 내보내기 및 런타임 경로를 포함하여 소스에서 영향을 받는 모든 공개 표면을 식별합니다. 정의 및 알려진 호출자에 대한 철자를 확인하십시오. 잘못된 키는 설득력 있는 0을 반환할 수 있습니다. 그룹화된 파사드, SDK 헬퍼 및 등록 리더도 추적하십시오. 평면 별칭은 지원되는 그룹화된 메서드를 구현하면서 직접적인 플러그인 호출이 0일 수 있습니다.
깨끗한 OpenClaw 체크아웃에서 Plugin Inspector의 정적 소스 분석을 사용하여 모든 번들 플러그인을 스캔합니다. 설치된 Inspector 0.4.3 이상을 재사용하십시오. 그렇지 않으면 라이프사이클 스크립트 없이 별도의 임시 디렉터리에 설치하십시오.
```
inspector_dir=$(mktemp -d)
npm install --prefix "$inspector_dir" --ignore-scripts @openclaw/[email protected]
node {baseDir}/scripts/scan-bundled.mjs \
  --inspector "$inspector_dir/node_modules/@openclaw/plugin-inspector" \
  --out /tmp/openclaw-bundled-sdk-usage.json
```
스캐너는 기본적으로 이 스킬의 체크아웃을 사용합니다. --root <checkout>은 다른 체크아웃을 선택합니다. extensions/*/openclaw.plugin.json을 발견하며, 플러그인 코드를 절대 실행하지 않고, 커밋, 입력 지문, Inspector 버전, 모든 플러그인 및 불완전한 분석을 기록합니다. 실패하거나 시간 초과된 스캔은 공백으로 남습니다. 선언된 진입점이 없는 플러그인도 Inspector가 암시적 진입점을 놓칠 수 있기 때문에 적용 범위 공백으로 남습니다. 중단된 코퍼스 스캔은 완료된 인벤토리로 사용할 수 없습니다. 소스가 변경되지 않은 상태에서 여러 쿼리에 보고서를 재사용하십시오. 변경된 커밋, 플러그인 명단 또는 커밋되지 않은 소스는 보고서를 무효화합니다. 영수증을 편집하지 말고 다시 스캔하십시오.
두 소스 모두에서 각 표준 키를 쿼리합니다.
```
node {baseDir}/scripts/query.mjs 'api-member:api.registerTool' \
  --bundled /tmp/openclaw-bundled-sdk-usage.json
```
"지난 3개월 이내에 업데이트됨"의 경우 --months 3을 추가하십시오. 이는 최신 적격 공개 릴리스가 현재로부터 3달력 월 이내에 업로드되었음을 의미합니다(UTC 기준, 월말은 고정됨). 목록 편집 및 재스캔은 업데이트로 간주되지 않습니다. 저장된 릴리스 날짜는 생성/업로드 시간입니다. 공개 승인은 나중에 발생할 수 있습니다. --since 2026-07-16T12:00:00Z는 명시적 기준을 허용합니다. releaseWindow에서 정확한 포함 기준을 보고하고 추정 날짜를 보고하지 마십시오. 공개 소비자와 적용 범위는 모든 페이지에서 동일한 창을 사용합니다. 번들 소스에는 비교할 수 있는 업로드 날짜가 없습니다. 최근 릴리스에 대한 질문의 경우에도 필터링되지 않은 상태로 별도로 보고하십시오. 결합된 개수는 해당 공개 릴리스 창과 현재 번들 소스의 합집합이며, 최근 릴리스의 개수가 아닙니다.

헬퍼는 빈 중간 페이지를 포함하여 모든 사용 및 적용 범위 페이지를 따릅니다. 개수와 적용 범위는 모든 결과를 포함합니다. items, gaps 및 warnings에는 output.omitted에서 생략된 개수와 함께 제한된 예제가 포함됩니다. 혼합 참조는 런타임 및 유형 합계 모두에 포함됩니다. 모든 소비자 또는 공백이 필요한 조사의 경우 --full 출력을 파일에 저장하고 섹션으로 읽으십시오.
```
node {baseDir}/scripts/query.mjs 'api-member:api.registerTool' \
  --bundled /tmp/openclaw-bundled-sdk-usage.json --full > sdk-usage.json
```
--help는 로컬 엔드포인트 및 순회 제한을 문서화합니다.
제안된 변경 사항에 대해 일치하는 증거를 검사합니다. 메서드 호출이 변경되는 동작을 사용하지 않을 수 있습니다. 유형 전용 소비자는 유형/내보내기 제거에 여전히 중요합니다. 관련 멤버를 별도로 쿼리하십시오. 모듈 가져오기가 모든 내보내기의 사용을 증명하지는 않습니다. 플러그인의 반복 참조는 하나의 소비자로 계산됩니다.
사용 횟수 질문의 경우 키, 쿼리 시간, 정확한 릴리스 창(요청된 경우), ClawHub 및 번들 개수, 결합된 개수, 번들 커밋 및 두 적용 범위 공백을 보고하십시오. 최상위 distinctPlugins 및 coverage는 ClawHub 전용으로 유지됩니다. bundled는 소스 결과를 설명합니다. combined는 정확한 패키지 ID를 한 번 병합합니다. 일부 번들 플러그인에는 패키지 이름이 없습니다. 공개 일치와 중복될 수 있는 경우 combined.distinctPlugins는 null이고 distinctPluginBounds는 가능한 범위를 보고합니다. observedPluginIdentities는 불확실한 중복 이전의 소스 ID 수를 계산합니다. 정확한 개수가 아닌 범위를 보고하십시오. 다른 이름은 구별된 상태로 유지됩니다. 표시 이름에서 별칭을 추측하지 마십시오. 번들 증거가 없으면 결합된 영향을 사용할 수 없습니다. 제안된 SDK 변경의 경우 일치하는 증거, 간접 호출자 및 호환성 권장 사항도 보고하십시오. 변경 조사를 유지 관리자의 결정으로 마무리하십시오. 동작 유지, 마이그레이션과 함께 폐기 또는 기존 정책에 따라 진행하십시오. 개수에서 권한을 추론하지 마십시오.

표준 키

표면	예제
SDK 모듈	`sdk-module:openclaw/plugin-sdk/core`
명명된 SDK 내보내기	`sdk-export:openclaw/plugin-sdk/core#OpenClawPluginApi`
플러그인 API 메서드	`api-member:api.registerTool`
호스트 런타임 멤버	`runtime-member:runtime.channel.reply.dispatchReplyFromConfig`
명명된 훅	`hook:hook.before_agent_start`
매니페스트 계약	`manifest-contract:manifest.contracts.tools:example_tool`

키는 로컬 별칭이 아닌 SDK ID를 설명합니다. api.runtime 멤버는 runtime.*로 정규화됩니다. 인벤토리는 지원 및 폐기된 참조를 포함합니다. 비어 있지 않은 deprecationCodes는 기존 경고와 연결된 항목을 선택합니다. 플러그인별 검사는 https://clawhub.ai/api/v1/sdk-usage/plugin?package=<encoded-name>에서 사용할 수 있습니다. 전체 인벤토리를 얻으려면 nextCursor가 null이 될 때까지 따르십시오.

결과 해석

결과	보고서
관찰된 소비자	공개, 번들 및 결합된 개수를 별도 범위와 함께 보고하십시오. 동작 변경을 판단하기 전에 증거를 검사하십시오.
관찰된 소비자 없음, 완전한 적용 범위	"N개의 공개/번들 플러그인 ID에서 정적 참조가 감지되지 않음." 두 스캔이 모두 필요합니다. 비공개 비번들 플러그인 및 번들되지 않은 종속성은 제외됩니다. API를 아무도 사용하지 않는다는 증거는 아닙니다.
부분적, 실패, 누락, 호환되지 않음 또는 해결되지 않은 분석	관찰된 일치, 공백 개수 및 대표적인 공백을 명시하십시오. 일치가 0이면 영향을 알 수 없습니다.
빈 코퍼스	적격 플러그인이 관찰되지 않았습니다. 이는 생태계 보장을 제공하지 않습니다.
사용할 수 없는 엔드포인트, 잘못된 결과 또는 불완전한 순회	영향을 알 수 없습니다. 오류를 보존하고 로컬 증거를 사용하십시오. 0을 대체하지 마십시오.

적용 범위는 현재 릴리스/아티팩트 및 분석 버전에 연결됩니다. 적격 ClawHub 보고서에는 inputKind: "artifact"가 있습니다. 번들 보고서는 "source"를 사용합니다. 소스 체크아웃 벤치마크는 게시된 패키지의 내용을 확인할 수 없습니다. 소스 전용 유형 참조는 SDK 유형 및 내보내기 제거에 여전히 중요합니다. 각 일치의 소스를 보존하십시오. 오래된 스캔 타임스탬프만으로는 변경 불가능한 아티팩트가 오래되었다고 단정할 수 없습니다. 증거는 샘플링됩니다. 각 스캔은 증거/알 수 없는 한계를 보고합니다. 페이지는 하나의 스냅샷이 아닌 실시간 읽기입니다. 조사 중에 릴리스 또는 가시성이 변경되면 다시 실행하십시오. 헬퍼는 관찰된 변경 사항을 플래그로 표시하지만 트랜잭션 전체 스냅샷을 설정할 수 없습니다.

소비자가 관찰되지 않았다는 이유만으로 보안 문제를 무시하지 마십시오. 사용 증거가 호환성 위험에 어떻게 영향을 미치는지 설명하십시오. 보안 및 SDK 소유자는 여전히 수정 사항과 일반 마이그레이션 기간에 대한 예외를 결정합니다.

Plugin SDK 영향 분석