Skip to content

About

Apache-2.0 forkable Core for enterprise AI delivery: review-first enterprise AI operations systems, public SDK, sample packs, docs, tests, and Docker quickstart for delivery engineers.

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,771 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

语言 / Language:中文 · English

Helm

多组织账号可点击顶部姓名/组织区域切换已授权的工作区;切换后重新加载目标工作区首页。单组织账号保持原有展示。

把分散的企业经营信号,转成可复核的判断、风险、下一步动作和交付闭环。

Helm 是面向企业一号位、AI 交付工程师和企业 AI 运营团队的 open-source Core。

它不是让 AI 自动经营企业,也不是替人自动决策。Helm 帮团队更快看清:现在发生了什么,谁需要判断,风险在哪里,下一步该怎么推进,以及哪些事情绝不能自动承诺。

交付预算接入前请核对 LLM spend charge contract v2:当前只有最大费用、不可变价格/汇率/策略来源快照及原子账本候选,新增空注册表的签名元数据读回候选及 opt-in C3 接口;发行者身份、真实计价/用量、普通付费出口和生产限额仍未闭合,默认 authority 保持关闭。 受控用量采集的源码与合成验证见 独立证据核销合同:默认仍无生产 collector/根,不代表真实 provider 账单、安装或月限额已生效。 通用用量的可选去重与追加更正见 Scoped usage observations / 工作区用量记录;不自动迁移旧调用,不创建账单、退款或供应商调用。 计费 V1 付款主体与范围绑定见 Billing payer accounts / 付款主体:仅身份与可撤销绑定,默认 billingMode=off,无余额、扣费或收款。

WorkBuddy 部署准入见 固定路由合同:关闭或未知固定绑定先于入口配置和数据库依赖加载拒绝,Core 默认保留旧行为;源码验证不代表现场激活。

License:Apache-2.0 · 仓库姿态:open-source Core,已在 owner Go/No-Go 后公开 · Helm Cloud / Enterprise:商业版可选,不替代开源

扩展外部成员的登录落地优先级与服务端页面边界见 Solution extension 协议。

最快理解路径:企业管理者先看下方"为什么关心"与"方法论";交付工程师直接跑 docker compose up 和 Golden Path;合作伙伴可先用公开样例判断咨询 / 交付场景,不需要客户数据。


一句话定位

Helm 是一套"经营信号 → AI 辅助判断 → 人工复核 → 可追踪推进"的开源参考实现 + 方法论。

通用 agent 平台告诉你"怎么搭"。Helm 帮你把企业 AI 试点和客户交付里的判断、证据、复核、边界、交付包做成可 fork、可验证、可继续商业化交付的工程结构。

完整论述见 HELM_FOR_DELIVERY_ENGINEERS_V1.md。

最新商业叙事的 public-safe 需求见 HELM_PUBLIC_BUSINESS_NARRATIVE_REQUIREMENTS.md: Helm 可以从合规销售过程信号切入,形成 Sales Process Intelligence、AI Diagnostic、 生态交付和行业 Pack 复利;但不得被讲成耳机公司、AI 产品分销商、CRM 替代或外包公司。 其中 Trust Center / AI Shelf 的 public-safe 合成契约由 docs/product/fixtures/ai-shelf-trust-center-contract.fixture.json 与 npm run check:ai-shelf-trust-center-contract 机器验证;这不是法律意见、供应商认证、 转售授权、客户部署或生产回执。


企业一号位为什么会关心

企业 AI 试点最大的卡点,往往不是模型不够强,而是经营信号没有变成行动:

  • 客户反馈、销售线索、项目风险、会议承诺、交付阻塞分散在不同系统里
  • 管理层看到的是滞后的汇总,不是今天必须推进的判断
  • AI 很容易生成建议,但难以说明证据、边界、责任人和下一步
  • 团队担心 AI 自动外发、自动承诺、权限越界,导致试点停在演示层

Helm 的价值是把这些信号收拢成可复核的经营推进闭环:先看清真实状态,再形成判断,再进入人工复核,再推进下一步,并留下证据。


Helm 的方法

  1. 收集经营信号:客户沟通、CRM、会议、邮件、项目进展、风险反馈、外部线索。
  2. 结构化业务对象:客户、机会、项目、事实、承诺、阻塞、风险、下一步。
  3. 形成判断建议:今天最重要的 3-5 个推进点、原因、证据、影响面和边界。
  4. 进入人工复核:客户可见动作、承诺、CRM 阶段变更和高风险建议都必须人工确认。
  5. 沉淀交付证据:每次判断、建议、边界和动作都有 trace,方便管理复盘和交付复用。

这套方法的目标不是"AI 自动经营企业",而是让企业经营推进更及时、更可控、更可复盘。


如何支撑 GTM:把兴趣转成可验证能力

Helm 的 GTM 目标不是先制造销售话术,而是让不同角色能用同一套证据路径完成判断:

GTM 对象 他们需要相信什么 README 给出的转化动作
企业一号位 AI 不只是 demo,而是能进入经营推进、风险识别和复核闭环 看 90 秒 demo,判断是否适合 AI 试点治理和经营推进
交付工程师 Helm 不是黑盒产品,而是可 fork、可改、可验证的交付资产 跑 Golden Path,改一条 synthetic fixture,证明边界仍成立
AI 咨询 / 交付伙伴 Helm 能沉淀成方法、案例、资产和后续服务能力 用 public-safe 场景评估合作,不把客户信息放公开 GitHub
开源贡献者 贡献入口清楚,边界明确,不会误触商业或客户私有内容 从文档、fixture、只读 connector、dry-run 和 public-safe issue 开始

最终要形成的市场能力是:把"我对 AI 经营推进有兴趣"转成"我能用公开样例试、能判断适不适合、能知道如何联系、能继续进入受控合作评估"。


它解决了什么(交付工程师视角)

通用 agent 平台和 LLM framework 解决了"怎么搭"。剩下三个问题仍要由交付团队承担:

  1. 该搭什么 — 企业客户真实诉求是"今天必须由谁拍板的 3 件事 + 为什么 + 边界",不是一个聊天框
  2. 怎么不出事 — AI 越权外发 / 自动承诺 / 跨租户串数据,平台不替你扛,你的客户会替你扛
  3. 怎么交付得快 — 每个客户从零建模 / 搭审批闸 / 写连接器 / 做 dashboard,你的人月被烧光

Helm 把这三件事预先编码进一个开源参考实现。


你可以怎么开始

你是谁 建议路径
企业一号位 / 管理者 先看 90 秒 demo,判断 Helm 是否适合你的 AI 试点治理、经营推进和交付复盘
交付工程师 跑 Golden Path,改一条 synthetic fixture,验证判断 / 证据 / 复核 / 边界是否仍成立
AI 咨询 / 交付伙伴 用公开样例评估合作场景;涉及客户信息时只做私下抽象讨论,不放公开 GitHub
开源贡献者 从文档修订、Golden Path 反馈、只读 connector、fixture 和 dry-run 边界开始

90 秒看到 Helm

git clone https://github.com/Helm-OpenSource/helm-public.git
cd helm-public
cp .env.example .env       # 默认本地 MySQL
docker compose up          # mysql:8.4 + app
open http://localhost:3000

第一屏即 /operating(经营信号流图)、/approvals(复核闸)、/memory(经营记忆)三张已经可工作的面。

当前演示使用公开合成数据,不代表真实客户业务流。请不要把客户数据、私有域名、生产日志、部署证据或内部项目信息放入公开仓库。

需要本地 Docker Desktop / OrbStack / colima。仅启动最小集(不含连接器、AI、支付)。 中国大陆 / 受限网络环境可先配置本地 npm 与 Docker 镜像:cp .npmrc.example .npmrc, 再用 NPM_REGISTRY=https://registry.npmmirror.com docker compose up --build;Docker Hub 基础镜像仍需在 Docker daemon 配置你们组织认可的 registry mirror。详见 getting-started.md §1.1。

