# EVOLVE-ARCHITECH

**Repository Path**: kaitoops/evolve-architech

## Basic Information

- **Project Name**: EVOLVE-ARCHITECH
- **Description**: CLAW进化架构实验性尝试（可能弃用）
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EVOLVE-ARCHITECH

> 实验性架构分支 · 与主架构隔离运行

## 定位

本仓库是 WorkBuddy Claw 架构的**实验沙箱**，专门存放可能成功也可能被弃用的探索性功能。

**主架构仓库**：[workbuddysystemevobackup](https://gitee.com/kaitoops/workbuddysystemevobackup)  
保持五条核心设计原则（P1 轻量优先 · P2 文件即状态 · P3 人类可读 · P4 按需取用 · P5 人类主权）

**本仓库**：实验性扩展，不受 P1/P4 约束，允许引入更复杂的组件。

---

## 当前实验内容：SKILL 追踪仪表盘系统

### 架构组成

```
.workbuddy/
├── dashboard/
│   ├── index.html     # 前端 UI（33 KB，6 模块）
│   ├── app.js         # 前端逻辑（29 KB）
│   ├── simple-test.html
│   └── test-api.html
├── server.js          # Node.js REST API 后端（9.4 KB）
├── data/
│   └── workbuddy.db   # SQLite 持久化数据库
└── docs/
    └── SKILL追踪与仪表盘系统实施方案.md  # 系统设计文档（23 KB）
```

### 仪表盘功能模块

| 模块 | 状态 | 描述 |
|------|------|------|
| SKILL 状态总览 | ✅ 已实现 | 5个SKILL的实时状态卡片 |
| 性能统计 | ✅ 已实现 | 4指标卡片 + 趋势指示 + 图表切换 |
| 趋势分析 | ✅ 已实现 | 4概览卡片 + SKILL筛选 |
| 用户反馈 | ✅ 已实现 | 星级评分 + 评论表单 |
| 版本对比 | ✅ 已实现 | A/B版本百分比差值对比 |
| 上下文监控 | ✅ 已实现 | TOKEN使用量可视化进度条 |
| 模块管理器 | ✅ 已实现 | 可选模块开关 + 刷新间隔设置 |

---

## 架构隔离原因

**问题诊断（2026-03-19）**：
仪表盘系统引入了三个大体量文件（index.html 33KB + app.js 29KB + server.js 9.4KB），
加上设计文档 23KB，总计约 95KB 的非核心内容污染了工作区上下文。
这与原始架构的 P1（轻量优先）原则直接冲突。

**解决方案**：将仪表盘实验移至本仓库独立演化，主仓库回归精简状态。

**失败处理预案**：若本实验无价值，直接弃用本仓库，主架构不受影响。

---

## 如何启动仪表盘

```bash
# 1. 安装依赖
cd .workbuddy && npm install

# 2. 启动后端服务
node server.js

# 3. 浏览器打开
# http://localhost:3000
```

或运行 `start-dashboard.bat`

---

## 实验状态

- **开始日期**：2026-03-19
- **当前阶段**：架构隔离 · 可自由演化
- **评估周期**：视使用频率决定是否合并回主架构或弃用