#示例项目：Git Desk

状态：已实现
配套仓库：https://gitee.com/phodit/git_desk

Git Desk 与 5xAI集成平台通过 两条正交通道 对接：

设置中：软件连接 看谁连上、看 AI 过程；MCP 连接 配置 Git Desk MCP。顶栏「N 个集成工具已连接」进入软件连接页。

┌─────────────────────┐      MCP stdio       ┌──────────────────────┐
│  5xAI集成平台        │ ◄─────────────────── │  Git Desk MCP        │
│  MCP 连接 / Agent   │   integration.{id}.* │  mcp/server.py       │
│                     │                      └──────────────────────┘
│  软件连接 :14220    │   HTTP               ┌──────────────────────┐
│  register / chat /  │ ◄─────────────────── │  Git Desk 桌面端      │
│  stream / action    │   主动登记 + 心跳     │  连接 AI 服务 / 总结  │
└─────────────────────┘                      └──────────────────────┘

软件连接 ≠ MCP 已连接。Agent 操控须在 设置 → MCP 连接 中连接 Git Desk MCP。

#1. 准备工作

1. 启动 5xAI集成平台，选好模型
2. 启动 Git Desk
3. 状态栏 连接 AI 服务 / 已连接 AI 服务；默认 localhost:14220
4. 齿轮设置：IP/端口、测试连接、自动连接

#clientId（须一致）

register 与每次 chat / summarize-commit 必须相同。可在 软件连接 → 记忆分区 挂接私域「代码提交」。详见 私域、记忆分区 API。

#2. Git Desk → 本应用（软件连接）

#AI 总结

开发 Tab → AI 总结 → POST /api/host/summarize-commit

#对话示例

curl -s -X POST http://localhost:14220/api/host/chat ^
  -H "Content-Type: application/json" ^
  -d "{\"clientId\":\"git-desk\",\"prompt\":\"根据 diff 写 commit message\",\"purpose\":\"commit\"}"

#Action 示例

curl -s -X POST http://localhost:14220/api/host/memory/search ^
  -H "Content-Type: application/json" ^
  -d "{\"clientId\":\"git-desk\",\"query\":\"提交规范\"}"

过程在 设置 → 软件连接 查看；挂接私域后在 私域 页刷新「记忆」统计。协议见 软件连接 API。

#3. 本应用 → Git Desk（MCP 连接）

#社区预设

1. 设置 → MCP 连接 → 社区 Server → Git Desk
2. mcp/server.py 绝对路径，工作目录 mcp/
3. 连接

#手动配置

pip install -r git_desk/mcp/requirements.txt

#Agent 工具示例

integration.git-desk.open_repo
integration.git-desk.get_commit_context
integration.git-desk.commit_with_message
integration.git-desk.release_compare_pipeline

Resource：integration://git-desk/state

#4. 多工具约定

• 只一个 AI 服务实例（14220 独占）
• 每工具不同 clientId；登记与请求一致
• 主动 register + heartbeat
• 写文件 / Shell 不在软件连接白名单 → 用 MCP 或应用内 Agent

#相关链接

• 集成概览 · MCP 连接 · 已废弃能力
• 私域 · 记忆分区 API
• 软件连接 API