前言¶
在灵芯派（SmartPi）这类 ARM64、可用空间往往只有约 2GB 的设备上跑 OpenCode，常见问题是：新开一轮对话后，助手不记得上次的配置、排障结论和进行中的任务；本地又没有稳定的备份，异常中断就容易丢进度。单靠把聊天记录贴在笔记里，既占空间，也难让 Agent 按固定结构恢复上下文。
下面介绍 SkillHub 上的 灵芯派记忆守护者（包名 opencode-lingxin-memory，v1.0.0）。它用 ~/.opencode-memory/ 目录存放 Markdown 与 JSON 索引，配合 Git 与 Gitee（或 GitHub）远程仓库做同步，面向低资源环境做记忆持久化。SkillHub 侧分类为 ai-agent，下载约 480 次，评分 100000（平台展示数据）。
这是什么¶
灵芯派记忆守护者 是一套基于通用 SKILL.md 的 Agent Skill：指导 OpenCode 类助手在会话开始读取长期记忆与当日日志，在会话结束执行同步脚本，把变更纳入版本控制并推送到远端。
- 维护方：Skill 元数据作者为
zmrobo；SkillHub 可通过命名空间indiv-zhangwei安装同名包。 - 官方登记地址：https://api.skillhub.cn/user_a5827f21/opencode-lingxin-memory
说明：该 API 地址在直接抓取时可能无正文；https://www.skillhub.cn/skills/user_a5827f21/opencode-lingxin-memory 页面当前显示「Skill 未找到」。安装前可用skillhub search opencode-lingxin确认是否仍可解析到@indiv-zhangwei/opencode-lingxin-memory。 - 许可：MIT。
核心功能¶
依据 Skill 包内 _meta.json 与 SKILL.md，已声明能力包括：
- 跨会话记忆持久化：长期内容写入
MEMORY.md，按日写入YYYY-MM-DD.md，并用INDEX.md、memory_index.json、project_timeline.json做导航与时间线。 - Git 版本控制：记忆库目录初始化 Git 仓库，便于回溯与对比。
- Gitee 云端备份同步：通过
sync.sh在对话结束后提交并同步（需自行配置git remote）。 - 轻量化设计：元数据标注至少约 100MB 可用空间；目标平台为 SmartPi / ARM64、Debian 10 及兼容系统。
- 依赖：
git、bash；远端需 Gitee 或 GitHub 账户。
安装与启用¶
安装分两层：把 Skill 装进 Agent（让模型按说明操作记忆库），以及 在设备上部署记忆库（install.sh）。
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 官方说明检查 CLI，未安装时执行完整安装脚本：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
文档：https://skillhub.cn/install/skillhub.md
2. 将 Skill 安装到当前 Agent 的 skills 目录¶
安装时必须使用 --dir 指向当前客户端识别的 skills 路径，否则默认落在 ./skills/ 可能不会被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/ - Claude Code：
~/.claude/skills/
在 2026-10-22 环境下，下列命令可成功拉取 Skill 包（命名空间以 CLI 解析结果为准）：
skillhub install opencode-lingxin-memory --namespace indiv-zhangwei --dir ~/.cursor/skills/
也可让 Agent 按 SkillHub 提示词安装（文档模板为安装 @user_a5827f21/opencode-lingxin-memory；若该命名空间解析失败，改用上文 indiv-zhangwei）。
3. 在灵芯派上初始化记忆库¶
Skill 包内提供 install.sh，将模板复制到 ~/.opencode-memory/ 并初始化 Git。SKILL.md 中的示例路径为作者环境，实际应进入 已安装的 Skill 目录 再执行：
cd ~/.cursor/skills/@indiv-zhangwei/opencode-lingxin-memory
./install.sh
首次配置 Gitee 远程仓库并推送：
cd ~/.opencode-memory
git remote add origin https://gitee.com/你的用户名/仓库.git
git push -u origin master
将 你的用户名/仓库 替换为自有远端；若使用 GitHub，替换为对应 HTTPS 地址即可。
典型用法¶
以下流程来自 Skill 包 SKILL.md 与 README.md，可按日把 2026-04-30.md 换成当天日期文件。
新对话开始——恢复上下文：
cat ~/.opencode-memory/MEMORY.md
cat ~/.opencode-memory/2026-04-30.md
README.md 还建议在开始时阅读 ~/.opencode-memory/README.md。
对话结束——同步记忆：
~/.opencode-memory/sync.sh
日常维护（可选）：
cd ~/.opencode-memory && git status
grep -r "关键词" ~/.opencode-memory/
du -sh ~/.opencode-memory/
启用 Skill 后，应由 Agent 在合适节点主动读取/更新上述文件，而不是仅手动 cat；手动命令适合排障或没有 Agent 参与的场景。
适用场景与注意¶
适合谁
- 在灵芯派或同类 ARM64、Debian 设备上使用 OpenCode，需要跨会话保留系统配置、已解决问题和当日工作日志的开发者。
- 希望用 Git + Gitee 做异地备份、又不愿在设备上部署重型记忆服务的团队。
限制与注意
- 页面与 API 状态：登记 URL 与 SkillHub 详情页可能暂时无法浏览，以
skillhub install能否成功为准。 - 空间与路径：示例安装路径
/home/zmrobo/Project来自文档示例，勿照搬；记忆库固定为~/.opencode-memory。 - 远端与分支：
git push -u origin master以 Skill 文档为准；若远端默认分支为main，需按仓库设置调整。 - Skill 与记忆库：只安装 Skill 而未运行
install.sh时，~/.opencode-memory可能不存在，同步脚本也无法使用。 - 与 Cursor 等客户端：本文仅列出 SkillHub 文档中的 skills 路径；装好后仍需重启或按各客户端规则刷新 Skill 列表。
结尾¶
灵芯派记忆守护者把「长期记忆 + 按日日志 + Git 同步」收敛到一套目录约定和 sync.sh，适合在低资源板子上给 OpenCode 补跨会话上下文。安装与元数据以 SkillHub 与包内 SKILL.md 为准；官方登记地址：
https://api.skillhub.cn/user_a5827f21/opencode-lingxin-memory
