用途:这是社区项目生态的技能端客户端,用于发布、fork、列出、更新和整理可运行代码项目。项目与技能不同:技能是工作流指令,项目是可运行代码。后端为网关 https://community.iamstarchild.com/api/code-projects/*(X-Internal-Key 认证),存储使用 Starchild-ai-agent/community-projects GitHub 仓库,安装目标为 output/projects/{slug}/。
主要能力:publish_project(project_dir, version_bump) 发布;fork_project(source, dest_dir) 拉取安装,支持 user_id/slug 或 user_id/slug@version;list_projects(type, tag, user, q) 浏览搜索;update_project 更新;tidy_project(any_dir, type) 整理零散代码;validate_project(project_dir) 发布前校验。项目类型分 task(定时任务)、preview(网页应用)、service(长驻进程)、script(一次性脚本)。
使用方式:项目须遵循固定结构,含 project.yaml、PROJECT.md、.env.example、.gitignore 及 src/ 下的对应入口文件(run.py、index.html、server.py、main.py)。可通过 bash 块导入 exports 中的函数调用。
限制与规则:slug 须为小写字母数字与连字符,3-50 字符且与文件夹名一致;版本遵循严格 semver,重复版本会被拒绝,类型发布后不可更改;发布前须先展示差异并确认,不自动运行 setup.sh,环境变量需一次性批量收集。