npm run delivery:doctor 与 npm run pack:fixture-check 是交付工程师 fork 后的本地只读自检命令,需要先 npm install;不是 "看到 Helm" 路径的必经步骤,详见下方入口表。

交付工程师 Golden Path

这条路径回答三个问题:我能否信任边界、我该改哪里、我能否证明没有越权。它复用已有 surface,不新增页面、包或命令。

npm run delivery:doctor
npm run delivery:doctor -- --region cn   # 中国客户交付前的本地静态预检
npm run golden:path                       # 生成 /tmp/helm-golden-path-proof 本地证据包
npm run pack:fixture-check
npm run eval:headless-signal-interface
npm run check:public-release

npm run golden:path 是当前推荐的单一 first proof 入口。它只写 /tmp/helm-golden-path-proof,生成 MANIFEST.json、doctor-receipt.json、 pack-fixture-receipt.json、fixture-diff-summary.json、hsi-eval-result.json、 public-release-guard-receipt.json、source-profiler-receipt.json、 boundary-note.md 和 next-safe-actions.md。这只是本地 public-safe 证据包, not customer deployment readiness、not release readiness、not connector authorization、not writeback、not external send、not approval execution。

Agentic / SARP 复核的本地证据包可用 npm run sarp:proof 生成到 /tmp/helm-sarp-proof。它只使用 synthetic AgentRunCapsule fixture 和 deterministic SARP receipt,不调用 LLM、不外发、不审批、不写回、不激活 connector。

数据接入先按 Helm 数据接入体验 走 source-intake-first:L0 诊断材料 → L1 脱敏 fixture / dry-run → L2 只读接入。 这条路径不授权写回、外发、审批执行或客户部署。

第一处可验证改动:

  1. 打开 extensions/case-management-sample/fixtures/case.sample.json。
  2. 找到 CASE-SAMPLE-002,把 "priorityScore": 64 改成 "priorityScore": 82。这只改变 synthetic fixture 的优先级,不引入真实客户数据。
  3. 观察 mapper 变化:
npx tsx -e "import fs from 'node:fs'; import { mapCaseRecordToSignals } from './extensions/case-management-sample/signals/case/case-mapper.ts'; const cases = JSON.parse(fs.readFileSync('extensions/case-management-sample/fixtures/case.sample.json', 'utf8')); const sample = cases.find((item) => item.caseId === 'CASE-SAMPLE-002'); const signal = mapCaseRecordToSignals(sample)[0]; console.log(signal.identity.severity, signal.payload.nextAction);"

改动前输出应为 info continue_followup;改动后应为 warning continue_followup。

  1. 跑边界和公开检查,确认这仍只是 review-first sample 改动:
npm run pack:fixture-check
npm run eval:headless-signal-interface
npm run check:public-release
  1. 回到 /demo / /operating 看判断、证据、复核、边界是否仍保持 review-first。

Public Core P0 的最小可演示链路是:

public fixture evidence
  -> signal(sourceRef / time / subject / confidence / gapFields)
  -> memory candidate only
  -> review packet(evidence / recommendation / risks / boundaries / nextSteps / owner)

这条链路不会自动外发、自动审批、执行动作、写 CRM,或把候选项升级成正式记忆。

交付工程师 Golden Path 的验收口径见 HELM_DELIVERY_ENGINEER_GOLDEN_PATH_REQUIREMENTS.md。extensions/case-management-sample/ 已提供可读 / 可改的最小公开 sample pack;Docker / fresh-clone 证据见 D2 smoke receipt,以 review receipt 和 gate 状态为准,不写成日期承诺。


什么情况下适合试 Helm

适合 暂不适合
已经有 AI 试点,但缺少经营推进、复核和证据闭环 只想要一个通用聊天机器人
咨询 / 交付团队需要把 AI demo 变成可管理的交付系统 只想做通用 BI 报表或一次性自动总结
客户担心 AI 自动承诺、自动外发、权限越界 需要 AI 自动审批、自动外发、自动替人决策
团队需要连接 CRM、会议、邮件、IM 等经营信号源 需要完整企业 SSO / SCIM / 多租户平台即刻上线
需要把判断、证据、复核和边界做成可 fork 的工程资产 需要第三方 plugin marketplace 或完整 workflow engine

