prts-mcp: Instructions file for Claude Code

CLAUDE.md — AI 协作者说明

PRTS-MCP 是面向明日方舟同人创作的 MCP Server，包含 Python 和 TypeScript 两套独立实现；两端均支持 stdio 与 Streamable HTTP。本文件记录每次会话必读的工作流。

相关文档

想看...	去哪里
项目现状、版本状态、仓库结构	STATUS.md
代码规范、反模式、已知陷阱	docs/dev/STYLE.md
全量 E2E 真机测试流程（高风险改动后必跑）	docs/dev/E2E.md
路线图与未来规划	ROADMAP.md
1.x → 2.0 迁移（破坏性变更）	docs/migration-1.x-to-2.0.md
1.7 LTS 维护规则	docs/dev/LTS.md
外部贡献者指南	CONTRIBUTING.md
Python 实现	python/
TypeScript 实现	ts/

动手写代码前先读 docs/dev/STYLE.md；不确定项目欠什么时查 STATUS.md。

---

本机运行时环境（WSL2）

本仓库在当前 WSL2 主机上的已验证入口：

• Shell：交互使用当前 POSIX shell；仓库的 Linux 脚本以 Bash 为执行环境
• Python：由 uv 管理 python/ 项目环境，初始化运行 uv sync --directory python --locked
• Python 命令统一经 uv run --directory python ... 执行，不直接调用 python/.venv，也不依赖 ambient python
• TypeScript：Node.js 要求 >=22，首选 ts/package.json 中的 Volta 版本；默认生产运行时为 Bun >=1.3.14
• WSL 下直接使用 npm / npx

快速检查：

./scripts/check-runtime.sh

完整验证：

./scripts/check-runtime.sh --full

python/uv.lock 是可复现环境的来源。uv 仍会在项目内维护隔离环境，但协作者不直接管理其路径。

---

分支模型

1.7.0 LTS 发布后三条长期分支：

分支	用途	版本号后缀
main	最新稳定发布。当前为 2.7.3	（无）
lts/1.7	1.7.x 长期维护线，从 1.7.0 发布提交创建（EOL 2027-07-02）	（无）
develop	开发集成线。所有非 LTS 改动 PR 到这里	.dev0（当前目标为 2.8.0.dev0）

合并方向：

feat/refactor/perf/docs/* ───────→ develop
release/* ───────────────────────→ main + develop
fix/docs/*（1.7 LTS）────────────→ lts/1.7 ──→ develop（适用时 cherry-pick）
fix/*（最新稳定 hotfix）────────→ main ──→ develop（forward merge / cherry-pick）

不允许反向合并。允许的同步方向只有：release/* → main、release/* → develop、main → develop（hotfix forward merge）和 lts/1.7 → develop（适用时 cherry-pick / reimplement）。

启动准则

四条硬规则：

• 需明确指令才 Commit。对话里讨论到"要提交"不算指令，必须出现"请提交 / 请 commit / 请开 PR"这类明确祈使句
• 不在长期分支直接工作。所有非 LTS feat / refactor / perf / 非紧急 fix / docs / chore 都 PR 到 develop；1.7.x 兼容性、安全性、数据同步和关键缺陷修复 PR 到 lts/1.7；最新稳定 hotfix 才 PR 到 main
• 不主动 push。即使刚 commit 完，也等用户说"请推"
• 不提交敏感物与本地产物。不提交 secrets、token、凭据、密钥，也不提交本地运行时产物（.venv、node_modules、会话/缓存状态）；安全漏洞细节按 SECURITY.md 私下处理，不在公开 commit / PR / issue 中复现