AGENTS.md@packages/pluginsA
AGENTS.md@packages/plugins from maomaochong-ai/open-astravia is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add maomaochong-ai/open-astravia/packages/plugins/AGENTS.md@git:20261014.fd1144bPins git:20261014.fd1144b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- maomaochong-ai/open-astravia
- Path
packages/plugins/AGENTS.md- Versions recorded
- 5
- Latest version
- git:20261014.fd1144b, committed Oct 14, 2026
- First version recorded
- Sep 18, 2026
- Size
- 16,416 bytes
- Repository stars
- 39
- License
- Apache-2.0
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Plugin Development Rules 本目录中的包统一属于仓库根 workspace。创建或修改以下内容时，必须遵守本文件： - `plugin-sdk/`：插件运行时 API 和类型契约。 - `plugin-vite/`：插件 Vite、Module Federation 和 zip 打包工具。 - `presets/<id>/`：随 Astravia Desktop 发布的系统插件。 - `externals/<id>/`：不随 App 打包、供用户安装的外置插件。 - `tenants.json`：按业务租户划分系统插件的打包清单（见下）。 修改子目录文件前仍需继续读取更具体的同级或下级说明文件（如存在）。 ## 相关文档 - [Module Federation 共享依赖约定](./docs/module-federation.md)：说明 `astraviaPluginFederation` 的宿主共享依赖、构建期本地依赖要求、顶层求值限制和验证方式。 ## 改动对外合同时必须同步文档 **判据**：改动会不会让仓库外的插件作者写出不一样的代码？会，就落在本节。包括 `plugin-sdk` 的公开类型与 manifest Schema、`plugin-vite` 的构建约定、宿主对清单字段的解析行为、 以及 `plugin-cli` 的命令与输出。纯内部重构、仓库内 preset 的业务逻辑不算。 漏同步的代价不对称：**仓库外的作者只能看到手册**。代码合上了而手册没跟上，他们会照着旧手册写出 编译不过、或者能编译但装不上的东西，而且这种错误只在别人机器上复现。 ### 唯一真源：`docs/plugin/` 手册写在仓库根的 `docs/plugin/`，**不要在别处维护副本**。它有两个自动出口： | 出口 | 机制 | 到达谁 | | --- | --- | --- | | npm tarball | `plugin-sdk/scripts/bundle-docs.mjs` 在 `plugin-sdk` 的 `build` 里跑，把整个目录拷进包 | 插件工程的 `node_modules/@astravia-org/plugin-sdk/docs/`，由 `astravia-plugin-cli docs` 解析 | | 插件工作台 | 工作台内置 `plugin-cli`（`bundle-cli.mjs`），由它解析上面那份 | 工作台里开发的插件 | 两条都是构建期自动的，**不需要手工拷贝**。改 `docs/plugin/` 就够了。 ### 一次对外合同改动要动的东西 按顺序过，缺一项都会让作者在某个环节卡住： …
Read the whole file at its exact version.
How to install
mdr add maomaochong-ai/open-astravia/packages/plugins/AGENTS.md@sha256:89e37d94039f77daThe line at the top of this page pins the label git:20261014.fd1144b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_hiovso33ar5rnvnd)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 18, 2026 and Oct 14, 2026, about one every 7 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261014.fd1144b latest | 2026-10-14 | fd1144b | 16,416 B | A | view · diff |
| git:20261008.acb5654 | 2026-10-08 | acb5654 | 16,323 B | A | view · diff |
| git:20261001.0ce1911 | 2026-10-01 | 0ce1911 | 16,182 B | A | view · diff |
| git:20260919.c82cd04 | 2026-09-19 | c82cd04 | 16,089 B | A | view · diff |
| git:20260918.31cb4cf | 2026-09-18 | 31cb4cf | 16,056 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (16416 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
maomaochong-ai/open-astravia · 39 stars · license Apache-2.0 · pushed 2026-11-01 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_hiovso33ar5rnvnd GET https://markdownregistry.com/api/v1/resolve?ref=maomaochong-ai/open-astravia/packages/plugins/AGENTS.md GET https://markdownregistry.com/api/v1/blob/89e37d94039f77da347f96935abdc00215afba5319dae556cb8538eb48911550
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.