npm - cli-jaw - Versions diffs - 1.3.0-preview.6 → 1.3.0-preview.8 - Mend

cli-jaw 1.3.0-preview.6 → 1.3.0-preview.8

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.

Files changed (22) hide show

package/README.ko.md +48 -10
package/README.md +70 -11
package/README.zh-CN.md +48 -10
package/dist/src/agent/args.js +4 -2
package/dist/src/agent/args.js.map +1 -1
package/dist/src/agent/spawn.js +2 -2
package/dist/src/agent/spawn.js.map +1 -1
package/dist/src/cli/registry.js +5 -2
package/dist/src/cli/registry.js.map +1 -1
package/dist/src/orchestrator/state-machine.js +13 -10
package/dist/src/orchestrator/state-machine.js.map +1 -1
package/dist/src/prompt/templates/orchestration.md +6 -4
package/package.json +1 -1
package/public/css/orc-state.css +1 -1
package/public/dist/bundle.js +59 -59
package/public/dist/bundle.js.map +3 -3
package/public/index.html +7 -0
package/public/js/constants.ts +4 -1
package/public/js/features/settings.ts +13 -2
package/public/js/main.ts +12 -0
package/public/js/ws.ts +55 -18
package/scripts/install-wsl.sh +38 -0

package/README.ko.md CHANGED Viewed

@@ -6,7 +6,7 @@
 *Claude, Codex, Gemini... 이제 번갈아 쓰지 마세요.*
