xiaohongshu-matrices-cli 0.9.0__tar.gz

xiaohongshu_matrices_cli-0.9.0/.gitattributes

@@ -0,0 +1,12 @@
+# Normalize line endings across platforms
+* text=auto eol=lf
+
+# Binary assets (never normalize)
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.zip binary
+*.woff binary
+*.woff2 binary

xiaohongshu_matrices_cli-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - run: pip install uv
+
+      - run: uv sync --extra dev
+
+      - run: uv run ruff check . --exclude vendor
+
+      - run: uv run pytest -m "not smoke" --ignore=tests/test_integration.py

xiaohongshu_matrices_cli-0.9.0/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  verify:
+    uses: ./.github/workflows/ci.yml
+
+  publish:
+    needs: verify
+    runs-on: ubuntu-latest
+    # Trusted Publishing (OIDC) — no API token required.
+    # Configure once on PyPI: project "xiaohongshu-matrices-cli" →
+    # Publishing → Add trusted publisher (GitHub, owner alanl1234,
+    # repo xiaohongshu-matrices-cli, workflow publish.yml, environment pypi).
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

xiaohongshu_matrices_cli-0.9.0/.gitignore

@@ -0,0 +1,43 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.playwright-mcp/
+xhs_login_page.png
+
+# ── Open-source hygiene ──
+.pytest-p0-desktop/
+.pytest-tmp/
+orchestrator_goals.json
+.coverage
+*.log
+
+# ── Runtime artifacts (never commit) ──
+data/
+*.db
+*.sqlite
+*.sqlite3
+.DS_Store
+Thumbs.db
+
+# ── Local / agent artifacts (never commit) ──
+.workbuddy/
+cookies.backup.json
+
+# ── AI research / local analysis products (local data, never commit) ──
+# 账号编号、源账号、风格绑定、图片指令词等均为本地数据，禁止入库。
+AI_RESEARCH_PLAN.md
+PROJECT_REVIEW.md
+wordcard_*.md
+erchuang_*.md
+template_analysis_*.md
+note_*.json
+elegant_publish_image.jpg
+
+# ── Build / packaging artifacts (regenerable) ──
+build/
+.buildenv/

xiaohongshu_matrices_cli-0.9.0/AI_OPERATIONS.md

