266 Commits

Author SHA1 Message Date
78e76db5b7 Merge pull request #121 from Deepractice/feature/unified-project-cwd
🎯 实现统一项目工作目录:@project://.promptx/cwd
2025-07-05 22:04:53 +08:00
65eddb96df 🎯 实现统一项目工作目录:@project://.promptx/cwd
## 🎯 核心功能
- **统一分析环境**:所有工具分析阶段使用@project://.promptx/cwd作为工作目录
- **保持执行隔离**:工具执行阶段继续使用独立沙箱@user://.promptx/toolbox/{toolId}
- **协议路径支持**:新增resolveProtocolPath()方法处理@project://协议
- **自动目录创建**:首次使用时自动创建统一工作目录

##  设计价值
### **语义清晰**
- @project://.promptx/cwd 明确表达项目级统一工作目录概念
- 完美融入PromptX资源协议体系,保持架构一致性

### **功能优化**
- 分析阶段:统一环境,所有工具共享相同的工作目录上下文
- 执行阶段:隔离环境,每个工具独立沙箱确保安全性
- 路径可预测:开发者明确知道工具运行的目录环境

### **架构改进**
- 符合奥卡姆剃刀原则:用简洁的协议表达明确的语义
- 符合单一职责:统一工作目录专注于分析环境,沙箱专注于执行隔离
- 易于扩展:未来可轻松扩展@project://.promptx/temp等目录

## 🔧 技术实现
### **新增方法**
- `resolveProtocolPath(protocolPath)` - 解析@project://等协议路径
- 更新`createSandbox()`默认sandboxPath为`@project://.promptx/cwd`

### **路径映射**
```
分析阶段: @project://.promptx/cwd → /Users/sean/Management/ContradictionManagement/.promptx/cwd
执行阶段: @user://.promptx/toolbox/{toolId} → /Users/sean/.promptx/toolbox/{toolId}
```

## 🧪 测试验证
-  协议路径解析正确
-  统一工作目录自动创建
-  工具分析和执行流程正常
-  heywhale-activity-scraper完整测试通过

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 22:02:35 +08:00
32c9a521b8 Merge pull request #119 from Deepractice/feature/toolsandbox-unified-refactor
🔧 ToolSandbox统一重构:修复process API缺失和代码重复问题
2025-07-05 14:57:50 +08:00
e1bd961ff1 🔧 修复工具依赖分析问题:新增分析阶段mock require
## 🎯 解决的问题
- 修复工具代码在分析阶段因require失败导致getDependencies()无法调用的问题
- 工具的第一行require('axios')失败时,整个脚本执行中断,module.exports未被设置

## 🔧 实现方案
- 新增createAnalysisRequire()方法,为分析阶段提供mock require
- 内置模块(path、fs等)使用真实require,第三方模块返回Proxy mock对象
- 执行阶段继续使用createSmartRequire()进行真实依赖解析

##  修复效果
-  分析阶段:axios/cheerio被正确mock,脚本完整执行
-  依赖提取:getDependencies()正常调用,返回['axios@^1.6.0', 'cheerio@^1.0.0-rc.12']
-  工具实例化:module.exports正确设置,工具对象创建成功

## 🧪 测试验证
-  heywhale-activity-scraper工具依赖分析成功
-  mock require日志正常输出
-  后续依赖安装准备完成

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 14:45:51 +08:00
487f02ef03 🔧 ToolSandbox统一重构:修复process API缺失和代码重复问题
## 🎯 核心改进
- **统一沙箱创建**:合并createBasicSandbox()和createSmartSandbox()为单一createSandbox()方法
- **完整process mock**:新增createProcessMock()提供完整的process API支持
- **智能require抽取**:独立createSmartRequire()方法处理依赖解析
- **消除代码重复**:删除~150行重复代码,净减少70行

##  修复的问题
-  process.cwd()在所有沙箱中可用
-  process.version/platform/arch完整支持
-  统一的沙箱行为和API
-  参数化配置,易于维护和测试

## 🔄 API变更
- 新增:createSandbox(options) - 统一沙箱创建入口
- 新增:createProcessMock(sandboxPath) - 完整process对象mock
- 新增:createSmartRequire(sandboxPath) - 智能依赖解析
- 删除:createBasicSandbox() - 已合并到createSandbox
- 删除:createSmartSandbox() - 已合并到createSandbox

## 🧪 测试状态
-  语法检查通过
-  基础沙箱功能正常
-  智能沙箱功能正常
-  process API完整性验证通过

