跳转至

Raw(原始素材)

借鉴卡帕西的 raw + wiki 二分法。raw 是"垃圾桶"层 — 写入门槛极低,捕获一切; 经过加工后流到 specs/ / issues/ / wiki/ 各层沉淀。

子目录

路径 用途 示例
inbox/ 待处理的临时收件箱 — 任何无明确分类的输入 一段对话片段、半成品想法
feedback/ 用户反馈原文(含截图描述) 用户提的 bug、UX 抱怨、改进建议
conversations/ 重要对话/讨论的存档 架构讨论、决策过程
ideas/ 未评估的想法 「也许可以加个 X」「类似 Y 工具的功能」

处理流程

1. 粘贴:把原始内容快速塞到 inbox/ 或对应子目录
   用 _template.md 起手,YYYY-MM-DD-简短描述.md
2. 评估:周期性整理(建议每周)
   ├─ 是 bug → 转 docs/issues/
   ├─ 是新功能 / 需求 → 转 docs/specs/active/
   ├─ 是架构/知识更新 → 直接补 docs/wiki/
   └─ 价值不大 → status: discarded(保留以备未来回顾)
3. 处理后保留:raw 文件不删除,只更新 status + 加 related 回链

文件命名约定

YYYY-MM-DD-<简短中文描述>.md

例: - 2026-05-26-用户截图-状态chip参差不齐.md - 2026-05-26-想法-定时导出excel.md - 2026-05-26-讨论-知识库结构借鉴卡帕西.md

当前条目

由 obsidian dataview 自动生成(如果在 obsidian 中),或手动维护:

日期 标题 类型 状态
2026-05-26 用户反馈-状态chip靠右 feedback processed → [[0021-status-chip-misalign
2026-05-26 讨论-知识库结构借鉴卡帕西 conversation spec-ed → SPEC-001-知识库改造

与其它层的边界

何时用
raw 「先塞进来」— 还没想清楚是什么,先存档
specs 「想清楚要做什么」— 有数据模型、API、任务拆分
issues 「修过的 bug」— 含根因、修法、避免再犯
wiki 「沉淀的知识」— 架构、模块、API 文档

raw 是入口;wiki/specs/issues 是出口。raw 文件永远不删,作为知识溯源。

全部 raw 条目(按子目录)

inbox/

日期 标题 状态 链接
2026-05-28 嵌套滚动条又出现 — 截图位置未标注,待复现 unprocessed 打开
2026-05-26 task delete 不删 MapTaskData 行 — 设计 vs bug 待确认 spec-ed 打开
2026-05-26 restoreExtensionTabs 与 ext-context-guard 双 reload 浪费 discarded 打开
2026-05-26 系统性盲区 — 前端 React lifecycle 一直没人查 spec-ed 打开
2026-05-26 dynamic-scraper.ts tabStatus/tabError Map 长期慢泄漏 processed 打开

feedback/

日期 标题 状态 链接
2026-05-28 用户构想:网站采集云端协同 + 贡献度机制 spec-ed 打开
2026-05-26 反馈 — Watchdog 重启后希望自动继续,而不要手动点开始 spec-ed 打开
2026-05-26 反馈 — KPI 任务卡文字截断 + 剩余时间不人性化 processed 打开
2026-05-26 反馈 — toast 提醒位置 + 网络状态位置 processed 打开
2026-05-26 反馈 — 状态 chip 参差不齐 processed 打开
2026-05-26 反馈 — StatsBanner 与 QuickFilters chip 信息重复 processed 打开
2026-05-26 反馈 — 网络状态点点加光晕 + 放大缩小动画 processed 打开
2026-05-26 反馈 — 邮箱列表出现 168 字符的怪邮箱 spec-ed 打开
2026-05-26 反馈 — Google /sorry/index 验证拦截交互不到位 spec-ed 打开
2026-05-26 反馈 — Extension context invalidated 错误 processed 打开
2026-05-26 反馈 — 扩展刷新后 main tab 变成浏览器默认页面 spec-ed 打开
2026-05-26 反馈 — 自动恢复默认值调激进(10s/无限) spec-ed 打开
2026-05-26 反馈 — 地图实开 (265) 比 地图请求 (249) 还多,反直觉 processed 打开

conversations/

日期 标题 状态 链接
2026-05-26 讨论 — 知识库结构借鉴卡帕西 spec-ed 打开
2026-05-26 讨论 — 文档体系体检诊断 spec-ed 打开