返回资讯中心
外部精选
软件工程
#开发者实时流

Wisdom 推出编码智能体会话记录工具,将代码变更与意图关联

来源标题:Wisdom: A ledger of coding-agent sessions that preserve intent behind code diffs

Wisdom 推出一款本地工具,可记录 Claude Code、Codex 和 Pi 的会话,并把每次文件变更与原始请求、推理过程和执行的命令关联起来。用户可通过本地仪表盘浏览会话,其他智能体也能通过 skill 查询这些记录。工具以 npm 包 @oqura/wisdom 发布,智能体事件由 hooks 发送到本地守护进程并存入项目的 .wisdom/ 目录。

Hacker News 最新biswalswaraj882026/11/9 · 8 天前12 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Wisdom 会在你的机器上记录 Claude Code、Codex 和 Pi 的会话,并把每一次文件改动关联到产生它的请求、推理过程和命令。你可以在本地仪表盘中浏览会话,你的任何 agent 都能通过一个 skill 查询这些会话,这样下一个 agent 就能从实际提出的需求、尝试过的做法和做出的改动出发。

Git 告诉你改了什么,却不会告诉你为什么改。当 agent 编写代码时,“为什么”存在于它的会话中:你要求了什么、它尝试了什么、哪条命令失败了、它做了什么决定。每个 agent 确实会在本地保留该会话,但形式难以使用:

于是下一个 agent、审阅 PR 的同事,或者一周后的你,看到的只是代码,看不到意图。Wisdom 把这份意图和代码放在一起:

agent 自己的 hooks 会把每个事件发送到你机器上的一个小型守护进程。守护进程把它保存在项目的 .wisdom/ 文件夹中,同时保存 agent 转录文本的逐字节副本,以及它所监视文件的 diff。如果守护进程停止运行,事件会被保留下来,并在它恢复后记录;agent 永远不会被阻塞。

npm install -g @oqura/wisdom

第 2 步:连接一个项目 cd your-project wisdom connect

第 3 步:照常使用你的 agent claude # 或 codex,或 pi

会话会使用你的正常登录信息记录。用以下命令打开它们: wisdom dashboard

在一个项目中首次使用时,Codex 会要求你信任它,并在 /hooks 中批准 Wisdom 的 hooks,Pi 也会要求你信任它。在脚本被阻止的 Windows PowerShell 上,请使用 wisdom.cmd 和 npm.cmd。

Agent 测试版本 记录方式 备注 Claude Code 2.1.319 Hooks 在项目文件夹中启动它 code CLI 0.166.0 Hooks 信任项目并批准一次 hooks Pi 1.2.0 Extension 在项目文件夹中启动它,并信任项目一次

两种记录方式 wisdom connect(见上文)会使用你的正常登录信息记录 claude、codex 和 pi。它把 Wisdom 的 hook 添加到项目的 agent 设置中,并让这些文件不被 git 跟踪。Claude Code 和 Pi 在项目文件夹中启动时会被记录。 wisdom init,然后 wisdom track claude(或 codex、pi),会为每个 agent 在 .wisdom/ 中提供各自的主目录,不改动其他任何东西。每个 agent 为该项目的登录一次。用它可以把所有内容放在一个文件夹中,或者记录从子文件夹启动的会话。 详情见两种记录方式。

命令 作用 wisdom glance [latest] 列出会话,或逐轮显示一个会话 wisdom open t3 --capture latest 完整查看一轮:回复、带输出的工具调用、diff wisdom dashboard 打印本地仪表盘的地址 wisdom resume <id> 继续一个会话,仍在记录 wisdom handoff codex 启动另一个 agent,它会先读取上一个会话 wisdom share <id> / wisdom import <file> 把一个会话发送给同事,读取你收到的会话 wisdom export <id> --out session.md 把一个会话导出为 Markdown,用于 PR 或 issue wisdom doctor 检查设置,并针对每个问题打印修复方法 wisdom disconnect 停止记录一个已连接的项目;记录会保留 完整参考见 usage。

Wisdom 会在每个已连接的 agent 中放入一个 skill,教它两个动作:glance 用于查看会话的各轮,open 用于完整读取某一轮。会话可以来自任何 agent:Codex 可以读取 Claude Code 做了什么,反之亦然。问类似“哪个会话改了 tool.py,那是有意的吗?”这样的问题,agent 会找到那一轮并读取它:

t3 in Add a one-line docstring to main() in jev_router/tool.py. c4 Edit src/optim_jev/tools/jev_router/tool.py · ok · → p1 reply I added a one-line docstring to main(). p1 src/optim_jev/tools/jev_router/tool.py · modify · +2 −1 · observed during c4 def main() -> None:

  • mode = sys.argv[1] if len(sys.argv) > 1 else ""
  • """Dispatch a JSON request from stdin to the handler named by argv[1]."""
  • mode =sys.argv[1] if len(sys.argv) > 1 else ""

请求和回复都说是 docstring;diff 显示下面那一行也变了。agent 看到了改动、改动背后的请求,以及它们之间的差异。更多内容见 agents。

wisdom dashboard 会为项目中的每个会话打开一个本地查看器,agent 运行时实时更新。

一切都保存在你机器上项目的 .wisdom/ 文件夹中。Git 会忽略它,但它保存的是未脱敏的会话,所以不要把它放到共享驱动器或压缩包中。wisdom share 和 wisdom export 在写入任何内容之前,会检查 API key、token、电子邮件地址及类似信息。

早期阶段。已在 Windows、macOS 和 Linux 上测试。见 limitations 和 roadmap。

Installation · Usage · Dashboard · Agents · Harnesses · Architecture · All docs

git clone https://github.com/Oqura-ai/wisdom.git && cd wisdom npm ci && npm test

见 development 和 data policy。在此仓库上工作的 coding agent 应从 AGENTS.md 开始。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →