隐私与安全¶
关于插件本身在您计算机上能做什么和不能做什么（无hooks、MCP服务器、依赖项或下载，以及如何验证您的副本），请参阅安装是否安全？。
各部分运行位置¶
| 部分 | 运行位置 | 发送内容 |
|---|---|---|
| 扫描、构建、更新 | 您的计算机（Node.js） | 无 |
| 编写名称和描述 | Claude或Codex，通过您的会话 | 它所读取的文件，与您交给它的任何其他任务相同 |
| 地图 | 您的浏览器 | 无。其布局引擎和字体打包在文件中，因此可以离线工作 |
地图服务器（serve.mjs） |
您的计算机，仅监听127.0.0.1 |
本身无任何发送 |
| 提问（Claude Code CLI） | 您计算机上的claude -p会话，使用您的账户 |
您的问题，以及Claude选择读取的文件 |
| 提问（Codex） | 您计算机上的codex exec运行，使用您的ChatGPT登录，不保存到您的Codex历史记录 |
您的问题，以及Codex选择读取的文件 |
| 从地图更改蓝图 | 与提问相同，使用Claude Code或Codex；然后地图服务器仅写入floorplan/中的计划文件 |
您的请求，以及AI选择读取的文件 |
| 提问（Claude应用） | 您的claude.ai账户 | 地图（名称、描述、结构），绝不包括您的源代码。Claude在发布前会先询问 |
| 导出副本 | 您的计算机：地图服务器写入一个HTML文件 | 无。您决定谁获得该文件。它包含地图，以及仅当您勾选时才包含的Health或最近工作，绝不包括您的文件夹路径、git远程仓库或源代码 |
| Floorplan Cloud等待名单（仅在您注册时） | 地图服务器，发送到Floorplan的等待名单服务 | 您输入或选择的电子邮件，以及“仅我”或“与我的团队”。请参阅下文 |
Floorplan没有分析或遥测功能，没有需要安装的依赖项，也没有安装脚本。它唯一的外部连接是下文的选择加入等待名单，除非您注册，否则不会有任何信息发送到那里。地图中少数指向文档的链接仅在您点击时才会打开。
布局引擎（elkjs 0.9.3，EPL-2.0）和字体（Inter和JetBrains Mono，SIL开放字体许可证）连同其许可证一起打包在skills/floorplan/assets/vendor/中，每次构建都会将它们复制到地图中。
本地服务器¶
- 它仅监听
127.0.0.1，因此您网络上的其他机器无法访问它。 - 每次启动都会创建一个随机令牌，只有它所服务的地图页面才能收到。提问和保存流程需要该令牌，来自其他网站的请求将被拒绝。
- 它仅在自己的端口上响应
127.0.0.1和localhost，因此将自身域名指向您计算机的网站（DNS重绑定）无法加载地图或其令牌。 - 提问使用只读工具运行Claude：读取文件、搜索以及地图自身的查找脚本。它无法编辑文件或运行其他命令。
- 使用Codex时，提问在Codex的只读沙箱中运行：它可以读取和搜索，但不能写入文件。
- 在蓝图（根据PRD规划的地图）上，更改请求以相同的只读方式运行。代理回复更新后的计划，服务器本身在检查后仅写入
floorplan/plan.json、floorplan/architecture.json和floorplan/recent-work.json，并保留旧副本以供撤销。 - 它会在最后一个标签页关闭两小时后自行停止，
node floorplan/serve.mjs --stop可立即停止它。
Floorplan Cloud等待名单¶
地图打开两分钟后，左下角会出现一张卡片，询问您是否希望在Floorplan Cloud发布时收到电子邮件。这是一个托管版本，每个团队共享一张地图，并与GitHub保持同步。它只询问一次：
- 现在不要会在两周后再次询问。
- 不再询问和注册都会在所有项目中永久停止询问。
除非您点击通知我，否则不会发送任何信息。
发送内容： 仅包括框中的电子邮件地址，以及您是独自使用Floorplan Cloud还是与团队一起使用。不会附带任何关于您、您的项目或您的代码的信息。
使用我的Claude电子邮件： 此按钮会用您的Claude Code所登录的Claude账户电子邮件填充该框。仅在该时刻才会询问Claude Code，您会在发送任何内容之前看到地址。当您不点击时，不会读取任何信息。
发送去向：
- 地图的本地服务器将其发送到Google Cloud Run上的一个小型服务。您可以在此处阅读其代码。它保存在该仓库的历史记录中而不是插件中，因此安装Floorplan时不会下载它。
- 该服务向私有Google Sheet中添加一行，只有Floorplan的制作者Hayden Smith可以查看。该行包含日期、电子邮件和您的回答。
用途： 仅在Floorplan Cloud发布时向您发送电子邮件，并评估是否值得构建。该列表绝不会被出售或共享。列表上的每封电子邮件都会包含取消订阅的方式，您也可以随时通过发送电子邮件至hismith142@gmail.com请求移除。
您的IP地址会被短暂用于限制注册速率，绝不会写入表格。Google Cloud会将标准请求日志（包含IP地址）保留30天。
关闭方式：
- 点击不再询问，或
- 设置环境变量
FLOORPLAN_NO_PROMPTS=1。
您的回答保存在~/.floorplan/settings.json中。
服务的保护方式： 其地址位于Floorplan的公开代码中，因此它被设计为即使被滥用也无害。
- 它只接受新注册，绝不会从列表中返回任何内容。
- 重复注册看起来与新注册相同，因此任何人都无法检查某个地址是否在列表中。
- 输入经过严格检查并以纯文本保存。
- 注册按IP地址和总体数量受到限制，列表也有大小上限。
- 它作为单个小实例运行，因此大量请求不会导致成本飙升。
秘密¶
Health 检查会在你的代码中查找密码、API 密钥和私钥，以及会被提交的 .env 文件。当发现这些内容时，它只会记录文件、行号、密钥类型，以及一个脱敏提示，例如“以 AKIA… 开头，20 个字符”。密钥值永远不会存储在地图中、打印出来或发送到任何地方，并且 Claude 被指示绝不要重复它们。
该检查是一项有用的初步排查，而非安全审计。
Git¶
Floorplan 创建的任何内容都不会被提交。参见 你的项目中包含哪些内容。
报告漏洞¶
请按照 SECURITY.md 中的描述，私下报告安全问题，而不要通过公开 issue 提交。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 floorplan/floorplan