first commit

This commit is contained in:
zyl
2026-03-06 03:36:12 +08:00
commit 4e32b3193f
64 changed files with 42394 additions and 0 deletions

View File

@@ -0,0 +1,261 @@
#!/bin/bash
# sgClaw 文档一键导出 PDF 脚本
# 使用方法chmod +x export-all-pdf.sh && ./export-all-pdf.sh
echo "============================================================"
echo "📄 sgClaw 文档一键导出 PDF"
echo "============================================================"
echo ""
# 创建输出目录
mkdir -p pdfs
echo "✅ 创建输出目录: pdfs/"
echo ""
# 定义需要导出的文档
declare -A docs=(
["协作时间表.html"]="协作时间表_interactive.pdf"
["协作时间表_printable.md"]="协作时间表.pdf"
["协作甘特图_printable.md"]="协作甘特图.pdf"
["团队分工.md"]="团队分工.pdf"
)
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📋 导出清单"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
# 列出所有文件
for src in "${!docs[@]}"; do
if [ -f "$src" ]; then
size=$(du -h "$src" | cut -f1)
dst="${docs[$src]}"
echo " 📄 $src ($size) → pdfs/$dst"
fi
done
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "🚀 选择导出方式"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "1) 自动导出(使用 wkhtmltopdf需要安装"
echo "2) 浏览器手动打印(推荐,最美观)"
echo "3) 在线工具(最简单)"
echo "4) VS Code 插件(最专业)"
echo ""
read -p "请选择 (1-4): " choice
case $choice in
1)
# 检查 wkhtmltopdf 是否安装
if ! command -v wkhtmltopdf &> /dev/null; then
echo ""
echo "⚠️ 未安装 wkhtmltopdf正在尝试安装..."
echo ""
if command -v apt-get &> /dev/null; then
sudo apt-get update && sudo apt-get install -y wkhtmltopdf
elif command -v yum &> /dev/null; then
sudo yum install -y wkhtmltopdf
else
echo "❌ 无法自动安装,请手动安装 wkhtmltopdf"
echo " 访问: https://wkhtmltopdf.org/downloads.html"
exit 1
fi
fi
echo ""
echo "开始自动导出..."
echo ""
# 导出 HTML 文件
if [ -f "协作时间表.html" ]; then
echo "📄 处理: 协作时间表.html"
wkhtmltopdf --enable-local-file-access \
--orientation Landscape \
--page-size A4 \
协作时间表.html \
pdfs/协作时间表_interactive.pdf 2>/dev/null
if [ $? -eq 0 ]; then
echo " ✅ 成功: pdfs/协作时间表_interactive.pdf"
else
echo " ❌ 失败"
fi
fi
# 导出 Markdown 文件(先转 HTML
for md_file in 协作时间表_printable.md 协作甘特图_printable.md 团队分工.md; do
if [ -f "$md_file" ]; then
echo ""
echo "📄 处理: $md_file"
# 创建临时 HTML
temp_html="/tmp/${md_file%.md}.html"
cat > "$temp_html" << 'HTML_HEAD'
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<style>
body {
font-family: "PingFang SC", "Microsoft YaHei", sans-serif;
max-width: 900px;
margin: 40px auto;
padding: 20px;
line-height: 1.8;
}
h1 { color: #1e40af; border-bottom: 3px solid #3b82f6; padding-bottom: 10px; }
h2 { color: #2563eb; margin-top: 30px; }
table { width: 100%; border-collapse: collapse; margin: 20px 0; }
th, td { border: 1px solid #ddd; padding: 10px; }
th { background: #3b82f6; color: white; }
img { max-width: 100%; height: auto; }
code { background: #f1f5f9; padding: 2px 6px; border-radius: 3px; }
pre { background: #1e293b; color: #f1f5f9; padding: 15px; border-radius: 6px; }
</style>
</head>
<body>
HTML_HEAD
# 简单的 Markdown to HTML保留图片链接
sed 's/^# \(.*\)/<h1>\1<\/h1>/g; s/^## \(.*\)/<h2>\1<\/h2>/g; s/^### \(.*\)/<h3>\1<\/h3>/g' "$md_file" >> "$temp_html"
echo '</body></html>' >> "$temp_html"
# 转 PDF
pdf_file="pdfs/${md_file%.md}.pdf"
pdf_file="${pdf_file/_printable/}"
wkhtmltopdf --enable-local-file-access \
--orientation Portrait \
--page-size A4 \
"$temp_html" \
"$pdf_file" 2>/dev/null
if [ $? -eq 0 ]; then
echo " ✅ 成功: $pdf_file"
else
echo " ❌ 失败"
fi
rm -f "$temp_html"
fi
done
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "✅ 导出完成!"
;;
2)
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "🌐 浏览器手动打印步骤"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "正在打开文件..."
firefox 协作时间表.html 2>/dev/null &
sleep 1
firefox 协作时间表_printable.md 2>/dev/null &
sleep 1
firefox 团队分工.md 2>/dev/null &
echo ""
echo "✅ 已在浏览器中打开文档"
echo ""
echo "对每个文件:"
echo " 1. 按 Ctrl+P或 Cmd+P"
echo " 2. 目标打印机:选择「另存为 PDF」"
echo " 3. 方向:选择「横向」(甘特图)或「纵向」(其他)"
echo " 4. 保存到 pdfs/ 目录"
echo " 5. 点击「保存」"
;;
3)
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "🌍 在线工具"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "推荐工具:"
echo ""
echo " 📄 Markdown to PDF:"
echo " https://markdown2pdf.com"
echo " https://www.markdowntopdf.com"
echo ""
echo " 🎨 HTML to PDF:"
echo " https://www.sejda.com/html-to-pdf"
echo " https://html2pdf.com"
echo ""
echo "使用步骤:"
echo " 1. 访问上述网站"
echo " 2. 上传文件(见下方文件列表)"
echo " 3. 下载生成的 PDF"
echo " 4. 保存到 pdfs/ 目录"
echo ""
echo "文件列表:"
echo " • 协作时间表.html"
echo " • 协作时间表_printable.md"
echo " • 协作甘特图_printable.md"
echo " • 团队分工.md"
echo ""
echo "文件位置: $(pwd)/"
# 打开文件管理器
xdg-open . 2>/dev/null &
;;
4)
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📝 VS Code 插件方法"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "步骤:"
echo " 1. 打开 VS Code"
echo " 2. 安装插件Markdown PDF"
echo " (Ctrl+Shift+X 搜索 \"Markdown PDF\")"
echo ""
echo " 3. 打开 Markdown 文件:"
echo " code 协作时间表_printable.md"
echo " code 协作甘特图_printable.md"
echo " code 团队分工.md"
echo ""
echo " 4. 右键 → \"Markdown PDF: Export (pdf)\""
echo ""
echo " 5. PDF 会自动保存到同目录"
echo ""
# 提供快捷命令
echo "快捷命令:"
echo " code 协作时间表_printable.md &"
;;
*)
echo ""
echo "❌ 无效选择"
exit 1
;;
esac
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📊 输出目录"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "PDF 文件将保存到:"
echo " $(pwd)/pdfs/"
echo ""
# 列出已生成的 PDF
if ls pdfs/*.pdf 1> /dev/null 2>&1; then
echo "已生成的 PDF 文件:"
ls -lh pdfs/*.pdf | awk '{printf " • %s (%s)\n", $9, $5}'
else
echo "(尚无 PDF 文件)"
fi
echo ""
echo "============================================================"
echo "完成!🎉"
echo "============================================================"

View File

@@ -0,0 +1,116 @@
#!/bin/bash
# sgClaw 文档 PDF 导出脚本
# 使用方法chmod +x export-pdf.sh && ./export-pdf.sh
echo "============================================================"
echo "📄 sgClaw 文档 PDF 导出工具"
echo "============================================================"
echo ""
echo "本脚本将帮助你导出所有文档为 PDF"
echo ""
# 创建输出目录
mkdir -p pdfs
echo "✅ 创建输出目录: pdfs/"
echo ""
# 方法说明
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📖 导出方法(推荐)"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "方法 1浏览器打印推荐最美观✅"
echo " 1. 在浏览器中打开文件(见下方文件列表)"
echo " 2. 按 Ctrl+P或 Cmd+P"
echo " 3. 选择\"另存为 PDF\""
echo " 4. 保存到 pdfs/ 目录"
echo ""
echo "方法 2在线工具最简单✅"
echo " 对于 Markdown 文件:"
echo " - 访问 https://markdown2pdf.com"
echo " - 或 https://www.markdowntopdf.com"
echo " - 上传 .md 文件,下载 PDF"
echo ""
echo "方法 3VS Code最专业✅"
echo " 1. 安装插件: \"Markdown PDF\""
echo " 2. 打开 .md 文件"
echo " 3. 右键 -> \"Markdown PDF: Export (pdf)\""
echo ""
# 文件列表
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📁 需要导出的文档"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
files=(
"协作时间表.html"
"团队分工.md"
"协作时间表.md"
"协作甘特图.md"
)
for file in "${files[@]}"; do
if [ -f "$file" ]; then
size=$(du -h "$file" | cut -f1)
echo " 📄 $file ($size)"
echo " file://$(pwd)/$file"
echo ""
fi
done
# SVG 文件特殊说明
if [ -f "协作甘特图.svg" ]; then
echo " 🎨 协作甘特图.svg"
echo " 可以用浏览器打开后打印,或直接插入 PPT"
echo " file://$(pwd)/协作甘特图.svg"
echo ""
fi
# 快捷命令
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "🚀 快捷命令"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "# 在 Firefox 中打开所有文件"
echo "firefox 协作时间表.html &"
echo "firefox 协作甘特图.svg &"
echo ""
echo "# 在 Chrome 中打开"
echo "google-chrome 协作时间表.html &"
echo ""
echo "# 在文件管理器中打开当前目录"
echo "xdg-open . &"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "💡 提示"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "• HTML 文件包含交互式甘特图,建议保持 HTML 格式或打印为 PDF"
echo "• Markdown 文件可以用 GitHub/GitLab 在线查看(自动渲染)"
echo "• SVG 文件可以直接拖入 PowerPoint/Keynote"
echo "• 打印时建议选择\"横向\"方向,页面更宽"
echo ""
# 提供一个自动打开的选项
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
read -p "是否在浏览器中打开主要文档?(y/n): " choice
if [ "$choice" = "y" ] || [ "$choice" = "Y" ]; then
echo ""
echo "正在打开浏览器..."
firefox 协作时间表.html 2>/dev/null &
sleep 1
firefox 协作甘特图.svg 2>/dev/null &
echo "✅ 已打开!按 Ctrl+P 可以打印为 PDF"
else
echo ""
echo "👋 你可以随时手动打开文件进行打印"
fi
echo ""
echo "============================================================"
echo "完成!祝你汇报顺利!🎉"
echo "============================================================"

View File

@@ -0,0 +1,114 @@
# sgClaw 团队协作架构图
## 📄 文档说明
这是一个**独立的可视化架构图文档**,用于向领导清晰展示 sgClaw 项目的团队分工、协作关系和技术架构。
## 🎯 包含的图表
1. **团队协作总架构5 人分工全景)**
- 每个人干什么?
- 为什么要这样干?
- 产出物是什么?
2. **人员接口对接关系图**
- P1a ↔ P2关键路径对接极高优先级
- P1a ↔ P1bRuntime 集成对接
- P1b ↔ P3Skill 加载对接
- P2 ↔ P4UI 交互对接
3. **数据流全链路**
- 从用户输入到浏览器执行的完整流程
- 8 步数据流转详解
4. **关键路径时间轴**
- 为什么 Day 4-5 是瓶颈?
- 风险预案是什么?
5. **技术栈分层**
- 每层对应哪些人员?
- 每层负责什么模块?
6. **为什么这样分工?**
- 设计依据和决策背景
- 常见问题解答
## 🚀 如何查看
### 方法 1本地浏览器直接打开推荐
```bash
# 在文件管理器中双击打开
团队协作架构图.html
```
### 方法 2局域网查看适合开会演示
```bash
cd /home/zyl/projects/sgClaw/docs
./查看架构图.sh
```
然后在浏览器中访问显示的 URL例如
- 本机:`http://localhost:8888/团队协作架构图.html`
- 局域网:`http://192.168.x.x:8888/团队协作架构图.html`
### 方法 3导出为 PDF
在浏览器中打开后:
1. 点击右下角的「📄 打印 PDF」按钮
2. 或按 `Ctrl+P`Windows/Linux/ `Cmd+P`macOS
3. 选择「另存为 PDF」
4. 保存
## 💡 使用建议
### 给领导汇报时
1. **先看"团队协作总架构"**(第一图)
- 一目了然看到 5 个人各自负责什么
- 理解为什么要这样分工
2. **重点讲"关键路径"**(第四图)
- 强调 Day 4-5 的 P1a + P2 联调是整个项目的瓶颈
- 说明有风险预案
3. **数据流全链路**(第三图)
- 演示一个完整的业务场景
- 让领导理解 5 个人的工作如何串联起来
### 给技术人员讲解时
1. **技术栈分层**(第五图)
- 清晰展示模块划分
- 说明依赖关系(从下往上)
2. **接口对接关系**(第二图)
- 详细展示每对人员之间的接口协议
- 包含代码示例
## 📋 文件清单
```
/home/zyl/projects/sgClaw/docs/
├── 团队协作架构图.html # 主文档(独立 HTML无外部依赖
├── 查看架构图.sh # 启动脚本(局域网查看)
└── 架构图使用说明.md # 本文档
```
## 🎨 特性
-**零依赖**:单文件 HTML不需要网络不需要额外资源
-**深色主题**:适合投影演示,保护眼睛
-**响应式设计**:自适应不同屏幕尺寸
-**打印友好**:可直接打印或导出 PDF
-**可视化清晰**颜色编码P1a 红色、P2 蓝色、P3 绿色等)
## 🔄 更新记录
- **v1.0** (2026-03-04):初版发布,包含 6 张核心架构图
---
**维护者**:项目经理
**最后更新**2026-03-04

View File

@@ -0,0 +1,44 @@
#!/bin/bash
# sgClaw 团队协作架构图查看脚本
# 使用方法chmod +x 查看架构图.sh && ./查看架构图.sh
echo "============================================================"
echo "📊 sgClaw 团队协作架构图"
echo "============================================================"
echo ""
# 获取本机 IP
IP=$(hostname -I | awk '{print $1}')
if [ -z "$IP" ]; then
IP="localhost"
fi
PORT=8888
echo "正在启动 HTTP 服务器..."
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📱 在浏览器中访问:"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo " 本机访问:"
echo " http://localhost:$PORT/团队协作架构图.html"
echo ""
echo " 局域网其他设备访问:"
echo " http://$IP:$PORT/团队协作架构图.html"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "💡 提示:"
echo " • 按 Ctrl+C 停止服务器"
echo " • 可以直接打印为 PDF点击右下角「打印 PDF」按钮"
echo " • 或在浏览器中按 Ctrl+P 打印"
echo ""
echo "============================================================"
echo ""
# 启动 HTTP 服务器
cd "$(dirname "$0")"
python3 -m http.server $PORT --bind 0.0.0.0

View File

@@ -0,0 +1,52 @@
#!/bin/bash
# sgClaw 系统架构总图查看脚本
echo "============================================================"
echo "🏗️ sgClaw 系统架构图"
echo "============================================================"
echo ""
# 获取本机 IP
IP=$(hostname -I | awk '{print $1}')
if [ -z "$IP" ]; then
IP="localhost"
fi
PORT=8889
echo "正在启动 HTTP 服务器..."
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📱 在浏览器中访问:"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo " 【推荐】Mermaid 流程图版本:"
echo " http://localhost:$PORT/系统架构图_Mermaid.html"
echo ""
echo " 方框布局版本:"
echo " http://localhost:$PORT/系统架构总图.html"
echo ""
echo " 局域网访问:"
echo " http://$IP:$PORT/系统架构图_Mermaid.html"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "💡 Mermaid 版本特点:"
echo " ✓ 专业流程图风格(不是方框布局)"
echo " ✓ 带箭头和连接线,展示数据流向"
echo " ✓ 包含 3 张图:"
echo " - 系统架构总览(所有组件关系)"
echo " - 端到端数据流10 步完整流程)"
echo " - 人员协作依赖5 人对接关系)"
echo " ✓ 颜色区分负责人(红=P1a橙=P1b绿=P2蓝=P3紫=P4"
echo " ✓ 关键路径用粗线标注"
echo ""
echo "按 Ctrl+C 停止服务器"
echo ""
echo "============================================================"
echo ""
cd "$(dirname "$0")"
python3 -m http.server $PORT --bind 0.0.0.0