AGENTS.mdB

AGENTS.md from ggg123124/vrchat-assistant is an AGENTS.md file: the standing instructions coding agents read in that repo.

Kind
AGENTS.md file
Repository
ggg123124/vrchat-assistant
Path
AGENTS.md
Audit grade
B, 13 of 14 checks passed
Versions recorded
24
Latest version
git:20261011.1ee76c0, committed Oct 11, 2026
First version recorded
Sep 11, 2026
Size
40,551 bytes
Repository stars
26
License
MIT

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

# VRChat 助手 (vrchat-assistant)

基于 Node.js 的 VRChat 好友在线状态监控服务,配合 Hermes 插件和桌面插件使用,支持自动抓取 OTP 验证码登录。

> 🤖 **AI-first 项目**:本程序只面向 AI Agent 使用与扩展,人类不直接编码;加功能 = 人类向 Agent 提需求 → Agent 实现。开发规范见 [DEVELOPMENT.md](./DEVELOPMENT.md)。

**面向 AI Agent 的配置引导**:以下步骤可由 Agent 自动完成。建议 agent 在本仓库目录内运行(服务目录可自动探测,无需设置环境变量)。

## 安装前检查(Agent 必读)

> ⚠️ **在开始配置步骤 1 之前,Agent 必须先向用户核实以下问题:**

1. **是否安装/使用过 VRCX?**
   - VRCX 是一款流行的 VRChat 第三方工具,会在本地保存好友活动历史、世界缓存、好友备注等数据(SQLite 数据库)。本服务的 `scripts/migrate-vrcx0.mjs` 脚本可从 VRCX 数据库一键导入这些历史数据。
   - 若用户**使用过 VRCX**,继续追问第 2 个问题。
   - 若用户**从未使用过 VRCX**,可跳过数据导入,直接进入「配置步骤」。

