Skip to main content
Glama
YiJing233
by YiJing233

ArchLens / 建筑透镜

ArchLens CI · 公开源码 · 在线 Demo

ArchLens 是一个面向建筑设计研究的开放案例资料库 Demo:参考 Mobbin 的检索与浏览效率,提供可追溯的案例结构化资料、研究资料包下载、轻量工作区和真实 MCP Endpoint。

本地运行

npm install
npm run dev

主要页面:

  • /:研究入口与短 Prompt 模板

  • /cases:案例库、筛选、案例详情和资料包下载

  • /boards:本地收藏、评分和 Wish List

  • /project:项目理念、任务、代码地图、预期和 Milestones

  • /mcp:MCP 工具说明与可运行 Playground

  • /api/mcp:无鉴权 MCP HTTP Endpoint

  • /api/health:协议、数据集版本和案例库就绪状态

  • /api/source-intake:可选的 D1 来源证据登记与复查接口(公开 Demo 默认关闭写入)

  • /api/workspaces:可选的 D1 共享工作区接口(公开 Demo 默认关闭)

共享工作区可选启用成员角色、过期 token 和 D1 quota bucket;quota 按读取、写入、成员管理操作区分,并对 owner/operator 与 editor/viewer 使用不同预算。来源同步可通过 GitHub Actions 的 ArchLens Source Intake 手动或每周触发,输出证据与人工发布候选,不会自动修改案例库。

工作区支持从页面导出/导入 workspace snapshot JSON,便于通过文件或 GitHub 交接收藏、评分和最近研究任务;快照只在浏览器和用户自己的文件之间流转,不上传到 ArchLens。

Related MCP server: bSDD MCP Server

MCP

https://archlens.yiking233.chatgpt.site/api/mcp 配置到支持 Streamable HTTP MCP 的 Agent 中即可。当前服务版本为 0.2.0、契约版本为 1.0.0,工具 schema、curl 和客户端连接说明见 mcp/README.md。Demo 不绑定任何模型供应商,返回的结构化案例上下文交给用户自己的 AI 工具继续处理。

案例生产

可复用的案例生产 Skill 在 skills/case-production/SKILL.md,规定了来源采集、结构化、设计理念提取、引用核验和资料包输出流程。

贡献者可以复制 skills/case-production/case.template.json,再运行 npm run case:pack -- --input <case.json> --out <目录>,零依赖生成 case.json、研究 Markdown 和 README 三件套。

如果需要先快速检查原始来源,可运行 npm run source:audit -- --input <case.json> --out <目录>。它只读取 HTTPS 网页的标题、描述、canonical 和短摘录,输出 source-report.jsonsource-notes.md;不下载图片、不生成事实,也不会把网页内容当作可执行指令。生成资料包时可追加 --source-report <source-report.json>,把这份证据一起交付。

贡献多个案例时,可运行 npm run source:pipeline -- --input <案例目录> --out <目录>,它会按顺序生成每个案例的来源报告和一个 pipeline-report.json 总览;任何无效案例或来源失败都会以非零状态阻断后续发布。

如果部署环境启用了 D1,可以把已经生成并人工复核的 source-report.json 登记到 /api/source-intake,保存案例 ID、来源数量、失败状态、时间线和完整报告;接口不会替代来源抓取,也不会自动生成事实。配置说明和请求示例见 docs/SOURCE_INTAKE.md

审核前可以生成一个不会自动入库的发布候选:npm run source:proposal -- --input ./research-packs/source-intake --out ./research-packs/release-candidate。它会验证来源报告、阻断失败证据,并输出 JSON/Markdown 审阅包;通过后仍需人工修改案例数据、提交 PR 并运行 npm run dataset:audit

也可以在 GitHub Actions 手动运行 ArchLens Source Intake;仓库还会每周自动检查来源输入目录。两种触发方式都复用同一套 pipeline、proposal 和可选 D1 ingest 流程;工作流失败时会保留并上传来源证据,便于人工复核。

项目文档

开源贡献

  • 代码、MCP、schema 和 Skill 使用 Apache-2.0。

  • 案例图片和原始资料按各自来源许可处理,默认保留来源链接与署名,不重新分发未授权素材。

  • 新案例和 Wish List 使用 .github/ISSUE_TEMPLATE/ 中的模板提交。

  • 贡献流程与内容边界见 CONTRIBUTING.md,每次 PR 会自动运行案例/MCP 校验、构建测试和 lint。

验证

npm run build
npm test
npm run lint
npm run dataset:audit
ARCHLENS_MCP_ENDPOINT="https://<your-domain>/api/mcp" npm run mcp:smoke

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers