xkat-cli 1.1.0 → 1.1.1
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 +18 -4
- package/package.json +1 -1
- package/scripts/install.js +3 -1
package/README.md
CHANGED
|
@@ -4,9 +4,10 @@ xKat Agent는 브라우저 기반의 코딩 학습 플랫폼과 사용자의 로
|
|
|
4
4
|
|
|
5
5
|
## 주요 기능
|
|
6
6
|
|
|
7
|
-
-
|
|
7
|
+
- **무설치 로컬 셸 브릿지**: 브라우저의 웹 IDE 터미널을 로컬 셸에 직접 연결합니다. 별도 설치/설정 없이 `npx xkat up` 한 번으로 현재 사용자 권한의 네이티브 셸(PTY)을 띄웁니다.
|
|
8
8
|
- **실시간 파일 동기화**: 로컬 작업 디렉토리의 파일 변경(VFS)을 감지하여 웹 대시보드와 즉시 동기화합니다.
|
|
9
|
-
- **보안 중심 설계**: 127.0.0.1 루프백
|
|
9
|
+
- **보안 중심 설계**: 127.0.0.1 루프백 바인딩과 Origin 검사를 통해 안전한 로컬 제어를 보장합니다.
|
|
10
|
+
- **(선택) SSH 모드**: 자격 증명(사용자/비밀번호)을 입력하면 로컬 SSH 서버로 연결할 수도 있습니다. 기본값은 무설치 직접 셸입니다.
|
|
10
11
|
|
|
11
12
|
## 시작하기
|
|
12
13
|
|
|
@@ -19,14 +20,14 @@ npx xkat up
|
|
|
19
20
|
또는 전역 설치를 원할 경우:
|
|
20
21
|
|
|
21
22
|
```bash
|
|
22
|
-
npm install -g xkat
|
|
23
|
+
npm install -g xkat-cli
|
|
23
24
|
xkat up
|
|
24
25
|
```
|
|
25
26
|
|
|
26
27
|
## 시스템 요구 사항
|
|
27
28
|
|
|
28
|
-
- **OpenSSH Server**: 로컬 환경에 SSH 서버가 활성화되어 있어야 합니다.
|
|
29
29
|
- **Node.js**: 16.x 이상의 버전이 필요합니다.
|
|
30
|
+
- **OpenSSH Server (선택)**: 기본 무설치 셸 모드에서는 불필요합니다. SSH 자격 증명 모드를 사용할 때만 로컬 SSH 서버가 필요합니다.
|
|
30
31
|
|
|
31
32
|
## 보안 가이드라인
|
|
32
33
|
|
|
@@ -35,6 +36,19 @@ xKat Agent는 보안을 위해 다음과 같은 장치를 마련하고 있습니
|
|
|
35
36
|
2. **Origin Verification**: 공식 서비스 도메인에서 온 연결요청만 수락합니다.
|
|
36
37
|
3. **Audit Log**: 모든 접속 시도와 파일 변경 이벤트는 타임스탬프와 함께 로컬로그에 기록됩니다.
|
|
37
38
|
|
|
39
|
+
## 배포 (Maintainers)
|
|
40
|
+
|
|
41
|
+
릴리스 파이프라인은 `docs/xkat-agent/deployment-pipeline.md` 및
|
|
42
|
+
`.github/workflows/release-agent.yml`를 참고하세요. 요약:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
cd apps/xkat-agent
|
|
46
|
+
npm version patch --no-git-tag-version
|
|
47
|
+
git add package.json && git commit -m "chore(agent): release vX.Y.Z"
|
|
48
|
+
git tag agent-v$(node -p "require('./package.json').version")
|
|
49
|
+
git push origin main --tags
|
|
50
|
+
```
|
|
51
|
+
|
|
38
52
|
## 라이선스
|
|
39
53
|
|
|
40
54
|
MIT License
|
package/package.json
CHANGED
package/scripts/install.js
CHANGED
|
@@ -8,7 +8,9 @@ const fs = require('fs');
|
|
|
8
8
|
const path = require('path');
|
|
9
9
|
const https = require('https');
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
// Version is the single source of truth from package.json, so a release bump
|
|
12
|
+
// (npm version patch) automatically points install at the matching R2 folder.
|
|
13
|
+
const VERSION = require('../package.json').version;
|
|
12
14
|
const BASE_URL = `https://dl.xkat.space/v${VERSION}`;
|
|
13
15
|
|
|
14
16
|
function getPlatformTarget() {
|