mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
02531c4d15
## Changes ### i18n 中文化 (i18n.js, cli-history.js) - 添加 60+ 个翻译键用于 CLI 执行历史和对话详情 - 将 cli-history.js 中的硬编码英文字符串替换为 t() 函数调用 - 覆盖范围: 执行历史、对话详情、状态、工具标签、按钮、提示等 ### 修复 Claude 会话追踪 (native-session-discovery.ts) - 问题: Claude 使用路径编码存储会话 (D:\path -> D--path)，但代码使用 SHA256 哈希导致无法发现 - 解决方案: - 添加 encodeClaudeProjectPath() 函数用于路径编码 - 更新 ClaudeSessionDiscoverer.getSessions() 使用路径编码 - 增强 extractFirstUserMessage() 支持多种消息格式 (string/array) - 结果: Claude 会话现可正确关联，UI 按钮 "查看完整过程对话" 应可正常显示 ## 验证 - npm run build 通过 ✅ - Claude 会话发现 1267 个会话 ✅ - 消息提取成功率 80% ✅ - 路径编码验证正确 ✅
CCW - Claude Code Workflow CLI
A powerful command-line tool for managing Claude Code Workflow with native CodexLens code intelligence, multi-model CLI orchestration, and interactive dashboard.
Installation
# Install globally
npm install -g ccw
# Or install from local source
cd path/to/ccw
npm install
npm link
Usage
View Dashboard
# Open workflow dashboard in browser
ccw view
# Specify project path
ccw view -p /path/to/project
# Generate dashboard without opening browser
ccw view --no-browser
# Custom output path
ccw view -o report.html
Features
🔍 Native CodexLens (v6.3)
- Full-Text Search (FTS): SQLite-based fast keyword search with symbol extraction
- Semantic Search: Dense embedding-based similarity search with vector store
- Hybrid Search: RRF (Reciprocal Rank Fusion) combining FTS and semantic results
- Cross-Encoder Reranking: Second-stage reranker for improved result relevance
- HNSW Index: Approximate Nearest Neighbor index for significantly faster vector search
- Dynamic Batch Processing: Intelligent batch size calculation for embedding generation
- Workspace Index Status: Real-time index status monitoring and management
💻 CLI Tools Integration
- Multi-Model Support: Execute prompts with Gemini, Qwen, Codex, Claude, or OpenCode
- CLI Wrapper Endpoints: Custom API endpoints with tool calling support
- Smart Content Formatter: Intelligent output formatting with structured IR
- Session Resume: Resume from last session or merge multiple sessions
- SQLite History: Persistent execution history with conversation tracking
- Custom IDs: Support for custom execution IDs and multi-turn conversations
- Preload Service: Optimized data fetching with caching for faster responses
🧠 Core Memory & Clustering
- Session Clustering: Intelligent grouping of related sessions
- Cluster Visualization: Interactive display with Cytoscape.js
- Cluster Management: Delete, merge, and deduplicate operations
🖥️ Dashboard Views
- Workflow Dashboard: Active/archived sessions with task progress
- CodexLens Manager: Index management with real-time progress bar
- Core Memory: Session clustering visualization
- CLAUDE.md Manager: File tree viewer for configuration
- Skills Manager: View and manage Claude Code skills
- Graph Explorer: Interactive code relationship visualization
- MCP Manager: Configure and monitor MCP servers
- Hook Manager: Manage Claude Code hooks
- Help View: Internationalized help documentation
Review Integration
- Code Review Findings: View results from
review-module-cycle - Severity Distribution: Critical/High/Medium/Low finding counts
- Dimension Analysis: Findings by review dimension (Security, Architecture, Quality, etc.)
- Tabbed Interface: Switch between Workflow and Reviews tabs
Dashboard Data Sources
The CLI reads data from the .workflow/ directory structure:
.workflow/
├── active/
│ └── WFS-{session-id}/
│ ├── workflow-session.json # Session metadata
│ ├── .task/
│ │ └── IMPL-*.json # Task definitions
│ └── .review/
│ ├── review-progress.json # Review progress
│ └── dimensions/
│ └── *.json # Dimension findings
└── archives/
└── WFS-{session-id}/ # Archived sessions
Bundled Templates
The CLI includes bundled dashboard templates:
workflow-dashboard.html- Workflow session and task visualizationreview-cycle-dashboard.html- Code review findings display
No external template installation required - templates are included in the npm package.
Requirements
- Node.js >= 16.0.0
- npm or yarn
Integration with Claude Code Workflow
This CLI is a standalone tool that works with the Claude Code Workflow system:
-
Install CCW CLI (via npm)
npm install -g ccw- Provides
ccw viewcommand for dashboard viewing - Templates are bundled - no additional installation required
-
Optional: Install Claude Code Workflow (via
Install-Claude.ps1)- Provides workflow commands, agents, and automation
- CCW will automatically detect and display workflow sessions
Options
| Option | Description |
|---|---|
-p, --path <path> |
Path to project directory (default: current directory) |
--no-browser |
Generate dashboard without opening browser |
-o, --output <file> |
Custom output path for HTML file |
-V, --version |
Display version number |
-h, --help |
Display help information |
Development
# Clone and install dependencies
git clone <repo-url>
cd ccw
npm install
# Link for local testing
npm link
# Test the CLI
ccw view -p /path/to/test/project
License
MIT