1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | goutoujunshi(狗头军师) | GitHub API |
| 作者/维护者 | powerycy(个人开发者) | GitHub API |
| 来源链接 | https://github.com/powerycy/goutoujunshi | — |
| 许可证 | MIT(原为 PolyForm Noncommercial 1.0.0,2026-08-03 前后已切换为 MIT,允许商业使用) | GitHub API + CHANGELOG.md |
| GitHub Stars | 2,313 | GitHub API |
| Forks | 255 | GitHub API |
| 最新版本 | 无正式 Release/Tag,按 CHANGELOG.md 追踪,最近一次记录更新为 2026-08-03 | GitHub API |
| 安装方式 | 克隆仓库到 Agent 的 skills 目录(详见第 10 章) | README.md |
2. 功能介绍与亮点
goutoujunshi 是一个面向恋爱、约会与亲密关系场景的对话式顾问 skill。它把“先接住情绪,再分清事实,最后给可执行选择”作为核心工作流:接收用户对当前关系的叙述(或聊天截图、导出记录),先做情绪确认,再把已知事实、合理推测与关键未知分开,结合心理学、社会学、法律、婚姻家庭与性学等多学科知识库给出带理由的具体建议,最后落到一个当下能做的小动作或话术成品。
主要亮点:
- 跨学科知识库:references 目录下拆分为“知识”与“实战”两类文档,覆盖关系心理学、依恋理论、MBTI 的合理边界、沟通冲突修复、婚姻家庭法律、经典社交话术体系的机制与风险边界等十余个专题,按当前问题按需加载 1–3 份,不会一次性把整个知识库塞进上下文。
- 明确的伦理边界:SKILL.md 与
references/knowledge/05-PUA操控与伦理替代.md等文档专门划出“经典社交体系”(冷读、Blueprint、自然流、Mystery 等)中哪些手法可用、哪些属于操控——贬低、服从性测试、煤气灯、跟踪、性胁迫等被明令禁止,出现家暴、跟踪、人身威胁等场景会引导用户先确保安全、联系可信支持或紧急服务。 - 可撤销的本地长期记忆:
scripts/memory_store.py在用户首次明确同意后,把精简的关系档案保存到本机操作系统用户数据目录的 SQLite 文件中,支持随时查看、暂停、撤销与硬删除;项目本身不带服务器或账号系统,SECURITY.md 明确写明数据不应放入 Git 仓库、公共云盘或共享目录。 - 多元关系与身份支持:不预设固定性别角色或性取向,同时支持异性恋、同性恋、双性恋、跨性别及非二元性别用户,也覆盖非单偶关系等场景。
- 证据分级:知识库引用研究结论时区分“较强研究证据、理论框架、流行说法、经验策略”,MBTI、依恋类型等工具用于辅助提问和生成方案,但不包装成诊断结论。
3. 适用场景
所属分类:内容创作与知识管理(按跨学科知识库生成可执行对话策略与文本成品,产出物落在文本内容层面)。
适合以下场景与人群:
- 面对暧昧、追求、约会等场景,不知道一条消息该怎么回、想要一句可以直接发送的话术;
- 需要梳理一段关系中的投入失衡、冷淡、冲突或分手/复合决策,希望有人先接住情绪再帮忙拆解事实;
- 有聊天截图或导出记录,想弄清楚对方的行为模式与关系走向,而不是凭只言片语脑补;
- 希望在婚姻、家庭、育儿、财务等长期关系议题上,获得带跨学科依据(而非“鸡汤”)的分析框架。
4. 跨 Agent 兼容性
- Codex CLI:原生支持。README 明确将其定位为“Codex Skill”,仓库内
agents/openai.yaml提供 Codex 专属的展示层与默认提示词,安装方式为克隆到~/.codex/skills/goutoujunshi。 - Claude Code:未验证。SKILL.md 遵循标准 Agent Skills 规范(YAML front matter + 指令正文),结构上应可直接放入 Claude Code 的 skills 目录使用,但未见作者或第三方给出明确验证记录。
- OpenClaw:未验证,理由同上。
- Hermes Agent:未验证。
5. 推荐理由
在同类“AI 恋爱/关系顾问”skill 中,goutoujunshi 的知识库覆盖面(心理学、法律、社会学、人文、哲学、婚姻家庭、性学)和工作流设计(情绪优先、事实与推测分离、按需加载知识、可撤销的本地记忆)都明显更完整;项目附带独立的 SECURITY.md 与漏洞报告渠道,对“不协助操控、不诊断疾病、危险情境优先转介”等边界写得非常具体,在情感类 skill 中安全设计属于少见的高水准。README 中已有一个真实的衍生项目(见第 8 章),说明其方法论具备被独立复用的价值。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 2,313 stars、255 forks;除 GitHub 自身外,尚未见具名媒体或独立评测的深度报道 |
| 可用性 | 8 | MIT 许可、无付费依赖、无需 API key;安装为单条 git clone 命令,文档结构清晰(SKILL.md + 分层 references);2026-08-03 有实质性更新,维护活跃 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仅本地 Python 脚本 memory_store.py 用于读写本机 SQLite 记忆文件,范围明确、无越权操作 |
| ② 运行时联网外发 | 项目不含服务器/账号系统,SECURITY.md 明确声明无网络服务;核心分析流程不发起外部网络请求 |
| ③ API key / 凭据 | 无需任何 API key 或凭据;可选的 ChatLab 聊天分析为独立第三方工具,遵循其自身权限边界 |
| ④ 可疑指令(prompt injection 迹象) | 未发现;SKILL.md 与知识库文档内容均为关系分析与伦理边界说明,无夹带无关品牌/平台推广的指令 |
| ⑤ 作者/组织信誉 | 个人开发者,无刷星或 SEO 操纵迹象;单独维护 SECURITY.md 并提供私密漏洞报告渠道 |
| ⑥ License | MIT,清晰明确(历史上曾用 PolyForm Noncommercial,已于 2026-08-03 前后切换为 MIT) |
| ⑦ 最近维护 | 2026-08-03 有实质性更新,活跃维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 goutoujunshi 的差异 |
|---|---|---|
| goutoujunshi | 跨学科关系顾问,覆盖心理/法律/社会/人文/哲学/婚姻家庭/性学 | 知识面最广,且有可撤销的本地长期记忆与聊天记录结构化分析能力 |
| tong-jincheng-skill(hotcoffeeshake,2,575★) | 蒸馏“童锦程”单一视角的思维框架分析人际关系 | 聚焦一位特定风格意见领袖的判断框架,覆盖面更窄,不含独立的长期记忆或多学科知识库 |
8. 用户评价
- moondrop12138(GitHub Issue #22,2026-08):该用户基于 goutoujunshi 的知识库开发了一款独立的 Android/Windows 桌面应用“温言”,并在 issue 中说明其分析流程完整沿用了 goutoujunshi“先接住情绪→事实/推测/未知拆分→利益判断→明确建议→可执行行动”的核心方法论,同时实现了跨会话记忆档案、聊天截图双通道分析等能力,原话感谢“把这个知识库开源出来——它帮到了很多人”。
- xyz-225648(GitHub Issue #10):建议项目适配 ChatLab 聊天分析工具,该功能已在 2026-08-03 的更新中实现。
9. 其他补充
项目提供中英双语 README(README.md / README_EN.md),CONTRIBUTING.md 与 CODE_OF_CONDUCT.md 齐全,欢迎社区补充研究依据、改进话术或提交新的关系场景案例。
10. 安装使用方式
Codex CLI(官方支持路径):
git clone https://github.com/powerycy/goutoujunshi.git ~/.codex/skills/goutoujunshi
安装后在 Codex 中输入:
使用 $goutoujunshi 帮我梳理情绪、分析当前关系,并给出下一步建议。
其他 Agent Skills 兼容工具:将仓库内的 SKILL.md 与 references/ 目录整体复制到对应 agent 的 skills 目录(如 Claude Code 的 .claude/skills/),按各自 agent 的技能加载机制启用即可;由于未经作者官方验证,建议先在低风险场景下试用确认行为符合预期。
首次使用时会询问用户与关系对象的 MBTI、主观评分、认识经过等背景信息,也可以直接讲述故事,Skill 会自动整理档案;是否启用跨任务长期记忆需要用户在首次询问时明确同意,拒绝不影响正常使用。
11. 注意事项
- 项目不具备直接读取、解密或导出微信、QQ 等聊天软件数据库的能力,需要用户自行提供聊天截图、导出文本或转述内容。
- 长期记忆功能默认关闭,仅在用户首次明确同意后启用;数据保存在本机,官方建议不要将该数据库文件放入 Git 仓库、公共云盘或共享目录。
- SKILL.md 明确声明不诊断心理疾病、不替代心理治疗/医疗诊断/律师意见/警方或紧急服务;遇到家暴、跟踪、胁迫等现实危险场景时,应优先联系当地紧急服务或专业机构,而非仅依赖本 skill 的建议。
- 目前仅有作者对 Codex CLI 的官方验证,在 Claude Code / OpenClaw / Hermes Agent 上使用前建议先小范围测试。