你的源文件(.md 转写/纪要)
      │  pj102 ingest —— 扫描 / 五类分型 / 幂等记账
      ▼
   索引 state
      │  pj102 run —— 13 步 LLM 编译管线（s1…s15）
      ▼
   粗编 wiki ── 后处理链: polish → merger → backlink → fix_index → lint → dispute → log
      ▼
 你的 wiki 知识库（Obsidian 可直接打开的 markdown 目录）
      │
      ├── pj102 ask "……"        检索问答（L1 实体 / L2 综合引用）
      ├── pj102 lint / stats      质检与统计
      └── MCP 三工具              kb_query / kb_lint / kb_stats

git clone https://github.com/<owner>/pj102-engine.git
cd pj102-engine
pip install -e .
pj102 init 我的知识库

pip install git+https://github.com/foreverkol/pj102-engine.git
pj102 init 我的知识库

pj102 init 我的知识库                    # 1. 生成空白实例（全占位符配置）
# 2. 编辑 我的知识库/config/project.yaml：
#    source_dir 指向你的转写文件目录；填核心人物与业务关键词
# 3. 编辑 我的知识库/.env：填入你的 LLM API key
pj102 ingest                             # 4. 分型入库（幂等可重跑）
pj102 run                                # 5. 运行 13 步管线，生成你的 wiki
pj102 ask "某人相关的合作事项有哪些"       # 6. 检索问答

// 客户端 mcp 配置示例（WorkBuddy: ~/.workbuddy/mcp.json；Codex: ~/.codex/config.toml 的 [mcp_servers]）
{
  "mcpServers": {
    "pj102-kb": {
      "command": "pj102",
      "args": ["mcp", "-i", "/你的/实例目录"]
    }
  }
}

pj102-engine/
├── src/pj102_engine/     # 引擎源码
│   ├── code/             # 管线步骤 / 后处理链 / 检索栈 / lint / MCP 服务器
│   ├── scripts/          # 摄入 / 全量运行 / 查询归档等入口
│   ├── cli.py            # pj102 命令入口
│   └── defaults/         # 默认配置与实例模板
├── docs/                 # 设计与使用文档（本仓库自带完整规格）
├── examples/             # 虚构示例源（冒烟自检用，非真实数据）
├── tests/                # 单元测试（虚构化语料）
├── pyproject.toml
└── README.md