用途:把 PJangler Project Notebook 当作有边界、以 Git 为依据的项目记忆。Git 与仓库的 Project Manifest 是权威来源,远程笔记本只是 PJangler 拥有并可审计的、有范围的派生上下文。
主要能力:通过 pj notebook 命令族操作,包括 status、create、overview、audit、migrate,以及笔记的 list notes、get note、add note、update note、delete note、search notes,还有 capture list|retry。可用 audit 诊断 Drift,用 migrate 生成修复计划,加 --apply 做本地变更,仅在需要远程修复时加 --live。
使用方式:当前目录不明确时显式指定仓库;先运行 pj notebook status [repo] 确认绑定健康;供其他工具消费时用 --json,并检查 ok、符号错误码与 next_actions,不要凭文字推断成功。读写都限定在项目范围内,不要直接调用笔记本服务。create 与 live 迁移需要 --live;删除笔记需要确认或 --yes;不得删除稳定的 Overview 笔记。全局安装不会启用某个仓库,全局包装器在运行时自行限定范围。仅使用真正的 SessionStart 与 SessionEnd,不要用 Stop 代替会话边界。
限制与安全:不要把 hook 载荷和用户内容放进 argv 或日志;hook 失败应视为有界、可操作、fail-open 的诊断。出现 PROJECT NOTEBOOK OVERVIEW DRIFT 表示上下文过期,需先执行报告的 audit 或 migrate 动作。保留压力是准入诊断而非回执状态,不得为腾空间删除或压缩未解决的回执。端点与认证通过 PJangler 运行时配置解析,绝不写入仓库 Manifest、笔记、hook 命令或技能文件。全局 Claude 投影使用 scripts/project-hooks.py,其 owner 标记恰为 project-notebook.v1,不要手改实时设置或移除 Bloodbank、Hindsight、Git checkpoint、notification、CommonProject 等外部 hook。更完整的命令形式、策略优先级、hook 投影与安全配置见 configuration.md;捕获压力、Drift、快照、卸载与故障恢复见 recovery.md。