Files
market/docs/desirecore-control.zh-CN.md
Yige 204cd96835 docs: 更新 Control 应用市场入口与服务技能边界 (#181)
## 变更 / Changes
新增 Control 1.4.0 中英文市场安装指南及 README 应用入口,指向真正的应用数据源
desirecore/registry;同步 registering-services / using-services 到 1.0.4,明确
native-app 的对外 MCP 不可注册为内部服务。

Add bilingual marketplace documentation and update both service skills
without duplicating an App as an MCP service. Fixed native application
listing and lifecycle live in Registry; open-source implementation lives
in desirecore-agent/desirecore-cdp-mcp.

## 兼容 / Compatibility
Requires native-app-aware desktop (catalog minimum 10.0.169) and
app-install-manager >=1.4.0. Catalog publication does not upgrade the
desktop or Agent.

## 验证 / Verification
- i18n/catalog validation: 0 errors, 129 existing governance/freshness
warnings retained.
- scoped translation hash check: both skills up to date; no model API
invoked by checks.
- git diff --check passed; unrelated market entries preserved.
2026-09-19 14:21:07 +08:00

4.1 KiB
Raw Permalink Blame History

从市场安装 DesireCore Control

DesireCore Control 是面向 ChatGPT、Codex 等外部智能体的独立应用,MCP 只是对外协议。它不向 DesireCore 内部智能体注册 MCP,不随 DesireCore 启停。1.4.0 包含本机实例管理及官方 ChatGPT tunnel-client 的启停与就绪检查。

应用目录

市场的“应用”数据来自 desirecore/registry,本仓库维护 Agent/Team/Skill。应用的正式索引为 entries/desirecore-control,不是本仓库的 MCP 服务条目。不要复制成第二份服务或伪装成 Docker。

在支持原生应用的 DesireCore 客户端中同步市场目录,然后在“市场 → 应用”搜索 DesireCore Control,核对版本 1.4.0 并发起安装。安装流程要求 native-app 客户端支持(条目标注最低 10.0.170)和应用安装管理技能 1.5.2 或更新版本。同步目录不会自动升级桌面客户端或核心智能体技能;旧版看不到条目或提示升级时,不应改类型、重建收据或绕过版本检查。客户端尚未发布或技能尚未更新时,市场一键安装仍不可用。

安装器使用受信 resolver 的固定版本、下载地址和 SHA-256。默认安装在独立用户目录,验证包版本与空实例启动后,通过唯一写入接口记录带时间的核验结果,不预写安装进度。不会启动真实 DesireCore 实例,不创建内部 MCP,不默认启用控制、隧道或开机启动。应用安装成功和应用进程运行是两个状态。

安装后

使用资源中的启动操作或安装器给出的准确独立命令启动 Control,在系统浏览器打开本机管理页。可选的官方 tunnel-client 需要单独安装,不随 Control 打包。在本机“ChatGPT 安全隧道”面板,先输入本次运行的 admin-token(私有文件位置由 Control 终端显示),再提供 Tunnel ID 和运行 API key。管理令牌、Control 对外 MCP token、OpenAI 运行 key 三者不同,均不能发到市场安装对话。正常退出 Control 时只终止它自己启动的 tunnel-client 进程,不停止 DesireCore 或其他隧道客户端,也不会删除 OpenAI Platform 上配置的 Tunnel。

可选外部依赖:OpenAI 隧道

启用前按官方配置指南准备关联目标组织/工作区的 Tunnel、具有 Tunnels Read + Use 的专用运行 key、独立的 ChatGPT 开发者模式权限,以及出站 HTTPS 网络。创建或编辑 Tunnel 另外需要 Manage 权限。用户需自行安装兼容的官方客户端并核对其许可证和 notices;Control 的 MIT 许可不能替代外部组件的条款。

OpenAI 服务适用其条款和政策,费用以用户订阅、订单及账户账单为准;不承诺隧道或模型调用免费,也不承诺已包含在 Control 安装中。启用可选连接前由用户在本机确认适用费用。客户端缺失或权限不足时不启动隧道,不回退到公开 CDP;就绪状态为 false 或未知时,不执行 ChatGPT 工具操作,先检查客户端、账号关联和网络。进程正在运行不等于就绪,就绪也不等于端到端验收。未启用隧道时本机管理页仍可用,关闭该可选连接不卸载 Control。

维护与版本

应用实现与 MIT 发行包由 desirecore-agent/desirecore-cdp-mcp 维护。Registry 负责市场分类、版本、固定制品及生命周期指南;核心 Agent 的 app-install-manager 负责按 App 授权执行安装与回写;DesireCore 客户端负责 native-app 的目录和安装投影。单独更新其中一个仓库不能证明整个安装链路已经部署。

升级/卸载保留精确来源、设备身份及原始管理指南,比较上次记录修订,不派生服务。软件操作与记账分别报告,记账失败不重跑安装;用户数据和凭据的删除需要独立确认。完整命令以 Registry 当前被审核的 install.md 为准,不从聊天历史取过期步骤。