# 织语言

**Repository Path**: web_io/weaving-language

## Basic Information

- **Project Name**: 织语言
- **Description**: 织语编程语言项目：在人工智能时代面向普通人的编程语言
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 织语（ZhiYu）— AI 原生中文前端编程框架

> 「织语成网，化言为用」

**🚀 开箱即用！克隆即启动，无需手动构建！**

织语是一款将**中文自然语言**提升为一等公民编程语言的 AI 原生前端框架。让非专业普通人也能读懂、修改和编写应用逻辑。

## ✨ 核心特性

- **🎯 开箱即用**：克隆项目后一条命令即可启动
- **中文双模态表达**：内部运行确定性代码，外部展示结构化中文自然语言
- **CNL2Code / Code2CNL**：中文意图 ↔ 代码双向自动转化
- **本地优先规则引擎**：简单中文指令毫秒级响应，不触发 LLM
- **跨框架即插即用**：自动识别 React/Vue/Svelte 环境，零配置接入
- **LLM 安全沙箱**：生成代码在隔离环境验证后才合并
- **代码即文档**：每个组件自带中文语义描述，项目可读性极高

## 🚀 快速开始

```bash
# 克隆项目
git clone <repository-url>
cd 织语编程语言项目

# 安装依赖（会自动构建核心包）
pnpm install

# 启动开发服务器
pnpm dev
```

浏览器会自动打开 http://localhost:3000，显示官方模板项目。

## 📖 项目结构

```
织语编程语言项目/
├── packages/              # 核心包
│   ├── core/             # 核心运行时
│   ├── parser/           # 语义解析器
│   ├── adapter/          # 跨框架适配
│   ├── llm/              # LLM集成
│   ├── plugin/           # 插件系统
│   ├── sandbox/          # 代码沙箱
│   └── cli/              # CLI工具
├── template/             # 项目模板
│   └── zhiyu-app/       # 官方模板（开箱即用）
├── docs/                 # 文档
├── scripts/              # 构建脚本
└── package.json          # 根配置
```

## 📦 核心包

| 包名 | 说明 |
|------|------|
| `@zhiyu/core` | 核心运行时：响应式系统、语义组件、事件总线 |
| `@zhiyu/parser` | 语义解析器：中文词法分析、AST 构建、本地规则引擎 |
| `@zhiyu/llm` | LLM 集成：Provider 抽象、上下文管理、Prompt 构建 |
| `@zhiyu/adapter` | 跨框架适配：自动探测、React/Vue/Svelte 适配器 |
| `@zhiyu/plugin` | 插件系统：注册/卸载、生命周期 Hook |
| `@zhiyu/sandbox` | 代码沙箱：安全执行、超时控制 |
| `@zhiyu/cli` | CLI 工具：项目初始化、开发、构建 |

## 🎨 语义组件示例

```typescript
import { SemanticComponent, Signal } from '@zhiyu/core'

const 计数器 = new SemanticComponent({
  名称: '计数器',
  描述: '一个简单的计数器，可以点击增加或减少数值',
  
  状态: () => ({
    计数值: new Signal(0)
  }),
  
  行为: {
    增加: (state) => {
      state.计数值.set(state.计数值.get() + 1)
    },
    减少: (state) => {
      state.计数值.set(state.计数值.get() - 1)
    }
  },
  
  渲染: (state, 行为) => {
    // 返回DOM元素
  }
})
```

## 🔧 开发命令

```bash
# 安装依赖（自动构建核心包）
pnpm install

# 启动开发服务器
pnpm dev

# 构建核心包
pnpm build

# 运行测试
pnpm test

# 类型检查
pnpm typecheck

# 代码检查
pnpm lint
```

## 📚 文档

- [架构设计文档](docs/architecture.md) — 完整分层架构、核心概念、LLM 交互流
- [开发说明文档](docs/development.md) — 开发指南、API文档
- [全流程指南](docs/full-workflow-guide.md) — 从环境搭建到部署

## 🤝 贡献

欢迎贡献代码、报告问题或提出建议！

## 📄 License

MIT