Xcode AI 集成模式jihongboo/dsh-apple-mode

dsh-apple-mode

English · 简体中文

DeepSeek Harness（dsh）的 Xcode AI 集成模式 —— 一个 agent preset（模式）+ 安装脚本，让 DSH 会话获得完整的 Xcode AI 能力栈：

- 26 个 Xcode MCP 工具（mcp__xcode__），通过 Apple 官方 mcpbridge 桥接
- Xcode Intelligence 风格的 persona（Swift 优先、工具辅助、解释/改动分流），改编自 IDEIntelligenceChat 提示词模板
- 10 个 Apple 平台技能（SwiftUI、App Intents、安全加固、bounds safety 等），安装时从你自己的 Xcode 本地生成

📌 dsh-plugin 话题仓库。DeepSeek Harness 处于开发者预览阶段，自动化场景请锁定具体版本。

为什么用"模式（preset）"而不是全局接入 MCP？

三样能力在 DSH 里对应三个不同机制：

| 层 | 能力 | DSH 机制 |
|---|---|---|
| 执行 | 26 个 mcp__xcode__ 工具 | dsh-mcp-client（挂在 preset 内） |
| 知识 | 10 个 Apple 技能 | dsh-skill-filesystem（全局、懒加载） |
| 行为 | Xcode Intelligence persona | agent preset（本仓库） |

若把 MCP 全局接入，26 个大工具 schema（约 6k+ tokens/请求）会常驻每一个会话。挂在 preset 内则只有选择该模式的会话背负成本——建会话时选 Apple Mode即获得全套能力，其他会话保持轻量。

环境要求

- macOS
- DeepSeek Harness：npx @deepseek-ai/dsh web
- Xcode 26+（含 mcpbridge 与 xcrun agent skills export）。使用 MCP 工具时，需要保证 Xcode 已启动并打开了相应的项目，并且在 Xcode 弹出的 MCP 接入对话框中点击允许（见使用方法）。

安装

git clone https://github.com/jihongboo/dsh-apple-mode.git
cd dsh-apple-mode
./install.sh

install.sh 做三件事：

1. 检测你机器上的 Xcode，并让你选择由哪个提供 mcpbridge（见下文）。
2. 安装 apple agent preset → ~/.dsh/.agent-presets/apple/（已有副本自动备份）。
3. 通过 xcrun agent skills export 在你机器上本地生成 10 个 Xcode 技能并合并进 ~/.agents/skills/（DSH 技能根目录，watcher 热加载即时生效）。

为什么不直接打包技能？ 技能是 Apple 官方内容。安装时从你自己的 Xcode 生成可以避免重新分发 Apple 内容——仓库只包含我们自己的代码、配置和文档。

选择 Xcode（多版本共存）

如果装了多个 Xcode（如 Xcode.app、Xcode-beta.app、Xcode-26.2.app），mcpbridge 位于各自的 Contents/Developer/usr/bin——且只有 Xcode 26+ 才有。install.sh 会扫描 /Applications 下所有包含 mcpbridge 的安装并提示你选择：

Found Xcode installs providing mcpbridge:
1) /Applications/Xcode-beta.app/Contents/Developer  (xcode-select default)
2) /Applications/Xcode.app/Contents/Developer
Choose (1-2, default 1):

- 默认 = xcode-select 选中的 Xcode → preset 使用 command: xcrun mcpbridge（可移植，跟随 xcode-select 变化）。
- 选择其他 → 所选 …/Contents/Developer/usr/bin/mcpbridge 以绝对路径写进安装后的 preset。
- 非交互：./install.sh --xcode /Applications/Xcode.app（或 --xcode …/Contents/Developer）；./install.sh --list-xcodes 列出候选。
- 运行时切换、无需重装：./install.sh --runtime-selectable 安装 bin/mcpbridge 作为命令；启动 dsh 时设置 DSH_XCODE_DEVELOPER_DIR=/Applications/…/Contents/Developer 即可切换。（解析顺序：DSH_XCODE_DEVELOPER_DIR → xcrun → 最新的 /Applications/Xcode.app。）
- 指定某个正在运行的 Xcode 实例：在安装后的 preset 的 mcp-xcode 行加 env: { MCP_XCODE_PID: '' }。

之后想改：重跑 ./install.sh、编辑 ~/.dsh/.agent-presets/apple/agent.cordis.yml 的 mcp-xcode 行，或用上面的运行时环境变量。

备选：全局 bundle（所有会话接入 MCP）

dsh plugin --profile web add "github:jihongboo/dsh-apple-mode"

安装 cordis.patch.yml bundle，将 Xcode MCP 接入 profile 的所有会话——无需选择模式，代价是所有会话都背负工具 schema 的 token 成本。两种安装方式二选一：二者都注册 serverName: xcode，重复的 server 名会导致后加载的实例失败。详见 docs/global-mcp.md。

使用方法

1. 重启 dsh（或直接新建会话——preset 只能在空白会话选择）。
2. 建会话时选择 Apple Mode。
3. 该会话即可使用：
- mcp__xcode__ 工具——直接操作打开的 Xcode 工作区：XcodeRead/Write/Update/MV/RM、XcodeGlob/Grep/LS、UpdateTargetBuildSetting/UpdateFileCompilerFlags、XcodeListNavigatorIssues、scheme/运行目标/测试计划切换、XcodeNewTarget、StringCatalogRead/Edit 等
- 全部 Apple 平台技能（按需懒加载）
- Apple 优先、工具辅助的工作方式

使用 mcp__xcode__ 工具之前：
1. 需要保证 Xcode 已启动，并且在其中打开了要操作的项目/工作区。
2. 首次建立连接时，Xcode 会弹出 MCP 接入对话框——请点击允许。在点击允许之前，工具调用会被拒绝。

构建/运行/测试仍在终端进行（xcodebuild，建议管道到 xcsift 获得结构化输出）；MCP 工具集负责工程手术、构建设置、诊断、运行目标与本地化。

内容清单

MCP 工具（26 个，命名空间 mcp__xcode__）

| 分组 | 工具 |
|---|---|
| 工程读写 | XcodeRead XcodeWrite XcodeUpdate XcodeMV XcodeRM XcodeMakeDir |
| 检索 | XcodeGlob XcodeGrep XcodeLS |
| 目标与设置 | XcodeNewTarget XcodeListTemplates XcodeListTargets UpdateTargetBuildSetting UpdateFileCompilerFlags |
| Scheme/运行/测试 | XcodeListSchemes XcodeSwitchScheme XcodeListRunDestinations XcodeSwitchRunDestination XcodeListTestPlans XcodeSwitchTestPlan |
| 诊断 | XcodeListNavigatorIssues XcodeRefreshCodeIssuesInFile |
| 本地化 | StringCatalogRead StringCatalogEdit |
| 窗口 | XcodeListWindows XcodeGetCurrentFile |

技能（10 个，安装时生成）

swiftui-specialist · swiftui-whats-new-27 · app-intents-specialist · app-intents-whats-new-27 · audit-xcode-security-settings · adopt-c-bounds-safety · uikit-app-modernization · modernize-tests · device-interaction · building-document-based-swiftui-applications

仓库结构

.
├── presets/apple/            # agent preset：agent.cordis.yml + preset.yml
├── bin/mcpbridge             # 运行时切换用的 mcpbridge 启动器（--runtime-selectable）
├── cordis.patch.yml          # 全局 MCP bundle 补丁（dsh plugin add）
├── package.json              # bundle manifest（dsh.bundle.patch）
├── docs/
│   ├── XCODE_AI_INTEGRATION.md  # 完整接入说明（中文）
│   └── global-mcp.md            # 全局 bundle 与 preset 的取舍
├── install.sh               # 安装 preset + 本地生成技能
├── uninstall.sh
└── LICENSE                  # MIT

自定义

- 更换 Xcode：重跑 ./install.sh（选择器）、./install.sh --xcode （非交互）、--runtime-selectable + DSH_XCODE_DEVELOPER_DIR，或在 mcp-xcode 行加 env: { MCP_XCODE_PID: '' } 指定某个正在运行的实例。详见选择 Xcode（多版本共存）。
- persona：编辑同文件的 persona 行文本。
- Xcode 升级后同步技能：重跑 ./install.sh（技能整体替换，preset 自动备份）。
- 对齐上游 standard preset：与 node_modules/@deepseek-ai/dsh/config/agent-presets/standard/agent.cordis.yml 做 diff。

安全说明

- MCP 工具调用不经过 DSH 文件沙箱，走工具级审批流程。XcodeUpdate/XcodeWrite 会直接修改真实 Xcode 工程文件（含 project.pbxproj）。
- preset 仅在你主动选择时激活；install.sh 不触碰任何全局配置。

参与贡献

欢迎 PR 与 issue。如果你发布自己的 DSH 扩展，请打上 dsh-plugin 话题，并考虑提交到 awesome-dsh-plugin。

许可证

MIT。Xcode AI 技能由安装脚本在你的机器上从你自己的 Xcode 生成，仍受 Apple 许可约束；persona 提示词风格改编自 Xcode Intelligence 模板（行为指导，非 Apple 源码文本）。