mocode-ai 0.6.9 → 0.6.10

package/dist/project-skill/index.js

@@ -38,24 +38,12 @@ export function readProjectSkill() {
         return null;
     }
 }
-/** 内容硬上限(字符数)。超限拒绝写入，防止系统提示词膨胀。从 6000 降至 4000，与快照互补后内容更精简。 */
-const MAX_SKILL_CHARS = 4000;
-/**
- * 写入/更新项目 skill。先备份旧内容再写新内容。
- * 返回 { ok, error? }: ok=false 时 error 说明原因(超限/IO 失败)。
- */
+/** 写入/更新项目 skill。内容不设字符上限；写入前备份旧内容。 */
 export function writeProjectSkill(content) {
     const trimmed = content.trim();
-    if (trimmed.length > MAX_SKILL_CHARS) {
-        return {
-            ok: false,
-            error: `内容超过上限(${trimmed.length}/${MAX_SKILL_CHARS} 字符)。请精简后重试。`,
-        };
-    }
     const p = skillPath();
     const dir = path.dirname(p);
     try {
-        // 备份旧内容(如果有)
         if (existsSync(p)) {
             copyFileSync(p, backupPath());
         }
@@ -67,95 +55,22 @@ export function writeProjectSkill(content) {
         return { ok: false, error: `写入失败: ${e.message}` };
     }
 }
-/**
- * 追加内容到项目 skill 末尾(以 \n\n 分隔)。
- * 同样受 MAX_SKILL_CHARS 限制。
- */
+/** 追加内容到项目 skill 末尾(以 \n\n 分隔)，内容不设字符上限。 */
 export function appendProjectSkill(addition) {
     const existing = readProjectSkill() ?? '';
     const trimmed = addition.trim();
     if (!trimmed)
         return { ok: false, error: '追加内容为空' };
     const separator = existing ? '\n\n' : '';
-    const merged = existing + separator + trimmed;
-    return writeProjectSkill(merged);
+    return writeProjectSkill(existing + separator + trimmed);
 }
-/**
- * 调用 LLM 压缩内容。超限时自动精简，保留关键信息。
- * 返回压缩后的内容，失败返回 null。
- */
-export async function compressContent(content, signal) {
-    try {
-        // 动态导入避免循环依赖
-        const { chat } = await import('../llm/index.js');
-        const messages = [
-            {
-                role: 'system',
-                content: 'You are a technical writer. Compress the following project skill content to fit within ' +
-                    `${MAX_SKILL_CHARS} characters while preserving the most important information. ` +
-                    'Keep concrete examples, paths, and actionable insights. Remove redundancy and verbose explanations. ' +
-                    'Output ONLY the compressed content, no explanations.',
-            },
-            { role: 'user', content },
-        ];
-        const result = await chat(messages, {}, signal);
-        const compressed = result.content?.trim();
-        if (!compressed)
-            return null;
-        return compressed;
-    }
-    catch {
-        return null;
-    }
+/** 兼容旧调用名：字数限制取消后直接写入，不再调用 LLM 压缩。 */
+export async function writeProjectSkillWithCompression(content, _maxAttempts = 3, _signal) {
+    return { ...writeProjectSkill(content), compressed: false };
 }
-/**
- * 写入时自动压缩：超限则调用 LLM 压缩，最多尝试 maxAttempts 次。
- * 返回 { ok, error?, compressed? }，compressed 标记是否经过压缩。
- */
-export async function writeProjectSkillWithCompression(content, maxAttempts = 3, signal) {
-    let current = content;
-    let compressed = false;
-    for (let attempt = 0; attempt < maxAttempts; attempt++) {
-        const result = writeProjectSkill(current);
-        if (result.ok) {
-            return { ok: true, compressed };
-        }
-        // 非超限错误直接返回
-        if (!result.error?.includes('内容超过上限')) {
-            return result;
-        }
-        // 超限时调用 LLM 压缩
-        const compressedContent = await compressContent(current, signal);
-        if (!compressedContent) {
-            return {
-                ok: false,
-                error: `压缩失败: ${result.error}`,
-            };
-        }
-        current = compressedContent;
-        compressed = true;
-    }
-    // 多次压缩后仍超限
-    const finalCheck = writeProjectSkill(current);
-    if (finalCheck.ok) {
-        return { ok: true, compressed: true };
-    }
-    return {
-        ok: false,
-        error: `经过 ${maxAttempts} 次压缩仍超限: ${finalCheck.error}`,
-    };
-}
-/**
- * 追加时自动压缩：合并后超限则调用 LLM 压缩，最多尝试 maxAttempts 次。
- */
-export async function appendProjectSkillWithCompression(addition, maxAttempts = 3, signal) {
-    const existing = readProjectSkill() ?? '';
-    const trimmed = addition.trim();
-    if (!trimmed)
-        return { ok: false, error: '追加内容为空' };
-    const separator = existing ? '\n\n' : '';
-    const merged = existing + separator + trimmed;
-    return writeProjectSkillWithCompression(merged, maxAttempts, signal);
+/** 兼容旧调用名：字数限制取消后直接追加，不再调用 LLM 压缩。 */
+export async function appendProjectSkillWithCompression(addition, _maxAttempts = 3, _signal) {
+    return { ...appendProjectSkill(addition), compressed: false };
 }
 /**
  * 生成系统提示词注入段。

package/dist/project-snapshot/llm-snapshot.js

@@ -19,9 +19,9 @@ Do NOT explain WHY or HOW (that's Project Skill's job).
 5. Identify tech stack from dependencies
 
 ## Output Format
-Output a markdown document between these exact delimiters:
+Output only a markdown document between these exact delimiter lines. The delimiters are not Markdown fences and must each appear on their own line:
 
-\`\`\`snapshot-md
+<snapshot-md>
 # Project Snapshot
 
 ## Description
@@ -49,7 +49,7 @@ src/
   tools/
   ui/
 \`\`\`
-\`\`\`snapshot-md
+</snapshot-md>
 
 ## Rules
 1. **Description**: ≤80字，中文，从 README 和 package.json description 提炼。不要"一个..."开头。
@@ -60,7 +60,36 @@ src/
 6. 不要包含：设计决策、注意事项、坑点、约定 → 这些是 Skill 的职责。
 7. 总 markdown ≤ 2500 字符。
 8. 使用中文。
+9. 不要在 <snapshot-md> 和 </snapshot-md> 之外输出任何内容。
 `;
+/**
+ * 提取子 agent 输出中的 markdown。
+ * 优先使用无歧义标签，同时兼容历史自定义围栏和标准 Markdown 围栏。
+ */
+function extractSnapshotMarkdown(summary) {
+    const tagged = summary.match(/<snapshot-md>[ \t]*\r?\n?([\s\S]*?)\r?\n?[ \t]*<\/snapshot-md>/i);
+    if (tagged?.[1]?.trim())
+        return tagged[1].trim();
+    const legacy = summary.match(/```snapshot-md[ \t]*\r?\n([\s\S]*?)\r?\n```snapshot-md[ \t]*(?:\r?\n|$)/i);
+    if (legacy?.[1]?.trim())
+        return legacy[1].trim();
+    const opening = summary.match(/^```(?:snapshot-md|markdown)[ \t]*\r?$/im);
+    if (opening?.index === undefined)
+        return undefined;
+    let bodyStart = opening.index + opening[0].length;
+    if (summary[bodyStart] === '\n')
+        bodyStart += 1;
+    const body = summary.slice(bodyStart);
+    const closings = [...body.matchAll(/^`{3,}[ \t]*\r?$/gm)];
+    const closing = closings.at(-1);
+    if (closing?.index === undefined)
+        return undefined;
+    let content = body.slice(0, closing.index).trim();
+    // 有些模型会把内层和外层的结束围栏连成六个反引号。
+    if (closing[0].trim().length >= 6)
+        content = `${content}\n\`\`\``;
+    return content || undefined;
+}
 /**
  * 生成 LLM 快照（markdown 格式）
  * @param root 项目根目录
@@ -101,21 +130,15 @@ export async function generateLLMSnapshot(root, signal) {
                 transcript: result.transcript,
             };
         }
-        // 从 summary 中提取 markdown
-        const mdMatch = result.summary.match(/```snapshot-md\n([\s\S]*?)\n```snapshot-md/);
-        if (!mdMatch || !mdMatch[1]) {
-            // fallback: 尝试普通 markdown 代码块
-            const fallbackMatch = result.summary.match(/```markdown\n([\s\S]*?)\n```/);
-            if (!fallbackMatch || !fallbackMatch[1]) {
-                return {
-                    ok: false,
-                    error: '无法从子 agent 输出中提取 markdown',
-                    transcript: result.transcript,
-                };
-            }
-            return { ok: true, content: fallbackMatch[1].trim(), transcript: result.transcript };
+        const content = extractSnapshotMarkdown(result.summary);
+        if (!content) {
+            return {
+                ok: false,
+                error: '无法从子 agent 输出中提取 markdown',
+                transcript: result.transcript,
+            };
         }
-        return { ok: true, content: mdMatch[1].trim(), transcript: result.transcript };
+        return { ok: true, content, transcript: result.transcript };
     }
     catch (e) {
         return {

package/dist/repl/index.js

@@ -1011,9 +1011,12 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
         const cmd = line.split(/\s+/)[0];
         // 语言命令把视觉分隔放在确认文案之后；避免回显后先空一行、下一条命令却紧贴确认。
         echoInput(input, cmd !== '/language');
-        const { status, placeholder } = runningStateFor(cmd);
+        const state = runningStateFor(cmd);
+        const placeholder = line === '/snapshot_refresh' || line === '/project_skill init'
+            ? ''
+            : state.placeholder;
         refreshStatusBase(history);
-        layout.enterRunningMode(status, placeholder);
+        layout.enterRunningMode(state.status, placeholder);
         if (line === '/help') {
             layout.contentWrite(`${ui.bold}${t('help.title')}${ui.reset}\n`);
             layout.contentWrite(`${ui.dim}${t('help.hint')}${ui.reset}\n`);
@@ -1311,10 +1314,11 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
             }
             // buildSnapshot 是异步操作(完全由 LLM 生成)，显示进度提示
             layout.contentWrite(`${ui.dim}正在重新生成项目快照 (LLM 分析中)...${ui.reset}\n`);
+            const signal = startRunningListener('');
             try {
                 // 清除缓存，强制重新生成
                 clearSnapshotCache();
-                const result = await buildSnapshot(undefined, true);
+                const result = await buildSnapshot(signal, true);
                 if (result.snapshot) {
                     layout.contentWrite(`${ui.cyan}✓ 项目快照已刷新${ui.reset} (${result.snapshot.builtAt})\n`);
                     layout.contentWrite(`${ui.dim}已生成 markdown 快照，注入到系统提示词中${ui.reset}\n`);
@@ -1336,6 +1340,9 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                 const msg = e instanceof Error ? e.message : String(e);
                 layout.contentWrite(`${ui.red}[错误]${ui.reset} 刷新快照失败: ${msg}\n`);
             }
+            finally {
+                stopRunningListener();
+            }
             continue;
         }
         if (line === '/sessions') {
@@ -1903,48 +1910,29 @@ export async function startRepl(initialHistory, sessionId, updateNotice = null,
                     }
                     continue;
                 }
-                // /project_skill init — 扫描项目并生成/优化 skill
+                // /project_skill init — 作为一条普通主 Agent 请求生成/优化 skill，不再派生高消耗子 agent。
                 if (arg === 'init') {
                     if (!isProjectSkillEnabled()) {
                         layout.contentWrite(`${ui.yellow}⚠ 项目专属 Skill 尚未开启${ui.reset}，请先运行 ${ui.cyan}/project_skill on${ui.reset}\n`);
                         continue;
                     }
-                    const { readProjectSkill, writeProjectSkill } = await import('../project-skill/index.js');
-                    const existing = readProjectSkill();
-                    if (existing) {
-                        layout.contentWrite(`${ui.cyan}⏳ 正在深度探索项目并优化现有 skill...${ui.reset}\n`);
-                    }
-                    else {
-                        layout.contentWrite(`${ui.cyan}⏳ 正在深度探索项目（子 agent 将使用工具扫描代码、架构、配置等）...${ui.reset}\n`);
-                    }
-                    layout.contentWrite(`${ui.dim}提示: 按 Ctrl+C 可中断${ui.reset}\n\n`);
-                    // 派生子 agent 深度探索项目
-                    const { generateInitialSkill } = await import('../project-skill/initializer.js');
-                    const result = await generateInitialSkill(existing ?? undefined, currentAbort?.signal);
-                    // 显示探索过程日志
-                    if (result.transcript) {
-                        layout.contentWrite(`${ui.dim}--- 探索过程 ---${ui.reset}\n`);
-                        layout.contentWrite(result.transcript);
-                        layout.contentWrite(`${ui.dim}--- 探索结束 ---${ui.reset}\n\n`);
-                    }
-                    if (result.ok && result.content) {
-                        const writeResult = writeProjectSkill(result.content);
-                        if (writeResult.ok) {
-                            layout.contentWrite(`${ui.green}✓ 项目 Skill 已生成${ui.reset}\n`);
-                            layout.contentWrite(`${ui.dim}内容预览:${ui.reset}\n${result.content.slice(0, 500)}${result.content.length > 500 ? '...' : ''}\n`);
-                            layout.contentWrite(`\n${ui.dim}文件: ${ui.accent}.mocode/project-skill.md${ui.reset} (${result.content.length} 字符)\n`);
-                            layout.contentWrite(`${ui.dim}下次启动时会自动注入到系统提示词。Agent 也会在开发过程中持续更新。${ui.reset}\n`);
-                            layout.contentWrite(`${ui.dim}提示: 可用 ${ui.cyan}/project_skill view${ui.reset} 查看完整内容，或手动编辑文件完善。${ui.dim}${ui.reset}\n`);
-                        }
-                        else {
-                            layout.contentWrite(`${ui.red}✗ 写入失败:${ui.reset} ${writeResult.error}\n`);
-                        }
+                    const initPrompt = `请直接初始化或优化当前项目的 Project Skill，并完成写入。
+
+要求：
+1. 直接由你完成，禁止调用 task 工具或派生任何子 agent。
+2. 优先利用系统提示中已有的 Project Snapshot 和 Project Skill；不要重复扫描其中已有的目录、依赖、命令和模块清单。
+3. 最多进行 1 次 codegraph 探索；只有缺少关键依据时，才额外进行少量定点 read_file/grep。禁止全仓 glob 和逐文件扫描。
+4. Skill 只记录 Snapshot 无法提供的 WHY/HOW/GOTCHAS/CONVENTIONS：设计取舍、关键调用链、非直觉边界、项目约定和可操作坑点。使用具体路径和例子，删除重复或过时内容。
+5. 最终内容应完整、结构清晰。调用 project_skill_update，使用 action=write 一次性写入完整内容。
+6. 写入成功后只简短说明更新了哪些关键洞察，不要输出完整 Skill。`;
+                    const previousMode = getAgentMode();
+                    try {
+                        await runTurn(initPrompt, false, '');
                     }
-                    else {
-                        layout.contentWrite(`${ui.red}✗ 探索失败:${ui.reset} ${result.error}\n`);
-                        if (result.transcript) {
-                            layout.contentWrite(`${ui.dim}子 agent 输出了部分内容（见上方），但未能生成完整的 skill 文档。${ui.reset}\n`);
-                        }
+                    finally {
+                        // init 是一次明确写操作，临时使用 auto；完成后恢复用户原来的模式。
+                        if (previousMode === 'plan')
+                            setAgentMode('plan');
                     }
                     continue;
                 }

package/dist/tools/builtins/project-skill-update.js

@@ -38,13 +38,11 @@ export const projectSkillUpdateTool = {
         '**何时更新**：发现新架构模式、踩坑后总结、学到新约定、完成重要重构、用户纠正理解时。\n' +
         '\n' +
         '**注意事项**：\n' +
-        '- 保持精简，硬上限 4000 字符（约 1000 token）\n' +
+        '- 内容长度不设硬上限，按项目实际复杂度完整记录有价值的信息\n' +
         '- 写可操作的内容，避免空泛描述\n' +
         '- 用具体路径和例子（不要写"有多个模块"，要写"src/agent 负责 agent 循环"）\n' +
-        '- 定期整理，删除过时信息\n' +
-        '- 更新前建议先 `read` 看一下现有内容，避免重复\n' +
-        '\n' +
-        '**自动压缩**：内容超限时会自动调用 LLM 压缩（最多 3 次），无需手动精简。',
+        '- 定期整理，删除过时和重复信息\n' +
+        '- 更新前建议先 `read` 看一下现有内容，避免重复。',
     risk: 'safe',
     parameters: {
         type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.6.9",
+  "version": "0.6.10",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {