fp-core 0.1.1.dev0__tar.gz → 0.1.3__tar.gz

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fp-core
-Version: 0.1.1.dev0
+Version: 0.1.3
 Summary: 五块卵石 Agent 引擎 - 基于生命周期钩子的插件化 Agent 核心
 Author: zpb
 License-Expression: MIT

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/__init__.py

@@ -1,6 +1,6 @@
 """fp-core - 五块卵石 Agent 引擎"""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __license__ = "MIT"
 __author__ = "zpb"
 

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/commands/__init__.py

@@ -11,6 +11,7 @@ import importlib.util
 import os
 
 from fp_core import display
+from fp_core.platform_utils import get_data_dir
 
 # 缓存：命令名 → 模块对象
 _commands: dict[str, "CommandModule"] = {}
@@ -36,9 +37,8 @@ def _discover_commands():
     builtin_dir = os.path.dirname(os.path.abspath(__file__))
     _scan_dir(builtin_dir, "fp_core.commands")
 
-    # 用户命令目录
-    _xdg_data = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
-    user_dir = os.path.join(_xdg_data, "fp", "commands")
+    # 用户命令目录（跨平台：Linux ~/.local/share/fp/commands, Windows %LOCALAPPDATA%/fp/commands）
+    user_dir = os.path.join(get_data_dir(), "commands")
     _scan_dir(user_dir)  # 直接 import 路径，通过 sys.path 解析
 
 

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/config.py

@@ -8,9 +8,10 @@ import os
 import sys
 from typing import Any
 
-# 用户配置（XDG 标准）
-_XDG_CONFIG_HOME = os.environ.get("XDG_CONFIG_HOME", os.path.join(os.path.expanduser("~"), ".config"))
-USER_CONFIG_PATH = os.path.join(_XDG_CONFIG_HOME, "fp", "config.json")
+from fp_core.platform_utils import get_config_dir, get_data_dir, is_windows
+
+# 用户配置（跨平台：Linux XDG 标准 / Windows %APPDATA%）
+USER_CONFIG_PATH = os.path.join(get_config_dir(), "config.json")
 
 
 def _load_json_config() -> dict:
@@ -147,15 +148,14 @@ MEMORY_MAX_HISTORY: int = _value("MEMORY_MAX_HISTORY", 100)
 
 
 # ═══════════════════════════════════════════════════════════════
-# 路径配置（XDG 标准）
+# 路径配置（跨平台：Linux XDG 标准 / Windows %APPDATA%）
 # ═══════════════════════════════════════════════════════════════
 
-_XDG_DATA_HOME = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
-_XDG_DATA_FP = os.path.join(_XDG_DATA_HOME, "fp")
+_FP_DATA_DIR = get_data_dir()
 
-SESSIONS_DIR = os.path.join(_XDG_DATA_FP, "sessions")
-MEMORY_DIR = os.path.join(_XDG_DATA_FP, "memory")
-TASKS_FILE = os.path.join(_XDG_DATA_FP, "tasks.json")
+SESSIONS_DIR = os.path.join(_FP_DATA_DIR, "sessions")
+MEMORY_DIR = os.path.join(_FP_DATA_DIR, "memory")
+TASKS_FILE = os.path.join(_FP_DATA_DIR, "tasks.json")
 PROMPTS_DIR = os.path.join(os.path.dirname(__file__), "prompts")
 SKILLS_DIR = os.path.join(os.path.dirname(__file__), "skills")
 
@@ -200,7 +200,12 @@ def color_supported() -> bool:
         return True
     if os.environ.get("NO_COLOR"):
         return False
-    import sys
+
+    if is_windows():
+        # Windows 上委托 platform_utils 做更精细的检测
+        from fp_core.platform_utils import ansi_supported
+
+        return ansi_supported()
 
     return sys.stdout.isatty()
 
@@ -301,7 +306,7 @@ def get_default_config() -> dict:
 
 
 def init_config(path: str | None = None):
