mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-10-20 23:24:56 +08:00
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.
This commit is contained in:
GitHub
@@ -316,6 +316,12 @@ the parent.
|
||||
The strict source schema is
|
||||
[`schemas/catalog-metadata.v1.schema.json`](schemas/catalog-metadata.v1.schema.json).
|
||||
|
||||
## Applications: DesireCore Control
|
||||
|
||||
Applications shown in the DesireCore marketplace are indexed by [DesireCore Registry](https://github.com/desirecore/registry), not by adding a Skill or MCP entry to this repository. [DesireCore Control 1.4.0](https://github.com/desirecore/registry/tree/main/entries/desirecore-control) is a native application for external agents, with ChatGPT tunnel management; installation never registers internal MCP tools. Its catalog declares the required client and installation-skill versions. Catalog publication does not update the desktop client automatically.
|
||||
|
||||
See the [installation guide](docs/desirecore-control.md) / [中文安装说明](docs/desirecore-control.zh-CN.md). Registry maintains the immutable release URL, checksum, application metadata and install/uninstall guide; the open-source implementation stays in `desirecore-agent/desirecore-cdp-mcp`.
|
||||
|
||||
## Categories
|
||||
|
||||
Valid category slugs are declared in `categories.json`:
|
||||
|
||||
27
docs/desirecore-control.md
Normal file
27
docs/desirecore-control.md
Normal file
@@ -0,0 +1,27 @@
|
||||
# Install DesireCore Control from the marketplace
|
||||
|
||||
DesireCore Control is a standalone application for external agents such as ChatGPT and Codex. MCP is its outward protocol, not an internal DesireCore service registration. Version 1.4.0 includes a local dashboard, multi-instance discovery and managed startup/shutdown/readiness observations for the official ChatGPT tunnel client.
|
||||
|
||||
## Application catalog
|
||||
|
||||
The marketplace's application data comes from [desirecore/registry](https://github.com/desirecore/registry); this repository maintains Agents, Teams and Skills. The authoritative application entry is [entries/desirecore-control](https://github.com/desirecore/registry/tree/main/entries/desirecore-control). Do not create a second MCP service listing or mislabel the application as Docker.
|
||||
|
||||
On a compatible client, synchronize the catalog and search for **DesireCore Control** under **Market → Applications**. Verify version **1.4.0** before requesting installation. The listing requires native-app client support (minimum **10.0.170**) and the core Agent's **app-install-manager 1.5.2 or newer**. Catalog sync does not update the desktop client or Agent skills. An older client may omit the entry or require an upgrade; do not change its type or bypass receipt/version checks. Marketplace installation remains unavailable until the required client and skill are actually deployed.
|
||||
|
||||
The installer uses the resolver-authorized fixed release URL and SHA-256, installs into an independent user directory, verifies the installed version and empty-instance startup, then records a timestamped observation through the owning API, without prewriting installation progress. It does not start DesireCore, register internal MCP tools, enable control/tunnels, or install an autostart hook. Installed and running are distinct states.
|
||||
|
||||
## After installation
|
||||
|
||||
Start Control using the resource action or the exact independent command returned by the installer, then open its local dashboard in the system browser. The optional official `tunnel-client` is separately installed, not bundled with Control. In the local ChatGPT tunnel panel, first enter the per-run `admin-token` from the private file identified by Control's terminal output, then provide the Tunnel ID and runtime API key. This management token is separate from Control's outward MCP token and the OpenAI runtime key; never send any of them to the marketplace installation conversation. Normal Control shutdown terminates only the `tunnel-client` process it owns, not DesireCore or other tunnel clients, and does not delete the Tunnel configured on OpenAI Platform.
|
||||
|
||||
### Optional external dependency: OpenAI tunnel
|
||||
|
||||
Before enabling a tunnel, follow the [official setup guide](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels): obtain a Tunnel associated with the intended organization/workspace, a dedicated runtime key with Tunnels Read + Use, separate ChatGPT developer-mode permission, and outbound HTTPS access. Creating or editing a Tunnel additionally requires Manage permission. The user installs a compatible official binary and verifies its license/notices; Control's MIT license does not replace those terms.
|
||||
|
||||
OpenAI usage is governed by the applicable [terms and policies](https://openai.com/policies/) and the user's subscription/order/account billing. No free tunnel service, free model use or inclusion in the Control installation price is promised. Confirm applicable costs locally before enabling the optional connection. If the binary or permission is missing, do not start the tunnel or fall back to public CDP. If readiness is false or unknown, do not issue ChatGPT tool operations: check the client installation, account association and connectivity first. A running process is not readiness, and readiness is not end-to-end acceptance. Control's local dashboard remains available without a tunnel; disabling this optional connection does not uninstall Control.
|
||||
|
||||
## Maintenance
|
||||
|
||||
[desirecore-agent/desirecore-cdp-mcp](https://github.com/desirecore-agent/desirecore-cdp-mcp) maintains the MIT-licensed application and releases. Registry owns its catalog metadata and pinned lifecycle guide; app-install-manager executes authorized installation and writes exact receipts; the desktop client projects native-app records and launch entries. Publishing only one repository is not evidence that the entire installation chain is deployed.
|
||||
|
||||
Updates and uninstallation preserve exact source/device identity, compare the last record revision, and use the original management guide. Software changes and recording are separate outcomes; recording failures do not replay installation commands. No internal services are derived. Deleting user credentials or data requires separate consent. Use the Registry's currently authorized install.md rather than stale chat instructions.
|
||||
27
docs/desirecore-control.zh-CN.md
Normal file
27
docs/desirecore-control.zh-CN.md
Normal file
@@ -0,0 +1,27 @@
|
||||
# 从市场安装 DesireCore Control
|
||||
|
||||
DesireCore Control 是面向 ChatGPT、Codex 等外部智能体的独立应用，MCP 只是对外协议。它不向 DesireCore 内部智能体注册 MCP，不随 DesireCore 启停。1.4.0 包含本机实例管理及官方 ChatGPT tunnel-client 的启停与就绪检查。
|
||||
|
||||
## 应用目录
|
||||
|
||||
市场的“应用”数据来自 [desirecore/registry](https://github.com/desirecore/registry)，本仓库维护 Agent/Team/Skill。应用的正式索引为 [entries/desirecore-control](https://github.com/desirecore/registry/tree/main/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 隧道
|
||||
|
||||
启用前按[官方配置指南](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels)准备关联目标组织/工作区的 Tunnel、具有 Tunnels Read + Use 的专用运行 key、独立的 ChatGPT 开发者模式权限，以及出站 HTTPS 网络。创建或编辑 Tunnel 另外需要 Manage 权限。用户需自行安装兼容的官方客户端并核对其许可证和 notices；Control 的 MIT 许可不能替代外部组件的条款。
|
||||
|
||||
OpenAI 服务适用其[条款和政策](https://openai.com/policies/)，费用以用户订阅、订单及账户账单为准；不承诺隧道或模型调用免费，也不承诺已包含在 Control 安装中。启用可选连接前由用户在本机确认适用费用。客户端缺失或权限不足时不启动隧道，不回退到公开 CDP；就绪状态为 false 或未知时，不执行 ChatGPT 工具操作，先检查客户端、账号关联和网络。进程正在运行不等于就绪，就绪也不等于端到端验收。未启用隧道时本机管理页仍可用，关闭该可选连接不卸载 Control。
|
||||
|
||||
## 维护与版本
|
||||
|
||||
应用实现与 MIT 发行包由 [desirecore-agent/desirecore-cdp-mcp](https://github.com/desirecore-agent/desirecore-cdp-mcp) 维护。Registry 负责市场分类、版本、固定制品及生命周期指南；核心 Agent 的 app-install-manager 负责按 App 授权执行安装与回写；DesireCore 客户端负责 native-app 的目录和安装投影。单独更新其中一个仓库不能证明整个安装链路已经部署。
|
||||
|
||||
升级/卸载保留精确来源、设备身份及原始管理指南，比较上次记录修订，不派生服务。软件操作与记账分别报告，记账失败不重跑安装；用户数据和凭据的删除需要独立确认。完整命令以 Registry 当前被审核的 install.md 为准，不从聊天历史取过期步骤。
|
||||
@@ -5,7 +5,7 @@ description: >-
|
||||
Catalog so that other Agents (and the human user) can discover and call it.
|
||||
Use when the user mentions adding a new service, registering an API, or
|
||||
publishing a backend you control to the team's catalog. 新增服务、注册 API、把后端发布到团队目录时使用。
|
||||
version: 1.0.3
|
||||
version: 1.0.4
|
||||
type: meta
|
||||
risk_level: medium
|
||||
status: enabled
|
||||
@@ -17,7 +17,7 @@ tags:
|
||||
- meta
|
||||
metadata:
|
||||
author: desirecore
|
||||
updated_at: '2026-07-29'
|
||||
updated_at: '2026-09-18'
|
||||
i18n:
|
||||
default_locale: en-US
|
||||
source_locale: zh-CN
|
||||
@@ -38,8 +38,8 @@ metadata:
|
||||
description: >-
|
||||
Register an external HTTP/MCP service to the global Application & Service Catalog so that other Agents (and the human user) can discover and call it. Use when the user mentions adding a new service, registering an API, or publishing a backend you control to the team's catalog.
|
||||
body: ./SKILL.md
|
||||
translated_by: human
|
||||
source_hash: sha256:dcd8732ac76f009f
|
||||
translated_by: ai:chatgpt
|
||||
source_hash: sha256:f5b954fb4d490606
|
||||
market:
|
||||
icon: >-
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#FFFFFF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="4" width="12" height="6" rx="1.5"/><rect x="3" y="14" width="12" height="6" rx="1.5"/><circle cx="6.5" cy="7" r="0.5" fill="#FFFFFF"/><circle cx="6.5" cy="17" r="0.5" fill="#FFFFFF"/><line x1="19.5" y1="5" x2="19.5" y2="11"/><line x1="16.5" y1="8" x2="22.5" y2="8"/></svg>
|
||||
@@ -52,6 +52,10 @@ market:
|
||||
|
||||
# registering-services Skill
|
||||
|
||||
## Native applications are not internal services
|
||||
|
||||
A `native-app` such as **DesireCore Control** is installed and managed through the App acquisition flow and `app-install-manager` (1.5.2 or newer). Its outward MCP endpoint is for external agents, not permission to register it in DesireCore's service catalog or an Agent's MCP configuration. Do not convert it to `mcp`/`docker-app`, derive services, or call service-registration APIs for it. Runtime GUI access still uses the governed `ControlDesireCoreGui` tool.
|
||||
|
||||
## L0: One-line Summary
|
||||
|
||||
Tell the Agent how to register an external HTTP/MCP service into the global
|
||||
|
||||
@@ -2,6 +2,10 @@
|
||||
|
||||
# 注册服务（registering-services）
|
||||
|
||||
## 原生应用不等于内部服务
|
||||
|
||||
**DesireCore Control** 等 `native-app` 通过 App 获取流程与 `app-install-manager`（1.5.2 或更新版本）安装和管理。它向外提供的 MCP 端点是给外部智能体使用的，不代表允许注册到 DesireCore 的服务目录或 Agent MCP 配置。不得改成 `mcp`/`docker-app`、派生内部服务或为它调用服务注册 API。运行时 GUI 接管仍使用受治理的 `ControlDesireCoreGui`。
|
||||
|
||||
## L0：一句话总结
|
||||
|
||||
教会 Agent 如何把一个外部 HTTP/MCP 服务安全地登记进全局"应用与服务目录"，
|
||||
|
||||
@@ -29,14 +29,14 @@
|
||||
},
|
||||
"release": {
|
||||
"state": "known",
|
||||
"version": "1.0.3",
|
||||
"version": "1.0.4",
|
||||
"versionScheme": "semver"
|
||||
},
|
||||
"timestamps": {
|
||||
"catalogUpdatedAt": {
|
||||
"state": "known",
|
||||
"value": "2026-07-29T09:48:28Z",
|
||||
"precision": "second"
|
||||
"value": "2026-09-18",
|
||||
"precision": "day"
|
||||
},
|
||||
"releasePublishedAt": {
|
||||
"state": "unknown"
|
||||
|
||||
@@ -5,7 +5,7 @@ description: >-
|
||||
catalog. Use when the user asks the Agent to call an API, search for an
|
||||
existing service, or query a backend that was registered via the
|
||||
registering-services skill. 调用某个 API、查找已有服务、访问已注册的后端服务时使用。
|
||||
version: 1.0.3
|
||||
version: 1.0.4
|
||||
type: meta
|
||||
risk_level: low
|
||||
status: enabled
|
||||
@@ -18,7 +18,7 @@ tags:
|
||||
- meta
|
||||
metadata:
|
||||
author: desirecore
|
||||
updated_at: '2026-07-29'
|
||||
updated_at: '2026-09-18'
|
||||
i18n:
|
||||
default_locale: en-US
|
||||
source_locale: zh-CN
|
||||
@@ -38,8 +38,8 @@ metadata:
|
||||
description: >-
|
||||
Discover and invoke HTTP/MCP services already registered in the global catalog. Use when the user asks the Agent to call an API, search for an existing service, or query a backend that was registered via the registering-services skill.
|
||||
body: ./SKILL.md
|
||||
translated_by: human
|
||||
source_hash: sha256:8a20b2835e5e54d1
|
||||
translated_by: ai:chatgpt
|
||||
source_hash: sha256:b841f1996c1d428f
|
||||
market:
|
||||
icon: >-
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#FFFFFF" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="9" width="6" height="6" rx="1.5"/><rect x="15" y="3" width="6" height="6" rx="1.5"/><rect x="15" y="15" width="6" height="6" rx="1.5"/><path d="M9 11.5h3.5V6H15"/><path d="M9 12.5h3.5V18H15"/></svg>
|
||||
@@ -52,6 +52,10 @@ market:
|
||||
|
||||
# using-services Skill
|
||||
|
||||
## Native applications and outward protocols
|
||||
|
||||
**DesireCore Control** is a `native-app` for external agents, not an installed internal MCP service. The presence of its dashboard or outward `/mcp` endpoint does not authorize this Agent to invoke it through `using-services`, register it, or bypass GUI approval. Use `app-install-manager` (1.5.2 or newer) for its App lifecycle and the governed `ControlDesireCoreGui` for runtime GUI access. An App installation must not mint an internal service or `svc-*` skill.
|
||||
|
||||
## L0: One-line Summary
|
||||
|
||||
Teach the Agent how to look up and call services from the global
|
||||
|
||||
@@ -2,6 +2,10 @@
|
||||
|
||||
# 使用服务（using-services）
|
||||
|
||||
## 原生应用与对外协议
|
||||
|
||||
**DesireCore Control** 是供外部智能体使用的 `native-app`，不是已经安装的内部 MCP 服务。看到它的管理页或对外 `/mcp` 端点，不代表本 Agent 获准通过 `using-services` 调用、注册它或绕过 GUI 审批。应用生命周期使用 `app-install-manager`（1.5.2 或更新版本），运行时 GUI 接管使用受治理的 `ControlDesireCoreGui`。应用安装不得生成内部服务或 `svc-*` 技能。
|
||||
|
||||
## L0：一句话总结
|
||||
|
||||
教会 Agent 如何从全局"应用与服务目录"里查找并正确调用服务。
|
||||
|
||||
@@ -30,14 +30,14 @@
|
||||
},
|
||||
"release": {
|
||||
"state": "known",
|
||||
"version": "1.0.3",
|
||||
"version": "1.0.4",
|
||||
"versionScheme": "semver"
|
||||
},
|
||||
"timestamps": {
|
||||
"catalogUpdatedAt": {
|
||||
"state": "known",
|
||||
"value": "2026-07-29T09:48:28Z",
|
||||
"precision": "second"
|
||||
"value": "2026-09-18",
|
||||
"precision": "day"
|
||||
},
|
||||
"releasePublishedAt": {
|
||||
"state": "unknown"
|
||||
|
||||
Reference in New Issue
Block a user