cc-viewer 1.6.205 → 1.6.207

package/README.md

@@ -1,11 +1,14 @@
-# CC-Viewer
+<img width="1500" height="150" alt="ccv" src="https://github.com/user-attachments/assets/433e79d4-8d55-4e3a-9efe-69bf4aa54426" />
 
-A Claude Code request monitoring system that captures and visualizes all API requests and responses from Claude Code in real time (raw text, unredacted). Helps developers monitor their context for review and troubleshooting during Vibe Coding sessions.
-The latest version of CC-Viewer also provides a server-deployed web programming solution and mobile programming tools. Feel free to use them in your own projects — more plugin features and cloud deployment support are coming in the future.
+# CC-Viewer
 
-Check out the fun part — here's what you can see on mobile:
+A Vibe Coding toolkit distilled from 15+ years of internet-industry R&D experience, built on top of Claude Code:
 
-<img width="1700" height="790" alt="image" src="https://github.com/user-attachments/assets/da3e519f-ff66-4cd2-81d1-f4e131215f6c" />
+1. Run /ultraPlan and /ultraReview locally, so your code never has to be fully exposed to Claude's cloud;
+2. Enables mobile programming over your local network (user-extensible);
+3. Full Claude Code payload interception and analysis — great for logging, debugging, learning, and reverse-engineering;
+4. Ships with accumulated study notes and hands-on experience (look for the "?" icons throughout the app), so we can explore and grow together;
+5. Web UI adapts to every size mode — drop it into browser extensions, OS split views, and any embedding scenario; a native installer is also available.
 
 English | [简体中文](./docs/README.zh.md) | [繁體中文](./docs/README.zh-TW.md) | [한국어](./docs/README.ko.md) | [日本語](./docs/README.ja.md) | [Deutsch](./docs/README.de.md) | [Español](./docs/README.es.md) | [Français](./docs/README.fr.md) | [Italiano](./docs/README.it.md) | [Dansk](./docs/README.da.md) | [Polski](./docs/README.pl.md) | [Русский](./docs/README.ru.md) | [العربية](./docs/README.ar.md) | [Norsk](./docs/README.no.md) | [Português (Brasil)](./docs/README.pt-BR.md) | [ไทย](./docs/README.th.md) | [Türkçe](./docs/README.tr.md) | [Українська](./docs/README.uk.md)
 
@@ -37,16 +40,15 @@ ccv -c --d             # == claude --continue --dangerously-skip-permissions
 
 After launching in programming mode, a web page will open automatically.
 