-    """初始化用户配置文件（写入 ~/.config/fp/config.json）"""
+    """初始化用户配置文件（跨平台：Linux ~/.config/fp/，Windows %APPDATA%/fp/）"""
     config_path = path or USER_CONFIG_PATH
     if os.path.exists(config_path):
         print(f"[Config] {config_path} already exists")

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/core/agent.py

@@ -27,6 +27,7 @@ from fp_core.core.lifecycle import HookContext, LifecycleHook, LifecycleManager
 from fp_core.core.llm_service import LLMConfig, LLMService
 from fp_core.core.prompt_builder import PromptBuilder
 from fp_core.core.tool_executor import ToolExecutor
+from fp_core.platform_utils import get_data_dir
 from fp_core.plugins.base.plugin import PluginRegistry
 
 # ── 上下文 local IO 通道（防并发竞态） ─────────────────
@@ -143,9 +144,8 @@ class Agent:
             plugin_dir=os.path.normpath(_builtin_plugin_dir),
         )
 
-        # 用户插件目录（XDG，同名覆盖）
-        _xdg_data = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
-        _user_plugin_dir = os.path.join(_xdg_data, "fp", "plugins")
+        # 用户插件目录（跨平台，同名覆盖）
+        _user_plugin_dir = os.path.join(get_data_dir(), "plugins")
         if os.path.isdir(_user_plugin_dir):
             self.plugins.scan(_user_plugin_dir)
 

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/core/prompt_builder.py

@@ -11,6 +11,8 @@ import os
 from datetime import datetime
 from typing import Any
 
+from fp_core.platform_utils import check_git_bash, is_windows, platform
+
 
 class PromptBuilder:
     """系统提示词构建器"""
@@ -55,12 +57,21 @@ class PromptBuilder:
         except Exception:
             current_user = "unknown"
 
-        state_info = f"""
-## 当前时间,路径等状态信息
-当前时间: {current_time}
-当前路径: {current_path}
-当前用户: {current_user}
-"""
+        # ── 运行时环境信息 ──
+        runtime_parts = [
+            f"当前时间: {current_time}",
+            f"当前路径: {current_path}",
+            f"当前用户: {current_user}",
+            f"当前平台: {platform()}",
+        ]
+        if is_windows():
+            git_ok, git_msg = check_git_bash()
+            if git_ok:
+                runtime_parts.append("Git Bash: 可用 ✓（写 Unix 命令：ls/grep/awk）")
+            else:
+                runtime_parts.append("Git Bash: 不可用 ✗（使用 cmd.exe 回退，写 Windows 命令：dir/type/findstr）")
+        runtime_info = "\n".join(runtime_parts)
+        state_info = f"\n## 当前时间,路径等状态信息\n{runtime_info}\n"
         parts.append(state_info)
 
         # 长期记忆索引（name + type 摘要，不含正文）

fp_core-0.1.3/src/fp_core/platform_utils.py

