deepccc 0.1.7 → 0.1.8

package/dist/context.d.ts

@@ -46,6 +46,11 @@ export declare function newBuiltinSessionId(now?: Date, suffix?: string): string
 export declare function getBuiltinContextSession(sessionId: string, contextDir?: string): BuiltinContextSessionInfo | null;
 export declare function listBuiltinContextSessions(contextDir?: string): BuiltinContextSessionInfo[];
 export declare function latestBuiltinSessionForCwd(cwd: string, contextDir?: string): BuiltinContextSessionInfo | null;
+/**
+ * 估算上下文的 token 数（用于决定何时压缩）。
+ * 按字符类型加权，比旧版 chars/3 更接近真实：CJK 字符 ≈ 1 token/字，
+ * 其他字符 ≈ 3.5 chars/token。避免中文长上下文被严重低估导致压缩过晚。
+ */
 export declare function estimateBuiltinContextTokens(summary: string, messages: readonly BuiltinContextMessage[]): number;
 export declare function serializeMessagesForSummary(messages: readonly BuiltinContextMessage[]): string;
 export declare function buildSummaryPrompt(plan: BuiltinCompactionPlan): string;

package/dist/context.js

@@ -121,9 +121,20 @@ export function latestBuiltinSessionForCwd(cwd, contextDir = DEFAULT_BUILTIN_CON
     const legacySessionId = defaultBuiltinSessionId(cwd);
     return listBuiltinContextSessions(contextDir).find((session) => session.cwd === cwd || session.sessionId === legacySessionId) ?? null;
 }
