ssampin-ai-bridge 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -0
- package/dist/index.js +2978 -0
- package/dist/registerCli.js +304 -0
- package/package.json +29 -0
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# ssampin-ai-bridge
|
|
2
|
+
|
|
3
|
+
쌤핀(SsamPin, 교사용 데스크톱 앱)의 **로컬 데이터를 외부 AI와 API 키 없이** 안전하게 연결하는 브릿지(MCP 서버 + 등록 CLI). Claude·Codex(GPT)·Antigravity(Gemini) 세 가지 AI 클라이언트를 **동등하게** 지원합니다.
|
|
4
|
+
|
|
5
|
+
> 학생·교사 개인정보는 **토큰화·탈식별·동의 게이트**를 거쳐 모델로 나갑니다. 자세한 개인정보 모델과 정직한 한계는 https://ssampin.com/ai-bridge 를 참고하세요.
|
|
6
|
+
|
|
7
|
+
## 빠른 시작 (B안 · CLI)
|
|
8
|
+
|
|
9
|
+
> 대부분의 선생님은 **쌤핀 앱 안에서 "설정 → AI 연결" 원클릭**(A안)을 쓰면 됩니다. 아래는 터미널에 익숙한 사용자를 위한 방법입니다.
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# 전역 설치 권장(등록되는 서버 경로가 안정적입니다)
|
|
13
|
+
npm install -g ssampin-ai-bridge
|
|
14
|
+
|
|
15
|
+
# 3개 클라이언트 중 원하는 곳에 등록
|
|
16
|
+
ssampin-ai-bridge register claude --data-dir "%APPDATA%/쌤핀/data"
|
|
17
|
+
ssampin-ai-bridge register codex --data-dir "%APPDATA%/쌤핀/data"
|
|
18
|
+
ssampin-ai-bridge register antigravity --data-dir "%APPDATA%/쌤핀/data"
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
또는 설치 없이 한 번만:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npx ssampin-ai-bridge register claude --data-dir "%APPDATA%/쌤핀/data"
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
등록 후 해당 AI 앱(또는 codex)을 **재시작**하면 도구가 나타납니다.
|
|
28
|
+
|
|
29
|
+
## 클라이언트별 등록 메커니즘 (동등 지원)
|
|
30
|
+
|
|
31
|
+
| 클라이언트 | 메커니즘 |
|
|
32
|
+
|---|---|
|
|
33
|
+
| **claude** (Claude Desktop) | 설정 파일 `claude_desktop_config.json` 의 `mcpServers` 안전 병합(기존 서버 보존 + 자동 백업) |
|
|
34
|
+
| **codex** (GPT) | `codex mcp add` 실행(codex CLI 필요 — 미설치 시 실행할 명령을 안내) |
|
|
35
|
+
| **antigravity** (Gemini) | 설정 파일 `~/.gemini/antigravity/mcp_config.json` 안전 병합(보존 + 백업) |
|
|
36
|
+
|
|
37
|
+
## 게이트 (기본 전부 꺼짐)
|
|
38
|
+
|
|
39
|
+
| 옵션 | 효과 |
|
|
40
|
+
|---|---|
|
|
41
|
+
| `--allow-content` | 관찰 내용 원문 노출(`get_observations`) 허용 |
|
|
42
|
+
| `--allow-write` | 관찰 기록 쓰기(`add_observation`) 허용 |
|
|
43
|
+
|
|
44
|
+
옵션을 주지 않으면 명단·자리 같은 **토큰화된 정보만** 다룹니다.
|
|
45
|
+
|
|
46
|
+
## 안전·프라이버시 (꼭 읽으세요)
|
|
47
|
+
|
|
48
|
+
- **토큰화는 "실명만" 가립니다.** 토큰화만으로 완전한 익명이 되지 않으며, 관찰 내용 맥락으로 재식별될 수 있습니다.
|
|
49
|
+
- **`get_observations` 는 관찰 원문이 외부 AI로 나갑니다.** 게이트/동의가 켜진 경우에만 동작합니다.
|
|
50
|
+
- **생기부는 법정 기록입니다.** 점검 도구는 어휘 근거 확인일 뿐, 모든 문장은 교사가 직접 사실 확인·책임져야 합니다.
|
|
51
|
+
|
|
52
|
+
## 명령
|
|
53
|
+
|
|
54
|
+
```
|
|
55
|
+
ssampin-ai-bridge register <claude|codex|antigravity|gemini> [--data-dir <경로>] [--allow-content] [--allow-write] [--name <이름>] [--dry-run]
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
- `--dry-run` : 실제 변경 없이 수행될 등록 계획(JSON)만 출력
|
|
59
|
+
- `ssampin-mcp` : MCP 서버를 직접 실행하는 진입(보통 클라이언트가 자동 실행)
|
|
60
|
+
|
|
61
|
+
## 라이선스
|
|
62
|
+
|
|
63
|
+
GPL-3.0
|