ttsc 维护者 Wiki

文件索引

本页是导航辅助，把高频改动文件按子系统归类、给一句话作用。它不是全量文件清单——全量树见各包目录；这里只列维护者最常打开的文件。

packages/ttsc — JS 启动层

文件	作用	相关页
`src/index.ts`	公共导出（只 TtscCompiler/TtscService/structures）	ttsc 包
`src/TtscCompiler.ts`	编程式编译宿主 + 异常分类	ttsc 包
`src/TtscService.ts`	常驻转换服务	增量 Session
`src/launcher/internal/runTtsc.ts`	ttsc CLI 分派 + watch	运行时流程
`src/launcher/internal/runTtsx.ts`	ttsx CLI + 参数路由	ttsx 运行时
`src/launcher/internal/prepareExecution.ts`	ttsx 项目构建 + 虚拟布局	ttsx 运行时
`src/launcher/internal/runtimeHooks.ts`	ttsx 子进程同步模块钩子	ttsx 运行时
`src/compiler/internal/runBuild.ts`	构建编排（check/transform 派发、tsgo flag）	transform 派发
`src/compiler/internal/transformProjectInMemory.ts`	源到源转换编排	transform 派发
`src/compiler/internal/sharedHostHelpers.ts`	共享宿主选择 / 兼容性断言	transform 派发
`src/compiler/internal/buildNativeCompiler.ts`	构建 cmd/ttsc 编译宿主二进制	运行时流程
`src/plugin/internal/loadProjectPlugins.ts`	插件发现/加载/组合	加载与发现
`src/plugin/internal/buildSourcePlugin.ts`	go build 缓存引擎	go build 缓存
`src/flags/schema.ts`	flag 单一真相源	flag 解析器
`src/flags/parser.ts`	flag 解析引擎	flag 解析器
`src/structures/ITtscPlugin.ts`	插件描述符契约	描述符协议

packages/ttsc — Go driver

文件	作用	相关页
`driver/program.go`	Program 外观、LoadProgram、单 checker、诊断	Program 与 Checker
`driver/emit_plugin.go`	AST 集成 emit	Emit 与重写
`driver/rewrite.go`	文本级 emit 重写	Emit 与重写
`driver/plugins.go`	链接插件注册/配对/hook	链接插件
`driver/session.go`	增量类型检查常驻	增量 Session
`driver/host.go`	DefaultFS/DefaultHost	Program 与 Checker
`driver/overlay.go`	OverlayFS 内存编辑	增量 Session

packages/ttsc — Go cmd / internal / utility

文件	作用	相关页
`cmd/ttsc/main.go`	原生编译宿主入口	运行时流程
`cmd/ttsc/build.go`	build 子命令	运行时流程
`cmd/ttsc/api_compile.go`	api-compile（内存 emit）	Emit 与重写
`cmd/ttsc/api_transform.go`	api-transform（源到源）	transform 派发
`cmd/ttscserver/main.go`	LSP 宿主入口	LSP 代理
`internal/lspserver/lsp_proxy.go`	字节级 LSP 代理	LSP 代理设计
`internal/lspserver/lsp_native_plugin_source.go`	旁车委托 PluginSource	LSP 代理设计
`internal/lspserver/lsp_server.go`	RunLSPServer + panic 恢复	LSP 代理设计
`internal/graph/graph.go`	图谱节点/边模型	代码图谱
`internal/graph/build.go`	声明节点收集	构建与解析
`internal/graph/resolve.go`	引用解析（barrel 解包）	构建与解析
`internal/graph/edges.go`	边解析	构建与解析
`utility/serve.go`	常驻转换 serve 协议	增量 Session
`tools/gen_shims/`	shim surface 生成器	shim 审计与同步
`tools/shim_audit/`	shim 完整性闸门	shim 审计与同步

packages/ttsc — shim

文件/目录	作用	相关页
`shim/<pkg>/surface.go`	生成的类型别名	shim 设计
`shim/<pkg>/shim.go`	手写包装/linkname	shim 设计
`shim/<pkg>/enums_gen.go`	生成的枚举补全	shim 审计与同步
`shim/<pkg>/extra-shim.json`	喂生成器的额外符号	shim 设计
`tools/shim_audit/baseline.json`	棘轮缺口 baseline	shim 审计与同步

packages/lint

文件	作用	相关页
`linthost/engine.go`	遍历引擎、分派、并行	lint 引擎
`linthost/host.go`	Program 自举（内联，不 import driver）	lint 引擎
`linthost/contrib_adapter.go`	贡献者规则桥接	贡献者插件
`linthost/rules_*.go`	规则实现（每文件一类）	规则与注册表
`linthost/print_*.go`	宽度感知格式化 printer	格式化器
`linthost/format.go` `config_format.go`	格式化入口/配置	格式化器
`rule/rule.go`	公共贡献者 API	贡献者插件
`rule/astutil/astutil.go`	byte-range helper	贡献者插件
`plugin/main.go`	二进制入口（多子命令）	贡献者插件

其他包

文件/目录	作用	相关页
`packages/factory/src/`	AST factory + printer	@ttsc/factory
`packages/graph/src/server/createServer.ts`	MCP 服务器（typia 反射）	MCP 服务器
`packages/unplugin/src/core/transform.ts`	unplugin transform + 缓存	@ttsc/unplugin
`packages/wasm/host/host.go`	wasm Expose 桥接	@ttsc/wasm
`packages/vscode/src/extension.ts`	VS Code 扩展入口	@ttsc/vscode

工作区脚本

文件	作用	相关页
`scripts/build-current.cjs`	构建当前平台（顺序约束）	构建与测试
`scripts/build-platforms.cjs`	构建全部平台	发布与多平台
`scripts/test-go-*.cjs`	Go 单测编排	构建与测试
`scripts/shim-audit.cjs`	shim 审计入口	shim 审计与同步
`experimental/benchmark/performance.mjs`	性能基准	基准测试

接下来