@yottameta/yotta-memory 0.22.5 → 0.22.7

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## v0.22.7 (2026-10-09)
+
+- **管理台 / 官网「配置键」补全人话说明**：高级 / CLI 页的 39 个配置键不再只显示「键名 + 命令」，每个键改为「键名 + 它是做什么的 + 默认值 / 取值 / 什么时候改」，与命令选项同一排版；键说明为单一真源（`CONFIG_KEY_HELP`），管理台 `/api/help` 与官网 `/product/` 同步渲染。
+- 新增配置键说明覆盖回归：每个 `CONFIG_VALUE_KEYS` 键必须有非空 `what` / `when` 说明，且不允许出现孤儿说明（说明里存在但键列表没有）。
+
+## v0.22.6 (2026-10-09)
+
+- **并发写入加固**：索引更新改为跨进程互斥（`.index.lock`，mkdir 原子语义 + 陈旧锁自动回收）+ 原子落盘（临时文件 + rename）；序号分配 / 记忆落盘 / 索引更新同处一个临界区，多智能体（多宿主、多 MCP 进程）同时写入更稳。
+- **索引一致性维护**：以记忆文件为唯一真源，读取路径与用户平台在后台做轻量一致性校准（自动对齐，无需用户操作；不修改任何记忆文件）。
+- **管理台搜索增强**：搜索支持按编号（文件名）与归属智能体查找（原支持标题 / 内容 / 标签）。
+- **管理台 CLI 页补全配置键**：高级 / CLI 页新增 39 个配置键速查（`config set` 单一真源，含 `memory_home` / `backup_*` / `maintain_*` / `consolidate_*` / `scale_*` 等），可直接搜索与复制。
+- **doctor**：新增索引一致性检查（条数 = 文件数）。
+- **安装器洁净度**：顶层跳过并清理 `*.tgz` 与 `test-fixtures/`（与 npm 包白名单一致），安装副本不再携带源码侧残留。
+- 新增 `test/index-consistency.test.js` 5 项（一致性检测与校准、幂等、6 进程并发 120 条零丢失、跨进程锁互斥、显示与实际对账 + 编号 / 归属搜索）。
+- 新增 `test/password-stdin-bom.test.js`（Windows PowerShell 管道 BOM）与 `test/installer-hygiene.test.js`（薄片洁净度 + 残留清理）。
+
 ## v0.22.5 (2026-10-07)
 
 - **修复 Electron 宿主（YottaCode shim）下开机自启拉起 GUI 而非服务**：宿主运行时为 Electron 时（`process.versions.electron`；`process.execPath` 指向 Electron 可执行文件），此前生成的任务 / 兜底 / 定时配置不带 `ELECTRON_RUN_AS_NODE=1`，开机拉起的是桌面程序本体、8787 无监听（新机首例实测）。现在自动检测并统一注入：Windows 主任务与每日备份任务（cmd /c + `set "ELECTRON_RUN_AS_NODE=1"`）、Windows Startup 兜底 .cmd（set 前缀）、Linux systemd 单元 / crontab @reboot / 备份定时器（`Environment=` / 行内前缀）、macOS 备份 LaunchAgent（EnvironmentVariables）。

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: yotta-memory
 description: 元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/可回滚：让任何 AI 智能体活过会话，开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档、记忆盘、共享记忆、局域网记忆、画像、开工上下文、长期理解摘要、近期走廊、会话闭环、记忆守则、profile、context、越用越懂、语义检索、反馈、维护、蒸馏、feedback、maintain、distill、explain、自我学习、自我进化、自我提升、查看平台分页、recall 候选预过滤、任务相关记忆、--focus、--embedding、压缩遗忘、consolidate、周期摘要、自动合并、分类型衰减、回滚、备份、backup、防误删、doctor、事务快照、基线探针、恢复演练、记忆库安全扫描、scan、命中打点、容量水位、--capacity、--propose、上下文压缩审计、context --audit
-version: 0.22.5
+version: 0.22.7
 license: MIT
 ---
 

package/assets/view.html

@@ -157,6 +157,8 @@
   .opt-what{color:var(--muted)}
   .opt-when{color:var(--faint)}
   .opt-risk{color:var(--danger)}
