笔记铸造台

将 JSON 对象数组转换为 Markdown 笔记的小型浏览器工具，重点解决 frontmatter 字符串类型保留和输出文件名碰撞。AI 辅助开发，并在华为云 AI 开发者空间运行验证。

使用

下载 index.html 并用现代浏览器打开，或执行 python3 -m http.server 18748 --bind 127.0.0.1 后访问本地地址。无需安装依赖，不调用网络接口，不使用 localStorage，输入只保留在当前页内存中。

1. 粘贴包含 1–500 条对象的 JSON 数组，选择作为文件名的字段。
2. 选择“报错阻止”“保留两份”或“跳过后项”，点击“检查并生成”。
3. 在结果列表切换笔记、检查 Markdown 源码，下载单条笔记或合并预览。

示例的两个 ID 分别为 A/B 和 A:B，清洗后都会变为 A-B.md。报错策略会阻止整批导出；保留策略自动分配新路径；跳过策略保留第一条并显示被跳过的记录。分配后缀时同时避让原始目标路径与已分配路径。

数据类型

字段名及字符串均使用 JSON 双引号转义；数字、布尔值、null、数组及对象按 JSON 流式语法写入 YAML frontmatter。因此 "true"、"null"、"001"、空文本不会被误读成其他类型。所有字段进入 frontmatter，不猜测正文字段；结果为源码预览，不渲染用户 HTML。

边界与限制

• 本工具适合小批量资料，输入限制 1 MiB、500 条。JavaScript 不支持无损大整数，超过安全范围的整数会被拒绝，请用字符串保存编号。
• 文件名替换分隔符、控制字符和非法符号，拦截空名及 Windows 保留设备名，按 NFC 与不区分大小写的方式检测冲突。
• 输入、字段或策略变化会使旧结果失效，校验错误时无法下载。页面不写入用户的磁盘目录，下载由浏览器处理。
• 合并 Markdown 是供浏览的汇总文件，每篇笔记源码采用缩进代码块展示，不是独立笔记导入归档。
• 关闭或刷新页面会清空输入；不提供云同步、账号、数据库及协作编辑。下载目录和同名文件处理由浏览器决定。

验证

执行 node verify.cjs 验证真实页面中的核心逻辑；roundtrip.json 保存供 YAML 解析器复核的产物。另用 Python PyYAML 读取生成的 frontmatter，检查值和类型的往返一致性。浏览器验收覆盖三种冲突策略、坏 JSON、编辑失效及下载。

文件

• index.html：独立应用，无外部依赖。
• verify.cjs：核心行为验证。
• roundtrip.json：验证样例输出。

由 AI 辅助编写与检查。请先在副本上检查实际转换结果再用于资料整理。