Helm vs AI agent 平台 / LLM framework

AI agent 平台
(Coze / 悟空 / Dify)
LLM framework
(LangGraph / LangChain)
Helm
抽象层级 拖拉拽 / DAG 编辑器 SDK + primitives 有意见的整机 + 图纸
给你什么 积木 + 配置面板 抽象类 + utilities 可工作的经营推进闭环 + vertical 参考实现
业务 domain 知识 你自带 你自带 内置:信号 / 案件 / 闭环 / 复核模型已建模
Advice vs Commitment 边界 看你怎么配 看你怎么写 eval gate 编码强约束
多租户隔离 平台层(黑盒) 你自己实现 Deployment Profile + Tenant Overlay 四层切割
中文 connector 部分 你自己接 DingTalk / IMAP / 阿里邮箱 / Qwen 内置可工作样板
是否可全部 fork 产品而异(Dify 可自托管;托管平台通常锁定) 是(无 vertical) 是(Apache-2.0 + vertical pack)
可 fork 的本地闭环 否 否 docker compose up + Golden Path checks
商业模式(对你) 平台抽成 / 走他们渠道 你自定价 open-core:fork 商用自营,Helm 不抽成

对比的是类型,不是某产品当下功能勾选;平台会持续演进,差异点在抽象层级与产品形态。Dify 官方文档强调其 open-source / self-hostable 形态,本表按可视化编排型 AI 应用平台比较,不把 Dify 归入闭源锁定平台。


5 步本地起服务

npm install                   # 1. 安装依赖
cp .env.example .env          # 2. 配置环境
npm run db:generate && npm run db:migrate && npm run db:seed   # 3. 数据库
npm run dev                   # 4. 启动
open http://localhost:3000    # 5. 访问

更详细的开发上手指引见 docs/getting-started.md。

.env.example 三档:

档位 字段 说明
MUST DATABASE_URL、APP_URL、CONNECTOR_TOKEN_SECRET 起服务的最小集
OPTIONAL_AI OPENAI_API_KEY、DASHSCOPE_API_KEY、DASHSCOPE_BASE_URL、LLM_* 缺失时给 placeholder + banner,不会崩;默认 provider 为 Qwen
PROFILE HELM_DEPLOYMENT_REGION、HELM_DATA_RESIDENCY、NPM_CONFIG_REGISTRY public-safe region / residency / npm registry override 姿态;不构成生产合规声明
RUNTIME_ATTESTATION HELM_HEALTH_ATTESTATION_MODE、HELM_RUNTIME_DEPLOYMENT_ID 默认仅做公开可达性检查;source-built 发布可显式选择 artifact-bound,由私有发布流程注入 non-secret opaque ID,并在缺失或非法时让 /api/health 返回 503
PUBLIC_IDENTITY HELM_PUBLIC_OPERATOR_DISPLAY_NAME、HELM_PUBLIC_OPERATOR_LEGAL_NAME、HELM_PUBLIC_OPERATOR_REGISTRATION_VERIFIED /terms 与 /privacy 的部署运营主体;法定名称只在私有发布流程已核验证据且 verification 精确为 true 时显示
OPTIONAL_CONNECTORS DingTalk · WeCom · HubSpot · Salesforce · Stripe · 支付宝 · 微信支付 按需开启

登录页的构建时样式入口是 app/(auth)/login/appearance.css,Core 默认为空。 部署可在已审核的构建阶段向该固定目标组合样式;无需新增运行时环境变量。 页面使用稳定 scope,详情见部署入口配置。

ASR 支持两个 provider:默认 openai(transcription path),以及 ASR_PROVIDER=dashscope (Qwen qwen3-asr-flash,OpenAI 兼容 chat 端点 + base64 内联音频,音频不出境、不产生 公网 URL;需 DASHSCOPE_API_KEY)。delivery:doctor --region cn 会按 provider 判定 中国交付红线:在中国 profile 启用 ASR 时,选择 OpenAI,或选择 DashScope 但缺少 key, 都会告警。


