Back to Details

hipass-receipt

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

하이패스 영수증 발급

Hi-pass 收据开具

What this skill does

此技能的功能

공식 하이패스 홈페이지(
https://www.hipass.co.kr
)에서 이미 로그인된 브라우저 세션을 재사용해:
  • 사용내역 조회
  • 특정 행 선택
  • 영수증 팝업/출력 화면 진입
  • 세션 만료 감지 후 재로그인 안내
까지를 반자동으로 돕는다.
在Hi-pass官方网站（
https://www.hipass.co.kr
）上，复用已登录的浏览器会话，半自动化完成以下操作：
  • 查询使用记录
  • 选择特定行
  • 进入收据弹窗/打印页面
  • 检测到会话过期后提示重新登录

Hard limits

使用限制

  • 로그인은 반드시 사용자가 직접 해야 한다.
  • 이 스킬은 로그인된 세션에서만 동작한다.
  • ID/PW, 인증코드, OTP, 공동인증서 절차를 자동 입력하지 않는다.
  • JSESSIONID
    쿠키만 저장해 장시간 재사용하는 방식은 지원하지 않는다.
  • 권장 세션 형태는 Playwright persistent context 또는 Chrome 
    user-data-dir
    / remote-debugging 재사용이다.
  • 세션이 만료되면 즉시 중단하고 다시 로그인해야 한다.
  • 登录必须由用户自行完成
  • 本技能仅能在已登录的会话中运行
  • 不会自动填写ID/密码、验证码、OTP、公共认证证书相关流程
  • 不支持仅存储
    JSESSIONID
    cookie进行长期复用的方式
  • 推荐的会话形式为Playwright persistent context或者复用Chrome的
    user-data-dir
    /remote-debugging
  • 会话过期后必须立即停止操作并重新登录

Why this design

设计思路

현재 공개 페이지 기준으로:
  • 로그인 페이지와 메인 페이지에 
    session_time=1200
    이 노출된다.
  • 세션 연장은 
    /comm/sessionCheck.do
  • 세션 종료는 
    /comm//sessionout.do
  • 미로그인/세션 종료 보호 응답은 
    mgs_type 11/12
    후 
    /comm/lginpg.do
    로 이동한다.
  • 사용내역 조회는 
    /usepculr/InitUsePculrTabSearch.do
    → 
    hpForm
    submit → 
    /usepculr/UsePculrTabSearchList.do
    흐름이다.
  • 영수증은 
    /usepculr/UsePculrReceiptPrint.do
    팝업 진입으로 이어진다.
즉 v1은 “로그인된 Chrome 세션 재사용” 이 가장 현실적이다.
以当前公开页面规则为准：
  • 登录页和主页会暴露
    session_time=1200
    参数
  • 会话续期接口为
    /comm/sessionCheck.do
  • 会话销毁接口为
    /comm//sessionout.do
  • 未登录/会话销毁的保护响应为
    mgs_type 11/12
    ，之后跳转至
    /comm/lginpg.do
  • 使用记录查询的流程为
    /usepculr/InitUsePculrTabSearch.do
    → 提交
    hpForm
    → 
    /usepculr/UsePculrTabSearchList.do
  • 收据流程会跳转至
    /usepculr/UsePculrReceiptPrint.do
    弹窗
也就是说v1版本最现实的实现方案就是**「复用已登录的Chrome会话」**。

Prerequisites

前置要求

  • macOS 또는 Chrome 실행 가능한 환경
  • npm install hipass-receipt
    또는 이 레포에서 
    npm install
    (
    playwright-core
    포함)
  • Chrome 원격 디버깅 포트 사용 가능
  • 사용자가 직접 하이패스 로그인 가능
  • 可运行macOS或Chrome的环境
  • 执行
    npm install hipass-receipt
    或者在本仓库下执行
    npm install
    （包含
    playwright-core
    依赖）
  • 可使用Chrome远程调试端口
  • 用户可自行登录Hi-pass账号

Workflow

工作流程

1. 전용 Chrome 프로필로 로그인 브라우저를 띄운다

1. 使用专用Chrome配置文件启动浏览器

bash
hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222
위 명령이 출력한 Chrome 실행문으로 브라우저를 띄운 뒤, 사용자가 직접 
https://www.hipass.co.kr/comm/lginpg.do
에 로그인한다.
bash
hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222
执行上述命令输出的Chrome启动语句打开浏览器后，用户自行访问
https://www.hipass.co.kr/comm/lginpg.do
完成登录。

2. 사용내역을 조회한다

2. 查询使用记录

bash
hipass-receipt list \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --page-size 30
  • 카드사/암호화 카드번호를 알고 있으면 
    --encrypted-card-number
    등으로 더 좁힐 수 있다.
  • --encrypted-card-number
    는 CLI의 기존 
    --ecd-no
    별칭이다.
  • 결과 JSON에서 
    rowIndex
    를 확인한다.
bash
hipass-receipt list \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --page-size 30
  • 如果你知道所属卡公司/加密卡号，可以通过
    --encrypted-card-number
    等参数进一步缩小查询范围
  • --encrypted-card-number
    是CLI原有参数
    --ecd-no
    的别名
  • 从返回的JSON结果中确认
    rowIndex

3. 특정 row의 영수증 팝업을 연다

3. 打开指定行的收据弹窗

bash
hipass-receipt receipt \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --row-index 1
  • 선택한 행의 
    영수증
    /
    출력
    control 을 클릭한다.
  • 팝업이 열리면 URL/title 을 반환한다.
bash
hipass-receipt receipt \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --row-index 1
  • 点击选中行的
    收据
    /
    打印
    控件
  • 弹窗打开后返回对应的URL/标题

Response policy

响应规则

  • “로그인 필수”, “세션 만료 시 재로그인 필요”를 항상 명확히 적는다.
  • 하이패스 계정 비밀번호를 받아 저장하거나 새 env var를 만들지 않는다.
  • 세션이 만료됐으면 즉시 실패시키고 
    /comm/lginpg.do
    재로그인만 안내한다.
  • v1 범위를 넘어서는 완전 무인 로그인 유지/백그라운드 재인증은 약속하지 않는다.
  • 始终明确标注「必须登录」、「会话过期后需重新登录」的提示
  • 不会获取存储Hi-pass账号密码，也不会新增相关环境变量
  • 检测到会话过期后会立即终止运行，仅提示前往
    /comm/lginpg.do
    重新登录
  • 不会承诺超出v1版本范围的完全无人值守登录维持/后台重新认证功能

Verification

验证方式

  • 자동 검증: fixture 기반 query/parser/session-detection 테스트
  • smoke 검증: 
    hipass-receipt fixture-demo --fixture ...
  • 최종 실서비스 검증: 로그인된 세션으로 수동 smoke test
  • 自动验证：基于fixture的query/parser/session-detection测试
  • 冒烟验证：
    hipass-receipt fixture-demo --fixture ...
  • 最终生产环境验证：使用已登录的会话手动完成冒烟测试

Done when

完成标准

  • 로그인된 세션으로 사용내역 조회가 가능하다.
  • 특정 row를 선택해 영수증 팝업 진입을 시도할 수 있다.
  • 세션 종료 응답을 감지하면 재로그인을 요구한다.
  • 使用已登录的会话可正常查询使用记录
  • 可选择指定行尝试进入收据弹窗
  • 检测到会话终止响应时会提示用户重新登录