Version 1.0.3 is expected to be released.

Author: PythonnotJava

CHANGELOG.md

@@ -2,16 +2,18 @@
 
 ## zh
 
-- 提供了在线访问Agent的功能.
-- 优化了上下文压缩.
-- 在工作目录下创建、使用临时技能进行临时性自我进化.
+- 提供了在线访问Agent的功能
+- 优化了上下文压缩
+- 在工作目录下创建、使用临时技能进行临时性自我进化
 - 命令功能，比如说创建全局技能并且自己导入
 
 
 ## en
 
 - Provides online access to the Agent.
 - Optimized context compression.
+- Create and use temporary skills for temporary self-evolution within the working directory.
+- Command functionality, such as creating global skills and importing them automatically.
 
 
 # V1.0.2

README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="snapshots/logos/logo_egg.png" alt="RemindAI Logo" width="128" />
   <h1>🧠 RemindAI</h1>
-  <p><strong>开源桌面 AI 助手 — 不只是对话，而是真正的工具外壳</strong></p>
+  <p><strong>开源桌面 AI 助手 — 不再只是对话</strong></p>
   <p>
     <a href="./README_EN.md">🌐 English</a> |
     <a href="https://github.com/PythonnotJava/RemindAI/releases">📦 下载</a> |
@@ -28,19 +28,51 @@
 
 ## 💡 这是什么
 
-RemindAI 是一个**开源桌面 AI 助手**，核心理念是为大模型提供一层完整的**工具外壳 (ToolShell)**，让 AI 不仅能聊天，还能直接操作文件、执行代码、调用外部工具、管理记忆，成为真正的生产力工具。
+RemindAI 是一个**开源桌面 AI 助手**，核心理念是为大模型提供一层完整的**工具外壳 (ToolShell)**，让 AI 不仅能聊天，还能直接操作文件、执行代码、调用外部工具、管理记忆、自主规划任务——成为真正能「上手」干活的生产力工具。
 
-> 🎯 一句话：**把 AI 从聊天框里释放出来，给它一个操作系统。**
+> 🎯 让 AI 走出对话框，真正「上手」你的工作。
 
 ### 🆚 与普通 AI 客户端的区别
 
 | | 🔵 普通 AI 客户端 | 🟣 RemindAI |
 |---|---|---|
 | 📁 文件操作 | ❌ 不支持或需插件 | ✅ 内置沙盒文件系统 |
-| 💻 代码执行 | ❌ 不支持 | ✅ 内置 Python/Shell 执行器 |
+| 💻 代码执行 | ❌ 不支持 | ✅ 内置 Python/Shell/JS 执行器 |
 | 🧠 记忆 | ❌ 无或仅上下文 | ✅ 向量语义记忆 + SQLite 持久化 |
-| 🔌 工具扩展 | ⚠️ 有限 | ✅ MCP 协议 + 技能系统 + Capability 插件 |
+| 🔌 工具扩展 | ⚠️ 有限 | ✅ MCP 协议 + 四层技能系统 + Capability 插件 |
 | 🤝 多 Agent | ⚠️ 多窗口并排 | ✅ 真协作：指挥部广播、权限隔离、自动路由 |
