技术规格书生成器（Technical Specification Generator）

一个基于 Tkinter 的桌面 GUI 应用，通过调用阿里云 DashScope 智能体 API 自动生成结构化的技术规格书，并支持一键导出为 .docx 格式文档。

---

✨ 功能亮点

• 🧠 AI 驱动内容生成：利用 DashScope 智能体根据用户输入自动生成专业、结构清晰的技术规格书。
• 📄 智能格式解析：自动识别 Markdown 风格文本（如标题、列表、表格等），并转换为格式规范的 Word 文档。
• 🖥️ 本地化桌面应用：无需联网浏览器，纯 Python 实现，界面简洁易用。
• ⚙️ 双模式支持：
  • 单章模式：适用于小型项目或单一模块说明。
  • 多章模式：适用于复杂系统，生成含多章节的完整技术文档。
• 💾 一键导出：结果可直接保存为 .docx 文件，兼容 Microsoft Word 及主流办公软件。

---

🛠️ 技术栈

组件	说明
前端	tkinter + ttk（原生 Python GUI）
后端逻辑	Python 标准库 + 多线程
AI 接入	DashScope Application API
文档生成	python-docx（支持中文字体与样式控制）
依赖管理	手动安装（见下文）

---

📦 安装与运行

1. 克隆仓库

git clone https://github.com/your-username/technical-spec-generator.git
cd technical-spec-generator

2. 安装依赖

pip install dashscope python-docx

注意：tkinter 是 Python 标准库的一部分，通常已内置。若缺失，请安装对应平台的 Python GUI 支持包（如 Ubuntu 上的 python3-tk）。

3. 配置环境变量

在运行前，请设置以下两个环境变量：

export DASHSCOPE_API_KEY="your_dashscope_api_key"
export DASHSCOPE_APP_ID="your_dashscope_app_id"

🔐 安全提示：请勿将 API Key 硬编码在代码中！本项目已通过 os.getenv() 读取，确保密钥安全。

4. 启动应用

python main.py

---

🖼️ 界面预览

表单字段包括：

• 项目名称
• 材料/系统类别
• 使用环境
• 性能要求
• 补充要求
• 模式选择（单章 / 多章）

点击“提交”后，AI 生成内容将显示在右侧区域，并可导出为 Word。

---

📝 输出格式支持

程序能正确解析以下 Markdown 风格语法并转换为 Word 样式：

源文本格式	Word 输出效果
## 封面标题	居中、加粗、16pt
# 一级标题	黑色、14pt、一级标题样式
## 1. 二级标题	加粗、12pt、二级标题
- 项目：说明	带项目符号，冒号前加粗
| A | B |	带边框表格
目录项……1	自动去除省略号及页码

---

📜 许可证

本项目采用 MIT 许可证 —— 自由使用、修改、分发。

---

👨‍💻 作者

• KTQ
• 创建日期：2026-03-07

---

💡 提示：本工具适用于工程师、技术文档撰写者、科研人员等需要快速生成标准化技术文档的场景。结合 DashScope 强大的语言模型能力，显著提升文档编写效率。