@szc-ft/mcp-szcd-client 0.11.0 → 0.11.1

package/AGENTS.md

@@ -0,0 +1,9 @@
+# 项目指令
+
+## 语言偏好
+
+始终使用中文（简体）回复用户，包括：
+- 所有对话回复
+- 代码注释说明
+- 错误信息和日志解读
+- 工具调用结果的解释说明

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.11.0",
+    "version": "0.11.1",
     "description": "MCP client for szcd component library - connects to remote MCP server via SSE or stdio proxy",
     "keywords": [
         "mcp",
@@ -32,6 +32,7 @@
         "skill/",
         "agents/",
         "commands/",
+        "AGENTS.md",
         "README.md"
     ],
     "engines": {

package/scripts/lib/qoder.js

@@ -13,15 +13,16 @@
  *
  * Qoder 目录结构：
  *   ~/.qoder/
- *   ├── settings.json        # 权限/Hook/MCP 配置
- *   ├── agents/              # 子代理
+ *   ├── AGENTS.md          # 用户级项目指令（语言偏好等）
+ *   ├── settings.json      # 权限/Hook/MCP 配置
+ *   ├── agents/            # 子代理
  *   │   └── <agentName>.md
- *   ├── skills/              # Skills
+ *   ├── skills/            # Skills
  *   │   └── <skillName>/
  *   │       └── SKILL.md
- *   ├── commands/            # 自定义命令
+ *   ├── commands/          # 自定义命令
  *   │   └── <commandName>.md
- *   └── hooks/               # Hook 脚本
+ *   └── hooks/             # Hook 脚本
  */
 
 import fs from "node:fs";
@@ -64,6 +65,14 @@ function getQoderProjectSettingsPath(projectRoot) {
     return path.join(projectRoot, ".qoder", "settings.json");
 }
 
+function getQoderUserAgentsMdPath() {
+    return path.join(getQoderUserDirectory(), "AGENTS.md");
+}
+
+function getQoderProjectAgentsMdPath(projectRoot) {
+    return path.join(projectRoot, ".qoder", "AGENTS.md");
+}
+
 // ==================== JSON 读写 ====================
 
 function readJsonFile(filePath) {
@@ -274,6 +283,47 @@ function copyCommandsToQoder(deps, isProjectLevel = false) {
     return false;
 }
 
+// ==================== AGENTS.md 复制 ====================
+
+/**
+ * 复制 AGENTS.md 到用户级 ~/.qoder/AGENTS.md
+ * 如果已存在用户自定义内容则跳过（避免覆盖用户修改）
+ */
+function copyAgentsMdToQoder(deps, isProjectLevel = false) {
+    const agentsMdSource = path.join(deps.PACKAGE_ROOT, "AGENTS.md");
+    if (!fs.existsSync(agentsMdSource)) {
+        console.log("⏭️  Skipping AGENTS.md install: source file not found in package");
+        return false;
+    }
+
+    const agentsMdDest = isProjectLevel
+        ? getQoderProjectAgentsMdPath(deps.PROJECT_ROOT)
+        : getQoderUserAgentsMdPath();
+
+    try {
+        // 如果目标已存在，检查内容是否相同
+        if (fs.existsSync(agentsMdDest)) {
+            const existingContent = fs.readFileSync(agentsMdDest, "utf8").trim();
+            const sourceContent = fs.readFileSync(agentsMdSource, "utf8").trim();
+            if (existingContent === sourceContent) {
+                console.log(`✓ Qoder ${isProjectLevel ? "project" : "user"} AGENTS.md already up-to-date: ${agentsMdDest}`);
+                return true;
+            }
+            // 用户已自定义，不覆盖
+            console.log(`⏭️  Skipping Qoder AGENTS.md (${isProjectLevel ? "project" : "user"}): already exists with custom content`);
+            return false;
+        }
+
+        deps.ensureDirectory(path.dirname(agentsMdDest));
+        deps.copyFile(agentsMdSource, agentsMdDest);
+        console.log(`✓ Copied AGENTS.md to Qoder ${isProjectLevel ? "project" : "user"} directory: ${agentsMdDest}`);
+        return true;
+    } catch (error) {
+        console.log(`⚠️  Failed to copy AGENTS.md to Qoder ${isProjectLevel ? "project" : "user"} directory: ${error.message}`);
+        return false;
+    }
+}
+
 // ==================== 项目级配置 ====================
 
 function setupQoderProjectConfig(deps) {
@@ -401,6 +451,7 @@ export function setupQoder(deps) {
     copySkillToQoder(deps, false);
     copyAgentsToQoder(deps, false);
     copyCommandsToQoder(deps, false);
+    copyAgentsMdToQoder(deps, false);
 
     // ---- 项目级安装（暂不启用，用户级足够） ----
     // let qoderProjectInstalled = false;