한국어 | English

LinKHU

경희대학교 학생들이 자주 사용하는 핵심 웹서비스들을 클릭 한 번으로 즉시 이동하세요. 홈페이지에서 주요 기능을 한눈에 볼 수 있습니다.

🔗 경희대학교 자주 찾는 웹서비스 바로가기 제공

🏫 지원 웹서비스

교내 공통 서비스, 단과대, 학과/전공까지 총 117개 서비스를 지원하며, 설정 페이지에서 원하는 것만 골라 담을 수 있습니다. 전체 목록은 Supported Services에서 확인할 수 있습니다.

🔎 팝업 검색

팝업 상단 검색창에서 서비스 이름, ID, 카테고리로 원하는 바로가기를 찾을 수 있습니다.

• / 키를 누르면 검색창으로 바로 이동합니다.
• 이름이 일치하는 서비스가 먼저 표시되고, Enter를 누르면 첫 번째 결과를 현재 탭에서 엽니다.
• 검색어가 없을 때는 설정 페이지에서 저장한 내 바로가기 목록이 표시됩니다.

💬 문의하기

팝업과 설정 페이지 하단의 문의하기에서 GitHub 계정 없이 바로 의견을 보낼 수 있습니다. 답변이 필요하면 이메일을 함께 남길 수 있습니다.

👀 미리보기

실행 화면	팝업 화면
설정 화면

🚀 설치 방법

방법 1: 브라우저 스토어에서 설치

1. 사용하는 브라우저의 스토어 페이지로 이동합니다. Chrome 웹 스토어 · Whale 스토어 · Firefox Add-ons
2. "추가" 버튼을 클릭합니다.
3. 확장 앱을 브라우저에 고정해 두고 사용하면 더욱 편리합니다.

방법 2: 수동 설치

1. 이 저장소를 git clone 하거나 ZIP으로 다운로드하여 압축을 풉니다.
2. 크롬 브라우저 주소창에 chrome://extensions를 입력하여 이동합니다.
3. 우측 상단의 '개발자 모드'를 켭니다.
4. '압축해제된 확장 프로그램을 로드합니다' 버튼을 클릭합니다.
5. 다운로드 받은 폴더 내 src 폴더를 선택합니다.
6. 확장 앱을 브라우저에 고정해 두고 사용하면 더욱 편리합니다.

⌨️ 단축키

LinKHU 팝업은 기본 단축키로 빠르게 열 수 있습니다.

• Windows/Linux: Ctrl + Shift + L
• macOS: Command + Shift + L

브라우저나 다른 확장 프로그램의 단축키와 충돌하면 기본 단축키가 동작하지 않을 수 있습니다. 이 경우 브라우저 확장 프로그램 단축키 설정 화면에서 LinKHU 단축키를 직접 다시 지정해주세요.

• Chrome: chrome://extensions/shortcuts
• Whale: whale://extensions/shortcuts
• Firefox: about:addons → 톱니바퀴 메뉴 → 확장 기능 단축키 관리

🛠 개발

npm run build   # 테스트 + 데이터 검증 + 패키징을 한 번에 실행

개별 스크립트는 package.json의 scripts를, 작업 규칙은 AGENTS.md를 참고하세요. 릴리스와 스토어 배포 절차는 Release Process를 따릅니다.

📁 프로젝트 구조

LinKHU/
├── src/                       # 확장 프로그램 소스
│   ├── manifest.json          # 확장 매니페스트 (버전 관리)
│   ├── data.js                # 지원 서비스 목록 (단일 소스)
│   ├── shared.js              # 팝업·설정 공통 검색/설정 유틸
│   ├── popup.{html,js,css}    # 팝업 화면
│   ├── options.{html,js,css}  # 설정 페이지
│   ├── version.js             # 업데이트 확인
│   ├── feedback.js            # 문의 전송
│   ├── images/                # 카테고리별 서비스 아이콘
│   └── icons/                 # 확장 프로그램 아이콘
├── docs/                      # GitHub Pages 랜딩 + 배포/운영 문서
│   ├── index.html             # 랜딩 페이지
│   ├── landing.{js,css}       # 랜딩 검색·문의·스타일
│   └── assets/                # 랜딩 데이터, 서비스 아이콘, 스크린샷
├── scripts/                   # 데이터 검증·패키징·스토어 배포 스크립트
├── tests/                     # node --test 기반 테스트
├── release-notes/             # 버전별 릴리스 노트
└── .github/workflows/         # 검증·릴리스·스토어 배포 자동화

🐛 버그 제보 및 기여

Issue와 Pull Request를 통한 제보와 기여는 언제나 환영입니다. 가볍게 의견만 남기고 싶다면 확장 프로그램 또는 홈페이지의 문의하기를 이용해주세요.

• 버그 제보: Bug Report 템플릿을 사용해주세요.
• 지원 웹 서비스 추가 요청: Service Request 템플릿에 서비스 이름, URL, 카테고리, 아이콘 정보를 적어주세요.
• 기능 제안: Feature Request 템플릿에 제안 배경과 기대 동작을 적어주세요.
• 직접 수정 PR: 관련 이슈를 먼저 만들고, 변경 후 검증 결과를 PR 본문에 남겨주세요.

📜 License

This project is licensed under the MIT License