Fixes #107

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 14:07:29 +08:00
d1d38e046b fix: 鲁班工具开发体验优化 - 五组件架构升级与智能错误处理 (#116)
* feat: 为promptx_tool增加forceReinstall选项支持

解决工具沙箱缓存机制问题,允许强制重新安装工具依赖。

## 修改内容

### 1. 工具定义更新 (toolDefinitions.js)
- 增加 context.options.forceReinstall 参数支持
- 增加 context.options.timeout 参数支持
- 完善参数描述,说明context用途
- 移除暂时不需要的role_id和session_id参数

### 2. 执行逻辑优化 (ToolCommand.js)
- 支持从context.options提取执行选项
- 将选项传递给ToolSandbox构造函数
- 增加调试日志输出沙箱选项
- 完善JSDoc注释

## 解决的问题

- Issue #107: PromptX工具沙箱缓存机制不支持工具集更新
- 鲁班等AI角色在调试工具时遇到的缓存问题
- 工具依赖更新后无法自动重新安装的问题

## 使用方式

```javascript
// 强制重新安装依赖
{
  tool_resource: "@tool://tool-name",
  parameters: { /* 工具参数 */ },
  context: {
    options: {
      forceReinstall: true
    }
  }
}
```

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化context参数,移除暂时不需要的role_id和session_id

按照奥卡姆剃刀原则,移除当前没有实际用途的参数:
- 移除 context.role_id
- 移除 context.session_id
- 保留 context.options 用于执行配置
- 简化API接口,降低复杂度

未来如需要可重新添加这些参数。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化promptx_tool参数结构,移除context层级

## 主要改进

### 1. 扁平化参数结构
- 移除复杂的context嵌套,直接使用顶级参数
- forceReinstall 和 timeout 作为可选的顶级参数
- 遵循MCP协议惯例,降低AI理解成本

### 2. 参数说明优化
- forceReinstall: 明确默认值为false
- 详细说明使用场景:工具开发和调试中的缓存问题
- timeout: 明确默认值为30000ms

### 3. 防止盲目调用
- 增加重要提醒:要求AI先了解工具说明再调用
- 避免大模型在不了解工具的情况下盲目执行

## 新的调用方式

## 优势
- 符合MCP预训练共识,降低AI学习成本
- 参数结构简洁直观
- 保持向后兼容性

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: 修正鲁班工具开发提示词 - 更新为五组件架构并增加AI引导机制

- 更新DPML工具标签知识:从四组件升级到五组件架构(增加identity标签)
- 在工具开发工作流中增加.tool.md说明书创建步骤
- 添加AI使用提醒机制,强化工具使用前必读原则
- 完善工具标签编写模板,包含完整的五标签结构
- 更新质量检查标准,适配新的标签体系

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: 添加智能require错误过滤机制到ToolSandbox

解决工具开发中的常见问题:analyze阶段require依赖导致的错误

核心改进:
- 添加_filterRequireError()私有方法,智能识别MODULE_NOT_FOUND错误
- 通过静态分析提取getDependencies()声明的依赖列表
- 对比缺失模块与声明依赖,区分合法缺失和代码错误
- 支持版本号格式的依赖声明(如axios@^1.6.0)

开发者体验提升:
- 可以自然地在文件顶部写require()语句
- 忘记声明依赖时仍会得到明确错误提示
- 降低工具开发的认知负担和学习成本
- 遵循奥卡姆剃刀原则:用技术解决技术问题

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-07-05 09:10:43 +08:00
e414dc0d18 feat: 解决工具沙箱缓存机制问题,增加forceReinstall参数支持 (#114)
* feat: 为promptx_tool增加forceReinstall选项支持

解决工具沙箱缓存机制问题,允许强制重新安装工具依赖。

## 修改内容

### 1. 工具定义更新 (toolDefinitions.js)
- 增加 context.options.forceReinstall 参数支持
- 增加 context.options.timeout 参数支持
- 完善参数描述,说明context用途
- 移除暂时不需要的role_id和session_id参数

### 2. 执行逻辑优化 (ToolCommand.js)
- 支持从context.options提取执行选项
- 将选项传递给ToolSandbox构造函数
- 增加调试日志输出沙箱选项
- 完善JSDoc注释

## 解决的问题

- Issue #107: PromptX工具沙箱缓存机制不支持工具集更新
- 鲁班等AI角色在调试工具时遇到的缓存问题
- 工具依赖更新后无法自动重新安装的问题

## 使用方式

```javascript
// 强制重新安装依赖
{
  tool_resource: "@tool://tool-name",
  parameters: { /* 工具参数 */ },
  context: {
    options: {
      forceReinstall: true
    }
  }
}
```

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化context参数,移除暂时不需要的role_id和session_id

按照奥卡姆剃刀原则,移除当前没有实际用途的参数:
- 移除 context.role_id
- 移除 context.session_id
- 保留 context.options 用于执行配置
- 简化API接口,降低复杂度

未来如需要可重新添加这些参数。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化promptx_tool参数结构,移除context层级

## 主要改进

### 1. 扁平化参数结构
- 移除复杂的context嵌套,直接使用顶级参数
- forceReinstall 和 timeout 作为可选的顶级参数
- 遵循MCP协议惯例,降低AI理解成本

### 2. 参数说明优化
- forceReinstall: 明确默认值为false
- 详细说明使用场景:工具开发和调试中的缓存问题
- timeout: 明确默认值为30000ms

### 3. 防止盲目调用
- 增加重要提醒:要求AI先了解工具说明再调用
- 避免大模型在不了解工具的情况下盲目执行

## 新的调用方式

## 优势
- 符合MCP预训练共识,降低AI学习成本
- 参数结构简洁直观
- 保持向后兼容性

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-07-05 08:00:02 +08:00
8f592cb880 fix: 修复Alpha Release工作流分支配置错误
## 问题描述
Alpha Release工作流错误地配置为在develop分支触发,导致:
- develop分支同时触发Snapshot Release和Alpha Release
- 违背了标准分支策略:develop→snapshot, test→alpha

## 修复内容
- 将Alpha Release触发分支从develop改为test
- 更新工作流中的git checkout命令从develop改为test
- 修正PR查找逻辑从develop分支改为test分支
- 更新注释说明从develop改为test分支

## 修复后的分支策略
- develop分支 → Snapshot Release 
- test分支 → Alpha Release 
- staging分支 → Beta Release 
- main分支 → Production Release 

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 07:29:56 +08:00
248358e2dc fix: 优化女娲角色知识生成机制,解决token爆炸问题
## 核心改进
- 建立增量价值三重检验机制,严格控制knowledge组件内容
- 补充DPML格式规范知识,修复角色生成格式错误
- 精简role-design-patterns,token使用量降低75%
- 在挑战思维中植入格式和内容双重检验机制

## 具体优化
1. **Knowledge约束强化**:只保留Sean原创概念和PromptX特有机制
2. **格式规范补充**:明确@\!引用语法和XML标签规范
3. **挑战思维增强**:增加DPML格式检验和增量价值检验
4. **执行约束完善**:添加token爆炸防护和格式错误防护

## 预期效果
- 解决Issue #108的token爆炸问题
- 修复女娲生成角色的格式错误
- 保持角色专业能力同时大幅节省token消耗

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 07:25:37 +08:00
71ce235904 修复中文路径URL编码问题 (#100)
- 在InitCommand中添加decodeURIComponent()处理中文路径
- 解决MCP传入URL编码路径导致验证失败的问题
- 支持类似 /home/azu/%E6%A1%8C%E9%9D%A2/PromptX 的编码路径

Co-authored-by: Cen-Yaozu <azu@example.com>
2025-07-01 10:00:41 +08:00
08d4c1d194 refactor: 完成PromptX资源架构重构和工具系统集成
- 将prompt/目录重构为resource/目录,统一资源管理
- 删除DACP相关代码,聚焦核心PromptX功能
- 新增鲁班角色,支持工具开发工作流
- 优化无面角色,增强学习和内容保存能力
- 修复角色加载和激活机制
- 完善MCP工具定义和适配器
- 清理过时的前端开发者等角色资源

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 22:44:04 +08:00
d1bd0b5907 feat: 鲁班角色开发Excel和PDF读取工具
- 开发Excel读取工具,支持.xlsx/.xls格式解析
- 开发PDF读取工具,支持文档文本内容提取
- 完成工具测试验证,功能正常
- 更新package注册表时间戳

工具特性:
 Excel工具: 支持多工作表、JSON/Array输出、中文内容
 PDF工具: 支持多页文档、元数据提取、中文文档
 完整的DPML标签文档和错误处理
 ToolSandbox沙箱环境测试通过

技术架构: 项目级工具存储在.promptx/resource/tool/目录
2025-06-28 22:32:02 +08:00
ffb5b4adaf fix: 修复InitCommand项目路径识别问题,优化角色发现机制
主要修改:
• 修复InitCommand.js中AI提供路径优先级配置问题
• 重构Luban角色思维模式文件结构,提升代码组织
• 优化工具执行系统,清理技术债务
• 更新package.registry.json反映最新资源结构

影响:解决了technical-product-manager等角色无法发现的关键问题

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 22:11:17 +08:00
071138ef57 refactor: 完成domain到role目录结构统一和硬编码清理
## 核心变更
1. **女娲角色知识更新**
   - dpml-authoring.execution.md: 更新镜像结构约束为.promptx/resource/role/
   - role-generation.execution.md: 4处domain路径更新为role
   - role-creation.thought.md: 文件组织思维从domain改为role

2. **命令类硬编码清理**
   - InitCommand.js: 移除domain目录创建,改为按需创建
   - RegisterCommand.js: 使用ResourceManager协议查找替代硬编码路径
   - WelcomeCommand.js: 简化loadRoleRegistry()方法,直接使用注册表

3. **包注册表同步**
   - 重新生成package.registry.json确保资源发现一致性

## 技术价值
-  统一目录语义:role比domain更准确描述AI角色
-  清理边角料代码:移除不必要的硬编码路径依赖
-  增强系统架构:基于注册表的资源发现更稳定
-  女娲知识同步:包含最新的role目录结构认知

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 19:59:28 +08:00
eea46a8ee1 feat: 优化鲁班角色并完善ToolSandbox工具开发体系
## 鲁班角色优化
- 新增tool-best-practices知识模块:工具设计最佳实践、性能优化、安全防护
- 新增dpml-tool-tagging知识模块:DPML工具标签四组件架构精通
- 增强craftsmanship思维模式:现代工具特征完善
- 资源迁移到包级别:支持跨项目共享

## ToolSandbox架构完善
- 实现ToolSandbox类:支持@tool://协议的三阶段执行流程
- 优化依赖管理:getDependencies()接口标准化
- 完善UserProtocol:支持@user://沙箱目录访问
- 增强工具发现:FilePatternDiscovery支持多种文件模式

## 工具生态建设
- 添加tool.tag.md:DPML工具标签框架完整定义
- 重构ToolInterface:统一getDependencies()接口规范
- 优化ToolExecutor:集成ToolSandbox执行流程
- 更新注册表:29个资源完整注册发现

## 技术架构改进
- pnpm依赖集成:自动化沙箱环境管理
- 协议系统完善:@tool://和@user://协议标准化
- 资源结构统一:包级别和项目级别一致性
- 开发流程标准化:从需求分析到质量保证的完整工作流

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 19:42:16 +08:00
5f9fa4c92c refactor: 统一资源文件结构 - 移动package.registry.json到resource目录
将package.registry.json从src/目录移动到resource/目录,实现资源文件的统一管理:

文件变更:
- 移动: src/package.registry.json → resource/package.registry.json
- 更新: scripts/generate-package-registry.js - 修改输出路径
- 更新: src/lib/core/resource/discovery/PackageDiscovery.js - 更新4处路径引用
  * _getRegistryPath() 方法(2处)
  * _loadPackageRegistry() 方法
  * getRegistryData() 方法

架构优化:
- 所有资源文件统一集中在resource/目录下
- 简化项目结构,提升语义清晰度
- 保持系统功能完全正常:角色发现、注册表生成、系统初始化

新的统一结构:
📁 resource/
├── 📄 package.registry.json (新位置)
├── 📁 core/ (核心思维模式)
├── 📁 role/ (角色文件)
├── 📁 tool/ (工具文件)
└── 📁 protocol/ (协议定义)

功能验证:
 角色发现正常 (4个核心角色)
 注册表生成正常 (23个资源)
 系统初始化正常
 路径引用全部更新

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 16:05:24 +08:00
3bbf4445d7 cleanup: 精简系统角色 - 保留四个核心角色
删除了不必要的系统角色,只保留核心的四个角色:
- nuwa (女娲) - AI创造与优化角色
- assistant (助手) - 通用助手角色
- sean (Sean) - 个人化角色
- noface (无脸) - 中性化角色

删除的角色:
- java-backend-developer - Java后端开发者
- frontend-developer - 前端开发者
- product-manager - 产品经理
- xiaohongshu-marketer - 小红书营销专家

同时清理了重复的项目级角色文件(.promptx/resource/domain和role目录),
避免角色重复和混乱,让系统更加精简和高效。

项目注册表已自动更新,现在只包含项目级工具资源。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:56:02 +08:00
67f54f83d1 feat: 实现基于文件模式的灵活资源发现架构
## 🏗️ 新增 FilePatternDiscovery 基类
- 统一的文件模式识别逻辑,支持 .role.md, .thought.md, .execution.md, .knowledge.md, .tool.js
- 递归扫描任意目录结构,完全基于文件扩展名识别资源类型
- 统一的资源验证和引用路径生成机制

## 🔄 重构 ProjectDiscovery 和 PackageDiscovery
- 继承 FilePatternDiscovery 基类,大幅简化代码
- 子类只需重写 _getBaseDirectory() 指定扫描目录
- 移除重复的文件扫描和验证逻辑,提升维护性

## 🎯 实现完全灵活的目录结构支持
- resource/ 下支持任意目录组织方式
- 目录名称仅有语义意义,不影响资源发现
- 支持深层嵌套和扁平化结构

## 🔧 修复 InitCommand 参数处理
- 优化空对象参数的处理逻辑
- 保持向后兼容的同时提升健壮性

##  测试验证
- welcome/action/init 命令全面测试通过
- 包级61个资源 + 项目级8个资源正确发现
- project 协议和工具文件识别正常工作

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:46:40 +08:00
559c146af1 refactor: 重构resource/domain为resource/role - 提升目录语义化
## 核心改进
- 将resource/domain重命名为resource/role,语义更清晰直观
- 统一更新所有硬编码路径引用,确保系统完整性
- 重新生成注册表,所有61个资源引用路径完全更新

## 目录结构优化
- resource/role (原domain) - 角色定义和专家能力
- resource/tool - JavaScript工具资源
- resource/protocol - 协议规范文档
- resource/core - 核心思维和执行模式

## 技术实现
### 发现器更新
- ProjectDiscovery.js: _scanDomainDirectory → _scanRoleDirectory
- PackageDiscovery.js: 同步更新函数名和路径引用
- 所有@project://.promptx/resource/domain/ → @project://.promptx/resource/role/
- 所有@package://resource/domain/ → @package://resource/role/

### 协议处理器
- PromptProtocol.js: domain注册表映射 → role注册表映射
- 更新协议示例和描述信息

### 注册表重新生成
- 使用generate-package-registry.js重新生成
- 61个资源路径引用全部更新为resource/role/
- 保持所有功能完全兼容

## 验证结果
-  角色发现功能正常:8个系统角色+1个项目角色
-  资源加载完全正常:61个资源正确识别
-  零功能影响:所有现有功能继续工作

这个重构显著提升了代码的语义化程度,role比domain更直观地表达目录用途,
同时建立了清晰的资源分类体系:role、tool、protocol、core。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:24:19 +08:00
808c5af9fa cleanup: 移除product子模块 - 精简项目结构
## 清理内容
- 反初始化product子模块:git submodule deinit -f product
- 删除git元数据:.git/modules/product/
- 从索引移除:git rm -f product
- 清理配置文件:.gitmodules

## 影响分析
- 项目结构更加清晰,专注于核心PromptX功能
- 减少不必要的依赖和复杂性
- 提升仓库克隆和维护效率

## 技术细节
- 完全移除product子模块的所有痕迹
- 保持git历史的完整性
- 确保.gitmodules配置文件正确更新

这个清理操作简化了项目结构,让开发者能够更专注于PromptX框架的核心功能开发。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:15:02 +08:00
5779aa837c fix: 全面清理prompt关键词引用 - 完成prompt→resource重构
核心修复:
- 修复PackageDiscovery._isValidDevelopmentRoot()检查resource目录而非prompt
- 更新package.json files字段从prompt/改为resource/
- 修复RegisterCommand.js中的资源路径引用
- 更新WelcomeCommand.js中的@package://prompt/为@package://resource/
- 修复PromptProtocol.js中所有@package://prompt/路径引用
- 更新PackageProtocol.js示例路径
- 批量更新docs/目录下26个文档的路径引用

技术价值:
- 解决PackageDiscovery无法加载系统级角色的问题
- 消除PackageProtocol的Access denied错误
- 实现prompt→resource语义重构的100%完整性
- 确保所有8个系统级角色正常加载和激活

验证结果:
-  61个系统级资源正常加载
-  8个角色完全可用(assistant,frontend-developer,java-backend-developer,noface,nuwa,sean,xiaohongshu-marketer,product-manager)
-  welcome和action命令完全正常工作

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:12:17 +08:00
54b77e7096 refactor: 重构/prompt/目录为/resource/ - 更符合资源引用协议语义
- 重命名核心目录: /prompt/ → /resource/
- 更新PackageDiscovery中所有硬编码路径引用
- 重新生成package.registry.json,61个资源全部更新为@package://resource/路径
- 批量更新文档中的路径引用,保持一致性
- 目录结构保持不变:domain/, core/, protocol/, tool/子目录结构完全一致

重构原因: 随着tool协议的加入,prompt目录名称不再准确描述系统本质
重构价值: 为未来资源生态扩展奠定清晰的命名基础

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:02:34 +08:00
8452eb4ec5 refactor: 整合MCP命令到mcp目录 - 优化项目结构
- 移动MCPServerCommand.js和MCPStreamableHttpCommand.js到lib/mcp/目录
- 删除空的lib/commands/目录,避免代码分散
- 更新bin/promptx.js中的import路径指向新位置
- 统一MCP相关代码到同一目录,提升代码组织性

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 14:40:10 +08:00
e54550a835 refactor: 重构PromptXToolCommand为ToolCommand并移至标准目录
📁 文件重构
- 移动: src/lib/commands/PromptXToolCommand.js → src/lib/core/pouch/commands/ToolCommand.js
- 重命名: PromptXToolCommand → ToolCommand
- 统一: 与其他Command文件保持相同目录结构

🔧 代码更新
Class:
- class PromptXToolCommand → class ToolCommand
- 更新module.exports导出名称

Imports:
- 修正BasePouchCommand相对路径引用
- 修正getGlobalResourceManager相对路径引用
- 修正ToolExecutor和logger相对路径引用

References:
- src/lib/core/pouch/commands/index.js: 更新import和export
- src/lib/core/pouch/PouchCLI.js: 更新commands.ToolCommand引用

📂 目录结构统一
src/lib/core/pouch/commands/
├── ActionCommand.js
├── InitCommand.js
├── LearnCommand.js
├── RecallCommand.js
├── RememberCommand.js
├── ToolCommand.js          # 新位置
├── WelcomeCommand.js
└── index.js

 验证通过
- @tool://calculator 减法功能正常: 100 - 58 = 42
- 所有引用路径正确
- 命名规范统一
- 目录结构规范

💡 重构收益
- 遵循项目命名约定
- 统一Command文件组织
- 简化类名提升可读性
- 便于维护和扩展

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 14:31:57 +08:00
7964cf8dba refactor: 重构MCPOutputAdapter到mcp目录 - 优化代码组织结构
📁 目录重构
- 移动: src/lib/adapters/MCPOutputAdapter.js → src/lib/mcp/MCPOutputAdapter.js
- 删除: src/lib/adapters/ 空目录
- 整合: 所有MCP相关组件统一在mcp目录下

🔧 引用更新
Components:
- src/lib/commands/MCPServerCommand.js: 更新import路径
- src/lib/commands/MCPStreamableHttpCommand.js: 更新import路径

🎯 重构目标
- 统一MCP相关代码组织
- 提升代码可维护性
- 优化目录结构逻辑

📂 新的mcp目录结构
src/lib/mcp/
├── MCPOutputAdapter.js     # MCP输出适配器
└── toolDefinitions.js      # MCP工具定义

 验证通过
- @tool://calculator 除法功能正常: 84 ÷ 2 = 42
- MCP Server功能完全正常
- 所有引用路径正确更新

💡 架构收益
- MCP组件集中管理
- 代码职责更清晰
- 便于后续MCP功能扩展

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 14:29:09 +08:00
b18983bdac refactor: 系统性移除DACP架构 - 简化框架专注@tool协议
🗑️ 核心清理
- 完全移除DACP服务架构和HTTP模式
- 删除DACPCommand、DACPConfigManager等核心组件
- 清理所有DACP相关文件、测试和文档
- 从CLI移除dacp命令,精简为6大核心锦囊

📁 删除内容
Core:
- src/dacp/ - 整个DACP服务目录
- src/lib/core/pouch/commands/DACPCommand.js
- src/lib/utils/DACPConfigManager.js

Tests:
- src/tests/commands/DACPCommand.unit.test.js
- src/tests/integration/dacp-integration.test.js
- src/tests/e2e/dacp-*-e2e.test.js
- src/tests/unit/DACPConfigManager.unit.test.js

Scripts & Docs:
- scripts/test-*dacp*.js
- docs/dacp-*.md
- prompt/core/dacp-*.execution.md

🔧 代码清理
CLI:
- src/bin/promptx.js: 移除dacp命令和--with-dacp选项
- 帮助信息更新:7大命令→6大核心命令

Core:
- src/lib/core/pouch/PouchCLI.js: 移除dacp命令注册
- src/lib/core/pouch/commands/index.js: 清理DACPCommand引用

MCP:
- src/lib/mcp/toolDefinitions.js: 移除promptx_dacp工具定义
- src/lib/commands/MCPServerCommand.js: 清理所有DACP方法和引用
- src/lib/commands/MCPStreamableHttpCommand.js: 移除DACP参数映射

Registry:
- src/package.registry.json: 自动更新,移除2个DACP execution资源
- package.json: 移除dacp相关npm脚本

📊 架构简化结果
- 资源总数:63个 → 61个 (移除2个DACP execution)
- CLI命令:7个 → 6大核心锦囊
- 代码复杂度显著降低,专注核心功能

 验证通过
- @tool://calculator 计算功能正常: 6 × 7 = 42
- @tool://send-email 邮件工具正常
- MCP Server启动正常
- 所有锦囊命令工作正常

🎯 新架构重点
1. 角色系统 - AI专业能力激活
2. 记忆系统 - 知识学习和回忆
3. @tool协议 - JavaScript工具执行
4. MCP集成 - AI应用连接

💡 技术收益
- 移除HTTP服务复杂度
- 统一@tool协议标准
- 简化维护和扩展
- 提升性能和稳定性

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 14:26:25 +08:00
40e0c01c59 feat: 实现@tool协议完整功能 - JavaScript工具执行框架
 核心功能
- 新增ToolProtocol处理器,支持@tool://协议解析
- 实现PromptXToolCommand,统一MCP/CLI工具调用
- 完善ToolExecutor,支持工具实例化和参数验证
- 新增calculator和send-email示例工具

🔧 技术改进
- 优化PackageDiscovery统一资源扫描逻辑
- 增强CrossPlatformFileScanner支持.tool.js文件
- 完善ResourceManager集成ToolProtocol
- 更新MCP工具定义支持promptx_tool

📋 详细变更
Core:
- src/lib/core/resource/protocols/ToolProtocol.js: 新增工具协议处理器
- src/lib/commands/PromptXToolCommand.js: 新增工具命令处理器
- src/lib/tool/ToolExecutor.js: 增强工具执行器兼容性

Discovery:
- src/lib/core/resource/discovery/PackageDiscovery.js: 统一资源扫描
- src/lib/core/resource/discovery/CrossPlatformFileScanner.js: 支持tool文件
- src/lib/core/resource/discovery/ProjectDiscovery.js: 增加tool验证

Integration:
- src/lib/core/resource/resourceManager.js: 集成ToolProtocol
- src/lib/mcp/toolDefinitions.js: 新增promptx_tool定义
- src/lib/commands/MCPServerCommand.js: 支持tool参数转换
- src/bin/promptx.js: 新增tool命令行支持

Tools:
- prompt/tool/calculator.tool.js: 数学计算工具示例
- prompt/tool/send-email.tool.js: 邮件发送工具示例

Registry:
- src/package.registry.json: 自动生成包含2个tool资源

🧪 测试验证
-  @tool://calculator 数学计算: 25 + 37 = 62
-  @tool://send-email 邮件发送演示版本
-  CLI和MCP双模式支持
-  完整的错误处理和执行元数据
-  资源自动发现和注册

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 14:15:24 +08:00
ee667ba0e3 fix: 简化Views徽章为username=PromptX
- 使用username=PromptX直接统计项目访问量
- 移除repo参数,使用更简洁的配置
- 专门为PromptX项目定制的访问计数器

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 12:11:42 +08:00
2b246deed7 fix: 修正Views徽章参数,添加repo指定为PromptX
- 添加repo=PromptX参数,确保统计针对具体仓库
- 修正之前只使用username导致的全局计数问题
- 现在将准确统计PromptX仓库的访问量

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 12:10:03 +08:00
6087db5d20 feat: 添加Repository Views徽章统计页面观看数
- 新增komarev/github-profile-views-counter服务统计仓库浏览量
- 使用蓝色主题(0e75b6)与现有徽章风格保持一致
- 提升项目可见性和数据透明度

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 12:07:53 +08:00
127adc979c Merge remote-tracking branch 'origin/main' into develop 2025-06-28 11:59:16 +08:00
671219f3f3 Merge pull request #90 from Deepractice/feature/readme-product-optimization
🌟 README社区价值体系全面优化
2025-06-28 11:31:16 +08:00
dca2ff31de feat: 添加安装成功示意图
- 新增 assets/install-success.jpg 用于展示MCP工具安装成功效果
- 完善README中的安装成功确认章节视觉展示

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 11:26:00 +08:00
eaf4efe841 feat: 全面优化社区价值体系和README结构
## 主要变更
- **社区定位升级**:从"AI时代Life Style"优化为"AI原生Life Style社区"
- **价值观体系重构**:技术开源·内容分享·社区开放·价值交换四维度
- **社区价值机制**:构建注意力价值交换+商业价值交换双重生态
- **内容展示优化**:社区案例分享格式精简,提升阅读体验
- **精神内核明确**:突出"实践·协作·创新"的社区精神

## 技术改进
- 移除冗余的传统企业级展示模式
- 优化信息架构,突出价值交换核心理念
- 精简社区案例展示,提升信息密度
- 强化AI原生社区的独特定位

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 11:17:01 +08:00
4f84120861 refactor: 重构社区章节和案例展示
核心改进:
- 🌟 新增「Deepractice深度实践社区」愿景展示
- 🎯 突出「AI时代Life Style」定位和「君子和而不同」价值观
- 🏗️ 重新设计社区资源架构:开源产品+开发者舞台+商业共建
- 📋 移动案例到最后,重命名为「社区优质案例分享」
- 🤝 简化「加入我们」为纯二维码展示

产品战略价值:
- 从工具项目升华为AI时代生活方式社区
- 建立开放包容的商业合作模式(内容换价值)
- 为社区可持续发展和商业化提供健康路径

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 10:29:20 +08:00
4aed668a98 feat: 重新定位产品价值主张,强化AI上下文工程概念
核心改进:
- 🎯 主标题改为「领先的AI上下文工程平台」蹭技术热点
-  引入「Chat is all you need」革命性交互理念
- 🚀 前置强力案例数据(11000行代码、40小时→30分钟)
- 🎭 重新包装核心能力,突出专业价值

产品战略价值:
- 结合AI上下文工程趋势,提升技术定位
- 通过真实数据建立社会证明
- 降低技术理解门槛,扩大目标用户群

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 09:31:59 +08:00
70093018f8 WIP: promptx tools 开发中的代码
- 正在开发 promptx tools 功能
- 包含 bin、commands、DACP 相关修改
- 新增 tool 目录结构

🚧 这是开发中的代码,需要继续完善
2025-06-28 09:25:54 +08:00
d6455987ab feat: noface角色重命名及file://协议路径转换优化
## 主要变更
- **角色重命名**: wumian → noface,更符合英文命名规范
- **file://协议优化**: 新增FileProtocol.js支持本地文件访问
- **路径转换修复**: 智能处理Shell反斜杠转义问题
- **ResourceManager增强**: 支持基础协议直接处理

## 技术改进
- 修复复杂路径格式兼容性(如WeChat路径、中文字符、特殊符号)
- 自动清理反斜杠转义符(Application\ Support → Application Support)
- 完善错误处理机制和用户提示

## 文件变更
- 新增: noface角色完整文件结构(role + 2个execution文件)
- 新增: FileProtocol.js协议处理器
- 更新: ResourceManager.js基础协议支持
- 更新: package.registry.json角色注册信息

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-26 17:26:04 +08:00
5181bfeff1 fix: 系统化优化角色输出显示,解决角色名称混淆问题
- 优化WelcomeCommand输出格式,角色列表显示为 `id` - name 格式
- 优化ActionCommand输出格式,激活成功时显示 `id` (name) 格式
- 更新package.registry.json中7个角色的name和description:
  * nuwa: "Nuwa 角色" → "女娲",描述更新为专业的角色创造能力
  * sean: "Sean 角色" → "Sean",描述更新为CEO身份
  * product-manager: 更新为"产品经理",描述强调价值平衡能力
  * java-backend-developer: 更新为"Java后端开发工程师",描述强调架构能力
  * frontend-developer: 更新为"前端开发工程师",描述强调用户体验
  * xiaohongshu-marketer: 更新为"小红书营销专家",描述强调平台运营
  * assistant: 更新为"总经理秘书",描述强调执行和协调能力
- 解决角色名称显示不一致和描述过于通用的问题
- 提升用户体验,避免角色身份混淆

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-26 16:24:07 +08:00
1cc01bf1ef fix: 修复记忆时的问题处理合并的问题 2025-06-26 16:04:50 +08:00
b3abbaeb84 Merge pull request #86 from Cen-Yaozu/develop
🚀 feat: 记忆系统架构升级 + declarative.dpml命名重构 + MCP边界条件Bug修复
2025-06-26 15:15:39 +08:00
b5845a7523 🚀 feat: 记忆系统架构升级 + declarative.dpml命名重构 + MCP边界条件Bug修复
## 📊 变更概览
- declarative.dpml架构升级:memory.xml → declarative.dpml (认知科学语义精准)
- MCP环境边界条件Bug修复:解决空文件导致的记忆保存失败问题
- 跨项目角色发现Bug修复:优化环境检测顺序,MCP环境角色发现从1个→9个
- XML转义处理增强:完整的存储-显示分离架构,数据安全+用户友好

## 🎯 核心成就
 declarative.dpml升级:100%测试验证通过
 边界条件修复:三重保护机制,文件状态自动检测修复
 角色发现修复:环境检测顺序优化,跨项目使用稳定
 存储分离架构:XML转义安全存储 + AI友好显示

## 📁 主要文件变更
- RememberCommand.js/RecallCommand.js: declarative.dpml升级 + 边界条件修复
- PackageDiscovery.js: 环境检测顺序优化
- 新增思维模式文件: recall-xml.thought.md, remember-xml.thought.md
- 新增测试: memory-dpml-integration.test.js
- 完整文档: PR文档 + Bug报告 + 修复总结

🎉 架构升级验证:MCP重启测试100%通过,零中断平滑切换
2025-06-26 14:07:47 +08:00
0cc59c22f7 删除产品子项目文件 2025-06-22 15:49:17 +08:00
901a278d6d Optimize: 优化 sean 提示词 2025-06-22 15:45:49 +08:00
0678824ffc Merge staging into develop: 解决合并冲突
- 保留develop分支的路径修复(DirectoryService统一使用)
- 保留develop分支的角色增强(Sean矛盾分析、女娲DPML规范)
- 保留develop分支的DACP工具描述优化
- 保留develop分支的资源注册表(50个资源)

冲突解决策略:
- RememberCommand/RecallCommand/RegisterCommand: 使用DirectoryService修复
- Sean角色: 保留矛盾分析方法论和三轨制管理
- 女娲角色: 保留DPML规范执行原则
- DACP工具: 保留专业执行工具描述
- 注册表: 保留完整的50个资源

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-22 14:15:04 +08:00
b03fb37d3f Optimize: 优化 sean 提示词 2025-06-22 13:03:47 +08:00
aed3d0f1d6 fix: 修复 这几个命令使用了废弃的项目路径定位方案 2025-06-22 11:14:55 +08:00
ef370d6af8 Optimize:优化女娲提示词,为 Sean 添加 Github Issues 矛盾分析方法论 2025-06-21 20:54:31 +08:00
320fe9e552 refactor: 优化DACP工具提示词,去除诱导性描述
- 将DACP工具描述从功能介绍改为使用条件
- 强调需要专业知识才能正确使用
- 避免AI在不了解服务配置时盲目尝试
- 符合"先学会使用工具再做事"的设计理念

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-21 16:34:21 +08:00
831a6297e8 doc: 新增“女娲”使用心得 (#73)
* feat:添加女娲的使用心得
refactor:readme最新版本同步到英文版

* docs: 添加社区教程与案例部分,包含基于PromptX架构的MCP工具开发实践经验

* Staging (#71)

* Develop (#66)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* Develop (#70)

* 重构ActionCommand和LearnCommand,更新DPMLContentParser和SemanticRenderer的导入路径,确保模块结构一致性。删除不再使用的DPMLContentParser和SemanticRenderer文件,优化代码结构,提升可维护性。

* 重构PromptX资源协议系统,采用极简两层协议架构,删除不必要的语义层,优化路径解析和资源加载流程。引入AI协作优化,支持直接生成完整协议路径,提升系统性能和用户体验。整体架构简化60%,实现零配置启动,显著降低内存占用和启动时间。

* optimize:优化女娲提示词

* Optimize:更新记忆策略文档,增加角色专业记忆的独特价值和工作流程,强调角色记忆与客户端记忆的差异,优化记忆引导话术和决策规则,以提升用户对专业记忆系统的理解和应用。

* feature:增加 Sean 角色

* optimize:优化记忆格式化逻辑,确保完整记忆内容不被截断,同时更新工具定义中的描述,增强用户对记忆回想器的理解和使用指导。

* feat: 添加DACP服务支持,允许通过命令行调用DACP专业服务,增强AI角色的执行能力,同时更新相关依赖和工具定义。

* feat: 在MCPServerCommand和MCPStreamableHttpCommand中添加'promptx_dacp'参数映射,同时在DACPCommand中优化参数处理逻辑,以支持数组参数的正确解析。

* feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

* feat: 添加DACP邮件发送功能,支持真实发送与Demo模式,增强邮件发送的配置管理和错误提示,优化用户体验。

* feat: 更新女娲和Sean角色文档,增强角色身份、核心特质和决策框架的描述,优化内容结构,提升用户理解和使用体验。同时,更新产品哲学知识体系,明确矛盾驱动和简洁性原则的应用。

* Add product management submodule

* fix: 修复 recall 和 learn 的 bug

* refactor: 把 hello 改成 welcome

* feat: 添加DACP服务启动脚本和测试命令,更新相关依赖,优化配置文件路径处理

* fix: 更新pnpm-lock.yaml以匹配DACP依赖,解决CI中--frozen-lockfile的错误

* 更新DACP白皮书的更新日期至2025-01-19;在DACPConfigManager中优化配置管理,支持项目级和用户级配置的优先级处理,增强错误提示信息,更新相关方法以支持异步操作。

* fix: 统一Pouch命令路径获取机制,解决Issue #69记忆持久化问题

修复多实例MCP环境下的路径不一致问题:
- RememberCommand: 使用ResourceManager替代DirectoryService直接调用
- RecallCommand: 使用ResourceManager替代DirectoryService直接调用
- RegisterCommand: 使用ResourceManager+DirectoryService统一路径获取

核心改进:
1. 所有命令现在使用相同的getGlobalResourceManager()初始化
2. 通过resourceManager.initializeWithNewArchitecture()确保路径一致性
3. 实现"要对一起对,要错一起错"的一致性原则

测试验证:
- 记忆写入和读取使用相同项目路径
- 多实例环境下路径解析行为完全一致
- 向后兼容,无破坏性变更

Fixes #69

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

* 更新README文件,替换女娲创造工坊的logo图片,添加社区教程与案例部分,展示基于PromptX架构的MCP工具开发经验,提升内容的可读性和用户体验。

* 更新README文件,优化“女娲”功能的描述,强调其无需编程知识即可使用的便利性,并介绍其创建“小红书营销”专家的能力,提升内容的清晰度和用户体验。

---------

Co-authored-by: Sean <sean@deepracticex.com>
Co-authored-by: coso <wutongci@example.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-06-21 12:33:44 +08:00