@@ -0,0 +1,143 @@
+# AI 素材研究与互动运营扩展
+
+面向多账号矩阵运营：在统一治理下，把自然语言目标拆解为检索子任务，并跨账号编排发布与互动。
+
+## 启动
+
+在项目根目录下设置环境变量后启动后台。Windows 使用 `$env:VAR="值"`，macOS / Linux 使用 `export VAR=值`。
+
+```bash
+# 方式一：依赖同步完成后（uv sync 之后）
+xhs-dashboard
+
+# 方式二：使用项目虚拟环境
+#   macOS / Linux:  .venv/bin/xhs-dashboard
+#   Windows:        .venv\Scripts\xhs-dashboard
+```
+
+```bash
+export OPENAI_API_KEY="你的 API Key"
+export XHS_AGENT_TOKEN="自行生成的长随机字符串"
+export XHS_ENGAGEMENT_MODE="shadow"   # shadow / inbound / reviewed
+xhs-dashboard
+```
+
+后台默认地址为 `http://127.0.0.1:8765`，仅监听本机。Camoufox 不需要一直打开；绑定、同步或执行任务时会按账号打开，完成后关闭，后台进程需保持运行。
+
+模型均可通过环境变量替换：
+
+默认 `shadow` 只生成和审核，不执行发送；第二阶段改为 `inbound`，只开放自有评论回复和入站私信；完成专用测试账号验收后才能人工改为 `reviewed`。
+
+```bash
+export XHS_AI_FAST_MODEL="低成本分类模型"
+export XHS_AI_BALANCED_MODEL="日常研究和起草模型"
+export XHS_AI_QUALITY_MODEL="复杂研究升级模型"
+```
+
+API Key 和 Agent Token 不写入 SQLite、任务包或日志。
+
+## 推荐使用顺序
+
+1. 在“账号人设”中建立真实账号的人设版本。
+2. 在“AI 研究”中把自然语言目标拆成多个检索角度（每个角度带检索词与筛选标准），完成后每个角度生成一个采集任务。
+3. 在“授权素材与二创”中登记来源。只有 `owned` 或 `authorized` 可以进入二创。
+4. 在线下完成二创，成品目录放置 `post.md` 和本地图片，再人工声明使用权并导入。
+5. 在“互动工作台”登记不含消息正文的会话索引，创建评论或私信任务。
+6. 每条任务先批准，再单独点击执行。批准与执行是两个不同动作。
+
+## Agent Gateway
+
+OpenAPI 文档位于 `http://127.0.0.1:8765/api/docs`。所有 `/api/agent/*` 请求必须携带：
+
+```text
+X-Agent-Token: <XHS_AGENT_TOKEN>
+```
+
+外部 Agent 可以创建 AI 任务、草稿和待审核互动任务，但没有批准、发送、Cookie、浏览器档案或敏感会话读取接口。
+
+创建草稿示例：
+
+```json
+{
+  "kind": "comment",
+  "account_id": 1,
+  "content": "针对当前笔记内容的具体观点",
+  "sources": ["note:abc"]
+}
+```
+
+创建互动任务示例：
+
+```json
+{
+  "kind": "dm_reply",
+  "account_id": 1,
+  "thread_id": 3,
+  "content": "可以，我们继续在站内把需求确认清楚。"
+}
+```
+
+Agent 也可将 UTF-8 JSON 文件放入数据目录的 `agent-inbox`，由操作者在“AI 研究”页手动导入。成功导入后扩展名变为 `.imported`。
+
+## 隐私和停止规则
+
+- 系统在内容进入模型和数据库前检测手机号、微信号及地址。
+- 同步私信时一旦检测到敏感信息，只写入不含原文的事件，停止 AI 和自动发送，并要求到原账号查看。
+- 拒绝、投诉或举报会把目标加入跨账号停止触达名单。
+- 验证码、登录失效、账号限制和发送结果不明确会停止队列，不自动重发。
+- 详细规则参见 `INTERACTION_RULES.md`，后台“互动规则”页展示当前生效版本。
+
+## 外部 AI Agent / 自动化工具
+
+优先使用 OpenAPI 连接器；如果工具只能访问本地文件，则只授权 `agent-inbox` 目录。不要把后台数据根目录、浏览器档案目录或账号 Cookie 暴露给外部 Agent。
+
+## Agent 发布门禁
+
+Agent 通过 `PUT /api/agent/drafts/{draft_id}/publish-gate` 填充门禁：素材权属（自有或已授权）、来源引用、二创完成声明、1–18 个成品图片绝对路径、权属证据，以及可选话题。编排器仅使用这些明确登记的成品图片，并且只能生成 `pending_review` 任务，不能批准。
+
+## 全自动编排（Orchestrator）
+
+编排层在**不改动任何手动流程**的前提下，把已有的两套队列（采集/发布、AI/互动）串成闭环，
+并一律经过治理引擎（限流、opt-out、敏感词、相似度）把关。默认关闭，需显式开启。
+
+### 环境变量
+
+| 变量 | 取值 | 作用 |
+|------|------|------|
+| `XHS_ORCHESTRATOR` | `1` | 启动编排常驻线程：目标调度 + 流水线串联 + 自动发布 + 自动执行已批准互动 |
+| `XHS_AUTO_PUBLISH` | `1` / `approve` | `1`=门禁完整的 AI 草稿转待审核发布任务；旧值 `approve` 行为相同，始终需要人工批准 |
+| `XHS_ASSET_POOL_DIR` | 目录路径 | 旧版兼容变量；新流程只使用发布门禁明确填入的成品图片 |
+| `XHS_ENGAGEMENT_MODE` | `shadow`/`inbound`/`reviewed` | 复用既有互动灰度，决定哪些**已批准**任务被自动执行 |
+| `XHS_AUTO_ENGAGE` | `1` | 额外开启入站会话的定期同步（dm_sync） |
+| `XHS_DAILY_PUBLISH_LIMIT` | 整数（默认 5） | 每账号每日最多自动发布数 |
+| `XHS_ORCHESTRATOR_TICK` | 秒（默认 60） | 编排线程轮询间隔 |
+
+### 目标文件
+
+在数据目录 `orchestrator_goals.json` 放置运营目标列表（可参考 `orchestrator_goals.example.json`）。
+编排器按各自 `cadence_hours` 周期性把目标转成 `search_brief` AI 任务，之后自动串联：
+
+```
+目标(orchestrator_goals.json)
+  → search_brief（AI 把目标拆成多个检索子任务，各带检索词与筛选标准，产出 SearchPlan）
+  → 每个子任务一个采集任务（自动入库爆款笔记）
+  → screen_results（AI 按各角度筛选标准做相关性筛选，选中/落选给理由，非热度前 N）
+  → material_research（AI 分析选中素材、产出二创洞察）
+  → agent_draft（AI 按人设起草草稿，状态 pending_review）
+  → Agent 填充来源、授权、二创完成和成品图片门禁
+  → [XHS_AUTO_PUBLISH] 门禁完整后转为 pending_review（人工批准）
+```
+
+### 互动侧的"全自动"
+
+互动任务仍需先 `pending_review → approved`（Agent Gateway 只能创建，批准必须由人工在后台完成）。
+编排器在 `reviewed`/`inbound` 模式下，把**已批准**任务自动排队执行，并再次经 `GovernanceService.preflight`
+把关（预算、冷却、opt-out、敏感词）。`shadow` 模式下不自动执行任何发送。
+
+### 状态与手动触发
+
+- `GET /api/orchestrator/status`：查看是否启用、当前模式、已加载目标数、是否运行中。
+- `POST /api/orchestrator/trigger`：立即跑一轮编排（即使常驻线程未启用也会执行一次）。
+
+> 设计原则：编排器只做"串联与排期"，不绕过任何既有闸门。发布与主动触达的最终放行，
+> 始终由治理引擎与 `XHS_ENGAGEMENT_MODE` 决定；命中敏感信息 / opt-out / 预算上限会自动转人工。

xiaohongshu_matrices_cli-0.9.0/CAPABILITIES.md

@@ -0,0 +1,66 @@
+# 能力总览与系统架构
+
+`xiaohongshu-matrices-cli` 是一套**本地优先、多账号矩阵化**的小红书运营工具，提供命令行（CLI）与本地运营后台（Dashboard）两种使用方式。矩阵化的核心在于：把多个账号纳入统一纳管，按账号设定独立人设，并在同一治理引擎（限流 / 去重 / 问责）下跨账号编排发布与互动。本项目基于 [jackwener/xiaohongshu-cli](https://github.com/jackwener/xiaohongshu-cli)（Apache-2.0）fork，在保留原版采集与互动能力的基础上，新增了受治理的自动化编排层，可运行于 Windows / macOS / Linux。
+
+## 能力分层
+
+系统按职责分为五层。所有自动化行为均经过治理层把关，不会绕过任何既有闸门。
+
+### 1. 采集层
+- 按关键词 / 话题 / 作者 / 热榜 / Feed 抓取爆款笔记与评论，写入本地 SQLite 持久化存储，支持断点恢复。
+- 适用场景：选题挖掘、竞品监控、爆款素材库建设。
+
+### 2. AI 层（可选）
+- 把自然语言运营目标拆解为多个检索子任务（不同角度），每个子任务自带检索词与筛选标准（`search_brief` 产出 `SearchPlan`）。
+- 采集完成后，先按各角度的筛选标准做**相关性筛选**（`screen_results`，LLM 判定选中/落选并给理由，而非机械取前 N 条），再对选中素材做二创洞察分析（`material_research`）。
+- 按账号人设起草草稿（`agent_draft`），默认进入 `pending_review` 状态等待人工批准。
+- 走 OpenAI Responses API 兼容协议，通过 `OPENAI_API_KEY` + `OPENAI_BASE_URL` 接入任意兼容模型。
+
+### 3. 执行层
+- **浏览器发布**：`BrowserPublisher` 使用 Camoufox（Firefox 抗检测分支）以真实浏览器发布图文笔记，需 1–18 张图片。
+- **互动执行**：评论、回复、私信、点赞、收藏、关注、取关。
+- 任务队列：`DurableTaskQueue`（采集 / 发布）与 `OperationQueue`（AI / 互动）均为持久化队列，进程重启不丢失任务。
+
+### 4. 治理层（核心价值与硬约束）
+- 限流 / 预算上限、opt-out（退出触达）、敏感信息过滤、相似度去重、账号级问责。
+- 互动灰度三段式：`shadow`（仅记录不发送）→ `inbound`（仅回复与入站私信）→ `reviewed`（全部放开）。
+- 所有发布默认 `pending_review`，必须人工批准；自动化不得绕过审核。
+
+### 5. 编排层（Orchestrator）
+- 将以上四层串成 **目标 → 采集 → 研究 → 起草 → 发布 → 互动** 的闭环，完全复用既有治理引擎。
+- 采用常驻轮询模型（默认 60s），目标与节奏由 `orchestrator_goals.json` 配置，全部通过环境变量 opt-in，默认关闭。
+- 详见 [AI_OPERATIONS.md](./AI_OPERATIONS.md)。
+
+## 典型场景
+
+| 场景 | 用法 |
+|------|------|
+| 选题挖掘 | 目标拆成多角度检索 → 按各角度筛选标准做相关性筛选 → AI 分析「为什么火」→ 产出二创方向 |
+| 内容生产 | 自然语言目标 → AI 按人设起草草稿 → 人工配图后发布 |
+| 多账号矩阵 | 多账号统一纳管、按账号设定人设，治理层统一限流 / 去重 / 问责，跨账号编排发布与互动 |
+| 互动运营 | `inbound` 模式自动回复评论 / 私信，受治理引擎把控 |
+| 全自动闭环 | 编写目标文件，后台常驻自动跑完整条流水线 |
+
+## 安全与合规边界
+1. 自动发布必须配图：AI 仅产出文字，发布需要 1–18 张图片；未配图时草稿自动跳过、留人工处理。
+2. `shadow` 模式绝不自动发送；任何触达的最终放行由 `XHS_ENGAGEMENT_MODE` 与治理引擎决定。
+3. 命中敏感信息 / opt-out / 预算上限时自动转人工，不会硬闯。
+4. 运行数据（Cookie / Token / 笔记库）默认落在用户主目录（`~/.xiaohongshu-cli`），不进入仓库。
+
+## 快速开始
+
+```bash
+# 安装依赖（项目内）
+uv sync
+# 启动后台
+xhs-dashboard --port 8765 --data-dir ./data
+# 常用 CLI
+xhs search "<关键词>"                  # 搜索笔记
+xhs hot                                # 热榜
+xhs comment <note_id> "<内容>"
+xhs follow <user_id>
+xhs post --title "..." --body "..." --images a.jpg b.jpg
+xhs login / status / whoami            # 账号绑定与状态
+```
+
+后台地址：`http://127.0.0.1:8765`（仅本机监听）。编排器状态：`GET /api/orchestrator/status`。

xiaohongshu_matrices_cli-0.9.0/DASHBOARD.md

@@ -0,0 +1,90 @@
+# 小红书爆款采集与多账号发布后台
+
+## 启动
+
+```bash
+uv sync --extra dev
+# macOS / Linux:  .venv/bin/xhs-dashboard
+# Windows:        .venv\Scripts\xhs-dashboard
+xhs-dashboard            # 启动后台（uv sync 后可用）
+```
+
+## Camoufox 浏览器（跨平台）
+
+项目通过本地 `vendor/camoufox-python` 接口使用 Camoufox（Firefox 抗检测分支）。
+Camoufox 二进制按操作系统下载，使用对应平台的安装命令即可，无需修改版本号：
+
+```bash
+# 拉取当前系统的 Camoufox 二进制（自动识别架构）
+python -m camoufox fetch
+
+# 或：从已下载的 ZIP 重新安装（路径按实际位置填写）
+#   macOS / Linux:  python scripts/install_camoufox_zip.py "/path/to/camoufox-<version>-<os>.zip"
+#   Windows:        .venv\Scripts\python.exe scripts\install_camoufox_zip.py "C:\path\to\camoufox-<version>-win.x86_64.zip"
+```
+
+安装器会根据同步索引校验 SHA-256，并在确认二进制存在后才切换活动版本。
+打开 `http://127.0.0.1:8765`。后台只允许监听本机地址，数据默认保存在
+用户主目录下的 `.xiaohongshu-cli/dashboard`（Windows 为 `%USERPROFILE%\.xiaohongshu-cli\dashboard`）。
+可用 `--data-dir` 修改位置。
+
+## P0 可靠性与安全
+
+- 搜索和发布任务写入 SQLite 持久化队列，使用租约与心跳；服务重启后搜索可断点恢复。
+- 同一账号严格串行，不同账号默认最多两个低并发工作线程。
+- 发布线程在提交阶段中断时直接转为 `verification_pending`，不会自动再次点击发布。
+- 搜索候选逐篇落库，已完成候选不会在恢复后重复抓取。
+- 每账号默认读取间隔 1 秒、每日最多 2500 次读取请求；验证、限流或账号限制会暂停账号。
+- 发布前校验标题、正文加话题总长度、1–18 张图片、单图 20MB 和重复内容指纹。
+- 发布核验要求本次提交后出现新的笔记 ID，不再只按相同标题判断。
+- 浏览器档案按平台隔离：Windows 下档案 ACL 仅授予当前用户与 SYSTEM；其他系统使用 `0o700` 权限，并拒绝同一小红书身份绑定到两个档案。
+- 数据库首次升级到 P0 架构时，会在数据目录的 `backups` 中自动保存迁移前备份。
+
+可通过环境变量调整：`XHS_WORKERS`、`XHS_REQUEST_INTERVAL`、
+`XHS_DAILY_REQUEST_LIMIT`、`XHS_QUEUE_LEASE` 和 `XHS_PUBLISH_COOLDOWN`。
+
+## 首次使用
+
+1. 在“账号管理”创建档案，点击“扫码绑定”，在弹出的独立浏览器中登录。
+2. 绑定状态变为 `ready` 后，在“爆款搜索”创建采集任务。
+3. 任务命中的笔记会连同图片和最多 100 条评论写入本地素材库。
+4. 在“审核与发布”上传内容，或导入批量目录；批准后才能执行发布。
+
+旧版单账号 Cookie 可一次性迁移：
+
+```powershell
+python -m xhs_cli.dashboard.migrate
+```
+
+## 批量发布目录
+
+每篇内容一个文件夹：
+
+```text
+待发布素材/
+  帖子一/
+    post.md
+    01.jpg
+    02.jpg
+```
+
+`post.md` 示例：
+
+```markdown
+---
+title: 周末城市漫步
+account: 品牌主账号
+topics: [城市漫步, 周末去哪]
+images: [01.jpg, 02.jpg]
+---
+正文内容。
+```
+
+## 安全与风控
+
+- 浏览器会话按账号隔离，数据库不保存明文 Cookie。
+- 所有发布任务默认是 `pending_review`，必须人工批准。
+- 同账号发布串行，默认间隔至少 10 分钟。
+- 验证码、登录失效、限流和访问限制会暂停任务，不进行自动绕过。
+- `verification_pending` 表示页面可能提示成功但作品列表未确认，系统不会自动重发。
+- 首次真实发布建议使用测试账号或仅自己可见内容。

xiaohongshu_matrices_cli-0.9.0/INTERACTION_RULES.md

@@ -0,0 +1,31 @@
+# 小红书互动与客户沟通规则（v1）
+
+本规则用于合规运营、减少误操作和保护沟通对象，不用于规避平台安全机制，也不保证账号不会受到限制。
+
+## 允许触达
+
+- 回复自有笔记评论、品牌提及和对方主动私信。
+- 暖线索仅包括：主动私信、自有笔记明确表达需求、品牌提及、约定咨询关键词。
+- 关注和点赞本身不构成主动私信依据。
+- 外部主动评论仅限人工选择的少量高相关笔记，且必须逐条审核。
+
+## 沟通与隐私
+
+- 默认引导继续站内私信，不主动索取微信、手机号或地址。
+- 检测到手机号、微信号或地址后，不保存具体内容，停止 AI 和自动发送，提示操作者到原账号人工查看。
+- 对方要求停止联系、投诉或举报时，立即跨账号停止触达。
+
+## 禁止行为
+
+- 禁止骚扰、批量复制、无关广告、虚假身份、虚假资质、虚假案例和效果承诺。
+- 禁止让模型或自动化绕过验证码、登录验证、账号限制或审核。
+- 医疗、金融、未成年人等高风险内容默认转人工处理。
+
+## 试运行频率
+
+- 回复评论：每账号 8 条/天。
+- 外部主动评论：每账号 8 条/天；两类评论合计最多 2 条/小时。
+- 暖线索主动私信：每账号 5 条/天，最小间隔 60 分钟。
+- 入站私信回复：每账号 30 条/天、同会话 10 条/天，同会话最小间隔 5 分钟。
+- 同一用户默认跨账号冷却 30 天；相似度超过 0.85 的近期内容禁止发送。
+- 14 天内不得自动提升额度，任何修改必须产生新的规则版本并人工启用。

xiaohongshu_matrices_cli-0.9.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work, excluding
+          those notices that do not pertain to any part of the Derivative
+          Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do
+          not modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024 jackwener
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.