# hk416 **Repository Path**: eilusa/hk416 ## Basic Information - **Project Name**: hk416 - **Description**: apple 风格的agent - **Primary Language**: TypeScript - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-26 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Griffin A modular AI Agent desktop application based on Electron. ## Product Introduction Griffin is an AI Agent desktop application adopting an Electron-based modular monolith architecture, aimed at providing users with a secure and controllable local Agent experience. ### Core Features - **Native Desktop Experience**: Built on Electron, providing cross-platform (Windows/macOS) desktop applications - **Secure Isolation Architecture**: Employs workspace isolation and controlled command approval mechanisms - **Local Data Storage**: Utilizes SQLite + Drizzle ORM for local data management - **Single Agent Lifecycle**: Supports single-agent task processing with resumable execution ## Project Structure ``` hk416/ ├── apps/ │ └── desktop/ # Electron Desktop Application │ ├── src/ │ │ ├── main/ # Main Process Code │ │ ├── preload/ # Preload Scripts │ │ └── renderer/ # Renderer Process (React) │ └── vite.config.ts # Vite Config ├── packages/ # Core Packages │ ├── agent-core/ # Agent Core Logic │ ├── database/ # Database Layer (SQLite + Drizzle) │ ├── policy/ # Policy & Security Modules │ ├── shared/ # Shared Utilities │ └── tool-runtime/ # Tool Runtime ├── docs/ # Architecture Decision Records (ADR) & Docs └── package.json # Workspace Root Config ``` ## Tech Stack - **Framework**: Electron + React - **Build Tool**: Vite - **Database**: SQLite + Drizzle ORM - **Package Manager**: pnpm (monorepo) - **Language**: TypeScript ## Quick Start ### Environment Requirements - Node.js 18+ - pnpm 8+ ### Install Dependencies ```bash # Install all dependencies pnpm install ``` ### Development Mode ```bash # Start desktop application development server pnpm desktop:dev ``` ### Build Release ```bash # Build desktop application pnpm desktop:build ``` ## Documentation The unified documentation entry is [Griffin Documentation Center](/docs/README.md). Architecture Decision Records are located under `docs/02-架构与决策/ADR/`: - [ADR-0001: Electron Modular Monolith](/docs/02-架构与决策/ADR/0001-Electron模块化单体.md) - [ADR-0002: Local SQLite and Drizzle](/docs/02-架构与决策/ADR/0002-本地SQLite与Drizzle.md) - [ADR-0003: Provider and Credential Security](/docs/02-架构与决策/ADR/0003-Provider与凭据安全.md) - [ADR-0004: Workspace and Command Security](/docs/02-架构与决策/ADR/0004-工作区与命令安全.md) - [ADR-0005: Single-Agent Lifecycle](/docs/02-架构与决策/ADR/0005-单Agent生命周期.md) More documentation: - [Current Product Requirements](/docs/01-产品与路线/01-Griffin完整产品与开发需求.md) - [Development Roadmap](/docs/01-产品与路线/02-Griffin后续开发计划.md) - [Architecture Overview](/docs/02-架构与决策/01-总体架构.md) - [Platform Strategy](/docs/02-架构与决策/02-跨平台策略.md) ## Security Features Griffin prioritizes security as a core consideration: 1. **Credential Security Management**: Separation of internal provider interfaces and system security credentials 2. **Workspace Isolation**: Each task runs in an independent workspace environment 3. **Command Approval Mechanism**: Sensitive operations require user approval and confirmation ## License This project adheres to the license terms contained in its LICENSE file.