当前能做(参考实现的 surface 一览)

这些 surface 是 Helm 参考实现的一部分。fork 后你可以全部改、全部砍、全部加。

入口 作用
/dashboard 今天的工作:推进、复核与继续入口
/mobile 移动端窄屏经营推进入口 + Ask Helm
/operating 经营总盘:判断 / 决策 / 边界三层
/approvals 客户可见草稿、CRM 阶段变更全部在这里等你点
/memory 经营记忆:事实、承诺、阻塞、修正——可引用、可复核;统一 trace timeline 仍是 release hard gate
/search?mode=ask 直达对象,或直接问 Helm(只读,附引用;行动需求会生成证据化行动包)
/setup 6 步 12 分钟初始化,5 分钟内看到第一张判断卡
/capture 按下录制 → 60 分钟会议目标 90 秒生成事实 / 承诺 / 跟进候选;高风险项必须复核
/reports 周复盘:过去两周一页看完 + 下周该抓什么
/settings 工作区控制台:连接器、策略、试点模式、保留期、自助导出
/health 公开可演示健康摘要:只展示可达性、workspace-first、先复核和审计守卫姿态;不暴露内部运行探测或隐藏采用
/trust-center 公开信任姿态:授权 / 告知 / 保留期 / 审计 / 撤销 / 认证 / 禁止项与灰色设备红线一页看清;渲染机器校验的合成契约,不构成法律意见或合规声明

技术栈:Next.js 16 (App Router) + React 19 · MySQL + Prisma · Tailwind CSS 4 + Radix UI · TypeScript(严格模式) · Vitest + Playwright


主流系统接入

接你客户的现有系统是你的核心交付动作——这套接口给你模板。 保留客户已经在用的系统。Helm 在它们之上长出"今天该做什么"。

第一步不是直接连接生产系统,而是先做数据来源诊断:确认手上已有的会议摘要、IM / 邮件 digest、CRM / 工单 snapshot、脱敏表格、业务系统显式标记或只读 API 授权,再决定 L0 / L1 / L2 路径。详见 数据接入体验。

已支持

状态口径:Stable = 主路径已可运行,缺少凭据时会明确降级;Alpha = 最小闭环已落,但仍依赖配置、样本或后续 hardening;Roadmap = 已建占位,未默认启用。

类型 系统 状态 说明
CRM HubSpot Stable 只读同步 + 经营信号层
CRM Salesforce Alpha 默认 authMode=MOCK 走示例数据;接入真实 OAuth 凭据后切换
企业 IM DingTalk(钉钉) Stable OAuth + Directory;目录邀请走复核闸口,不自动外发
企业 IM Feishu(飞书) Alpha OAuth callback foundation + public auth + env-backed Bitable read-only ingest;message draft(review-first)仍待下一层
企业 IM WeCom(企业微信) Alpha OAuth callback foundation + meetings read-only ingest;calendar / message / send 仍保持边界
邮件 Gmail Stable OAuth + IMAP 读取;外发走复核
邮件 阿里邮箱 Stable IMAP 同步 + 系统 SMTP(手动显式发送)
会议 录音 / 转写 / 经营理解 Alpha 浏览器录音 MVP + 外部 transcript ingest + OpenAI / DashScope(Qwen) ASR;不是实时会议录音转写平台,不含 Zoom / 腾讯会议原生音频接入
支付 Stripe Stable 真 API(订阅 / 支付链接)
支付 支付宝 Stable 真网关 + RSA-SHA256 签名
支付 微信支付 Alpha 适配器已落,生产前需运维确认密钥与回调
LLM OpenAI 兼容 / 本地 Gemma Stable provider=openai;通过 LLM_BASE_URL 接任意 OpenAI-compatible endpoint
LLM Qwen(阿里云百炼) Stable provider=qwen;默认模型 qwen3.6-plus,默认 endpoint https://dashscope.aliyuncs.com/compatible-mode/v1

路线图——公开征集贡献

如何贡献:开 issue 标签 integration: <system>,先讲清楚「客户用例 / 数据流向 / 治理边界」三件事,再写代码。

🔥 P0 · 仅限首批推进入口

系统 期望能力
Microsoft 365(Teams + Outlook + Calendar) Calendar pull · Teams capture · Outlook draft
Google Workspace(Calendar + Gmail + Drive) Calendar pull · Gmail thread · Drive doc reference
Slack Channel digest · draft message(review-first)
Zoom 会议录制 / transcript ingest;不承诺实时会议平台替代

🧭 Issue-driven 候选池

Pipedrive、Zoho、Dynamics、Notion、Coda、腾讯会议、Webex、用友、金蝶、HRIS、Jira、GitHub、通话、税务、现金流等方向先走 integration: issue。我们会判断是否服务于"会议 / CRM / 邮箱 → Must Push → Review Action"的首批闭环;不承诺排期。

可接受 PR 的边界

类型 允许范围
只读连接器 read-only ingest、fixture、dry-run、边界文档
草稿型能力 draft / preview / review-first,不自动外发
证据层适配 进入 evidence candidate,不直接进入 Must Push truth

我们对集成方的 5 条原则

  1. 人工看见,边界先行:integration: issue 会按公开社区节奏人工查看;回复目标见运营文档,但不构成排期或实现承诺。
  2. 3 类清晰边界:每个集成上线时公开"自动做什么 / 复核后做什么 / 永远只人工"。
  3. 不替你给客户发送:所有客户可见的动作永远等用户点击。这条线不退。
  4. 数据可携带:所有接入的数据,一键自助导出(/settings)。
  5. 审计 trace:关键集成动作带 trace ID;统一用户可见 trace timeline 仍是发布硬门,未落地前不宣传"0 秒回放"。

集成模板

docs/integrations/INTEGRATION_TEMPLATE.md(随 v0.1.0 一起开放)包含:

  • 数据流声明模板
  • 边界三轨表(auto / review / never)
  • OAuth + API key 安全清单
  • 测试夹具 + dry-run 模式
  • 用户可见命名规范
  • 退出与数据回收

联系方式

路径 用途
GitHub Issues integration: 标签 公开征集 / 路线图讨论
GitHub Discussions 社区问答、卡点求助、vertical 共建
微信 ffjw0821 联系我们 / 商业合作 / 联合发布 / 社群邀请(受控人工对接)
问题反馈(公开) GitHub Issues(bug、文档勘误、功能建议)
问题反馈(私密) 安全相关仅走 SECURITY.md 私下披露流程
开源增长作战表 发布后 7 天的社区、激活、反馈和边界化运营节奏
docs/product/HELM_OPEN_SOURCE_COMMERCIAL_BOUNDARY_PLAN.md 开源 / 商业边界

当前刻意不做

  • 完整企业 SSO / SCIM / 多租户平台
  • 完整 workflow / orchestration / agent 编排引擎
  • 完整 BI / 报表中心
  • 自动执行 · 自动审批 · 自动结算 · 自动外发
  • 插件市场 · App store
  • 第三方 plugin runtime / sandbox;当前 extension seam 只服务 first-party / private tenant extension
  • 多轮聊天历史持久化 · 跨工作区自动聚合
  • LLM 在承诺路径做最终排序
  • SaaS 直销给端客户(Helm Inc. 仅保留少量具名直营灯塔客户,用于打磨方法论与行业 Pack;在这些具名客户之外,不和交付工程师抢生意)

核心纪律:Recommendation ≠ Commitment

  • 建议(Recommendation):系统建议,需人工复核。
  • 承诺(Commitment):具有业务影响的正式行动,必须明确授权。
  • 任何客户可见措辞,如可能被误读成承诺,会被显式降级为「边界备注 / 前置 / 依赖 / 非承诺备注」。

这条不是商业承诺,是代码 + eval 提供的可审计约束:OPERATING_SIGNAL_ALLOWED_NEXT_ACTION_SET 闭集、commitment: "suggestion_only" 写死、crossTenantProjection: false eval 硬拒;对外商业承诺仍以人工授权和合同为准。