+/**
+ * 估算上下文的 token 数（用于决定何时压缩）。
+ * 按字符类型加权，比旧版 chars/3 更接近真实：CJK 字符 ≈ 1 token/字，
+ * 其他字符 ≈ 3.5 chars/token。避免中文长上下文被严重低估导致压缩过晚。
+ */
 export function estimateBuiltinContextTokens(summary, messages) {
-    const chars = summary.length + messages.reduce((sum, m) => sum + m.role.length + m.content.length, 0);
-    return Math.ceil(chars / 3);
+    const text = summary + messages.reduce((sum, m) => sum + `${m.role}\n${m.content}\n`, "");
+    let cjk = 0;
+    for (const ch of text) {
+        if (/[\u3400-\u4DBF\u4E00-\u9FFF\uF900-\uFAFF\u3000-\u303F\uFF00-\uFFEF]/.test(ch))
+            cjk++;
+    }
+    const other = text.length - cjk;
+    return Math.ceil(cjk + other / 3.5);
 }
 export function serializeMessagesForSummary(messages) {
     return messages

package/dist/file-tools.d.ts

@@ -132,6 +132,12 @@ export interface ApplyPatchFileChange {
 export interface ApplyPatchOutput {
     changedFiles: ApplyPatchFileChange[];
 }
+/**
+ * 把 `~` / `~/x`（含反斜杠 `~\\x`）展开为用户主目录绝对路径。
+ * `~user/x` 形式不展开（Node 无内置支持），保持原样交给后续解析。
+ * 供路径工具共用：技能索引里 `~/...` 路径可直接传给 read_file 等工具。
+ */
+export declare function expandHomePath(value: string): string;
 export declare function readFileForTool(cwd: string, input: ReadFileInput): Promise<ReadFileOutput>;
 export declare function listDirForTool(cwd: string, input?: ListDirInput): Promise<ListDirOutput>;
 export declare function searchCodeForTool(cwd: string, input: SearchCodeInput, signal?: AbortSignal, runtimeOptions?: SearchCodeRuntimeOptions): Promise<SearchCodeOutput>;

package/dist/file-tools.js

@@ -3,7 +3,8 @@ import { createHash, randomBytes } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { copyFile, mkdir, open, readFile, readdir, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
-import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createInterface } from "node:readline";
 import { jsonSchema, tool } from "ai";
 import { isDangerousCommand } from "./permissions.js";
@@ -22,11 +23,25 @@ const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;
 const MAX_COMMAND_TIMEOUT_MS = 900_000;
 const requireFromHere = createRequire(import.meta.url);
 const FALLBACK_SKIPPED_DIRECTORIES = new Set([".git", "node_modules"]);
+/**
+ * 把 `~` / `~/x`（含反斜杠 `~\\x`）展开为用户主目录绝对路径。
+ * `~user/x` 形式不展开（Node 无内置支持），保持原样交给后续解析。
+ * 供路径工具共用：技能索引里 `~/...` 路径可直接传给 read_file 等工具。
+ */
+export function expandHomePath(value) {
+    if (value === "~")
+        return homedir();
+    if (value.startsWith("~/") || value.startsWith("~\\")) {
+        return join(homedir(), value.slice(2));
+    }
+    return value;
+}
 function resolveToolPath(cwd, value) {
     const raw = value?.trim();
     if (!raw)
         return resolve(cwd);
-    return isAbsolute(raw) ? resolve(raw) : resolve(cwd, raw);
+    const expanded = expandHomePath(raw);
+    return isAbsolute(expanded) ? resolve(expanded) : resolve(cwd, expanded);
 }
 function toPositiveInt(value) {
     if (value === undefined)

package/dist/index.d.ts

@@ -98,7 +98,12 @@ export declare class ChatSession {
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */
     private systemPrompt;
     constructor(overrides?: ChatSessionConfig, options?: ChatSessionOptions);
-    /** 组装系统提示词：固定规则 + 项目指令 + 技能索引 + 用户补充 + 运行时上下文 */
+    /**
+     * 组装系统提示词。顺序遵循“稳定性优先”原则（缓存命中友好）：
+     * 固定规则 → 项目指令 → runtime 上下文 → 用户补充 → 技能索引（最后）。
+     * 技能索引是最易变的部分（热加载，任何 SKILL.md 变化都会改前缀），
+     * 放最后可以让前面的稳定内容尽量命中缓存，只丢尾段。
+     */
     private buildSystemPrompt;
     chat(userMessage: string, signal?: AbortSignal): AsyncIterable<ChatEvent>;
     /** 返回当前的会话历史（只读） */

package/dist/index.js

@@ -123,21 +123,26 @@ export class ChatSession {
         });
         this.permissionGate = new PermissionGate(options.permissionMode ?? "ask", options.permissionResolver);
     }
-    /** 组装系统提示词：固定规则 + 项目指令 + 技能索引 + 用户补充 + 运行时上下文 */
+    /**
+     * 组装系统提示词。顺序遵循“稳定性优先”原则（缓存命中友好）：
+     * 固定规则 → 项目指令 → runtime 上下文 → 用户补充 → 技能索引（最后）。
+     * 技能索引是最易变的部分（热加载，任何 SKILL.md 变化都会改前缀），
+     * 放最后可以让前面的稳定内容尽量命中缓存，只丢尾段。
+     */
     buildSystemPrompt(skills) {
         const systemContent = [SYSTEM_PROMPT];
         const projectInstructions = readProjectInstructionFiles(this.cwd);
         if (projectInstructions) {
             systemContent.push("", projectInstructions);
         }
+        systemContent.push("", buildRuntimeWorkspacePrompt(this.cwd));
+        if (this.customSystemPrompt) {
+            systemContent.push("", this.customSystemPrompt);
+        }
         const skillsPrompt = buildSkillsIndexPrompt(skills);
         if (skillsPrompt) {
             systemContent.push("", skillsPrompt);
         }
-        if (this.customSystemPrompt) {
-            systemContent.push("", this.customSystemPrompt);
-        }
-        systemContent.push("", buildRuntimeWorkspacePrompt(this.cwd));
         return systemContent.join("\n");
     }
     async *chat(userMessage, signal) {
@@ -291,6 +296,8 @@ export class ChatSession {
             system: SUMMARY_SYSTEM_PROMPT,
             messages: [{ role: "user", content: buildSummaryPrompt(plan) }],
             abortSignal: signal,
+            // 温度 0：相同输入尽量产出相同摘要，避免压缩后上下文前缀随机漂移破坏缓存
+            temperature: 0,
         });
         if (!result.text.trim())
             return 0;

package/dist/skills.d.ts

@@ -46,11 +46,18 @@ export declare function scanSkillsDirs(dirs: SkillDirSpec[]): Promise<BuiltinSki
  * 其中 codex 全局包含 ~/.codex/skills（CLI 旧路径）与 ~/.agents/skills（标准全局目录）。
  */
 export declare function buildDefaultSkillDirs(cwd: string): SkillDirSpec[];
+/**
+ * 把技能绝对路径转成 prompt 展示形式：主目录下的路径缩写为 `~/...`（跨机器、
+ * 跨用户稳定，避免用户名/盘符差异导致 system 前缀变化破坏缓存命中）；
+ * 分隔符统一为 `/`。主目录外的路径保持绝对路径（仅统一分隔符）。
+ */
+export declare function normalizeSkillPathForPrompt(skillPath: string): string;
 /**
  * 生成 skill 索引提示词（注入 system prompt）。
  * 索引只含 name + description + 来源 + 路径，并指示模型在任务匹配时
  * 先用 read_file 读取 SKILL.md 全文再执行；同时声明"创建技能"约定
  * （模型在对话中应把新技能创建到 ~/.deepccc/skills 或项目 .deepccc/skills）。
+ * 路径经 normalizeSkillPathForPrompt 缩写，保持跨机器前缀稳定。
  */
 export declare function buildSkillsIndexPrompt(skills: BuiltinSkill[]): string;
 /** 生成 Codex 结构的新技能 SKILL.md 模板（供 CLI skill create / 对话创建约定共用） */

package/dist/skills.js

@@ -113,11 +113,27 @@ export function buildDefaultSkillDirs(cwd) {
         { dir: join(cwd, ".deepccc", "skills"), source: "deepccc", scope: "project" },
     ];
 }
+/**
+ * 把技能绝对路径转成 prompt 展示形式：主目录下的路径缩写为 `~/...`（跨机器、
+ * 跨用户稳定，避免用户名/盘符差异导致 system 前缀变化破坏缓存命中）；
+ * 分隔符统一为 `/`。主目录外的路径保持绝对路径（仅统一分隔符）。
+ */
+export function normalizeSkillPathForPrompt(skillPath) {
+    const home = homedir().replace(/[\\/]+$/, "").replace(/\\/g, "/");
+    const normalized = skillPath.replace(/\\/g, "/");
+    if (normalized === home)
+        return "~";
+    if (normalized.startsWith(home + "/")) {
+        return "~" + normalized.slice(home.length);
+    }
+    return normalized;
+}
 /**
  * 生成 skill 索引提示词（注入 system prompt）。
  * 索引只含 name + description + 来源 + 路径，并指示模型在任务匹配时
  * 先用 read_file 读取 SKILL.md 全文再执行；同时声明"创建技能"约定
  * （模型在对话中应把新技能创建到 ~/.deepccc/skills 或项目 .deepccc/skills）。
+ * 路径经 normalizeSkillPathForPrompt 缩写，保持跨机器前缀稳定。
  */
 export function buildSkillsIndexPrompt(skills) {
     if (skills.length === 0)
@@ -128,7 +144,7 @@ export function buildSkillsIndexPrompt(skills) {
         "On name conflicts: DeepCCC > Codex > Cursor > Claude wins; within one source, project scope wins over global.",
         "When a user request matches a skill's description, first read its full SKILL.md with read_file, then follow the instructions in it exactly.",
         "",
-        ...skills.map((s) => `- **${s.name}** [${s.source}:${s.scope}] (\`${s.skillPath}\`): ${s.description || "(no description)"}`),
+        ...skills.map((s) => `- **${s.name}** [${s.source}:${s.scope}] (\`${normalizeSkillPathForPrompt(s.skillPath)}\`): ${s.description || "(no description)"}`),
         "",
         "## Creating Skills",
         "When the user asks to create a skill, create it as a Codex-style directory skill at",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "A lightweight DeepSeek-optimized coding agent with OpenAI-compatible model support.",
   "license": "Apache-2.0",
   "keywords": [