Skip to content

Code reading preview

Pre-release
Pre-release

Choose a tag to compare

View all tags
@zlsjtj zlsjtj released this 04 Oct 10:37
v0.1.0-preview.2
4c9b6aa

CodeAtlas 的代码阅读预览版。把目录、搜索结果和带行号源码放在一个本地工作台里读，基础阅读不需要模型 Key。

试用

准备 Python 3.11+、Node.js 20.12+ 和 Git：

git clone --branch v0.1.0-preview.2 https://github.com/zlsjtj/CodeAtlas.git
cd CodeAtlas
npm run setup
npm run demo

打开终端打印的地址，搜索 callback=f。固定版本的 Click 已导入并索引，可以沿三处源码查看装饰器如何保存、调用原函数。示例使用独立数据，不覆盖 .env，也不使用其中的模型 Key。退出按 Ctrl+C。

读自己的仓库用 npm run dev。Docker、模型配置和数据目录见 README。

这版包含

  • 目录、关键词与符号搜索、每次最多 200 行的源码阅读。
  • 源码语法颜色、搜索命中和当前结果标识；窄屏布局、自动换行、可收起问答栏。
  • 固定版本的 Click 示例，以及分别录制的中英文真实演示。没有模拟模型响应。

本次标签指向 4c9b6aa。Windows、Ubuntu、Linux Docker 的 CI 均已通过，包括类型检查、生产构建、浏览器回归和容器重建后的数据保留。

使用边界

  • 关键词和正则符号匹配，不是语义检索或自动调用图。
  • 六条真实模型问答案例仍未执行，不能据此评价回答或引用质量。问答和草案需要另配模型，相关源码会发送给模型服务。
  • pytest 和 npm scripts 会执行仓库代码，只对信任的仓库运行检查。没有执行沙箱、鉴权或多用户隔离，不直接暴露到公网。
  • macOS 和大规模仓库性能尚未验收。

遇到问题可提交 Issue，附系统、版本和最小复现，删除 Key 和私有代码。

English

A local code-reading preview: search text or symbols, inspect numbered source, and follow the highlighted matches. No model key is needed for reading.

The commands above check out this release and start an indexed, pinned Click example. Search callback=f and follow the callback walkthrough. Use npm run dev for your own repositories; see the English README for Docker and optional model setup.

This preview includes source colors, search-hit and selected-result markers, line wrapping and a mobile layout. Chinese and English demos were recorded independently from the actual workspace, without model calls. CI passed on Windows, Ubuntu and Linux Docker for the tagged commit.

Real-model Q&A remains unvalidated. Search is keyword/regex based, with 200-line reads. Checks execute repository code without a sandbox; use trusted repositories and keep the service local. macOS and large-repository performance have not been validated.

Assets 2
Loading