Agent-Guidance-Python

# Agent Guidance MCP  [](https://www.python.org/) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io/)   [](https://ko-fi.com/JunMystery) <img src="docs/images/hero-banner.png" alt="Agent Guidance MCP"> MCP 服务器通过 **185 种技能目录**、捆绑的引导语料库、工作流提示、限定项目代码上下文工具和 **token 优化引擎** 提供 AI 代理引导服务 — 所有服务均通过 **Stdio** 传输。 > ⚡ **寻找超快速 Rust 版本 (< 1ms 启动，~35MB RAM)？** 请查看 [Agent-Guidance-Rust](https://github.com/JunMystery/Agent-Guidance-Rust)！ --- ## 安装 通过单个命令安装 Agent Guidance MCP 服务器并配置所有本地 IDE 客户端： **Linux / macOS (Bash)：** ```bash curl -fsSL https://raw.githubusercontent.com/JunMystery/Agent-Guidance-Python/main/scripts/install.sh | bash ``` **Windows (CMD / PowerShell)：** ```cmd powershell -Command "irm https://raw.githubusercontent.com/JunMystery/Agent-Guidance-Python/main/scripts/install.ps1 | iex" ``` *不需要事先安装 Python — 脚本会自动引导 `uv`（一个单二进制 Python 工具链）。* ### 验证安装 使用 MCP Inspector 在本地进行测试： ```bash DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector .venv/bin/python -m agent_guidance_mcp ``` 然后调用 `agent-guidance-mcp_task_pipeline(...)` 加载引导和限定项目上下文。有关工作流，请参见 [使用指南](docs/usage.md)。 ### 升级 **服务器 + IDE 注册：** 重新运行上述安装命令。 **标准目录和技能：** ```bash agent-guidance-mcp --update ``` **可执行包：** ```bash uv tool update agent-guidance-mcp ``` ### 调度自动更新 ```bash agent-guidance-mcp --auto-update # 每周（默认） agent-guidance-mcp --auto-update monthly # 每月 ``` 或通过环境变量：`AGENT_AUTO_UPDATE_INTERVAL=weekly` ### 卸载 **Linux / macOS：** ```bash curl -fsSL https://raw.githubusercontent.com/JunMystery/Agent-Guidance-MCP/main/scripts/install.sh | bash -s -- --uninstall ``` **Windows：** ```cmd powershell -Command "irm https://raw.githubusercontent.com/JunMystery/Agent-Guidance-MCP/main/scripts/uninstall.ps1 | iex" ``` ### 手动 / 开发者安装 ```bash python -m venv .venv .venv/bin/pip install -e ".[dev]" # Linux / macOS .venv\Scripts\pip install -e ".[dev]" # Windows ``` ```bash agent-guidance-mcp .venv/bin/python -m agent_guidance_mcp # Linux / macOS .venv\Scripts\python.exe -m agent_guidance_mcp # Windows ``` 自定义语料库路径： ```bash AGENT_GUIDANCE_ROOT=/path/to/Agent-Guidance ``` 平台说明：[安装](docs/installation.md) · [客户端设置](docs/setup/client-configuration.md) --- ## 支持的 IDE 与任何 MCP 兼容的客户端配合使用。安装程序自动配置： | Claude Desktop / Claude Code | Cursor | VS Code (Copilot) | | OpenCode / OMO | Gemini CLI | Windsurf | | Cline / Roo-Code | Continue.dev | Antigravity | --- ## MCP 接口 <img src="docs/images/tool-surface.png" alt="MCP Tool Surface" width="50%"> ### 工具 | 工具 | 门控 | 角色 | 关键操作 | |---|---|---|---| | `agent-guidance-mcp_task_pipeline` | **解锁** | **调用第一个** — 上下文准备 | 推荐 + 树 + 搜索 + UI + 执行序列 | | `agent-guidance-mcp_guidance` | 门控 | 标准和技能目录 + 工作流/预代码/验证/反馈 | `list`, `get`, `search`, `recommend`, `reason`, `docs`（Context7），`workflow`, `precode`, `verify`, `feedback` | | `agent-guidance-mcp_project_context` | 门控 | 项目文件操作 + 3 级搜索 | `tree`, `search`（FTS5 文档配置常规），`read`, `symbols`, `references`, `structure`, `callers`, `callees`, `diff`, `snapshot` | | `agent-guidance-mcp_ui_ux` | 门控 | 设计引导 | `search`, `design_system`, `slides` | | `agent-guidance-mcp_session_continuity` | 门控 | 任务状态持久性 | `save`, `load`, `clear` | | `agent-guidance-mcp_workflow_gate` | 门控 | 阶段强制 | `status`, `check`, `set_stage` | | `agent-guidance-mcp_require_edit_approval` | 不门控 | 编辑权限门控 | `project_path` | | `agent-guidance-mcp_usage_report` | 不门控 | 使用情况统计 | `session`, `all` | | `agent-guidance-mcp_health_check` / `agent-guidance-mcp_diagnose` / `agent-guidance-mcp_token_stats` | 白名单 | 操作 | 服务器状态，自诊断，token 节省 | 门控工具如果在 `agent-guidance-mcp_task_pipeline` 之前调用，将返回 `PRIORITY_REQUIRED`。白名单工具绕过门控。 ### 资源 | URI | 描述 | |---|---| | `standards://manifest` | 索引标准清单（JSON） | | `standards://skill/{name}` | 按需技能胶囊（Markdown） | | `standards://document/{identifier}` | 按 slug 的标准文档（Markdown） | | `standards://version` | 服务器版本信息（JSON） | | `agent-guidance-mcp://system/priority` | 优先级门控指令 — 由 `PRIORITY_REQUIRED` 错误返回 | | `agent-guidance-mcp://system/gate` | 优先级门控状态：已通过 + 存在哨兵（JSON） | | `agent-guidance-mcp://system/edit-allowed` | 基于工作流阶段的编辑权限检查（JSON） | ### 工作流（合并到 `guidance`） `agent-guidance-mcp_guidance(operation="workflow", identifier="<mode>", query="<subject>")` — 按模式加载工作流：plan，test，deploy，debug 等。以前的 `workflow` / `workflow_prompt` 工具已合并到 `guidance`。 有关阶段生命周期管理（`workflow_gate`），请参见 [工作流阶段强制](#工作流阶段强制) 部分。 --- ## 为什么选择 Agent Guidance MCP AI 编码代理的上下文窗口迅速耗尽。每次文件读取、每次 grep、每次网络搜索都会消耗上下文 — 而当上下文消失时，代理会忘记一切。Agent Guidance MCP 通过四层解决这个问题： | 层 | 功能 | 收益 | |---|---|---| | **优先级强制** | `agent-guidance-mcp_task_pipeline` 必须在门控工具（guidance，project_context，ui_ux，session_continuity，workflow_gate）之前调用。会话启动钩子自动通行证。 | 代理在行动前始终具有项目上下文。不会再出现“忘记调用 task_pipeline” | | **上下文预算** | 文件读取限制在 300 行；智能截断源代码以保留结构 | 代理专注于相关代码，永远不会淹没在噪音中 | | **引导目录** | 185 种技能 + 编码标准 + 安全规则按需提供 | 代理遵循生产模式，无需您提醒 | | **Token 优化** | 在 LLM 到达之前剥离注释、折叠空格、重复输出 | **每个 MCP 响应减少 40–80% 的 token** | ### 节省 在典型的 500 行 React 组件重构任务上测量： <img src="docs/images/token-savings-chart.png" alt="Token Savings Comparison" width="65%"> ``` 无 MCP 使用 Agent Guidance MCP ───────────── ────────────────────── 工具往返次数 12–18 次 4–6 次（task_pipeline 合并） 使用上下文 ~45,000 token ~12,000 token 文件读取次数 8+ 次完整读取 3 次上限读取（每次数 300 行） 标准查找 手动 / 猜测 通过 guidance() 自动 死胡同 2–3 次错误搜索 零（搜索优先策略） 到首次修复的时间 ~4 分钟 ~45 秒 ``` ### Token 优化管道 每个 MCP 响应通过 8 阶段过滤器： <img src="docs/images/token-pipeline.png" alt="Token Optimization Pipeline" width="40%"> ``` 原始响应 │ ├─ 阶段 1 ANSI 剥离 ── 删除终端颜色代码 ├─ 阶段 2 正则表达式替换 ── 折叠噪音模式 ├─ 阶段 3 匹配/短路 ── 跳过空负载 ├─ 阶段 4 行过滤器 ── 仅保留相关输出行 ├─ 阶段 5 智能截断 ── 保留导入、签名、常量 ├─ 阶段 6 头/尾保留 ── 前 N 行和后 N 行，带有省略标记 ├─ 阶段 7 最大行限制 ── 绝对上限 └─ 阶段 8 空保护 ── 如果一切都被过滤，则回退消息 │ ▼ 优化响应（小 40–80%） ``` ### 语义技能搜索和本地工作区技能 Agent Guidance MCP 采用混合语义搜索引擎，旨在根据意图和任务上下文动态加载相关技能。 - **预计算嵌入**: 185 个全局目录技能具有使用轻量级 `intfloat/multilingual-e5-small` 模型预计算的嵌入。这确保在启动时即时检索。 - **本地工作区技能**: 服务器自动扫描项目工作区中的自定义本地技能，定义在 `.agents/skills/`、`.opencode/skills/` 或 `.claude/skills/` 目录中，在启动时动态嵌入，并合并到搜索索引中。 - **混合相似性排名**: `agent-guidance-mcp_guidance(operation="search")` 将传统关键词匹配与向量余弦相似性计算相结合，以准确排名技能，即使任务查询不包含确切的关键词重叠（例如，将“减少上下文大小”与 `context-budget` 技能匹配）。 - **零配置下载**: 查询嵌入模型在服务器第一次运行时按需自动下载，无需手动设置或配置。 --- ## 优先级强制 Agent Guidance MCP 确保 `agent-guidance-mcp_task_pipeline` 始终在任何门控工具之前调用，适用于所有代理和 IDE。 ### 三层强制 ``` 会话开始 │ ├─ 层 1：会话启动钩子 │ hooks/session-start.sh → agent-guidance-mcp --session-start │ → 写入 ~/.agent-guidance/.gate_passed 哨兵文件 │ → 将项目上下文注入对话 │ ├─ 层 2：持久哨兵文件 │ MCP 服务器启动 → 读取哨兵 → 门控预先通过 │ 连接钩子进程和服务器进程 │ └─ 层 3：进程内门控 task_pipeline → priority_gate_pass() 解锁门控 门控工具 → priority_gate_check() 阻止如果未通过 ``` ### 工具门控状态 | 工具 | 门控行为 | |---|---| | `agent-guidance-mcp_task_pipeline` | **解锁门控** — 调用第一个以启用所有门控工具 | | `agent-guidance-mcp_guidance`, `agent-guidance-mcp_project_context`, `agent-guidance-mcp_ui_ux`, `agent-guidance-mcp_session_continuity`, `agent-guidance-mcp_workflow_gate` | **门控** — 如果在 `agent-guidance-mcp_task_pipeline` 之前调用，返回 `PRIORITY_REQUIRED` 错误 | | `agent-guidance-mcp_require_edit_approval`, `agent-guidance-mcp_usage_report` | **不门控** — 始终可调用，无优先级检查 | | `agent-guidance-mcp_health_check`, `agent-guidance-mcp_diagnose`, `agent-guidance-mcp_token_stats` | **白名单** — 始终可用，无门控检查 | ### 每个阶段重置规则 对于每个新工作阶段（计划 → 实现 → 测试 → 审查 → 重构），请使用阶段目标重新调用 `agent-guidance-mcp_task_pipeline`。这会刷新技能推荐、项目上下文和新范围的执行序列。该规则通过 `AGENTS.md` 和 `SKILL.md` 文件部署到所有 IDE。 ### 会话启动钩子 每个支持的 CLI 代理都会触发一个会话启动钩子，该钩子会自动调用 `agent-guidance-mcp --session-start --project-path .`。这会： 1. 构建技能目录 2. 通过（写入哨兵文件）优先级门控 3. 为默认上下文运行 `agent-guidance-mcp_task_pipeline` 4. 返回一个 JSON 有效负载，注入对话中 钩子尝试：已安装二进制 → `python -m agent_guidance_mcp` → 传统元技能回退。 ### 标记部分部署 规则块和技能内容用 HTML 注释标签包装 (`<!-- agent-guidance:start -->` / `<!-- agent-guidance:end -->`)。`--setup` 命令使用这些标签查找和替换所有 IDE/CLI 配置文件中的部分 — 无过时副本，无需手动清理。 ### 工作流阶段强制 除了优先级门控外，Agent Guidance MCP 还强制执行一个 **7 阶段工作流生命周期**，该生命周期门控文件编辑： `Context → Plan → Ask_Revise → Build → Test_Recheck → Fix → Proposal` | 阶段 | 允许编辑？ | 什么门控阻止 | |---|---|---| | `Context` | 否 | 除 `task_pipeline`、 `workflow_gate` 和 `session_continuity` 之外的所有工具 | | `Plan` | 否 | `project_context` 上的 `diff` 和 `architecture` 操作 | | `Ask_Revise` | 否 | 代码读取（`read`、`search`、`symbols`、`references`、`structure`、`callers`、`callees`、`diff`）和 `precode` / `verify` | | `Build` | ✅ 是（如果批准） | 如果 `plan_approved=false`，则阻止所有工具 | | `Test_Recheck` | 否 | `precode` 操作 | | `Fix` | ✅ 是 | 如果失败 3 次，则电路中断器重置为 `Ask_Revise` | | `Proposal` | 否 | `diff`、`structure`、`symbols` 操作 | **阶段管理工具：** | 工具/资源 | 目的 | |---|---| | `agent-guidance-mcp_workflow_gate(action="status")` | 查看当前阶段、计划批准、修复尝试次数 | | `agent-guidance-mcp_workflow_gate(action="check", user_message=...)` | 从自然语言中解析用户批准（“继续”、“确定”、“执行”） | | `agent-guidance-mcp_workflow_gate(action="set_stage", target_stage=...)` | 转换到新阶段（验证规则 + 电路中断器） | | `agent-guidance-mcp_require_edit_approval(project_path=...)` | 最终门控检查 — 除非阶段为 `Build` 且 `plan_approved=true`，否则返回错误 | | `agent-guidance-mcp://system/edit-allowed` | 只读资源，用于低摩擦权限检查（JSON） | **电路中断器**：如果代理无法修复问题 3 次（3 次转换为 `Fix`），则阶段自动重置为 `Ask_Revise` 且 `plan_approved=false`，强制重新批准后再进行任何编辑。 `require_edit_approval` 工具和 `agent-guidance-mcp://system/edit-allowed` 资源共同形成 **编辑门控** — 可由代理在写入/编辑/ bash 之前调用以确认工作流阶段允许编辑。 --- ## 实践中的工作原理 ### 场景：“在我的 Express API 中添加 JWT 身份验证” **步骤 1 — 代理调用 `agent-guidance-mcp_task_pipeline`（一次调用） ``` Agent: task_pipeline(task="Add JWT auth to Express API", focus="backend") ``` 返回单个响应： - **推荐**: 8 种相关技能（api-design、security-review、backend-patterns、express-patterns...） - **项目树**: Express 项目目录结构 - **代码搜索**: 预先检索的结果为“auth”、“jwt”、“token”、“middleware” - **执行顺序**: 生命周期顺序排列的技能（spec → plan → build → test → review） **步骤 2 — 代理咨询标准** ``` Agent: guidance(operation="search", query="JWT authentication middleware Express") ``` 返回：security-review 技能、api-design 模式、OWASP auth 秘籍 — 所有预加载，无需网络搜索往返。 **步骤 3 — 代理使用三级回退搜索代码库** ``` Agent: project_context(operation="search", query="JWT middleware auth") ``` 返回按三级管道排序的结果： - **一级**: 文档和清单（README、ARCHITECTURE.md、pyproject.toml）— 快速、高信号 - **二级**: 配置、入口点、测试目录（Dockerfile、main.py、src/）— 结构上下文 - **三级**: 常规代码文件，限制 300 行 — 速度慢，仅在前两级未命中时才访问 FTS5（SQLite 全文索引）解决约 90% 的查询，瞬间绕过所有三个备用层。只有当 FTS5 为空或索引未就绪时，才会触发三级备用。 **步骤 4 — 代理使用实时文档实施** ``` Agent: guidance(operation="docs", query="jsonwebtoken sign options", identifier="node-jsonwebtoken") ``` 返回：Context7 中的当前 `jsonwebtoken` API 文档 — 没有臆造的 API 调用。 **结果**: 代理在大约 3 次调用中编写生产级 JWT 中间件，而不是 15+ 次，并具有自动的安全审查意识。 --- ## 用量仪表盘 Agent Guidance MCP 包含一个轻量级的使用情况仪表盘，用于可视化每次会话的工具调用、token 节省、技能加载和嵌入查询。 ### 启动仪表盘 ```bash # 独立仪表盘服务器（无需 ML 模型，纯标准库） agent-guidance-mcp --dashboard # 仪表盘：http://127.0.0.1:<port>/ ``` ### 自动跟踪的数据 | 数据 | 通过 | 显示在仪表盘中 | |------|-------------|-------------------| | 工具调用 | 每次 `agent-guidance-mcp_task_pipeline`、`agent-guidance-mcp_guidance`、`agent-guidance-mcp_project_context`、`agent-guidance-mcp_ui_ux`、`agent-guidance-mcp_session_continuity` 调用 | 操作日志视图 | | Token 节省 | 每个工具的原始 token 计数与优化 token 计数 | Token 节省视图 | | 技能加载 | `agent-guidance-mcp_guidance(get)`、`standards://skill/{name}` 资源 | 仪表盘视图 | | 嵌入查询 | `agent-guidance-mcp_guidance(search)`、`agent-guidance-mcp_guidance(recommend)` | 嵌入状态视图 | | 会话标识 | `AGENT_CLIENT_NAME` 环境变量或 `--client-name` 标志 | 会话选择器 | ### 仪表盘视图 | 视图 | 内容 | |------|---------| | 仪表盘 | 会话摘要卡片、技能列表、嵌入状态 | | 操作日志 | 实时更新的工具调用表格，每 5 秒轮询 | | Token 节省 | 会话节省百分比 + 生命周期原始/优化/节省条 | | 嵌入状态 | 模型加载状态、活跃客户端（后台模式）、总嵌入查询 | | 快速指南 | 4 步工作流程参考（任务流程 → 指导 → 项目上下文 → 会话连续性） | | MCP 工具 | 完整的工具参考，带有网关状态和操作 | 数据持久化到项目目录中的 `.agent-context/usage.db`，并在服务器重启后保留。 --- ## 环境变量 | 变量 | 目的 | 默认值 | |---|---|---| | `AGENT_GUIDANCE_ROOT` | 自定义标准语料库路径 | 捆绑语料库 | | `AGENT_PROJECT_ROOT` | 重写上下文工具的项目根目录 | `.`（当前工作目录） | | `AGENT_PROJECT_ALLOWED_ROOTS` | 安全的白名单目录 | 仅项目根目录（设置为展开） | | `AGENT_EMBEDDING_DAEMON` | 禁用嵌入守护进程（强制进程内模型） | `1`（启用） | | `AGENT_WATCHER_ENABLED` | 启用/禁用 CodeGraph 文件监视器 | `true` | | `AGENT_WATCHER_INTERVAL` | 监视器轮询间隔（秒） | `30` | | `AGENT_WATCHER_DEBOUNCE_MULTIPLIER` | 更改后的去抖动乘数 | `2.0` | | `AGENT_WATCHER_REF_THRESHOLD` | 完整引用解析的批量大小 | `50` | | `AGENT_AUTO_UPDATE_INTERVAL` | 通过环境变量自动更新调度 | `weekly` | | `--auto-update` / `--update` | 用于手动更新和模型下载的 CLI 标志 | — | | `--session-start` | 用于会话启动钩子自动激活的 CLI 标志 | — | | `--embed-daemon` | 以前台进程启动嵌入守护进程 | — | | `--dashboard` | 启动使用仪表盘服务器 | — | | `--re-gate` | 为子代理恢复重新传递优先级网关 | — | | `--no-optimize` | 禁用 token 优化和节省跟踪 | — | 有关完整的工具文档、响应格式和示例，请参阅 [MCP Surface](docs/reference/mcp-surface.md)。 --- ## 文档 - [快速入门](docs/getting-started.md) — 首次使用教程。 - [安装](docs/installation.md) — 自动和手动设置。 - [使用指南](docs/usage.md) — 推荐的代理工作流程和示例。 - [客户端设置](docs/setup/client-configuration.md) — VS Code, Copilot, Cursor, Gemini, OpenCode, Windsurf, Antigravity. - [MCP Surface](docs/reference/mcp-surface.md) — 所有工具、提示和资源。 - [项目上下文工具](docs/reference/project-context-tools.md) — 树、搜索、读取、快照、符号、引用。 - [技能概述](docs/skills/SKILLS_OVERVIEW.md) — 完整的 185+ 技能目录。 - [集成仓库](docs/integrations/integrated-repositories.md) — 代码库中的第三方仓库。 - [多 IDE 指南](docs/integrations/multi-ide.md) — 内存使用、SSE 模式和建议。 - [开发指南](docs/development.md) — 测试、项目结构和维护者笔记。 - [MCP 集成指南](agent-guidance/mcp-integrations/README.md) — SQLite 缓存、CodeGraph、Context7 文档。 --- ## 多 IDE 使用 每个 IDE/CLI 都启动自己的 MCP 服务器子进程，但**嵌入模型通过本地 HTTP 守护进程共享** — 每个用户一个，每个模型加载一个。 ``` VS Code → MCP 进程 A ──┐ Cursor → MCP 进程 B ──┼──► embed_daemon (127.0.0.1) Claude Desktop → MCP 进程 C ──┘ │ [SentenceTransformer] intfloat/multilingual-e5-small ``` **总 RAM**：~466 MB 用于守护进程，与打开的 IDE 数量无关。 ### 工作原理 | 层 | 机制 | |---|---| | **守护进程启动** | 需要嵌入的第一个 MCP 进程获取 `~/.agent-guidance/daemon.lock`（POSIX 上的 fcntl flock，Windows 上的 msvcrt）并启动守护进程子进程 | | **服务发现** | 守护进程在启动时将 `~/.agent-guidance/daemon.json` 写入其端口和 PID | | **客户端连接** | 所有 MCP 进程都将 `http://127.0.0.1:<port>/embed` 发送到 `embed` 进行推理 | | **健康检查** | 守护进程公开 `GET /health` 回声其 PID + `embed_ready` 标志；客户端在重用清单之前进行探测 | | **客户端注册** | 每个 MCP 进程都调用 `POST /register` 及其 PID；守护进程后台回收死亡客户端 | | **自动关闭** | 守护进程在 600 秒空闲或所有客户端断开连接后退出（30 秒宽限期） | ### 哪些工具会触发模型加载 守护进程在第一次调用任何需要嵌入的工具时惰性启动，而不仅仅是 `guidance(search)`： | 工具 | 触发守护进程？ | |---|---| | `agent-guidance-mcp_task_pipeline` | ❌ — 使用预计算的 `skills_embeddings.json` | | `agent-guidance-mcp_guidance(operation="search")` | ✅ — 第一个调用启动守护进程，随后调用重用 | | `agent-guidance-mcp_guidance(operation="list\|get\|recommend")` | ❌ — 仅限目录 | | `agent-guidance-mcp_project_context` | ❌ — 仅文件操作 | | `agent-guidance-mcp_session_continuity` | ❌ — 仅状态 | | `agent-guidance-mcp_health_check / diagnose / token_stats` | ❌ — 服务器信息 | 在第一次调用时，守护进程在 ~1 秒内加载模型。后续调用是已经运行的守护进程的瞬时 HTTP 请求。 ### 回退（守护进程不可用） 如果守护进程无法启动（锁竞争、`AGENT_EMBEDDING_DAEMON=0` 或 pytest 下），每个 MCP 进程都会回退到**进程本地单例** — 每个进程加载自己的 466 MB 模型。这对调用者来说是透明的。 ### SSE 模式（未来） 即使使用共享的嵌入守护进程，每个 MCP 进程仍然运行自己的 stdio 服务器。添加 SSE 传输（`--transport sse`）将允许所有 IDE 共享单个 MCP 守护进程。请参阅 [多 IDE 指南](docs/integrations/multi-ide.md) 以获取详细信息和当前限制。 --- ## 开发 ```bash python -m pytest ``` 测试套件验证了目录发现、MCP 处理程序注册、标准搜索、推荐行为、项目上下文工具（18 个测试）和优先级 + 工作流程网关强制（13 个测试，涵盖阻止/通过/重置/线程安全/哨兵持久性/编辑批准）。请参阅 [开发指南](docs/development.md) 以获取更多详细信息。