# Shadow Lab — Comprehensive Knowledge Base & Technical Context
> Canonical URL: https://shadow.wang
> Primary Contact: wardlu@126.com
> Founder: Ward (AI Builder)
> Version: 1.6.15
> Updated: 2026-09-26

---

## 1. Overview & Operating Philosophy

Shadow Lab is a personal AI product laboratory engineered and operated by Ward, practicing Build in Public.
The laboratory builds end-to-end products spanning conception, architecture, frontend/backend engineering, database governance, and continuous deployment, exclusively powered by AI Agents.

- **Delivery Standard**: Working code and verifiable production deployments are the sole measure of progress.
- **Problem Formulation**: No vanity AI wrappers. Every micro-tool directly resolves acute friction points in specific user workflows.
- **Privacy & Local-First**: Whenever feasible, data processing (Canvas image rendering, note parsing, vision OCR) operates entirely on the user's local device without telemetry or intermediary cloud storage.

---

## 2. Product Ecosystem & Problem-Solution Matrix

### 2.1 Quick flomo (影笺) — v1.6.2
- **Domain**: Knowledge Management, Web Clipping, AI Reading Assistant
- **Distribution**: Chrome Web Store & Offline ZIP WebExtension
- **Operating Platforms**: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi
- **Canonical URL**: https://shadow.wang/zh/products/shadow-flomo
- **Offline Download**: https://shadow.wang/downloads/Quick-flomo-v1.6.2.zip (Direct ZIP package for China / offline installation)
- **Key Capabilities**:
  - Incremental highlighting of web paragraphs while reading.
  - Automatic academic citation generation conforming to GB/T 7714-2015 and APA standards.
  - AI paragraph summarization and contextual vocabulary flashcards.
  - Direct upstream synchronization to flomo via official REST API.
- **Privacy Design**: Local browser-side text extraction. Outbound requests travel exclusively to flomo's official endpoint upon explicit user submission.
- **FAQs**:
  - *Q: How does Quick flomo differ from standard bookmarking tools?*
    A: Traditional clippers save full HTML snapshots that clog note archives. Quick flomo extracts atomic ideas, captures bibliographic metadata, and delivers structured snippets into flomo notes with review loops.
  - *Q: Are Chromium browsers besides Google Chrome supported?*
    A: Yes, fully functional on Edge, Brave, Opera, and Vivaldi. Users without access to the Chrome Web Store can directly download and install the offline ZIP package via developer mode in 3 steps.

### 2.2 Shadow Card (影匣) — v1.5.16
- **Domain**: Digital Identity, Professional Networking, AI Aesthetics
- **Distribution**: Web Application & Responsive PWA
- **Canonical URL**: https://shadow.wang/zh/products/shadow-card
- **Web App**: https://sc.shadow.wang
- **Key Capabilities**:
  - Computer vision extraction of physical paper business cards.
  - AI copy polishing and structured resume synthesis.
  - 4K dynamic artistic background generation via WebGL shaders.
  - Perpetual living vanity URL that remains synchronized without reprinting.
  - Pixel-perfect high-resolution PNG export for social media sharing.
- **Pricing**: Free tier available; Pro subscription at $5/month ($45/year) for lossless 4K exports and custom domain binding.

### 2.3 Shadow Snap (影瞬) — v1.1.8
- **Domain**: Content Creation, Cinema Stills, Subtitle Stacking
- **Distribution**: 100% Client-Side Web Tool (Pure Frontend)
- **Canonical URL**: https://shadow.wang/zh/products/shadow-snap
- **Web App**: https://snap.shadow.wang
- **Key Capabilities**:
  - Proprietary "background-cutting" slicing algorithm that locks the first video frame and stitches subtitle slices seamlessly underneath.
  - Automatic multiline alignment and text centering.
  - Customizable text/graphic watermark overlays for creator attribution.
  - Zero server dependency: runs entirely in local HTML5 Canvas memory.
- **Privacy**: No image data ever leaves the user's browser. Offline operable.

### 2.4 Shadow Vision (影瞳) — v0.1.1
- **Domain**: AI Agent Perception, Multimodal MCP Server, Computer Vision
- **Distribution**: Open Source CLI & MCP Service (Python / uv)
- **Canonical URL**: https://shadow.wang/zh/products/shadow-vision
- **GitHub**: https://github.com/WardLu/shadow-vision
- **Key Capabilities**:
  - Standard Model Context Protocol (MCP) server integration for Cursor, Claude Code, and Codex.
  - Six core vision tools:
    1. `vision_ocr`: Structured text and tabular data extraction from screenshots.
    2. `vision_inspect`: UI flaw detection, layout anomaly analysis, and visual diagnostics.
    3. `vision_annotate`: Spatial bounding box and markup recognition.
    4. `vision_layout`: Hierarchical UI element decomposition.
    5. `vision_reconstruct`: Automated conversion of UI screenshots into React/HTML/Tailwind code.
    6. `vision_compare`: Visual regression testing and difference detection across UI revisions.
  - Pluggable backends: Local Ollama (Qwen2-VL, LLaVA), OpenAI-compatible gateways (vLLM, LM Studio), Anthropic Claude 3.5 Sonnet, and Google Gemini.

