Skip to content

About

ClawCanvas 是对 [ultraworkers/claw-code](https://github.com/ultraworkers/claw-code) 的创意分叉,为现有的 AI 编码助手添加了现代化的分屏终端 UI。本项目由 Thanksgiver 开发,作为申请 Agent 相关技术岗位的求职作品集。 项目展示了高级 Rust 编程技能、终端 UI 设计和系统架构能力。Phase 2-5 的所有新功能均采用零额外外部依赖实现,仅使用 Rust 标准库和现有 crates。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClawCanvas 提交包索引 / Submission Package Index

作者 / Author: Thanksgiver
版本 / Version: v1.0.0
日期 / Date: 2026-08-18
项目路径 / Project Path: D:\claw-code-main\claw-code-main


目录结构 / Directory Structure

submission/
├── README.md                    # 项目总览 / Project overview
├── LICENSE                      # MIT 许可证 / MIT License
├── docs/                        # 开发文档 / Development documentation
│   ├── README.md                # 项目说明(双语)/ Project description (bilingual)
│   ├── BUILD.md                 # 构建指南 / Build guide
│   ├── SRC_README.md            # 源码说明 / Source code documentation
│   ├── PROJECT_SUMMARY.md       # 项目总结 / Project summary
│   ├── GITHUB_SUBMISSION_COMPLETE.md  # GitHub 提交包 / GitHub submission package
│   ├── canvas-ui-redesign.md    # Phase 2 设计稿 / Phase 2 design spec
│   ├── phase2-verification-report-v2.md  # Phase 2 验证报告 / Phase 2 verification
│   ├── phase4-final-report.md   # Phase 4 最终报告 / Phase 4 final report
│   ├── phase5-plan.md           # Phase 5 开发方案 / Phase 5 development plan
│   └── phase5-verification-report.md  # Phase 5 验证报告 / Phase 5 verification
├── scripts/                     # 辅助脚本 / Helper scripts
│   ├── verify-phase2.ps1        # Phase 2 验证脚本 / Phase 2 verification script
│   └── fix_main_encoding.py     # 编码修复脚本 / Encoding fix script
└── config/                      # 配置文件 / Configuration files
    ├── .gitignore               # Git 忽略规则 / Git ignore rules
    └── .dockerignore            # Docker 忽略规则 / Docker ignore rules

文件说明 / File Descriptions

根目录文件 / Root Files

文件 / File 大小 / Size 说明 / Description
README.md 8.5 KB 项目主文档,包含中英文双语介绍 / Main project document with bilingual intro
LICENSE 1.9 KB MIT 许可证 / MIT License

文档目录 / Documentation (docs/)

文件 / File 大小 / Size 阶段 / Phase 说明 / Description
README.md 8.5 KB 全部 / All 项目概述、功能介绍、安装指南 / Project overview, features, installation
BUILD.md 4.5 KB 全部 / All 构建命令、测试方法、发布清单 / Build commands, testing, release checklist
SRC_README.md 6.5 KB 全部 / All 源码模块说明、API 使用示例 / Source module docs, API examples
PROJECT_SUMMARY.md 7.4 KB Phase 1-5 项目开发总结报告 / Project development summary
GITHUB_SUBMISSION_COMPLETE.md 9.1 KB 全部 / All GitHub 提交包完整说明 / Complete GitHub submission guide
canvas-ui-redesign.md 8.9 KB Phase 2 Canvas UI 改造设计稿 / Canvas UI redesign specification
phase2-verification-report-v2.md 8.7 KB Phase 2 Phase 2 验证报告 v2 / Phase 2 verification report
phase4-final-report.md 4.9 KB Phase 4 Phase 4 最终报告 / Phase 4 final report
phase5-plan.md 6.6 KB Phase 5 Phase 5 开发方案 / Phase 5 development plan
phase5-verification-report.md 4.3 KB Phase 5 Phase 5 验证报告 / Phase 5 verification report

脚本目录 / Scripts (scripts/)

文件 / File 大小 / Size 说明 / Description
verify-phase2.ps1 2.2 KB Phase 2 验证脚本(PowerShell)/ Phase 2 verification script
fix_main_encoding.py 2.0 KB main.rs 编码修复脚本(Python)/ main.rs encoding fix script

配置目录 / Config (config/)

文件 / File 大小 / Size 说明 / Description
.gitignore 300 B Git 忽略规则 / Git ignore rules
.dockerignore 230 B Docker 忽略规则 / Docker ignore rules

源码位置 / Source Code Location

注意 / Note: 本目录仅包含非源码文件和文档。源码位于以下路径:
Note: This directory contains non-source files and documentation only. Source code is located at:

rust/crates/rusty-claude-cli/src/
├── canvas/                    # Canvas UI 模块 / Canvas UI modules
│   ├── mod.rs                 # 主控制器 / Main controller (360 lines)
│   ├── file_tree.rs           # 文件树面板 / File tree panel
│   ├── tool_trace.rs          # 工具追踪面板 / Tool trace panel
│   ├── tool_duration.rs       # 工具耗时面板 / Duration tracking panel
│   ├── cost_chart.rs          # 成本图表面板 / Cost chart panel
│   ├── session_diff.rs        # 会话对比面板 / Session diff panel
│   ├── status_bar.rs          # 状态栏 / Status bar
│   ├── panel.rs               # Panel trait 定义 / Panel trait definition
│   └── integration_guide.rs   # 集成指南 / Integration guide
├── file_watcher.rs            # 文件监听器 / File watcher
├── main.rs                    # CLI 入口 / CLI entry point
├── input.rs                   # REPL 实现 / REPL implementation
├── init.rs                    # 初始化 / Initialization
├── render.rs                  # 渲染工具 / Rendering utilities
└── setup_wizard.rs            # 设置向导 / Setup wizard

新增功能概览 / New Features Overview

Phase 2: Canvas UI 改造 / Canvas UI Redesign

  • 创新点 / Innovation: 实现多视图工作空间面板系统
  • 实现 / Implementation: 基于 crossterm 的终端 UI 框架
  • 布局模式 / Layout Modes: 单列、双栏、三栏三种布局
  • 测试覆盖 / Test Coverage: 26 个单元测试全部通过

Phase 4: 实时文件监听 / Real-time File Watching

  • 创新点 / Innovation: 纯标准库实现的跨平台文件监听
  • 技术 / Technology: 轮询方案(无额外依赖)
  • 性能优化 / Performance: 深度限制、排除模式、防抖处理

Phase 5: 高级功能扩展 / Advanced Features

  • ToolDurationPanel: 工具执行耗时追踪与颜色编码
  • CostChartPanel: ASCII 艺术成本趋势图
  • SessionDiffPanel: 会话对比与差异高亮

技术栈 / Tech Stack

组件 / Component 技术 / Technology 版本 / Version
语言 / Language Rust 1.75+
终端 UI / Terminal UI crossterm 0.28
异步运行时 / Async Runtime tokio 1.x
REPL / REPL Editor rustyline 15
序列化 / Serialization serde + serde_json 1.x

构建与测试 / Build & Test

# 构建项目 / Build project
cd rust && cargo build -p rusty-claude-cli

# 运行测试 / Run tests
cargo test -p rusty-claude-cli -- canvas
cargo test -p rusty-claude-cli -- file_watcher

# 代码检查 / Code check
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings

作者信息 / Author Information

  • 姓名 / Name: Thanksgiver
  • 身份 / Role: 研究生,Agent 系统方向 / Graduate student, Agent systems
  • GitHub: @Thanksgiver233
  • 项目目的 / Purpose: 求职作品集,展示 Rust 编程、终端 UI 设计和系统架构能力

文档版本 / Document Version: 1.0.0
最后更新 / Last Updated: 2026-08-18

About

ClawCanvas 是对 [ultraworkers/claw-code](https://github.com/ultraworkers/claw-code) 的创意分叉,为现有的 AI 编码助手添加了现代化的分屏终端 UI。本项目由 Thanksgiver 开发,作为申请 Agent 相关技术岗位的求职作品集。 项目展示了高级 Rust 编程技能、终端 UI 设计和系统架构能力。Phase 2-5 的所有新功能均采用零额外外部依赖实现,仅使用 Rust 标准库和现有 crates。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages