SuperAPI AI 工具集

host-memory

办公与效率

查看项目

更新于 10-16 08:44

技能介绍

用途:为主机上的目录与项目建立一套轻量记忆台账,回答“某目录或项目是什么、怎么操作、怎么维护”,并记录观察、待办、结论,支持巡检本机、配置同步与备份等场景。

主要能力:三层结构。INDEX.md 是索引,把 scope(目录)与 tag(标签)映射到 slug;rules/<slug>.md 存稳定知识(是什么、怎么操作、怎么维护);logs/<slug>.md 只追加,记录发生过什么与要做什么,todo 直接写成一行。目录用于按“人在哪”自动命中,标签用于跨目录按主题命中。

使用方式:默认存储位置为 ~/host-memory/(Windows 为 %USERPROFILE%\host-memory)。加载后先读 INDEX.md,不存在视为空;scope 与当前目录相等才算命中,嵌套子目录不命中父级 scope,tag 按主题跨目录匹配;只读命中 slug 的 rules,需要脉络或待办再读 logs 尾部。写入时稳定知识进 rules,观察、运维结果、todo 追加进 logs;新建记忆先在 INDEX.md 加一行再建文件;跨主题知识 scope 写 -,只靠标签命中;跨目录共性归最近祖先 slug,整机级归 host-<host>。只读不建,只有写入才创建文件。

压实:logs 只追加会变长,压实把仍有效的上提进 rules、删除过时内容、保留近期脉络,并在结尾追加压实标记说明压缩行数与上提条数。只压实命中过的 slug,不遍历;未完成 todo 一律保留;压实是唯一允许重写 logs 的操作,INDEX 不因压实改动。

命名与标签:slug 用稳定、可读、唯一、kebab-case,优先目录或项目本名;主机级用 host-<主机名小写>。标签小写 kebab-case,一条 3–6 个,优先复用已有标签。

限制:只记入口与位置,不记密钥、token、密码明文;具体记什么由用户自行配置;与 project-memory、chezmoi-config-manager 等相邻技能有边界,本技能只做台账与索引。