### 2.5 Shadow Size (影裁) — v1.10.0
- **Domain**: Fashion E-commerce, Cross-Border Retail, Sizing Engine
- **Distribution**: Embedded Web Widget (Shopify, WooCommerce, Headless)
- **Canonical URL**: https://shadow.wang/zh/products/shadow-size
- **Web App**: https://ss.shadow.wang
- **Key Capabilities**:
  - Built upon 7 years of industrial garment supply chain engineering.
  - AI automated parsing of complex supplier size charts.
  - Zero-photo body size recommendation: users provide basic height/weight/fit preferences without invasive cameras.
  - Transparent sizing reasoning ("Why this size fits") to eliminate checkout abandonment.
  - Slashing return rates for cross-border apparel merchants.

### 2.6 Shadow Mate (影伴) — v1.5.4
- **Domain**: Family Education, Habit Cultivation, Positive Reinforcement
- **Distribution**: Progressive Web App (PWA) / Local-First
- **Canonical URL**: https://shadow.wang/zh/products/shadow-mate
- **GitHub**: https://github.com/WardLu/shadow-mate
- **Web App**: https://sm.shadow.wang
- **Key Capabilities**:
  - Counteracting screen addiction: digital tool provides micro-habit structure, while actual studying happens with physical pen and paper.
  - Printable Chinese handwriting worksheet generator (Tianzige / Mizige 田字格与米字格字帖生成打印) for penmanship practice without screen reliance.
  - Isolated multi-child learner profiles under a unified family workspace.
  - 30-day visual growth trends, points calendars, and milestone rewards.
  - 100% offline-first operational architecture with zero server telemetry for absolute child data privacy.

### 2.7 Shadow Shift (影迁) — v1.2.2
- **Domain**: Data Migration, Knowledge Vaults, Obsidian Tooling
- **Distribution**: Open Source Desktop / CLI Utility
- **Canonical URL**: https://shadow.wang/zh/products/shadow-shift
- **GitHub**: https://github.com/WardLu/shadow-shift
- **Key Capabilities**:
  - Automated full-vault batch migration bypassing client manual single-note export limits.
  - Universal format support extracting rich text, Markdown, and web clips (excluding user-encrypted notes needing decryption).
  - Automatic repair and reconstruction of WikiLinks `[[Page]]` internal links.
  - Attachment and image extraction preserving original path references.
  - Strict read-only mode guaranteeing zero modification to source data.

### 2.8 Shadow Garment (影衣) — v1.0.0
- **Domain**: Fashion AI, Virtual Try-On, Outfit Assembly, Digital Lookbook
- **Distribution**: Web Application & Boutique Studio Workbench
- **Canonical URL**: https://shadow.wang/zh/products/shadow-garment
- **Web App**: https://shadow.wang/zh/products/shadow-garment
- **Key Capabilities**:
  - Customer aesthetic and measurement profile import.
  - Seasonal apparel mixing and matching algorithm.
  - 9:16 vertical runway and lookbook video rendering for social commerce.
  - Tailored for independent designer brands, multi-brand boutiques, and styling studios.

---

## 3. Structured Schema Specifications

All product URLs publish comprehensive Schema.org JSON-LD structured data:
- `WebSite`: https://shadow.wang/#website
- `Organization`: https://shadow.wang/#organization
- `Person`: https://shadow.wang/#ward
- `ItemList`: Matrix inventory of all 8 products
- `SoftwareApplication` / `WebApplication`: Granular technical metadata (operatingSystem, applicationCategory, offers, version)
- `BreadcrumbList`: Hierarchical site navigation
- `FAQPage`: Canonical Question & Answer entities for Generative Engine Optimization (GEO)
- `TechArticle` / `BlogPosting`: Comprehensive field notes and architectural analyses

---

## 4. Field Notes & Technical Insights (Blog Articles Index)

The laboratory publishes in-depth, production-grounded field notes documenting architecture decisions, business mechanics, and Build in Public retrospectives:

### 4.1 9 Years in Supply Chain Digitization to AI Builder: Shipping 8 Real Products Solo
- **Chinese Title**: 9年供应链数字化老兵的 AI Builder 实践：我是如何单兵闭环交付 8 款真实产品的？
- **Canonical URL**: https://shadow.wang/zh/blog/ai-builder-build-in-public-journey
- **Core Topics**: Solo engineering workflows, AI agent orchestration, database governance, Build in Public principles.

