本地优先个人维基

解决什么问题

个人知识库往往会陷入两个困境：资料散落在桌面、下载目录或聊天记录中难以检索；AI 助手处理文件时容易造成原始内容被覆盖或污染。直接让模型读写整个文档库风险极高。

build-personal-wiki 旨在建立一套本地优先、不可变的个人维基系统。它将原始资料与 AI 生成的综合页面分离，确保私域数据不离开本地，同时通过结构化的提案流程管理所有持久化变更。

核心机制与工作流

该技能通过纯 Python 3 编写的 CLI 工具（wiki_standalone.py）驱动，不依赖 Git 也能运行。其核心能力包括：

• 不可变的原始资料库：所有接入的文件存入 raw/ 目录后即被视为只读，任何修改都会生成新版本，杜绝误删或覆盖风险。
• 双重源头管理：支持扫描外部目录（如 Documents、Downloads）的 Reference-root 模式，也支持直接管理用户上传文件的 Managed-copy 模式。
• 严格的审查门禁：AI 不会直接修改知识库页面。任何持久化写入前都会生成 .wiki-system/proposals/ 下的变更提案，包含 Markdown 摘要与 Diff，需经用户显式批准操作 ID 后方可执行。
• 哈希校验与溯源：每条引用均关联 raw/ 路径与 SHA-256 哈希，确保上下文可追溯。

启动时，技能会引导用户确认维基根目录，通过 check-home 验证目录为空且可写。随后利用 discover-roots 扫描常见路径，在用户明确授权内容读取前，仅基于元数据和哈希进行工作。

适用边界与注意点

• 数据隐私：技能默认不进行任何上传或同步。请警惕 raw/ 中可能包含的敏感信息，严禁配置远程仓库。
• 非镜像存储：raw/ 并非用户文件夹的镜像，仅保留被显式批准接入的文件。禁止批量复制整个微信导出目录或系统文件夹。
• 依赖限制：基础功能零第三方依赖，仅在处理 PDF 或 DOCX 时需要可选的 pypdf 和 python-docx 库。
• 操作中断恢复：若遇非空闲操作，需通过 status 命令确认是否恢复，避免状态不一致。

该方案适合注重数据主权、希望利用 AI 整理本地资料但又不愿牺牲文件安全性的开发者与研究者。