@@ -0,0 +1,175 @@
+"""
+platform_utils.py - 跨平台工具集
+
+单一真相源（Single Source of Truth），所有模块都通过此模块获取：
+  - 平台类型（linux / windows / darwin）
+  - 数据目录（XDG_DATA_HOME ~/.local/share <-> %APPDATA%）
+  - 配置目录（XDG_CONFIG_HOME ~/.config <-> %APPDATA%）
+  - Git Bash 定位（Windows 专用）
+"""
+
+import os
+import shutil
+import sys
+
+# ═══════════════════════════════════════════════════════════════
+# 平台检测
+# ═══════════════════════════════════════════════════════════════
+
+
+def platform() -> str:
+    """返回标准平台名：linux / windows / darwin"""
+    if sys.platform == "win32":
+        return "windows"
+    if sys.platform == "darwin":
+        return "darwin"
+    return "linux"
+
+
+def is_windows() -> bool:
+    """是否为 Windows 系统"""
+    return sys.platform == "win32"
+
+
+def is_linux() -> bool:
+    """是否为 Linux 系统"""
+    return sys.platform == "linux"
+
+
+# ═══════════════════════════════════════════════════════════════
+# 路径工具（跨平台 XDG 等价物）
+# ═══════════════════════════════════════════════════════════════
+
+# 参考规范：
+#   Linux:   XDG_CONFIG_HOME (默认 ~/.config)
+#            XDG_DATA_HOME   (默认 ~/.local/share)
+#   Windows: APPDATA         (C:/Users/<user>/AppData/Roaming)
+#            LOCALAPPDATA    (C:/Users/<user>/AppData/Local)
+#   macOS:   ~/Library/Application Support
+
+
+def get_config_dir() -> str:
+    """获取跨平台用户配置目录
+
+    Linux:   $XDG_CONFIG_HOME/fp  ->  ~/.config/fp
+    Windows: %APPDATA%/fp         ->  C:/Users/<user>/AppData/Roaming/fp
+    macOS:   ~/Library/Application Support/fp
+    """
+    if is_windows():
+        base = os.environ.get("APPDATA", os.path.join(os.path.expanduser("~"), "AppData", "Roaming"))
+    elif sys.platform == "darwin":
+        base = os.path.join(os.path.expanduser("~"), "Library", "Application Support")
+    else:
+        base = os.environ.get("XDG_CONFIG_HOME", os.path.join(os.path.expanduser("~"), ".config"))
+    return os.path.join(base, "fp")
+
+
+def get_data_dir() -> str:
+    """获取跨平台用户数据目录
+
+    Linux:   $XDG_DATA_HOME/fp   ->  ~/.local/share/fp
+    Windows: %LOCALAPPDATA%/fp   ->  C:/Users/<user>/AppData/Local/fp
+    macOS:   ~/Library/Application Support/fp
+    """
+    if is_windows():
+        base = os.environ.get("LOCALAPPDATA", os.path.join(os.path.expanduser("~"), "AppData", "Local"))
+    elif sys.platform == "darwin":
+        base = os.path.join(os.path.expanduser("~"), "Library", "Application Support")
+    else:
+        base = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
+    return os.path.join(base, "fp")
+
+
+# ═══════════════════════════════════════════════════════════════
+# Git Bash 定位（Windows）
+# ═══════════════════════════════════════════════════════════════
+
+
+def find_bash() -> str | None:
+    """在 Windows 上找到 Git Bash 的 bash.exe，找不到返回 None
+
+    搜索路径优先级：
+      1. PATH 中的 bash（Git Bash 安装时默认添加）
+      2. 常见安装路径
+      3. Git for Windows SDK 路径
+
+    Linux/macOS 上始终返回 "bash"（系统自带）。
+    """
+    if not is_windows():
+        return "bash"  # Unix 系统直接用系统 bash
+
+    # 1. PATH 中查找
+    resolved = shutil.which("bash")
+    if resolved:
+        return resolved
+
+    # 2. 常见安装路径
+    common_paths = [
+        os.path.join("C:", os.sep, "Program Files", "Git", "bin", "bash.exe"),
+        os.path.join("C:", os.sep, "Program Files (x86)", "Git", "bin", "bash.exe"),
+        os.path.join(os.path.expanduser("~"), "AppData", "Local", "Programs", "Git", "bin", "bash.exe"),
+        # MSYS2
+        os.path.join("C:", os.sep, "msys64", "usr", "bin", "bash.exe"),
+        os.path.join("C:", os.sep, "msys32", "usr", "bin", "bash.exe"),
+    ]
+    for path in common_paths:
+        if os.path.isfile(path):
+            return path
+
+    return None
+
+
+def check_git_bash() -> tuple[bool, str]:
+    """检查 Git Bash 是否可用（Windows 专用），返回 (可用?, 消息)
+
+    Linux/macOS 上始终返回 (True, "系统自带 bash")。
+    """
+    if not is_windows():
+        return True, "系统自带 bash"
+
+    bash_path = find_bash()
+    if bash_path:
+        return True, f"已找到 Git Bash: {bash_path}"
+    return False, "未找到 Git Bash。请安装 Git for Windows (https://git-scm.com) 并确保将 Git Bash 添加到 PATH"
+
+
+# ═══════════════════════════════════════════════════════════════
+# ANSI 颜色支持检测
+# ═══════════════════════════════════════════════════════════════
+
+
+def ansi_supported() -> bool:
+    """检测终端是否支持 ANSI 转义码
+
+    Linux/macOS:  始终 True（终端原生支持）
+    Windows:      Windows 10+ 的 Windows Terminal / VS Code 集成终端 支持；
+                  cmd.exe 仅在 10+ 版本 + ENABLE_VIRTUAL_TERMINAL_PROCESSING 启用时支持
+    """
+    # 强制开关优先
+    if os.environ.get("FORCE_COLOR"):
+        return True
+    if os.environ.get("NO_COLOR"):
+        return False
+
+    # 非交互式终端不支持
+    if not sys.stdout.isatty():
+        return False
+
+    if is_windows():
+        # Windows 10 build 14393+ 通过虚拟终端处理支持 ANSI
+        # 但我们保守检测：如果在 Windows Terminal 或 VS Code 终端中，返回 True
+        term = os.environ.get("TERM_PROGRAM", "").lower()
+        if term in ("vscode", "microsoft-terminal", "windows-terminal"):
+            return True
+        # 检查 ConEmu / Cmder
+        if os.environ.get("CONEMUANSI") == "ON":
+            return True
+        # 兜底：使用 colorama 的 stream 检测
+        try:
+            import colorama.ansitowin32  # type: ignore[import-untyped]
+
+            return colorama.ansitowin32.is_ansi_enabled()
+        except ImportError:
+            return False
+
+    return True

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/prompts/agent.md

