mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-10-21 05:04:36 +08:00

Files

Yige a514b55b68 feat: 收录应用开发发布技能与双语示例 (#214 )

## 中文

新增按需调用的内置技能 `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.

2026-10-18 17:53:37 +08:00

4.4 KiB

Raw Blame History

环境探测 JSON 协议

probe.sh / probe.ps1 / probe-python.sh / probe-node.sh 输出统一 JSON。Skill 解析 JSON 后再决策，避免逐条 grep。

通用字段

字段	类型	说明
`platform`	`"darwin" \| "linux" \| "win32"`	操作系统标识
`arch`	`"arm64" \| "x64" \| ...`	CPU 架构
`desirecore_api`	`string`	探测到的 DesireCore agent-service URL，不可达时为 `""`
`desirecore_port_file`	`boolean`	`${DESIRECORE_ROOT}/agent-service.port` 是否存在（probe.sh / probe.ps1 输出原生 JSON boolean）

probe.sh / probe.ps1（父级 dev-environment-setup）

输出系统级总览：

{
  "platform": "darwin",
  "arch": "arm64",
  "desirecore_api": "https://127.0.0.1:38291",
  "desirecore_port_file": true,
  "tools": {
    "python3": { "available": true, "path": "/opt/homebrew/bin/python3", "version": "3.12.4" },
    "pip3":    { "available": true, "path": "/opt/homebrew/bin/pip3",    "version": "24.0" },
    "node":    { "available": true, "path": "/opt/homebrew/bin/node",    "version": "22.4.1" },
    "npm":     { "available": true, "path": "/opt/homebrew/bin/npm",     "version": "10.8.1" },
    "docker":  { "available": false },
    "podman":  { "available": false },
    "git":     { "available": true, "path": "/usr/bin/git", "version": "2.43.0" }
  },
  "wsl": null
}

Windows 上 wsl 字段值类似 { "installed": true, "version": "2", "defaultDistro": "Ubuntu" }。

probe-python.sh（python-runtime 专用）

{
  "platform": "darwin",
  "arch": "arm64",
  "desirecore_api": "https://127.0.0.1:38291",
  "system_python": { "path": "/opt/homebrew/bin/python3", "version": "3.12.4" },
  "system_pip": { "path": "/opt/homebrew/bin/pip3", "version": "24.0" },
  "hatch_path": "/Users/example/.desirecore/runtime/hatch/hatch",
  "hatch_version": "1.16.5",
  "hatch_versions": ["3.11", "3.12"],
  "active_venv": "/Users/example/proj/.venv",
  "pep668": false,
  "pyenv_path": "",
  "conda_path": ""
}

字段语义：

hatch_path 空字符串表示二进制不存在
hatch_versions 是 ${DESIRECORE_ROOT}/runtime/hatch/local/ 下的目录列表（即已通过 Hatch 安装的 Python 版本）
active_venv 取自 $VIRTUAL_ENV 环境变量
pep668 检测 /usr/lib/python*/EXTERNALLY-MANAGED 是否存在（Debian 12+/Ubuntu 23.04+ 启用）

probe-node.sh（nodejs-runtime 专用）

{
  "platform": "darwin",
  "arch": "arm64",
  "desirecore_api": "https://127.0.0.1:38291",
  "system_node": { "path": "/opt/homebrew/bin/node", "version": "22.4.1" },
  "system_npm":  { "path": "/opt/homebrew/bin/npm",  "version": "10.8.1" },
  "volta_path": "/Users/example/.desirecore/runtime/volta/volta",
  "volta_version": "2.0.2",
  "volta_tools": {
    "node": ["22.4.1"],
    "pnpm": ["9.5.0"],
    "yarn": [],
    "npm":  []
  },
  "package_json_volta": null,
  "nvm_path": "",
  "fnm_path": "",
  "registry": "https://registry.npmmirror.com/",
  "proxy": ""
}

字段语义：

volta_tools 来自 <volta> list --format=plain，按工具分类
package_json_volta 若当前目录存在 package.json 且其中有 "volta" 字段，填入对象；否则 null
registry / proxy 来自 npm config get registry / npm config get https-proxy

设计约定

JSON 必合法：缺字段也保留键并赋空字符串/null，避免 Claude 解析失败。
不阻塞：每个外部命令都加 2>/dev/null，失败用空值，不让脚本中途退出。
超时控制：HTTP 探测 0.5s 超时（curl --max-time/PowerShell TimeoutSec）；CLI 调用（--version 等）依赖工具自身实现，无显式 timeout 包装，正常情况通常 <5s 完成。
跨平台：probe.sh / probe-python.sh / probe-node.sh 共用 POSIX 子集；Windows 同等功能由 probe.ps1 提供（仅父级提供，python/nodejs 子 skill 可由 PowerShell 直接 invoke 父级或自行实现）。
路径展开：所有 ~ 在 JSON 中展开为绝对路径，避免下游解析歧义。

调用约定

SNAPSHOT=$(bash skills/python-runtime/scripts/probe-python.sh)
echo "$SNAPSHOT" | jq .

# 关键字段判定
HATCH=$(echo "$SNAPSHOT" | jq -r .hatch_path)
[ -n "$HATCH" ] && [ "$HATCH" != "null" ] && echo "Hatch 可用"

PowerShell 等价：

$snapshot = & "$PWD\skills\dev-environment-setup\scripts\probe.ps1" | ConvertFrom-Json
if ($snapshot.tools.node.available) { ... }

4.4 KiB Raw Blame History Unescape Escape