Skip to content

About

魔都水滴实验室:把技术文章变成可以立即体验、验证和分享的互动工具。

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Margrop Labs

魔都水滴实验室:把技术文章变成可以立即体验、验证和分享的互动工具。

margrop-labs 是 blog.margrop.net 的互动实验层。博客负责解释“为什么”,Labs 负责让读者“马上试一下”,GitHub 负责公开实现、规则和验证过程。

正式入口:https://lab.margrop.net。Preview 与 Production 的发布边界、Secret 要求、验收和回滚流程见 Cloudflare Workers 部署。

当前产品焦点

AI 面试工作台已完成 P5-001 至 P5-009,并以仅合成数据的 Alpha开放索引。它仍不接受 真实候选人材料,也不代表招聘质量或自动决策能力获批。Token Forge 的 Beta 评审继续保留 NO-GO 历史,不在本轮重新打开;AI 故障侦探已重新开发可选解释与审核型案例工坊,SMART / RMA 继续维护。

首批实验

实验 用户价值 状态
Token 任务炼金炉 把闲置 Token、仓库上下文和目标转换为可验收的开发任务 Alpha·主线
AI 面试工作台 从岗位匹配和面试计划走到有证据边界的面试结论 Alpha·合成样例
AI 故障侦探 在合成事故中练习按证据排障,而不是让 AI 猜根因 Alpha·维护
SMART / RMA 报告机 保留本地解析与脱敏 Alpha,不继续健康判断、AI 和 RMA 导出 Alpha·暂停

产品原则

  1. 确定性内核,AI 增强:解析、计算、脱敏和安全判断由代码负责;AI 用于理解、解释、生成案例和提出下一步。
  2. 隐私优先:敏感原始输入尽量只在浏览器处理;服务端默认不记录输入正文。
  3. 样例先行:所有实验必须提供无需登录、无需真实数据、无需消耗 AI 额度的合成演示。
  4. 证据可见:AI 结论必须能追溯到规则、输入摘要或引用证据。
  5. 成本有上限:每次 AI 调用都有模型、Token、超时、频率和输出大小限制。
  6. 文章双向关联:每个实验链接相关文章;相关文章提供明确的“在线体验”入口。
  7. 可访问、可分享:移动端可用、键盘可操作、结果可导出,但分享链接不得携带敏感原文。

预期架构

apps/
├── web/          # Labs 门户与互动页面
└── api/          # 可选 AI 网关、限流与公开仓库读取
labs/             # 每个实验的产品合同、样例和专属规则
packages/         # UI、契约与安全相关公共模块
schemas/          # 版本化 JSON Schema
docs/             # 架构、隐私、成本和博客集成规范

Web 端采用 Astro + TypeScript + Preact Islands,首期生成静态 HTML,并以 Cloudflare Workers Static Assets 作为 lab.margrop.net 的部署目标。低优先级交互使用 client:visible 按需加载;服务端 AI Gateway 继续通过稳定 HTTP 合同解耦。选型见 ADR-0003。

开始贡献

当前状态

本地运行

nvm use
npm ci
npm run validate
npm run dev --workspace @margrop-labs/web

开发者与 GitHub Actions 使用同一条根目录质量命令。检查内容和故障处理见 质量门。实验卡片由版本化清单生成,规则见 实验清单加载器。页面组件与交互必须遵循 UI 与可访问性基线。Token 任务炼金炉的稳定输入输出见 v1 合同,无需 AI 的降级核心见 确定性模板模式,公开仓库的有界只读输入见 GitHub 摘要适配器。所有未来 AI 能力必须通过 Provider 中立的 Gateway 合同。

