mirror of https://bitbucket.org/siakitem/my-pi.git synced 2026-10-26 18:55:22 +00:00

Files

T

云服务部-叶林立andDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com> ba164896d2 feat: 系统提示词改为单一入口统一管理

多个扩展各自整段改写系统提示词并按加载顺序接力，任一扩展定死提示词后
其余只能做字符串手术，且各上游的工具说明与组合包实际工具格局冲突。

- 新增 extensions/system-prompt.ts 作为唯一出口（加载列表最后），按
  config/prompt/（preamble.md、tools.jsonc、routing.jsonc、sections.jsonc）
  组合开场白、工具简介/规则与 <tool_routing> 分区；替代原封面与
  tool-routing 扩展，/dump-system-prompt 输出最终提示词。
- pi-chrome、pi-ssh、pi-hermes-memory 改为写命名分区，pi-rtk-optimizer
  改写 promptGuidelines，pi-permission-system 直接过滤结构化 skills，
  均不再返回 systemPrompt；pi-chrome 未授权时不再每轮冻结提示词。
- 新增 prompt-guard 代理加载第三方扩展（Hashline、FFF、LSP、
  context-mode）：拦截直接改写提示词并按目录覆盖工具说明；context-mode
  去掉与组合包路由冲突的锚点段，保留记忆与恢复快照。
- 消除冲突：bash 简介不再建议 grep/find；Hashline edit 不再称可用 grep
  锚点、不再介绍已关闭的 replace_text；context-mode 读写/网页路由提示。
- 守门测试：工具目录覆盖率、禁用用法检查、context-mode 上游原文锁定；
  AGENTS.md 新增「系统提示词单一所有权」。

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

2026-10-20 17:53:04 -07:00

4.0 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 保持上游原样。
before_agent_start 在结构化 systemPromptOptions 下把记忆上下文写入 sections.memory_policy 命名分区（而不是上游的 appendSystemPrompt 追加），分区顺序由组合包 config/prompt/sections.jsonc 统一控制；无结构化 options 的旧宿主分支保持原有的 systemPrompt 文本拼接行为。

工具与常驻

该扩展注册 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 移植改动，并与本地改动对照审查，不得整体覆盖本目录。

4.0 KiB Raw Blame History Unescape Escape