# mykb

**Repository Path**: XimoKB/mykb

## Basic Information

- **Project Name**: mykb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# md2doc — 知识库文档工程

将 Markdown 知识库素材转化为专业文档（DOCX / PPTX）的 **Agent-Skill 架构**工具集。

## 架构概览

```
用户意图  →  main.py (Agent 调度器)  →  skills/<skill_name>/run(config)
                  ↕
             core/ (公共组件)
```

## 使用方式

```bash
# 列出所有可用技能
uv run python main.py list

# PPT 生成（Apple 深色风格）
uv run python main.py ppt_gen --input llm/report/ppt_content_v2.md --output output.pptx --style apple_dark

# DOCX 生成
uv run python main.py docx_gen --input llm/report/report.md --output report.docx

# PPT 后处理
uv run python main.py ppt_postprocess --input llm/pptx/output.pptx --steps style,layout

# 内容修复
uv run python main.py content_fix --input llm/report/ppt_content_v2.md

# 图表生成
uv run python main.py diagram_gen --output-dir llm/img_report --figures 1,2,3
```

## 目录结构

```
md2doc/
├── main.py                    Agent 调度入口
├── core/                      公共组件
│   ├── pptx_utils.py          PPT 共用函数
│   └── docx_utils.py          DOCX 共用函数
├── skills/                    技能模块
│   ├── ppt_gen/               PPT 生成（apple_dark / card_light）
│   ├── docx_gen/              DOCX 生成（GB/T 9704 规范）
│   ├── diagram_gen/           架构图生成（matplotlib）
│   ├── ppt_postprocess/       PPT 后处理（style / layout / content）
│   └── content_fix/           内容修复（encoding / corrections）
├── configs/                   通用文档格式配置
├── llm/                       LLM 知识库
├── quant/                     量化知识库
├── pyproject.toml             项目配置
└── uv.lock                    依赖锁定
```

## 技能清单

| 技能 | 说明 |
|------|------|
| `ppt_gen` | Markdown → PPT，支持 Apple 深色 / 卡片浅色两种风格 |
| `docx_gen` | Markdown → DOCX，符合 GB/T 9704 + NSFC + 科研院所规范 |
| `diagram_gen` | matplotlib 架构图 / 流程图 / 金字塔图（8 张 PNG） |
| `ppt_postprocess` | PPT 颜色替换、章节编号、布局调整、图片插入 |
| `content_fix` | UTF-8 编码修复 + 乱码文本批量替换 |