mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
从官方 Git 仓库导入 chandra447/pi-hermes-memory 在 tag v0.9.10 (df624056a2e8c68bc89ba0a81e1c120856ec9665,2026-10-02)的源码快照。 本次仅导入源码,尚未接入组合包:package.json、加载顺序、依赖与权限策略 均未改动。 - 原样导入 src/、tests/、docs/、scripts/、README、CHANGELOG、PLAN、 AGENTS 与 LICENSE;该快照共 156 个上游文件。 - 剔除嵌套 .git、上游 .github 工作流、.ralph/、.claude/、node_modules、 覆盖率与构建产物。 - 新增中文 UPSTREAM.md,记录来源,以及启用前必须完成的待决事项: 在 pi-compaction 之前注册加载顺序、better-sqlite3 版本与根 allowScripts 对齐、strip-ansi 解析确认。 - 说明选择 tag 而非 main 的原因:导入时上游 main 已领先至 24fcd8ad26fc27badb8d7dbaf8034645de07b893(2026-10-11),选 tag 是为 对应一个已发布、可复现的版本。 尚未接线。启用前还需反转 tests/extension-load.test.ts 中"不得加载 Hermes"的断言,并同步 pi-tool-search 分组、权限策略与文档。 验证:快照 156 个上游文件全部导入,目录内仅多出 UPSTREAM.md 一份; 已确认与上游 main 内容存在差异,证明取的是 tag 而非 main。
2.0 KiB
2.0 KiB
上游来源
- 官方仓库:https://github.com/chandra447/pi-hermes-memory
- 导入发布 tag:
v0.9.10 - 导入 commit:
df624056a2e8c68bc89ba0a81e1c120856ec9665(chore: bump version to 0.9.10 (#277),2026-10-02) - 初始本地导入:2026-10-13
- 许可证:MIT;上游
LICENSE文件原样保留。
快照取自官方 Git 仓库中 v0.9.10 tag 指向的 commit。导入时上游 main 已领先该 tag(24fcd8ad26fc27badb8d7dbaf8034645de07b893,2026-10-11);选择 tag 是为了让导入状态对应一个已发布、可复现的版本。不保留嵌套 .git、上游 .github 工作流、依赖目录、覆盖率与构建产物。
本地维护
本目录由 my-pi 组合包直接维护,不是 submodule。根包直接加载 pi-hermes-memory/src/index.ts。
导入时尚未接入组合包。启用该扩展前必须先完成以下事项,记录在此以免待决决定丢失:
- 根
package.json必须新增本地file:./pi-hermes-memory依赖,并在pi.extensions中注册扩展入口。 - 注册顺序很重要:该扩展必须在
pi-compaction之前加载。ExtensionRunner.emit()会在遇到第一个返回{ cancel: true }的session_before_compacthandler 时停止,而pi-compaction/index.ts在判定无需压缩时正是这样返回。注册在它之后的 handler 在这些轮次会被跳过,从而静默禁用该扩展的flushOnCompact。 - 该扩展依赖
better-sqlite3@^13.0.3。根allowScripts当前只放行better-sqlite3@12.11.1(Context Mode 使用);安装前必须对齐原生构建批准。 strip-ansi@7.2.0是第二个运行时依赖,必须能与现有依赖树干净解析。- 它注册
memory_add/memory_replace/memory_remove/memory_search/session_search/skill_manage,以及/memory-*命令。这些名称当前与组合包中的任何内容都不冲突。
同步上游时,请从明确 tag/commit 移植改动,并与本地改动对照审查,不得整体覆盖本目录。