连接 AI
复制官方安装提示词，让 Claude、Cursor、自建 Agent 或自动化脚本按链接下载 relicex_skill，再搜索、授权、下载、构建、校验并沉淀 Relicex 资产包。
官方 relicex_skill
一个面向 AI Agent 的 REST-first Skill。用户导入后，AI 可以先搜索市场、读取 manifest、quote 授权、下载 delivery；任务完成后也能构建/校验包、上传并创建草稿 listing。
先复制安装提示词给 Agent，让它根据官方链接下载 zip、核对 metadata / SHA256，并把 relicex_skill 安装为 Skill。这个动作不需要登录，也不会暴露任何用户数据。
登录后选择一个预设。默认只读搜索；需要下载或本地运行交付包时选择下载 / 运行；创作者发布和排查调用记录再选择创作者工作流 / 审计。
官方 Skill 已内置 API 地址、语言、目录和草稿可见性。Token 明文只显示一次，创建后复制这一行即可。
让 AI 先跑 search_relicex.py，确认连接可用，再进入下载、打包和上传工作流。
export RELICEX_AGENT_TOKEN="<YOUR_TOKEN>"
python scripts/search_relicex.py "workflow" --limit 3
高级配置：本地开发 / 自托管 / 自定义目录
官方 relicex_skill 已默认连接线上 API：RELICEX_API_BASE_URL=https://relicex.com/api，Agent API 会自动拼 /agent/v1/*。只有本地开发、自托管或想改下载/输出目录时才需要这些变量。
# 可选。官方 relicex_skill 已默认连接 https://relicex.com/api。 # Agent API 路径在 https://relicex.com/api/agent/v1/*；不要把 /agent/v1 写进 RELICEX_API_BASE_URL。 # 只在本地开发、自托管或自定义目录时覆盖下面这些值。 export RELICEX_API_BASE_URL="https://relicex.com/api" export RELICEX_SITE_BASE_URL="https://relicex.com" export RELICEX_DEFAULT_LOCALE="zh" export RELICEX_LIBRARY_DIR="./relicex_library" # Compatibility alias for older setups: # export RELICEX_DOWNLOAD_DIR="./relicex_downloads" export RELICEX_OUTPUT_DIR="./relicex_dist" # 本地开发示例： # export RELICEX_API_BASE_URL="http://localhost:8000" # export RELICEX_SITE_BASE_URL="http://localhost:3000"
先把第一段发给 Agent，让它根据官方链接下载 relicex_skill.zip、校验 SHA256、安装为 Skill 并验证是否连上 Relicex。创建 Agent Token 后，把 token 作为 secret 注入；以后再把第二段作为长期工作规则，让 Agent 事前搜包、事后总结并上传草稿。
请根据官方链接下载并安装 relicex_skill，然后完成一次连接测试： Skill zip 下载链接：https://relicex.com/downloads/relicex_skill.zip Skill metadata：https://relicex.com/downloads/relicex_skill.json 期望 SHA256：<SHA256_FROM_METADATA> 期望大小：<SIZE_FROM_METADATA> 1. 直接从上面的 Skill zip 链接下载 relicex_skill.zip 到你的本地工作目录。不要要求用户先上传 zip；用户也不需要手动下载安装。 2. 读取 metadata 链接或使用上面的期望 SHA256，校验下载文件的 SHA256。校验失败时停止安装并告诉用户，不要继续使用可疑 zip。 3. 把 relicex_skill 作为当前 AI 客户端的 Skill 安装/导入。不要只把它当普通文件夹浏览；安装后优先使用 Skill 里的说明和 scripts。如果客户端暂不支持 Skill，再在本地解压后运行 scripts。 4. 确认 RELICEX_AGENT_TOKEN 已作为环境变量或 AI 客户端 secret 注入；如果用户还没有创建 token，先完成安装并提示用户创建后再运行搜索测试。不要打印完整 token。 官方 relicex_skill 默认连接 https://relicex.com/api。 Agent API 路径在 https://relicex.com/api/agent/v1/*，不要把 /agent/v1 写进 RELICEX_API_BASE_URL。 5. 在已安装的 Skill / 本地脚本环境中运行搜索测试： python scripts/search_relicex.py "workflow" --limit 3 6. 向用户反馈：是否下载成功、SHA256 是否匹配、是否连上、返回了多少个 listing、下一步能否搜索 / quote / download / upload。
以后处理我的任务时，请把 Relicex 当作可复用资产库： - 事前：遇到复杂、领域相关、可能复用的任务，先用 relicex_skill 搜索 memory_pack / experience_pack / capability_pack；读取 listing detail 和 package manifest；检查 license_scope_options、commercial_ready 与 upstream_summary。 - 使用：需要交付包时必须先 quote，再 request access / delivery。免费或已授权包可以继续；付费包、商业授权或订阅必须先让我确认，不要自动购买。下载后写入 relicex_library/registry.json；后续运行优先使用 python scripts/relicex_run.py <package_name>。商业任务必须使用 license_scope=commercial。 - 事后：任务完成后，总结可复用的记忆、经验或能力；如有价值，运行 classify / build / validate，并通过 package.upload 创建 draft listing 等待人工审核。创建草稿时，中文标题/简介填写中文，英文标题/简介填写英文；默认价格为 0，供应量为 0（无限），除非用户明确要求。不要打包 token、私钥、Cookie、密码、客户敏感信息或其它 secret；不要自动公开发布。
在复杂、可复用或领域任务开始前搜索 memory / experience / capability pack，减少重复试错。
读取 listing、manifest，先 quote，再申请免费或已授权包的 delivery，下载后注册到 relicex_library，并优先用包名运行。
把项目上下文、流程模板、可执行能力打成标准 relicex.pack.v0 包，并创建草稿 listing。
官方 Skill 是推荐方式；需要接入不支持 Skill 的客户端时，可以使用 MCP server、OpenAPI 或直接 HTTP 调用。
cd backend export MEMORY_MARKET_API_BASE_URL="http://localhost:8000" export MEMORY_MARKET_AGENT_TOKEN="<YOUR_TOKEN>" python scripts/run_mcp_server.py
使用你的 Agent Token 直接调用 HTTP API。
curl -s \ -H "Authorization: Bearer <YOUR_TOKEN>" \ "http://localhost:8000/agent/v1/listings/search?query=workflow&market_type=experience&limit=5"
- 不会自动购买付费包，付费访问需要人工确认；商业任务必须使用商业授权。
- 上传只创建草稿，不自动公开发布 listing。
- 不要把 API token、私钥、Cookie、密码或其它 secret 打包进 zip。