yzt 2.2.0__tar.gz

yzt-2.2.0/CHANGELOG.md

@@ -0,0 +1,92 @@
+# 📝 变更日志 | Changelog
+
+所有重要的项目变更都将记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+项目遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Added - 新增
+- 配置向导 CLI (`yzt --setup`)
+- 错误诊断工具 (`yzt --diagnose`)
+- 多语言支持框架 (`--lang` 选项)
+- 国际化 README (中英双语)
+- 快速入门指南
+- 打包发布指南
+- PyInstaller 打包配置
+
+### Changed - 变更
+- 改进 README 文档结构和内容
+- 增强 CLI 命令选项
+- 优化错误提示信息
+
+### Fixed - 修复
+- API 连接测试逻辑
+- 配置文件加载问题
+
+---
+
+## [1.0.0] - 2024-04-04
+
+### Added - 新增
+- 核心查询引擎
+- 40+ 开发工具集
+  - 文件操作工具 (Read, Write, Edit, Glob, Grep)
+  - Shell 执行工具 (Bash, PowerShell)
+  - Git 管理工具 (Status, Diff, Log, Branch)
+  - Web 操作工具 (Fetch, Search, Scrape, API Test)
+  - 任务管理工具
+- 交互式 CLI 界面
+- Web 界面支持
+- MCP 协议支持
+- 权限控制系统
+- 会话管理
+- 基础文档
+
+### Changed - 变更
+- 支持 OpenRouter API
+- 优化 Anthropic SDK 集成
+
+---
+
+## 版本说明 | Version Notes
+
+### [Unreleased]
+- 专注于降低使用门槛
+- 提升用户体验
+- 完善文档和工具链
+
+### [1.0.0]
+- 初始发布版本
+- 核心功能实现
+- 基础 CLI 和 Web 界面
+
+---
+
+## 提交规范 | Commit Guidelines
+
+我们遵循以下提交规范:
+
+- `feat`: 新功能
+- `fix`: Bug 修复
+- `docs`: 文档更新
+- `style`: 代码格式
+- `refactor`: 重构
+- `test`: 测试
+- `chore`: 构建/工具
+
+示例:
+```
+feat (setup): 添加配置向导功能
+
+- 实现交互式配置向导
+- 支持 5 大 AI 提供商
+- 自动测试 API 连接
+```
+
+---
+
+**目标：GitHub TOP10 ⭐**

