# 202668

**Repository Path**: study10086/202668

## Basic Information

- **Project Name**: 202668
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 学习

## README

# AI Workflow Kit

AI Workflow Kit 是一个本地 AI 工作流控制台和技能包，用来统一管理 Cursor、Codex、Claude Code 和通用 agent 的规划、编码、记忆、检索、研究、提示词、模型配置以及本地 AI 工具。

当前版本已经把五类常用 AI 辅助工具集成到 Web 端展示和诊断面板中。具体工具目录由 `server/toolsRegistry.ts` 配置，README 不依赖某台机器上的绝对路径。

- CodeGraph
- CodeGraphContext
- FreeLLMAPI
- Understand Anything
- Karpathy Skills

## 快速启动

在本仓库根目录运行：

```powershell
corepack pnpm run dev
```

启动后打开：

```text
http://localhost:3000/
```

如果 `3000` 被占用，服务会自动切到 `3001` 等可用端口。开发模式下 Web 控制台会绕过登录，方便本地调试。

## Web 控制台功能

| 页面 | 路径 | 功能 |
| --- | --- | --- |
| Dashboard | `/dashboard` | 本地工具总览、路径检查、端口探测、状态统计 |
| Tool Detail | `/tools/:id` | 单个工具详情、README 摘要、manifest 扫描、环境诊断、源码检索 |
| Code Graph | `/code-graph` | CodeGraph、CodeGraphContext、Understand Anything 的图谱能力入口 |
| Workflows | `/workflows` | plan、code、memory、research、prompt、model 等工作流模块 |
| Model Gateway | `/model-gateway` | FreeLLMAPI 模型网关概览和 `/v1/models` 探测 |
| Model Routing | `/model-routing` | 模型路由、fallback、限流和 provider 映射说明 |
| Tasks | `/tasks` | Web 控制台触发的 test/start/stop/restart 操作记录 |
| Config Center | `/config-center` | 工具注册表、端口、日志、白名单动作配置清单 |
| Logs | `/logs` | 已登记日志文件的本地读取面板 |

## 已集成工具

| 工具 | Web 入口 | 作用 | 当前实现 |
| --- | --- | --- | --- |
| CodeGraph | `/tools/codegraph-main` | TypeScript/Node 语义代码图谱、符号搜索、影响分析、MCP 服务 | 路径检查、manifest 扫描、README 摘要、源码检索、能力卡片 |
| CodeGraphContext | `/tools/codegraphcontext-main` | Python 代码图谱、MCP、Neo4j/FalkorDB/Kuzu 等图数据库后端 | 路径检查、`pyproject.toml` 摘要、README 摘要、源码检索、能力卡片 |
| Understand Anything | `/tools/understand-anything-main` | 代码库理解、架构导览、知识图谱、diff 影响分析 | 路径检查、manifest 扫描、源码检索、受控启动/停止/重启入口 |
| FreeLLMAPI | `/tools/freellmapi-main` | OpenAI 兼容模型网关、provider 聚合、fallback、限流、模型列表 | 路径检查、manifest 扫描、源码检索、模型端点探测、受控启动/停止/重启入口 |
| Karpathy Skills | `/tools/andrej-karpathy-skills-main` | Karpathy 风格 agent 指南、提示词和工作流参考 | 路径检查、README 摘要、源码检索、技能参考入口 |

## 源码检索

每个工具详情页都提供 `Source search` 面板，可以在注册表配置的工具目录中检索源码和文档。

检索范围由后端注册表限定，不允许前端提交任意路径。默认跳过：

```text
.git
node_modules
dist
build
coverage
target
vendor
__pycache__
```

相关实现：

- `server/toolSearch.ts`
- `server/toolSearch.test.ts`
- `server/routers.ts` 中的 `tools.search`
- `client/src/pages/ToolDetail.tsx` 中的源码检索 UI

## 受控动作

Web 端支持 `test`、`start`、`stop`、`restart` 四类动作，但执行命令由服务端白名单控制，不能从前端传任意 shell 命令。

当前白名单：

| 工具 | 命令 |
| --- | --- |
| FreeLLMAPI | `corepack pnpm run dev` |
| Understand Anything | `corepack pnpm dev:dashboard` |

操作记录会写入：

```text
.panel-operations.log
```

## 需要配置的内容

### 1. Node 和 pnpm

