[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ericjang--tdb":3,"tool-ericjang--tdb":61},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":24,"last_commit_at":59,"category_tags":60,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":76,"owner_url":77,"languages":78,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":99,"env_os":100,"env_gpu":101,"env_ram":101,"env_deps":102,"category_tags":111,"github_topics":75,"view_count":24,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":112,"updated_at":113,"faqs":114,"releases":115},10123,"ericjang\u002Ftdb","tdb","Interactive, node-by-node debugging and visualization for TensorFlow","TDB（TensorDebugger）是一款专为 TensorFlow 打造的交互式可视化调试工具。它允许开发者在深度神经网络的计算图中设置断点，实时观察数据在节点间的流动情况，就像给复杂的模型训练过程装上了“显微镜”。\n\n面对现代深度学习模型参数复杂、内部逻辑难以直观理解的痛点，TDB 有效解决了训练过程中 bug 难定位、超参数调整靠猜的难题。通过提供运行时可视化能力，它能帮助用户更早发现梯度消失、权重饱和等异常，从而大幅缩短模型迭代与调优的时间。\n\n这款工具特别适合从事深度学习算法研发的工程师、科研人员以及需要深入理解神经网络内部机制的学生。其核心技术亮点在于将 Python 库与 Jupyter Notebook 扩展无缝结合，不仅支持像传统代码调试那样单步执行和暂停，还允许用户自定义绘图函数，实时生成直方图或梯度幅度等高级统计图表。尽管目前该项目已停止主动维护，建议新用户关注官方 tfdbg，但 TDB 提出的“节点级调试 + 实时可视化”理念，依然是理解神经网络如何学习的宝贵参考。","# TDB\n\n*Note: This project is no longer actively being maintained. Please check out the official [tfdbg debugger](https:\u002F\u002Fwww.tensorflow.org\u002Fversions\u002Fmaster\u002Fhow_tos\u002Fdebugger\u002F)\n\nTensorDebugger (TDB) is a visual debugger for deep learning. It extends [TensorFlow](https:\u002F\u002Fwww.tensorflow.org\u002F) (Google's Deep Learning framework) with breakpoints + real-time visualization of the data flowing through the computational graph.\n\n[Video Demo](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VcoVEvGEmFM)\n\n\u003Cimg src=\"http:\u002F\u002Fi.imgur.com\u002Fn0PmXQn.gif\"\u002F>\n\nSpecifically, TDB is the combination of a Python library and a Jupyter notebook extension, built around Google's TensorFlow framework. Together, these extend TensorFlow with the following features:\n\n- **Breakpoints**: Set breakpoints on Ops and Tensors in the graph. Graph execution is paused on breakpoints and resumed by the user (via `tdb.c()`) Debugging features can be used with or without the visualization frontend.\n- **Arbitrary Summary Plots**: Real-time visualization of high-level information (e.g. histograms, gradient magnitudes, weight saturation) while the network is being trained. Supports arbitrary, user-defined plot functions.\n- **Flexible**: Mix user-defined Python and plotting functions with TensorFlow Nodes. These take in `tf.Tensors` and output placeholder nodes to be plugged into TensorFlow nodes. The below diagram illustrates how TDB nodes can be mixed with the TensorFlow graph.\n\n![heterogenous](http:\u002F\u002Fi.imgur.com\u002F7xfA6Pg.png?1)\n\n\n## Motivations\n\nModern machine learning models are parametrically complex and require considerable intuition to fine-tune properly.\n\nIn particular, Deep Learning methods are especially powerful, but hard to interpret in regards to their capabilities and learned representations.\n\nCan we enable better understanding of how neural nets learn, without having to change model code or sacrifice performance? Can I finish my thesis on time?\n\nTDB addresses these challenges by providing run-time visualization tools for neural nets. Real-time visual debugging allows training bugs to be detected sooner, thereby reducing the iteration time needed to build the right model.\n\n## Setup\n\nTo install the Python library,\n\n```bash\npip install tfdebugger\n```\n\nTo install the Jupyter Notebook extension, run the following in a Python terminal (you will need to have IPython or [Jupyter](https:\u002F\u002Fjupyter.readthedocs.org\u002Fen\u002Flatest\u002Finstall.html) installed)\n\n```python\nimport notebook.nbextensions\nimport urllib\nimport zipfile\nSOURCE_URL = 'https:\u002F\u002Fgithub.com\u002Fericjang\u002Ftdb\u002Freleases\u002Fdownload\u002Ftdb_ext_v0.1\u002Ftdb_ext.zip'\nurllib.urlretrieve(SOURCE_URL, 'tdb_ext.zip')\nwith zipfile.ZipFile('tdb_ext.zip', \"r\") as z:\n    z.extractall(\"\")\nnotebook.nbextensions.install_nbextension('tdb_ext',user=True)\n```\n\n## Tutorial\n\nTo get started, check out the [MNIST Visualization Demo](notebooks\u002Fmnist_demo.ipynb). More examples and visualizations to come soon.\n\n## User Guide\n\n### Debugging\n\n#### Start \n```python\nstatus,result=tdb.debug(evals,feed_dict=None,breakpoints=None,break_immediately=False,session=None)\n```\n\n`debug()` behaves just like Tensorflow's Session.run(). If a breakpoint is hit, `status` is set to 'PAUSED' and `result` is set to `None`. Otherwise, `status` is set to 'FINISHED' and `result` is set to a list of evaluated values.\n\n#### Continue\n```python\nstatus,result=tdb.c()\n```\n\nContinues execution of a paused session, until the next breakpoint or end. Behaves like `debug`.\n\n\n#### Step\n```python\nstatus,result=tdb.s()\n```\n\nEvaluate the next node, then pause immediately to await user input. Unless we have reached the end of the execution queue, `status` will remain 'PAUSED'. `result` is set to the value of the node we just evaluated.\n\n#### Where\n\n```python\nq=tdb.get_exe_queue()\n```\n\nReturn value: list of remaining nodes to be evaluated, in order.\n\n#### print\n\n```python\nval=tdb.get_value(node)\n```\n\nReturns value of an evaluated node (a string name or a tf.Tensor)\n\n### Custom Nodes\n\nTDB supports 2 types of custom Ops:\n\n#### Python\n\nHere is an example of mixing tdb.PythonOps with TensorFlow.\n\nDefine the following function:\n```\ndef myadd(ctx,a,b):\n\treturn a+b\n```\n\n```python\na=tf.constant(2)\nb=tf.constant(3)\nc=tdb.python_op(myadd,inputs=[a,b],outputs=[tf.placeholder(tf.int32)]) # a+b\nd=tf.neg(c)\nstatus,result=tdb.debug([d], feed_dict=None, breakpoints=None, break_immediately=False)\t\n```\n\nWhen `myadd` gets evaluated, `ctx` is the instance of the PythonOp that it belongs to. You can use ctx to store state information (i.e. accumulate loss history).\n\n#### Plotting\n\nPlotOps are a special instance of PythonOp that send graphical output to the frontend.\n\nThis only works with Matplotlib at the moment, but other plotting backends (Seaborn, Bokeh, Plotly) are coming soon.\n\n```python\ndef watch_loss(ctx,loss):\n  if not hasattr(ctx, 'loss_history'):\n    ctx.loss_history=[]\n  ctx.loss_history.append(loss)\n  plt.plot(ctx.loss_history)\n  plt.ylabel('loss')\n```\n\n```python\nploss=tdb.plot_op(viz.watch_loss,inputs=[loss])\n```\n\nRefer to the [MNIST Visualization Demo](notebooks\u002Fmnist_demo.ipynb) for more examples. You can also find more examples in the [tests\u002F](tdb\u002Ftests) directory.\n\n## FAQ\n\n### Is TDB affiliated with TensorFlow?\n\nNo, but it is built on top of it.\n\n### What is TDB good for?\n\nTDB is especially useful at the model prototyping stage and verifying correctness in an intuitive manner. It is also useful for high-level visualization of hidden layers during training.\n\n### How is TDB different from TensorBoard?\n\nTensorBoard is a suite of visualization tools included with Tensorflow. Both TDB and TensorBoard attach auxiliary nodes to the TensorFlow graph in order to inspect data.\n\nTensorBoard cannot be used concurrently with running a TensorFlow graph; log files must be written first. TDB interfaces directly with the execution of a TensorFlow graph, and allows for stepping through execution one node at a time.\n\nOut of the box, TensorBoard currently only supports logging for a few predefined data formats. \n\nTDB is to TensorBoard as GDB is to printf. Both are useful in different contexts.\n\n\n\n## License\n\nApache 2.0\n\n\n","# TDB\n\n*注意：该项目已不再积极维护。请查看官方的 [tfdbg 调试器](https:\u002F\u002Fwww.tensorflow.org\u002Fversions\u002Fmaster\u002Fhow_tos\u002Fdebugger\u002F)\n\nTensorDebugger (TDB) 是一个用于深度学习的可视化调试器。它通过断点和对计算图中流动数据的实时可视化，扩展了 [TensorFlow](https:\u002F\u002Fwww.tensorflow.org\u002F)（Google 的深度学习框架）的功能。\n\n[视频演示](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VcoVEvGEmFM)\n\n\u003Cimg src=\"http:\u002F\u002Fi.imgur.com\u002Fn0PmXQn.gif\"\u002F>\n\n具体来说，TDB 是由一个 Python 库和一个 Jupyter Notebook 扩展组成的，基于 Google 的 TensorFlow 框架构建。它们共同为 TensorFlow 增加了以下功能：\n\n- **断点**：可以在图中的 Op 和 Tensor 上设置断点。当遇到断点时，图的执行会被暂停，用户可以通过 `tdb.c()` 来恢复执行。调试功能可以单独使用，也可以与可视化前端结合使用。\n- **任意摘要绘图**：在网络训练过程中，实时可视化高层次信息（例如直方图、梯度大小、权重饱和度等）。支持用户自定义的绘图函数。\n- **灵活性**：可以将用户自定义的 Python 函数和绘图函数与 TensorFlow 节点混合使用。这些函数接收 `tf.Tensor` 作为输入，并输出占位符节点，以便插入到 TensorFlow 节点中。下图展示了 TDB 节点如何与 TensorFlow 图混合使用。\n\n![heterogenous](http:\u002F\u002Fi.imgur.com\u002F7xfA6Pg.png?1)\n\n\n## 动机\n\n现代机器学习模型在参数上非常复杂，需要大量的直觉才能正确地进行调优。\n\n特别是深度学习方法，虽然功能强大，但在理解其能力和学习到的表示方面却非常困难。\n\n我们能否在不修改模型代码或牺牲性能的情况下，更好地理解神经网络的学习过程呢？我还能按时完成论文吗？\n\nTDB 通过提供神经网络的运行时可视化工具来应对这些挑战。实时可视化调试能够更早地发现训练中的错误，从而减少构建正确模型所需的迭代时间。\n\n## 安装\n\n要安装 Python 库，\n\n```bash\npip install tfdebugger\n```\n\n要安装 Jupyter Notebook 扩展，请在 Python 终端中运行以下命令（您需要先安装 IPython 或 [Jupyter](https:\u002F\u002Fjupyter.readthedocs.org\u002Fen\u002Flatest\u002Finstall.html)）\n\n```python\nimport notebook.nbextensions\nimport urllib\nimport zipfile\nSOURCE_URL = 'https:\u002F\u002Fgithub.com\u002Fericjang\u002Ftdb\u002Freleases\u002Fdownload\u002Ftdb_ext_v0.1\u002Ftdb_ext.zip'\nurllib.urlretrieve(SOURCE_URL, 'tdb_ext.zip')\nwith zipfile.ZipFile('tdb_ext.zip', \"r\") as z:\n    z.extractall(\"\")\nnotebook.nbextensions.install_nbextension('tdb_ext',user=True)\n```\n\n## 教程\n\n要开始使用，请查看 [MNIST 可视化演示](notebooks\u002Fmnist_demo.ipynb)。更多示例和可视化内容即将推出。\n\n## 用户指南\n\n### 调试\n\n#### 启动\n```python\nstatus,result=tdb.debug(evals,feed_dict=None,breakpoints=None,break_immediately=False,session=None)\n```\n\n`debug()` 的行为与 TensorFlow 的 Session.run() 完全相同。如果命中断点，则 `status` 会被设置为 'PAUSED'，`result` 会被设置为 `None`。否则，`status` 会被设置为 'FINISHED'，`result` 则是一个包含所有评估值的列表。\n\n#### 继续\n```python\nstatus,result=tdb.c()\n```\n\n继续执行已暂停的会话，直到下一个断点或结束。行为与 `debug` 相同。\n\n#### 单步\n```python\nstatus,result=tdb.s()\n```\n\n评估下一个节点，然后立即暂停以等待用户输入。除非已经到达执行队列的末尾，否则 `status` 将保持为 'PAUSED'。`result` 会被设置为刚刚评估的节点的值。\n\n#### 查看剩余节点\n```python\nq=tdb.get_exe_queue()\n```\n\n返回值：按顺序排列的待评估节点列表。\n\n#### 打印节点值\n```python\nval=tdb.get_value(node)\n```\n\n返回已评估节点的值（字符串名称或 `tf.Tensor`）。\n\n### 自定义节点\n\nTDB 支持两种类型的自定义 Op：\n\n#### Python\n以下是一个将 tdb.PythonOps 与 TensorFlow 混合使用的示例。\n\n定义如下函数：\n```\ndef myadd(ctx,a,b):\n\treturn a+b\n```\n\n```python\na=tf.constant(2)\nb=tf.constant(3)\nc=tdb.python_op(myadd,inputs=[a,b],outputs=[tf.placeholder(tf.int32)]) # a+b\nd=tf.neg(c)\nstatus,result=tdb.debug([d], feed_dict=None, breakpoints=None, break_immediately=False)\t\n```\n\n当 `myadd` 被评估时，`ctx` 是它所属的 PythonOp 实例。您可以使用 ctx 来存储状态信息（例如累计损失历史）。\n\n#### 绘图\nPlotOps 是一种特殊的 PythonOp，它可以将图形输出发送到前端。\n\n目前仅支持 Matplotlib，但其他绘图后端（Seaborn、Bokeh、Plotly）也将很快推出。\n\n```python\ndef watch_loss(ctx,loss):\n  if not hasattr(ctx, 'loss_history'):\n    ctx.loss_history=[]\n  ctx.loss_history.append(loss)\n  plt.plot(ctx.loss_history)\n  plt.ylabel('loss')\n```\n\n```python\nploss=tdb.plot_op(viz.watch_loss,inputs=[loss])\n```\n\n更多示例请参阅 [MNIST 可视化演示](notebooks\u002Fmnist_demo.ipynb)。您还可以在 [tests\u002F](tdb\u002Ftests) 目录中找到更多示例。\n\n## 常见问题\n\n### TDB 是否隶属于 TensorFlow？\n\n不是，但它构建在 TensorFlow 之上。\n\n### TDB 适合用于什么场景？\n\nTDB 在模型原型设计阶段以及以直观的方式验证正确性时特别有用。它也适用于在训练过程中对隐藏层进行高层次的可视化。\n\n### TDB 与 TensorBoard 有何不同？\n\nTensorBoard 是 TensorFlow 自带的一套可视化工具。TDB 和 TensorBoard 都会在 TensorFlow 图上附加辅助节点来检查数据。\n\nTensorBoard 不能与正在运行的 TensorFlow 图同时使用；必须先写入日志文件。而 TDB 则可以直接与 TensorFlow 图的执行交互，并允许逐个节点地单步执行。\n\n开箱即用时，TensorBoard 目前仅支持几种预定义数据格式的日志记录。\n\nTDB 之于 TensorBoard，正如 GDB 之于 printf。两者在不同的场景下都很有用。\n\n\n\n## 许可证\n\nApache 2.0","# TDB 快速上手指南\n\n> **注意**：本项目已不再积极维护。如需生产环境调试，建议参考官方 [tfdbg debugger](https:\u002F\u002Fwww.tensorflow.org\u002Fversions\u002Fmaster\u002Fhow_tos\u002Fdebugger\u002F)。本指南仅供学习或遗留项目参考。\n\nTDB (TensorDebugger) 是一个专为深度学习设计的可视化调试器，它扩展了 TensorFlow，支持断点调试和计算图中数据流的实时可视化。\n\n## 环境准备\n\n- **操作系统**：Linux \u002F macOS \u002F Windows\n- **Python 版本**：推荐 Python 2.7 或 Python 3.5+（取决于你的 TensorFlow 版本）\n- **前置依赖**：\n  - [TensorFlow](https:\u002F\u002Fwww.tensorflow.org\u002F)\n  - [Jupyter Notebook](https:\u002F\u002Fjupyter.readthedocs.org\u002Fen\u002Flatest\u002Finstall.html) 或 IPython\n  - `matplotlib` (用于绘图功能)\n  - `pip` 包管理工具\n\n## 安装步骤\n\n### 1. 安装 Python 库\n\n使用 pip 安装核心库：\n\n```bash\npip install tfdebugger\n```\n\n*(国内用户如遇下载缓慢，可尝试指定清华镜像源：`pip install tfdebugger -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple`)*\n\n### 2. 安装 Jupyter Notebook 扩展\n\n在 Python 终端（命令行输入 `python` 进入）中运行以下代码以安装前端扩展：\n\n```python\nimport notebook.nbextensions\nimport urllib\nimport zipfile\n\n# 下载扩展包\nSOURCE_URL = 'https:\u002F\u002Fgithub.com\u002Fericjang\u002Ftdb\u002Freleases\u002Fdownload\u002Ftdb_ext_v0.1\u002Ftdb_ext.zip'\nurllib.urlretrieve(SOURCE_URL, 'tdb_ext.zip')\n\n# 解压并安装\nwith zipfile.ZipFile('tdb_ext.zip', \"r\") as z:\n    z.extractall(\"\")\nnotebook.nbextensions.install_nbextension('tdb_ext', user=True)\n```\n\n*注：如果使用 Python 3，可能需要将 `import urllib` 改为 `import urllib.request` 并调整 `urlretrieve` 的调用方式，或者手动下载 zip 包后解压安装。*\n\n## 基本使用\n\nTDB 的使用方式与 TensorFlow 原生的 `Session.run()` 非常相似，但增加了断点和步进功能。\n\n### 1. 启动调试 (Debug)\n\n使用 `tdb.debug()` 替代 `session.run()`。如果命中断点，执行会暂停并返回状态 `'PAUSED'`。\n\n```python\nimport tdb\nimport tensorflow as tf\n\n# 定义简单的计算图\na = tf.constant(2)\nb = tf.constant(3)\nc = a + b\n\n# 启动调试\n# evals: 需要计算的节点列表\n# breakpoints: 可选，设置断点的节点名称列表\nstatus, result = tdb.debug(evals=[c], feed_dict=None, breakpoints=None)\n\nif status == 'PAUSED':\n    print(\"调试已暂停\")\nelse:\n    print(\"计算结果:\", result)\n```\n\n### 2. 继续执行 (Continue)\n\n当调试暂停时，使用 `tdb.c()` 继续运行直到下一个断点或结束。\n\n```python\nstatus, result = tdb.c()\n```\n\n### 3. 单步执行 (Step)\n\n使用 `tdb.s()` 执行下一个节点并立即暂停，适合逐节点排查问题。\n\n```python\nstatus, result = tdb.s()\n# result 包含刚刚执行过的节点的值\n```\n\n### 4. 查看当前队列与数值\n\n- 查看剩余待执行节点：\n  ```python\n  queue = tdb.get_exe_queue()\n  ```\n\n- 获取特定节点的值：\n  ```python\n  val = tdb.get_value(node_name_or_tensor)\n  ```\n\n### 5. 自定义绘图监控\n\n你可以定义函数来实时监控训练指标（如 Loss），并将其作为节点插入图中。\n\n```python\nimport matplotlib.pyplot as plt\nimport tdb\n\ndef watch_loss(ctx, loss_val):\n    if not hasattr(ctx, 'loss_history'):\n        ctx.loss_history = []\n    ctx.loss_history.append(loss_val)\n    \n    plt.clf() # 清空画布\n    plt.plot(ctx.loss_history)\n    plt.ylabel('loss')\n    plt.pause(0.01) # 短暂暂停以刷新图像\n\n# 假设 loss 是一个 TensorFlow Tensor\n# ploss = tdb.plot_op(watch_loss, inputs=[loss])\n# 将 ploss 加入你的 fetch 列表中进行调试\n```\n\n更多详细示例请参考项目自带的 [MNIST Visualization Demo](notebooks\u002Fmnist_demo.ipynb)。","一位深度学习工程师正在训练一个复杂的卷积神经网络进行图像分类，但模型在训练初期就出现了梯度消失导致准确率无法提升的问题。\n\n### 没有 tdb 时\n- 开发者只能依赖传统的 `print` 语句或静态日志来猜测数据流向，无法实时看到中间层张量的具体数值分布。\n- 当遇到梯度异常时，必须反复修改代码、重新编译并重启整个耗时的训练过程才能验证假设，迭代周期极长。\n- 面对庞大的计算图，难以定位具体是哪个算子（Op）导致了数值饱和或变为 NaN，排查过程如同“盲人摸象”。\n- 缺乏直观的可视化手段，无法动态观察权重直方图或梯度幅值的变化趋势，全靠经验盲调超参数。\n\n### 使用 tdb 后\n- 利用 tdb 的断点功能，工程师可以在特定网络层暂停执行，直接 inspect 该节点的实时输出直方图，瞬间发现激活值全部趋近于零。\n- 通过 `tdb.s()` 单步执行模式，逐节点追踪计算流程，无需重启训练即可精确定位到引发梯度消失的具体卷积核操作。\n- 结合 Jupyter 扩展，直接在笔记本中混合编写自定义绘图函数，实时可视化任意层的梯度幅值变化，动态调整策略立竿见影。\n- 在训练过程中随时挂起会话，检查中间变量状态，将原本需要数小时的“修改 - 重训”循环缩短为几分钟的交互式调试。\n\ntdb 通过将传统的黑盒训练过程转化为可视化的交互式调试体验，帮助开发者在分钟级内定位并修复深层网络的训练故障。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fericjang_tdb_7418f213.png","ericjang","Eric Jang","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fericjang_e316b39b.jpg",null,"http:\u002F\u002Fevjang.com","https:\u002F\u002Fgithub.com\u002Fericjang",[79,83,87,91],{"name":80,"color":81,"percentage":82},"JavaScript","#f1e05a",90.3,{"name":84,"color":85,"percentage":86},"Python","#3572A5",6.7,{"name":88,"color":89,"percentage":90},"Jupyter Notebook","#DA5B0B",3.1,{"name":92,"color":93,"percentage":94},"Shell","#89e051",0,1350,140,"2026-04-07T13:58:18","Apache-2.0",4,"","未说明",{"notes":103,"python":104,"dependencies":105},"该项目已不再积极维护，建议改用官方 TensorFlow 调试器 (tfdbg)。安装需要手动下载并配置 Jupyter Notebook 扩展。目前绘图功能仅支持 Matplotlib 后端。","未说明 (需支持 IPython 或 Jupyter)",[106,107,108,109,110],"tensorflow","tfdebugger","jupyter","ipython","matplotlib",[14],"2026-03-27T02:49:30.150509","2026-04-20T19:22:23.886697",[],[116,121,125],{"id":117,"version":118,"summary_zh":119,"released_at":120},360366,"tdb_ext_v0.1","Jupyter Notebook 扩展。\n","2015-12-13T01:05:18",{"id":122,"version":123,"summary_zh":75,"released_at":124},360367,"v0.1","2015-12-13T00:42:30",{"id":126,"version":127,"summary_zh":75,"released_at":128},360368,"bower_deps_0.1","2015-12-13T00:34:31"]