@@ -45,3 +45,16 @@
 - 开始执行任务时，请用 task_update 将状态改为 in_progress
 - 任务完成后，请用 task_update 将状态改为 completed
 - 在回复中引用任务时带上 #ID 方便用户追踪
+
+【跨平台兼容】
+- 我同时支持 Linux 和 Windows。
+- **bash 工具**：
+  - Linux/macOS：直接由系统 shell 执行，写 Unix 命令（`ls`/`grep`/`cat`）
+  - Windows + Git Bash 可用：自动路由到 Git Bash 的 `bash.exe`，写 Unix 命令（`ls`/`grep`/`awk`）
+  - Windows + 无 Git Bash：降级到 `cmd.exe`，**写 Windows 命令**（`dir`/`type`/`findstr`）
+  - 运行时环境信息（平台 + Git Bash 状态）会自动注入到提示词的状态信息区，注意查看。
+- **路径兼容**：配置/会话/记忆等数据目录自动适配——
+  - Linux: `~/.config/fp/` + `~/.local/share/fp/`
+  - Windows: `%APPDATA%/fp/` + `%LOCALAPPDATA%/fp/`
+- **KDE 专属技能**（KDE Connect 通知/壁纸等）仅在 Linux/KDE 桌面环境可用，Windows 上调用会返回不可用提示。
+- **ANSI 颜色**：Windows Terminal / VS Code 终端原生支持；旧版 cmd.exe 可能禁用颜色输出。

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/skills/loader.py

@@ -7,11 +7,12 @@ import os
 import re
 from dataclasses import dataclass, field
 
+from fp_core.platform_utils import get_data_dir
+
 BUILTIN_SKILLS_DIR = os.path.dirname(os.path.abspath(__file__))
 