-You can use Claude directly from the web page while viewing the full request payloads and code changes.
-
-Even better — you can even code from your mobile device!
+CC-Viewer also ships as a native desktop app — grab the build for your platform from GitHub.
+[Download page](https://github.com/weiesky/cc-viewer/releases)
 
 
 ### Logger Mode
 
-⚠️ If you still prefer using the native claude tool or VS Code extension, use this mode.
+If you still prefer the native claude tool or the VS Code extension, use this mode.
 
-In this mode, launching `claude` or `claude --dangerously-skip-permissions` will automatically start a logging process that records request logs to ~/.claude/cc-viewer/*yourproject*/date.jsonl
+In this mode, launching `claude` will automatically start a logging process that records request logs to ~/.claude/cc-viewer/*yourproject*/date.jsonl
 
 Enable logger mode:
 ```bash
@@ -55,12 +57,6 @@ ccv -logger
 
 When the console cannot print the specific port, the default first port is 127.0.0.1:7008. Multiple instances use sequential ports like 7009, 7010.
 
-This command automatically detects how Claude Code is installed locally (NPM or Native Install) and adapts accordingly.
-
-- **NPM version Claude Code**: Automatically injects an interceptor script into Claude Code's `cli.js`.
-- **Native version Claude Code**: Automatically detects the `claude` binary, configures a local transparent proxy, and sets up a Zsh Shell Hook to forward traffic automatically.
-- NPM-installed Claude Code is the recommended approach for this project.
-
 Uninstall logger mode:
 ```bash
 ccv --uninstall
@@ -82,6 +78,7 @@ Letting Claude Code diagnose the issue itself is more effective than asking anyo
 
 After the above instruction is completed, `findcc.js` will be updated. If your project frequently requires local deployment, or if forked code often needs to resolve installation issues, keeping this file lets you simply copy it next time. At this stage, many projects and companies using Claude Code are not deploying on Mac but rather on server-side hosted environments, so the author has separated `findcc.js` to make it easier to track cc-viewer source code updates going forward.
 
+
 ### Other Commands
 
 See:
@@ -90,10 +87,6 @@ See:
 ccv -h
 ```
 
-### Configuration Override
-
-If you need to use a custom API endpoint (e.g., a corporate proxy), simply configure it in `~/.claude/settings.json` or set the `ANTHROPIC_BASE_URL` environment variable. `ccv` will automatically detect and correctly forward requests.
-
 ### Silent Mode
 
 By default, `ccv` runs in silent mode when wrapping `claude`, keeping your terminal output clean and consistent with the native experience. All logs are captured in the background and can be viewed at `http://localhost:7008`.
@@ -122,10 +115,10 @@ While you can open files and code manually, manual coding is not recommended —
 You can even scan a QR code to code from your mobile device:
 
 <img width="3018" height="1460" alt="image" src="https://github.com/user-attachments/assets/8debf48e-daec-420c-b37a-609f8b81cd20" />
+<img width="1700" height="790" alt="image" src="https://github.com/user-attachments/assets/da3e519f-ff66-4cd2-81d1-f4e131215f6c" />
 
 Fulfill your imagination of mobile programming. There's also a plugin mechanism — if you need to customize for your coding habits, stay tuned for plugin hooks updates.
 
-**Voice input:** tap the microphone icon in the chat input for voice-to-text (Web Speech API; requires HTTPS or localhost, so it's hidden on LAN HTTP access). Alternatively, on Android use Gboard's built-in 🎤 key, and on iOS use the system dictation on the keyboard — both work offline and without any HTTPS requirement.
 
 ### Logger Mode (View Complete Claude Code Sessions)
 
@@ -144,7 +137,6 @@ Click the "Conversation Mode" button in the top-right corner to parse the Main A
 
 <img width="1500" height="764" alt="image" src="https://github.com/user-attachments/assets/725b57c8-6128-4225-b157-7dba2738b1c6" />
 
-
 - Agent Team display is not yet supported
 - User messages are right-aligned (blue bubbles), Main Agent replies are left-aligned (dark bubbles)
 - `thinking` blocks are collapsed by default, rendered as Markdown — click to expand and view the thinking process; one-click translation is supported (feature is still unstable)
@@ -153,22 +145,10 @@ Click the "Conversation Mode" button in the top-right corner to parse the Main A
 - Settings panel: toggle default collapse state for tool results and thinking blocks
 - Mobile conversation browsing: in mobile CLI mode, tap the "Conversation Browse" button in the top bar to slide out a read-only conversation view for browsing the complete conversation history on mobile
 
-### Statistics Tool
-
-The "Data Statistics" floating panel in the header area:
-
-<img width="1500" height="765" alt="image" src="https://github.com/user-attachments/assets/a3d2db47-eac3-463a-9b44-3fa64994bf3b" />
-
-- Displays cache creation/read counts and cache hit rate
-- Cache rebuild statistics: grouped by reason (TTL, system/tools/model changes, message truncation/modification, key changes) showing counts and cache_creation tokens
-- Tool usage statistics: displays call frequency for each tool sorted by number of calls
-- Skill usage statistics: displays call frequency for each skill sorted by number of calls
-- Supports teammate statistics
-- Concept help (?) icon: click to view built-in documentation for MainAgent, CacheRebuild, and each tool
-
 ### Log Management
 
 Via the CC-Viewer dropdown menu in the top-left corner:
+
 <img width="1500" height="760" alt="image" src="https://github.com/user-attachments/assets/33295e2b-f2e0-4968-a6f1-6f3d1404454e" />
 
 **Log Compression**
@@ -200,24 +180,10 @@ You can customize plugins, manage all CC-Viewer processes, and CC-Viewer support
 
 ---
 
-
 <img width="1500" height="746" alt="image" src="https://github.com/user-attachments/assets/b1f60c7c-1438-4ecc-8c64-193d21ee3445" />
 
 More features waiting to be discovered... For example: the system supports Agent Team, and has a built-in Code Reviewer. Codex Code Reviewer integration is coming soon (the author highly recommends using Codex to review Claude Code's code).
 
-
-### Auto-Update
-
-CC-Viewer automatically checks for updates on startup (at most once every 4 hours). Within the same major version (e.g., 1.x.x -> 1.y.z), updates are applied automatically and take effect on the next restart. Cross-major-version updates only show a notification.
-
-Auto-update follows Claude Code's global configuration in `~/.claude/settings.json`. If Claude Code has auto-updates disabled (`autoUpdates: false`), CC-Viewer will also skip auto-updates.
-
-### Multi-language Support
-
-CC-Viewer supports 18 languages, automatically switching based on system locale:
-
-简体中文 | English | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська
-
 ## License
 
 MIT

package/cli.js

@@ -362,11 +362,12 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   });
 
   const port = serverMod.getPort();
+  const serverProtocol = serverMod.getProtocol();
 
   // 3. 启动 PTY 中的 claude
   const { spawnClaude, killPty } = await import('./pty-manager.js');
   try {
-    await spawnClaude(proxyPort, workingDir, extraClaudeArgs, claudePath, isNpmVersion, port);
+    await spawnClaude(proxyPort, workingDir, extraClaudeArgs, claudePath, isNpmVersion, port, serverProtocol);
   } catch (err) {
     console.error('[CC Viewer] Failed to spawn Claude:', err.message);
     await serverMod.stopViewer();
@@ -456,6 +457,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
     onStreamingStatus: (data) => serverMod.setSdkStreamingState(data),
     broadcastWs: (msg) => serverMod.broadcastWsMessage(msg),
     permissionMode,
+    runWaterfallHook: (await import('./lib/plugin-loader.js')).runWaterfallHook,
   });
 
   // 注册 SDK 回调到 server.js（WS 消息路由用）