erlangshen 0.1.0

package/src/skills/framework.py

@@ -0,0 +1,105 @@
+"""
+分析框架 Skill
+"""
+
+from typing import Dict, Any
+
+
+class AnalysisFramework:
+    """
+    分析框架库
+    
+    提供各种专业分析框架模板
+    """
+    
+    FRAMEWORKS = {
+        "macro": {
+            "name": "宏观分析框架",
+            "description": "用于宏观经济分析的标准框架",
+            "structure": {
+                "1. 经济周期": ["GDP增速", "产出缺口", "CPI/PPI"],
+                "2. 货币金融": ["M2增速", "社融", "利率水平"],
+                "3. 财政政策": ["赤字率", "专项债", "税收"],
+                "4. 外部环境": ["出口", "汇率", "外资"],
+                "5. 政策展望": ["逆周期调节", "改革举措"]
+            }
+        },
+        "equity": {
+            "name": "股票分析框架",
+            "description": "用于个股和行业分析的标准框架",
+            "structure": {
+                "1. 行业分析": ["行业空间", "竞争格局", "景气度"],
+                "2. 公司分析": ["商业模式", "核心竞争力", "管理层"],
+                "3. 财务分析": ["盈利能力", "成长性", "现金流"],
+                "4. 估值分析": ["PE/PB", "DCF", "相对估值"],
+                "5. 风险因素": ["行业风险", "公司风险", "市场风险"]
+            }
+        },
+        "multi_asset": {
+            "name": "多资产配置框架",
+            "description": "用于大类资产配置的分析框架",
+            "structure": {
+                "1. 宏观研判": ["经济周期", "政策取向", "风险偏好"],
+                "2. 资产筛选": ["股票", "债券", "商品", "另类"],
+                "3. 相关性分析": ["资产相关性", "动态相关性"],
+                "4. 组合优化": ["风险预算", "收益预期", "约束条件"],
+                "5. 动态调整": ["再平衡", "择时", "应急计划"]
+            }
+        },
+        "risk": {
+            "name": "风险管理框架",
+            "description": "用于风险识别和评估的框架",
+            "structure": {
+                "1. 风险识别": ["市场风险", "信用风险", "流动性风险", "操作风险"],
+                "2. 风险测量": ["VaR", "ES", "波动率", "最大回撤"],
+                "3. 风险监控": ["预警指标", "限额管理", "压力测试"],
+                "4. 风险缓释": ["对冲", "分散化", "保险"]
+            }
+        },
+        "performance": {
+            "name": "业绩归因框架",
+            "description": "用于组合业绩归因的框架",
+            "structure": {
+                "1. 收益分解": ["资产配置", "个股选择", "交互效应"],
+                "2. 因子暴露": ["市场因子", "风格因子", "行业因子"],
+                "3. 风险归因": ["各类资产贡献", "各类因子贡献"],
+                "4. 基准对比": ["相对收益", "信息比率", "跟踪误差"]
+            }
+        }
+    }
+    
+    @classmethod
+    def get_framework(cls, name: str) -> Dict[str, Any]:
+        """获取指定框架"""
+        return cls.FRAMEWORKS.get(name, {})
+    
+    @classmethod
+    def list_frameworks(cls) -> list:
+        """列出所有框架"""
+        return [
+            {
+                "name": key,
+                "name_cn": value["name"],
+                "description": value["description"]
+            }
+            for key, value in cls.FRAMEWORKS.items()
+        ]
+    
+    @classmethod
+    def apply_framework(cls, framework_name: str, content: str) -> str:
+        """应用框架格式化内容"""
+        framework = cls.get_framework(framework_name)
+        
+        if not framework:
+            return content
+        
+        output = f"# {framework['name']}\n\n"
+        output += f"*{framework['description']}*\n\n"
+        
+        for section, items in framework["structure"].items():
+            output += f"## {section}\n"
+            for item in items:
+                output += f"- {item}\n"
+            output += "\n"
+        
+        return output

package/src/skills/templates.py