-# 用户技能目录（XDG 标准，可写，同名技能覆盖内置）
-_XDG_DATA_HOME = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
-USER_SKILLS_DIR = os.path.join(_XDG_DATA_HOME, "fp", "skills")
+# 用户技能目录（跨平台：Linux ~/.local/share/fp/skills, Windows %LOCALAPPDATA%/fp/skills, 同名技能覆盖内置）
+USER_SKILLS_DIR = os.path.join(get_data_dir(), "skills")
 
 # 模板变量：agent 主入口文件路径（用于自修改等技能）
 AGENT_ENTRY = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "cli.py")

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/tools/__init__.py

@@ -18,6 +18,8 @@ import os
 from collections.abc import Callable
 from typing import Any
 
+from fp_core.platform_utils import get_data_dir
+
 
 class ToolRegistry:
     """工具注册表，管理所有核心工具和插件"""
@@ -41,9 +43,8 @@ class ToolRegistry:
         builtin_dir = os.path.join(os.path.dirname(__file__), "plugins")
         self._load_from_dir(builtin_dir, "fp_core.tools.plugins")
 
-        # 用户工具目录
-        _xdg_data = os.environ.get("XDG_DATA_HOME", os.path.join(os.path.expanduser("~"), ".local", "share"))
-        user_dir = os.path.join(_xdg_data, "fp", "tools", "plugins")
+        # 用户工具目录（跨平台：Linux ~/.local/share/fp/tools/plugins, Windows %LOCALAPPDATA%/fp/tools/plugins）
+        user_dir = os.path.join(get_data_dir(), "tools", "plugins")
         self._load_from_dir(user_dir)
 
     def _load_from_dir(self, directory: str, package_prefix: str | None = None):

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/tools/core.py

@@ -2,7 +2,7 @@
 核心工具模块 — 不可插件化的基础工具（全异步版本）
 
 这些工具必须保持直接绑定，作为系统的基础设施：
-- bash: Shell 命令执行（使用 asyncio.create_subprocess_shell）
+- bash: Shell 命令执行（跨平台：Linux 用 bash，Windows 用 Git Bash）
 - read_file: 文件读取
 - write_file: 文件写入
 - edit_file: 精确文本替换
@@ -12,6 +12,8 @@ import asyncio
 import os
 from typing import Any
 
+from fp_core.platform_utils import find_bash, is_windows
+
 # ── 核心工具定义（OpenAI function calling schema） ──────────────────────
 
 CORE_TOOL_DEFINITIONS = [
@@ -19,7 +21,11 @@ CORE_TOOL_DEFINITIONS = [
         "type": "function",
         "function": {
             "name": "bash",
-            "description": "执行一条 shell 命令并获取输出。支持任意 bash 语法，可管道/重定向。超时 300 秒。",
+            "description": (
+                "执行 shell 命令，支持管道/重定向。"
+                "跨平台：Linux 原生执行，Windows 自动路由到 Git Bash 或降级 cmd.exe。"
+                "超时 300 秒。"
+            ),
             "parameters": {
                 "type": "object",
                 "properties": {
@@ -85,16 +91,45 @@ def get_core_definitions() -> list:
 
 
 async def _execute_bash(command: str) -> str:
-    """异步执行 shell 命令"""
+    """异步执行 shell 命令
+
+    跨平台策略：
+      - Linux/macOS:      使用 asyncio.create_subprocess_shell，由系统 shell 执行
+      - Windows + Git Bash: 使用 bash.exe -c，Unix 命令（ls/grep/awk）可用
+      - Windows + 无 Git Bash: 降级到 cmd.exe /c，Windows 命令（dir/type/findstr）可用
+    """
     if not command:
         raise ValueError("bash 工具需要 command 参数")
 
+    # ── 跨平台路由：选择正确的 shell 执行方式 ──
+    cmd_prefix = ""  # 输出前缀，cmd.exe 回退时标记
     try:
-        proc = await asyncio.create_subprocess_shell(
-            command,
-            stdout=asyncio.subprocess.PIPE,
-            stderr=asyncio.subprocess.PIPE,
-        )
+        if is_windows():
+            bash_path = find_bash()
+            if bash_path:
+                # Git Bash 可用 → 走 bash.exe，Unix 命令
+                proc = await asyncio.create_subprocess_exec(
+                    bash_path,
+                    "-c",
+                    command,
+                    stdout=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.PIPE,
+                )
+            else:
+                # Git Bash 不可用 → 降级到 cmd.exe，Windows 命令
+                proc = await asyncio.create_subprocess_shell(
+                    command,
+                    stdout=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.PIPE,
+                )
+                cmd_prefix = "[cmd.exe 回退] "
+        else:
+            # Linux/macOS → 系统 shell
+            proc = await asyncio.create_subprocess_shell(
+                command,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE,
+            )
 
         try:
             stdout, stderr = await asyncio.wait_for(
@@ -106,7 +141,6 @@ async def _execute_bash(command: str) -> str:
             await proc.wait()
             return "错误：命令执行超时（300秒）"
         except (KeyboardInterrupt, asyncio.CancelledError):
-            # 中断时 kill 子进程并重新抛出
             proc.kill()
             await proc.wait()
             raise
@@ -121,6 +155,10 @@ async def _execute_bash(command: str) -> str:
         if len(output) > 10000:
             output = output[:10000] + f"\n...（已截断，原文 {len(output)} 字符）"
 
+        # cmd.exe 回退模式下加前缀告知 LLM
+        if cmd_prefix and output.strip():
+            output = cmd_prefix + output.lstrip()
+
         return output
     except Exception as e:
         return f"错误：{e}"

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/tools/plugins/python_plugin.py

@@ -7,6 +7,7 @@ Python 插件 — 执行 Python 代码（异步版本）
 import asyncio
 import contextlib
 import os
+import sys
 import tempfile
 from typing import Any
 
@@ -63,7 +64,7 @@ async def execute(params: dict[str, Any]) -> str:
 
         # 异步执行
         proc = await asyncio.create_subprocess_exec(
-            "python3",
+            sys.executable,
             tmp_path,
             stdout=asyncio.subprocess.PIPE,
             stderr=asyncio.subprocess.PIPE,

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core/tools/plugins/subagent_plugin.py

@@ -181,7 +181,7 @@ async def execute(params: dict[str, Any]) -> str:
 
     # ═══════════════════════════════════════════════════════════
     # 定位入口 — 通过 python -m fp_cli.main 启动子进程
-    # （不依赖文件系统路径，fp-cli 必须已安装）
+    # （不依赖文件系统路径，fp-terminal 必须已安装）
     # ═══════════════════════════════════════════════════════════
     entry = [sys.executable, "-m", "fp_cli.main", "-m"]
 

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fp-core
-Version: 0.1.1.dev0
+Version: 0.1.3
 Summary: 五块卵石 Agent 引擎 - 基于生命周期钩子的插件化 Agent 核心
 Author: zpb
 License-Expression: MIT

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/src/fp_core.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ pyproject.toml
 src/fp_core/__init__.py
 src/fp_core/config.py
 src/fp_core/display.py
+src/fp_core/platform_utils.py
 src/fp_core.egg-info/PKG-INFO
 src/fp_core.egg-info/SOURCES.txt
 src/fp_core.egg-info/dependency_links.txt

{fp_core-0.1.1.dev0 → fp_core-0.1.3}/tests/test_skills.py

@@ -106,9 +106,9 @@ class TestSkillLoader:
         )
 
         # 创建同名用户技能
-        import fp_core.config as cfg
+        from fp_core.skills.loader import USER_SKILLS_DIR
 
-        user_dir = os.path.join(cfg._XDG_DATA_HOME, "fp", "skills")
+        user_dir = USER_SKILLS_DIR
         os.makedirs(user_dir, exist_ok=True)
         user_file = os.path.join(user_dir, f"{builtin_name}.md")
         with open(user_file, "w", encoding="utf-8") as f: