docs: map existing codebase

2026-03-13 14:55:43 +08:00
parent 1d7957aab4
commit a8669ec0a3
5 changed files with 790 additions and 0 deletions
@@ -0,0 +1,108 @@
+# Technology Stack
+
+**Analysis Date:** 2026-03-13
+
+## Languages
+
+**Primary:**
+- Python 3.12 - 主要用于 kb-* 技能模块（内容采集、语音识别、AI分析等）
+- JavaScript/Node.js >=16.7.0 - 用于 gsd (Get-Shit-Done) 元提示系统
+
+**Secondary:**
+- Shell/Bash - 用于部署脚本和工具链（ffmpeg, yt-dlp）
+
+## Runtime
+
+**Environment:**
+- Python 3.12.3
+- Node.js v22.22.0
+
+**Package Manager:**
+- pip/uv (Python) - gsd-openclaw 使用 uv.lock
+- npm (Node.js) - gsd 使用 npm
+
+**Lockfile:**
+- `uv.lock` (gsd-openclaw)
+- `package-lock.json` (gsd)
+
+## Frameworks
+
+**Core:**
+- 无传统 Web 框架 - 这是一个 CLI 技能集合，非 Web 应用
+
+**Testing:**
+- pytest >=7.0.0 - Python 单元测试 (gsd-openclaw)
+- Node.js 内置测试 - gsd 使用自定义 `scripts/run-tests.cjs`
+
+**Build/Dev:**
+- esbuild ^0.24.0 - gsd hooks 构建
+- c8 ^11.0.0 - 测试覆盖率工具
+
+## Key Dependencies
+
+**Python 核心依赖:**
+- `requests` - HTTP 客户端，用于 AI API 调用
+- `httpx` - 异步 HTTP 客户端（Bilibili 元数据提取）
+- `playwright` / `undetected_playwright` - 浏览器自动化（反爬虫）
+- `easyocr>=1.7.0` - OCR 文字识别
+- `pytesseract>=0.3.10` - Tesseract OCR 接口
+- `Pillow>=9.0.0` - 图像处理
+- `torch>=2.0.0` - PyTorch 深度学习框架
+- `pyannote.audio>=1.0.0` - 说话者分离
+- `funasr` / `modelscope` - 阿里 FunASR 语音识别
+- `libtmux>=0.55.0` - tmux 会话管理 (gsd-openclaw)
+
+**Node.js 核心依赖:**
+- 无外部运行时依赖 - gsd 是纯 CommonJS 工具集
+
+## Configuration
+
+**环境变量配置:**
+- 配置文件: `~/.kb_env` - 知识库专用环境变量
+- `.env.example` - 各技能目录下提供示例配置
+
+**关键配置文件:**
+- `pyproject.toml` - gsd-openclaw 项目配置
+- `requirements.txt` - Python 技能依赖声明
+- `package.json` - gsd Node.js 项目配置
+
+**构建配置:**
+- `scripts/build-hooks.js` - gsd hooks 构建
+- `tool.setuptools` - gsd-openclaw 打包配置
+
+## Platform Requirements
+
+**Development:**
+- ffmpeg - 音视频格式转换
+- yt-dlp - 视频下载工具
+- whisper.cpp - 本地语音识别（或 GPU 版 PyTorch）
+- tesseract - OCR 引擎（可选）
+- tmux - 会话管理
+
+**Production:**
+- 自托管 Gitea Actions runner
+- 部署目标: `~/.openclaw/skills/` 目录
+- rsync 同步部署
+
+## Project Structure
+
+**Monorepo 结构:**
+```
+kb-skills/
+├── gsd/                    # Get-Shit-Done 元提示系统 (Node.js)
+├── gsd-openclaw/           # GSD-OpenClaw 桥接技能 (Python)
+├── kb-workflow/            # 知识库工作流编排入口
+├── kb-link-parser/         # 多平台 URL 解析
+├── kb-bilibili-*/          # B站内容采集技能
+├── kb-zhihu-*/             # 知乎内容采集技能
+├── kb-whisper/             # Whisper 语音识别
+├── kb-whisper-diarization/ # 说话者分离
+├── kb-funasr/              # 阿里 FunASR 语音识别
+├── kb-ocr-processor/       # OCR 文字提取
+├── kb-deep-analyzer/       # AI 深度内容分析
+└── todo-manager/           # 待办管理技能
+```
+
+---
+
+*Stack analysis: 2026-03-13*