# project-inbox **Repository Path**: julaoshi/project-inbox ## Basic Information - **Project Name**: project-inbox - **Description**: CodeX(或其他智能体)文件管理Skill,项目制 AI 文件管家,按领域→年份→项目整理 Inbox - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-10 - **Last Updated**: 2026-10-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Project Inbox — 项目制 AI 文件管家 **一句话:你只管把材料丢进 Inbox,Codex 按“领域 → 年份 → 项目 → 文件”帮你归档。** 这是一个面向 Codex 的个人文件整理 Skill。它与传统按“图片 / Word / Excel / PDF”分类的工具不同:它首先判断一份材料属于你正在做的哪件事、哪个项目,然后再归档到对应项目文件夹。 ## V1 能力 - 统一 `00_Inbox` 收件箱 - 混合文件扫描与稳定性检测 - 项目制归档:领域 → 年份 → 项目 → 文件 - 优先匹配已有项目,谨慎创建新项目 - 批次上下文判断 - Preview / Apply / Undo - 冲突安全移动,不覆盖同名文件 - `98_待确认` 兜底 - 根目录 `整理日志.md`:人可读地记录“哪些文件从哪里移到哪里”以及撤销记录 - 中央项目索引 `.organizer/project-index.json` - 可被 Codex Scheduled Task 定时调用 ## 安装到 Codex 当前 Codex 会从用户级 `$HOME/.agents/skills` 或仓库级 `.agents/skills` 发现本地 Skill。把整个 `project-inbox` 文件夹复制到其中一个目录即可。 用户级示例: ```bash mkdir -p ~/.agents/skills cp -R project-inbox ~/.agents/skills/project-inbox ``` 然后在 Codex 中用 `$project-inbox` 显式调用,或直接说“整理 Inbox”。 ## 快速开始 ```bash python scripts/init_workspace.py --workspace "$HOME/Documents/Personal-Workspace" python scripts/scan_inbox.py --workspace "$HOME/Documents/Personal-Workspace" ``` 把新材料放进: ```text Personal-Workspace/00_Inbox/ ``` 然后让 Codex: ```text 使用 $project-inbox,先预览怎么整理 00_Inbox,不要移动文件。 ``` 确认效果后: ```text 使用 $project-inbox,整理 00_Inbox。高置信度的执行,不确定的放到 98_待确认。 ``` ## 目录原则 例如科研: ```text 03_科研/ └── 2026/ ├── 项目一/ │ ├── 申报书.docx │ ├── 立项通知.pdf │ ├── 调研数据.xlsx │ └── 论文初稿.docx ├── 项目二/ └── 项目三/ ``` 项目内部默认不继续按“通知 / 数据 / 论文 / 结题”等拆子文件夹。 ## 文件整理日志 工作区根目录会自动生成 `整理日志.md`。每次实际 Apply 后追加一条批次记录,例如: ```markdown ## 2026-08-09T21:30:00+08:00|整理批次 `batch-001` | 原位置 | 移动到 | 置信度 | 判断说明 | |---|---|---:|---| | `00_Inbox/访谈记录.docx` | `03_科研/2026/项目A/访谈记录.docx` | 95% | 与项目A关键词高度匹配 | ``` `整理日志.md` 面向用户查看;`.organizer/history.jsonl` 面向程序、Undo 和审计。两者同时保留。 ## 脚本职责 - `init_workspace.py`:初始化目录及 `.organizer` - `scan_inbox.py`:安全扫描 Inbox,输出 inventory - `extract_preview.py`:提取 Word/Excel/PPT/TXT/PDF 等轻量文本预览 - `rebuild_index.py`:从现有“领域/年份/项目”目录自动建立中央项目索引 - `validate_plan.py`:检查 AI 生成的计划是否越界或有问题 - `execute_plan.py`:安全执行计划,同时写 `.organizer/history.jsonl` 与根目录 `整理日志.md` - `undo.py`:撤销最近一批操作,并同步追加到 `整理日志.md` - `update_index.py`:维护中央项目索引 AI 负责“理解和判断”;脚本负责“确定性执行”。