详见 AGENTS.md §6-§7、lib/operating-signal-flow/contract.ts。


路线图

Now

  • Public Core、Docker quickstart、case-management sample pack、Golden Path doctor、offline evals、public-release guard。
  • Repo split 边界:Core 留在本仓;行业 Pack、客户 Overlay、BOM / 授权 / deployment metadata 各自走对应私有目标仓,不回塞 Public Core。
  • Repository visibility is public after the owner Go/No-Go; future release, tag, and announcement changes remain owner-gated.
  • README · 治理文档 · .env.example 分层 · docker-compose.yml · 中国大陆 / 受限网络本地镜像指引。

Next

  • 清理所有冻结 helm2026 公开链接和日期式 release 文案。
  • 把 Builder walkthrough 写成"改这行 → 跑这命令 → 看到这变化"的可复核路径。
  • 完成 sample provenance gate、fork-and-rename guide、"Helm 不做什么"、forker upgrade story。
  • 在对应治理仓另起只读 split doctor,聚合 Core / Pack / Overlay / BOM readiness。
  • 继续收敛 degraded-mode health surface、Required Reviewer 评审、redacted live DB calibration 和生产部署 runbook / image 边界。

Later

  • 社区贡献 vertical pack 的协作机制(开源 vertical vs tenant-private 边界)
  • Helm Cloud(托管版)公开 beta
  • Helm Enterprise 私有部署模板
  • 完整生产级 SSO / SCIM 评估(按客户合规要求触发)
  • BI 报表能力评估(按需扩展,不做平台化)

详见 docs/product/HELM_OPEN_SOURCE_AND_CLOUD_TRIAL_LAUNCH_PLAN_V1.md。


文档导航

文档 作用
docs/positioning/HELM_FOR_DELIVERY_ENGINEERS_V1.md 根定位:给交付工程师的一页 1-pager + 差异表 + forkable Core 锚点
docs/product/HELM_DELIVERY_ENGINEER_GOLDEN_PATH_REQUIREMENTS.md Golden Path:判断 / 证据 / 复核 / 边界 / 交付包的可 fork 工程需求与验收门
docs/getting-started.md 开发者上手指引(中文)
docs/getting-started.en.md Developer quickstart(English)
AGENTS.md 仓库长期执行规范、硬边界、统一验证链
DESIGN.md 视觉与界面基线
WORKING-CONTEXT.md 当前 active queue 与短周期约束
GOVERNANCE.md 开源治理、scope control、release 与认证边界
CONTRIBUTING.md 贡献指南(中文)
docs/README.md 完整文档索引(中文)
docs/product/HELM_OPEN_SOURCE_COMMERCIAL_BOUNDARY_PLAN.md 开源 / 商业 / 合作边界
docs/product/HELM_CERTIFIED_ECOSYSTEM_CHECKLIST.md Certified Delivery Partner / Connector / Workflow Pack 认证清单
docs/legal/HELM_PUBLIC_TRIAL_DATA_POLICY_V1.md 公开试点数据政策
docs/operations/ON_CALL_AND_RESPONSE_SLA.md 早期落地伙伴响应与值班机制
docs/product/HELM_RELEASE_REALITY_ALIGNMENT.md 公开承诺、release hard gates 与需求减负收口

验证链

非微小改动默认应跑通:

npm run db:reset
npm run self-check
npm run check:boundaries
npm run typecheck
npm run lint
npm run test
npm run build
npm run e2e
npm run quality:regression

公开发布前额外跑:

npm run check:public-release
npm run check:secret-history
npm run release:check

详见 AGENTS.md §10。


贡献

  • ✅ 我们欢迎:bug 修复、文档修订、测试覆盖、本地化、只读连接器、可访问性改进。
  • ⚠️ 请先开 issue 讨论:改 schema、引入自动写入 / 发送、扩展 sandbox / marketplace / orchestration 平台能力。
  • 🧩 集成方向请用 integration: <system> 标签。
  • 🎯 想成为 Certified Delivery Partner?见 docs/product/HELM_CERTIFIED_ECOSYSTEM_CHECKLIST.md。