yzt-2.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,97 @@
+# 📜 行为准则 | Code of Conduct
+
+## 我们的承诺
+
+为了营造一个开放和友好的环境，我们作为贡献者和领导者承诺，参与我们的社区将为每个人提供无骚扰的体验，无论年龄、体型、可见或不可见的残疾、种族、身体特征、性别认同和表达、经验水平、教育程度、社会经济地位、国籍、个人外貌、种族、种姓、肤色、宗教或性认同和取向如何。
+
+我们承诺以有助于建立开放、友好、多样化、包容和健康社区的方式行事和互动。
+
+---
+
+## 我们的标准
+
+有助于创造积极环境的行为示例包括:
+
+- ✅ 对他人展现出同理心和善意
+- ✅ 尊重不同的意见、观点和经验
+- ✅ 给予并优雅地接受建设性反馈
+- ✅ 为自己的错误承担责任，向受影响的人道歉，并从经验中学习
+- ✅ 关注对社区最有利的事情，而不仅仅是个人利益
+
+不可接受的行为包括:
+
+- ❌ 使用性化的语言或图像，以及任何形式的性关注或挑逗
+- ❌ 恶意挑衅、侮辱或贬低性评论，以及人身或政治攻击
+- ❌ 公开或私下的骚扰行为
+- ❌ 未经许可发布他人私人信息，如实际地址或电子邮件地址
+- ❌ 在专业环境中被合理认为不适当的其他行为
+
+---
+
+## 执行责任
+
+社区领导者有责任澄清和执行我们可接受行为的标准，并将对任何不可接受的行为采取适当和公平的纠正措施。
+
+社区领导者有权也有责任移除、编辑或拒绝不符合本行为准则的评论、提交、代码、维基编辑、问题和其他贡献，并在适当时说明进行管理决定的原因。
+
+---
+
+## 适用范围
+
+本行为准则适用于所有社区空间，也适用于个人在公共空间正式代表社区的情况。代表我们社区的示例包括使用官方电子邮件地址、通过官方社交媒体账户发布内容，或在线上或线下活动中担任指定代表。
+
+---
+
+## 执行
+
+如果发生滥用、骚扰或其他不可接受的行为，可向社区领导者报告，邮箱：contact@yanzhiti.com。所有投诉都将得到迅速和公正的审查和调查。
+
+所有社区领导者都有义务尊重任何事件报告者的隐私和安全。
+
+### 执行指南
+
+社区领导者将遵循以下社区影响指南来确定对任何他们认为违反本行为准则的行为的后果:
+
+#### 1. 纠正
+
+**社区影响**: 使用不适当的语言或其他被认为在社区中不专业或不受欢迎的行为。
+
+**后果**: 社区领导者发出私下书面警告，阐明违规行为的性质，并解释为什么该行为不适当。可能会要求公开道歉。
+
+#### 2. 警告
+
+**社区影响**: 通过单次事件或一系列行为构成的违规。
+
+**后果**: 警告并说明持续此类行为的后果。在指定时间内禁止与相关人员进行互动，包括主动与执行本行为准则的人员进行互动。这包括避免在社区空间以及社交媒体等外部渠道进行互动。违反这些规定可能导致临时或永久禁令。
+
+#### 3. 临时禁令
+
+**社区影响**: 严重违反社区标准，包括持续的不当行为。
+
+**后果**: 在指定时间内禁止与社区进行任何形式的互动或公开交流。在此期间，禁止与执行本行为准则的人员进行任何公开或私下互动。违反这些规定可能导致永久禁令。
+
+#### 4. 永久禁令
+
+**社区影响**: 表现出违反社区标准的行为模式，包括持续的不当行为、骚扰个人或攻击或贬低某类人群。
+
+**后果**: 永久禁止在社区内进行任何形式的公开互动。
+
+---
+
+## 参见
+
+本行为准则改编自 [Contributor Covenant](https://www.contributor-covenant.org), 版本 2.1, 可在 [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html) 获取。
+
+社区影响指南的灵感来自 [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity)。
+
+有关本行为准则的常见问题的解答，请参阅 FAQ: [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq)。翻译版本见：[https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations)。
+
+---
+
+<div align="center">
+
+**衍智体 (YANZHITI)** - 让 AI 助力您的编程之旅
+
+[行为准则](CODE_OF_CONDUCT.md) | [贡献指南](CONTRIBUTING.md) | [变更日志](CHANGELOG.md)
+
+</div>

yzt-2.2.0/CONTRIBUTING.md

@@ -0,0 +1,247 @@
+# 贡献指南 | Contributing to 衍智体 (YANZHITI)
+
+感谢您对衍智体项目的关注！我们欢迎各种形式的贡献。
+
+## 📋 目录 | Contents
+
+- [行为准则](#-行为准则-code-of-conduct)
+- [如何贡献](#-如何贡献-how-to-contribute)
+- [开发环境搭建](#-开发环境-setup)
+- [代码规范](#-代码规范-code-style)
+- [提交规范](#-提交规范-commit-guidelines)
+- [Pull Request 流程](#-pull-request-流程)
+- [测试要求](#-测试要求-testing)
+
+---
+
+## 🤝 行为准则 | Code of Conduct
+
+- **尊重他人** - 保持礼貌和建设性的讨论
+- **包容开放** - 欢迎不同背景的贡献者
+- **专注技术** - 讨论聚焦于代码和功能本身
+- **遵守许可** - 所有贡献遵循项目开源协议
+
+## 🚀 如何贡献 | How to Contribute
+
+### 贡献方式
+
+| 类型 | 说明 |
+|------|------|
+| 🐛 Bug 报告 | 发现问题请提 Issue，尽量提供复现步骤 |
+| 💡 功能建议 | 新功能想法请先提 Issue 讨论 |
+| 🔧 代码贡献 | 修复 Bug 或实现新功能（见下方流程） |
+| 📖 文档改进 | 中英文文档、示例、教程等 |
+| 🌐 国际化 | 多语言翻译支持 |
+
+### 不适合的情况
+
+- 纯粹的 UI 偏好调整
+- 与项目目标不符的功能
+- 未经过讨论的大型重构
+
+---
+
+## 🛠️ 开发环境 | Setup
+
+### 前置要求
+
+```bash
+# Python 版本 | Python version
+Python >= 3.10 (推荐 3.11+)
+
+# 依赖管理 | Dependencies
+pip install -e ".[dev]"
+```
+
+### 克隆和安装
+
+```bash
+# 克隆仓库 | Clone repository
+git clone https://github.com/yanzhiti/yanzhiti.git
+cd yanzhiti
+
+# 创建虚拟环境 | Create virtual environment
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# 或 venv\Scripts\activate  # Windows
+
+# 安装依赖 | Install dependencies
+pip install -e ".[dev]"
+
+# 验证安装 | Verify installation
+yzt --version
+```
+
+### 项目结构概览
+
+```
+yanzhiti/
+├── src/yanzhiti/          # 核心源码
+│   ├── core/              # 核心引擎、供应商系统
+│   │   ├── providers.py   # AI 供应商配置 (17+)
+│   │   ├── unified_engine.py  # 统一 AI 引擎
+│   │   └── builtin_models.py  # 内置模型管理
+│   ├── web/               # Web GUI
+│   │   ├── server.py      # FastAPI 后端
+│   │   └── static/        # 前端静态文件
+│   ├── cli/               # 命令行工具
+│   └── tools/             # 工具集
+├── tests/                 # 测试文件
+├── docs/                  # 文档
+└── pyproject.toml         # 项目配置
+```
+
+---
+
+## ✍️ 代码规范 | Code Style
+
+### Python 规范
+
+```bash
+# 自动格式化 | Auto-format
+ruff format src/ tests/
+
+# Lint 检查 | Lint check
+ruff check src/ tests/
+
+# 类型检查 | Type checking
+mypy src/yanzhiti/
+```
+
+**关键规则**:
+- 遵循 PEP 8
+- 使用 Ruff 格式化器
+- 行宽: 100 字符
+- 所有函数必须有 docstring
+- 注释使用中文 + 英文双语
+
+### JavaScript/CSS 规范
+
+- 使用 2 空格缩进
+- CSS 变量统一在 `:root` 定义
+- 函数命名使用 camelCase
+- 类名使用 kebab-case
+
+---
+
+## 📝 提交规范 | Commit Guidelines
+
+### Commit Message 格式
+
+```
+<类型> (<范围>): <描述>
+
+[可选的正文]
+
+[可选的脚注]
+```
+
+### 类型说明
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `feat` | 新功能 | `feat (providers): 添加 Groq 供应商` |
+| `fix` | Bug 修复 | `fix (server): 修复 WebSocket 断连问题` |
+| `docs` | 文档更新 | `docs (readme): 更新安装指南` |
+| `style` | 代码格式 | `style: 统一 import 排序` |
+| `refactor` | 重构 | `refactor (engine): 简化 failover 逻辑` |
+| `test` | 测试相关 | `test (core): 添加供应商单元测试` |
+| `chore` | 构建/工具 | `chore: 更新 CI 配置` |
+
+---
+
+## 🔀 Pull Request 流程
+
+### PR 步骤
+
+1. **Fork 并克隆**
+   ```bash
+   git clone https://github.com/<your-username>/yanzhiti.git
+   ```
+
+2. **创建特性分支**
+   ```bash
+   git checkout -b feature/你的功能名
+   ```
+
+3. **编写代码并测试**
+   ```bash
+   ruff check src/ --fix
+   ruff format src/
+   pytest tests/ -v
+   ```
+
+4. **提交并推送**
+   ```bash
+   git commit -m "feat (scope): 你的改动"
+   git push origin feature/你的功能名
+   ```
+
+5. **创建 PR** - 在 GitHub 上创建 Pull Request
+
+### PR 模板
+
+```markdown
+## 改动类型
+- [ ] Bug 修复
+- [ ] 新功能
+- [ ] 文档改进
+- [ ] 其他: _____
+
+## 改动描述
+简要描述你的改动内容和原因。
+
+## 测试情况
+- [ ] 已运行 `pytest tests/`
+- [ ] 已通过 `ruff check` 检查
+- [ ] 已通过 `ruff format` 格式化
+
+## 相关 Issue
+Closes #(Issue 编号)
+```
+
+---
+
+## 🧪 测试要求 | Testing
+
+### 运行测试
+
+```bash
+# 全部测试 | All tests
+pytest tests/ -v
+
+# 覆盖率报告 | Coverage report
+pytest tests/ --cov=src/yanzhiti --cov-report=html
+
+# 单个模块 | Single module
+pytest tests/test_core.py -v
+```
+
+### 新功能必须包含测试
+
+- 核心功能: 单元测试覆盖率 > 80%
+- API 端点: 至少包含正常和异常两种场景
+- 工具类: 包含边界条件测试
+
+---
+
+## 💡 建议 | Tips for Contributors
+
+1. **先看 Issue** - 在动手前查看是否有类似的工作在进行
+2. **小步快跑** - 每个 PR 尽量保持专注和精简
+3. **写好文档** - 公开的 API 和复杂逻辑需要注释
+4. **关注性能** - 注意异步操作和资源释放
+5. **多语言友好** - UI 文本考虑国际化
+
+---
+
+## 📞 联系方式 | Contact
+
+- **Issue**: [GitHub Issues](https://github.com/yanzhiti/yanzhiti/issues)
+- **讨论**: [GitHub Discussions](https://github.com/yanzhiti/yanzhiti/discussions)
+
+---
+
+**感谢您为衍智体做出贡献！🎉**
+
+*每个贡献者都会被记录在 [CONTRIBUTORS.md](CONTRIBUTORS.md) 中。*

yzt-2.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yanzhiti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yzt-2.2.0/MANIFEST.in

@@ -0,0 +1,43 @@
+# MANIFEST.in - 衍智体 (YANZHITI) 打包清单
+# 包含 PyPI 发布所需的所有非 Python 文件
+
+# ============================================================
+# 📦 核心源码 | Core Source
+# ============================================================
+include src/yanzhiti/**/*.py
+recursive-include src/yanzhiti/web/static *
+recursive-include examples *.py *.md
+
+# ============================================================
+# 📄 文档文件 | Documentation Files
+# ============================================================
+include README.md
+include README.en.md
+include CHANGELOG.md
+include LICENSE
+include NOTICE.md
+include SECURITY.md
+include CONTRIBUTING.md
+include CODE_OF_CONDUCT.md
+include SUPPORT.md
+
+# ============================================================
+# 🎨 资源文件 | Asset Files
+# ============================================================
+include docs/logo.svg
+recursive-include docs *.md *.svg *.png
+
+# ============================================================
+# ⚙️ 配置文件 | Configuration Files
+# ============================================================
+include pyproject.toml
+include .gitignore
+
+# ============================================================
+# 🚫 排除项 | Exclusions (安全)
+# ============================================================
+exclude .trae/*
+exclude *.env
+exclude *.local
+exclude sessions/*
+exclude marketing/*.mp4

yzt-2.2.0/NOTICE.md

@@ -0,0 +1,52 @@
+# 📢 项目状态 | Project Status
+
+> **⚠️ 项目正在积极开发中**
+
+---
+
+## 🚧 开发中 | Under Development
+
+衍智体 (YANZHITI) 是一个活跃开发中的开源 AI 编程助手项目。
+
+### 当前状态
+
+- ✅ 核心功能已实现
+- ✅ 基础工具链完善  
+- ✅ 文档持续更新
+- 🔄 打包发布优化中
+- 🔄 用户体验改进中
+
+### 欢迎参与
+
+我们欢迎所有感兴趣的开发者:
+
+- 💻 **使用体验** - 提供反馈
+- 🐛 **报告问题** - 帮助改进
+- 💡 **提出建议** - 参与讨论
+- 🔧 **贡献代码** - 直接参与
+- 📖 **改进文档** - 帮助他人
+- 🌍 **翻译支持** - 走向全球
+
+### 快速开始
+
+```bash
+# 安装使用
+pip install yanzhiti
+
+# 或从源码
+git clone https://github.com/yanzhiti/yanzhiti.git
+cd yanzhiti
+pip install -e .
+```
+
+### 获取帮助
+
+- 📖 [使用文档](README.md)
+- 🐛 [报告问题](https://github.com/yanzhiti/yanzhiti/issues)
+- 💬 [社区讨论](https://github.com/yanzhiti/yanzhiti/discussions)
+
+---
+
+**感谢你的关注和支持!** 🙏
+
+**衍智体 (YANZHITI) Team**