天神走
智慧模块提取(概念验证)
一个独立的Go MCP服务器,为开发人员提供智慧引语、值得信赖的顾问和鼓舞人心的指导。从exarp项目中提取,作为对exarp模块使用编译语言(Go)的概念证明。
 ](https://golang.org/) 
🎯 项目状态
第一阶段: ✅ 完整(核心结构)\ 第2阶段: ✅ 完成(智慧数据移植-16/21本地来源)\ 第三期: ✅ 完整(顾问系统)\ 阶段4: ✅ 完成(MCP协议实施)\ 第4.5阶段: ✅ 完成(SDK迁移-2026-01-09)\ 第6阶段: ✅ 完成(随机源选择器)\ 电流相位:第5阶段(咨询记录)\ 语言:转到1.23+\ MCP-SDK:官方 modelcontextprotocol/go-sdk v1.2.0\ 类型:MCP服务器/开发人员工具
📋 快速开始
# Clone the repository
git clone
cd devwisdom-go
# Build MCP server
make build
# Build CLI
make build-cli
# Run MCP server
make run
# Run CLI commands
./devwisdom-cli quote
./devwisdom-cli consult --metric security --score 75
./devwisdom-cli briefing --days 7
# Run with watchdog (crash monitoring + file watching)
make watchdog
# Test
make test💻 CLI使用情况
这 devwisdom CLI提供了对智慧名言和顾问咨询的便捷访问。CLI可以在两种模式下运行:
- 命令行接口命令模式:从终端运行时(stdin是TTY)
- MCP服务器模式:通过stdio运行时(用于MCP集成)
构建CLI
# Build CLI binary
make build-cli
# Build both server and CLI
make build-all
# Install CLI globally
make install-cli命令
# Get a random wisdom quote (date-seeded, consistent per day)
devwisdom quote
# Get quote from specific source
devwisdom quote --source stoic
# Get quote with score context (affects aeon level selection)
devwisdom quote --source art_of_war --score 85
# Get quote in JSON format
devwisdom quote --json
# Get quote text only (quiet mode)
devwisdom quote --quiet
# Consult an advisor for a metric
devwisdom consult --metric security --score 40
# Consult an advisor for a tool
devwisdom consult --tool project_scorecard --score 75
# Consult an advisor for a workflow stage
devwisdom consult --stage daily_checkin --score 60
# List all available wisdom sources
devwisdom sources
# List sources in JSON format
devwisdom sources --json
# List all available advisors
devwisdom advisors
# List advisors in JSON format
devwisdom advisors --json
# Get daily briefing (today's wisdom)
devwisdom briefing
# Get briefing for last 7 days
devwisdom briefing --days 7
# Get briefing in JSON format
devwisdom briefing --json
# Show version
devwisdom version
# Show help
devwisdom help例子
# Quick daily wisdom
devwisdom quote
# Security advice when score is low
devwisdom consult --metric security --score 25
# Planning stage advice
devwisdom consult --stage planning --score 60
# View all Stoic quotes available
devwisdom sources --json | jq '.[] | select(.name == "stoic")'
# Get quote for high-performing project
devwisdom quote --source pistis_sophia --score 90
# Get quiet quote for scripts
QUOTE=$(devwisdom quote --quiet)
echo "Today: $QUOTE"命令选项
quote 命令:
--source SOURCE:智慧源名称(例如。,stoic,pistis_sophia,random)--score SCORE:项目健康评分(0-100),影响aeon级别选择--json:JSON格式的输出--quiet:仅输出报价文本
consult 命令:
--metric METRIC:度量名称(例如。,security,testing,documentation)--tool TOOL:工具名称(例如。,project_scorecard)--stage STAGE:舞台名称(例如。,daily_checkin,sprint_planning)--score SCORE:项目健康评分(0-100),用于度量/工具咨询--json:JSON格式的输出--quiet:仅输出报价文本
briefing 命令:
--days DAYS:要包含的天数(默认值:1)--json:JSON格式的输出
用例
每日站立:
# Get today's wisdom for team standup
devwisdom quote项目健康监测:
# Get advice based on current project score
SCORE=$(calculate-project-score)
devwisdom consult --metric security --score $SCORECI/CD集成:
# Add wisdom to build notifications
QUOTE=$(devwisdom quote --quiet)
echo "Build wisdom: $QUOTE" | send-notification文档生成:
# Generate markdown with quotes
devwisdom sources --json | jq -r '.[] | "## \(.name)\n\n\(.description)\n"'📚 有关详细的使用示例,请参阅:
快速参考
| 命令 | 描述 | 示例 |
|---|---|---|
quote | 获取智慧名言 | devwisdom quote --source stoic |
consult | 咨询顾问 | devwisdom consult --metric security --score 40 |
sources | 列出来源 | devwisdom sources |
advisors | 列出顾问 | devwisdom advisors |
briefing | 每日简报 | devwisdom briefing --days 7 |
version | 显示版本 | devwisdom version |
help | 显示帮助 | devwisdom help |
🐚 Zsh插件
安装zsh插件,以便与标签完成和帮助函数方便地进行shell集成。
安装
自动安装(推荐)
# From project root
cd zsh
./install.sh安装脚本将:
- 检测你的zsh框架(哦,我的zsh或标准zsh)
- 将插件文件复制到适当的位置
- 配置您的
~/.zshrc自动地 - 设置选项卡完成
手动安装
对于我的zsh用户:
# Create plugin directory
mkdir -p ~/.oh-my-zsh/custom/plugins/devwisdom
# Copy plugin files
cp zsh/devwisdom.plugin.zsh ~/.oh-my-zsh/custom/plugins/devwisdom/
cp zsh/_devwisdom ~/.oh-my-zsh/custom/plugins/devwisdom/
# Make completion executable
chmod +x ~/.oh-my-zsh/custom/plugins/devwisdom/_devwisdom
# Add to ~/.zshrc
echo 'plugins=(... devwisdom)' >> ~/.zshrc对于标准zsh用户:
# Create plugin directory
mkdir -p ~/.zsh/plugins/devwisdom
# Copy plugin files
cp zsh/devwisdom.plugin.zsh ~/.zsh/plugins/devwisdom/
cp zsh/_devwisdom ~/.zsh/plugins/devwisdom/
# Make completion executable
chmod +x ~/.zsh/plugins/devwisdom/_devwisdom
# Add to ~/.zshrc
cat >> ~/.zshrc # Shows: quote, consult, sources, advisors, briefing
# Tab completion for options
devwisdom quote -- # Shows: --source, --score, --json, --quiet
devwisdom consult -- # Shows: --metric, --tool, --stage, --score, --json, --quiet汽车日常智慧
在shell启动时启用自动日常智慧:
# Add to ~/.zshrc
export DEVWISDOM_AUTO_DAILY=true启用后,每次打开新的终端会话时,您都会看到每日智慧语录。
用例
日常动机:
# Add to ~/.zshrc for daily inspiration
devwisdom-daily项目健康检查:
# Quick consultation when starting work
devwisdom-consult security $(get-project-score)脚本集成:
#!/bin/zsh
# Get wisdom for automation scripts
QUOTE=$(devwisdom quote --json)
echo "Today's wisdom: $(echo $QUOTE | jq -r '.quote')"自定义别名:
# Add to ~/.zshrc
alias wisdom='devwisdom quote'
alias advice='devwisdom consult'
alias daily='devwisdom-daily'🔄 看门狗脚本
该项目包括一个监视脚本,用于监视服务器是否崩溃,并可以在文件更改时自动重新加载。
基本用法
# Monitor for crashes only
./watchdog.sh
# Watch files and reload on changes
./watchdog.sh --watch-files
# Watch files and restart on changes
./watchdog.sh --watch-files --restart-on-change
# Log to file
./watchdog.sh --watch-files --log-file watchdog.log特性
- 碰撞检测:如果服务器崩溃,则自动重新启动服务器
- 文件监视:监视器
sources.json、配置文件和Go源文件 - 热重新加载:在不完全重新启动的情况下重新加载源(如果支持)
- 自动重建:Go源文件更改时重建二进制文件
- 重启限制:可配置的最大重启尝试次数
- 优雅关闭:处理SIGTERM以实现干净停机
监视器选项
--watch-files:启用文件监视(使用fswatch在macOS上,退回到轮询)--restart-on-change:文件更改时重新启动服务器(默认值:reload)--log-file PATH:将输出记录到文件--pid-file PATH:自定义PID文件位置--max-restarts N:最大重启尝试次数(默认值:10)--restart-delay SEC:重新启动之间的延迟(默认值:2)
生成文件目标
make watchdog # Run with file watching and reload
make watchdog-restart # Run with file watching and restart on change
make watchdog-monitor # Run with crash monitoring only交叉编译
为多个平台构建二进制文件:
# Build for specific platform
make build-windows # Windows (amd64)
make build-linux # Linux (amd64, arm64)
make build-darwin # macOS (amd64, arm64)
# Build for all platforms
make build-all-platforms
# Build and package release archives
make build-release # Creates zip/tar.gz archives in dist/release/发布档案:
- 窗户:
devwisdom-{version}-windows-amd64.zip - Linux:
devwisdom-{version}-linux-{arch}.tar.gz - macOS:
devwisdom-{version}-darwin-{arch}.tar.gz
构建工件:
- 二进制文件放置在
dist/{platform}-{arch}/ - 发布档案放在
dist/release/ - 使用
make clean-dist删除所有构建工件
🔄 CI/CD
持续集成
该项目使用GitHub Actions for CI/CD:
- CI工作流 (
.github/workflows/ci.yml):
- 根据推送和拉取请求运行 - Go 1.21和1.22测试 - 用golangci棉绒织物 - 生成二进制文件以验证编译 - 上传测试覆盖率报告
- 发布工作流 (
.github/workflows/release.yml):
- 版本标签上的触发器(例如。, v1.0.0) - 为所有平台构建二进制文件: - Windows(amd64) - Linux(amd64、arm64) - macOS(amd64、arm64) - 创建包含所有工件的GitHub版本 - 自动生成发行说明
创建发布
# Create and push a version tag
git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0发布工作流将自动:
- 为所有平台构建二进制文件
- 将它们打包到发布档案中
- 创建GitHub版本
- 将所有工件附加到发布中
CI/CD状态
查看工作流状态和日志:
🏗️ 项目结构
devwisdom-go/
├── cmd/server/ # MCP server entry point
├── internal/
│ ├── wisdom/ # Wisdom engine (quotes, sources, advisors)
│ ├── mcp/ # MCP protocol handler
│ └── config/ # Configuration management
├── docs/ # Documentation
├── Makefile # Build commands
└── go.mod # Go dependencies📊 规划和状态
任务在中跟踪 举个例子 (Todo2 SQLite)。看 PROJECT_GOALS.md 用于相位分解和 PRD.md 以满足全部要求。
🚀 阶段
- ✅ 第一阶段:核心结构(完整)
- ✅ 第2阶段:智慧数据移植(16/21本地来源完整)
- ⏳ 第三期:顾问系统
- ⏳ 阶段4:MCP协议实施
- ⏳ 阶段5:咨询记录
- ✅ 第6阶段:每日随机源选择(完整)
- ⏳ 第7阶段:可选功能(Sefaria API)
- ⏳ 第8阶段:测试
- ⏳ 第9阶段:文件
- ⏳ 第10阶段:波兰和部署
📚 文档
核心文件
- 项目_高斯.md -战略阶段和目标
- PRD.md -产品需求文档(129个用户故事)
- TODO.md -按阶段划分的任务
参考文件
- docs/README.md -完整的文档索引
- docs/WATCHDOG.md -看门狗脚本文档
- docs/PERFORMANCE.md -性能分析和基准测试
- docs/MCP_SERVERS.md -MCP服务器配置指南
- docs/CURSOR_EXTENSION.md -游标扩展架构(⚠️ 未来目标-目前尚未实现)
看 docs/README.md 获取完整的文档索引。
🔗 相关
- 源:Python智慧模块
exarp项目 - MCP规范: https://modelcontextprotocol.io/
- Go文档: https://go.dev/doc/effective_go
📝 许可证
\[在此处添加您的许可证\]
👤 作者
从exarp项目中提取,作为编译语言PoC。
