diy-pc-ingest

核心用法

diy-pc-ingest 专用于将非结构化的 PC 配件购买记录（如 Discord 消息、购物小票文本、配置清单）转化为结构化的 Notion 数据库记录。用户只需粘贴原始文本，系统即可自动识别硬件类型（CPU/GPU/存储/外置机箱等），通过日语字段名映射到四个专用数据表（PCConfig、ストレージ、エンクロージャー、PCInput）。对于缺失的规格参数（如硬盘位数、接口类型），系统可调用 web_search 进行智能补全，并通过交互式询问解决关键字段（如序列号）的歧义，最终通过 dry-run 预览后执行 upsert 操作。

显著优点

该工具在数据完整性方面表现突出：针对存储设备以序列号为唯一键，针对外置机箱以"取り外し表示名"为标识，针对整机配置采用"名称+购买日期"复合键，有效避免重复录入。其实现严格遵循最小权限原则，仅申请必要的 Notion API 权限，并在 SKILL.md 中完整披露数据流向（本地解析→可选网络搜索→Notion 写入）。技术实现上采用锁定的 Notion API 版本（2025-09-03），使用 data_sources 新端点而非传统数据库查询，支持关系型字段更新。特别值得一提的是其"预览模式"，允许用户在正式写入前查看哪些记录将被创建/更新/跳过，显著降低误操作风险。

潜在缺点与局限性

首要限制在于其针对日语数据库结构的深度定制——字段名、分类逻辑均基于日语 Notion 表设计，对非日语用户存在使用门槛。作为 T3 来源的社区项目，虽然代码通过安全审计，但长期维护稳定性不如企业级项目。功能上依赖 notion-api-automation skill，增加了依赖链复杂度。此外，尽管网络搜索是可选功能，但启用时会将产品型号发送至外部搜索引擎，对极度敏感的商业采购场景可能不适用。配置过程也需要用户手动获取并填写 Notion 数据源 ID，对普通用户不够友好。

适合的目标群体

最适合拥有大量硬件设备（特别是 NAS 硬盘、外置硬盘盒、多机配置）的 DIY 爱好者、硬件评测博主、IT 资产管理员。对于习惯使用 Notion 管理个人数字资产，且能接受日语界面或愿意自定义数据库结构的技术用户尤为合适。不适合仅需简单记录偶尔购机行为的一般用户，或对企业级代码审计有严格要求的企业环境。

使用风险

需确保 NOTION_API_KEY 存储安全（建议环境变量而非配置文件），避免 Token 泄露导致 Notion 工作区被非法访问。启用 DIY_PC_INGEST_BOOTSTRAP=1 时，脚本会写入本地配置文件，在多用户环境需检查文件权限。虽然代码层面无命令注入或路径遍历风险，但 T3 来源意味着用户应自行审查后续版本更新，避免供应链攻击。网络搜索功能的使用需权衡便利性与隐私保护，建议在处理敏感商业采购信息时关闭外部 enrichment。