内容
# 塞卡
**适用于克劳德代码的持久内存。零依赖。纯 Markdown。**
此外,它是唯一一个可以硬阻止破坏性工具调用的 AI 内存系统。
## 塞卡的作用
**1. 跨会话记住事物。** 在一个会话中告诉克劳德,在下一个会话中询问它,它就知道。偏好、决策、项目上下文,任何事情 — 都以纯 Markdown 文件的形式保存在 `~/.sekha/` 下。关闭克劳德代码。再次打开它时,内存仍然存在。
克劳德通过 MCP 调用 `sekha_save` / `sekha_search` / `sekha_list` / `sekha_delete` 来管理内存。你只需要正常地与克劳德对话。
**2. 阻止危险的工具调用(护城河)。** 塞卡钩入克劳德代码的 `PreToolUse` 事件,并在工具输入与你编写的正则表达式规则匹配时返回 `permissionDecision: "deny"`。AI **无法绕过此限制**,即使使用 `--dangerously-skip-permissions`。`rm -rf`、`git push --force`、`DROP TABLE` — 无论你选择保护什么。规则是纯 Markdown 文件,位于 `~/.sekha/rules/`,因此你的执行策略与版本控制下的任何其他配置一样可审查。
其他所有内存系统(MemPalace、Mem0、Letta、Zep、Basic Memory、CLAUDE.md)都只存储规则。塞卡在钩子边界强制执行它们。
## 诚实的范围
**塞卡强制执行的内容(严格):** 可匹配正则表达式的工具输入模式 — `rm -rf /`、`git push --force origin main`、`DROP TABLE users`。PreToolUse 钩子在工具调用运行之前否决它。
**塞卡不强制执行的内容:** 诸如“始终在执行前确认”或“不做假设”之类的行为规则。这些规则仍然是提示级别的提醒,AI 可以忽略它们。有关为什么这是当今克劳德代码钩子表面的基本限制,而不是塞卡的错误,请参见[威胁模型](#威胁模型)。
### 跨会话的内存

*克劳德记得你在上一个会话中告诉它的事情 — 以 Markdown 文件的形式保存在 `~/.sekha/` 下,按需通过 `sekha_search` MCP 工具检索。*
### 阻止破坏性工具调用

*克劳德要求塞卡安装一条规则,阻止在特定文件夹上执行 `rm -rf`,然后尝试删除该文件夹 — PreToolUse 钩子返回拒绝,文件得以保留。*
## 安装
```bash
pip install sekha
sekha init
```
就这样。`sekha init`:
- 为记忆和规则创建 `~/.sekha/`。
- 将 PreToolUse 钩子连接到 `~/.claude/settings.json`。
- 通过 `claude mcp add sekha --scope user` 自动注册 MCP 服务器,以便克劳德可以直接使用 `sekha_save` / `sekha_search` / `sekha_add_rule` 等工具。
重启克劳德代码后,它会选择新的钩子和 MCP 服务器。然后使用 `sekha doctor` 进行验证。
**如果 `claude` 不在 PATH 上** (例如克劳德代码已安装但 CLI 别名缺失),`sekha init` 会打印手动 `claude mcp add` 命令,以便您可以手动注册它。或者,使用 `sekha init --skip-mcp` 完全跳过自动注册。
## 功能
- **跨会话的持久内存。** `~/.sekha/` 下的纯 Markdown 文件,分为五个固定类别:`sessions`、`decisions`、`preferences`、`projects`、`rules`。grep 友好的文件名,如果您希望它们在版本控制下,可以跟踪 git。使用术语频率 x 最新性 x 文件名匹配评分进行搜索。
- **6 个 MCP 工具** 供 AI 自身管理内存:`sekha_save`、`sekha_search`、`sekha_list`、`sekha_delete`、`sekha_status`、`sekha_add_rule`。
- **工具模式规则强制执行** 在钩子级别。对于工具输入的正则表达式匹配,AI 无法绕过 — 即使使用 `--dangerously-skip-permissions`。行为规则(“始终确认”、“不做假设”)仍然是提示级别的,可以被覆盖;请参见威胁模型。
- **零运行时依赖** — 纯 Python 标准库,无供应链表面。
- **与任何 MCP 客户端合作** 用于内存(克劳德代码、Cursor、Cline、Windsurf)。钩子级别规则强制执行是 v0.1.0 中克劳德代码独有的。
- **CLI**:`sekha init`、`sekha doctor`、`sekha add-rule`、`sekha list-rules`、`sekha hook run/bench/enable/disable`、`sekha serve`。
## 工作原理
[图:克劳德代码 -> PreToolUse 钩子 -> sekha 钩子运行 -> 规则引擎 -> 阻止或允许]
三个进程,共用 `~/.sekha/` 下的状态:
1. **MCP 服务器** (长期运行,每个克劳德代码会话一个)— 提供内存工具。
2. **钩子** (短生命周期,每个工具调用一个)— 读取规则目录,匹配 `tool_name` + `pattern`,阻止或警告。
3. **CLI** (一次性)— `init`、`doctor`、`add-rule`、`list-rules`、`hook bench` 等。
钩子是区分因素。规则在每次调用时都会加载新的,因此编辑立即生效,解析错误会大声地报错,而不是静默地跳过规则。
## 示例规则
请参阅 [`examples/rules/`](examples/rules/) 以获取可复制粘贴的规则:
- `block-rm-rf.md` — 防止 `rm -rf /`、`rm -rf ~`、`rm -rf *` 灾难。
- `block-force-push-main.md` — 不允许对 `main`/`master` 进行 `git push --force`。
- `block-drop-table.md` — 拒绝 Bash 调用 SQL 中的 `DROP TABLE`。
- `warn-no-tests-before-commit.md` — 在 `git commit` 之前提示没有测试。
每个示例都是一条单一目的的规则,带有内联注释,解释如何收紧或放松模式。
## 威胁模型
### 塞卡强制执行的内容
工具输入的正则表达式模式。如果您编写一条规则,阻止 `Bash` 工具在其 `command` 字段与 `rm -rf` 匹配时运行,AI 无法绕过它。PreToolUse 钩子作为独立的 Python 子进程运行,评估规则并为匹配项返回 `permissionDecision: "deny"`。即使使用 `--dangerously-skip-permissions` 也能幸存。
### 塞卡不强制执行的内容
诸如“始终在编辑前确认”、“不要猜测”或“首先解释你的计划”之类的行为规则。这些规则存在于内存/上下文中作为提醒。AI 可以并且确实会忽略它们。这类规则是目前在克劳德代码层面上没有解决方案的 — 提示级别的提醒(CLAUDE.md、内存系统、警告严重程度的塞卡规则)都依赖于自愿遵守。
没有 PreReason 钩子。决策发生在 AI 的令牌流中,在工具调用之间,没有子进程可以介入。任何声称有此功能的人都在夸大其词。
### 为什么工具模式强制执行仍然是*一致性*强制执行,而不是*安全*沙盒
即使在塞卡可以阻止的事情中,AI 也可以通过选择不同的工具来绕过被阻止的模式。如果您阻止 `Bash` 匹配 `rm -rf`,AI 可以编写一个删除脚本并通过您未覆盖的工具调用它。塞卡有意将规则范围限定为 `tool_name`,因此您的策略保持可检查,而不是隐藏在不透明的允许列表后面。
为了防止受损或对抗性 AI 的攻击,请使用 OS 级别的沙盒 — 容器、VM、seccomp 等。塞卡让 AI 对您明确的意图保持诚实。它不保护您免受积极尝试绕过您的规则的创造性代理的攻击。
## 跨客户端支持
| 客户端 | 内存(MCP 工具) | 规则强制执行(钩子) |
|--------------|--------------------|--------------------------|
| 克劳德代码 | 是 | 是 |
| 光标 | 是 | 否(无钩子 API) |
| 克莱恩 | 是 | 否 |
| 风暴 | 是 | 否 |
钩子强制执行是 **克劳德代码独有** 的 v0.1.0 版本。内存工具在 MCP 工作的所有地方都可以使用。
## 文档
- [架构](docs/architecture.md) — 三进程设计、数据流、性能预算、不变性。在贡献之前请阅读。
- [集成测试运行手册](docs/hook-integration-test.md) — 在您的机器上验证钩子阻塞,端到端。
- [变更日志](CHANGELOG.md) — 版本历史。
- [发布运行手册](docs/release.md) — 维护人员如何发布版本。
- [v1.1 路线图](docs/roadmap-v1.1.md) — v0.1.x 之后计划的内容。
## 贡献
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
MIT
连接信息
猜你喜欢
rea
用于编码代理的逆向工程:一个 CLI 和 MCP 服务器,用于检查任何应用程序,了解其功能,并按照您的方式构建它们。
everything-claude-code
完整的 Claude Code 配置集合 - agents、skills、hooks、commands、rules、MCPs。来自 Anthropic...
Firecrawl
Firecrawl MCP Server 实现了网页抓取、爬虫和内容提取功能。
MarkItDown MCP
MarkItDown-MCP是一个轻量级服务器,用于将URI转换为Markdown。
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
Agent-Reach
赋予你的AI Agent观察整个互联网的眼睛。读取并搜索...