karuo-ai/运营中枢/参考资料/本人目录文件规范_防IDE报错.md

本人目录文件规范（防 IDE「Unable to open / Assertion Failed」）

编辑 个人/1、卡若：本人/ 下任何文件时须遵守，避免 Cursor/VS Code 出现「Unable to open 'xxx.md'」「Assertion Failed: Argument is undefined or null」。

---

一、必须遵守

1. 路径：本目录内互相引用一律用相对路径（如 记忆.md、01_自我与性格.md），不在正文写绝对路径（如 /Users/karuo/...），避免多工作区下解析为 null。
2. 编码与换行：文件保存为 UTF-8 无 BOM，换行符 LF；文件末尾保留一个换行符。
3. 链接：避免使用 [[文件名]] 等 wikilink，改用普通文本或 文件名.md；不写可能指向已删除文件的链接。
4. 重命名/删除后：若在本目录做了重命名或删除（如 05 合并进 00），提示用户 Reload Window（命令面板 Developer: Reload Window）或关闭后重新从左侧资源管理器打开文件，以刷新 IDE 状态。

---

二、出现报错时的处理

• 单文件报错：检查该文件是否末尾无换行、是否含绝对路径或 [[...]]，修正后保存；让用户关闭该标签页后重新从树状图打开。
• 多文件或整目录报错：按上一条规范检查并修正所有 md；提醒用户执行 Reload Window。

---

三、与记忆路径的关系

• 记忆读取/写入仍以规则中约定的唯一路径为准；本规范约束的是写在文件内容里的路径表述，避免 IDE 解析时拿到 undefined/null。