SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场helix-foundry

helix-foundry

数据与分析

查看项目

更新于 10-29 04:37

技能介绍

用途

本技能用于 HelixDB/helix-foundry 的检出与运行安装。Helix Foundry 是一个本地优先的公司数据工作区，将数据库、托管服务商、API、文件、Stripe、WorkOS 与 PostHog 等连接起来。它是一个单机、单所有者的应用：资源文档与关系边存储在 HelixDB 中，而隔离的 DuckDB 执行器查询不可变的 Parquet 快照。

主要能力

  • 运行离线预检脚本，盘点主机二进制，并在提供 --repo 时检查受限的公共仓库形态、Git show-toplevel 与 rev-parse HEAD。
  • 检查现有本地安装：读取参考文档后，获取经所有者批准的、仅回环的健康检查、Compose ps/近期日志与 API 文档。
  • 支持新安装或恢复流程：在参考文档中选定模型路径并查看精确的固定命令，再提出 setup.sh、Compose 启动、备份、恢复或升级方案。
  • 将通用模式/实体规划路由到 database-schema-design，API 契约路由到 api-design，认证/会话设计路由到 authentication-setup，.env 策略路由到 environment-setup，机器/容器接入路由到 system-environment-setup，安全加固路由到 security-best-practices，发布提升/回滚路由到 deployment-automation，后端测试策略路由到 backend-testing。

使用方式

在任何操作者动作之前运行离线辅助脚本：

python3 .agent-skills/helix-foundry/scripts/preflight.py --json

已安装根目录：

python3 "$SKILLS_ROOT/helix-foundry/scripts/preflight.py" --json

离线源与主机预检示例：

python3 .agent-skills/helix-foundry/scripts/preflight.py --json
--repo /path/to/helix-foundry
--expect-commit 84899851d845d1db98f9e328634f14e0ed4ad7b7

状态解读：ok 仅表示通过离线检查；Docker 路径不等于 Docker 守护进程健康，Compose 候选不等于 Compose v2 插件可用。runtime_verified: false 是权威结论。

现有本地安装检查：读取 references/upstream.md，然后获取经所有者批准的、仅回环的健康检查、Compose ps/近期日志与 API 文档。不要整体读取 .env。如果身份已存在，允许只读 GET /api/v1/me；在全新安装上，该请求是配置变更，必须按上述方式设门控。

新安装或恢复：选择模型路径，并在提出 setup.sh、Compose 启动、备份、恢复或升级之前，查看参考文档中的精确固定命令。保持提供商密钥、数据库密码、OAuth/API 令牌与模型/API 支出归用户所有。

适用场景

  • 在单台计算机上安装并运行 Helix Foundry。
  • 检查现有本地安装的健康状态、Compose 状态与日志。
  • 执行备份、恢复或升级（需所有者批准）。
  • 连接数据库、托管服务商、API、文件、Stripe、WorkOS 与 PostHog 等数据源。

限制

  • 服务仅限回环：Compose 发布到 127.0.0.1；不要通过 LAN、反向代理、隧道或服务器级网络变更暴露应用。
  • 保持 .env、卷、备份、提供商凭据与备份密钥文件私密。绝不打印、复制或整体读取机密。
  • 所有有后果的工作都需设门控：源测试或同步、摄取/上传、管道运行、提供商或托管连接、助手动作、数据集接受、本体提案的验证/发布/拒绝/执行，或任何外部 API 调用或成本，均需明确批准与正确的工作区/令牌。
  • 绝不使用 docker compose down -v 或手动删除卷；这会删除工作区、快照与存储的凭据。
  • 备份、恢复与升级会短暂停止或替换数据，因此需要所有者批准、匹配的检出/备份与回滚决策。
  • 移除源不会在其提供商处撤销凭据。
  • 预检脚本从不启动 Docker/Compose、调用健康 URL、读取 .env、读取密钥、联系提供商或声称 Foundry 正在运行；其 runtime_verified 字段始终为 false。
  • 将源测试、生成的 SQL、本体提案与助手构建视为可审查的输出，而非权威。
  • 为现有卷保留匹配的 .env/加密密钥；替换它可能导致存储的凭据无法恢复。
  • 在任何有状态或破坏性操作之前，优先使用最小的只读证据集。
  • 将未知的守护进程/插件/模型就绪状态报告为未知，而非就绪。
  • 将操作声明固定到上游提交 84899851d845d1db98f9e328634f14e0ed4ad7b7。

参考

references/upstream.md — 固定源形态以及 Compose/模型/API/身份/备份/SDK 操作与出处。

固定上游树、固定 README 与 setup、固定 AGENTS runbook、固定 API 契约、固定操作限制。