mimeku/deepseek-v4-annotated-walkthrough
DeepSeek V4 Guide
Interactive static PDF guide prototype.
Local Build
npm install
npm run buildnpm run build regenerates note annotations and writes a deploy-only dist/ folder. The deploy artifact intentionally contains only static app files, rendered PDF assets, generated annotation/text-layer data, and Cloudflare headers.
Environment
Copy .env.example to .env and fill in the local secrets:
CLOUDFLARE_ACCOUNT_ID=...
CLOUDFLARE_API_TOKEN=...
CLOUDFLARE_WORKER_NAME=deepseek-v4-guide
CLOUDFLARE_CUSTOM_DOMAIN=dsv4.interactive.ikot.blog
CLOUDFLARE_ZONE_NAME=ikot.blog
HF_TOKEN=...
HF_SPACE_ID=stalkermustang/deepseek-v4-guide.env is ignored by git. Legacy .cloudflare_token and .hf_token files are also ignored, but the deploy scripts read .env.
Deploy
npm run deploy:cloudflare
npm run deploy:hfor deploy both targets:
npm run deployCloudflare uses wrangler.toml, publishes dist/ as Workers Static Assets, and keeps the configured custom domain attached to the Worker. Hugging Face creates the configured static Space if needed and uploads dist/ to the Space root, not the repository root. The HF deploy script does not change Space visibility.
