# 식탁보 TableCloth
Windows Sandbox에서 인터넷 뱅킹과 전자정부 사이트를 사용할 때 필요한 보안 프로그램을 격리하여 실행합니다.
[](https://github.com/yourtablecloth/TableCloth/actions)
[](https://discord.gg/eT2UnUXyTV)
[](https://github.com/sponsors/yourtablecloth)
[](https://github.com/yourtablecloth/TableCloth/releases)
[](https://marticliment.com/unigetui/share?name=TableCloth&id=TableClothProject.TableCloth&sourceName=winget&managerName=WinGet)
> [!IMPORTANT]
> 2026년 1월 17일부터 Certum 코드 서명 인증서를 사용합니다. v1.14.0 이후 GitHub Release의 실행 파일에는 Authenticode 서명을 적용합니다.
> [!IMPORTANT]
> Microsoft Store 정책 변경으로 Store 버전의 최신 업데이트를 제공하기 어렵습니다. Store 버전을 제거한 뒤 [GitHub Releases](https://github.com/yourtablecloth/TableCloth/releases) 또는 WinGet 패키지로 다시 설치하면 현재 릴리스를 사용할 수 있습니다.
> [!IMPORTANT]
> v1.13.0부터 AGPL-3.0과 상용 라이선스를 함께 제공합니다. 적용할 라이선스는 [라이선스 안내](#라이선스)를 기준으로 판단할 수 있습니다.
> [!CAUTION]
> **사칭과 피싱에 주의하십시오.**
>
> 식탁보는 본인 인증, 회원 가입, 카드 결제 또는 금전을 요구하지 않습니다. 공식 배포처는 [GitHub Releases](https://github.com/yourtablecloth/TableCloth/releases)와 WinGet 패키지 `TableClothProject.TableCloth`입니다. 검색 광고에서 제공하는 다운로드 파일은 공식 배포본으로 간주하지 않습니다.
## 빠른 시작 가이드
처음 사용하는 경우 Quick Start Guide에서 Windows Sandbox의 지원 OS와 가상화 조건, 설치, 실행과 첫 결과 확인 절차를 따라 진행할 수 있습니다. Apple Silicon Mac에서 macSandbox로 무설치 `.wsb` 파일을 실행하는 방법도 안내합니다.
- [한국어 Quick Start Guide](docs/QUICK_START.ko.md)
- [English Quick Start Guide](docs/QUICK_START.md)
## 프로젝트 개요
식탁보는 호스트 Windows에서 Windows Sandbox를 시작하고 필요한 폴더와 설정만 게스트에 전달합니다. 샌드박스 안에서는 Spork가 사이트 카탈로그를 표시하고 선택한 사이트에 필요한 보안 프로그램을 설치합니다. 샌드박스를 닫으면 게스트에 설치한 프로그램과 변경 사항이 함께 폐기됩니다.
빠른 시작 화면의 통합 입력란에 기관 이름, 웹 주소 또는 질문을 입력하고 `시작`을 누를 수 있습니다. 입력 중에는 카탈로그의 서비스 이름 또는 웹 주소와 일치하는 항목을 입력란 아래에 제안합니다. 제안을 선택하면 입력란을 채우며 `시작`을 눌러 실행할 수 있습니다. 입력란이 비어 있으면 빈 샌드박스를 시작합니다. 한두 단어가 카탈로그의 서비스 이름과 일치하면 검색 결과 목록을 열어 사이트를 선택합니다. 선택한 서비스의 소프트웨어 설치와 사이트 접속은 샌드박스 안의 Spork가 처리합니다. 전체 목록은 `접속할 사이트 선택`으로 열 수 있습니다.
입력한 공개 웹 주소가 Catalog 서비스의 도메인과 일치하면 QuickStart 설정을 적용하고 Spork가 해당 서비스의 소프트웨어를 설치한 뒤 입력한 페이지를 엽니다. 같은 도메인의 후보가 많으면 서비스를 선택하는 창이 열립니다. 일치 항목이 없으면 폴더와 인증서를 공유하지 않는 브라우저 전용 샌드박스에서 페이지를 엽니다. 로컬 및 사설 주소, 로그인 정보가 포함된 URL과 웹 이외의 스킴은 받지 않습니다. `#debug`는 로컬 진단 경로를 표시합니다. 그 밖의 `#` 명령은 향후 진단 기능을 위해 예약했습니다. 다른 문장은 식탁보 AI 대화창의 입력란에 초안으로 전달합니다.
v1.21.0은 WPF UI를 Avalonia로 이관하고 TableCloth와 Spork 배포본을 Native AOT로 전환했습니다. 현재 정식 버전인 [v1.22.0](https://github.com/yourtablecloth/TableCloth/releases/tag/v1.22.0)은 식탁보 AI, 스킬 마켓플레이스와 파일 첨부 기능을 제공하며 Safe Mode 실행을 지원합니다.
## 식탁보 AI (베타)
빠른 시작 화면에서 `식탁보 AI (베타)`를 열 수 있습니다. AI 창은 메인 창보다 조금 큰 840×640의 초기 크기로 열립니다. Codex 버전, 연결 상태, 대화 모델과 100만 토큰당 입력 및 출력 크레딧 단가를 상단 한 줄에 표시합니다. 이 기능은 TableCloth 전용 위치에 OpenAI Codex 런타임을 설치하고 사용자의 ChatGPT 로그인으로 대화를 처리합니다. 선택한 모델은 기존 애플리케이션 설정에 저장합니다. 응답의 웹 링크를 누르면 Windows Sandbox 또는 현재 Windows 브라우저를 선택할 수 있습니다. Sandbox 경로는 TableCloth Catalog를 확인하고 Spork로 필요한 소프트웨어를 설치한 뒤 페이지를 엽니다.
AI 대화에는 실행 중인 식탁보의 버전, 공식 홈페이지, Windows Sandbox와 Spork의 역할을 기본 문맥으로 전달합니다. 답변 언어는 AI 창의 표시 언어를 따르며, 외부 사이트의 최신 절차는 웹 검색 결과에 근거합니다.
일반 설정 창의 `AI 스킬` 탭이나 AI 대화 창에서 스킬 마켓플레이스를 열 수 있습니다. 마켓플레이스에서는 원격 스킬을 탐색하고 설치, 업데이트, 활성화, 비활성화, 제거하거나 로컬 스킬 폴더를 가져올 수 있습니다. [스킬 카탈로그 페이지](https://catalog.yourtablecloth.app/skills/)에서는 새 스킬의 마켓플레이스 등재를 제안할 수 있습니다. AI 입력창 위의 `+` 버튼이나 `@` 입력으로 설치된 스킬 목록을 열고 위아래 방향키와 Enter로 선택할 수 있습니다. 현재 선택 후보는 강조색으로 표시합니다. TableCloth는 전용 프로필 밖에서 Codex가 찾은 사용자 및 프로젝트 스킬을 대화 실행 전에 끕니다. 스킬 파일과 사용 설정은 Codex 런타임 릴리스 폴더와 분리하므로 런타임 업데이트나 재설치 후에도 유지합니다.
스킬 스크립트 실행은 AppContainer 브로커를 거칩니다. 대화창의 `앱 실행 기록`에는 브로커가 확인한 스킬, 도구, 실행 결과와 종료 코드를 표시하고 후속 질문에도 실행 기록을 전달합니다. 이 기록이 답변에 포함된 모든 수치의 정확성을 검증하지는 않습니다.
[tablecloth-certificate-expiry](https://github.com/yourtablecloth/tablecloth-certificate-expiry) 스킬은 공동인증서 만료일 질문을 처리하며 스킬 마켓플레이스에서 선택해 설치합니다. 새 전용 프로필에는 스킬을 자동 설치하지 않습니다. 사용자가 조회에 동의하면 호스트의 `TableClothCli.exe`가 기본 NPKI 폴더에서 공개 인증서의 만료 여부를 확인합니다. AI에는 만료된 인증서 수, 향후 30일 안에 만료되는 인증서 수와 조회 완료 여부만 전달합니다. 인증서 이름, 발급자, 일련번호, 파일 경로, 공개 인증서의 내용, 개인키와 Catalog 정보는 전달하지 않습니다. 식탁보 AI는 개별 인증서의 세부 정보나 스크린샷을 직접 확인할 수 없습니다.
AI 창은 민감 개인정보, 공동인증서 파일과 스크린샷을 입력하거나 링크로 공유하지 말라는 안내를 새 대화의 시작 화면에만 표시합니다. 텍스트 입력과 첨부 텍스트에서는 일부 국내 전화번호, 주민등록번호와 주소 형식을 자동으로 가립니다. 정규표현식 기반 필터가 모든 개인정보를 찾아내지는 못합니다. 인식 가능한 인증서 세부 정보와 인증서 스크린샷 링크는 전송 전에 거부합니다. 자세한 사용 범위는 [홈페이지의 식탁보 AI 안내](https://yourtablecloth.app/docs/managed-ai)와 [개인정보 처리방침](https://yourtablecloth.app/docs/privacy)에서 확인할 수 있습니다.
입력창 위의 클립 버튼으로 PNG, JPEG와 텍스트 파일을 최대 4개 첨부할 수 있습니다. Ctrl+V는 클립보드의 파일과 비트맵을 첨부로 추가하고 일반 텍스트는 입력창에 붙여넣습니다. 여러 첨부 파일은 한 행에 나란히 표시합니다. 메시지를 보내면 입력창의 첨부 카드를 바로 비우고 전송 실패나 중지 시에는 초안을 복원합니다. 첨부 파일은 메시지와 함께 OpenAI로 전송하며 이미지에는 자동 가림을 적용하지 않습니다.
식탁보 AI 메시지를 전송하면 사용자의 OpenAI 구독 사용량을 소비합니다. 기능의 구현 상태, 보안 경계와 검증 이력은 [AI Preview 구현 및 검증 보고서](docs/poc/managed-ai-runtime.md)에 기록했습니다. [최초 PoC 설계](docs/poc/managed-ai-runtime-design.ko.md)는 구현 전 기준과 의사결정 이력을 보존합니다.
정식 릴리스는 다음 네 가지 앱 조합을 제공합니다.
- TableCloth x64와 ARM64
- Spork x64와 ARM64
- 설치 관리자와 Portable ZIP
- Authenticode 서명과 아키텍처별 SBOM
## 지원 환경
- Windows 11 Pro, Education 또는 Enterprise
- Windows Sandbox 기능
- x64 또는 ARM64 프로세서
- 인터넷 연결
Windows Sandbox를 제공하지 않는 Windows Home은 현재 지원 대상에 포함하지 않습니다. 조직에서 Windows Sandbox, 가상화 또는 GitHub 다운로드를 차단했다면 시스템 관리자 정책이 우선합니다.
macOS에서는 Apple Silicon용 [macSandbox](https://github.com/yourtablecloth/macSandbox)로 무설치 `.wsb`를 열어 Windows 게스트 안에서 Spork를 실행할 수 있습니다. Mac의 지원 환경과 기본 이미지 준비 절차는 [Quick Start Guide](docs/QUICK_START.ko.md#macos-설치와-wsb-실행)에서 안내합니다.
## 설치와 실행
WinGet을 사용할 수 있다면 다음 명령으로 설치합니다.
```powershell
winget install --exact --id TableClothProject.TableCloth
```
WinGet 등록소 반영에는 GitHub Release 게시 이후 시간이 더 걸릴 수 있습니다. WinGet에서 최신 버전을 찾지 못하면 [GitHub Releases](https://github.com/yourtablecloth/TableCloth/releases)에서 아키텍처에 맞는 설치 관리자를 내려받을 수 있습니다. GUI 패키지 관리가 편하다면 [UniGetUI 공유 링크](https://marticliment.com/unigetui/share/?name=TableCloth&id=TableClothProject.TableCloth&sourceName=winget&managerName=WinGet)를 사용할 수 있습니다.
설치 후 TableCloth에서 공유할 데이터와 장치 옵션을 선택하고 빠른 시작의 `시작`을 누릅니다. 사이트 선택과 보안 프로그램 설치는 Windows Sandbox 안의 Spork에서 진행합니다. 처음 설치하는 경우 [Quick Start Guide의 Windows 설치와 실행](docs/QUICK_START.ko.md#windows-설치와-실행)에서 첫 실행 순서와 결과 확인 방법을 볼 수 있습니다.
## 무설치 Express 실행
공유 폴더를 사용하는 실행에서 PC에 블루스크린이 발생하면 빠른 시작의 **샌드박스를 시작하는데 문제가 있으신가요?** 링크를 눌러 Safe Mode 실행을 비교할 수 있습니다. Safe Mode는 호스트 폴더와 클립보드 및 장치 공유를 제외하고 네트워크를 유지합니다. 일반 실행 옵션과 조합하지 않으며 입력란과 호스트에서 선택한 기관을 전달하지 않습니다. 기관은 Sandbox 안의 Spork에서 선택합니다. v1.22.0부터 사용할 수 있습니다. 제한 기능과 비교 절차는 [Safe Mode 및 중지 오류 가이드](docs/SAFE_MODE.ko.md)에 설명했습니다. [English guide](docs/SAFE_MODE.md)
호스트에 TableCloth를 설치하지 않고 Windows Sandbox 안에서 Spork만 실행할 수도 있습니다.
1. 최신 정식 릴리스에서 [`no-install-spork.wsb`](https://github.com/yourtablecloth/TableCloth/releases/latest/download/no-install-spork.wsb)를 내려받습니다.
2. 내려받은 파일을 두 번 눌러 Windows Sandbox를 시작합니다.
3. SporkBootstrap이 현재 아키텍처에 맞는 최신 Spork Portable 패키지를 다운로드하고 실행할 때까지 기다립니다.
무설치 구성은 호스트 폴더를 게스트에 매핑하지 않습니다. 따라서 호스트의 파일 기반 공동인증서와 데이터 폴더를 사용할 수 없습니다. 모바일 인증처럼 호스트 파일을 요구하지 않는 인증 수단에 적합합니다.
설계와 자산 계약은 [무설치 부트스트래퍼 설계](docs/EXPRESS_BOOTSTRAPPER_DESIGN.md)와 [파라미터화된 WSB 스펙](docs/PARAMETERIZED_WSB_SPEC.md)에 기록했습니다. 이름 해석에 실패한 경우에만 공용 DNS로 전환하며 정상 동작하는 사내 DNS는 유지합니다. 관련 배경은 [#285](https://github.com/yourtablecloth/TableCloth/issues/285)에서 확인할 수 있습니다.
## 사이트 정보 수정과 문제 제보
사이트 카탈로그 수정은 [TableClothCatalog 저장소](https://github.com/yourtablecloth/TableClothCatalog)에 이슈 또는 Pull Request로 제출할 수 있습니다. 다음 채널도 운영합니다.
- [GitHub Issues](https://github.com/yourtablecloth/TableCloth/issues)
- [Google Forms 제보](https://forms.gle/Pw6pBKhqF1e5Nesw6)
- [TableCloth Discord](https://discord.gg/eT2UnUXyTV)
## 개발 문서
- [개발 환경과 프로젝트 구조](DEVELOPMENT.md)
- [브랜치와 버전 관리 정책](docs/BRANCHING.md)
- [Retail과 Preview 릴리스 채널](docs/RELEASE_CHANNELS.md)
- [릴리스 실행 절차](docs/RELEASING.md)
- [업데이트 채널 문제 해결](docs/TROUBLESHOOTING_UPDATE_CHANNEL.md)
- [Avalonia와 Native AOT 전환 기록](docs/AVALONIA_AOT_MIGRATION.md)
- [식탁보 AI Preview 구현 및 검증](docs/poc/managed-ai-runtime.md)
- [스킬 마켓플레이스와 원격 카탈로그](docs/SKILL_MARKETPLACE.ko.md), [English](docs/SKILL_MARKETPLACE.md)
- [AppContainer 스킬 스크립트 실행 PoC와 평가 결과](tools/appcontainer-skill-poc/README.ko.md), [English](tools/appcontainer-skill-poc/README.md)
- [Windows Sandbox 내부 Codex CLI와 Computer Use 탐색 기록](docs/poc/codex-sandbox-computer-use.ko.md), [English](docs/poc/codex-sandbox-computer-use.md)
- [Windows Sandbox RDP 호스팅 실험과 검증 기록](docs/poc/rdp-sandbox.ko.md), [English](docs/poc/rdp-sandbox.md)
v1.22.0은 `global.json`에 고정한 .NET 11 RC1 SDK `11.0.100-rc.1.26425.128`로 빌드합니다. 제품의 정식 릴리스와 별개로 빌드 SDK는 RC 버전을 사용합니다. `develop`은 다음 Minor 개발을 시작하기 전까지 `1.22.0`을 유지합니다. 개발 환경은 Visual Studio 2026 Insiders 또는 C# Dev Kit을 사용합니다. Native AOT 게시에는 MSVC C++ 빌드 도구가 필요하며 ARM64를 로컬에서 게시하려면 ARM64용 C++ 빌드 도구도 설치해야 합니다. CI는 x64와 ARM64 네이티브 Windows 러너에서 각 아키텍처를 빌드합니다.
## 후원과 수상
[GitHub Sponsors](https://github.com/sponsors/yourtablecloth)를 통해 프로젝트를 후원할 수 있습니다.
2024년 9월에 disquiet.io의 Product of the Week로 선정되었습니다.
[](https://disquiet.io/product/%EC%8B%9D%ED%83%81%EB%B3%B4)
## 법적 고지
### 저작권
식탁보 소프트웨어는 대한민국 저작권법에 따라 보호받습니다.
- 저작권 등록번호 `C-2025-051228`
- 등록일 2025년 11월 21일
- 저작권자 남정현
- [한국저작권위원회 CROS](https://www.cros.or.kr)에서 등록번호로 조회
Copyright 2021-2026 rkttu.com. All rights reserved.
### 상표
`식탁보` 명칭은 대한민국 특허청에 상표로 출원되어 있습니다.
- 출원번호 `4020240205929`
- 출원공고일 2025년 3월 17일
- 출원인 rkttu.com
- [KIPRIS](https://www.kipris.or.kr)에서 출원번호로 조회
### 라이선스
이 저장소는 AGPL-3.0과 상용 라이선스를 함께 제공합니다. AGPL-3.0 조건을 적용하는 경우 [LICENSE-AGPL](LICENSE-AGPL)을 따릅니다. 별도 상용 라이선스는 라이선스 파일에 기재된 연락처로 문의할 수 있습니다.
## 이미지 저작권
- TableCloth Logo by [Icons8](https://img.icons8.com/color/96/000000/tablecloth.png)
- Spork New Logo by [Freepik Flaticon](https://www.flaticon.com/free-icon/spork_5625701)