zco-claude 0.0.8__py3-none-any.whl

ClaudeSettings/DOT.claudeignore

@@ -0,0 +1,7 @@
+## 默认全局忽略
+
+**/*._/
+**/_.*/
+**/*._.*
+**.bak.*
+**/__pycache__/*

ClaudeSettings/README.md

@@ -0,0 +1,100 @@
+# Claude Code 配置说明
+
+本目录包含 Claude Code 的项目配置文件。
+
+## 配置文件
+
+### `settings.json`
+项目级别的配置，包含了从以下文件转换而来的排除规则：
+- 项目的 `.gitignore`
+- 全局的 `~/.gitignore_global`
+
+该配置确保 Claude Code 在分析代码时忽略：
+- 构建产物和二进制文件
+- IDE 配置文件 (.idea, .vscode, .DS_Store)
+- 日志文件
+- 临时文件和备份
+- Python/Go 的依赖和缓存
+- 敏感配置文件 (.env, conf/app.conf)
+- 本地数据目录 (var, data, logs)
+
+## 文件说明
+
+| 文件 | 用途 | 是否提交到 Git |
+|------|------|---------------|
+| `settings.json` | 团队共享配置 | ✅ 是 |
+| `settings.local.json` | 个人本地配置 | ❌ 否 (自动忽略) |
+
+## 使用方法
+
+配置已自动生效，无需额外操作。Claude Code 将自动读取此配置。
+
+## 维护说明
+
+### 当修改 .gitignore 时
+
+由于 Claude Code 不会自动同步 `.gitignore` 的更改，当你更新项目的 `.gitignore` 或全局的 `~/.gitignore_global` 时，需要手动更新 `settings.json`。
+
+可以使用以下方法：
+
+1. **手动添加规则**
+   在 `settings.json` 的 `permissions.deny` 数组中添加新规则：
+   ```json
+   "Read(./新增目录)",
+   "Read(./新增目录/**)"
+   ```
+
+2. **请求 Claude 重新生成**
+   告诉 Claude：
+   ```
+   请重新读取 .gitignore 和 ~/.gitignore_global，更新 .claude/settings.json
+   ```
+
+### 常见排除模式
+
+```json
+{
+  "permissions": {
+    "deny": [
+      "Read(./单个文件.txt)",           // 排除单个文件
+      "Read(./目录)",                   // 排除目录
+      "Read(./目录/**)",                // 排除目录及所有子内容
+      "Read(**/*.扩展名)",              // 排除所有该扩展名文件
+      "Read(**/目录名)",                // 排除所有该名称的目录
+      "Read(**/目录名/**)"              // 排除所有该名称目录的内容
+    ]
+  }
+}
+```
+
+## 个人配置
+
+如果你有个人专属的排除需求，创建 `settings.local.json`：
+
+```bash
+cat > .claude/settings.local.json << 'EOF'
+{
+  "permissions": {
+    "deny": [
+      "Read(./my-personal-notes)",
+      "Read(./my-personal-notes/**)"
+    ]
+  }
+}
+EOF
+```
+
+该文件不会被提交到 Git（已在 .gitignore 中忽略）。
+
+## 验证配置
+
+测试配置是否生效：
+
+```bash
+# 在 Claude Code 会话中尝试读取被排除的文件
+# 应该会被阻止
+```
+
+## 更新历史
+
+- 2026-01-06: 初始配置，基于项目 .gitignore 和 ~/.gitignore_global

ClaudeSettings/commands/generate_changelog.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+
+# 获取所有 yj3d-prod.v25* tags，按时间倒序
+tags=$(git tag -l "yj3d-prod.v25*" --sort=-version:refname)
+
+# 转换为数组
+tag_array=($tags)
+
+echo "找到 ${#tag_array[@]} 个 tags"
+
+# 输出前 5 个 tag 的信息
+for i in {0..4}; do
+    if [ $i -ge ${#tag_array[@]} ]; then
+        break
+    fi
+    
+    current_tag="${tag_array[$i]}"
+    
+    # 提取版本号 (去掉 yj3d-prod.v 前缀)
+    version="${current_tag#yj3d-prod.v}"
+    
+    # 格式化版本号为 YY.MM.DD
+    formatted_version="${version:0:2}.${version:2:2}.${version:4:2}"
+    
+    echo ""
+    echo "## v${formatted_version}"
+    
+    # 获取到前一个 tag 的 commits
+    if [ $((i+1)) -lt ${#tag_array[@]} ]; then
+        prev_tag="${tag_array[$((i+1))]}"
+        
+        # 获取 commits，按类型分组
+        commits=$(git log ${prev_tag}..${current_tag} --oneline --no-merges --format="%s")
+        
+        # 分类处理
+        echo "$commits" | grep -i "^feat:" | sed 's/^feat: */- **feat**: /'
+        echo "$commits" | grep -i "^fix:" | sed 's/^fix: */- **fix**: /'
+        echo "$commits" | grep -i "^fixed:" | sed 's/^fixed: */- **fix**: /'
+        echo "$commits" | grep -i "^tofix:" | sed 's/^tofix: */- **fix**: /'
+        echo "$commits" | grep -i "^api:" | sed 's/^api: */- **api**: /'
+        echo "$commits" | grep -i "^chore:" | sed 's/^chore: */- **chore**: /'
+        echo "$commits" | grep -i "^dbm:" | sed 's/^dbm: */- **dbm**: /'
+        echo "$commits" | grep -i "^ci:" | sed 's/^ci: */- **ci**: /'
+        echo "$commits" | grep -i "^doc:" | sed 's/^doc: */- **doc**: /'
+        
+        # 其他未分类的
+        echo "$commits" | grep -iv "^feat:\|^fix:\|^fixed:\|^tofix:\|^api:\|^chore:\|^dbm:\|^ci:\|^doc:" | sed 's/^/- /'
+    fi
+done

ClaudeSettings/commands/show_env

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+"""
+Display current Claude CLI session environment variables
+
+Usage:
+    show_env              # Show filtered env vars (default)
+    show_env --all        # Show all env vars and save to _.env.txt
+
+Default filters: AN, ACCESS, YJ, CODE, CLAUDE, KEY, IN
+"""
+import os
+import sys
+import argparse
+
+
+DEFAULT_FILTERS = ['AN', 'ACCESS', 'YJ', 'CODE', 'CLAUDE', 'KEY', 'IN']
+
+
+def should_show_var(var_name, filters):
+    """Check if variable name contains any filter keyword"""
+    var_upper = var_name.upper()
+    return any(f in var_upper for f in filters)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Show Claude CLI environment variables',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  show_env              Show filtered environment variables
+  show_env --all        Show all variables and save to _.env.txt
+
+Default filters: AN, ACCESS, YJ, CODE, CLAUDE, KEY, IN
+        """
+    )
+    parser.add_argument(
+        '--all',
+        action='store_true',
+        help='Show all environment variables and save to _.env.txt'
+    )
+
+    args = parser.parse_args()
+
+    env_vars = dict(os.environ)
+
+    if args.all:
+        # Show and save all environment variables
+        output_file = '_.env.txt'
+        print("📋 All Environment Variables\n")
+
+        with open(output_file, 'w', encoding='utf-8') as f:
+            f.write("# Environment Variables\n")
+            f.write(f"# Generated: {__import__('datetime').datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n\n")
+
+            for key in sorted(env_vars.keys()):
+                line = f"{key}={env_vars[key]}"
+                print(line)
+                f.write(line + '\n')
+
+        print(f"\n✅ All {len(env_vars)} environment variables saved to: {output_file}")
+
+    else:
+        # Show filtered environment variables
+        print("🔧 Claude CLI Environment Variables (Filtered)\n")
+        print(f"Filters: {', '.join(DEFAULT_FILTERS)}\n")
+
+        shown_vars = {}
+        for key in sorted(env_vars.keys()):
+            if should_show_var(key, DEFAULT_FILTERS):
+                shown_vars[key] = env_vars[key]
+
+        if not shown_vars:
+            print("(No matching variables found)")
+        else:
+            max_key_len = max(len(k) for k in shown_vars.keys())
+            for key, value in shown_vars.items():
+                print(f"{key:<{max_key_len}} = {value}")
+
+        print(f"\n✅ Showing {len(shown_vars)} of {len(env_vars)} variables")
+        print("💡 Use --all to see all environment variables")
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\nInterrupted by user")
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)

ClaudeSettings/commands/zco-clean

@@ -0,0 +1,164 @@
+#!/usr/bin/env python3
+"""
+Clean old log files from Claude conversation history
+
+Usage:
+    zco-clean                      # Clean files older than 30 days
+    zco-clean --days 7             # Clean files older than 7 days
+    zco-clean --dir custom_logs    # Clean custom directory
+    zco-clean --dry-run            # Show what would be deleted
+
+Environment Variables:
+    YJ_CLAUDE_CHAT_SAVE_DIR: Default directory to clean (default: _.claude_hist)
+"""
+import os
+import sys
+import argparse
+from pathlib import Path
+from datetime import datetime, timedelta
+
+
+def clean_old_files(directory, days, dry_run=False):
+    """Delete files older than specified days"""
+    target_dir = Path(directory)
+
+    if not target_dir.exists():
+        print(f"❌ Error: Directory does not exist: {directory}")
+        return 0, 0
+
+    if not target_dir.is_dir():
+        print(f"❌ Error: Not a directory: {directory}")
+        return 0, 0
+
+    cutoff_date = datetime.now() - timedelta(days=days)
+
+    # Find all markdown and text files
+    all_files = list(target_dir.glob('*.md')) + list(target_dir.glob('*.txt'))
+    old_files = []
+
+    for file_path in all_files:
+        if file_path.is_file():
+            mtime = datetime.fromtimestamp(file_path.stat().st_mtime)
+            if mtime < cutoff_date:
+                old_files.append((file_path, mtime))
+
+    if not all_files:
+        print(f"ℹ️  No files found in {directory}")
+        return 0, 0
+
+    deleted_count = 0
+
+    if old_files:
+        if dry_run:
+            print(f"\n📝 Files that would be deleted:\n")
+        else:
+            print(f"\n🗑️  Deleting old files:\n")
+
+        # Sort by modification time (oldest first)
+        old_files.sort(key=lambda x: x[1])
+
+        for file_path, mtime in old_files:
+            age_days = (datetime.now() - mtime).days
+            age_str = f"({age_days} days old)"
+
+            if dry_run:
+                print(f"  - {file_path.name} {age_str}")
+            else:
+                try:
+                    file_path.unlink()
+                    print(f"  ✓ {file_path.name} {age_str}")
+                    deleted_count += 1
+                except Exception as e:
+                    print(f"  ✗ {file_path.name} - Error: {e}")
+    else:
+        print(f"\nℹ️  No files older than {days} days found")
+
+    remaining_count = len(all_files) - deleted_count
+
+    return deleted_count, remaining_count
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Clean old Claude conversation logs',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  zco-clean                     Clean default directory (30 days)
+  zco-clean --days 7            Clean files older than 7 days
+  zco-clean --dir my_logs       Clean custom directory
+  zco-clean --dry-run           Preview what would be deleted
+
+Environment Variable:
+  YJ_CLAUDE_CHAT_SAVE_DIR      Default directory (if --dir not specified)
+        """
+    )
+
+    parser.add_argument(
+        '--days',
+        type=int,
+        default=30,
+        help='Delete files older than N days (default: 30)'
+    )
+
+    parser.add_argument(
+        '--dir',
+        type=str,
+        default=None,
+        help='Directory to clean (default: YJ_CLAUDE_CHAT_SAVE_DIR or _.claude_hist)'
+    )
+
+    parser.add_argument(
+        '--dry-run',
+        action='store_true',
+        help='Show what would be deleted without actually deleting'
+    )
+
+    args = parser.parse_args()
+
+    # Validate days parameter
+    if args.days < 0:
+        print(f"❌ Error: --days must be a positive number (got: {args.days})")
+        sys.exit(1)
+
+    # Determine directory
+    if args.dir:
+        target_dir = args.dir
+    else:
+        target_dir = os.environ.get('YJ_CLAUDE_CHAT_SAVE_DIR', '_.claude_hist')
+
+    print("=" * 60)
+    print("🧹 Claude Chat Log Cleanup")
+    print("=" * 60)
+    print(f"📂 Directory: {target_dir}")
+    print(f"📅 Delete files older than: {args.days} days")
+
+    if args.dry_run:
+        print("⚠️  DRY RUN MODE (no files will be actually deleted)")
+
+    print("=" * 60)
+
+    deleted, remaining = clean_old_files(target_dir, args.days, args.dry_run)
+
+    print("\n" + "=" * 60)
+    print("📊 Summary")
+    print("=" * 60)
+    print(f"✅ {'Would delete' if args.dry_run else 'Deleted'}: {deleted} file(s)")
+    print(f"📁 Remaining: {remaining} file(s)")
+    print("=" * 60)
+
+    if args.dry_run and deleted > 0:
+        print("\n💡 Run without --dry-run to actually delete files")
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\n⚠️  Interrupted by user")
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Error: {e}", file=sys.stderr)
+        import traceback
+        traceback.print_exc(file=sys.stderr)
+        sys.exit(1)

ClaudeSettings/commands/zco-git-summary

@@ -0,0 +1,15 @@
+#!/bin/bash
+# git-summary - 显示 Git 仓库摘要
+
+echo "📊 Git Repository Summary"
+echo "========================"
+echo ""
+echo "📍 Branch: $(git branch --show-current)"
+echo "📝 Commit: $(git rev-parse --short HEAD)"
+echo "👤 Author: $(git config user.name)"
+echo ""
+echo "📈 Recent commits:"
+git log --oneline -5
+echo ""
+echo "📊 Status:"
+git status --short

ClaudeSettings/commands/zco-git-tag

@@ -0,0 +1,42 @@
+#!/bin/bash
+## desc: show git tag info
+## usage: zco-git-tag [RepoDir]
+## author: ningrong@minieye.com
+## version: v1.2024.11.24
+
+zco_git_tag_() {
+	local x_entry=${1:-$(pwd)}
+	local x_root=$(cd $x_entry && git rev-parse --show-toplevel 2>/dev/null)
+	if [[ -z "${x_root}" ]]; then
+		echo "[error]: 这不是一个仓库:" $x_entry
+		exit 1
+	fi
+	local x_commit_id=$(cd $x_root && git rev-parse --short=8 HEAD 2>/dev/null)
+	local x_branch=$(cd $x_root && git rev-parse --abbrev-ref HEAD 2>/dev/null)
+	local x_commit_dt=$(cd $x_root && git show -s --format=%cd --date=format:'%y%m%d_%H%M' 2>/dev/null)
+	#local x_dirty_st1=$(cd $x_root && git diff --staged | wc -l 2>/dev/null)
+	#local x_dirty_st=$(cd $x_root && git diff --all | wc -l 2>/dev/null)
+	local x_dirty_st1=$(cd $x_root && git diff --staged | wc -l 2>/dev/null)
+	local x_dirty_st2=$(cd $x_root && git diff | wc -l 2>/dev/null)
+	if [[ -z "${x_dirty_st1}" && -z "${x_dirty_st2}" ]]; then
+		echo "Y${x_commit_dt}.${x_commit_id}"
+	else
+		echo "Y${x_commit_dt}.${x_commit_id}.${x_branch}.X"
+	fi
+	return 0
+}
+
+############################################
+##; Run Main
+if [ $# -eq 0 ]; then
+	zco_git_tag_ $(pwd)
+elif [[ $1 == "help" || $1 == "--help" || $1 == "-h" || $# -gt 1 ]]; then
+	decho "[entry]  $0"
+	decho "[usage] show git tag info"
+	decho "[eg0]: $(basename $0) <RepoDir>"
+	if [[ $# -gt 1 ]]; then
+		exit 1
+	fi
+else
+	zco_git_tag_ $1
+fi

ClaudeSettings/hooks/CHANGELOG.md

@@ -0,0 +1,157 @@
+# Hooks 变更日志
+
+## 2026-01-06 - 增强版发布
+
+### 新增功能
+
+#### save-conversation-enhanced.py（增强版）
+
+相比标准版，新增以下功能：
+
+1. **📚 参考资源记录**
+   - 自动提取并记录所有引用的资源
+   - 支持的资源类型：
+     - 🌐 网络 URLs（WebFetch、WebSearch）
+     - 📄 本地文件路径（Read 工具）
+     - 🤖 Agent 调用（Task 工具）
+
+2. **🔧 工具调用统计**
+   - 记录使用了哪些工具
+   - 统计每个工具的调用次数
+   - 在文档头部显示摘要
+
+3. **📋 详细的工具调用记录**
+   - 在附录中记录每个工具的完整调用参数
+   - JSON 格式展示，便于调试和回溯
+
+4. **🗂️ 独立的资源列表文件**
+   - 为每次对话生成独立的资源列表文件
+   - 文件名：`{timestamp}_{keywords}_resources.txt`
+   - 便于批量处理和检索
+
+### 文件对比
+
+| 功能 | 标准版 | 增强版 |
+|------|--------|--------|
+| 保存对话内容 | ✅ | ✅ |
+| 提取关键词 | ✅ | ✅ |
+| 记录参考资源 | ❌ | ✅ |
+| 工具使用统计 | ❌ | ✅ |
+| 工具调用详情 | ❌ | ✅ |
+| 独立资源列表 | ❌ | ✅ |
+| 性能开销 | 低 | 中等 |
+
+### 输出示例
+
+#### 对话文件（26010614_API文档_生成.md）
+
+```markdown
+# Claude Code 对话记录
+
+**时间**: 2026-01-06 14:30:00
+
+## 📚 参考资源
+
+- 🤖 Agent: claude-code-guide
+- 🤖 Agent: Explore
+- 📄 /path/to/routers/router.go
+- 📄 /path/to/models/auth/jwt.go
+
+**使用工具**: 8 次
+  - Read: 5 次
+  - Task: 2 次
+  - Bash: 1 次
+
+---
+
+## 👤 用户提问 #1
+
+请为我遍历项目的 API 接口...
+
+## 🤖 Claude 回答 #1
+
+好的！我来帮你遍历...
+
+---
+
+## 📋 附录：工具调用详情
+
+### 工具 1: Task
+```json
+{
+  "subagent_type": "Explore",
+  "prompt": "探索项目 API 结构..."
+}
+```
+
+---
+*自动生成于 2026-01-06 14:30:00*
+```
+
+#### 资源列表文件（26010614_API文档_生成_resources.txt）
+
+```
+# 参考资源
+# 生成时间: 2026-01-06 14:30:00
+# 对话文件: 26010614_API文档_生成.md
+
+🤖 Agent: Explore
+🤖 Agent: claude-code-guide
+📄 /home/lane/.../routers/router.go
+📄 /home/lane/.../models/auth/jwt.go
+```
+
+### 如何切换版本
+
+编辑 `.claude/settings.json`：
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            // 标准版：
+            // "command": "python3 \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/save-conversation.py"
+
+            // 增强版（当前）：
+            "command": "python3 \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/save-conversation-enhanced.py"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 性能说明
+
+- **标准版**: 处理时间 < 100ms，适合频繁对话
+- **增强版**: 处理时间 100-300ms，适合需要详细记录的场景
+
+### 推荐使用场景
+
+#### 标准版适合：
+- 日常快速对话
+- 不需要追溯参考资源
+- 注重性能
+
+#### 增强版适合：
+- 技术研究和学习
+- 需要记录资料来源
+- 团队协作和知识分享
+- 生成可审计的对话记录
+
+---
+
+## 历史版本
+
+### v1.0 - 2026-01-06
+- 初始版本：save-conversation.py
+- 功能：基础对话保存
+
+### v2.0 - 2026-01-06（当前）
+- 增强版：save-conversation-enhanced.py
+- 新增：参考资源记录、工具调用统计、详细调用记录