docmk 1.0.0

package/.claude/skills/pdf/SKILL.md

@@ -0,0 +1,89 @@
+---
+title: PDF Processing
+description: Comprehensive guide to working with PDF files including extraction, manipulation, and generation
+tags: ["pdf", "documents", "data-extraction"]
+---
+
+# PDF Processing
+
+This skill covers various aspects of working with PDF documents programmatically.
+
+## Overview
+
+PDF (Portable Document Format) is a widely used file format for documents. This skill includes:
+
+- Text extraction from PDFs
+- PDF generation and manipulation  
+- Form handling
+- Metadata processing
+- Document conversion
+
+## Key Libraries and Tools
+
+### Python
+- **PyPDF2/PyPDF4** - Basic PDF operations
+- **pdfplumber** - Text extraction with layout preservation
+- **ReportLab** - PDF generation
+- **pdftk** - Command-line PDF toolkit
+
+### JavaScript/Node.js
+- **pdf-lib** - Create and modify PDF documents
+- **pdf-parse** - Simple PDF parsing
+- **puppeteer** - Generate PDFs from web content
+
+## Common Use Cases
+
+### Text Extraction
+Extract text content from PDF files while preserving formatting and structure.
+
+### Document Generation
+Create PDFs programmatically from data, templates, or web content.
+
+### Form Processing
+Handle PDF forms, extract form data, and fill forms programmatically.
+
+## Best Practices
+
+1. **Memory Management** - Large PDFs can consume significant memory
+2. **Error Handling** - PDFs can be corrupted or password-protected
+3. **Performance** - Consider streaming for large documents
+4. **Security** - Be cautious with user-uploaded PDFs
+
+## Examples
+
+### Basic Text Extraction (Python)
+```python
+import PyPDF2
+
+with open('document.pdf', 'rb') as file:
+    reader = PyPDF2.PdfReader(file)
+    text = ""
+    for page in reader.pages:
+        text += page.extract_text()
+    print(text)
+```
+
+### PDF Generation (JavaScript)
+```javascript
+import { PDFDocument, rgb } from 'pdf-lib'
+import fs from 'fs'
+
+const pdfDoc = await PDFDocument.create()
+const page = pdfDoc.addPage()
+
+page.drawText('Hello, PDF!', {
+  x: 50,
+  y: 750,
+  size: 30,
+  color: rgb(0, 0, 0),
+})
+
+const pdfBytes = await pdfDoc.save()
+fs.writeFileSync('output.pdf', pdfBytes)
+```
+
+## Troubleshooting
+
+- **Encoding Issues** - Some PDFs may have encoding problems
+- **Layout Preservation** - Complex layouts may not extract cleanly
+- **Performance** - Large PDFs may require optimization

package/.claude/skills/web-scraping/SKILL.md

@@ -0,0 +1,78 @@
+---
+title: Web Scraping
+description: Techniques and tools for extracting data from websites
+tags: ["scraping", "data-extraction", "automation"]
+---
+
+# Web Scraping
+
+Web scraping is the process of extracting data from websites programmatically.
+
+## Overview
+
+Web scraping involves:
+
+- Fetching web pages
+- Parsing HTML content
+- Extracting specific data
+- Handling dynamic content
+- Managing rate limits and ethics
+
+## Tools and Libraries
+
+### Python
+- **BeautifulSoup** - HTML parsing
+- **Scrapy** - Full-featured scraping framework
+- **Selenium** - Browser automation
+- **requests** - HTTP library
+
+### JavaScript/Node.js
+- **Puppeteer** - Chrome automation
+- **Playwright** - Multi-browser automation
+- **Cheerio** - Server-side jQuery
+- **axios** - HTTP client
+
+## Key Concepts
+
+### Respect robots.txt
+Always check the robots.txt file of websites before scraping.
+
+### Rate Limiting
+Implement delays between requests to avoid overwhelming servers.
+
+### User Agents
+Rotate user agents to appear more like regular browsers.
+
+## Examples
+
+### Basic Scraping (Python)
+```python
+import requests
+from bs4 import BeautifulSoup
+
+response = requests.get('https://example.com')
+soup = BeautifulSoup(response.content, 'html.parser')
+
+titles = soup.find_all('h2', class_='title')
+for title in titles:
+    print(title.text)
+```
+
+### Dynamic Content (JavaScript)
+```javascript
+const puppeteer = require('puppeteer');
+
+(async () => {
+  const browser = await puppeteer.launch();
+  const page = await browser.newPage();
+  
+  await page.goto('https://example.com');
+  await page.waitForSelector('.dynamic-content');
+  
+  const content = await page.$eval('.dynamic-content', 
+    el => el.textContent);
+  
+  console.log(content);
+  await browser.close();
+})();
+```

