---
name: shushu-memory-installer
description: Guide an authorized learner through Shushu memory toolkit purchase, verified download and project-scoped installation on macOS or Windows 11 pilot. Use for explicit memory setup requests, not ordinary conversation or automatic billing on MCP connection.
---

# 舒舒记忆 Harness 下载与安装引导

这是免费的安装引导，不包含付费运行工具，也不包含舒舒私人母库。仅在学员要求搭建记忆时使用；服务端不能替你操作学员电脑。

## 先看清环境和授权

确认操作系统、Python 3.10+、客户端、本地文件/命令权限和学员指定的测试项目。只有远程 MCP 能力时，说明无法本地安装。不能扫描全盘、覆盖旧库、改全局身份或静默安装依赖。

先读取公开元信息 `https://cognition.openenergy.top/portal-api/memory-kit-info`，检查当前版本、价格与平台限制。v1 工具包开通需 19,999 现有积分，可用 CDK 余额；一个客户、一个项目，WorkBuddy 与 Codex 包共用权益，重复下载不再次收费。不含人工代部署或第三方模型费用。Windows 11 是待实机验收候选；不能承诺一定安装成功。

## 购买由学员明确确认

让学员打开 `https://cognition.openenergy.top/#memory-architect`，登录并点击“开通 / 下载”，核对价格与候选风险后确认。当前版本只允许网页会话购买；不要尝试伪造会话、CSRF、确认字段，或通过 MCP 普通调用代替购买。连接 MCP、阅读本 Skill 或提供 API key 都不是扣费授权。

若学员已经购买，直接使用其下载文件，或者使用客户已配置的 Bearer 凭据请求 `https://cognition.openenergy.top/portal-api/memory-kit-workbuddy`（WorkBuddy）或 `https://cognition.openenergy.top/portal-api/memory-kit`（Codex）。凭据仅放 HTTPS Authorization 请求头，不放 URL、命令日志、聊天或项目文件；不能安全使用已有凭据时让学员浏览器下载，不索要明文密钥。402 表示缺少权益，停止；401 表示认证失败，停止；不要自动反复购买。

## 下载后才安装

以公开元信息中对应客户端的 SHA-256 核对完整下载包；不一致停止。哈希不是独立数字签名。检查 ZIP 路径不含绝对路径、父目录越界或符号链接；只解压到客户确认的新目录，不覆盖旧安装。

先阅读解压后的 SKILL.md 与 references/guide.md；Windows 11 先读 references/windows11.md，WorkBuddy 再读 references/workbuddy.md。执行预检后展示具体解释器、工具位置、项目库位置和拟追加的入口文件，获得学员安装授权后才执行 init/attach。

使用包内 acceptance.py 在临时目录测试，再用学员同意的合成信息演练候选、人类批准、召回、纠正和撤回。定时任务另需授权；Windows 候选只生成 XML，由用户审核导入任务计划程序，不能伪称自动注册已完成。Mac 按包内说明安装。一次只维护同一个库，不建立重复调度。

## 如何证明跑起来

分别报告：文件已下载、库初始化、入口哈希匹配、新 Agent 会话有真实检索及出处、调度注册、首次维护成功、备份恢复成功。新进程测试不等于新 Agent 会话；任务注册不等于执行成功。未观察的写未验证。

失败保留原库、备份和原入口，报告脱敏错误；不为“修复”删除数据、关闭安全规则或改用另一个库伪装成功。只提交经许可的脱敏状态，不上传学员记忆全文。已安装工具在本地维护不另扣远程积分；远程认知调用按另行说明计费。