build: 打通 FastAPI 与 Vue 最小工程、依赖与数据库连接

后端入口、配置、Redis 与 Alembic 迁移就位；前端 Vite 工程可安装可构建。

backend/alembic/versions/add_mcp_usage_guidance_001.py

@@ -0,0 +1,61 @@
+"""
+Copyright 2024-2026 ReplyPier
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+"""Add mcp_tools.usage_guidance
+
+Operator-written notes on what an MCP source holds and how to query it.
+Reaches the model as agno per-toolkit instructions so investigations stop
+inventing index and field names (#318). Nullable with no server default, so
+existing rows stay NULL and their prompts are unchanged.
+
+Revision ID: add_mcp_usage_guidance_001
+Revises: add_openai_compat_ai_model_001
+Create Date: 2026-09-08 00:00:00.000000
+
+"""
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = 'add_mcp_usage_guidance_001'
+down_revision: Union[str, None] = 'add_openai_compat_ai_model_001'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def _has_column() -> bool:
+    """Development databases are shared between feature branches, so the column
+    can already exist by the time this runs. Adding it twice would abort the
+    upgrade."""
+    inspector = sa.inspect(op.get_bind())
+    return any(c['name'] == 'usage_guidance'
+               for c in inspector.get_columns('mcp_tools'))
+
+
+def upgrade() -> None:
+    if _has_column():
+        return
+    op.add_column(
+        'mcp_tools',
+        sa.Column('usage_guidance', sa.Text(), nullable=True),
+    )
+
+
+def downgrade() -> None:
+    if _has_column():
+        op.drop_column('mcp_tools', 'usage_guidance')