本项目和多个集成工具依赖 Node.js 与 pnpm：

```powershell
node --version
corepack pnpm --version
```

如果某个集成工具未安装依赖，需要进入该工具自己的项目目录安装。

### 2. Python 和 uv

CodeGraphContext 相关功能需要 Python 环境，建议同时准备 `uv`：

```powershell
python --version
uv --version
```

### 3. FreeLLMAPI Provider Key

FreeLLMAPI 需要按它自己的 `.env.example` 配置 provider key，例如 Google、Groq、OpenRouter、Cloudflare、Ollama 或自定义 OpenAI-compatible provider。

常见环境变量由 FreeLLMAPI 项目定义，本仓库不会把密钥写入 Git。

### 4. 图数据库

CodeGraphContext 的部分高级能力可能需要 Neo4j、FalkorDB 或 Kuzu。具体配置以 CodeGraphContext 项目自身 README 为准。

### 5. OAuth

生产模式如果需要登录鉴权，需要配置 OAuth 相关环境变量。开发模式下本地控制台默认用于调试展示。

## 内置技能

| Skill | 作用 |
| --- | --- |
| `router` | 总入口，判断下一步应该加载哪个 skill |
| `plan` | 需求澄清、方案设计、边界确认 |
| `code` | 编码、修 bug、测试、构建、发布检查 |
| `memory` | 维护 `spec/`、架构文档、变更记录、当前任务 |
| `retrieval` | 本地/网页检索、证据提取、语料发现 |
| `research` | 外部搜索、事实核查、对比分析 |
| `prompt` | 生成 Cursor、Codex、Claude Code 等工具可用的提示词 |
| `model` | 适配 Doubao、Kimi、DeepSeek、Qwen、智谱、OpenAI、Claude、Gemini、本地模型 |
| `web-analyzer` | URL 分析、正文提取、视频解析和爬虫工具设计 |

## 本地命令

类型检查：

```powershell
corepack pnpm check
```

测试：

```powershell
corepack pnpm test
```

构建：

```powershell
corepack pnpm build
```

模型配置工具：

```powershell
python tools\model-adapter\model_adapter.py list
python tools\model-adapter\model_adapter.py show doubao
python tools\model-adapter\model_adapter.py prompt kimi --tool Cursor --task "coding assistant setup"
```

本地检索工具：

```powershell
python tools\retrieval\retrieval_tool.py capabilities
python tools\retrieval\retrieval_tool.py search "router ->" --root .
```

## 关键文件

| 文件 | 作用 |
| --- | --- |
| `server/toolsRegistry.ts` | 五个外部工具和本项目的注册表 |
| `server/toolStatus.ts` | 路径、端口和日志状态检查 |
| `server/toolDiagnostics.ts` | manifest、README、环境和关键文件诊断 |
| `server/toolActions.ts` | 受控动作白名单和操作记录 |
| `server/toolSearch.ts` | 注册工具源码检索 |
| `server/platformBlueprint.ts` | CodeGraph、工作流、模型路由、任务和配置页面的数据蓝图 |
| `client/src/components/DashboardLayout.tsx` | Web 左侧导航 |
| `client/src/pages/ToolDashboard.tsx` | 工具总览页 |
| `client/src/pages/ToolDetail.tsx` | 工具详情、诊断、操作和源码检索 |
| `docs/integrated-tools.md` | 五个工具的详细集成说明 |

## 文档

| 文档 | 内容 |
| --- | --- |
| [Integrated local tools](docs/integrated-tools.md) | 五个本地工具集成、功能和配置 |
| [Install guide](docs/install.md) | 安装与接入说明 |
| [Model adapter](docs/model-adapter.md) | 模型供应商配置生成器 |
| [Retrieval tool](docs/retrieval-tool.md) | 本地检索工具 |
| [Prompt generation](docs/prompt-generation.md) | 可复用提示词生成 |
| [Compatibility](docs/compatibility.md) | Cursor、Codex、Claude Code 兼容说明 |

## 当前边界

本项目不会把五个外部工具项目复制进仓库，也不会自动安装它们的依赖。当前集成重点是：

- Web 可视化
- 工具目录和端口状态
- manifest/README 诊断
- 受控动作
- 源码检索
- 模型网关探测
- 详细配置文档

## License

MIT. See [LICENSE](LICENSE).