fix: correct homepage date, update READMEs, fix repo links, remove stale files

- Fix invitation event date 2025-04-16 → 2026-04-16 on both en/zh-cn index pages
- Rewrite README.md and README.zh-CN.md to match actual repo structure
  - Remove non-existent directories (getting-started, platform-policies, faq)
  - Change npm → pnpm to match packageManager setting
  - Add actual components, scripts, pages to repo structure tree
  - Add turndown to tech stack, Copy-for-LLMs check to quality checks
  - Clarify openapi.json vs openapi.swagger.json
- Delete orphan docs/next-steps.md (internal dev memo, not linked anywhere)
- Update GitHub demo repo links to new names:
  PythonScirptDemo → Python-Worker-Demo
  NodeScirptDemo → Node-Worker-Demo
  GoScirptDemo → Go-Worker-Demo
- Remove stale dev comment from astro.config.mjs

Author: kael-odin

README.md

@@ -1,117 +0,0 @@
-# CoreClaw Documentation
-
-This repository contains the source content and configuration for the CoreClaw documentation site at [docs.coreclaw.com](https://docs.coreclaw.com/), built with [Astro](https://astro.build/) and [Starlight](https://starlight.astro.build/).
-
-For the Chinese version of this guide, see [`README.zh-CN.md`](./README.zh-CN.md).
-
-## Documentation Architecture
-
-The CoreClaw docs are organized into distinct content areas, each serving a specific audience:
-
-### Content Areas
-
-| Section | Audience | Purpose |
-| --- | --- | --- |
-| Getting Started | New users | Platform overview, account setup, first Worker run |
-| User Guide | End users | Running Workers, viewing results, pricing, API calls |
-| Developer Guide | Worker developers | Building, testing, publishing, and monetizing Workers |
-| API Reference | API consumers | Complete endpoint documentation with request/response schemas |
-| Website Events | All users | Platform events and promotions |
-| Platform Policies | All users | Terms, privacy, and usage policies |
-| FAQ | All users | Common questions and troubleshooting |
-| Changelog | All users | Platform and documentation updates |
-
-### Multi-Language Structure
-
-- **English** (`/`) — default language, authoritatively maintained
-- **Simplified Chinese** (`/zh-cn/`) — full translation maintained in parallel
-
-All content directories under `src/content/docs/` and `src/content/docs/zh-cn/` mirror each other. When adding or updating content, both language versions should be kept in sync.
-
-## Key Conventions
-
-### Worker / Scraper Terminology
-
-The CoreClaw platform uses two terms for the same concept:
-
-- **Worker** — used throughout the documentation and UI to refer to a data extraction script
-- **Scraper** — used in API paths and field names for backward compatibility (`scraper_slug`, `/api/v1/scraper/run`)
-
-### API Documentation
-
-The API reference is structured around endpoint groups:
-
-- **Worker** — `/api/v1/scraper/*` endpoints for starting, aborting, and inspecting Worker runs
-- **Runs** — `/api/v1/run/*` endpoints for history, results, logs, and exports
-- **Tasks** — `/api/v1/task/*` endpoints for saved Task templates
-- **Account** — `/api/v1/account/*` endpoints for user account information
-
-Each endpoint page documents the HTTP method, path, request parameters, response schema, and error codes. The [API index page](https://docs.coreclaw.com/api/) includes a complete endpoint quick reference table.
-
-An `openapi.swagger.json` file is kept locally for API schema reference but is excluded from version control (see `.gitignore`).
-
-### Sidebar Configuration
-
-Navigation is defined manually in `astro.config.mjs` using explicit `items` arrays. This gives full control over:
-- Section labels and ordering
-- Translation of labels across languages
-- Collapsible groups and nesting depth
-- Badge annotations (e.g., "Required")
-
-## Repository Structure
-
-```text
-.
-├── public/                         # Static assets served as-is
-├── src/
-│   ├── assets/                     # Images and logos used at build time
-│   ├── components/                 # Custom Astro components (Header, Banner, TOC)
-│   ├── content/docs/               # English documentation (default locale)
-│   │   ├── api/                    #   API reference
-│   │   ├── developer-guide/        #   Developer documentation
-│   │   ├── user-guide/             #   End-user documentation
-│   │   ├── getting-started/        #   Onboarding
-│   │   ├── website-events/         #   Events and promotions
-│   │   ├── platform-policies/      #   Legal and policy pages
-│   │   ├── faq/                    #   Frequently asked questions
-│   │   ├── changelog.mdx           #   Changelog
-│   │   └── zh-cn/                  # Simplified Chinese mirror
-│   └── styles/common.css           # Global CSS overrides
-├── astro.config.mjs                # Astro + Starlight configuration
-├── package.json
-└── tsconfig.json
-```
-
-## Tech Stack
-
-| Component | Role |
-| --- | --- |
-| [Astro](https://astro.build/) | Static site generator |
-| [Starlight](https://starlight.astro.build/) | Documentation theme (sidebar, search, i18n) |
-| [React](https://react.dev/) | Interactive UI components |
-| `starlight-image-zoom` | Image zoom plugin |
-| `sharp` | Image optimization |
-
-## Local Development
-
-```bash
-npm install          # Install dependencies (Node.js 18+, npm 9+)
-npm run dev          # Start dev server at http://localhost:4321
-npm run build        # Build to dist/
-npm run preview      # Preview built output
-```
-
-## Quality Checks
-
-Before committing, run `npm run build` and verify:
-
-- No content rendering errors
-- Sidebar order matches expectations in both languages
-- English and Chinese pages are structurally aligned
-- No broken internal links or missing asset references
-
-## References
-
-- [Astro Documentation](https://docs.astro.build/)
-- [Starlight Documentation](https://starlight.astro.build/)
-- [CoreClaw Docs (live)](https://docs.coreclaw.com/)

README.zh-CN.md

@@ -12,13 +12,10 @@ CoreClaw 文档按受众划分为以下内容区域：
 
 | 区域 | 受众 | 内容 |
 | --- | --- | --- |
-| 快速入门 | 新用户 | 平台概览、账号注册、首次运行 Worker |
-| 用户指南 | 终端用户 | 运行 Worker、查看结果、计费规则、API 调用 |
+| 用户指南 | 终端用户 | 运行 Worker、查看结果、计费规则、API 调用、常见问题 |
 | 开发者指南 | Worker 开发者 | 构建、测试、发布和变现 Worker |
 | API 参考 | API 调用方 | 完整的接口文档，含请求/响应 schema |
 | 网站活动 | 所有用户 | 平台活动与推广 |
-| 平台政策 | 所有用户 | 条款、隐私、使用政策 |
-| 常见问题 | 所有用户 | 常见疑问与排障 |
 | 更新日志 | 所有用户 | 平台与文档更新记录 |
 
 ### 多语言结构
@@ -48,7 +45,7 @@ API 参考按端点组组织：
 
 每个端点页面记录了 HTTP 方法、路径、请求参数、响应 schema 和错误码。[API 索引页](https://docs.coreclaw.com/zh-cn/api/) 提供了完整的端点速查表。
 
-`openapi.swagger.json` 文件仅供本地 API schema 参考，不纳入版本控制（见 `.gitignore`）。
+OpenAPI 规范文件位于 `public/openapi.json`，通过 `/openapi.json` 对外提供。`openapi.swagger.json` 文件仅供本地参考，不纳入版本控制（见 `.gitignore`）。
 
 ### 侧边栏配置
 
@@ -63,20 +60,31 @@ API 参考按端点组组织：
 ```text
 .
 ├── public/                         # 静态资源（直接输出）
+│   ├── openapi.json                #   OpenAPI 规范（通过 /openapi.json 提供）
+│   ├── favicon.jpg                 #   站点图标
+│   └── logo.png                    #   站点 Logo
 ├── src/
 │   ├── assets/                     # 构建期资源（图片、logo）
-│   ├── components/                 # 自定义 Astro 组件（Header、Banner、目录）
+│   │   └── docs/                   #   文档截图
+│   ├── components/                 # 自定义 Astro 组件
+│   │   ├── ApiPlayground.astro     #   交互式 API 调试表单
+│   │   ├── CopyForLLMs.astro      #   复制给 LLM 头部下拉
+│   │   ├── Banner.astro           #   站点横幅
+│   │   ├── Header.astro           #   自定义页头
+│   │   ├── Footer.astro           #   自定义页脚
+│   │   └── ...                    #   其他覆盖组件
 │   ├── content/docs/               # 英文文档（默认语言）
 │   │   ├── api/                    #   API 参考
 │   │   ├── developer-guide/        #   开发者文档
 │   │   ├── user-guide/             #   用户文档
-│   │   ├── getting-started/        #   快速入门
 │   │   ├── website-events/         #   活动推广
-│   │   ├── platform-policies/      #   法律与政策
-│   │   ├── faq/                    #   常见问题
-│   │   ├── changelog.mdx           #   更新日志
+│   │   ├── home.mdx                #   首页
+│   │   ├── changelog.mdx          #   更新日志
 │   │   └── zh-cn/                  # 简体中文镜像
+│   ├── pages/                      # 动态路由（Copy-for-LLMs .md 导出）
 │   └── styles/common.css           # 全局样式覆盖
+├── scripts/
+│   └── check-copy-for-llms.mjs    # 构建后冒烟测试（.md 导出完整性）
 ├── astro.config.mjs                # Astro + Starlight 配置
 ├── package.json
 └── tsconfig.json
@@ -91,24 +99,26 @@ API 参考按端点组组织：
 | [React](https://react.dev/) | 交互式 UI 组件 |
 | `starlight-image-zoom` | 图片缩放插件 |
 | `sharp` | 图片优化 |
+| `turndown` | HTML 转 Markdown（Copy-for-LLMs） |
 
 ## 本地开发
 
 ```bash
-npm install          # 安装依赖（Node.js 18+，npm 9+）
-npm run dev          # 启动开发服务器 http://localhost:4321
-npm run build        # 构建至 dist/
-npm run preview      # 预览构建结果
+pnpm install          # 安装依赖（Node.js 22+，pnpm 10+）
+pnpm run dev          # 启动开发服务器 http://localhost:4321
+pnpm run build        # 构建至 dist/（含 Copy-for-LLMs 检查）
+pnpm run preview      # 预览构建结果
 ```
 
 ## 质量检查
 
-提交前执行 `npm run build`，确认：
+提交前执行 `pnpm run build`，确认：
 
 - 无内容渲染错误
 - 中英文侧边栏顺序一致
 - 中英文页面结构对齐
 - 无断链或缺失资源引用
+- Copy-for-LLMs 冒烟测试通过（每个文档页面导出非空 Markdown）
 
 ## 参考链接
 

astro.config.mjs

@@ -581,8 +581,6 @@ export default defineConfig({
                                 },
                             ],
                         },
-                        // Single-endpoint group flattened — was a one-item
-                        // collapsible folder, now shows up directly.
                         {
                             label: 'Start Task',
                             slug: 'api/task/run',

docs/next-steps.md

@@ -35,19 +35,19 @@ Local mode development support (running Workers locally with the CoreClaw SDK) i
 
 Choose your preferred language and clone the demo repository:
 
-- **Python**: [PythonScirptDemo](https://github.com/Core-Claw/PythonScirptDemo)
-- **Node.js**: [NodeScirptDemo](https://github.com/Core-Claw/NodeScirptDemo)
-- **Go**: [GoScirptDemo](https://github.com/Core-Claw/GoScirptDemo)
+- **Python**: [Python-Worker-Demo](https://github.com/Core-Claw/Python-Worker-Demo)
+- **Node.js**: [Node-Worker-Demo](https://github.com/Core-Claw/Node-Worker-Demo)
+- **Go**: [Go-Worker-Demo](https://github.com/Core-Claw/Go-Worker-Demo)
 
 ```bash
 # Python
-git clone https://github.com/Core-Claw/PythonScirptDemo.git
+git clone https://github.com/Core-Claw/Python-Worker-Demo.git
 
 # Node.js
-git clone https://github.com/Core-Claw/NodeScirptDemo.git
+git clone https://github.com/Core-Claw/Node-Worker-Demo.git
 
 # Go
-git clone https://github.com/Core-Claw/GoScirptDemo.git
+git clone https://github.com/Core-Claw/Go-Worker-Demo.git
 ```
 
 ### 2. Project Structure

src/content/docs/developer-guide/develop-worker/quick-start.md

@@ -10,7 +10,7 @@ Learn how to build a Worker using Go.
 ## GitHub Repository
 
 Go Script Demo Repository:
-[GoScirptDemo](https://github.com/Core-Claw/GoScirptDemo)
+[Go-Worker-Demo](https://github.com/Core-Claw/Go-Worker-Demo)
 
 ---
 

src/content/docs/developer-guide/worker-definition/examples/go-example.md

@@ -10,7 +10,7 @@ Learn how to build a Worker using Node.js.
 ## GitHub Repository
 
 Node.js Script Demo Repository:
-[NodeScirptDemo](https://github.com/Core-Claw/NodeScirptDemo)
+[Node-Worker-Demo](https://github.com/Core-Claw/Node-Worker-Demo)
 
 ---
 

src/content/docs/developer-guide/worker-definition/examples/nodejs-example.md

@@ -10,7 +10,7 @@ Learn how to build a Worker using Python.
 ## GitHub Repository
 
 Python Script Demo Repository:
-[PythonScirptDemo](https://github.com/Core-Claw/PythonScirptDemo)
+[Python-Worker-Demo](https://github.com/Core-Claw/Python-Worker-Demo)
 
 ---