Files
my-pi/pi-hermes-memory/UPSTREAM.md
T
云服务部-叶林立andDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com> 2aa1be0b54 feat: 组合包配置以包内 config/ 为唯一来源,并新增受保护写入人工审批
配置统一:权限策略、硬防御、Tool Search、提示词封面以及新迁入的
RTK、pi-compaction、pi-worktree、pi-hermes-memory 配置全部由扩展
直接读取已安装组合包内的 config/,pi install / pi update 即完成部署;
删除 rebuild-bundle-config.mjs 与 bundle-manifest.json,my-pi/ 只保留
日志与缓存。update.sh 成功升级后将默认 git 来源的已安装副本
reset 回发布版本。AGENTS.md 新增「组合包配置原则」。

脚本整合:search_config.sh / ssh_config.sh 合并为 configure.sh
search|ssh;install.sh / update.sh 共享函数抽到 scripts/lib.sh,远程
安装器改为先下载到临时文件再执行,下载失败可被检测。

权限:hard-guards 新增 protectedWrites,写入 Pi 凭据/设置、已安装
组合包与扩展目录、pi-ssh 凭据库时一律人工确认(跳过 AutoReview、
yolo 与 Session grant,无 UI 时拒绝);放行 ls、LSP 查询、ctx 只读、
web_search、Chrome 只读与 git 只读命令,skill_manage 改为 ask。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-10-20 01:05:31 -07:00

3.6 KiB
Raw Blame History

上游来源

  • 官方仓库: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
  • 接入组合包:2026-10-14
  • 许可证:MIT;上游 LICENSE 文件原样保留。

快照取自官方 Git 仓库中 v0.9.10 tag 指向的 commit。导入时上游 main 已领先该 tag(24fcd8ad26fc27badb8d7dbaf8034645de07b893,2026-10-11);选择 tag 是为了让导入状态对应一个已发布、可复现的版本。不保留嵌套 .git、上游 .github 工作流、依赖目录、覆盖率与构建产物。

本地维护

本目录由 my-pi 组合包直接维护,不是 submodule。根包通过 file:./pi-hermes-memory 依赖并直接加载 pi-hermes-memory/src/index.ts,不得同时安装或加载 npm 预编译入口。

加载顺序

该扩展必须注册在 pi-compaction 之前。 ExtensionRunner.emit() 在遇到第一个返回 { cancel: true } 的 session_before_compact handler 时立即返回,而 pi-compaction/index.ts 在判定无需压缩时正是这样返回。注册在它之后的 handler 在这些轮次会被跳过,从而静默禁用该扩展的 flushOnCompact。

依赖

  • better-sqlite3@^13.0.3:13.x 运行时实际 dlopen 的是包内 N-API 预编译二进制 prebuilds/<platform>.node,不依赖 node-gyp 编译产物。npm 会因该包存在 binding.gyp 而推断出隐式 node-gyp rebuild,但该步骤既无必要也不得批准。npm 会把它嵌套安装到本目录的 node_modules/,与 Context Mode 使用的根 better-sqlite3@12.11.1 并存;因此根 allowScripts 无需新增条目,也不得删除既有的 better-sqlite3@12.11.1 放行。
  • strip-ansi@7.2.0:解析到根 node_modules。

本地改动

  • devDependencies 中的 @earendil-works/pi-ai、@earendil-works/pi-coding-agent、@earendil-works/pi-tui、typebox、tsx、typescript、@types/better-sqlite3 已从上游的 ^0.80.2 等范围改为与根包一致的精确版本。上游的宽松范围与根包的 0.84.2 不兼容,会让 npm 在本目录嵌套安装第二套 Pi runtime(实测 229 MB),违反组合包"不得再安装一套 Pi runtime"的纪律;pi-notify/package.json 是同样的先例。运行时依赖(better-sqlite3、strip-ansi)与 peerDependencies 保持上游原样。

工具与常驻

该扩展注册 memory_add、memory_replace、memory_remove、memory_search、session_search、skill_manage,以及 /memory-* 命令。六个工具全部通过 pi-tool-search 的 alwaysEnabled 常驻,并在 pi-permission-system 策略中默认 allow。

注意 skill_manage 由本扩展提供,不是 Pi 宿主能力:Pi 只负责发现并加载 skill 目录(~/.pi/agent/skills/ 加扩展通过 resources_discover 注册的目录),本身没有创建 skill 的工具。因此本扩展同时承担 skill 的写入与目录注册两件事;不加载它,projects-memory/<项目>/skills/ 下的既有 skill 也不会被 Pi 发现。

用户数据

  • 全局记忆与 skill:~/.pi/agent/pi-hermes-memory/
  • 项目记忆与 skill:~/.pi/agent/projects-memory/<项目>/ 以上路径是用户数据,不属于组合包,也不应提交或自动清理。组合包配置位于已安装组合包的 config/pi-hermes-memory.json,随 pi update 刷新;旧 ~/.pi/agent/hermes-memory-config.json 被忽略。

同步上游时,请从明确 tag/commit 移植改动,并与本地改动对照审查,不得整体覆盖本目录。