# AGENTS.md

## 基本要求

- 回答、审查结论和任务说明使用简体中文。
- 默认缩进为 4 个半角空格；遵循已有文件格式化规则。
- 修改前先阅读相关代码、配置和文档；更深层级的 `AGENTS.md` 优先。
- 避免无关重构、格式化或元数据变更。
- 不删除或覆盖用户已有改动；不确定时先确认或绕开。
- 避免在项目中硬编码。URL、版本、主题色、公开路径和产品名优先使用已有配置或集中常量。

## 项目定位

- ALCOMD3 已作为独立项目维护，当前代码、文档、发布流程和用户体验以 ALCOMD3 自身为准。
- 外部改动只做选择性引入。安全修复、数据损坏修复、VRChat/VPM 兼容性修复和重要崩溃修复优先。
- 不要机械套用其他项目的结构或流程。涉及 GUI、MCP、操作状态、资源锁、取消机制或仓库管理的改动，应按 ALCOMD3 当前架构重新评估和适配。

## 兼容性边界

- 不要随意修改 Tauri identifier、安装目录、主程序文件名、协议名、用户数据路径或 `vrc-get` 兼容路径。
- `vrc-get-gui/`、`vrc-get-vpm/`、`vrc-get/` 等命名目前具有历史和兼容成本，不作为普通清理项重命名。
- ALCOMD3 updater 使用 ALCOMD3 自有 endpoint 和签名材料，不复用非 ALCOMD3 的发布配置、secret 或 updater metadata。
- MCP 默认关闭，仅使用本地 stdio bridge 和本机 IPC，不应引入网络监听。

## 开发与验证

- Rust 改动按影响范围运行 `cargo check`、`cargo test` 或更聚焦的包级命令。
- GUI 改动按影响范围运行 `npm.cmd run check`、`npm.cmd run lint`、`npm.cmd run build` 或更聚焦验证。
- Website 改动需同时遵循 `website/AGENTS.md`，并按影响范围运行 `npm.cmd run check`、`npm.cmd run build`。
- 无法验证时说明原因、风险和未覆盖范围。

## 文档与发布

- `docs/README.md` 是统一文档入口；需要定位维护、发布、MCP、格式说明或历史记录时优先从这里进入。
- 处理发布、发布审计、版本准备、GitHub Release、updater metadata、stable/beta channel 或 release notes 任务时，先读取 `docs/skills/alcomd3-release/SKILL.md`，再按 `docs/RELEASE.md` 执行或审计。
- 行为、兼容性、发布流程、MCP 边界或用户可见功能变化，应同步更新文档和 `release-notes/`。
- 发布流程以 ALCOMD3 自己的 `xtask`、文档和 updater 签名流程为准。
- 暂时不维护 GitHub release workflow；如需新增，应作为单独设计和实现任务处理。