+| 🌐 对外服务 | ❌ 不支持 | ✅ 内置 HTTP API 服务器，三种端点对外暴露 |
+| 🐱 全局陪伴 | ❌ 无 | ✅ 像素宠物 + TTS 语音 + 商店经济 + 成就系统 |
+
+---
+
+## 🏗️ RemindAI 的 Skill 系统
+
+RemindAI 的 Skill 系统采用**四层架构**，每一层都有独立的存储目录和生命周期，互不干扰：
+
+| 层级 | 名称 | 存储位置 | 生命周期 | 说明 |
+|------|------|----------|----------|------|
+| **L1** | 默认元 Skill | `assets/default_skills/` | 全局，随应用发布 | ToolShell、Schedule、System 三个核心元技能，构成 AI 的基础操作能力：文件读写、命令执行、任务规划、环境探测 |
+| **L2** | 用户全局 Skill | `Skills/` | 全局，用户手动开关 | 用户通过 ZIP 导入或 `/skill-cti` 命令创建，可跨项目复用。格式为 `SKILL.md` + `tools.json` |
+| **L3** | 工作目录临时 Skill | `.toolshell/skills/` | 跟随工作目录，恒定激活 | AI 在指导用户时按需创建，固化当前项目的临时流程，切目录即消失，**绝不污染全局技能库** |
+| **L4** | AI 自生成 Skill 🧪 | （规划中） | 全局，出于安全性暂未实现 | AI 根据长期对话记忆自动总结用户偏好（例如你常请教运筹优化问题，AI 自动沉淀为一个运筹优化专属技能），并自行调用 |
+
+### 设计理念
+
+- **L1 元技能**：相当于 AI 的「操作系统内核」——文件读写、命令执行、环境探测、任务管理，是 ToolShell 的底层基础
+- **L2 全局技能**：用户的「工具箱」——可复用的专业能力，如特定领域代码生成、文档模板、工作流自动化
+- **L3 临时技能**：AI 的「便签纸」——在当前项目中临时固化一段流程，用完即弃，不留痕迹。例如 `memory.json` 中的 ToolShell/Schedule/System 元技能定义，就是通过 L3 机制注入的
+- **L4 自生成技能**（规划中）：AI 的「长期学习」——从多轮对话中提炼用户的领域偏好和工作模式，自动形成个性化技能。**考虑到自动生成代码执行的安全风险，该层暂未实现**
+
+### 技能工作流
+
+| 命令 | 用途 | 去向 |
+|------|------|------|
+| 直接要求创建技能 | 在当前工作目录创建项目级技能 | L3 `.toolshell/skills/`（默认） |
+| `/skill-temp` | 显式创建项目级临时技能 | L3 `.toolshell/skills/` |
+| `/skill-cti` | 创建 → 自测 → 安装为全局技能 | 先在 `.toolshell/_staging/` 搭建自测，通过后装到 L2 `Skills/` |
+
+> 💡 若 RemindAI 的技能系统对您的项目、论文等研究起到启发作用，请协助我改进、链接该项目，这也对我毕业、工作有很大帮助 🙇‍
 
 ---
 
@@ -50,34 +82,37 @@ RemindAI 是一个**开源桌面 AI 助手**，核心理念是为大模型提供
 |---|---|---|
 | AI 对话核心 (LLM + tool calling) | ✅ | AgentLoop 流式循环 + 事件驱动 UI |
 | 三端 LLM 适配 (OpenAI/Anthropic/Gemini) | ✅ | 各自独立客户端，流式+tool_call+多模态 |
-| ToolShell 元技能 | ✅ | 读/写/删/搜索/exec/python + rg/fd/rtk |
+| ToolShell 元技能 | ✅ | 读/写/删/搜索/exec/python/js + rg/fd/rtk |
 | Schedule 元技能 | ✅ | 7 工具 CRUD + 审查 + 归档 |
 | System 元技能 | ✅ | 环境探测 + 环境变量脱敏 |
 | MCP 多传输 | ✅ | stdio / SSE / Streamable HTTP |
 | 向量记忆系统 | ✅ | Qdrant + SQLite 双写 + 自动容灾 |
 | 可插拔 Capability | ✅ | 搜索能力已落地，框架可扩展 |
-| 技能系统 | ✅ | ZIP 导入 / 排序 / 激活 |
+| 四层技能系统 | ✅ | L1 默认元技能 + L2 用户全局 + L3 临时技能，L4 规划中 |
 | 模型 Card 管理 | ✅ | 增删改 + Logo + 拖拽排序 |
 | 多 Agent 协作 | ⚡ | 框架已搭建，执行链路持续完善中 |
 | 领域专家系统 | ✅ | 预设/自定义角色 + 绑定技能 |
 | 对话导出 | ✅ | MD / PDF / Word / HTML |
 | 桌面体验 | ✅ | 托盘 / 通知 / 闪屏 / 主题动画 |
 | 全局宠物 Agent | ✅ | 像素猫 + TTS 语音 + 商店经济 + 成就系统 |
+| 对外 API 服务 | ✅ | 内置 HTTP 服务器，三种端点：OpenAI 聚合 / Claude Agent / Claude 代理 |
+| 在线访问 Agent | ✅ | 通过浏览器远程访问 RemindAI Agent |
+| 上下文压缩 | ✅ | RTK Token 压缩 60-90% + 上下文管理优化 |
 
 ---
 
 ## 🌟 更多特性
 
 | 特性 | 说明 |
 |---|---|
-| 🐚 ToolShell | 文件沙盒 + Python/Shell 执行 + rg/fd/rtk + RTK 压缩 60-90% token |
+| 🐚 ToolShell | 文件沙盒 + Python/Shell/JS 执行 + rg/fd/rtk + RTK 压缩 60-90% token |
 | 🌐 对外 API 服务 | 内置 HTTP 服务器，三种端点：OpenAI 聚合、Claude Agent（运行 RemindAI 自身的 AgentLoop）、Claude 代理（纯透传） |
 | 🔌 MCP 协议 | stdio/SSE/Streamable HTTP 三传输 + 工具自动发现 + 拖拽管理 |
 | 🧠 向量记忆 | Qdrant 语义搜索 + SQLite 持久备份 + 自动运维 + 记忆重建 |
 | 🤝 多 Agent | 指挥部/工作者/审查员角色 + 权限隔离 + 自动路由 |
 | 🎨 多模型 | OpenAI/Anthropic/Gemini 原生适配 + 流式推理链 + 多模态 |
 | 🧩 Capability | 可插拔能力架构，Custom → MCP → ToolShell 三级路由 |
-| 📦 技能系统 | SKILL.md + tools.json 格式，ZIP 一键导入 |
+| 📦 技能系统 | 四层架构 (L1 元技能 / L2 全局 / L3 临时 / L4 自生成规划中)，SKILL.md + tools.json 格式，ZIP 一键导入，支持命令创建 |
 | 🔍 Web 搜索 | Tavily / Brave / 百度智能搜索，会话级开关 |
 | 📋 Schedule | SCHEDULE.md 驱动，P0/P1/P2 优先级，AI 主动回顾 |
 | 👤 领域专家 | 预设/自定义角色 + 独立 system prompt |
@@ -86,6 +121,8 @@ RemindAI 是一个**开源桌面 AI 助手**，核心理念是为大模型提供
 | 🌍 国际化 | 完整中英双语 |
 | 🎨 主题 | Material 3 亮/暗 + 涟漪切换动画 |
 | 🐱 全局宠物 Agent | 像素猫陪伴 + 右键智能问答 + 火山TTS语音 + 商店/背包/投喂 + 成就系统 |
+| 🗜️ 上下文压缩 | RTK 命令输出压缩 + 对话上下文智能裁剪 |
+| 🌐 在线访问 | 浏览器远程访问 Agent，在线会话管理 |
 
 ### 📦 内置 CLI 工具
 

README_EN.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="snapshots/logos/logo_egg.png" alt="RemindAI Logo" width="128" />
   <h1>🧠 RemindAI</h1>
-  <p><strong>Open-source Desktop AI Assistant — Not just chat, a real Tool Shell</strong></p>
+  <p><strong>Open-source Desktop AI Assistant — Beyond just chat</strong></p>
   <p>
     <a href="./README.md">🌐 中文</a> |
     <a href="https://github.com/PythonnotJava/RemindAI/releases">📦 Download</a> |
@@ -28,19 +28,51 @@
 
 ## 💡 What is RemindAI
 
-RemindAI is an **open-source desktop AI assistant** built around a complete **ToolShell** layer that gives LLMs the ability to manipulate files, execute code, call external tools, and manage persistent memory — turning AI into a real productivity tool.
+RemindAI is an **open-source desktop AI assistant** built around a complete **ToolShell** layer that gives LLMs the ability to manipulate files, execute code, call external tools, manage persistent memory, and autonomously plan tasks — turning AI into a productivity tool that can actually *do* things, not just talk about them.
 
-> 🎯 In one line: **Free AI from the chatbox — give it an operating system.**
+> 🎯 Beyond the chatbox — give AI real agency.
 
 ### 🆚 How it differs from typical AI clients
 
 | | 🔵 Typical AI Client | 🟣 RemindAI |
 |---|---|---|
 | 📁 File Ops | ❌ Not supported | ✅ Built-in sandboxed filesystem |
-| 💻 Code Exec | ❌ Not supported | ✅ Built-in Python/Shell executor |
+| 💻 Code Exec | ❌ Not supported | ✅ Built-in Python/Shell/JS executor |
 | 🧠 Memory | ❌ None or context-only | ✅ Vector semantic memory + SQLite |
-| 🔌 Extensions | ⚠️ Limited | ✅ MCP + Skills + Capability plugins |
-| 🤝 Multi-Agent | ⚠️ Side-by-side windows | ✅ Real collaboration with routing |
+| 🔌 Extensions | ⚠️ Limited | ✅ MCP + four-layer Skills + Capability plugins |
+| 🤝 Multi-Agent | ⚠️ Side-by-side windows | ✅ Real collaboration with routing & permission isolation |
+| 🌐 External API | ❌ Not supported | ✅ Built-in HTTP API server with three endpoint types |
+| 🐱 Desktop Companion | ❌ None | ✅ Pixel pet + TTS voice + shop economy + achievements |
+
+---
+
+## 🏗️ RemindAI's Skill System
+
+RemindAI's Skill System uses a **four-layer architecture**, each with independent storage and lifecycle:
+
+| Layer | Name | Storage | Lifecycle | Description |
+|-------|------|---------|-----------|-------------|
+| **L1** | Default Meta-Skills | `assets/default_skills/` | Global, shipped with app | ToolShell, Schedule, System — the three core meta-skills forming AI's fundamental capabilities: file I/O, command execution, task planning, environment probing |
+| **L2** | User Global Skills | `Skills/` | Global, user-toggled | Imported via ZIP or created with `/skill-cti`; reusable across projects. Format: `SKILL.md` + `tools.json` |
+| **L3** | Workspace Temp Skills | `.toolshell/skills/` | Per workspace, always active | AI creates on-demand during guidance; solidifies workflows for the current project; disappears when switching directories — **never pollutes global skills** |
+| **L4** | AI Self-Generated Skills 🧪 | (Planned) | Global, not yet implemented for safety | AI auto-generates skills from long-term conversation memory (e.g., if you frequently consult on operations research, AI distills a dedicated OR skill) and invokes it autonomously |
+
+### Design Philosophy
+
+- **L1 Meta-Skills**: The AI's "OS kernel" — file I/O, command execution, environment probing, task scheduling; the foundation of ToolShell
+- **L2 Global Skills**: Your "toolbox" — reusable expertise for specific domains, code generation, document templates, workflow automation
+- **L3 Temp Skills**: The AI's "sticky notes" — solidify a workflow for the current project, discard cleanly when done. For example, the ToolShell/Schedule/System meta-skill definitions in `memory.json` are injected via the L3 mechanism
+- **L4 Self-Generated** (planned): The AI's "long-term learning" — distill domain preferences and working patterns from conversations into personalized skills. **Deferred due to safety concerns around auto-generated executable code**
+
+### Skill Workflows
+
+| Command | Purpose | Destination |
+|---------|---------|-------------|
+| Direct request to create a skill | Create a project-level skill in current workspace | L3 `.toolshell/skills/` (default) |
+| `/skill-temp` | Explicitly create a project-level temp skill | L3 `.toolshell/skills/` |
+| `/skill-cti` | Create → Self-test → Install as global skill | Built in `.toolshell/_staging/`, installed to L2 `Skills/` after passing tests |
+
+> 💡 If RemindAI's skills system inspires your projects, papers, or other research, please help me improve and link to the project. This would be very helpful for my graduation and future employment. 🙇‍
 
 ---
 
@@ -50,34 +82,37 @@ RemindAI is an **open-source desktop AI assistant** built around a complete **To
 |---|---|---|
 | AI Chat Core (LLM + tool calling) | ✅ | AgentLoop streaming + event-driven UI |
 | Three LLM Protocols (OpenAI/Anthropic/Gemini) | ✅ | Independent clients, streaming+tools+multimodal |
-| ToolShell Meta-Skill | ✅ | read/write/delete/search/exec/python + rg/fd/rtk |
+| ToolShell Meta-Skill | ✅ | read/write/delete/search/exec/python/js + rg/fd/rtk |
 | Schedule Meta-Skill | ✅ | 7 tools CRUD + review + archive |
 | System Meta-Skill | ✅ | Env probe + sanitized env vars |
 | MCP Multi-Transport | ✅ | stdio / SSE / Streamable HTTP |
 | Vector Memory | ✅ | Qdrant + SQLite dual-write + auto failover |
 | Pluggable Capability | ✅ | Search landed, framework extensible |
-| Skills System | ✅ | ZIP import / sort / activate |
+| Four-Layer Skill System | ✅ | L1 default meta + L2 user global + L3 workspace temp, L4 planned |
 | Model Card Management | ✅ | CRUD + logo + drag-sort |
 | Multi-Agent Collaboration | ⚡ | Framework built, execution loop ongoing |
 | Domain Experts | ✅ | Preset/custom roles + skill binding |
 | Conversation Export | ✅ | MD / PDF / Word / HTML |
 | Desktop Experience | ✅ | Tray / notifications / splash / theme animation |
 | Global Pet Agent | ✅ | Pixel cat + TTS voice + shop economy + achievements |
+| External API Server | ✅ | Built-in HTTP server, three endpoints: OpenAI aggregation / Claude Agent / Claude proxy |
+| Online Agent Access | ✅ | Remote access to RemindAI Agent via browser |
+| Context Compression | ✅ | RTK Token compression 60-90% + context management optimization |
 
 ---
 
 ## 🌟 More Features
 
 | Feature | Description |
 |---|---|
-| 🐚 ToolShell | File sandbox + Python/Shell exec + rg/fd/rtk + RTK compression 60-90% token savings |
-| 🌐 API Server | Built-in HTTP server with three endpoints: OpenAI aggregation, Claude Agent (RemindAI's own agent loop), and Claude proxy (pass-through) |
+| 🐚 ToolShell | File sandbox + Python/Shell/JS exec + rg/fd/rtk + RTK compression 60-90% token savings |
+| 🌐 API Server | Built-in HTTP server with three endpoints: OpenAI aggregation, Claude Agent (runs RemindAI's own agent loop), and Claude proxy (pass-through) |
 | 🔌 MCP Protocol | stdio/SSE/Streamable HTTP + auto-discovery + drag-and-drop management |
 | 🧠 Vector Memory | Qdrant semantic search + SQLite backup + auto-ops + index rebuild |
 | 🤝 Multi-Agent | Commander/Worker/Reviewer roles + permission isolation + auto-routing |
 | 🎨 Multi-Model | OpenAI/Anthropic/Gemini native + streaming reasoning chain + multimodal |
 | 🧩 Capability | Pluggable architecture, Custom → MCP → ToolShell three-tier routing |
-| 📦 Skills | SKILL.md + tools.json format, one-click ZIP import |
+| 📦 Skills | Four-layer architecture (L1 meta / L2 global / L3 temp / L4 self-gen planned), SKILL.md + tools.json format, one-click ZIP import, command-based creation |
 | 🔍 Web Search | Tavily / Brave / Baidu AI Search, session-level toggle |
 | 📋 Schedule | SCHEDULE.md driven, P0/P1/P2 priority, AI proactive review |
 | 👤 Domain Experts | Preset/custom roles + dedicated system prompts |
@@ -86,6 +121,8 @@ RemindAI is an **open-source desktop AI assistant** built around a complete **To
 | 🌍 i18n | Full Chinese and English |
 | 🎨 Themes | Material 3 light/dark + ripple transition animation |
 | 🐱 Global Pet Agent | Pixel cat companion + right-click AI Q&A + Volcano TTS + shop/inventory/feeding + achievements |
+| 🗜️ Context Compression | RTK output compression + intelligent conversation context trimming |
+| 🌐 Online Access | Remote browser access to Agent with online session management |
 
 ### 📦 Bundled CLI Tools
 

assets/default_skills/toolshell/SKILL.md

@@ -56,6 +56,21 @@
 - `*.pem` / `*.key` 私钥文件
 - 项目根目录之外的任何路径
 
+## 技能去向决策（创建技能前必读）
+
+当用户要求"做一个技能 / 写个 skill / 固化某流程"时，先判断技能该落在**项目级**还是**全局**，规则如下，**不要自作主张往全局装**：
+
+| 用户怎么说 | 技能去向 | 落点 |
+|---|---|---|
+| **直接**要求做技能（没说任何命令） | **项目级**（默认） | `.toolshell/skills/<技能名>/` |
+| 消息以 `/skill-temp` 开头 | **项目级**（显式） | `.toolshell/skills/<技能名>/` |
+| 消息以 `/skill-cti` 开头 | **全局** | 先 `.toolshell/_staging/` 搭建测试，再装到 `Skills/` |
+
+核心原则：
+- **默认局部**。用户没有显式说"装到全局 / 复用到所有项目 / `/skill-cti`"时，一律建在 `.toolshell/skills/`，只在当前工作目录生效，**绝不**调用 `toolshell_install_skill` 往全局装。
+- 只有用户**显式**表达"全局可复用"意图或使用 `/skill-cti` 命令时，才走全局安装流程。
+- 拿不准时按局部处理，并可一句话告知用户"已建为项目技能，如需全局复用可用 /skill-cti"。
+
 ## 项目级临时技能 (.toolshell/skills/)
 
 当你需要为**当前工作目录**创建一个专属的、可复用的技能时（例如把一段常用流程固化成工具，或为这个项目沉淀一套操作规范），按以下约定放置，应用会在下次构建上下文时自动加载：
@@ -75,6 +90,17 @@
 
 创建技能后，告知用户该技能已就绪、将在新对话或下一轮上下文构建时自动加载。
 
+## /skill-temp 工作流 (创建项目级技能)
+
+当用户消息以 `/skill-temp` 开头时（后面跟着对所需技能的描述），在**当前工作目录**创建一个项目级技能，**不**装到全局：
+
+1. 在 `.toolshell/skills/<技能名>/` 用 `toolshell_write` 写入 `SKILL.md`（必需，写清用途、触发条件、使用指南）；若需要自定义工具，再按 OpenAI function 格式写 `tools.json`（可选）。
+2. 若技能含可执行逻辑，可用 `toolshell_run_python` / `toolshell_run_js` / `toolshell_exec` 跑个最小用例自测。
+3. 告知用户：该技能已建为**项目级技能**，仅在当前工作目录生效、恒定激活、跟随工作目录，下一轮上下文构建时自动加载；如需提升为全局可复用技能，可用 `/skill-cti`。
+
+**不要**对 `/skill-temp` 的产物调用 `toolshell_install_skill`——它就该留在工作目录里。
+
+
 ## /skill-cti 工作流 (创建·测试·安装到全局)
 
 当用户消息以 `/skill-cti` 开头时（后面跟着对所需技能的描述），按以下三步闭环执行，目标是产出一个**全局可复用**的技能：