详见 CONTRIBUTING.md · 参与即同意 CODE_OF_CONDUCT.md。


早期落地伙伴可选路径(非默认 CTA)

主路径是 fork + 自部署 + Golden Path 自检。 早期落地伙伴路径仅作为 backup,供需要 Helm 团队直接陪跑的 design partner 使用。如果你是 Helm Inc. 的潜在合作方,先看 Certified Delivery Partner;试点合作仅在 Certified 不适配时启用。

早期合作不从"功能清单"开始,而从一个 public-safe 经营推进场景开始:

  1. 用公开样例或抽象后的客户场景描述经营信号来源。
  2. 明确哪些判断需要 AI 辅助,哪些动作必须人工复核。
  3. 用 Golden Path 验证判断 / 证据 / 复核 / 边界是否能跑通。
  4. 再讨论 Certified Delivery Partner、私有部署、Cloud 或 Enterprise 是否适配。
评估问题 看什么
是否真的提升经营推进 Must Push 采纳率、48h follow-up 完成率、manager review time
是否守住边界 wrong commitment incident、客户可见动作复核率、越权外发为零
是否可交付复用 sample pack 是否能 fork、fixture 是否能改、交付证据是否可复查
是否适合合作 咨询 / 交付伙伴能否用它形成方法、资产、案例和后续服务能力

涉及客户数据、私有域名、生产日志、部署证据、商业条款或真实项目信息时,不放公开 GitHub;请先走微信 ffjw0821 或 owner-approved private path 抽象讨论。


安全

请勿在公开渠道披露未公开的安全漏洞。私下披露见 SECURITY.md。


License

Apache-2.0 · NOTICE · 第三方依赖保留各自 license


加入我们

入口 用途
🚀 git clone + docker compose up 本地跑通核心 surface;从 extensions/case-management-sample/ 开始 fork 你的客户 vertical
🧭 npm run delivery:doctor 先做只读本地诊断:Golden Path 文件、关键 scripts、sample pack、HSI eval 和 D2 smoke 姿态
📦 npm run golden:path 生成 /tmp/helm-golden-path-proof 本地证据包:doctor、fixture diff、HSI eval、public guard、source-profiler receipt
🧪 npm run pack:fixture-check 检查 pack manifest、tenant 对齐、fixture JSON、安全 marker 和 HSI surface 覆盖
💬 GitHub Discussions 社区问答、vertical 共建、卡点求助
📮 微信 ffjw0821 联系我们、合作沟通、获取当期社群邀请(受控人工对接)
🛠 GitHub Issues 提出问题 / 反馈 bug / 提交改进建议
📣 微信公众号 Helm开源经营系统 · 微信号 HelmCoreCN(信息发布入口,非默认支持工单入口)
🎯 Certified Delivery Partner 交付商认证、品牌背书、案例共建
☁️ Helm Cloud(托管版) 可选,不替代开源;适合不想自部署的交付商 / 客户

目标:帮交付工程师把客户业务落地里的判断、证据、复核、边界、交付包做成可 fork 的工程结构。

生产环境的邀请、成员登录链接与 demo 跳转要求有效 HTTPS APP_URL;配置错误会在写入前拒绝。参见 可信公共入口 / Trusted public origin。 Production invitation, member-login and demo links require a valid HTTPS APP_URL and fail before writes when it is invalid.

通用资源预留协议见 Core SDK 合同:当前提供严格向量规范化与原子存储端口定义,存储、认证和生产接入另行实现。

The resource reservation SDK contract supplies strict vector normalization and atomic store interfaces; persistence, authentication and production integration remain separate.

版本化 server startup 的固定准入、等待屏障与超时边界见可信用量组合;公开默认保留 legacy,未发行收费安装许可。 Versioned server startup supplies source admission and an awaited barrier, not payment authority.

About

Apache-2.0 forkable Core for enterprise AI delivery: review-first enterprise AI operations systems, public SDK, sample packs, docs, tests, and Docker quickstart for delivery engineers.

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages