Borrowing it
Nothing to install: this file belongs to AloneNanNan/Halo-Theme-Ethereal. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/AloneNanNan/Halo-Theme-Ethereal/main/AGENTS.mdgit clone --depth 1 https://github.com/AloneNanNan/Halo-Theme-EtherealWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/alonenannan/halo-theme-ethereal/agents-md)<a href="https://agentmods.dev/instructions/alonenannan/halo-theme-ethereal/agents-md"><img src="https://agentmods.dev/badge/instructions/alonenannan/halo-theme-ethereal/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/alonenannan/halo-theme-ethereal/agents-md"><img src="https://agentmods.dev/badge/instructions/alonenannan/halo-theme-ethereal/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.05035 | $0.05035 |
| Opus 5 | $0.02518 | $0.02518 |
| Sonnet 5 | $0.01007 | $0.01007 |
| Haiku 4.5 | $0.00504 | $0.00504 |
Grade A, and why
Halo-Theme-Ethereal AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
- **Halo 模板缓存**：改完 `templates/` 后 Halo 不会自动重载，必须到后台「主题 → 重载主题」（或重新上传主题包）才生效。服务端渲染中途抛错会表现为**浏览器一直转圈（响应流截断）而非报错页**；此时用 curl 抓页面看是否以 `</html>` 结尾、并到日志搜 `TemplateProcessingException` 定位。直接 `>` 截断 `halo.log` 会因写入偏移错位产生空字节，要用 How it starts
The opening of the file, as written. The whole thing — 147 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
面向 AI 协作者的开发约定与注意事项。本文件是给编码代理（Codex、opencode、Cursor 等）读取的，用于在改代码前快速了解本项目的构建方式、目录约定与常见坑，减少到处搜索。
项目是什么
Ethereal 是一款基于 Astro 构建的 Halo CMS 主题。它先用 Astro 编写组件与模板，构建后输出为 Halo 使用的 Thymeleaf 模板，再由 Halo（Spring Boot + Thymeleaf）在服务端渲染最终页面。
核心心智模型：你在 .astro 文件里写的 th:xxx 属性不是前端语法，而是给 Thymeleaf 模板引擎用的指令，构建后原样保留在 templates/*.html 里。
技术栈：Astro（页面/路由）+ Svelte 5（交互组件，如 Search、LightDarkSwitch）+ Tailwind CSS 4 + TypeScript + Swup（页面过渡动画）+ Iconify（图标）。
开发环境
- 需要 Node.js >= 22.12.0（推荐 24.x，见
.nvmrc）与 pnpm。 pnpm dev：监听src/文件变更自动重建（不会打包 zip）。
构建与校验命令
| 命令 | 作用 |
|---|---|
pnpm build:only |
仅执行 astro build，输出到 templates/（开发调试常用） |
pnpm build |
astro build + pnpm package（打成发布 zip） |
pnpm astro check |
类型检查，务必在改动后运行确认 0 error |
pnpm format |
prettier 格式化全项目，随后自动刷新 README-Halo.md |
pnpm readme:halo |
单独触发 README→README-Halo 转换（见「README-Halo 转换」） |
重要：改完代码后运行的校验是 pnpm astro check 和 pnpm build:only。 两类产物的位置不同：astro build 的 HTML 模板输出到 templates/；pnpm package 打出的发布 zip 输出到 dist/。两者都是构建生成、勿手动编辑——要改就改 src/ 后重新构建。
经典脚本资产管线（I27 引入，astro.config.mjs 的 buildAssets integration）：
src/scripts/assets/*.ts →(esbuild IIFE, build:start)→ public/assets/*.js
src/scripts/vendor/*.js →(原样拷贝, build:start)→ public/assets/*.js
→(astro 拷贝 public/)→ templates/assets/*.js →(esbuild 压缩, build:done)→ 产物
src/scripts/assets/是全部经典脚本源码（含// @ts-nocheck的 legacy 脚本），public/assets/是纯产物目录，勿手改。legacy 脚本（wave/navbar/wishes/upvote/banner-* 等）迁入后统一.ts后缀（兼容 nodemon watch，esbuild 照常编译）。src/scripts/vendor/存放第三方 vendored 资产（如 qrcode.bundle.js UMD），构建期原样拷贝、不经过 esbuild 编译。_前缀文件（如_theme-config.ts）是被 import 的共享模块，不是独立入口，esbuild 会内联进各入口。- 产物带
/*__ETHEMEAL_MINIFIED__*/标记；build:done 只压缩白名单内 public 产物，不碰 Astro/Vite 的 hashed module 文件。 - nodemon 的 ext 不含 js 是有意的：编译产物写入 public/ 不会触发重建（防编译→重建死循环）。不要给 nodemon.json 加 js；改脚本源码统一用
.ts后缀。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago Changed · +4 lines · +197 tokens per session 3abeccdd0381
- 4d ago Changed · -8 lines · -427 tokens per session 4de98abe1ebd
- 10d ago First seen · 151 lines · 5,265 tokens per session scan A e47e7e977678
Halo-Theme-Ethereal AGENTS.md is an instructions file published in the GitHub repository AloneNanNan/Halo-Theme-Ethereal (13 stars, last pushed 2d ago), licensed MIT. It adds 5,035 tokens to every session, about $0.0252 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.