@@ -0,0 +1,342 @@
+"""
+报告模板 Skill
+"""
+
+from typing import Dict, Any
+from datetime import datetime
+
+
+class ReportTemplates:
+    """
+    报告模板库
+    
+    提供各种标准化的报告模板
+    """
+    
+    TEMPLATES = {
+        "daily": {
+            "name": "日报模板",
+            "description": "每日市场总结报告模板",
+            "template": """# {title}
+
+**日期**: {date}
+**分析师**: 二郎神
+
+---
+
+## 今日市场回顾
+
+### 宏观面
+- 重要经济数据：
+- 政策动向：
+
+### 市场走势
+| 指数 | 收盘价 | 涨跌幅 |
+|------|--------|--------|
+| 上证指数 | - | - |
+| 深证成指 | - | - |
+| 创业板指 | - | - |
+| 沪深300 | - | - |
+
+### 资金面
+- 成交额：
+- 北向资金：
+- 融资融券：
+
+## 热点聚焦
+
+## 明日展望
+
+## 风险提示
+
+---
+*本报告仅供参考，不构成投资建议*
+"""
+        },
+        "weekly": {
+            "name": "周报模板",
+            "description": "每周市场总结报告模板",
+            "template": """# {title}
+
+**周期**: {date}
+**分析师**: 二郎神
+
+---
+
+## 本周市场概述
+
+### 宏观环境
+- 国内经济数据：
+- 政策动态：
+- 海外市场：
+
+### 市场表现
+| 指数 | 本周涨跌幅 | 成交额变化 |
+|------|-----------|-----------|
+| 上证指数 | - | - |
+| 深证成指 | - | - |
+| 创业板指 | - | - |
+
+### 行业表现
+本周涨幅前五：
+本周跌幅前五：
+
+### 资金动向
+- 北向资金：
+- 融资余额：
+
+## 下周展望
+
+### 关注事件
+1. 
+2. 
+3. 
+
+### 投资建议
+
+## 风险提示
+
+---
+*本报告仅供参考，不构成投资建议*
+"""
+        },
+        "monthly": {
+            "name": "月度报告模板",
+            "description": "每月投资总结报告模板",
+            "template": """# {title}
+
+**期间**: {date}
+**分析师**: 二郎神
+
+---
+
+## 本月宏观经济
+
+### 经济数据
+- GDP：
+- CPI：
+- PPI：
+- PMI：
+- 社融：
+
+### 政策取向
+- 货币政策：
+- 财政政策：
+
+## 本月市场表现
+
+### 股票市场
+| 指数 | 本月涨跌幅 | 成交额 |
+|------|-----------|--------|
+| 上证指数 | - | - |
+| 深证成指 | - | - |
+| 创业板指 | - | - |
+| 沪深300 | - | - |
+
+### 债券市场
+### 商品市场
+### 外汇市场
+
+## 组合表现
+
+### 收益表现
+- 本月收益：
+- YTD收益：
+- 波动率：
+- 最大回撤：
+
+### 归因分析
+- 资产配置贡献：
+- 个券选择贡献：
+
+## 下月展望
+
+### 宏观判断
+### 市场观点
+### 配置建议
+
+## 风险提示
+
+---
+*本报告仅供参考，不构成投资建议*
+"""
+        },
+        "research": {
+            "name": "个股研究报告模板",
+            "description": "个股深度研究报告模板",
+            "template": """# {title}
+
+**股票代码**: 
+**股票名称**: 
+**报告日期**: {date}
+**分析师**: 二郎神
+
+---
+
+## 投资摘要
+
+### 核心观点
+(1-2句话概括投资逻辑)
+
+### 评级
+- 评级：
+- 目标价：
+- 当前价：
+- 上涨空间：
+
+### 投资亮点
+
+### 主要风险
+
+---
+
+## 公司概况
+
+### 主营业务
+### 发展历程
+### 股权结构
+
+## 行业分析
+
+### 行业空间
+### 竞争格局
+### 发展趋势
+
+## 业务分析
+
+### 业务结构
+### 核心竞争力
+### 成长性分析
+
+## 财务分析
+
+### 盈利能力
+| 指标 | 2021 | 2022 | 2023 | 2024E |
+|------|------|------|------|--------|
+| 营收(亿) | - | - | - | - |
+| 净利润(亿) | - | - | - | - |
+| 毛利率 | - | - | - | - |
+| 净利率 | - | - | - | - |
+
+### 成长性
+### 现金流
+### 资产负债
+
+## 估值分析
+
+### 相对估值
+### 绝对估值
+### 估值结论
+
+## 风险提示
+
+1. 
+2. 
+3. 
+
+## 投资建议
+
+---
+*本报告仅供参考，不构成投资建议*
+"""
+        },
+        "strategy": {
+            "name": "策略报告模板",
+            "description": "投资策略报告模板",
+            "template": """# {title}
+
+**类型**: {date}
+**分析师**: 二郎神
+
+---
+
+## 核心观点
+
+## 宏观背景
+
+### 经济周期
+### 政策环境
+### 外部环境
+
+## 市场判断
+
+### 股票市场
+### 债券市场
+### 商品市场
+### 外汇市场
+
+## 资产配置建议
+
+### 战略配置
+| 资产类别 | 配置比例 | 变化 |
+|----------|---------|------|
+| 股票 | - | - |
+| 债券 | - | - |
+| 商品 | - | - |
+| 现金 | - | - |
+
+### 战术调整
+
+## 行业配置
+
+### 超配行业
+### 低配行业
+### 规避行业
+
+## 风险提示
+
+## 跟踪指标
+
+---
+*本报告仅供参考，不构成投资建议*
+"""
+        }
+    }
+    
+    @classmethod
+    def get_template(cls, template_name: str) -> Dict[str, Any]:
+        """获取指定模板"""
+        template = cls.TEMPLATES.get(template_name, {})
+        
+        if not template:
+            return {}
+        
+        # 填充模板
+        filled = template["template"].format(
+            title="标题",
+            date=datetime.now().strftime("%Y年%m月%d日")
+        )
+        
+        return {
+            "name": template["name"],
+            "description": template["description"],
+            "template": filled
+        }
+    
+    @classmethod
+    def list_templates(cls) -> list:
+        """列出所有模板"""
+        return [
+            {
+                "id": key,
+                "name": value["name"],
+                "description": value["description"]
+            }
+            for key, value in cls.TEMPLATES.items()
+        ]
+    
+    @classmethod
+    def render_template(cls, template_name: str, **kwargs) -> str:
+        """渲染模板"""
+        template = cls.TEMPLATES.get(template_name)
+        
+        if not template:
+            return ""
+        
+        defaults = {
+            "title": kwargs.get("title", "报告标题"),
+            "date": kwargs.get("date", datetime.now().strftime("%Y年%m月%d日"))
+        }
+        defaults.update(kwargs)
+        
+        return template["template"].format(**defaults)

