- Cursor 全局 MCP 配置:
%USERPROFILE%\.cursor\mcp.json - Codex MCP 配置:通过
codex mcp add/remove/list/get管理,脚本不直接写config.toml - Cursor 用户级 Skills:
%USERPROFILE%\.cursor\skills - Codex 用户级 Skills:
%USERPROFILE%\.codex\skills - Codex 全局规则入口:
%USERPROFILE%\.codex\AGENTS.md - Codex 按需规则:
%USERPROFILE%\.codex\agent-rules - Cursor User Rules:手动录入,源文件
<配置包根目录>/rules/universal/AGENTS.md(setup 默认不装 rules) - Cursor Project Rules(可选):
-ProjectPath安装到{工程根}/.cursor/rules - Cursor 本地 MCP 服务:
%USERPROFILE%\.cursor\mcp-servers - Codex 本地 MCP 服务:
%USERPROFILE%\.codex\mcp-servers - QoderCN 用户级 Skills:
%USERPROFILE%\.qoder-cn\skills - QoderCN 记忆入口(常驻薄 AGENTS.md):
%USERPROFILE%\.qoder-cn\AGENTS.md - QoderCN 规则(trigger frontmatter 按需注入):
%USERPROFILE%\.qoder-cn\rules - QoderCN 本地 MCP 服务:
%USERPROFILE%\.qoder-cn\mcp-servers - QoderCN MCP 配置:
%USERPROFILE%\.qoder-cn\settings.json(经qoderclicn mcp add/remove -s user管理,脚本不直接改写 JSON) - DSH 用户级 Skills:
%USERPROFILE%\.dsh\skills - DSH 全局规则入口:
%USERPROFILE%\.dsh\AGENTS.md - DSH 按需规则:
%USERPROFILE%\.dsh\rules - DSH 本地 MCP 服务:
%USERPROFILE%\.dsh\mcp-servers - DSH MCP 注册:
%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml的托管标记块 - DSH campus-net 用户根:
%USERPROFILE%\.dsh\campus-net - 迁移包 Skills 副本:
<配置包根目录>/skills - 迁移包 MCP 源码快照:
<配置包根目录>/mcp-servers-src - Cursor 写入脚本(非通用 IDE 安装名):
scripts/setup-cursor-agents.ps1(在配置包根目录内执行) - Codex 写入脚本:
scripts/setup-codex-agents.ps1(在配置包根目录内执行) - QoderCN 写入脚本:
scripts/setup-qodercn-agents.ps1(在配置包根目录内执行) - DSH 写入脚本:
scripts/setup-dsh-agents.ps1(在配置包根目录内执行;写入$DSH_HOME) - UI/UX 技能同步(维护者):
scripts/sync-ui-ux-skills.ps1(在配置包根目录内执行) - 安装记录:
MCP与Skills配置记录.md(若存在)
setx S2_API_KEY "你的 Semantic Scholar API Key"
setx OPENALEX_EMAIL "你的邮箱"
setx CROSSREF_EMAIL "你的邮箱"
setx NCBI_API_KEY "你的 NCBI API Key"S2_API_KEY:Semantic Scholar 高配额,可选。OPENALEX_EMAIL:OpenAlex polite pool,可选。CROSSREF_EMAIL:CrossRef polite pool,可选。NCBI_API_KEY:PubMed 高配额,可选。- 校园网馆藏:参见
campus-netMCP 与CAMPUS_*变量(若启用)。 GEMINI_API_KEY(可选):designSkill 下 Logo/CIP/图标 生成 脚本需要;使用setx GEMINI_API_KEY "..."或系统环境变量,并执行pip install google-genai。不 patch 脚本读取.env路径。
真相源为同仓库或 sibling 路径下的 ui-ux-pro-max-skill/。更新汉化或模板后,进入配置包根目录执行:
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\sync-ui-ux-skills.ps1" -Assemble
# 仅复制 <配置包根目录> 到新机器、无 sibling 仓库时
powershell -ExecutionPolicy Bypass -File ".\scripts\sync-ui-ux-skills.ps1" -UpstreamPath "D:\path\to\ui-ux-pro-max-skill"
# 安装到 Cursor(Skills + MCP;Rules 见终端提醒手动录入 AGENTS.md)
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"
# 安装到 DSH(Skills + Rules + MCP;写入 $DSH_HOME)
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-dsh-agents.ps1"
# 安装到 Codex(Rules + Skills + MCP;只覆盖 manifest 托管项)
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-codex-agents.ps1"
# 可选:Project Rules 到指定工程
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1" -ProjectPath "D:\GeoPile"前置:Python 3.10+(Python MCP、ui-ux-pro-max、design-system search-slides);Node.js 18+(brand、design-system、ui-styling 的 .cjs 与 shadcn CLI)。安装脚本会优先通过 Windows py 启动器选择 py -3.10 或更高版本,避免 PATH 中旧版 python 误建虚拟环境。
banner-design 限制:完整生成链引用未打包 Skill ai-artist、ai-multimodal、chrome-devtools;迁入包仅含 SKILL + references。
Claude Code 手动安装:若复制到 ~/.claude/skills/,须将 SKILL 内 $env:USERPROFILE\.cursor\skills\ 替换为 Claude 用户级路径(含 ppt-maker、ui-ux-pro-max)。
DSH 安装:setup-dsh-agents.ps1 会把 pathRewriteSkills 中的 $env:USERPROFILE\.cursor\skills\ / %USERPROFILE%\.cursor\skills\ / ~/.cursor/skills 改写为当前 $DSH_HOME 技能根;-NoPathRewrite 可关闭。
Codex 安装:使用 setup-codex-agents.ps1 写入 %USERPROFILE%\.codex\skills\;若手动复制 Skill,须将仅适用于 Cursor 的命令路径替换为 Codex 用户级路径。
编辑源:工作区 sibling andrej-karpathy-skills/;发布副本:<配置包根目录>/skills/karpathy-guidelines/、<配置包根目录>/rules/cursor/karpathy-guidelines.mdc、AGENTS.md §11(禁止手改副本,须 sync)。
# andrej-karpathy-skills → <配置包根目录>(四路同步)
node andrej-karpathy-skills/scripts/sync-to-agents.mjs
node andrej-karpathy-skills/scripts/sync-to-agents.mjs --dry-run
# 安装到 Cursor
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"
# 安装到 Codex
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-codex-agents.ps1"修改四原则时须同步源仓库内 SKILL.md、CLAUDE.md、.cursor/rules/karpathy-guidelines.mdc,再运行上述 sync。
编辑源:工作区根 cad-structure-layout-debug/(沙箱);发布副本:<配置包根目录>/skills/cad-structure-layout-debug/(禁止手改,须 sync)。
# 编辑源 → <配置包根目录> 发布副本
powershell -ExecutionPolicy Bypass -File "cad-structure-layout-debug\scripts\sync-to-agents.ps1"
powershell -ExecutionPolicy Bypass -File "cad-structure-layout-debug\scripts\sync-to-agents.ps1" -DryRun
# 安装到 Cursor
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"
# 安装到 Codex
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-codex-agents.ps1"前置:Python 3.10+;验证脚本依赖 ezdxf、matplotlib、pillow(见 requirements.txt)。
冒烟:
$skill = "$env:USERPROFILE\.cursor\skills\cad-structure-layout-debug"
py -3.10 "$skill\examples\minimal_engineering_drawing\generate.py" --out "$skill\out\minimal.dxf"
py -3.10 "$skill\scripts\dxf_smoke_check.py" --dxf "$skill\out\minimal.dxf" --min-entities 10
py -3.10 "$skill\scripts\render_dxf_preview.py" --dxf "$skill\out\minimal.dxf" --png "$skill\out\minimal.png"Codex 路径将 $env:USERPROFILE\.cursor\skills\ 替换为 $env:USERPROFILE\.codex\skills\ 即可。
编辑源:工作区根 wpf-python-mvvm-builder/(沙箱);发布副本:<配置包根目录>/skills/wpf-python-mvvm-builder/(禁止手改,须 sync)。
# 编辑源 → <配置包根目录> 发布副本
powershell -ExecutionPolicy Bypass -File "wpf-python-mvvm-builder\scripts\sync-to-agents.ps1"
powershell -ExecutionPolicy Bypass -File "wpf-python-mvvm-builder\scripts\sync-to-agents.ps1" -DryRun
# 安装到 Cursor
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"前置:Python 3;本机 .NET SDK(dotnet build)。脚本仅用标准库,无额外 pip 依赖。
冒烟(对已有 WPF 项目,替换 <path> / <Abbr> / <Project>):
$skill = "$env:USERPROFILE\.cursor\skills\wpf-python-mvvm-builder"
py -3 "$skill\scripts\audit_project.py" --project-dir "<path>" --abbr "<Abbr>"
py -3 "$skill\scripts\smoke_bridge.py" --project-dir "<path>" --abbr "<Abbr>"
dotnet build "<path>/<Project>.csproj"Codex 安装与说明见 CODEX.md(本小节只维护 Cursor 链路)。
编辑源:工作区根 ppt-maker/(沙箱);发布副本:<配置包根目录>/skills/ppt-maker/(禁止手改,须 sync)。
# 沙箱 → <配置包根目录> 发布副本
node ppt-maker/scripts/sync-to-agents.mjs
node ppt-maker/scripts/sync-to-agents.mjs --dry-run
# 安装到 Cursor
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"刷新 kit-template(维护者,可选):
node ppt-maker/scripts/sync-template.mjs --upstream "D:\path\to\ppt-maker-kit"
node ppt-maker/scripts/sync-to-agents.mjs用户任务副本:每次任务在工作区 ppt-projects/{english-slug}/;勿提交进 Git(根 .gitignore 已忽略)。
前置:Node.js 18+(npm install / npm run serve);Python 3 + ui-ux-pro-max(风格 design-tokens.css)。
冒烟:
node "$env:USERPROFILE\.cursor\skills\ppt-maker\scripts\check-node.mjs"
node "$env:USERPROFILE\.cursor\skills\ppt-maker\scripts\slug.mjs" --generate
node "$env:USERPROFILE\.codex\skills\ppt-maker\scripts\check-node.mjs"- 修改
%USERPROFILE%\.cursor\mcp.json后,需要重启 Cursor 或重新打开 Agent 会话。 - 修改 DSH 的
cordis.patch.yml后,HMR 通常会自动重载;未生效时重启 DSH 桌面端并新开会话。 - 使用
codex mcp add/remove更新 MCP 后,需要新开 Codex 会话。 - 新增或修改 Skills 后,建议重启 Cursor 或新开 Agent 会话。
- 不要修改
%USERPROFILE%\.cursor\skills-cursor,该目录为 Cursor 内置 Skills。
将 <配置包根目录>/ 复制到新电脑任意项目根目录后,进入配置包根目录执行 setup;按终端提醒手动录入 User Rules。
cd <本项目目录>
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-cursor-agents.ps1"
powershell -ExecutionPolicy Bypass -File ".\scripts\setup-codex-agents.ps1"安装脚本会优先使用 <配置包根目录>/mcp-servers-src/ 内的源码快照;如果源码快照缺失,才从对应 GitHub 仓库克隆。
Codex 脚本的增量边界:只覆盖 manifest.json 的 codexInstallManifest 声明的同名托管 skill、rule、MCP 源码目录和 MCP 注册;用户自装内容不删除、不卸载。
# Cursor
Set-Location "$env:USERPROFILE\.cursor\mcp-servers\academic-research-mcp"
git pull
& ".\.venv\Scripts\python.exe" -m pip install -r requirements.txt
Set-Location "$env:USERPROFILE\.cursor\mcp-servers\zotero-mcp"
git pull
npm install
npm run build
Set-Location "$env:USERPROFILE\.cursor\mcp-servers\deck-builder"
git pull
npm install
npm run build
# Codex
Set-Location "$env:USERPROFILE\.codex\mcp-servers\academic-research-mcp"
git pull
& ".\.venv\Scripts\python.exe" -m pip install -r requirements.txt
Set-Location "$env:USERPROFILE\.codex\mcp-servers\zotero-mcp"
git pull
npm install
npm run build
Set-Location "$env:USERPROFILE\.codex\mcp-servers\deck-builder"
git pull
npm install
npm run build如有 campus-net-mcp:在项目侧更新 <配置包根目录>/mcp-servers-src/campus-net-mcp 后再次运行对应平台 setup,或直接覆盖 %USERPROFILE%\.cursor\mcp-servers\campus-net-mcp / %USERPROFILE%\.codex\mcp-servers\campus-net-mcp 并重装 venv 依赖。
- 确认 Cursor 已重启,或已新开 Codex 会话。
- Cursor:在
Settings > Tools & MCP确认 MCP 已启用;Codex:执行codex mcp list。 - Cursor:检查
mcp.json是否为合法 JSON;Codex:用codex mcp get <name> --json检查配置。 - 检查本地入口文件是否存在:
%USERPROFILE%\.cursor\mcp-servers\academic-research-mcp\server.py%USERPROFILE%\.cursor\mcp-servers\zotero-mcp\dist\index.js%USERPROFILE%\.cursor\mcp-servers\deck-builder\build\index.js%USERPROFILE%\.codex\mcp-servers\academic-research-mcp\server.py%USERPROFILE%\.codex\mcp-servers\zotero-mcp\dist\index.js%USERPROFILE%\.codex\mcp-servers\deck-builder\build\index.js
- 如果卡在第一个 Python MCP,检查依赖是否真实可导入:
& "$env:USERPROFILE\.codex\mcp-servers\academic-research-mcp\.venv\Scripts\python.exe" -c "import mcp; print('ok')"
& "$env:USERPROFILE\.cursor\mcp-servers\academic-research-mcp\.venv\Scripts\python.exe" -c "import mcp; print('ok')"- 使用 Zotero MCP 前确认 Zotero Desktop 已启动。
- UI/UX:
python "%USERPROFILE%\.cursor\skills\ui-ux-pro-max\scripts\search.py" "test" --design-system -n 1应能输出结果(终端文案可能仍为英文)。