2. **是否需要将 VRCX 中的历史数据导入到本系统?**
   - 导入内容包括:好友列表与信任等级、好友备注/昵称、世界缓存、位置变更历史、上下线记录、Avatar 变更、状态/Bio 变更等(详见下表)。
   - 导入是**可选**的——不导入也能正常使用本服务,只是查询历史活动记录时没有迁移前的旧数据。
   - 若用户**需要导入**,在完成「配置步骤」1-3(服务能正常启动)后,运行 `node scripts/migrate-vrcx0.mjs` 导入数据(脚本会自动探测 VRCX 数据库路径和 userId)。
   - **迁移引擎(v1.1.0 起)**:改用 **better-sqlite3**(与主服务同引擎,WAL 模式),已移除旧版 sql.js 整文件重写(该方式曾导致 `SQLITE_CORRUPT`,2026-08-12 实测踩坑后由 PR #10 防呆 + PR #12 根因修复)。服务运行中迁移不再损坏数据库,但仍**建议迁移前停止服务**(避免与服务的实时写入交错)。脚本内置 127.0.0.1:8799 端口检测:检测到服务运行时会给出警告,需加 `--force` 确认后继续(风险自负)。
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ggg123124/vrchat-assistant/AGENTS.md@git:20261011.1ee76c0
Exact content
mdr add ggg123124/vrchat-assistant/AGENTS.md@sha256:0046f3cc7c3e12f0

Pin to a label like 1.0.0, or to a sha256 fingerprint for the exact contents. Either way, the exact version is written to mdr.lock. mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nplkqa7hy2e32j42.svg)](https://markdownregistry.com/a/art_nplkqa7hy2e32j42)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 24 versions of this file, between Sep 11, 2026 and Oct 11, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261011.1ee76c0 latest2026-10-11 1ee76c0 40,551 BB view · diff
git:20261007.a8213c02026-10-07 a8213c0 40,267 BB view · diff
git:20261004.983dd6f2026-10-04 983dd6f 39,724 BB view · diff
git:20261004.69b0b212026-10-04 69b0b21 39,663 BB view · diff
git:20261003.bed18322026-10-03 bed1832 39,447 BB view · diff
git:20261003.ed08c282026-10-03 ed08c28 39,307 BB view · diff
git:20261003.d1e24f82026-10-03 d1e24f8 38,158 BB view · diff
git:20260925.1772e682026-09-25 1772e68 38,016 BB view · diff
git:20260925.bc2ced22026-09-25 bc2ced2 37,720 BB view · diff
git:20260924.d03017b2026-09-24 d03017b 37,183 BB view · diff
git:20260923.12755602026-09-23 1275560 36,464 BB view · diff
git:20260923.6bf05342026-09-23 6bf0534 35,303 BB view · diff
git:20260920.9437e512026-09-20 9437e51 34,459 BB view · diff
git:20260918.b0f99422026-09-18 b0f9942 34,362 BB view · diff
git:20260915.efdc3da2026-09-15 efdc3da 34,318 BB view · diff
git:20260915.04b7cd02026-09-15 04b7cd0 34,298 BB view · diff
git:20260915.a662edd2026-09-15 a662edd 33,899 BB view · diff
git:20260915.720eab82026-09-15 720eab8 33,037 BB view · diff
git:20260915.b1f69be2026-09-15 b1f69be 32,287 BB view · diff
git:20260914.81661712026-09-14 8166171 30,234 BB view · diff
git:20260914.2ed3e452026-09-14 2ed3e45 30,092 BB view · diff
git:20260913.bb021602026-09-13 bb02160 29,203 BB view · diff
git:20260913.77d842e2026-09-13 77d842e 27,821 BB view · diff
git:20260911.4629bbe2026-09-11 4629bbe 27,432 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8799)
  • pass: Size between 200 bytes and 200 KB (40551 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 script tag

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

ggg123124/vrchat-assistant · 26 stars · license MIT · pushed 2026-10-12 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nplkqa7hy2e32j42
GET https://markdownregistry.com/api/v1/resolve?ref=ggg123124/vrchat-assistant/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/0046f3cc7c3e12f047cf35464f74d705577f3469f97acb403bdbb9fd7639e9e8

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.

More from ggg123124/vrchat-assistant

plugin-template SKILL.md skill
ggg123124/vrchat-assistant · docs/plugin-template/SKILL.md
git:20260913.bb02160 · audit C · 26 stars
auth-guard SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/auth-guard/SKILL.md · 公网访问鉴权与安全防护插件,提供 HTTP Bearer/API-Key 访问拦截、Token 密码学生成与公网就绪度状态评估
git:20260825.70281e5 · audit A · 26 stars
emoji-notes SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/emoji-notes/SKILL.md
git:20260905.9067250 · audit C · 26 stars
events SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/events/SKILL.md · VRChat 社区活动聚合插件:多源采集、群组深度挖掘、音乐/VTuber 筛选、双列时区与中文参加方式标准化输出
git:20261003.bed1832 · audit B · 26 stars
friend-removals SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/friend-removals/SKILL.md
git:20260905.d885067 · audit C · 26 stars
presence-status SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/presence-status/SKILL.md
git:20260923.6bf0534 · audit C · 26 stars
redeem SKILL.md skill
ggg123124/vrchat-assistant · plugins/official/redeem/SKILL.md
git:20260920.d898ff6 · audit C · 26 stars
acceptance-orchestrator SKILL.md skill
ggg123124/vrchat-assistant · skills/acceptance-orchestrator/SKILL.md · Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and…
git:20260831.b03c82e · audit A · 26 stars
address-github-comments SKILL.md skill
ggg123124/vrchat-assistant · skills/address-github-comments/SKILL.md · Use when you need to address review or issue comments on an open GitHub Pull Request using the gh CLI.
git:20260831.b03c82e · audit A · 26 stars
booth-purchase-automation SKILL.md skill
ggg123124/vrchat-assistant · skills/booth-purchase-automation/SKILL.md · Buy a real BOOTH item: search, add to cart, confirm, pay, download via browser CDP.
v1.0.0 · audit A · 26 stars
booth-query-display SKILL.md skill
ggg123124/vrchat-assistant · skills/booth-query-display/SKILL.md · Use when the user asks to search/query BOOTH (booth.pm) items, show BOOTH item rankings, or display BOOTH products with…
v1.0.0 · audit B · 26 stars
closed-loop-delivery SKILL.md skill
ggg123124/vrchat-assistant · skills/closed-loop-delivery/SKILL.md · Use when a coding task must be completed against explicit acceptance criteria with minimal user re-intervention across…
git:20260831.b03c82e · audit A · 26 stars

Every file in ggg123124/vrchat-assistant

Other files named AGENTS.md

AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 297,596 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 277,095 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 190,317 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 161,772 stars
AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261012.ac6ef95 · audit A · 141,622 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 135,893 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 125,506 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 111,034 stars

Browse by kind, by grade B, or by owner.