package/CLAUDE.md

@@ -0,0 +1,90 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 项目概述
+
+DocGen 是一个文档生成 CLI 工具，用于扫描任意目录并自动生成静态文档网站。支持 Markdown 渲染、全文搜索、代码高亮等功能。
+
+## 常用命令
+
+```bash
+# 安装依赖
+npm install
+
+# 构建 CLI（输出到 dist/）
+npm run build
+
+# 类型检查
+npm run typecheck
+
+# 代码检查
+npm run lint
+
+# 开发模式运行 CLI（使用 tsx 直接执行）
+npm run dev
+
+# 使用 CLI 启动文档开发服务器
+node dist/index.js dev --dir ./my-docs --port 3000
+
+# 构建静态站点
+node dist/index.js build --dir ./my-docs --output ./dist
+
+# 预览构建结果
+node dist/index.js preview --output ./dist --port 4173
+```
+
+## 架构
+
+```
+src/
+├── cli/              # CLI 入口和命令实现
+│   ├── index.ts      # 主入口，使用 Commander.js 定义命令
+│   └── commands/     # dev/build/preview 命令
+├── scanner/          # 目录扫描器，递归扫描 .md 文件
+├── parser/           # Markdown 解析，使用 gray-matter + markdown-it + shiki
+├── builder/          # Vite 构建逻辑
+│   ├── index.ts      # 生产构建，生成 sitemap/robots.txt
+│   └── vite-dev.ts   # 开发服务器，支持文件监听热更新
+├── client/           # Vue 3 前端 SPA
+│   ├── pages/        # Home（首页统计）和 SkillPage（文档渲染）
+│   ├── components/   # Sidebar、SearchBox 等
+│   └── router.ts     # 路由配置，catch-all 匹配文档路径
+└── types/            # TypeScript 类型定义
+```
+
+## 核心数据流
+
+1. **Scanner** (`src/scanner/index.ts`): 扫描源目录，递归收集 `.md` 文件，构建 `SkillDirectory[]` 树结构
+2. **Parser** (`src/parser/index.ts`): 解析 frontmatter、渲染 Markdown 为 HTML、提取 TOC、应用 shiki 代码高亮
+3. **Builder**:
+   - 开发模式：通过 `/api/config` 端点注入配置，使用 chokidar 监听文件变化触发热更新
+   - 生产模式：将配置 base64 编码注入 HTML `<head>`，生成 sitemap.xml 和 robots.txt
+4. **Client**: Vue 3 SPA 从 `globalThis.__DOCGEN_CONFIG__` 或 `/api/config` 获取配置，渲染文档
+
+## 关键类型
+
+- `SkillDirectory`: 目录节点，包含 `children` 和可选的 `skillFile`（SKILL.md）
+- `SkillFile`: 文件节点，包含 `content`、`frontmatter`、`lastModified`
+- `DocGenConfig`: 完整站点配置，包含 `navigation`、`files`、`directories`
+
+## 技术栈
+
+- **CLI**: Commander.js + tsup 打包
+- **前端**: Vue 3 + Vue Router + Vite + Tailwind CSS
+- **解析**: gray-matter（frontmatter）+ markdown-it（渲染）+ shiki（代码高亮）
+- **监听**: chokidar
+
+## 文档目录结构约定
+
+```
+docs/
+├── category/
+│   ├── SKILL.md      # 主文档（可选，作为该目录的入口）
+│   ├── advanced.md   # 其他文档
+│   └── sub-category/ # 子目录
+└── another/
+    └── SKILL.md
+```
+
+路由规则：`SKILL.md` 文件映射到目录路径（如 `/api/SKILL.md` → `/api`），其他 `.md` 文件保留文件名（如 `/api/advanced.md` → `/api/advanced`）。

package/bin/docmk.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/index.js').catch(console.error)

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node