package/src/tools/__init__.py

@@ -0,0 +1 @@
+"""Tools: market, macro, search, file"""

package/src/tools/file_tools.py

@@ -0,0 +1,209 @@
+"""
+File Tools - 文件/报告工具
+知识沉淀、纪要写入、报告生成
+"""
+import os
+from pathlib import Path
+from typing import Optional
+from datetime import datetime
+from loguru import logger
+
+
+class FileTools:
+    """
+    文件工具集
+
+    工具函数：
+    - write_memo: 写入纪要
+    - write_report: 写入报告
+    - search_knowledge: 搜索知识库
+    - append_insight: 追加洞察
+    """
+
+    def __init__(self, base_path: Optional[str] = None):
+        if base_path is None:
+            base_path = Path.home() / ".openclaw-agent-06" / "workspace" / "erlangshen" / "knowledge"
+        self.base_path = Path(base_path)
+        self.memos_path = self.base_path / "memos"
+        self.reports_path = self.base_path / "reports"
+        self.insights_path = self.base_path / "insights"
+
+        for p in [self.memos_path, self.reports_path, self.insights_path]:
+            p.mkdir(parents=True, exist_ok=True)
+
+        logger.info(f"FileTools initialized at {self.base_path}")
+
+    async def execute(self, tool_name: str, **kwargs) -> any:
+        """执行指定工具"""
+        method = getattr(self, tool_name, None)
+        if method and callable(method):
+            return await method(**kwargs)
+        return {"error": f"Unknown tool: {tool_name}"}
+
+    async def write_memo(
+        self,
+        content: str,
+        title: Optional[str] = None,
+    ) -> dict:
+        """
+        写入纪要
+
+        Args:
+            content: 纪要内容
+            title: 标题
+
+        Returns:
+            dict 操作结果
+        """
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        title_str = title or "memo"
+        filename = f"{timestamp}_{title_str}.md"
+        filepath = self.memos_path / filename
+
+        try:
+            filepath.write_text(content, encoding="utf-8")
+            logger.info(f"Wrote memo: {filename}")
+            return {
+                "status": "success",
+                "filename": filename,
+                "path": str(filepath),
+            }
+        except Exception as e:
+            logger.error(f"Failed to write memo: {e}")
+            return {"status": "error", "message": str(e)}
+
+    async def write_report(
+        self,
+        content: str,
+        title: str,
+        tags: Optional[list[str]] = None,
+    ) -> dict:
+        """
+        写入报告
+
+        Args:
+            content: 报告内容
+            title: 标题
+            tags: 标签
+
+        Returns:
+            dict 操作结果
+        """
+        timestamp = datetime.now().strftime("%Y%m%d")
+        filename = f"{timestamp}_{title}.md"
+        filepath = self.reports_path / filename
+
+        try:
+            # 添加元数据头
+            header = f"""---
+title: {title}
+date: {datetime.now().isoformat()}
+tags: {tags or []}
+---
+
+"""
+            filepath.write_text(header + content, encoding="utf-8")
+            logger.info(f"Wrote report: {filename}")
+            return {
+                "status": "success",
+                "filename": filename,
+                "path": str(filepath),
+            }
+        except Exception as e:
+            logger.error(f"Failed to write report: {e}")
+            return {"status": "error", "message": str(e)}
+
+    async def append_insight(
+        self,
+        insight: str,
+        category: str = "general",
+    ) -> dict:
+        """
+        追加洞察到洞察文件
+
+        Args:
+            insight: 洞察内容
+            category: 分类
+
+        Returns:
+            dict 操作结果
+        """
+        timestamp = datetime.now().strftime("%Y%m%d")
+        filename = f"insights_{timestamp}.md"
+        filepath = self.insights_path / filename
+
+        try:
+            content = f"""# 洞察 {datetime.now().strftime("%Y-%m-%d %H:%M")}
+
+**分类**: {category}
+
+{insight}
+
+---
+"""
+            filepath.write_text(content, encoding="utf-8")
+            logger.info(f"Appended insight: {filename}")
+            return {
+                "status": "success",
+                "filename": filename,
+                "path": str(filepath),
+            }
+        except Exception as e:
+            logger.error(f"Failed to append insight: {e}")
+            return {"status": "error", "message": str(e)}
+
+    async def search_knowledge(
+        self,
+        query: str,
+        path: Optional[str] = None,
+    ) -> list[str]:
+        """
+        搜索知识库文件
+
+        Args:
+            query: 搜索关键词
+            path: 搜索路径
+
+        Returns:
+            list[str] 匹配的文件列表
+        """
+        search_path = Path(path) if path else self.base_path
+        results = []
+        query_lower = query.lower()
+
+        try:
+            for filepath in search_path.rglob("*.md"):
+                try:
+                    content = filepath.read_text(encoding="utf-8").lower()
+                    if query_lower in content:
+                        results.append(str(filepath))
+                except Exception:
+                    continue
+        except Exception as e:
+            logger.error(f"Search failed: {e}")
+
+        return results
+
+    async def list_memos(self) -> list[dict]:
+        """列出所有纪要"""
+        memos = []
+        for f in sorted(self.memos_path.glob("*.md"), reverse=True):
+            memos.append({
+                "name": f.name,
+                "path": str(f),
+                "size": f.stat().st_size,
+                "modified": datetime.fromtimestamp(f.stat().st_mtime).isoformat(),
+            })
+        return memos
+
+    async def list_reports(self) -> list[dict]:
+        """列出所有报告"""
+        reports = []
+        for f in sorted(self.reports_path.glob("*.md"), reverse=True):
+            reports.append({
+                "name": f.name,
+                "path": str(f),
+                "size": f.stat().st_size,
+                "modified": datetime.fromtimestamp(f.stat().st_mtime).isoformat(),
+            })
+        return reports