HANGYU ENGINE / PRIVACY

隐私说明

这是姬航宇一个人使用的本地原型，不是面向公众的 SaaS，也没有账号体系。下面写的是当前代码实际做到的事，不把计划写成已上线。

Key 存在哪里

• 首屏只接受 hy_ 引擎通行证；模型 Key（sk-...）进入工作台后在【设置】里填写。两者都只放在当前标签页的 sessionStorage，关闭标签页即清除；不写 localStorage、Cookie 或 URL。
• ENGINE_ACCESS_TOKEN 只存在服务端 .env，API 每次请求都会校验；服务端不再读取模型 LLM_API_KEY，模型 Key 由浏览器在模型请求头中即时提供。
• 浏览器请求带 Authorization: Bearer hy_... 和模型头 X-Provider-Key: sk-...；外部 Agent 用 X-Provider-Key: hy_... 作为引擎鉴权。服务端只在当次请求内存中使用，不落库、不写日志、不写导出。
• 模型请求由本机引擎转发给你选择的服务商；Key 不会出现在报告、Markdown、错误响应或页面里。
• 工作台顶部“清除模型 Key”只删除模型 sk_ Key；不会清除 hy_ 通行证、不会退出登录、不会刷新页面。模型选择保留。

文本与报告

• 粘贴的原文默认不落盘。数据库只保存字数、SHA-256、来源类型、报告和疑点引用，不保存全文。
• 送入模型前，引擎会先脱敏：sk- / hy_、Bearer token、邮箱、手机号、身份证号替换为 [REDACTED]。
• 质检报告和疑点存在本机 SQLite（data/）。它们不会自动发给任何人。
• 如果 LLM_PROVIDER=mock，文本不会离开本机。如果配置了 SiliconFlow / DeepSeek / OpenAI-compatible 服务，脱敏后的文本会发给该服务商，适用其自己的隐私政策。

Ground Truth 与模型矩阵

• Ground Truth 是可选的参考错误清单，可手动输入或上传 .txt/.md/.csv/.json；只在本标签页读取，作为定向扫描上下文，不落库、不写报告、不写导出、不写日志。
• 未提供 Ground Truth 时，页面不会给出“完美无缺”的空结论；如果模型没有找到可定位项，引擎会补一条 P2、cannot_verify 的“值得核实”来源项。
• 模型矩阵包含 DeepSeek V4.1 Flash、GLM-5.3 Flash、DeepSeek V3、Qwen3 Coder 480B、Pro DeepSeek V3；审计器包含 V4 Pro、Qwen3.5 397B、R1、Kimi K3、Pro R1。完整模型 ID 会作为请求的 model 字段发给兼容服务商。

状态质检与全维仪表盘

• /workflow-audit 与 /life-audit 是确定性红线规则，不调用 LLM；只保存派生指标（主线数、专注分钟、红线代码、分数、提示语），不保存原始任务标题、日程标题或日志原文。
• 仪表盘的文本分数来自最近一次文本质检；工作流/生活分数来自最近一次对应状态质检。需要鉴权才能读取。
• 状态质检是提醒与决策辅助，不是医疗诊断、心理测量或对人格的评价。

指令、确认与 Webhook

• 指令草稿（intent、动作、风险、回滚、时间块）存在本机 SQLite；不会自动执行。
• 高风险指令的确认 token 只在生成时返回一次，服务端只保存它的 SHA-256。token 10 分钟过期、绑定单条指令、只能使用一次；不写入日志、JSON 预览或剪贴板。
• 只有你点“确认这条指令”并点“发送给 Grok”后，指令 JSON 才会发给你在 .env 配置的 Webhook URL。如果该 URL 指向外部 Grok、n8n 或中继，它会收到指令内容（不含模型 Key、不含原文全文）。
• 默认不配置 Webhook；本地开发使用 127.0.0.1 的 mock 接收端。Webhook 的 HMAC secret 只存在服务端环境变量，不进入浏览器。
• 可选事件 Webhook（EVENT_WEBHOOK_*）会在文本质检、工作流/生活质检、指令生成完成时发送派生 JSON（不含 Key、原文全文、确认 token）；外部可将其转成桌面通知。
• Grok / 中继执行后的回执会保存到本机 SQLite。没有回执就显示“回执未知”，不会当作成功。

导出、删除、保留期

• 设置里可以导出 JSON 或 ZIP。导出包含报告、疑点引用、指令、投递/回执；不包含 Key、原文全文、确认 token、请求签名或 Webhook secret。
• “删除全部”需要输入 DELETE_ALL，会清空本机报告、疑点、指令、投递、回执与状态质检派生记录，不可恢复。删除后 Key 仍保留在当前标签页，可继续使用。
• 默认自动保留：文本质检 30 天、指令与状态质检 90 天；每 6 小时清理一次。日志自动轮转尚未实现。
• 备份/恢复是服务端命令，不在浏览器里做；备份文件仍应视为敏感数据。

日志

日志只记录请求 ID、路由、状态码、耗时、模型名、token 计数和错误码；不记录请求体、原文、Authorization 或 Key。日志再做一层字段脱敏。

承诺复盘

默认关闭。打开时会先确认。它只读你提供的文本，只引用你自己的话，只问问题；不打分、不排名、不通知家人。记录不足时会写“无法判断”。

数据边界以代码与 SECURITY.md 为准。若发现日志、导出或错误信息中出现 Key，应立即停止使用并清理 data/、logs/。