feedback-mcp 1.0.64__py3-none-any.whl

feedback_config.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""
+Feedback配置管理
+用于管理IDE等全局配置
+"""
+import json
+import os
+from pathlib import Path
+from typing import Optional, Dict, Any
+
+
+class FeedbackConfig:
+    """Feedback配置管理"""
+
+    def __init__(self, project_path: Optional[str] = None):
+        """初始化配置管理器
+
+        Args:
+            project_path: 项目路径，默认为当前工作目录
+        """
+        if project_path:
+            self.project_path = Path(project_path)
+        else:
+            self.project_path = Path.cwd()
+
+        self.config_dir = self.project_path / '.claude'
+        self.config_file = self.config_dir / 'feedback.config'
+
+    def load_config(self) -> Dict[str, Any]:
+        """加载配置
+
+        Returns:
+            配置字典
+        """
+        if not self.config_file.exists():
+            return {
+                "ide": None,
+                "custom_ide_command": None
+            }
+
+        try:
+            with open(self.config_file, 'r', encoding='utf-8') as f:
+                config = json.load(f)
+                # 确保必要的键存在
+                if "ide" not in config:
+                    config["ide"] = None
+                if "custom_ide_command" not in config:
+                    config["custom_ide_command"] = None
+                return config
+        except (json.JSONDecodeError, IOError) as e:
+            print(f"Error loading config: {e}")
+            return {
+                "ide": None,
+                "custom_ide_command": None
+            }
+
+    def save_config(self, config: Dict[str, Any]):
+        """保存配置
+
+        Args:
+            config: 配置字典
+        """
+        try:
+            # 确保目录存在
+            self.config_dir.mkdir(parents=True, exist_ok=True)
+
+            # 写入配置
+            with open(self.config_file, 'w', encoding='utf-8') as f:
+                json.dump(config, f, indent=2, ensure_ascii=False)
+        except IOError as e:
+            print(f"Error saving config: {e}")
+
+    def get_ide(self) -> Optional[str]:
+        """获取配置的IDE
+
+        Returns:
+            IDE名称或None
+        """
+        config = self.load_config()
+        # 优先返回custom_ide_command，其次返回ide
+        custom = config.get("custom_ide_command")
+        if custom:
+            return custom
+        return config.get("ide")
+
+    def set_ide(self, ide: Optional[str] = None, custom_command: Optional[str] = None):
+        """设置IDE
+
+        Args:
+            ide: IDE名称（单选按钮选择的）
+            custom_command: 自定义IDE命令
+        """
+        config = self.load_config()
+
+        if custom_command:
+            # 如果有自定义命令，优先使用
+            config["custom_ide_command"] = custom_command
+            config["ide"] = None
+        else:
+            # 否则使用预设IDE
+            config["ide"] = ide
+            config["custom_ide_command"] = None
+
+        self.save_config(config)
+
+    def clear_ide(self):
+        """清除IDE配置"""
+        config = self.load_config()
+        config["ide"] = None
+        config["custom_ide_command"] = None
+        self.save_config(config)
+
+
+def main():
+    """命令行接口"""
+    import argparse
+
+    parser = argparse.ArgumentParser(description='管理Feedback配置')
+    parser.add_argument('action', choices=['get', 'set', 'clear'],
+                        help='要执行的操作')
+    parser.add_argument('--project-path', help='项目路径')
+    parser.add_argument('--ide', help='IDE名称')
+    parser.add_argument('--custom-command', help='自定义IDE命令')
+
+    args = parser.parse_args()
+
+    config_manager = FeedbackConfig(args.project_path)
+
+    if args.action == 'get':
+        ide = config_manager.get_ide()
+        print(ide if ide else "none")
+
+    elif args.action == 'set':
+        config_manager.set_ide(args.ide, args.custom_command)
+        ide = config_manager.get_ide()
+        print(f"IDE配置已设置为: {ide}")
+
+    elif args.action == 'clear':
+        config_manager.clear_ide()
+        print("IDE配置已清除")
+
+
+if __name__ == "__main__":
+    main()

feedback_mcp-1.0.64.dist-info/METADATA

@@ -0,0 +1,327 @@
+Metadata-Version: 2.4
+Name: feedback-mcp
+Version: 1.0.64
+Summary: Interactive Feedback MCP Server with UI - 支持工作空间管理、任务追踪、检查点恢复的反馈系统
+Author-email: Yang <your.email@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/feedback-mcp
+Project-URL: Repository, https://github.com/yourusername/feedback-mcp
+Project-URL: Issues, https://github.com/yourusername/feedback-mcp/issues
+Keywords: mcp,feedback,interactive,workspace,task-management,checkpoint,ai-assistant,development-tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp==2.5.1
+Requires-Dist: PySide6<7.0.0,>=6.8.0
+Requires-Dist: psutil<8.0.0,>=6.0.0
+Requires-Dist: markdown<4.0.0,>=3.6
+Requires-Dist: pyyaml<7.0.0,>=6.0.0
+Requires-Dist: requests<3.0.0,>=2.28.0
+Requires-Dist: python-dotenv<2.0.0,>=1.0.0
+Requires-Dist: urllib3<3.0.0,>=2.0.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: Pillow<12.0.0,>=10.0.0
+Requires-Dist: pyperclip<2.0.0,>=1.8.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# Interactive Feedback MCP
+
+一个功能强大的 MCP (Model Context Protocol) 服务器,提供交互式反馈界面,支持工作空间管理、任务追踪和检查点恢复。
+
+## ✨ 核心特性
+
+- 🎯 **交互式反馈界面**: 基于 PySide6 的现代化 UI,支持文本、图片等多种反馈方式
+- 📁 **工作空间管理**: 完整的工作空间生命周期管理,支持阶段切换
+- ✅ **任务追踪**: 强大的任务管理系统,支持依赖关系、优先级、并行执行
+- 💾 **检查点恢复**: 创建、恢复、对比工作检查点,确保工作安全
+- 🔄 **工作流支持**: 模板化工作流,支持自定义工作流程
+- 📊 **会话管理**: 完整的会话历史记录和统计
+
+## 🚀 快速开始
+
+### 方式一：使用 uv tool 安装（推荐）
+
+#### 安装 feedback-mcp
+
+```bash
+# 使用清华镜像（推荐，国内速度快）
+uv tool install feedback-mcp@latest --index https://pypi.tuna.tsinghua.edu.cn/simple
+
+# 或使用阿里云镜像
+uv tool install feedback-mcp@latest --index https://mirrors.aliyun.com/pypi/simple/
+
+# 验证安装
+uv tool list | grep feedback
+which feedback-mcp
+
+# 更新版本
+uv tool upgrade feedback-mcp
+```
+
+**优势：**
+- ✅ 只占用 1.1GB 空间（不会重复缓存）
+- ✅ 启动速度快 10-30 倍
+- ✅ 使用国内镜像下载速度快（1-3分钟 vs 10-30分钟）
+- ✅ 一次安装，长期使用
+- ✅ 自动管理 Python 版本（支持 3.10-3.12）
+
+**可选：配置全局镜像**
+
+如果不想每次都加 `--index` 参数，可以配置 `~/.config/uv/uv.toml`：
+
+```toml
+[[index]]
+name = "tsinghua"
+url = "https://pypi.tuna.tsinghua.edu.cn/simple"
+default = true
+```
+
+配置后直接运行 `uv tool install feedback-mcp@latest` 即可。
+
+### 方式二：使用 pip 安装
+
+```bash
+# 使用清华镜像安装
+pip install feedback-mcp -i https://pypi.tuna.tsinghua.edu.cn/simple
+
+# 或配置 pip 全局镜像
+pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+pip install feedback-mcp
+```
+
+### 配置 MCP 服务器
+
+在你的 MCP 客户端配置文件（如 `.mcp.json`）中添加：
+
+#### 使用 uv tool 方式（推荐）
+
+```json
+{
+  "mcpServers": {
+    "feedback": {
+      "command": "feedback-mcp",
+      "args": ["--ide", "qoder"],
+      "timeout": 30000,
+      "autoApprove": ["interactive_feedback"]
+    }
+  }
+}
+```
+
+
+**参数说明：**
+- `--ide`: IDE 名称，可选值：`qoder`、`cursor`、`vscode` 等
+- `timeout`: 超时时间（毫秒），建议 30000 以上
+- `autoApprove`: 自动批准的工具列表
+
+### 配置 Stop Hook
+
+在项目的 `hooks/hooks.json` 文件中配置停止钩子：
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uvx --from feedback-mcp --with feedback-mcp python -m stop_hook"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**注意：**
+- `uvx` 会自动选择合适的 Python 版本（3.10-3.12）
+- 如需指定版本可添加 `--python 3.11` 参数
+- 如果使用 `uv tool install` 方式，参考上文中的路径配置
+- 如果使用 pip 全局安装，使用 `python3 -m stop_hook` 即可
+- Stop Hook 用于在会话结束时触发反馈提示
+
+### 使用示例
+
+安装配置完成后，AI 助手可以通过 `interactive_feedback` 工具与你交互：
+
+```python
+# AI 助手自动调用 feedback 工具
+# 弹出交互式反馈窗口
+# 支持文本输入、预定义选项、文件选择等多种交互方式
+```
+
+## 📦 主要功能
+
+### 1. 工作空间管理
+
+- 创建工作空间并设置目标
+- 管理工作空间的不同阶段
+- 记录工作记忆和相关文件
+- 支持多个并行工作空间
+
+### 2. 任务管理
+
+- 创建和更新任务列表
+- 设置任务依赖关系和优先级
+- 支持任务并行执行
+- 实时任务状态追踪
+
+### 3. 检查点系统
+
+- 创建工作检查点快照
+- 恢复到历史检查点
+- 对比不同检查点的差异
+- 自动收集相关文件
+
+### 4. 工作流引擎
+
+- 预定义工作流模板
+- 自定义工作流步骤
+- 工作流状态管理
+- 步骤依赖和执行控制
+
+## 🔧 系统要求
+
+- Python >= 3.10, < 3.13 (支持 3.10, 3.11, 3.12)
+- PySide6 >= 6.8.0
+- FastMCP >= 2.5.1
+
+## 🐛 常见问题
+
+### 1. 磁盘空间占用过大
+
+**问题：** `~/.cache/uv/` 目录占用大量磁盘空间（可能达到 100GB+）
+
+**原因：** 使用 `uvx` 方式会为每次运行创建独立的虚拟环境缓存
+
+**解决方案：**
+```bash
+# 清理 uv 缓存
+uv cache clean
+
+# 迁移到 uv tool install 方式（推荐）
+uv tool install feedback-mcp@latest
+```
+
+迁移后磁盘占用从 ~125GB 降至 ~1.1GB，启动速度提升 10-30 倍。
+
+### 2. 安装速度慢
+
+**问题：** 下载 PySide6 等大型依赖包速度很慢
+
+**解决方案：** 配置国内镜像加速（见上文"配置国内镜像加速"章节）
+
+### 3. Stop Hook 不工作
+
+**问题：** 会话结束时没有弹出反馈窗口
+
+**排查步骤：**
+```bash
+# 1. 检查 hooks.json 配置是否正确
+cat hooks/hooks.json
+
+# 2. 测试 stop_hook 模块是否可用
+~/.local/share/uv/tools/feedback-mcp/bin/python -m stop_hook
+
+# 3. 检查 Python 路径是否正确
+which python
+ls -la ~/.local/share/uv/tools/feedback-mcp/bin/python
+```
+
+**解决方案：** 确保 hooks.json 中的 Python 路径与实际安装位置一致
+
+### 4. 权限问题
+
+**问题：** `permission denied: feedback-mcp`
+
+**解决方案：**
+```bash
+# 添加执行权限
+chmod +x ~/.local/bin/feedback-mcp
+
+# 确保 ~/.local/bin 在 PATH 中
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### 5. 版本更新
+
+**更新到最新版本：**
+```bash
+# 使用 uv tool
+uv tool upgrade feedback-mcp
+
+# 或重新安装特定版本
+uv tool install feedback-mcp@1.0.4 --force
+
+# 使用 pip
+pip install --upgrade feedback-mcp -i https://pypi.tuna.tsinghua.edu.cn/simple
+```
+
+### 6. 从 uvx 迁移到 uv tool
+
+如果你之前使用 `uvx` 方式，建议迁移到 `uv tool install`：
+
+**迁移步骤：**
+1. 清理旧缓存：`uv cache clean`
+2. 安装工具：`uv tool install feedback-mcp@latest`
+3. 更新 `.mcp.json`：将 `command` 从 `"uvx"` 改为 `"feedback-mcp"`
+4. 更新 `hooks.json`：使用完整的 Python 路径
+
+详细迁移指南请参考项目中的 `MIGRATION_SUMMARY.md` 文档。
+
+## 🔍 调试模式
+
+启用调试日志：
+
+```bash
+# 设置环境变量
+export DEBUG=1
+feedback-mcp --ide qoder
+
+# 查看日志
+tail -f /path/to/feedback.log
+```
+
+## 📝 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/yourusername/interactive-feedback-mcp.git
+cd interactive-feedback-mcp
+
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行服务器
+python -m src-min.server
+```
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request!
+
+## 📄 许可证
+
+MIT License
+
+## 🔗 相关链接
+
+- [GitHub Repository](https://github.com/yourusername/interactive-feedback-mcp)
+- [MCP Documentation](https://modelcontextprotocol.io/)
+- [Issue Tracker](https://github.com/yourusername/interactive-feedback-mcp/issues)

feedback_mcp-1.0.64.dist-info/RECORD

@@ -0,0 +1,41 @@
+add_command_dialog.py,sha256=SFBlWCY5eZ9MmFOQ4Nt29ehwMY1Y8POIzeGgOnRTHzI,26281
+command.py,sha256=wC1x3KfaOi-DDy5SvIK4kN-PMZTIGYNsgilPTzQ1Us0,25936
+context_formatter.py,sha256=yt88vx-HU1LstlKMl8eh9yf8nhhTkskjimig8rw2k8Y,11458
+debug_logger.py,sha256=ZDhErmUdKMKDJMMfvKI-UtLHOaAFm9qbgtUJDuiSRts,4228
+feedback_config.py,sha256=sQzYgKYhwEDWJtlG492ickGYK2EdyBhsZdjiqRtJxSE,4142
+feedback_ui.py,sha256=eMAlEgy_aBGYp8l35qUgT1jqaU586LLz7GqliD0vUHg,67874
+get_session_id.py,sha256=NDfxazme_BgHgHkKOdo-n71MvlkRIebwPEI6h5kduGk,1809
+git_operations.py,sha256=svBodkhkfnNd4t5MwJZFvi_XRr3SdicbjSyMH1g1JMI,23871
+ide_utils.py,sha256=8KlHeQdQ1wAVctzxKBeBpKlr9wpt52WKtvArUvmESZE,8948
+path_config.py,sha256=MY43rTs19DEWbIVckGGSyA0q2NUiEHuU51L5RgFF7Vw,3274
+post_task_hook.py,sha256=nGMi9iIbq3iv7gqN1hDTYrTDdBgj6-arwTeCXXWedjw,2649
+record.py,sha256=jhZJ5lWMs1fQt9yoLZ1rj2eCqr3yGIejAhXDhBxkwUg,6417
+server.py,sha256=V7oIAj382dyfuxSAU0KZ8TBZMuGay5YaAFqHacaseg0,30385
+session_manager.py,sha256=mvvK2X2Rr1-LHT71poDZj-ZuPY3Ni5IuNbV470LxzQg,12622
+stop_hook.py,sha256=BBGzAivVTxUIcG-oAKDZCyZnvj7NctsBwCwDkX-7uaI,3052
+window_position_manager.py,sha256=4BhMDIQ2UnvTnbBzt5yQDKC7En2-8fOIDwhKfWpaNBw,6469
+workspace_manager.py,sha256=F8cxQBr3misn32w1Z4UnDMU3BETWyC0asG_af8Sejuc,7848
+components/__init__.py,sha256=MLxfbTmwIyXT0n7hgHzcKyf1mjLEAFfkQohVPju75pU,287
+components/agent_popup.py,sha256=b6bEUXXaPxHOoB-NzEg4a3H9raYO2HCSFed8HCnsfDk,5805
+components/chat_history.py,sha256=XrgE_Kh3iQN1OQ_6GP-UUBkLNnBaIXUdvDXTOftgPUc,10376
+components/command_popup.py,sha256=7me1MNg2Vm4Ue3s-bosWD8O9Fg3TS2rTF-X1f5f7KzE,15229
+components/feedback_text_edit.py,sha256=Q8qzlXzgrXXv8UBe0mHKeIXUYs8ka4rU5ceI4flZAHQ,43437
+components/file_popup.py,sha256=_gS7w7KH0jLtFo9C0IvWv4gC5cc9IvwHWnJvZ_OJtWo,14788
+components/history_popup.py,sha256=61KLCJzkkDFB4E8FPovZlX3WGAohiYIcYZJUggghX7E,19694
+components/markdown_display.py,sha256=neNfe2s8_dFkKPOnF-WQkzIvBeKD3nxxFZbuNmkUNFA,9777
+tabs/__init__.py,sha256=HPlk2eAtIQEHNpjNp5RH6wbQLvwJJOBMbSxyIPTsiA0,1559
+tabs/base_tab.py,sha256=6nYXKhrWp77ezt1Xdmu0Mod9nOafMp27wPsoBTp6-Po,781
+tabs/chat_history_style.qss,sha256=viziaHC8oluD5LJeOKXhGHVDh3JWS4PReUxvfEFbrks,1645
+tabs/chat_history_tab.py,sha256=0jrg-SoREwoq4DJ_uH6tQSRrBDCiJPRQ-N8x9VcqywA,38662
+tabs/chat_tab.py,sha256=lFfLs7b22o55A0xmznTZ8ScA295NEF9Kn6Spa6oOjeM,77921
+tabs/workspace_tab.py,sha256=FOeRJIVvGboNqmFLSnF_rcneAL0ICMT2HItuUrKr_xI,18219
+ui/__init__.py,sha256=Ci3V2esksNuam2ZpGKVqr4n7AX2mhdC39U6EcJwSlrQ,345
+ui/__main__.py,sha256=iDIR_b9SHIhWTuxgHRg4IcHNke23KWJZ2M6hsHwu_Fk,363
+ui/compact_feedback_ui.py,sha256=VjWwSiyC-9zulXQI4mbgxRNUj3ss00EQyjTg0oSdVZE,14090
+ui/session_list_ui.py,sha256=V9WrGgRC0uLuwVtAaAo5Mrkrm9zIzFfS6sBnwTswepo,30027
+ui/styles/session_list.qss,sha256=y5tt0F6fRhEDcSCHJPQQrTFAIKeSShZMmRvjTeE6gvI,3735
+feedback_mcp-1.0.64.dist-info/METADATA,sha256=5C1bLN63lyKP5NZBnQdniw3JhbnXL7SdZBOHlPKVocw,8715
+feedback_mcp-1.0.64.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+feedback_mcp-1.0.64.dist-info/entry_points.txt,sha256=sQh-GO0peid-VnYwSo9YKc-24H13o8mG4l-qLtFWoeg,45
+feedback_mcp-1.0.64.dist-info/top_level.txt,sha256=IKnj7tM3zkH5s9di3IQN4szSO-6GDc2MzOyegPCyyKo,254
+feedback_mcp-1.0.64.dist-info/RECORD,,

feedback_mcp-1.0.64.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

feedback_mcp-1.0.64.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+feedback-mcp = server:main

feedback_mcp-1.0.64.dist-info/top_level.txt

@@ -0,0 +1,20 @@
+add_command_dialog
+command
+components
+context_formatter
+debug_logger
+feedback_config
+feedback_ui
+get_session_id
+git_operations
+ide_utils
+path_config
+post_task_hook
+record
+server
+session_manager
+stop_hook
+tabs
+ui
+window_position_manager
+workspace_manager