@tom2012/cc-web 1.5.91 → 1.5.93

package/backend/dist/memory-pool/pool-manager.js

@@ -0,0 +1,230 @@
+"use strict";
+// backend/src/memory-pool/pool-manager.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPool = readPool;
+exports.writePool = writePool;
+exports.readBallContent = readBallContent;
+exports.writeBallContent = writeBallContent;
+exports.enrichBallsWithBuoyancy = enrichBallsWithBuoyancy;
+exports.generateSnapshot = generateSnapshot;
+exports.migrateV1toV2 = migrateV1toV2;
+exports.needsUpgrade = needsUpgrade;
+exports.isInitialized = isInitialized;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../config");
+const buoyancy_1 = require("./buoyancy");
+const POOL_FILE = 'pool.json';
+const BALLS_DIR = 'balls';
+const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
+function readPool(poolDir) {
+    const file = path.join(poolDir, POOL_FILE);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writePool(poolDir, pool) {
+    (0, config_1.atomicWriteSync)(path.join(poolDir, POOL_FILE), JSON.stringify(pool, null, 2));
+}
+function readBallContent(poolDir, ballId) {
+    const file = path.join(poolDir, BALLS_DIR, `${ballId}.md`);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function writeBallContent(poolDir, ballId, content) {
+    const dir = path.join(poolDir, BALLS_DIR);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    (0, config_1.atomicWriteSync)(path.join(dir, `${ballId}.md`), content);
+}
+function enrichBallsWithBuoyancy(pool) {
+    const { lambda, alpha, t } = pool;
+    return pool.balls
+        .map((ball) => ({
+        ...ball,
+        buoyancy: (0, buoyancy_1.computeBuoyancy)(ball.B0, ball.H, alpha, lambda, t, ball.t_last, ball.permanent),
+    }))
+        .sort((a, b) => b.buoyancy - a.buoyancy);
+}
+function generateSnapshot(pool) {
+    const balls = enrichBallsWithBuoyancy(pool);
+    const cap = pool.active_capacity;
+    const active = balls.slice(0, cap);
+    const deep = balls.slice(cap);
+    const lines = [`## Memory Pool Snapshot (t=${pool.t})`, '### Active (sorted by buoyancy)'];
+    active.forEach((b, i) => {
+        const perm = b.permanent ? ', permanent' : '';
+        lines.push(`${i + 1}. [${b.type}] ${b.summary} (B=${b.buoyancy.toFixed(1)}${perm})`);
+    });
+    if (deep.length > 0) {
+        const lowest = deep[deep.length - 1].buoyancy;
+        lines.push(`### Deep (${deep.length} balls, lowest B=${lowest.toFixed(2)})`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Migrate from v1 (state.json + index.json + frontmatter balls) to v2 (pool.json + pure content balls).
+ * Idempotent: if pool.json already exists with version >= 2, returns empty changes.
+ */
+function migrateV1toV2(poolDir) {
+    const changes = [];
+    // Check if already migrated
+    const existing = readPool(poolDir);
+    if (existing && existing.version >= 2)
+        return { changes };
+    // Read old state.json
+    const stateFile = path.join(poolDir, 'state.json');
+    if (!fs.existsSync(stateFile))
+        return { changes: ['no state.json found, skipping'] };
+    let state;
+    try {
+        state = JSON.parse(fs.readFileSync(stateFile, 'utf-8'));
+    }
+    catch (e) {
+        throw new Error('state.json is corrupt: ' + (e.message || e));
+    }
+    // Read old index.json
+    const indexFile = path.join(poolDir, 'index.json');
+    let oldBalls = [];
+    if (fs.existsSync(indexFile)) {
+        try {
+            const idx = JSON.parse(fs.readFileSync(indexFile, 'utf-8'));
+            oldBalls = idx.balls || [];
+        }
+        catch { /* empty */ }
+    }
+    // Build ball metadata from index.json entries, enriching with frontmatter data where available
+    const ballsMeta = oldBalls.map((b) => {
+        // Try to read created_at from ball frontmatter
+        let created_at = new Date().toISOString();
+        const ballFile = path.join(poolDir, BALLS_DIR, `${b.id}.md`);
+        if (fs.existsSync(ballFile)) {
+            const raw = fs.readFileSync(ballFile, 'utf-8');
+            const match = raw.match(/created_at:\s*"?([^"\n]+)"?/);
+            if (match)
+                created_at = match[1].trim();
+        }
+        return {
+            id: b.id,
+            type: b.type || 'project',
+            summary: b.summary || '',
+            B0: b.B0 ?? 5,
+            H: b.H ?? 0,
+            t_last: b.t_last ?? 0,
+            hardness: b.hardness ?? 5,
+            permanent: false,
+            links: b.links || [],
+            created_at,
+        };
+    });
+    // Strip frontmatter from ball files FIRST (before writing pool.json as the v2 gate)
+    const ballsDir = path.join(poolDir, BALLS_DIR);
+    if (fs.existsSync(ballsDir)) {
+        const files = fs.readdirSync(ballsDir).filter((f) => f.endsWith('.md'));
+        let stripped = 0;
+        for (const file of files) {
+            try {
+                const filePath = path.join(ballsDir, file);
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                if (raw.startsWith('---')) {
+                    const clean = raw.replace(FRONTMATTER_RE, '').trimStart();
+                    (0, config_1.atomicWriteSync)(filePath, clean);
+                    stripped++;
+                }
+            }
+            catch (e) {
+                changes.push(`warning: failed to strip frontmatter from ${file}: ${e.message}`);
+            }
+        }
+        if (stripped > 0)
+            changes.push(`stripped frontmatter from ${stripped} ball files`);
+    }
+    // Write pool.json LAST — this is the v2 gate, so partial migration can be retried
+    const pool = {
+        version: 2,
+        t: state.t ?? 0,
+        lambda: state.lambda ?? 0.97,
+        alpha: state.alpha ?? 1.0,
+        active_capacity: state.active_capacity ?? 20,
+        next_id: state.next_id ?? 1,
+        pool: state.pool ?? 'project',
+        initialized_at: state.initialized_at ?? new Date().toISOString(),
+        balls: ballsMeta,
+    };
+    writePool(poolDir, pool);
+    changes.push(`created pool.json with ${ballsMeta.length} balls`);
+    // Backup old files (rename, not delete)
+    try {
+        fs.renameSync(stateFile, stateFile + '.v1bak');
+        changes.push('backed up state.json → state.json.v1bak');
+    }
+    catch { /* non-fatal */ }
+    if (fs.existsSync(indexFile)) {
+        try {
+            fs.renameSync(indexFile, indexFile + '.v1bak');
+            changes.push('backed up index.json → index.json.v1bak');
+        }
+        catch { /* non-fatal */ }
+    }
+    return { changes };
+}
+/**
+ * Check if pool directory uses v1 format (has state.json but no pool.json).
+ */
+function needsUpgrade(poolDir) {
+    const hasPool = fs.existsSync(path.join(poolDir, POOL_FILE));
+    const hasState = fs.existsSync(path.join(poolDir, 'state.json'));
+    return hasState && !hasPool;
+}
+/**
+ * Check if pool is initialized (either v1 or v2 format).
+ */
+function isInitialized(poolDir) {
+    return (fs.existsSync(path.join(poolDir, POOL_FILE)) ||
+        fs.existsSync(path.join(poolDir, 'state.json')));
+}
+//# sourceMappingURL=pool-manager.js.map

package/backend/dist/memory-pool/pool-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-manager.js","sourceRoot":"","sources":["../../src/memory-pool/pool-manager.ts"],"names":[],"mappings":"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"}

package/backend/dist/memory-pool/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/memory-pool/templates.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,IAAI,MAAM,CAyKvC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAqE3C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAmB9C"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/memory-pool/templates.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,IAAI,MAAM,CAkJvC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CA2D3C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAiB9C"}

package/backend/dist/memory-pool/templates.js

@@ -7,17 +7,19 @@ exports.generateClaudeMdBlock = generateClaudeMdBlock;
 function generateSpecMd() {
     return `# Memory Pool 规范文档 (SPEC.md)
 
-> 本文档定义了记忆池系统的完整规范。AI 应在执行复杂记忆操作（分化、融合、架构调整）时参考本文档。
+> 本文档定义了记忆池系统��完整规范。AI 应在执行复杂记忆操作时参考本文档。
 > 日常操作请使用 QUICK-REF.md。
 
 ## 一、核心模型：楔形容器与浮球系统
 
-记忆池是一个**楔形容器**——上窄下深，深度无限。每条记忆是容器中的一个**浮球**，对应 \`.memory-pool/balls/\` 下的一个 \`.md\` 文件。
+记忆池是一个**楔形容器**——利用物理几何来施加计算层面的容量约束。每条记忆是容器中的一个**浮球**，对应 \`.memory-pool/balls/\` 下的一个 \`.md\` 文件。
 
-- **活跃层**：浮力最高的 Top-N 个球（N = \`state.json\` 中的 \`active_capacity\`），AI 每次对话应优先加载
+- **活跃层**：浮力最高的 Top-N 个球（N = \`pool.json\` 中的 \`active_capacity\`），AI 每次对话应优先加载
 - **深层**：其余球，不主动加载，但可通过查询或连线召回
 - **永不消失**：浮力趋近于零但永远不为零，任何记忆都可被召回
 
+物理特性——浮力、碰撞、衰减——驱动记忆的自动筛选、重新排序和重构。可视化是附带收益，而非设计目标。
+
 ## 二、浮力公式
 
 \`\`\`
@@ -26,24 +28,28 @@ B(t) = (B₀ + α · H) · λ^(t - t_last)
 
 | 符号 | 含义 | 来源 |
 |------|------|------|
-| B₀ | 初始浮力 | 球文件 frontmatter \`B0\` |
-| H | 累计命中次数 | 球文件 frontmatter \`H\` |
-| α | 查询增益系数 | \`state.json\` → \`alpha\`（默认 1.0） |
-| λ | 衰减率 | \`state.json\` → \`lambda\`（默认 0.97） |
-| t | 当前全局轮次 | \`state.json\` → \`t\` |
-| t_last | 上次访问轮次 | 球文件 frontmatter \`t_last\` |
+| B₀ | 初始浮力 | \`pool.json\` 球条目 \`B0\` |
+| H | 累计命中次数 | \`pool.json\` 球条目 \`H\` |
+| α | 查询增益系数 | \`pool.json\` → \`alpha\`（默认 1.0） |
+| λ | 衰减率 | \`pool.json\` → \`lambda\`（默认 0.97） |
+| t | 当前全局轮次 | \`pool.json\` → \`t\` |
+| t_last | 上次访问轮次 | \`pool.json\` 球条目 \`t_last\` |
+
+**浮力动态计算**：buoyancy 不存储在文件中，每次读取时由后端根据公式实时计算。
 
-**轮次规则**：每条用户消息算一轮。AI 在对话开始时读取 \`state.json\` 的 \`t\` 值，在对话过程中根据用户消息数量自增并写回。
+**永久标记**：\`permanent: true\` 的球跳过衰减项，\`B(t) = B₀ + α · H\`。
 
-## 三、球的五个属性
+**轮次规则**：每条用户消息算一轮。\`t\` 由系统 hook 自动递增，AI 无需手动管理。
+
+## 三、球的属性
 
 | 属性 | 字段 | 说明 |
 |------|------|------|
 | 体积 | （正文长度） | 信息的 token 数或字数，越长越大 |
 | 浮力 | \`B0\`, \`H\`, \`t_last\` | 由公式计算，决定检索优先级 |
 | 硬度 | \`hardness\` (0-10) | 抗拆解能力，硬度高的球抵抗分化 |
-| 连线 | \`links[]\` | 与其他球的关联：\`strong\`（分化产生）或 \`weak\`（共现产生） |
-| 融合潜力 | \`fusion_potential\` (0-1) | 多次共现检索时累积，超过阈值可触发融合 |
+| 连线 | \`links[]\` | 与其他球的关联（ID 数组） |
+| 永久 | \`permanent\` | true 时不参与衰减 |
 
 ## 四、球的四种类型
 
@@ -54,124 +60,95 @@ B(t) = (B₀ + α · H) · λ^(t - t_last)
 | \`project\` | 4-6 | 项目上下文、技术决策、进度状态 |
 | \`reference\` | 2-4 | 外部资源指针（URL、文档位置等） |
 
-## 五、球文件格式
+## 五、文件结构
 
-文件路径：\`.memory-pool/balls/ball_XXXX.md\`
-
-\`\`\`yaml
----
-id: ball_0042
-type: feedback
-B0: 8
-H: 3
-t_last: 156
-hardness: 7
-fusion_potential: 0.3
-links:
-  - target: ball_0015
-    strength: strong
-  - target: ball_0038
-    strength: weak
-created_at: "2026-04-03T10:00:00Z"
----
-
-（记忆正文内容）
+\`\`\`
+.memory-pool/
+├── pool.json          # 唯一的元数据文件（全局参数 + 所有球的元数据）
+├── balls/             # 球文件，纯 markdown 内容（无 YAML frontmatter）
+│   ├── ball_0001.md
+│   └── ...
+├── QUICK-REF.md       # 日常操作参考
+└── SPEC.md            # 本文档
 \`\`\`
 
-**字段规则：**
-- \`id\`：与文件名一致，格式 \`ball_XXXX\`（从 \`state.json\` 的 \`next_id\` 获取，创建后自增）
-- \`type\`：必须是 \`user\` / \`feedback\` / \`project\` / \`reference\` 之一
-- \`B0\`：初始浮力，参考上方类型表
-- \`H\`：初始为 0，每次被查询/使用时 +1
-- \`t_last\`：初始为创建时的 \`t\` 值，每次被访问时重置为当前 \`t\`
-- \`hardness\`：0-10，评估语义完整性（拆了就丧失意义的信息硬度高）
-- \`fusion_potential\`：0-1，初始为 0，多次共现检索时累积
-- \`links\`：数组，每项包含 \`target\`（目标球 ID）和 \`strength\`（\`strong\` 或 \`weak\`）
-- \`created_at\`：ISO 8601 时间戳
-
-## 六、state.json 格式
+### 5.1 pool.json 格式
 
 \`\`\`json
 {
+  "version": 2,
   "t": 0,
   "lambda": 0.97,
   "alpha": 1.0,
   "active_capacity": 20,
   "next_id": 1,
   "pool": "project",
-  "initialized_at": "2026-04-03T10:00:00Z"
-}
-\`\`\`
-
-## 七、index.json 格式
-
-AI 每次修改球文件后必须同步更新 index.json。前端读取此文件渲染列表。
-
-\`\`\`json
-{
-  "t": 156,
-  "updated_at": "2026-04-03T12:30:00Z",
+  "initialized_at": "2026-04-03T10:00:00Z",
   "balls": [
     {
-      "id": "ball_0042",
+      "id": "ball_0001",
       "type": "feedback",
-      "summary": "不在代码中添加多余注释",
+      "summary": "不在代码中��加多余注释",
       "B0": 8,
       "H": 3,
       "t_last": 156,
-      "buoyancy": 8.2,
       "hardness": 7,
-      "links": ["ball_0015", "ball_0038"]
+      "permanent": false,
+      "links": ["ball_0015", "ball_0038"],
+      "created_at": "2026-04-03T10:00:00Z"
     }
   ]
 }
 \`\`\`
 
-**\`buoyancy\` 字段**：AI 在更新 index 时用公式计算并写入，前端直接读取显示。
+### 5.2 球文件格式
 
-## 八、操作流程
+文件路径：\`.memory-pool/balls/ball_XXXX.md\`
+
+球���件为纯 markdown，不包含 YAML frontmatter。所有元数据存储在 \`pool.json\` 中。
 
-### 8.1 创建球
+## 六、操作流程
 
-1. 读取 \`state.json\`，获取 \`next_id\` 和当前 \`t\`
-2. 创建 \`balls/ball_XXXX.md\`，填写 frontmatter 和正文
-3. \`state.json\` 的 \`next_id\` += 1
-4. 更新 \`index.json\`：添加新球条目，重新计算所有球的 \`buoyancy\`，按浮力降序排列
+### 6.1 创建球
 
-### 8.2 查询/使用球（命中更新）
+1. 读取 \`pool.json\`，获取 \`next_id\` 和当前 \`t\`
+2. 创建 \`balls/ball_XXXX.md\`，写入纯 markdown 正文
+3. 在 \`pool.json\` 的 \`balls\` 数组中添加新球条目
+4. \`pool.json\` 的 \`next_id\` += 1
+5. 写回 \`pool.json\`
+
+### 6.2 查询/使用球（命中更新）
 
 每次在对话中使用某个球的信息时：
-1. 该球 \`H\` += 1
-2. \`t_last\` = 当前 \`t\`
-3. 更新球文件和 \`index.json\`
+1. 在 \`pool.json\` 中找到该球条目
+2. \`H\` += 1，\`t_last\` = 当前 \`t\`
+3. 写回 \`pool.json\`
 
-### 8.3 维护（衰减、分化、融合）
+### 6.3 维护
 
-**衰减**：不需要显式操作——浮力公式中的 \`λ^(t - t_last)\` 自动完成衰减。每次更新 index.json 时重新计算即可。
+**衰减**：不需要显式操作——浮力公式中的 \`λ^(t - t_last)\` 自动完成衰减，由后端在读取时动态计算。
 
 **分化**（大球拆为多个小球）：
 - 触发条件：活跃层空间不足，且存在体积大的球
-- 判据：易裂度 = (z - x) / (y - x)，其中 x=原球浮力，y=子球最大浮力，z=子球最小浮力
-- 硬度约束：硬度 ≥ 7 的球不拆
-- 操作：删除原球文件，创建多个新球文件，新球之间建立 \`strong\` 连线
+- 硬度约束��硬度 ≥ 7 的球不拆
+- 操作：删除原球文件和元数据，创建多个新球，新球之间建立连线
+
+### 6.4 连线召回
 
-**融合**（多个小球合为一个）：
-- 触发条件：\`fusion_potential\` > 0.7 的多个球
-- 操作：合并源球内容为新球，重新评估 B₀ 和硬度，继承外部连线，删除源球文件
+查询命中活跃层某球时，检查其 \`links\`，拉出关联球（H+=1, t_last 重置）。
 
-### 8.4 连线召回
+### 6.5 轮次自增
 
-查询命中活跃层某球时，检查其 \`links\`：
-- \`strong\` 连线：直接拉出关联球（H+=1, t_last 重置）
-- \`weak\` 连线：仅当该连线已被多次激活时触发
+\`t\` 由系统 hook 自动递增（每条用户消息 +1）。AI 无需手动管理轮次。
 
-### 8.5 轮次自增
+## 七、多容器架构
 
-AI 在对话中应跟踪用户消息数量，在对话结束或执行记忆操作时将增量写入 \`state.json\` 的 \`t\`。
+系统支持两层记忆池：
 
-## 九、多容器架构（预留）
+- **项目池**（\`pool: "project"\`）：位于项目目录下 \`.memory-pool/\`，\`lambda: 0.97\`，记录项目内的局部经验
+- **全局池**（\`pool: "global"\`）：位于 \`~/.ccweb/memory-pool/\`，\`lambda: 0.99\`，汇总所有项目的通用经验
 
-当前为项目级记忆池（\`pool: "project"\`）。未来可扩展全局池（\`~/.ccweb/memory-pool/\`，\`pool: "global"\`，\`lambda: 0.99\`）。球文件格式和操作流程保持一致。
+全局池的 \`t\` 按日历天数递增，通用性记忆自然上浮。项目池初始化/更新时自动注册到全局池。
 `;
 }
 function generateQuickRefMd() {
@@ -181,31 +158,26 @@ function generateQuickRefMd() {
 
 ## 创建球
 
-\`\`\`bash
-# 1. 读取 state.json 获取 next_id 和 t
-# 2. 创建文件
-\`\`\`
+1. 读取 \`pool.json\`，获取 \`next_id\` 和 \`t\`
+2. 创建 \`balls/ball_XXXX.md\`（纯 markdown，无 frontmatter）
+3. 在 \`pool.json\` 的 \`balls\` 数组中添加条目：
 
-\`\`\`yaml
----
-id: ball_{next_id 补零到4位}
-type: feedback | user | project | reference
-B0: {参考下方}
-H: 0
-t_last: {当前 t}
-hardness: {0-10}
-fusion_potential: 0
-links: []
-created_at: "{ISO时间}"
----
-
-{记忆正文}
+\`\`\`json
+{
+  "id": "ball_XXXX",
+  "type": "feedback",
+  "summary": "简短摘要",
+  "B0": 8,
+  "H": 0,
+  "t_last": 当前t,
+  "hardness": 7,
+  "permanent": false,
+  "links": [],
+  "created_at": "ISO时间"
+}
 \`\`\`
 
-\`\`\`
-# 3. state.json next_id += 1
-# 4. 更新 index.json（重算所有 buoyancy，降序排列）
-\`\`\`
+4. \`next_id\` += 1，写回 \`pool.json\`
 
 **B₀ 参考**：feedback=8-10 | user=5-7 | project=4-6 | reference=2-4
 
@@ -215,51 +187,44 @@ created_at: "{ISO时间}"
 B(t) = (B0 + alpha * H) * lambda^(t - t_last)
 \`\`\`
 
-默认参数在 state.json：lambda=0.97, alpha=1.0
+默认参数在 pool.json：lambda=0.97, alpha=1.0
+永久球（permanent=true）不乘衰减项。
+buoyancy 由后端动态计算，不存储在文件中。
 
 ## 命中更新
 
-使用某球信息时：H += 1, t_last = 当前 t，更新球文件 + index.json
+使用某球信息时：在 pool.json 中找到该球，H += 1, t_last = 当前 t，写回 pool.json
 
 ## 维护流程
 
-1. 读取 state.json 和所有球文件
-2. 对每个球计算当前 buoyancy
-3. 按 buoyancy 降序排列
-4. 前 active_capacity 个为活跃层，其余为深层
-5. 检查是否需要分化（活跃层满 + 大球 + 硬度 < 7）
-6. 检查是否需要融合（fusion_potential > 0.7 的共现球组）
-7. 写回所有修改的球文件 + index.json
+1. 读取 pool.json
+2. 浮力由后端动态计算，无需手动重算
+3. 检查是否需要分化（活跃层满 + 大球 + 硬度 < 7）
+4. 写回 pool.json
 
 ## 轮次管理
 
-每条用户消息 = 1 轮。对话中跟踪消息数，操作记忆时将增量写入 state.json 的 t。
+\`t\` 由系统 hook 自动递增，AI 无需手动管理。
 
-## index.json 更新
+## pool.json 更新
 
-**每次修改球文件后必须更新 index.json**。每个球条目：
-
-\`\`\`json
-{ "id", "type", "summary"(正文首行或摘要), "B0", "H", "t_last", "buoyancy"(计算值), "hardness", "links"(ID数组) }
-\`\`\`
+每次修改球信息后写回 pool.json。只需操作这一个文件（+ 球的 markdown 文件）。
 `;
 }
 function generateClaudeMdBlock() {
-    return `
-## 记忆池（Memory Pool）
+    return `## 记忆池（Memory Pool）
 
 本项目已启用记忆池系统。
 
 **每次对话开始时：**
 1. 读取 \`.memory-pool/QUICK-REF.md\` 了解操作规范
-2. 读取 \`.memory-pool/state.json\` 获取当前轮次
-3. 读取 \`.memory-pool/index.json\` 加载活跃层记忆
-4. 将活跃层记忆纳入当前对话上下文
+2. 读取 \`.memory-pool/pool.json\` 加载全局参数和活跃层记忆
+3. 将活跃层记忆纳入当前对话上下文
 
 **对话过程中：**
 - 遇到重要信息时主动提议存入记忆池
 - 用户要求记忆操作时参照 QUICK-REF.md 执行
-- 每次操作后更新 index.json
+- 每次操作后更新 pool.json
 
 **完整规范：** \`.memory-pool/SPEC.md\`
 `;

package/backend/dist/memory-pool/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/memory-pool/templates.ts"],"names":[],"mappings":";AAAA,uCAAuC;;AAEvC,wCAyKC;AAED,gDAqEC;AAED,sDAmBC;AArQD,SAAgB,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuKR,CAAC;AACF,CAAC;AAED,SAAgB,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmER,CAAC;AACF,CAAC;AAED,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;CAiBR,CAAC;AACF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/memory-pool/templates.ts"],"names":[],"mappings":";AAAA,uCAAuC;;AAEvC,wCAkJC;AAED,gDA2DC;AAED,sDAiBC;AAlOD,SAAgB,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgJR,CAAC;AACF,CAAC;AAED,SAAgB,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDR,CAAC;AACF,CAAC;AAED,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;CAeR,CAAC;AACF,CAAC"}

package/backend/dist/memory-pool/types.d.ts

@@ -0,0 +1,65 @@
+export interface GlobalBallOrigin {
+    source_project: string;
+    source_ball_id: string;
+    synced_at: string;
+}
+export interface PoolBallMeta {
+    id: string;
+    type: 'user' | 'feedback' | 'project' | 'reference';
+    summary: string;
+    B0: number;
+    H: number;
+    t_last: number;
+    hardness: number;
+    permanent: boolean;
+    links: string[];
+    created_at: string;
+    origins?: GlobalBallOrigin[];
+    orphaned?: boolean;
+    pre_orphan_B0?: number;
+    global_ball_id?: string;
+}
+export interface PoolJson {
+    version: number;
+    t: number;
+    lambda: number;
+    alpha: number;
+    active_capacity: number;
+    next_id: number;
+    pool: string;
+    initialized_at: string;
+    balls: PoolBallMeta[];
+    global_pool_path?: string;
+}
+export interface PoolBallWithBuoyancy extends PoolBallMeta {
+    buoyancy: number;
+}
+export interface SourceEntry {
+    project_id: string;
+    project_name: string;
+    pool_path: string;
+    registered_at: string;
+    last_synced_at: string | null;
+    status: 'active' | 'unreachable';
+    unreachable_count?: number;
+}
+export interface SourcesJson {
+    version: number;
+    sources: SourceEntry[];
+}
+export interface SyncResult {
+    added: number;
+    updated: number;
+    skipped: number;
+    orphaned: number;
+    unreachable_projects: string[];
+    synced_projects: string[];
+}
+export interface ImportPreviewBall {
+    global_ball_id: string;
+    type: string;
+    summary: string;
+    buoyancy: number;
+    origins_count: number;
+}
+//# sourceMappingURL=types.d.ts.map