会话数据会上传吗？

不会。本地优先设计，数据只在本地处理，这是它区别于云端分析工具的核心卖点。

distill 要花钱吗？

蒸馏要走模型调用，CLI 会先展示调用计划并征得你的同意再花，不会偷跑扣费。

刚装好、没多少会话历史能用吗？

能装，但没数据可挖；先正常用一阵编码代理攒会话，库是越用越厚的。

支持 Cursor / Windsurf 吗？

README 明确列出的是 Claude Code、Codex、kiro-cli、OpenCode，其他客户端要看会话目录格式是否兼容。

Human Hindsight：（human-hindsight）把你本地的编码代理会话历史挖一遍

19次阅读

没有评论

获取下载链

微信关注「软件教程管家」公众号，回复 human-hindsight

官方渠道：GitHub 仓库

30秒速读

用 Claude Code、Codex 写代码，最大的隐形成本是每开一个新会话都要重新解释一遍自己的工作方式——”先诊断再行动””版本要 pin 住””输出简洁点”，同样的话说了上百遍。Human Hindsight（human-hindsight）把你本地的编码代理会话历史挖一遍，蒸馏出两样东西：每个真实任务的”理想首轮提示词”库，和可以直接粘进 CLAUDE.md / AGENTS.md 的偏好规则。数据只存本地，不上传。本篇讲清三种获取方式怎么选、装完 4 项必做配置，以及它和团队提示词库的分工。

软件信息表

项目名称	Human Hindsight（human-hindsight）
npm 包名	human-hindsight（以 npm 实际版本为准；前身为 cc-hindsight，已改名）
运行方式	Node.js 命令行工具（npx 直接运行或 npm 全局安装）
适用平台	Windows / macOS / Linux（跨平台）
界面语言	英文（命令行英文交互；另有 gui 浏览器浏览模式）
数据存储	只存本地（local-first 设计，不上传会话数据）
支持的客户端	Claude Code / Codex / kiro-cli / OpenCode（README 明确列出）
数据目录	~/.human-hindsight（可用 –home 或环境变量指定）

版本选择：主力用全局安装，尝鲜用 npx

结论先行：打算长期用的直接 npm 全局安装；只想看一眼的用 npx；cc-hindsight 老用户看第三行。

获取方式	适合谁	命令	推荐
npm 全局安装	主力使用	npm install -g human-hindsight	首选
npx 临时运行	先尝鲜	npx human-hindsight@latest	尝鲜用
cc-hindsight 老用户	已有旧数据	装新版＋兼容转发包，旧库、评分、检查点继续用	老用户必看

安装步骤：只写关键卡点

先确认本机有会话数据：Claude Code 看 ~/.claude/projects/。没数据装了也挖不出东西，先正常用一阵编码代理攒会话。
跑 npx human-hindsight 做扫描（只读操作），先看它认出了哪些项目。
export 先导出人话版会话审一遍，确认理解对了再 distill 蒸馏——别跳过审阅直接蒸馏。
蒸馏会调用模型，CLI 会先展示调用计划并征得同意——看到费用确认别慌，这是正常流程。

装完必做配置（4 项）

数据目录用 –home 或 HUMAN_HINDSIGHT_HOME 固定。多设备、多身份别混库。目录优先级：–home > HUMAN_HINDSIGHT_HOME > 旧 CC_HINDSIGHT_HOME > ~/.human-hindsight。
cc-hindsight 老用户升级后检查实际读取位置。新旧目录不自动合并，新目录优先——默认读取位置可能已经换了地方，先确认再跑。
distill 前先 export 审阅。先看导出的人话版会话，确认它对你工作方式的理解是对的，再蒸馏成提示词库。
非交互场景加 –yes / –no-follow-up。脚本里跑不会卡在确认提示上，适合定时任务。

注意事项 / 常见问题

会话数据会上传吗？不会。本地优先设计，数据只在本地处理，这是它区别于云端分析工具的核心卖点。
distill 要花钱吗？蒸馏要走模型调用，CLI 会先展示调用计划并征得你的同意再花，不会偷跑扣费。
刚装好、没多少会话历史能用吗？能装，但没数据可挖；先正常用一阵编码代理攒会话，库是越用越厚的。
支持 Cursor / Windsurf 吗？README 明确列出的是 Claude Code、Codex、kiro-cli、OpenCode，其他客户端要看会话目录格式是否兼容。