mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-10-20 23:24:56 +08:00
Yige
a514b55b68
## 中文 新增按需调用的内置技能 `app-developer`（应用开发与发布）：中英正文、sidecar、MIT 许可、静态与服务两个通用工作台示例，以及作者接口与分发参考，并登记进 `builtin-skills.json`。作者管理优先使用 AppManage 的有限动作，执行前须通过 `authoring_capabilities` 确认 `app-authoring-v1`，能力不可用时停止受影响的操作；外部 Node/Docker 运行时、托管、Git 服务与数据库的条款和可能费用已在发现文案、compatibility 与正文披露。另将 dev-environment-setup 探测参考中的三处用户 home 示例改为通用路径。 与 #220、#212 合入后的 main 解决 manifest 冲突：技能总数 144，市场版本 1.5.13。验证：catalog 与 i18n 校验 0 errors / 106 warnings（含新技能尚未 ref-bound review 的治理提醒），translate --check 与 git diff --check 通过；远端 validate、translate、CodeQL 通过。Copilot 因额度用尽未能审查。 ## English Add the on-demand builtin `app-developer` skill (application development and publishing): English/Chinese bodies, sidecar, MIT license, static and service workbench examples, plus authoring-interface and distribution references, registered in `builtin-skills.json`. Authoring prefers AppManage's finite actions and must confirm `app-authoring-v1` through `authoring_capabilities` first, stopping affected operations when the capability is unavailable. External Node/Docker runtime, hosting, Git service and database terms and possible costs are disclosed. Three user-home examples in the dev-environment-setup probe reference are neutralized. The manifest conflict with main after #220 and #212 is resolved: 144 skills, market version 1.5.13. Catalog and i18n validation report 0 errors with 106 warnings (including the new skill's pending ref-bound review notice); translate --check and git diff --check pass; remote validate, translate and CodeQL passed. Copilot could not review because of its quota limit.
3.8 KiB
3.8 KiB
固定应用版本分发
- 确认用户要分发的精确版本、真实目标仓库/Registry、公共或私有范围、实际登录连接和材料许可。生成文件、个人发布或已有预览都不是上传授权；既有会话中的明确分发授权直接沿用。
- 用原 AppManage 的 export_release 动作，从 prepareRef，或 installationId + expectedRevision 导出；完整 AppReleaseExportRequest 放在 owner_request。
paths必须显式覆盖全部 payload + app-release.json；不包含服务物化 descriptor、owner 标记、个人数据和秘密。需要实际 ZIP 时，另在顶层给 export_file_ref（当前 Agent 原写权限目录的目标 FileResourceRef）与 expected_absent:true 或原 expected_etag；不能同时给两个条件或覆盖未知文件。核验响应的 files/size 和 archiveFile 的实际 fileRef/sha256/size/etag/replayed，sha256/size 必须等于 export 的 archiveDigest/size。读能力返回的 fileRoots 不授写权限；响应丢失保持同一目标、条件与完整正文恢复。downloadPath 是平台管理消费者路径，普通 HttpRequest 不自动注入凭据。 - 将真实 archiveFile.fileRef 交原实际授权上传工具；GitHub Release 上传此 ZIP 后，核读真实下载地址、固定 commit 和原始字节摘要；Gitea 私有仓库可提交
releases/<version>.zip，取得完整 commit 与该路径。可变 tag/latest 只作展示，必须解析到固定引用。没有真实来源回执就报告“制品已生成，尚未上传”。 - 使用原 AppManage 的 distribution_prepare 动作，owner_request 为 AppDistributionPrepareRequest：
exportRef、从 authoring_capabilities.registryTargetIds 选择的真实 registryRepoId、source:{kind:'release'|'git',url,ref,sha256,path?}和实际 metadata。目录目标列表是配置事实，不授予源端上传权限；普通模型不读取实例 token 或改 Origin 绕过认证。git 必须给固定包路径，sha256 必须等于导出 archiveDigest。产品 ID/名称/版本/入口不由 metadata 另填。 - metadata 包含 author/description/tags/category/license/redistribution/availability/requiredClientVersion，以及实际维护者、品牌和复核材料。证据不足保留 listing-only；不要填不存在的审核者、认证、发布时间或平台验收。已复核的许可证路径应来自同一 release 的 license role 文件。
- 返回的是
entries/<id>/manifest.json、catalog-metadata.v1.json、install.md内容和摘要。mapping 关联目标 sourceId、逻辑 ID、releaseDigest 与 archiveDigest，descriptor 安装时按真实来源物化。将三文件写入实际授权的目录仓库后审阅 diff，通过其原治理提交 PR；不能自动合并或说目录已开放。 - 查询真实目录可获取状态与目标客户端握手，再由第二用户/设备沿原 acquisition/app-install-manager 路径安装并核验。两来源同名不共享实例或数据；目录更新仅给更新候选，不改原安装快照。
候选 Registry 4.3 Schema 与客户端 reader 必须先分别 review；正式 Registry seed 只指已合入的受审提交。候选 reader 仅在明确受信的非官方测试来源开放，正式条目等待客户端能力发行，不能借 10.0.180 字符串跳过 app-authoring-v1。
私有源使用 access: private 的真实 Registry 连接，只读登记端点、不转公开镜像；认证失败拒绝新获取。字段不是 ACL，GitHub/Gitea 管理员仍负责实际成员权限。平台团队成员移除不自动改变源端 ACL，不能宣称已撤销。已下载字节不能收回，本机数据不自动删除。
离线可继续使用已核验的本地固定版本，远端依赖如实不可用；离线不能产生新的来源上传成功。目录撤回阻止新获取并保留理由，不自动卸载已安装应用。临时导出不修改当前个人发布，取消分发保留原工作台。