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.11594 | $0.11594 |
| Opus 5.5 | $0.04638 | $0.04638 |
| Sonnet 5.5 | $0.02319 | $0.02319 |
| Haiku 4.5 | $0.01159 | $0.01159 |
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 today.
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` 会因写入偏移错位产生空字节，要用 `strings` How it starts
The opening of the file, as written. The whole thing — 296 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
面向 AI 协作者的开发约定与注意事项（Codex / opencode / Cursor 等）。改代码前先读「硬规则」「注释规范」以及改动范围对应的「架构契约」小节；人类协作流程（Fork / PR / 许可证）见 CONTRIBUTING.md。
0. 硬规则
- 禁止修改
theme.yaml的version：版本号由发布流程手工提升，AI 不得改动。 - 改完必须跑
pnpm astro check+pnpm build:only并确认通过；只交付src/与根配置 / 脚本改动，构建产物（templates/、dist/、public/assets/*.js）勿手改。 - 不私自 commit / push：仅在用户明确要求时提交，先确认范围；禁止 force push，禁止 amend / rebase 已推送的提交；提交默认排除
theme.yaml版本号改动。 - 先读后改：动手前读本文对应「架构契约」与「常见坑」；涉及同步点（三处设置、两处开关、成对断点）必须同步修改。
- 注释按「注释规范」写：只描述「当前代码为什么这样」，不留日期、过程叙事与重复信息；改代码时顺手修正过时注释。
- 口径不确定先问用户：业务语义、删除功能、改默认值与公开行为，决定权不在 AI。
1. 快速上手
Ethereal 是一款基于 Astro 构建的 Halo CMS 主题：先用 Astro 写组件与模板，构建后输出为 Halo 使用的 Thymeleaf 模板，再由 Halo（Spring Boot + Thymeleaf）在服务端渲染最终页面。
核心心智模型：.astro 文件里的 th:xxx 不是前端语法，而是给 Thymeleaf 的指令，构建后原样保留在 templates/*.html 里。
技术栈：Astro（页面 / 路由）+ Svelte 5（交互组件）+ 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 |
pnpm check + astro build + pnpm package（发布 zip 输出到 dist/） |
pnpm astro check |
类型检查，改动后必须 0 error |
pnpm format |
prettier 格式化全项目，随后自动刷新 README-Halo.md |
pnpm readme:halo |
单独触发 README→README-Halo 转换（见 6.1 的转换说明） |
2. 目录结构速览
src/pages/*.astro— 页面模板（post.astro、index.astro、category.astro等）src/components/*.astro/*.svelte— 可复用组件；control/为分组页共享控件（FilterTab/FilterTabs/PageHeader，表达式以字符串 prop 传入，见 6.6）；widget/为侧边栏小组件（WidgetSwitch.astro是条目分派片段库，见 6.3）src/layouts/*.astro— 页面布局（Layout.astro、MainGridLayout.astro）src/styles/*.css— 全局样式与 CSS 变量（variables.css定义主题色 / 圆角等）src/types/config.ts—theme.config的类型定义src/utils/*.ts— 工具（post-list-config.ts、responsive-image.ts）src/scripts/assets/*.ts— 经典脚本源码（见 6.1）；src/scripts/vendor/— 第三方 vendored 资产settings.yaml— 后台主题设置表单；theme.yaml— 主题元信息，version禁止修改i18n/— 多语言文案；templates//dist/— 构建产物（勿手改）
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.
- today Changed · +5 lines · +323 tokens per session 9389ab401190
- yesterday Changed · +2 lines · +222 tokens per session fb7746d46440
- 20d ago Changed · +58 lines · +1,207 tokens per session 68605717dbfb
- 21d ago Changed · +6 lines · +536 tokens per session d3a72e6e9bb5
- 1mo ago Changed · -51 lines · -5,101 tokens per session 49680881f55b
- 1mo ago Changed · +39 lines · +1,974 tokens per session b9f13587337d
- 1mo ago Changed · +1 lines · +328 tokens per session d68c34b19488
- 1mo ago Changed · +68 lines · +5,014 tokens per session e912d9a1d152
- 1mo ago Changed · +1 lines · +598 tokens per session 93e975edfb07
- 1mo ago First seen · 167 lines · 6,493 tokens per session scan A ccd9d1800726
Halo-Theme-Ethereal AGENTS.md is an instructions file published in the GitHub repository AloneNanNan/Halo-Theme-Ethereal (28 stars, last pushed today), licensed MIT. It adds 11,594 tokens to every session, about $0.0464 per session on Opus 5.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.
Halo-Theme-Ethereal AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| Halo-Theme-Ethereal AGENTS.mdAloneNanNan/Halo-Theme-Ethereal | Instructions file | 28 | today | MIT | A | 11,594 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,516 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 275k | 3d ago | MIT | A | 4,313 | Codex, OpenCode |