Kilo Code VS Code 擴展專用輸出通道Dedicated Output Channel設計與落地指南【免費下載鏈接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/ki/kilocode導讀本文以倉庫內基礎設施規劃文檔 dedicated-output-channel.md 為骨架系統講解 Kilo Code 擴展輸出通道的現狀、規劃與演進路徑。你將掌握為什么擴展需要一個真正統一的 Kilo Code 輸出通道而非散落各處的獨立通道如何通過vscode.window.createOutputChannel在激活期創建、按日志級別集中路由并在停用時釋放以及如何把現有[Kilo New]前綴的console.*調用平滑遷移到統一 Logger。文中所有結論均以當前倉庫源碼為佐證并給出可直接對照的落點與驗收標準。背景為什么需要 Dedicated Output Channel現狀沒有全局的 Kilo Code 輸出通道規劃文檔開篇即給出關鍵事實Priority: P2Agent Manager 擁有自己的輸出通道不存在通用的 Kilo Code 輸出通道。這句話點出了當前擴展的日志基礎設施形態各功能模塊各自為政各自創建自己的 Output Channel而缺少一個承載全部日志的頂層通道。文檔進一步用 Remaining Work 清單明確了目標狀態與差距在激活activation階段創建vscode.window.createOutputChannel(Kilo Code)建立帶日志級別debug、info、warn、error的集中式日志工具將所有[Kilo New]日志消息路由到該通道在停用deactivation時釋放dispose該通道把現有console.log([Kilo New] ...)調用遷移到新的 Logger這是一個典型的基礎設施債型文檔篇幅精煉但定義了明確的驗收標準與實現邊界與倉庫中實際存在的分散式輸出通道現狀互為印證。倉庫實證各模塊自建 Output Channel 的現狀從源碼搜索可以確認當前packages/kilo-vscode內存在多個彼此獨立的輸出通道這正是規劃文檔要收斂的分散局面輸出通道名稱創建位置Kilo Diff VirtualDiffVirtualProvider.tsKilo Diff Paneldiff/DiffViewerProvider.tsKilo Diff: Branches/Kilo Diff: Attributesdiff/sources/catalog.tsKilo Diff: Staged/Unstaged/Workspacediff/sources/staged.ts、unstaged.ts、worktree.tsKilo Agent Manageragent-manager/AgentManagerProvider.tsKilo Config WarningsKiloProvider.tsNext Edit 自動補全日志通道services/autocomplete/next-edit/log.ts推論基于代碼結構除上述顯式通道外還有大量直接使用console.log / console.warn / console.error且帶[Kilo New]前綴的調試輸出在 KiloProvider.ts 中可見數十處它們既不進任何 Output Channel也不帶日志級別只能在 Extension Host 控制臺里靠前綴人工過濾。這正是文檔 Remaining Work 中最后一項要治理的對象。目標架構從散落日志到統一通道 分級 Logger目標狀態結合文檔清單與 VS Code 擴展生命周期目標架構可以歸納為三層單一通道激活時創建唯一的Kilo CodeOutput Channel作為擴展全部日志的匯聚點。分級 Logger提供debug / info / warn / error四個級別把不同嚴重程度的日志統一寫入同一通道。統一來源廢棄散落的console.log([Kilo New] ...)調用全部經由 Logger 輸出保證過濾、檢索與問題定位的一致性。與現有OutputHandle抽象的關系值得注意的是Agent Manager 模塊已經先行實現了一種可注入、可釋放的通道抽象可作為統一 Logger 的參考模板。host.ts 中定義了export interface OutputHandle { appendLine(msg: string): void dispose(): void }其在 vscode-host.ts 中的宿主實現正是文檔要求的創建與釋放語義createOutput(name: string): OutputHandle { const channel vscode.window.createOutputChannel(name) return { appendLine: (msg) channel.appendLine(msg), dispose: () channel.dispose(), } }而 AgentManagerProvider.ts 在構造期調用host.createOutput(Kilo Agent Manager)在 1888 行 的dispose()中釋放。這種模式恰好是文檔規劃中的 create during activation / dispose on deactivation 的模塊級先例——統一通道只是把這一模式提升到擴展全局層面并把appendLine升級為帶級別的 Logger API。設計要點Agent Manager 通道目前采用[SessionTerminal]、[RunScript]、[EnvCopy]、[SetupScript]、[AgentManager]等前綴區分來源見 AgentManagerProvider.ts并統一在 345 行 使用new Date().toISOString()打時間戳。統一 Kilo Code 通道可繼續沿用前綴 時間戳 級別的組合實現多模塊共用一個通道時依然可分、可查、可排序。實施路徑按 Remaining Work 清單逐項落地第 1 步激活期創建通道在擴展激活入口activate函數中創建全局通道import * as vscode from vscode export function activate(context: vscode.ExtensionContext) { const outputChannel vscode.window.createOutputChannel(Kilo Code) context.subscriptions.push(outputChannel) // ... 其余初始化 }把通道加入context.subscriptions后VS Code 會在擴展停用deactivation時自動調用其dispose()天然滿足文檔 Dispose on deactivation 的要求無需手寫清理邏輯。第 2 步建立集中式分級 Logger圍繞通道封裝帶級別的 Loggertype LogLevel debug | info | warn | error const LEVEL_ORDER: RecordLogLevel, number { debug: 0, info: 1, warn: 2, error: 3, } class KiloLogger { private minLevel: LogLevel info constructor(private readonly channel: vscode.OutputChannel) {} setLevel(level: LogLevel) { this.minLevel level } private write(level: LogLevel, args: unknown[]) { if (LEVEL_ORDER[level] LEVEL_ORDER[this.minLevel]) return const ts new Date().toISOString() const msg args .map((a) (typeof a string ? a : JSON.stringify(a))) .join( ) this.channel.appendLine([${ts}] [${level.toUpperCase()}] ${msg}) } debug(...args: unknown[]) { this.write(debug, args) } info(...args: unknown[]) { this.write(info, args) } warn(...args: unknown[]) { this.write(warn, args) } error(...args: unknown[]) { this.write(error, args) } } export const logger new KiloLogger( vscode.window.createOutputChannel(Kilo Code) )實現要點級別過濾通過LEVEL_ORDER數值比較實現最小級別過濾debug默認關閉、error永不丟失避免高頻調試日志刷屏生產通道時間戳沿用 Agent Manager 的toISOString()慣例保證多行日志可排序對象序列化非字符串參數如Error、對象統一JSON.stringify與現有console.log([Kilo New] ..., { ... })的多參數風格對齊統一命名通道名嚴格使用文檔規定的Kilo Code保證用戶在 Output 面板中一眼可辨。第 3 步路由[Kilo New]消息并遷移 console 調用文檔要求將所有[Kilo New]日志消息路由到該通道并遷移現有console.log([Kilo New] ...)調用。倉庫中此類調用集中在 KiloProvider.ts典型形態如下已存在多處此處僅列舉代表性模式// 遷移前現狀 console.error([Kilo New] checkpoint mutation failed:, error) console.log([Kilo New] KiloProvider: syncWebviewState(), { /* ... */ }) console.warn([Kilo New] KiloProvider: Failed to resolve managed session:, error) // 遷移后 logger.error(checkpoint mutation failed:, error) logger.info(KiloProvider: syncWebviewState(), { /* ... */ }) logger.warn(KiloProvider: Failed to resolve managed session:, error)遷移時的分級建議console.log→logger.debug或logger.info流程性消息如syncWebviewState、webviewReady received、Retrying connection...屬于調試信息可落為debug避免通道被噪聲淹沒console.warn→logger.warn可恢復的異常路徑如 session 解析失敗、重連失敗、MCP 連接失敗保留warnconsole.error→logger.error不可恢復或影響核心功能的失敗如 checkpoint mutation 失敗、handleLoadSessions失敗保留error。遷移完成后Extension Host 控制臺中的[Kilo New]前綴可以整體退役——統一通道 級別前綴已提供更強的過濾能力見上文 Logger 輸出格式這正是倉庫規范 AGENTS.md 中 All debug output must be prepended with[Kilo New]for easy filtering 的演進方向。兼容性提示若擔心遷移期間遺漏可在 Logger 內部保留一條console.debug([Kilo New], ...)旁路輸出灰度期雙寫確認無遺漏后再移除。但最終目標按文檔是集中到單一通道旁路僅作為過渡手段。第 4 步停用期釋放若采用context.subscriptions.push(outputChannel)方式釋放由 VS Code 生命周期自動完成若 Logger 以單例模塊持有通道則需要在擴展的deactivate()中顯式釋放export function deactivate() { logger.dispose() // 內部調用 outputChannel.dispose() }驗收標準與驗證方式對照文檔 Remaining Work 清單完成后的驗收標準可定義為文檔要求驗收方式激活時創建createOutputChannel(Kilo Code)啟動擴展后Output 面板出現名為Kilo Code的通道集中式日志工具debug/info/warn/errorLogger 單元測試覆蓋四級輸出與最小級別過濾所有[Kilo New]消息路由到該通道在倉庫內搜索\[Kilo New\]應無殘留或僅剩注釋/文檔停用時釋放停用擴展后無通道泄漏重復 activate/deactivate 循環后 VS Code 不報泄漏遷移 console 調用console.log調用數顯著下降關鍵路徑全部走 Logger當前倉庫中可復用的驗證基礎設施包括Agent Manager 的單測已用 mock 的OutputHandle驗證通道行為見 AgentManagerProvider.spec.tscreateOutput: () ({ appendLine: vi.fn(), dispose: vi.fn() })新的統一 Logger 可沿用同樣的 mock 策略編寫單元測試。總結現狀packages/kilo-vscode中存在多個按模塊劃分的獨立 Output ChannelDiff 系列、Agent Manager、Config Warnings 等且仍有大量帶[Kilo New]前綴的console.*調用游離于任何通道之外。目標按 dedicated-output-channel.md 的規劃在激活期創建唯一的Kilo Code通道用帶debug/info/warn/error級別的 Logger 統一輸出停用時釋放。可復用先例Agent Manager 的OutputHandle抽象host.ts與宿主實現vscode-host.ts已經演示了創建-注入-釋放的完整生命周期統一通道是其全局化推廣。此項工作優先級為 P2非阻塞發布但它直接影響擴展的可觀測性與排障效率統一通道落地后用戶只需打開一個Kilo Code輸出面板就能按級別過濾查看擴展全量運行日志而無需在 Extension Host 控制臺和多個 Diff/Agent Manager 通道之間來回切換。【免費下載鏈接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/ki/kilocode創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Kilo Code VS Code 擴展專用輸出通道（Dedicated Output Channel）設計與落地指南
Kilo Code VS Code 擴展專用輸出通道Dedicated Output Channel設計與落地指南【免費下載鏈接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/ki/kilocode導讀本文以倉庫內基礎設施規劃文檔 dedicated-output-channel.md 為骨架系統講解 Kilo Code 擴展輸出通道的現狀、規劃與演進路徑。你將掌握為什么擴展需要一個真正統一的 Kilo Code 輸出通道而非散落各處的獨立通道如何通過vscode.window.createOutputChannel在激活期創建、按日志級別集中路由并在停用時釋放以及如何把現有[Kilo New]前綴的console.*調用平滑遷移到統一 Logger。文中所有結論均以當前倉庫源碼為佐證并給出可直接對照的落點與驗收標準。背景為什么需要 Dedicated Output Channel現狀沒有全局的 Kilo Code 輸出通道規劃文檔開篇即給出關鍵事實Priority: P2Agent Manager 擁有自己的輸出通道不存在通用的 Kilo Code 輸出通道。這句話點出了當前擴展的日志基礎設施形態各功能模塊各自為政各自創建自己的 Output Channel而缺少一個承載全部日志的頂層通道。文檔進一步用 Remaining Work 清單明確了目標狀態與差距在激活activation階段創建vscode.window.createOutputChannel(Kilo Code)建立帶日志級別debug、info、warn、error的集中式日志工具將所有[Kilo New]日志消息路由到該通道在停用deactivation時釋放dispose該通道把現有console.log([Kilo New] ...)調用遷移到新的 Logger這是一個典型的基礎設施債型文檔篇幅精煉但定義了明確的驗收標準與實現邊界與倉庫中實際存在的分散式輸出通道現狀互為印證。倉庫實證各模塊自建 Output Channel 的現狀從源碼搜索可以確認當前packages/kilo-vscode內存在多個彼此獨立的輸出通道這正是規劃文檔要收斂的分散局面輸出通道名稱創建位置Kilo Diff VirtualDiffVirtualProvider.tsKilo Diff Paneldiff/DiffViewerProvider.tsKilo Diff: Branches/Kilo Diff: Attributesdiff/sources/catalog.tsKilo Diff: Staged/Unstaged/Workspacediff/sources/staged.ts、unstaged.ts、worktree.tsKilo Agent Manageragent-manager/AgentManagerProvider.tsKilo Config WarningsKiloProvider.tsNext Edit 自動補全日志通道services/autocomplete/next-edit/log.ts推論基于代碼結構除上述顯式通道外還有大量直接使用console.log / console.warn / console.error且帶[Kilo New]前綴的調試輸出在 KiloProvider.ts 中可見數十處它們既不進任何 Output Channel也不帶日志級別只能在 Extension Host 控制臺里靠前綴人工過濾。這正是文檔 Remaining Work 中最后一項要治理的對象。目標架構從散落日志到統一通道 分級 Logger目標狀態結合文檔清單與 VS Code 擴展生命周期目標架構可以歸納為三層單一通道激活時創建唯一的Kilo CodeOutput Channel作為擴展全部日志的匯聚點。分級 Logger提供debug / info / warn / error四個級別把不同嚴重程度的日志統一寫入同一通道。統一來源廢棄散落的console.log([Kilo New] ...)調用全部經由 Logger 輸出保證過濾、檢索與問題定位的一致性。與現有OutputHandle抽象的關系值得注意的是Agent Manager 模塊已經先行實現了一種可注入、可釋放的通道抽象可作為統一 Logger 的參考模板。host.ts 中定義了export interface OutputHandle { appendLine(msg: string): void dispose(): void }其在 vscode-host.ts 中的宿主實現正是文檔要求的創建與釋放語義createOutput(name: string): OutputHandle { const channel vscode.window.createOutputChannel(name) return { appendLine: (msg) channel.appendLine(msg), dispose: () channel.dispose(), } }而 AgentManagerProvider.ts 在構造期調用host.createOutput(Kilo Agent Manager)在 1888 行 的dispose()中釋放。這種模式恰好是文檔規劃中的 create during activation / dispose on deactivation 的模塊級先例——統一通道只是把這一模式提升到擴展全局層面并把appendLine升級為帶級別的 Logger API。設計要點Agent Manager 通道目前采用[SessionTerminal]、[RunScript]、[EnvCopy]、[SetupScript]、[AgentManager]等前綴區分來源見 AgentManagerProvider.ts并統一在 345 行 使用new Date().toISOString()打時間戳。統一 Kilo Code 通道可繼續沿用前綴 時間戳 級別的組合實現多模塊共用一個通道時依然可分、可查、可排序。實施路徑按 Remaining Work 清單逐項落地第 1 步激活期創建通道在擴展激活入口activate函數中創建全局通道import * as vscode from vscode export function activate(context: vscode.ExtensionContext) { const outputChannel vscode.window.createOutputChannel(Kilo Code) context.subscriptions.push(outputChannel) // ... 其余初始化 }把通道加入context.subscriptions后VS Code 會在擴展停用deactivation時自動調用其dispose()天然滿足文檔 Dispose on deactivation 的要求無需手寫清理邏輯。第 2 步建立集中式分級 Logger圍繞通道封裝帶級別的 Loggertype LogLevel debug | info | warn | error const LEVEL_ORDER: RecordLogLevel, number { debug: 0, info: 1, warn: 2, error: 3, } class KiloLogger { private minLevel: LogLevel info constructor(private readonly channel: vscode.OutputChannel) {} setLevel(level: LogLevel) { this.minLevel level } private write(level: LogLevel, args: unknown[]) { if (LEVEL_ORDER[level] LEVEL_ORDER[this.minLevel]) return const ts new Date().toISOString() const msg args .map((a) (typeof a string ? a : JSON.stringify(a))) .join( ) this.channel.appendLine([${ts}] [${level.toUpperCase()}] ${msg}) } debug(...args: unknown[]) { this.write(debug, args) } info(...args: unknown[]) { this.write(info, args) } warn(...args: unknown[]) { this.write(warn, args) } error(...args: unknown[]) { this.write(error, args) } } export const logger new KiloLogger( vscode.window.createOutputChannel(Kilo Code) )實現要點級別過濾通過LEVEL_ORDER數值比較實現最小級別過濾debug默認關閉、error永不丟失避免高頻調試日志刷屏生產通道時間戳沿用 Agent Manager 的toISOString()慣例保證多行日志可排序對象序列化非字符串參數如Error、對象統一JSON.stringify與現有console.log([Kilo New] ..., { ... })的多參數風格對齊統一命名通道名嚴格使用文檔規定的Kilo Code保證用戶在 Output 面板中一眼可辨。第 3 步路由[Kilo New]消息并遷移 console 調用文檔要求將所有[Kilo New]日志消息路由到該通道并遷移現有console.log([Kilo New] ...)調用。倉庫中此類調用集中在 KiloProvider.ts典型形態如下已存在多處此處僅列舉代表性模式// 遷移前現狀 console.error([Kilo New] checkpoint mutation failed:, error) console.log([Kilo New] KiloProvider: syncWebviewState(), { /* ... */ }) console.warn([Kilo New] KiloProvider: Failed to resolve managed session:, error) // 遷移后 logger.error(checkpoint mutation failed:, error) logger.info(KiloProvider: syncWebviewState(), { /* ... */ }) logger.warn(KiloProvider: Failed to resolve managed session:, error)遷移時的分級建議console.log→logger.debug或logger.info流程性消息如syncWebviewState、webviewReady received、Retrying connection...屬于調試信息可落為debug避免通道被噪聲淹沒console.warn→logger.warn可恢復的異常路徑如 session 解析失敗、重連失敗、MCP 連接失敗保留warnconsole.error→logger.error不可恢復或影響核心功能的失敗如 checkpoint mutation 失敗、handleLoadSessions失敗保留error。遷移完成后Extension Host 控制臺中的[Kilo New]前綴可以整體退役——統一通道 級別前綴已提供更強的過濾能力見上文 Logger 輸出格式這正是倉庫規范 AGENTS.md 中 All debug output must be prepended with[Kilo New]for easy filtering 的演進方向。兼容性提示若擔心遷移期間遺漏可在 Logger 內部保留一條console.debug([Kilo New], ...)旁路輸出灰度期雙寫確認無遺漏后再移除。但最終目標按文檔是集中到單一通道旁路僅作為過渡手段。第 4 步停用期釋放若采用context.subscriptions.push(outputChannel)方式釋放由 VS Code 生命周期自動完成若 Logger 以單例模塊持有通道則需要在擴展的deactivate()中顯式釋放export function deactivate() { logger.dispose() // 內部調用 outputChannel.dispose() }驗收標準與驗證方式對照文檔 Remaining Work 清單完成后的驗收標準可定義為文檔要求驗收方式激活時創建createOutputChannel(Kilo Code)啟動擴展后Output 面板出現名為Kilo Code的通道集中式日志工具debug/info/warn/errorLogger 單元測試覆蓋四級輸出與最小級別過濾所有[Kilo New]消息路由到該通道在倉庫內搜索\[Kilo New\]應無殘留或僅剩注釋/文檔停用時釋放停用擴展后無通道泄漏重復 activate/deactivate 循環后 VS Code 不報泄漏遷移 console 調用console.log調用數顯著下降關鍵路徑全部走 Logger當前倉庫中可復用的驗證基礎設施包括Agent Manager 的單測已用 mock 的OutputHandle驗證通道行為見 AgentManagerProvider.spec.tscreateOutput: () ({ appendLine: vi.fn(), dispose: vi.fn() })新的統一 Logger 可沿用同樣的 mock 策略編寫單元測試。總結現狀packages/kilo-vscode中存在多個按模塊劃分的獨立 Output ChannelDiff 系列、Agent Manager、Config Warnings 等且仍有大量帶[Kilo New]前綴的console.*調用游離于任何通道之外。目標按 dedicated-output-channel.md 的規劃在激活期創建唯一的Kilo Code通道用帶debug/info/warn/error級別的 Logger 統一輸出停用時釋放。可復用先例Agent Manager 的OutputHandle抽象host.ts與宿主實現vscode-host.ts已經演示了創建-注入-釋放的完整生命周期統一通道是其全局化推廣。此項工作優先級為 P2非阻塞發布但它直接影響擴展的可觀測性與排障效率統一通道落地后用戶只需打開一個Kilo Code輸出面板就能按級別過濾查看擴展全量運行日志而無需在 Extension Host 控制臺和多個 Diff/Agent Manager 通道之間來回切換。【免費下載鏈接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.項目地址: https://gitcode.com/GitHub_Trending/ki/kilocode創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考