当前站点进入 alpha。AI 面试工作台已完成 P5-001 至 P5-009,并以只接受完全合成样例 的可索引 Alpha 运行;真实候选人输入继续保持 NO-GO。Token Forge 的未完成任务按仓库 所有者要求跳过,Beta NO-GO 历史保持不变;AI 故障侦探与 SMART / RMA 只做维护。 P4-001/P4-002 已完成隔离的 Preview 与 Production 部署, 正式站点由 Cloudflare Workers Static Assets 和 Custom Domain 提供。P1-004 已在 P0-006 AI Gateway 和 P0-007 脱敏边界上实现 Token Forge AI 任务拆分核心:最小仓库上下文、 确定性输出安全检查和 P1-002 完整降级均已有合成测试。P1-005 已增加验证计划的本地 Markdown 和逐任务 GitHub Issue 草稿,包含脱敏、Markdown 安全、固定文件名和大小上限。 P1-006 已把无需登录、仓库和 AI 的模板生成与两种本地导出接到 /token-forge/;P1-007 又接入可选的受限公开 GitHub 摘要,只展示固定技术标签、覆盖计数和安全未知项,任何仓库 失败都保留模板与导出。P1-008 已完成 Preview 与 Production 的真实 Provider 验收: 浏览器不持有密钥,匿名限流、原子预算、并发上限、超时、熔断与固定 fallback 模型均在 服务端执行,AI 失败仍保留本地模板。P1-009 已为计划增加确定性质量报告;P1-010 已上线 可撤销、本地依赖安全的计划编辑;P1-011 已把最终计划生成第三种 Provider-neutral Coding Agent 执行包,逐阶段提供上下文边界、命令发现、验收、交接与失败恢复协议。P1-012 已增加 6K/24K/40K 三档一键模板样例、三步引导、错误恢复和移动端结果导航。P0-008 已把固定 工具链、依赖扫描、Secret 扫描、Schema/fixture 验证和手动 Production 边界接入统一质量 门。P1-013 已加入 31 个完整计划场景、8 份跨栈快照、35 个故障注入、五类隐私 sink 和 真实 Chromium 关键路径。P4-003 已把最小事件接到独立的 SQLite Durable Object,只保留 31 天的日期、事件和粗设备类别聚合计数,不保存原始事件、用户标识或正文。P4-005 已提供 版本化的文章中段/文末 CTA,固定正式链接且不带追踪参数。当前下一项是 P4-006,在博客 导航突出 Token Forge 入口。 P2-001 已定义完全合成的 Incident Detective 场景/证据与单局推理 合同;P2-002 已完成首个 MySQL + Prometheus + Loki 合成事故,包含 10 份证据、13/9 点预算取舍、合理反证、按证据揭示的时间线和与公开场景分离的内部答案草稿。P2-003 已上线 逐步取证 Alpha 页面:用户可以管理预算与解锁、查看五类证据和时间线,并在本地生成 Attempt v1。P2-004 已加入五维 100 分确定性评分、逐条判定和改进反馈;确定性评分仍不加载 内部答案、不保存或上传结果。P2-005 已增加 Provider-neutral 的 Case Proposal 生成核心与显式 人工审核门:模型不能接触答案或评分,也不能自动发布候选。P2-006 完成 Score-only 的确定性 SVG 下载。P2-007/P2-008 进一步接入按需 AI 评分解释和公开案例工坊:Explanation 只发送 Finding、维度分数与证据元数据,Proposal 必须通过既有 DAG/预算/隐私检查和七项人工审核, 审核包始终 publishable: false。P3-001 已建立 7 份完全合成的 ATA、NVMe 与未知协议 smartctl 输入及版本化索引,覆盖健康、预警、危险、 缺失字段、厂商扩展、SMART 不可用和冲突信号。P3-002 已上线浏览器端只读解析工作台和 Parse Result v1。P3-003 已增加序列号、WWN、主机名、IP 与常见 Secret 的本地脱敏预览, 以及不含自由文本的 Boundary Projection v1;URL、日志和 Analytics 进一步收窄为固定元数据, AI 与导出尚未启用,现有结果仍不构成厂商保修判断。P5-000 已定义 AI 面试工作台的双角色 三段主流程、敏感输入边界和公共 AI Gateway 复用方案;其功能任务仍阻塞于 P1-014。 完整顺序以 Token Forge 优先路线图为准。

About

魔都水滴实验室:把技术文章变成可以立即体验、验证和分享的互动工具。

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages