# 连接相交线：中文安装指南

只在用户要求安装/连接时执行。用户在官方 colorcross.dodo.fun 页面输入手机号和验证码并确认权限，不在聊天中提供凭据。用户 MCP 地址：`https://colorcross.dodo.fun/mcp/user`。

## 本地 Agent：Codex、Claude Code、Gemini CLI、Qwen Code、ZCode

下载并查看 `https://colorcross.24.run/skill/install.py`，再用 Python 3.9+ 执行：

```bash
python3 <下载目录>/install.py --client codex --language zh
```

按当前客户端将 codex 替换为 claude、gemini、qwen 或 zcode。仅用户要求同时安装时可用 both（Codex/Claude）或 all（本机可发现的客户端）。Windows 可用 `py -3`。安装器核验同源 ZIP/每个文件 SHA-256，备份旧版与原配置，不覆盖冲突连接，配置用户 MCP 及本地私有上传工具。中文、英文通过 `--language zh|en` 选择。

登录步骤：

- Codex：`codex mcp login colorcross-user-production --scopes colorcross:capture,colorcross:read,offline_access`。
- Claude Code：在交互终端执行 `claude mcp login colorcross-user-production`，或用 `/mcp` 登录。
- Gemini CLI、Qwen Code：进入客户端，执行 `/mcp auth colorcross-user-production`。
- ZCode：设置 → MCP 服务器 → 相交线连接 → 打开授权；不会自动弹出浏览器。刷新 Skills，确认相交线已启用。请在 5 分钟内完成授权；会话过期后需要重新发起连接，不要继续使用旧授权标签页。多次重试若触发注册限流，请稍后再试或联系相交线支持。

安装后新建会话，可说“查询未完成待办”“总结上周记录”“查看昨天日报”。只有用户明确要求时才保存验收记录。

## ChatGPT

在 ChatGPT 的应用/插件设置中创建自定义 MCP，填入上面的用户 MCP 地址，认证选择 OAuth，按页面完成登录。平台功能取决于账号/工作区权限；必要时由管理员开放。使用平台提供的 DCR 连接流程，不需要手动收集 Token。

ChatGPT 网页连接不运行本地 Skill 安装器，也不能调用电脑上的上传工具。当前文字录入、任务查询、记录搜索总结和已有报告读取可通过远端工具完成。本地图片、语音、视频请使用相交线 App 或本地 Agent，不把附件的临时地址交给 shell。

## Gemini 网页/手机端

在 Gemini 网页端 Settings → Connected Apps → Custom apps 添加用户 MCP 地址，并完成 OAuth。Google 当前对地区、账号、年龄和英文界面等有开放限制，实际以平台页面为准；相交线登录授权页自身支持中英文。Gemini CLI 不受同一网页入口约束，是独立选择。媒体边界与 ChatGPT 相同。

## 其他 MCP Agent

支持远程 HTTP MCP、OAuth PKCE 和标准本地回调的客户端可使用同一用户服务。支持 SKILL.md 的本地客户端可将完整目录放入其官方技能目录；配置只包含服务地址，不含用户 ID、Token 或管理端地址。没有安全上传通道时只使用文字与查询。不能把“配置成功”称为“真实登录或业务验收成功”。

## 维护与权限

只使用 `/mcp/user`。历史读取需明确 `colorcross:read` 同意，旧 token 不会自动扩权。媒体需“准备 → 本地上传 → 提交”全部成功才保存；任务查询不修改任务，日报周报读取不触发生成。登录失败停止后续操作，不换用后台、数据库或其他 API 绕过。