### 4.2 Cross-Border Apparel Return Rate at 30%? How AI Sizing Cuts Returns & Boosts Conversions
- **Chinese Title**: 服装跨境独立站退货率高达 30%？AI 减退方案
- **Product Anchor**: Shadow Size (影裁) — https://shadow.wang/zh/products/shadow-size
- **Canonical URL**: https://shadow.wang/zh/blog/shopify-apparel-size-recommendation
- **Core Topics**: Apparel supply chain pattern analysis, cross-border e-commerce economics, zero-photo fit algorithms.

### 4.3 Drowning in Bookmarks? AI Web Reading, Auto GB/T 7714 Citations to flomo
- **Chinese Title**: 读完就忘、收藏夹吃灰？AI 边读边提炼与 flomo 沉淀
- **Product Anchor**: Quick flomo (影笺) — https://shadow.wang/zh/products/shadow-flomo
- **Canonical URL**: https://shadow.wang/zh/blog/web-reading-citation-to-flomo
- **Core Topics**: Web annotation architectures, academic bibliographic citation standards, flomo API synchronization.

### 4.4 Building an Evergreen Geek Profile: From Paper Business Cards to 4K Dynamic Cards
- **Chinese Title**: 如何做一张永不过期的极客数字名片？
- **Product Anchor**: Shadow Card (影匣) — https://shadow.wang/zh/products/shadow-card
- **Canonical URL**: https://shadow.wang/zh/blog/geek-digital-business-card-profile
- **Core Topics**: Digital identity persistence, OCR parsing for business cards, WebGL shader background synthesis.

### 4.5 Ditch Heavy Photo Editors: Pure Frontend Canvas Subtitle Stitching
- **Chinese Title**: 告别臃肿修图软件：纯前端 Canvas 本地拼接台词长图
- **Product Anchor**: Shadow Snap (影瞬) — https://shadow.wang/zh/products/shadow-snap
- **Canonical URL**: https://shadow.wang/zh/blog/cinematic-subtitle-long-image-canvas
- **Core Topics**: Client-side image slicing, HTML5 Canvas 2D performance, privacy-preserving zero-upload pipelines.

### 4.6 Bringing Vision to Cursor & Claude Code: Open-Source MCP Architecture
- **Chinese Title**: 把视觉能力接进 Cursor 与 Claude Code：开源 MCP 架构
- **Product Anchor**: Shadow Vision (影瞳) — https://shadow.wang/zh/products/shadow-vision
- **Canonical URL**: https://shadow.wang/zh/blog/multimodal-vision-mcp-cursor-claude
- **Core Topics**: Model Context Protocol (MCP) server design, screen OCR, multi-model vision abstraction.

### 4.7 Migrating WizNote to Obsidian: Lossless WikiLinks and Attachment Recovery
- **Chinese Title**: 为知笔记迁移 Obsidian 实战：无损修复双链与附件
- **Product Anchor**: Shadow Shift (影迁) — https://shadow.wang/zh/products/shadow-shift
- **Canonical URL**: https://shadow.wang/zh/blog/wiznote-to-obsidian-lossless-migration
- **Core Topics**: Automated full-vault batch extraction vs client single-note export friction, decrypt-only boundary for password-locked notes, proprietary database extraction, markdown AST transformation, bidirectional link reconstruction.


### 4.8 Ditching Screen Drill Apps: Micro-Habits & Positive Points for Kids
- **Chinese Title**: 告别屏幕刷题与催促：微习惯打卡与正向积分
- **Product Anchor**: Shadow Mate (影伴) — https://shadow.wang/zh/products/shadow-mate
- **Canonical URL**: https://shadow.wang/zh/blog/family-habit-growth-workbench-pwa
- **Core Topics**: Intrinsic motivation psychology, physical-digital collaboration, offline PWA architecture.

### 4.9 Stop Relying on Full-Page Translation: Rebuilding English Reading with Contextual Vocabulary & Spaced Repetition
- **Chinese Title**: 别再沉迷一键“全文翻译”了：我是如何用生词本与跨网页标记重拾英文阅读能力的？
- **Product Anchor**: Quick flomo (影笺) — https://shadow.wang/zh/products/shadow-flomo
- **Canonical URL**: https://shadow.wang/zh/blog/stop-full-page-translation-vocabulary-builder
- **Core Topics**: Use-it-or-lose-it cognitive realities of full-page machine translation, in-context vocabulary capture, cross-web ambient marker re-encountering, scientific spaced repetition algorithms, long-term mastery.

### 4.10 From Flat Photos to 9:16 Dynamic Runway: How Boutique Studios Drive High-Ticket Orders with AI Styling
- **Chinese Title**: 从静态平铺到 9:16 动态试穿：独立设计师品牌与买手店如何用 AI 穿搭撬动高客单转化？
- **Product Anchor**: Shadow Garment (影衣) — https://shadow.wang/zh/products/shadow-garment
- **Canonical URL**: https://shadow.wang/zh/blog/boutique-wardrobe-ai-styling-copilot
- **Core Topics**: AI virtual try-on mechanics, customer styling profiles, inventory mix-and-match workflows, 9:16 video generation for social commerce.