+  .opt-row.with-copy{grid-template-columns:minmax(150px,auto) minmax(0,1fr) auto;align-items:start}
+  .opt-row.with-copy .ibtn{width:26px;height:26px}
 
   @media (max-width:960px){.g4{grid-template-columns:repeat(2,minmax(0,1fr))}.bars{grid-template-columns:repeat(2,minmax(0,1fr))}.quick-list{grid-template-columns:minmax(0,1fr)}}
   @media (max-width:760px){
@@ -250,7 +252,7 @@
 
     <section class="view" id="view-memories">
       <div class="card toolbar">
-        <label class="search" style="min-width:280px;flex:1"><svg class="sv" viewBox="0 0 24 24"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/></svg><input id="memSearch" placeholder="搜索记忆（标题 / 内容 / 标签）"></label>
+        <label class="search" style="min-width:280px;flex:1"><svg class="sv" viewBox="0 0 24 24"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/></svg><input id="memSearch" placeholder="搜索记忆（标题 / 内容 / 标签 / 编号）"></label>
         <div class="chips" id="typeChips">
           <button class="chip active" data-type="all">全部</button>
           <button class="chip" data-type="FACT">FACT</button>
@@ -258,6 +260,7 @@
           <button class="chip" data-type="BOUND">BOUND</button>
           <button class="chip" data-type="COMMIT">COMMIT</button>
         </div>
+        <select id="ownerFilter" title="按智能体筛选" style="width:auto;min-width:140px"><option value="">全部智能体</option></select>
         <div class="spacer"></div>
         <button class="btn" id="btnArchived">已藏</button>
         <button class="btn" id="btnTrash">最近删除</button>
@@ -329,7 +332,7 @@
 (function () {
   'use strict';
   var $ = function (s) { return document.querySelector(s); };
-  var state = { view: 'overview', entries: [], count: 0, offset: 0, limit: 20, query: '', type: 'all', owners: [], overview: null, current: null, help: null };
+  var state = { view: 'overview', entries: [], count: 0, offset: 0, limit: 20, query: '', type: 'all', owner: '', owners: [], overview: null, current: null, help: null };
   var typeNames = { FACT: 'FACT 事实', PREF: 'PREF 偏好', BOUND: 'BOUND 边界', COMMIT: 'COMMIT 承诺' };
 
   function esc(s) {
@@ -437,14 +440,24 @@
     $('#ovBytes').textContent = fmtBytes(d.bytes);
     $('#accBackup').textContent = d.backupDir || '未配置';
     var colors = { FACT: 'var(--gold)', PREF: '#b79cdd', BOUND: '#8fb4de', COMMIT: 'var(--ok)' };
+    var byType = d.byType || {};
+    var typeCounts = { all: d.total || 0, FACT: byType.FACT || 0, PREF: byType.PREF || 0, BOUND: byType.BOUND || 0, COMMIT: byType.COMMIT || 0 };
     $('#typeBars').innerHTML = ['FACT', 'PREF', 'BOUND', 'COMMIT'].map(function (t) {
-      var n = d.byType[t] || 0;
-      return '<div class="bar"><span class="dot" style="background:' + colors[t] + '"></span><span class="faint">' + typeNames[t] + '</span><b>' + n + '</b></div>';
+      return '<div class="bar" data-type="' + t + '" style="cursor:pointer" title="查看 ' + typeNames[t] + '"><span class="dot" style="background:' + colors[t] + '"></span><span class="faint">' + typeNames[t] + '</span><b>' + typeCounts[t] + '</b></div>';
     }).join('');
+    Array.prototype.forEach.call(document.querySelectorAll('#typeChips .chip'), function (c) {
+      c.textContent = (c.dataset.type === 'all' ? '全部' : c.dataset.type) + ' ' + (typeCounts[c.dataset.type] || 0);
+    });
   }
   async function loadOwners() {
     var d = await api('/api/owners');
     state.owners = (d && d.owners) || [];
+    var sel = $('#ownerFilter');
+    if (sel) {
+      sel.innerHTML = '<option value="">全部智能体</option>' + state.owners.map(function (o) {
+        return '<option value="' + esc(o.owner) + '"' + (o.owner === state.owner ? ' selected' : '') + '>' + esc(o.owner) + '</option>';
+      }).join('');
+    }
     var box = $('#ownerRows');
     if (!state.owners.length) { box.innerHTML = '<tr><td colspan="5" class="faint">' + esc((d && d.hint) || '当前没有 owner，请先在 CLI 执行 yotta-memory iam <id>。') + '</td></tr>'; return; }
     box.innerHTML = state.owners.map(function (o) {
@@ -456,7 +469,7 @@
     }).join('');
   }
   async function loadEntries() {
-    var d = await api('/api/entries', { query: state.query, offset: state.offset, limit: state.limit, type: state.type === 'all' ? '' : state.type });
+    var d = await api('/api/entries', { query: state.query, offset: state.offset, limit: state.limit, type: state.type === 'all' ? '' : state.type, owner: state.owner || '' });
     if (d.error) { toast(errText(d, '加载失败')); return; }
     state.entries = d.entries || [];
     state.count = d.count || 0;
@@ -669,6 +682,15 @@
     Array.prototype.forEach.call(document.querySelectorAll('#typeChips .chip'), function (c) { c.classList.toggle('active', c === b); });
     loadEntries();
   });
+  $('#typeBars').addEventListener('click', function (e) {
+    var bar = e.target.closest('.bar[data-type]');
+    if (!bar) return;
+    state.type = bar.dataset.type; state.offset = 0;
+    Array.prototype.forEach.call(document.querySelectorAll('#typeChips .chip'), function (c) { c.classList.toggle('active', c.dataset.type === state.type); });
+    switchView('memories');
+    loadEntries();
+  });
+  $('#ownerFilter').addEventListener('change', function () { state.owner = this.value; state.offset = 0; loadEntries(); });
   $('#prevPage').addEventListener('click', function () { if (state.offset > 0) { state.offset -= state.limit; loadEntries(); } });
   $('#nextPage').addEventListener('click', function () { state.offset += state.limit; loadEntries(); });
 
@@ -803,7 +825,7 @@
   }
   function renderFull() {
     if (!state.help) return;
-    $('#cliFull').innerHTML = (state.help.groups || []).map(function (g) {
+    var groupsHtml = (state.help.groups || []).map(function (g) {
       var cmds = (g.commands || []).map(function (c) {
         var subs = (c.subcommands || []).map(function (s) {
           return '<div class="help-sub"><div class="cmd-head"><code class="cmd-name">' + esc(c.name + ' ' + s.name) + '</code></div>' +
@@ -817,6 +839,18 @@
       }).join('');
       return '<div class="quick-group"><h4>' + esc(g.group) + '</h4>' + cmds + '</div>';
     }).join('');
+    var keys = state.help.configKeys || [];
+    var keyHelp = state.help.configKeyHelp || {};
+    var keysHtml = keys.length ? '<div class="quick-group" id="cliConfigKeys"><h4>配置键（config set）</h4>' +
+      '<div class="cmd-when">全部可配置键（共 ' + keys.length + ' 个）。用法：yotta-memory config set &lt;键&gt; &lt;值&gt;，改完用 yotta-memory config get 复查；配置保存在 ~/.yottamemory/config.json。</div>' +
+      keys.map(function (k) {
+        var h = keyHelp[k] || {};
+        return '<div class="opt-row with-copy"><div class="opt-flag">' + esc(k) + '</div><div>' +
+          '<div class="opt-what">' + esc(h.what || '') + '</div>' +
+          (h.when ? '<div class="opt-when">' + esc(h.when) + '</div>' : '') +
+          '</div>' + copyBtn('yotta-memory config set ' + k + ' <值>') + '</div>';
+      }).join('') + '</div>' : '';
+    $('#cliFull').innerHTML = groupsHtml + keysHtml;
   }
   async function ensureHelp() {
     if (state.help) { renderQuick(); return; }

package/bin/install.js

@@ -27,7 +27,7 @@ const PKG_ROOT = path.join(__dirname, '..');
 const TOP_SKIP = [
   'package.json', 'package-lock.json', 'bin', 'lib', 'test',
   '.github', '.git', '.gitignore', '.npmignore', '.gitattributes',
-  '.yotta', '.tmp', 'install.sh', 'node_modules',
+  '.yotta', '.tmp', 'install.sh', 'node_modules', 'test-fixtures',
 ];
 const TOP_SKIP_SET = new Set(TOP_SKIP);
 // 缓存 / 编译产物：任意层级跳过，安装时同样清理。
@@ -190,6 +190,7 @@ function copyDir(src, dst, topLevel) {
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     // 只跳过安装包顶层开发文件；template/ 等嵌套同名载荷必须保留。
     if (topLevel && TOP_SKIP_SET.has(entry.name)) continue;
+    if (topLevel && entry.isFile() && /\.tgz$/i.test(entry.name)) continue;
     if (shouldSkipCache(entry.name, entry.isFile())) continue;
     const s = path.join(src, entry.name);
     const d = path.join(dst, entry.name);
@@ -219,6 +220,16 @@ function cleanResidue(target) {
     fs.rmSync(p, { recursive: true, force: true });
     removed.push(name);
   }
+  try {
+    for (const name of fs.readdirSync(target)) {
+      if (!/\.tgz$/i.test(name)) continue;
+      const p = path.join(target, name);
+      const entry = fs.lstatSync(p);
+      if (entry.isSymbolicLink() || !entry.isFile()) continue;
+      fs.rmSync(p, { force: true });
+      removed.push(name);
+    }
+  } catch (_) { /* ignore */ }
   const walk = (dir) => {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
       const p = path.join(dir, entry.name);