-[![Tests](https://img.shields.io/badge/tests-608%20pass-brightgreen)](#-테스트)
+[![Tests](https://img.shields.io/badge/tests-639%20pass-brightgreen)](#-테스트)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-blue)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-ISC-yellow)](LICENSE)
@@ -133,7 +133,7 @@ gemini                       # Google Gemini — 첫 실행 시 인증
  ✅ OpenCode CLI    installed
  ✅ Copilot CLI     installed
  ✅ Database        jaw.db OK
- ✅ Skills          17 active, 90 reference
+ ✅ Skills          20 active, 89 reference
  ✅ MCP             3 servers configured
  ✅ Memory          MEMORY.md exists
  ✅ Server          port 3457 available
@@ -154,7 +154,7 @@ CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **
 > 💬 *"이 모듈 리팩토링하고 테스트도 짜줘"* → 서브에이전트가 알아서, 커피 한 잔 하고 오면 돼요
 > 💬 *"저 PDF 다운받아서 핵심만 노션에 정리해"* → 브라우저 + 노션 스킬 조합으로 뚝딱
-단일 모델만을 사용하는 기존 비서들과 달리, CLI-JAW는 5개의 AI 엔진(Claude, Codex, Gemini, OpenCode, Copilot)을 공식 CLI를 통해 오케스트레이션하여 모든 제공업체의 장점을 통합된 경험으로 제공합니다. 하나의 엔진 사용량이 초과되면 자동으로 다음 엔진으로 전환됩니다. 108개의 내장 스킬이 브라우저 자동화부터 문서 생성까지 모든 것을 처리합니다.
+단일 모델만을 사용하는 기존 비서들과 달리, CLI-JAW는 5개의 AI 엔진(Claude, Codex, Gemini, OpenCode, Copilot)을 공식 CLI를 통해 오케스트레이션하여 모든 제공업체의 장점을 통합된 경험으로 제공합니다. 하나의 엔진 사용량이 초과되면 자동으로 다음 엔진으로 전환됩니다. 109개의 내장 스킬이 브라우저 자동화부터 문서 생성까지 모든 것을 처리합니다.
 |                                         | 왜 CLI-JAW인가요?                                                                                                |
 | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
@@ -162,13 +162,28 @@ CLI-JAW는 내 컴퓨터에 상주하며 이미 익숙한 인터페이스인 **
 | 🤖 **검증된 에이전트 도구**              | 실전에서 검증된 5개의 코딩 에이전트(Claude, Codex, Gemini, OpenCode, Copilot)를 한 곳에서 사용하세요.            |
 | ⚡ **멀티 에이전트 자동 전환(Fallback)** | 엔진 하나가 멈춰도 걱정 없습니다. 다음 엔진이 즉시 이어받아 중단 없는 작업이 가능합니다.                         |
 | 🎭 **오케스트레이션 기반 성능 극대화**   | 복잡한 작업은 전문화된 서브 에이전트에게 분산시켜 처리량을 극대화합니다.                                         |
-| 📦 **108개의 내장 스킬**                 | 브라우저 자동화, 문서 생성, 텔레그램 연동, 영구 메모리 등 설치 즉시 사용 가능한 기능들을 제공합니다.             |
+| 📦 **109개의 내장 스킬**                 | 브라우저 자동화, 문서 생성, 텔레그램 연동, 영구 메모리 등 설치 즉시 사용 가능한 기능들을 제공합니다.             |
 | 🖥️ **크로스 플랫폼**                     | macOS, Linux, Windows — ENOENT-safe CLI 스폰, 자동 감지, `.cmd` shim 지원, 네이티브 설치 전부 크로스플랫폼 동작. |
 ![CLI-JAW 터미널](docs/screenshots/terminal-cli.png)
 ---
+## 🆕 새로운 기능 (v1.3.0)
+| 기능 | 설명 |
+|------|------|
+| 🎤 **음성 & STT** | 웹 마이크 버튼 + 텔레그램 음성 전사. 멀티 프로바이더 STT: OpenAI 호환, Google Vertex AI, 커스텀 엔드포인트. 설정 UI에서 API 키 관리. |
+| 📝 **프롬프트 템플릿** | 웹 UI에서 프롬프트 템플릿 생성, 편집, 관리. 노드맵 시각화 + 전체 CRUD API. |
+| 📊 **쿼타 대시보드** | 압축된 쿼타 바 + 리셋 시간 표시. 429 사용량 제한 시 캐시된 사용량 데이터로 안정적 처리. |
+| 🔍 **IDE Diff View** | 핑거프린트 기반 변경 감지. VS Code 또는 Antigravity 자동 감지 후 인라인 diff 열기. |
+| 🎭 **PABCD 개선** | 라이브 로드맵 바 + 🦈 샤크 러너 애니메이션. 페이즈 전환 시 글로우, 펄스, 뱃지 피드백. |
+| 🪟 **WSL 설치 개선** | 사전 필수 패키지(`unzip`, `curl`, `git`) 자동 설치, `jaw` 명령어 PATH 수정, 문제 해결 가이드 추가. |
+| 🧪 **639개 테스트** | 608개에서 증가 — STT, 쿼타 캐싱, 오케스트레이션, CI 안정성 커버리지 추가. |
+| 📦 **109개 스킬** | 20개 활성 + 89개 참조. 신규: `dev-pabcd`, `dev-scaffolding`, `dev-code-reviewer`. |
+---
 ## 비서가 어떤 일을 할 수 있나요?
 ```mermaid
@@ -189,7 +204,9 @@ graph LR
 - 🤖 **5개의 AI 엔진, 1명의 비서** — Claude · Codex · Gemini · OpenCode · Copilot. `/cli` 명령어로 전환하세요.
 - ⚡ **자동 전환(Fallback)** — 엔진 하나가 다운되면 다음 엔진이 매끄럽게 이어받습니다.
 - 🎭 **멀티 에이전트 오케스트레이션** — 복잡한 작업은 전문화된 서브 에이전트들에게 자동으로 분산됩니다.
-- 📦 **108개의 스킬** — 브라우저 제어, 파일 편집, 이미지 생성, 웹 검색 외 [다양한 기능](#-스킬-시스템).
+- 🎤 **음성 입력** — 웹 마이크 버튼 + 텔레그램 음성 메시지. 멀티 프로바이더 STT (OpenAI, Vertex AI).
+- 📝 **프롬프트 템플릿** — 시각적 노드맵 에디터로 프롬프트 템플릿 생성, 관리, 재사용.
+- 📦 **109개의 스킬** — 브라우저 제어, 파일 편집, 이미지 생성, 웹 검색 외 [다양한 기능](#-스킬-시스템).
 - 🧠 **영구 메모리** — 세션을 넘나들며 과거의 대화와 사용자 선호도를 기억합니다.
 - 📱 **텔레그램 봇** — 휴대폰으로 비서와 채팅하고, 음성/사진/파일을 전송하세요.
 - 🌐 **브라우저 자동화** — 비서가 알아서 웹을 탐색하고, 클릭하고, 타이핑하고, 스크린샷을 찍을 수 있습니다.
@@ -212,15 +229,15 @@ jaw service install  # 부팅 시 자동 실행 (systemd/launchd/docker 자동
 ## 📦 스킬 시스템
-**108개 스킬** 내장 — 브라우저, GitHub, 노션, 텔레그램, 메모리, PDF, 이미지 생성 등 [다양하게](#).
+**109개 스킬** 내장 — 브라우저, GitHub, 노션, 텔레그램, 메모리, PDF, 이미지 생성 등 [다양하게](#).
 <details>
 <summary>전체 스킬 목록 보기</summary>
 | 티어               | 수량  | 작동 방식                                        |
 | ------------------ | :---: | ------------------------------------------------ |
-| **Active 스킬**    |  17   | 매번 AI한테 자동으로 주입돼요. 항상 켜져 있어요. |
-| **Reference 스킬** |  90   | 관련 작업을 시키면 그때 AI가 읽어서 써요.        |
+| **Active 스킬**    |  20   | 매번 AI한테 자동으로 주입돼요. 항상 켜져 있어요. |
+| **Reference 스킬** |  89   | 관련 작업을 시키면 그때 AI가 읽어서 써요.        |
 #### Active 스킬 (항상 켜짐)
@@ -237,10 +254,11 @@ jaw service install  # 부팅 시 자동 실행 (systemd/launchd/docker 자동
 | `screen-capture`                                                    | macOS 스크린샷 및 카메라 캡처                      |
 | `openai-docs`                                                       | 최신 OpenAI API 문서                               |
 | `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | 서브에이전트용 개발 가이드                         |
+| `dev-pabcd` / `dev-scaffolding` / `dev-code-reviewer`               | 오케스트레이션, 스캐폴딩, 코드 리뷰 가이드               |
 #### Reference 스킬 (필요할 때만)
-90개 스킬이 더 있어요 — spotify, 날씨, 딥리서치, TTS, 비디오 다운로드, Apple 미리알림, 1Password, Terraform, PostgreSQL, Jupyter 등.
+89개 스킬이 더 있어요 — spotify, 날씨, 딥리서치, TTS, 비디오 다운로드, Apple 미리알림, 1Password, Terraform, PostgreSQL, Jupyter 등.
 ```bash
 jaw skill install <name>    # reference → active로 영구 활성화
@@ -286,6 +304,26 @@ jaw skill install <name>    # reference → active로 영구 활성화
 ---
+## 🎤 음성 & STT — 음성 인식
+CLI-JAW는 멀티 프로바이더 STT로 모든 인터페이스에서 음성 입력을 지원합니다:
+| 프로바이더 | 설정 방법 |
+|-----------|----------|
+| **OpenAI 호환** | Settings UI → STT → OpenAI 엔드포인트 + API 키 |
+| **Google Vertex AI** | Settings UI → STT → Vertex AI 인증 정보 |
+| **커스텀 엔드포인트** | OpenAI 호환 STT API URL 직접 입력 |
+**음성을 사용할 수 있는 곳:**
+- 🌐 **웹 UI** — 마이크 버튼으로 실시간 녹음 및 전사
+- 📱 **텔레그램** — 음성 메시지 전송 시 AI에 전달 전 자동 전사
+- 🎙️ **멀티모달** — 음성 + 텍스트 + 파일 첨부를 하나의 메시지에 조합 가능
+모든 STT 설정(프로바이더, API 키, 언어)은 **Settings UI**에서 관리 — 설정 파일 편집 불필요.
+---
 ## 🎭 멀티 에이전트 오케스트레이션
 ![오케스트레이션 로그](docs/screenshots/orchestration-log.png)
@@ -470,7 +508,7 @@ src/
 ## 🧪 테스트
 <details>
-<summary>608 pass · 1 skipped · 외부 의존성 0</summary>
+<summary>639 pass · 1 skipped · 외부 의존성 0</summary>
 ```bash
 npm test

package/README.md CHANGED Viewed

@@ -6,7 +6,7 @@
 *One assistant. Five brains. Always on.*
-[![Tests](https://img.shields.io/badge/tests-608%20pass-brightgreen)](#-tests)
+[![Tests](https://img.shields.io/badge/tests-639%20pass-brightgreen)](#-tests)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-blue)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-ISC-yellow)](LICENSE)
@@ -37,7 +37,15 @@ Restart your computer when prompted. After reboot, open **Ubuntu** from the Star
 curl -fsSL https://raw.githubusercontent.com/lidge-jun/cli-jaw/master/scripts/install-wsl.sh | bash
 ```
-**Step 3: Authenticate an AI Engine** (pick one)
+The script automatically installs prerequisites (`curl`, `unzip`, `git`), Node.js 22+, and CLI-JAW.
+**Step 3: Reload your shell** (important — picks up PATH changes)
+```bash
+source ~/.bashrc
+```
+**Step 4: Authenticate an AI Engine** (pick one)
 ```bash
 copilot login    # GitHub Copilot (Free)
@@ -47,7 +55,7 @@ codex login      # OpenAI Codex
 gemini           # Google Gemini
 ```
-**Step 4: Start Chatting**
+**Step 5: Start Chatting**
 ```bash
 jaw serve
@@ -56,6 +64,18 @@ jaw serve
 > 💡 The script uses [fnm](https://github.com/Schniz/fnm) for Node.js management. If you already have `nvm`, it will use that instead.
+<details>
+<summary>🔧 <b>Troubleshooting WSL</b></summary>
+| Problem | Fix |
+|---------|-----|
+| `unzip: command not found` | Rerun the installer — it now auto-installs `unzip` |
+| `jaw: command not found` after install | Run `source ~/.bashrc` to reload PATH |
+| Still can't find `jaw` | Run `export PATH="$(npm config get prefix)/bin:$PATH"` |
+| Permission errors with `npm install -g` | Run `sudo chown -R $USER $(npm config get prefix)` |
+</details>
 </details>
 <details>
@@ -133,7 +153,7 @@ Check what's ready: `jaw doctor`
  ✅ OpenCode CLI    installed
  ✅ Copilot CLI     installed
  ✅ Database        jaw.db OK
- ✅ Skills          17 active, 90 reference
+ ✅ Skills          20 active, 89 reference
  ✅ MCP             3 servers configured
  ✅ Memory          MEMORY.md exists
  ✅ Server          port 3457 available
@@ -169,6 +189,21 @@ Unlike single-model assistants, CLI-JAW orchestrates **5 AI engines** (Claude, C
 ---
+## 🆕 What's New (v1.3.0)
+| Feature | Description |
+|---------|-------------|
+| 🎤 **Voice & STT** | Web mic button + Telegram voice transcription. Multi-provider STT: OpenAI-compatible, Google Vertex AI, custom endpoints. Settings UI with API key management. |
+| 📝 **Prompt Templates** | Create, edit, and manage prompt templates via the Web UI. Node-map visualization + full CRUD API. |
+| 📊 **Quota Dashboard** | Compact quota bars with reset-time display. Graceful 429 rate-limit handling with cached usage data. |
+| 🔍 **IDE Diff View** | Fingerprint-based change detection. Auto-detects VS Code or Antigravity and opens inline diffs. |
+| 🎭 **PABCD Enhancements** | Live roadmap bar with 🦈 shark runner animation. Glow, pulse, and badge feedback on phase transitions. |
+| 🪟 **WSL Installer v2** | Auto-installs prerequisites (`unzip`, `curl`, `git`), fixes PATH for `jaw` command, adds troubleshooting guide. |
+| 🧪 **639 Tests** | Up from 608 — new coverage for STT, quota caching, orchestration, and CI stability. |
+| 📦 **109 Skills** | 20 active + 89 reference. New: `dev-pabcd`, `dev-scaffolding`, `dev-code-reviewer`. |
+---
 ## What can your assistant do?
 ```mermaid
@@ -189,7 +224,9 @@ graph LR
 - 🤖 **5 AI engines, 1 assistant** — Claude · Codex · Gemini · OpenCode · Copilot. Switch with `/cli`.
 - ⚡ **Auto fallback** — If one engine is down, the next picks up seamlessly.
 - 🎭 **Multi-agent orchestration** — Complex tasks get split across specialized sub-agents automatically.
-- 📦 **108 skills** — Browser control, file editing, image generation, web search, and [much more](#-skill-system).
+- 🎤 **Voice input** — Mic button on the web + Telegram voice messages. Multi-provider STT (OpenAI, Vertex AI).
+- 📝 **Prompt templates** — Create, manage, and reuse prompt templates with a visual node-map editor.
+- 📦 **109 skills** — Browser control, file editing, image generation, web search, and [much more](#-skill-system).
 - 🧠 **Persistent memory** — Your assistant remembers past conversations and preferences across sessions.
 - 📱 **Telegram bot** — Chat with your assistant from your phone, send voice/photos/files.
 - 🌐 **Browser automation** — Your assistant can navigate the web, click, type, and screenshot.
@@ -201,15 +238,15 @@ graph LR
 ## 📦 Skill System
-**108 skills** out of the box — browser, github, notion, telegram, memory, pdf, image generation, and [much more](#).
+**109 skills** out of the box — browser, github, notion, telegram, memory, pdf, image generation, and [much more](#).
 <details>
 <summary>View all skills</summary>
 | Tier                 | Count | How it works                                              |
 | -------------------- | :---: | --------------------------------------------------------- |
-| **Active Skills**    |  17   | Auto-injected into every AI prompt. Always available.     |
-| **Reference Skills** |  90   | AI reads them on-demand when you ask for a relevant task. |
+| **Active Skills**    |  20   | Auto-injected into every AI prompt. Always available.     |
+| **Reference Skills** |  89   | AI reads them on-demand when you ask for a relevant task. |
 #### Active Skills (always on)
@@ -226,10 +263,11 @@ graph LR
 | `screen-capture`                                                    | macOS screenshot and camera capture                       |
 | `openai-docs`                                                       | Up-to-date OpenAI API documentation                       |
 | `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | Development guidelines for sub-agents                     |
+| `dev-pabcd` / `dev-scaffolding` / `dev-code-reviewer`               | Orchestration, scaffolding, and code review guides        |
 #### Reference Skills (on-demand)
-90 more skills ready to use — spotify, weather, deep-research, tts, video-downloader, apple-reminders, 1password, terraform, postgres, jupyter-notebook, sentry, whatsapp, and more.
+89 more skills ready to use — spotify, weather, deep-research, tts, video-downloader, apple-reminders, 1password, terraform, postgres, jupyter-notebook, sentry, whatsapp, and more.
 ```bash
 jaw skill install <name>    # Activate a reference skill permanently
@@ -259,8 +297,9 @@ Your assistant isn't tied to your desk. Chat from anywhere via Telegram:
 **What you can do from Telegram:**
 - 💬 Chat with your assistant (any of 5 AI engines)
-- 🎤 Send voice messages (auto-transcribed)
+- 🎤 Send voice messages (auto-transcribed via multi-provider STT)
 - 📎 Send files and photos for processing
+- 🎙️ Combine voice + text + attachments in a single message
 - ⚡ Run commands (`/cli`, `/model`, `/status`)
 - 🔄 Switch AI engines on the fly
@@ -277,6 +316,26 @@ Your assistant isn't tied to your desk. Chat from anywhere via Telegram:
 ---
+## 🎤 Voice & STT — Speech-to-Text
+CLI-JAW supports voice input across all interfaces with multi-provider STT:
+| Provider | How to enable |
+|----------|--------------|
+| **OpenAI-compatible** | Settings UI → STT → OpenAI endpoint + API key |
+| **Google Vertex AI** | Settings UI → STT → Vertex AI credentials |
+| **Custom endpoint** | Any OpenAI-compatible STT API URL |
+**Where you can use voice:**
+- 🌐 **Web UI** — Click the mic button to record and transcribe in real-time
+- 📱 **Telegram** — Send voice messages; auto-transcribed before reaching the AI
+- 🎙️ **Multimodal** — Combine voice + text + file attachments in a single message
+All STT settings (provider, API keys, language) are managed in the **Settings UI** — no config files to edit.
+---
 ## 🎭 Multi-Agent Orchestration — PABCD
 For complex tasks, CLI-JAW uses **PABCD** — a finite state machine that enforces a strict 5-phase pipeline:
@@ -521,7 +580,7 @@ src/
 ## 🧪 Tests
 <details>
-<summary>608 pass · 1 skipped · zero external dependencies</summary>
+<summary>639 pass · 1 skipped · zero external dependencies</summary>
 ```bash
 npm test

package/README.zh-CN.md CHANGED Viewed

@@ -6,7 +6,7 @@
 *Claude、Codex、Gemini... 从此告别来回切换。*
-[![Tests](https://img.shields.io/badge/tests-608%20pass-brightgreen)](#-测试)
+[![Tests](https://img.shields.io/badge/tests-639%20pass-brightgreen)](#-测试)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://typescriptlang.org)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-blue)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-ISC-yellow)](LICENSE)
@@ -133,7 +133,7 @@ gemini                       # Google Gemini — 首次运行触发认证
  ✅ OpenCode CLI    installed
  ✅ Copilot CLI     installed
  ✅ Database        jaw.db OK
- ✅ Skills          17 active, 90 reference
+ ✅ Skills          20 active, 89 reference
  ✅ MCP             3 servers configured
  ✅ Memory          MEMORY.md exists
  ✅ Server          port 3457 available
@@ -154,7 +154,7 @@ CLI-JAW 是驻留在您本地机器上的**专属 AI 助手**，并在您熟悉
 > 💬 *"重构这个模块，顺便写好测试"* → 子 Agent 搞定，你喝杯咖啡回来就行
 > 💬 *"把那个 PDF 下载下来，关键信息放到 Notion 里"* → 浏览器 + Notion 技能组合，搞定
-与单一模型的助手不同，CLI-JAW 通过官方 CLI 命令行工具对 **5 大 AI 引擎**（Claude、Codex、Gemini、OpenCode、Copilot）进行编排 — 为您提供各大供应商最优势的能力及统一的体验。当一个引擎处于繁忙状态时，它会自动无缝切换至下一个。108 个内置技能可处理从浏览器自动化到文档生成的所有事务。
+与单一模型的助手不同，CLI-JAW 通过官方 CLI 命令行工具对 **5 大 AI 引擎**（Claude、Codex、Gemini、OpenCode、Copilot）进行编排 — 为您提供各大供应商最优势的能力及统一的体验。当一个引擎处于繁忙状态时，它会自动无缝切换至下一个。109 个内置技能可处理从浏览器自动化到文档生成的所有事务。
 |                                 | 为什么选择 CLI-JAW？                                                                  |
 | ------------------------------- | ------------------------------------------------------------------------------------- |
@@ -162,13 +162,28 @@ CLI-JAW 是驻留在您本地机器上的**专属 AI 助手**，并在您熟悉
 | 🤖 **经过验证的智能体工具**      | 5 大实战级编码智能体（Claude、Codex、Gemini、OpenCode、Copilot）集于一身。            |
 | ⚡ **多模型自动回退 (Fallback)** | 单一引擎发生故障？下一个立即接管。确保零停机。                                        |
 | 🎭 **基于编排的性能优化**        | 复杂的任务会被拆分给专业的子智能体，以实现效率最大化。                                |
-| 📦 **108 个内置技能**            | 浏览器自动化、文档生成、Telegram 通知、持久化记忆 — 开箱即用。                        |
+| 📦 **109 个内置技能**            | 浏览器自动化、文档生成、Telegram 通知、持久化记忆 — 开箱即用。                        |
 | 🖥️ **跨平台支持**                | macOS、Linux、Windows — ENOENT-safe CLI 启动、自动检测、`.cmd` 支持，跨平台原生运行。 |
 ![CLI-JAW 终端](docs/screenshots/terminal-cli.png)
 ---
+## 🆕 新功能 (v1.3.0)
+| 功能 | 说明 |
+|------|------|
+| 🎤 **语音 & STT** | Web 麦克风按钮 + Telegram 语音转写。多供应商 STT：OpenAI 兼容、Google Vertex AI、自定义端点。设置 UI 中管理 API 密钥。 |
+| 📝 **提示词模板** | 通过 Web UI 创建、编辑和管理提示词模板。节点地图可视化 + 完整 CRUD API。 |
+| 📊 **配额仪表盘** | 紧凑型配额条 + 重置时间显示。429 速率限制时使用缓存数据优雅处理。 |
+| 🔍 **IDE Diff 视图** | 基于指纹的变更检测。自动检测 VS Code 或 Antigravity 并打开内联 diff。 |
+| 🎭 **PABCD 增强** | 实时路线图进度条 + 🦈 鲨鱼跑步动画。阶段切换时有发光、脉冲和徽章反馈。 |
+| 🪟 **WSL 安装改进** | 自动安装前置依赖（`unzip`、`curl`、`git`），修复 `jaw` 命令 PATH，新增故障排除指南。 |
+| 🧪 **639 项测试** | 从 608 项增加 — 新增 STT、配额缓存、编排和 CI 稳定性覆盖。 |
+| 📦 **109 个技能** | 20 个活跃 + 89 个参考。新增：`dev-pabcd`、`dev-scaffolding`、`dev-code-reviewer`。 |
+---
 ## 您的助手能做什么？
 ```mermaid
@@ -189,7 +204,9 @@ graph LR
 - 🤖 **5 大 AI 引擎，1 个专属助手** — Claude · Codex · Gemini · OpenCode · Copilot。使用 `/cli` 命令一键切换。
 - ⚡ **自动回退 (Fallback)** — 即使一个引擎出现故障，下一个也会无缝接管。
 - 🎭 **多智能体编排** — 复杂任务会自动拆分给专业的子智能体并行处理。
-- 📦 **108 个技能** — 浏览器控制、文件编辑、图片生成、网页搜索以及[更多功能](#-技能系统)。
+- 🎤 **语音输入** — Web 麦克风按钮 + Telegram 语音消息。多供应商 STT（OpenAI、Vertex AI）。
+- 📝 **提示词模板** — 使用可视化节点地图编辑器创建、管理和复用提示词模板。
+- 📦 **109 个技能** — 浏览器控制、文件编辑、图片生成、网页搜索以及[更多功能](#-技能系统)。
 - 🧠 **持久化记忆** — 跨越不同会话，记住您过往的对话和偏好设定。
 - 📱 **Telegram 机器人** — 通过手机即可与您的助手聊天、发送语音/图片/文件。
 - 🌐 **浏览器自动化** — 您的助手能够自动导航网页、点击、打字并进行截图。
@@ -212,15 +229,15 @@ jaw service install  # 开机自动启动 (systemd/launchd/docker 自动检测)
 ## 📦 技能系统
-**108 个技能**开箱即用 — 浏览器、GitHub、Notion、Telegram、记忆、PDF、图片生成等[应有尽有](#)。
+**109 个技能**开箱即用 — 浏览器、GitHub、Notion、Telegram、记忆、PDF、图片生成等[应有尽有](#)。
 <details>
 <summary>查看全部技能</summary>
 | 层级         | 数量  | 工作方式                           |
 | ------------ | :---: | ---------------------------------- |
-| **活跃技能** |  17   | 每次对话自动加载，随时可用。       |
-| **参考技能** |  90   | 用到的时候 AI 自己去读，按需调用。 |
+| **活跃技能** |  20   | 每次对话自动加载，随时可用。       |
+| **参考技能** |  89   | 用到的时候 AI 自己去读，按需调用。 |
 #### 活跃技能（常驻）
@@ -237,10 +254,11 @@ jaw service install  # 开机自动启动 (systemd/launchd/docker 自动检测)
 | `screen-capture`                                                    | macOS 截图和摄像头捕获                  |
 | `openai-docs`                                                       | 最新 OpenAI API 文档                    |
 | `dev` / `dev-frontend` / `dev-backend` / `dev-data` / `dev-testing` | 子 Agent 开发指南                       |
+| `dev-pabcd` / `dev-scaffolding` / `dev-code-reviewer`               | 编排、脚手架和代码审查指南                                |
 #### 参考技能（按需调用）
-90 个技能随时待命 — Spotify、天气、深度研究、TTS、视频下载、Apple 提醒事项、1Password、Terraform、PostgreSQL、Jupyter 等。
+89 个技能随时待命 — Spotify、天气、深度研究、TTS、视频下载、Apple 提醒事项、1Password、Terraform、PostgreSQL、Jupyter 等。
 ```bash
 jaw skill install <name>    # 参考 → 活跃，永久激活
@@ -286,6 +304,26 @@ jaw skill install <name>    # 参考 → 活跃，永久激活
 ---
+## 🎤 语音 & STT — 语音转文字
+CLI-JAW 通过多供应商 STT 在所有界面支持语音输入：
+| 供应商 | 设置方法 |
+|-------|---------|
+| **OpenAI 兼容** | Settings UI → STT → OpenAI 端点 + API 密钥 |
+| **Google Vertex AI** | Settings UI → STT → Vertex AI 凭证 |
+| **自定义端点** | 任何 OpenAI 兼容的 STT API URL |
+**可以使用语音的场景：**
+- 🌐 **Web UI** — 点击麦克风按钮实时录音并转写
+- 📱 **Telegram** — 发送语音消息，AI 处理前自动转写
+- 🎙️ **多模态** — 在单条消息中组合语音 + 文字 + 文件附件
+所有 STT 设置（供应商、API 密钥、语言）均在 **Settings UI** 中管理 — 无需编辑配置文件。
+---
 ## 🎭 多智能体编排
 对于复杂的任务，您的助手会自动将其委派给专业的子智能体：
@@ -470,7 +508,7 @@ src/
 ## 🧪 测试
 <details>
-<summary>608 pass · 1 skipped · 零外部依赖</summary>
+<summary>639 pass · 1 skipped · 零外部依赖</summary>
 ```bash
 npm test

package/dist/src/agent/args.js CHANGED Viewed

@@ -1,6 +1,6 @@
 // ─── Agent CLI Argument Builders ──────────────────────
 // Extracted from agent.js for 500-line compliance.
-export function buildArgs(cli, model, effort, prompt, sysPrompt, permissions = 'auto') {
+export function buildArgs(cli, model, effort, prompt, sysPrompt, permissions = 'auto', options = {}) {
     const autoPerm = permissions === 'auto';
     switch (cli) {
         case 'claude':
@@ -15,6 +15,7 @@ export function buildArgs(cli, model, effort, prompt, sysPrompt, permissions = '
             return ['exec',
                 ...(model && model !== 'default' ? ['-m', model] : []),
                 ...(effort ? ['-c', `model_reasoning_effort="${effort}"`] : []),
+                ...(options.fastMode ? ['--enable', 'fast_mode'] : []),
                 ...(autoPerm ? ['--dangerously-bypass-approvals-and-sandbox'] : []),
                 '--skip-git-repo-check', '--json'];
         case 'gemini':
@@ -31,7 +32,7 @@ export function buildArgs(cli, model, effort, prompt, sysPrompt, permissions = '
             return [];
     }
 }
-export function buildResumeArgs(cli, model, effort, sessionId, prompt, permissions = 'auto') {
+export function buildResumeArgs(cli, model, effort, sessionId, prompt, permissions = 'auto', options = {}) {
     const autoPerm = permissions === 'auto';
     switch (cli) {
         case 'claude':
@@ -45,6 +46,7 @@ export function buildResumeArgs(cli, model, effort, sessionId, prompt, permissio
         case 'codex':
             return ['exec', 'resume',
                 ...(model && model !== 'default' ? ['--model', model] : []),
+                ...(options.fastMode ? ['--enable', 'fast_mode'] : []),
                 ...(autoPerm ? ['--dangerously-bypass-approvals-and-sandbox'] : []),
                 '--skip-git-repo-check',
                 sessionId, prompt || '', '--json'];

package/dist/src/agent/args.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/agent/args.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,mDAAmD;AAEnD,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,SAAiB,EAAE,WAAW,GAAG,MAAM;~~IACzH~~,MAAM,QAAQ,GAAG,WAAW,KAAK,MAAM,CAAC;IACxC,QAAQ,GAAG,EAAE,CAAC;QACV,KAAK,QAAQ;YACT,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa;gBAC5D,4BAA4B;gBAC5B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,aAAa,EAAE,IAAI;gBACnB,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,KAAK,OAAO;YACR,OAAO,CAAC,MAAM;gBACV,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,2BAA2B,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,uBAAuB,EAAE,QAAQ,CAAC,CAAC;QAC3C,KAAK,QAAQ;YACT,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE;gBACtB,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QACnC,KAAK,UAAU;YACX,OAAO,CAAC,KAAK;gBACT,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxC,UAAU,EAAE,MAAM;gBAClB,MAAM,IAAI,EAAE,CAAC,CAAC;QACtB;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc,EAAE,SAAiB,EAAE,MAAc,EAAE,WAAW,GAAG,MAAM;~~IAC/H~~,MAAM,QAAQ,GAAG,WAAW,KAAK,MAAM,CAAC;IACxC,QAAQ,GAAG,EAAE,CAAC;QACV,KAAK,QAAQ;YACT,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa;gBAC5D,4BAA4B;gBAC5B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,UAAU,EAAE,SAAS;gBACrB,aAAa,EAAE,IAAI;gBACnB,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxE,KAAK,OAAO;YACR,OAAO,CAAC,MAAM,EAAE,QAAQ;gBACpB,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,uBAAuB;gBACvB,SAAS,EAAE,MAAM,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3C,KAAK,QAAQ;YACT,OAAO,CAAC,UAAU,EAAE,SAAS;gBACzB,IAAI,EAAE,MAAM,IAAI,EAAE;gBAClB,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QACnC,KAAK,UAAU;YACX,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS;gBAC1B,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxC,UAAU,EAAE,MAAM;gBAClB,MAAM,IAAI,EAAE,CAAC,CAAC;QACtB;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC"}
1	+ {"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/agent/args.ts"],"names":[],"mappings":"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"}

package/dist/src/agent/spawn.js CHANGED Viewed

@@ -298,10 +298,10 @@ export function spawnAgent(prompt, opts = {}) {
     let args;
     if (isResume) {
         console.log(`[jaw:resume] ${cli} session=${resumeSessionId.slice(0, 12)}...`);
-        args = buildResumeArgs(cli, model, effort, resumeSessionId, prompt, permissions);
+        args = buildResumeArgs(cli, model, effort, resumeSessionId, prompt, permissions, { fastMode: cfg.fastMode });
     }
     else {
-        args = buildArgs(cli, model, effort, promptForArgs, sysPrompt, permissions);
+        args = buildArgs(cli, model, effort, promptForArgs, sysPrompt, permissions, { fastMode: cfg.fastMode });
     }
     const agentLabel = agentId || 'main';
     // ─── DIFF-A: Preflight — verify CLI binary exists before spawn ───