autosnippet 3.2.17 → 3.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (184) hide show
  1. package/README.md +73 -104
  2. package/dashboard/dist/assets/{index-CKMy5LY6.js → index-DdvZE4Yd.js} +1 -1
  3. package/dashboard/dist/index.html +1 -1
  4. package/dist/bin/cli.js +88 -49
  5. package/dist/lib/agent/AgentEventBus.js +3 -3
  6. package/dist/lib/agent/AgentFactory.d.ts +3 -3
  7. package/dist/lib/agent/AgentFactory.js +4 -4
  8. package/dist/lib/agent/AgentMessage.d.ts +8 -8
  9. package/dist/lib/agent/AgentMessage.js +8 -8
  10. package/dist/lib/agent/AgentRuntime.js +2 -2
  11. package/dist/lib/agent/AgentState.js +4 -4
  12. package/dist/lib/agent/ConversationStore.d.ts +1 -1
  13. package/dist/lib/agent/ConversationStore.js +1 -1
  14. package/dist/lib/agent/PipelineStrategy.js +1 -1
  15. package/dist/lib/agent/context/ContextWindow.d.ts +2 -2
  16. package/dist/lib/agent/context/ContextWindow.js +7 -7
  17. package/dist/lib/agent/context/ExplorationTracker.js +9 -9
  18. package/dist/lib/agent/context/exploration/PlanTracker.js +2 -2
  19. package/dist/lib/agent/context/exploration/SignalDetector.d.ts +1 -1
  20. package/dist/lib/agent/context/exploration/SignalDetector.js +1 -1
  21. package/dist/lib/agent/core/LoopContext.d.ts +21 -21
  22. package/dist/lib/agent/core/LoopContext.js +21 -21
  23. package/dist/lib/agent/core/SystemPromptBuilder.js +4 -4
  24. package/dist/lib/agent/domain/EvidenceCollector.js +5 -5
  25. package/dist/lib/agent/memory/ActiveContext.js +1 -1
  26. package/dist/lib/agent/memory/MemoryRetriever.js +1 -1
  27. package/dist/lib/agent/memory/MemoryStore.js +2 -2
  28. package/dist/lib/agent/memory/SessionStore.js +3 -3
  29. package/dist/lib/agent/policies.d.ts +1 -1
  30. package/dist/lib/agent/policies.js +1 -1
  31. package/dist/lib/agent/strategies.d.ts +1 -1
  32. package/dist/lib/agent/strategies.js +4 -4
  33. package/dist/lib/agent/tools/_shared.d.ts +1 -1
  34. package/dist/lib/agent/tools/_shared.js +1 -1
  35. package/dist/lib/agent/tools/infrastructure.js +2 -2
  36. package/dist/lib/cli/SetupService.d.ts +25 -25
  37. package/dist/lib/cli/SetupService.js +28 -15
  38. package/dist/lib/cli/deploy/FileDeployer.d.ts +9 -2
  39. package/dist/lib/cli/deploy/FileDeployer.js +139 -46
  40. package/dist/lib/cli/deploy/FileManifest.d.ts +23 -39
  41. package/dist/lib/cli/deploy/FileManifest.js +22 -27
  42. package/dist/lib/core/AstAnalyzer.d.ts +2 -2
  43. package/dist/lib/core/AstAnalyzer.js +2 -2
  44. package/dist/lib/core/analysis/CallEdgeResolver.d.ts +7 -7
  45. package/dist/lib/core/analysis/CallEdgeResolver.js +9 -9
  46. package/dist/lib/core/analysis/CallGraphAnalyzer.d.ts +4 -4
  47. package/dist/lib/core/analysis/CallGraphAnalyzer.js +2 -2
  48. package/dist/lib/core/analysis/ImportPathResolver.d.ts +0 -2
  49. package/dist/lib/core/analysis/ImportPathResolver.js +2 -4
  50. package/dist/lib/core/ast/ProjectGraph.js +7 -7
  51. package/dist/lib/core/capability/CapabilityProbe.js +6 -14
  52. package/dist/lib/domain/knowledge/UnifiedValidator.js +2 -2
  53. package/dist/lib/domain/knowledge/values/Constraints.js +4 -4
  54. package/dist/lib/domain/knowledge/values/Content.js +6 -6
  55. package/dist/lib/domain/knowledge/values/Quality.js +5 -5
  56. package/dist/lib/domain/knowledge/values/Reasoning.js +5 -5
  57. package/dist/lib/domain/knowledge/values/Relations.js +1 -1
  58. package/dist/lib/domain/knowledge/values/Stats.js +6 -6
  59. package/dist/lib/domain/task/TaskIdGenerator.d.ts +4 -4
  60. package/dist/lib/domain/task/TaskIdGenerator.js +2 -2
  61. package/dist/lib/external/lark/LarkTransport.js +4 -4
  62. package/dist/lib/external/mcp/McpServer.d.ts +3 -7
  63. package/dist/lib/external/mcp/McpServer.js +9 -13
  64. package/dist/lib/external/mcp/handlers/bootstrap/ExternalSubmissionTracker.js +5 -5
  65. package/dist/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.js +4 -3
  66. package/dist/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.d.ts +3 -3
  67. package/dist/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.js +3 -3
  68. package/dist/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.d.ts +1 -1
  69. package/dist/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.js +1 -1
  70. package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-context.js +3 -3
  71. package/dist/lib/external/mcp/handlers/bootstrap/shared/dimension-sop.js +27 -14
  72. package/dist/lib/external/mcp/handlers/bootstrap-external.js +6 -0
  73. package/dist/lib/external/mcp/handlers/dimension-complete-external.js +55 -1
  74. package/dist/lib/external/mcp/handlers/skill.js +9 -31
  75. package/dist/lib/external/mcp/handlers/system.js +2 -2
  76. package/dist/lib/external/mcp/handlers/task.js +16 -1
  77. package/dist/lib/external/mcp/tools.d.ts +12 -10
  78. package/dist/lib/external/mcp/tools.js +97 -69
  79. package/dist/lib/http/HttpServer.js +15 -2
  80. package/dist/lib/http/utils/routeHelpers.d.ts +1 -1
  81. package/dist/lib/http/utils/routeHelpers.js +1 -1
  82. package/dist/lib/http/utils/sse-sessions.d.ts +1 -1
  83. package/dist/lib/http/utils/sse-sessions.js +1 -1
  84. package/dist/lib/infrastructure/cache/CacheService.js +1 -1
  85. package/dist/lib/infrastructure/vector/AsyncPersistence.js +8 -8
  86. package/dist/lib/infrastructure/vector/BatchEmbedder.d.ts +1 -1
  87. package/dist/lib/infrastructure/vector/BatchEmbedder.js +2 -2
  88. package/dist/lib/infrastructure/vector/HnswIndex.d.ts +4 -4
  89. package/dist/lib/infrastructure/vector/HnswIndex.js +5 -5
  90. package/dist/lib/infrastructure/vector/HnswVectorAdapter.js +8 -8
  91. package/dist/lib/infrastructure/vector/ScalarQuantizer.d.ts +1 -1
  92. package/dist/lib/infrastructure/vector/ScalarQuantizer.js +4 -4
  93. package/dist/lib/infrastructure/vector/VectorStore.d.ts +1 -1
  94. package/dist/lib/infrastructure/vector/VectorStore.js +1 -1
  95. package/dist/lib/injection/ServiceContainer.d.ts +1 -1
  96. package/dist/lib/injection/ServiceContainer.js +1 -1
  97. package/dist/lib/platform/NativeUi.d.ts +1 -1
  98. package/dist/lib/platform/NativeUi.js +1 -1
  99. package/dist/lib/platform/ios/spm/DependencyGraph.d.ts +1 -1
  100. package/dist/lib/platform/ios/spm/DependencyGraph.js +1 -1
  101. package/dist/lib/platform/ios/spm/PolicyEngine.d.ts +1 -1
  102. package/dist/lib/platform/ios/spm/PolicyEngine.js +1 -1
  103. package/dist/lib/platform/ios/spm/SpmDiscoverer.js +1 -1
  104. package/dist/lib/platform/ios/spm/SpmHelper.js +3 -3
  105. package/dist/lib/platform/ios/xcode/SaveEventFilter.js +2 -2
  106. package/dist/lib/platform/ios/xcode/XcodeIntegration.js +1 -1
  107. package/dist/lib/repository/base/BaseRepository.js +1 -1
  108. package/dist/lib/repository/task/TaskRepository.impl.d.ts +2 -2
  109. package/dist/lib/repository/task/TaskRepository.impl.js +1 -1
  110. package/dist/lib/repository/token/TokenUsageStore.js +1 -1
  111. package/dist/lib/service/automation/ActionPipeline.d.ts +1 -1
  112. package/dist/lib/service/automation/ActionPipeline.js +1 -1
  113. package/dist/lib/service/bootstrap/BootstrapEventEmitter.js +2 -2
  114. package/dist/lib/service/bootstrap/BootstrapTaskManager.d.ts +1 -1
  115. package/dist/lib/service/bootstrap/BootstrapTaskManager.js +2 -2
  116. package/dist/lib/service/bootstrap/DimensionCopyRegistry.d.ts +2 -2
  117. package/dist/lib/service/bootstrap/DimensionCopyRegistry.js +2 -2
  118. package/dist/lib/service/delivery/AgentInstructionsGenerator.d.ts +6 -15
  119. package/dist/lib/service/delivery/AgentInstructionsGenerator.js +53 -189
  120. package/dist/lib/service/delivery/CursorDeliveryPipeline.d.ts +6 -16
  121. package/dist/lib/service/delivery/CursorDeliveryPipeline.js +14 -19
  122. package/dist/lib/service/delivery/KnowledgeCompressor.d.ts +1 -1
  123. package/dist/lib/service/delivery/KnowledgeCompressor.js +1 -1
  124. package/dist/lib/service/delivery/RulesGenerator.d.ts +10 -3
  125. package/dist/lib/service/delivery/RulesGenerator.js +43 -3
  126. package/dist/lib/service/delivery/SkillsSyncer.d.ts +21 -7
  127. package/dist/lib/service/delivery/SkillsSyncer.js +46 -10
  128. package/dist/lib/service/delivery/TopicClassifier.d.ts +3 -6
  129. package/dist/lib/service/delivery/TopicClassifier.js +0 -3
  130. package/dist/lib/service/guard/ExclusionManager.d.ts +1 -1
  131. package/dist/lib/service/guard/ExclusionManager.js +1 -1
  132. package/dist/lib/service/guard/GuardCheckEngine.d.ts +3 -3
  133. package/dist/lib/service/guard/GuardCheckEngine.js +5 -5
  134. package/dist/lib/service/guard/GuardCrossFileChecks.d.ts +1 -1
  135. package/dist/lib/service/guard/GuardFeedbackLoop.d.ts +3 -3
  136. package/dist/lib/service/guard/GuardFeedbackLoop.js +3 -3
  137. package/dist/lib/service/guard/GuardPatternUtils.js +1 -1
  138. package/dist/lib/service/guard/GuardService.d.ts +1 -15
  139. package/dist/lib/service/guard/GuardService.js +0 -1
  140. package/dist/lib/service/guard/RuleLearner.d.ts +1 -1
  141. package/dist/lib/service/guard/RuleLearner.js +1 -1
  142. package/dist/lib/service/knowledge/CodeEntityGraph.d.ts +3 -3
  143. package/dist/lib/service/knowledge/CodeEntityGraph.js +3 -3
  144. package/dist/lib/service/knowledge/KnowledgeService.d.ts +0 -1
  145. package/dist/lib/service/knowledge/KnowledgeService.js +0 -1
  146. package/dist/lib/service/module/ModuleService.d.ts +1 -1
  147. package/dist/lib/service/module/ModuleService.js +2 -2
  148. package/dist/lib/service/search/HybridRetriever.d.ts +2 -2
  149. package/dist/lib/service/search/HybridRetriever.js +2 -2
  150. package/dist/lib/service/search/SearchEngine.d.ts +1 -3
  151. package/dist/lib/service/search/SearchEngine.js +1 -3
  152. package/dist/lib/service/search/contextBoost.d.ts +1 -1
  153. package/dist/lib/service/skills/EventAggregator.js +2 -2
  154. package/dist/lib/service/skills/SignalCollector.js +1 -1
  155. package/dist/lib/service/snippet/codecs/VSCodeCodec.js +1 -1
  156. package/dist/lib/service/task/TaskGraphService.d.ts +0 -3
  157. package/dist/lib/service/task/TaskGraphService.js +0 -3
  158. package/dist/lib/service/task/TaskKnowledgeBridge.d.ts +8 -27
  159. package/dist/lib/service/task/TaskKnowledgeBridge.js +0 -8
  160. package/dist/lib/service/task/TaskReadyEngine.d.ts +1 -2
  161. package/dist/lib/service/task/TaskReadyEngine.js +0 -1
  162. package/dist/lib/service/wiki/WikiRenderers.js +0 -1
  163. package/dist/lib/service/wiki/WikiUtils.js +2 -7
  164. package/dist/lib/shared/PathGuard.js +6 -6
  165. package/dist/lib/shared/schemas/mcp-tools.js +84 -43
  166. package/dist/scripts/install-vscode-copilot.js +14 -4
  167. package/package.json +1 -1
  168. package/skills/autosnippet-create/SKILL.md +131 -131
  169. package/skills/autosnippet-devdocs/SKILL.md +1 -2
  170. package/skills/autosnippet-guard/SKILL.md +20 -89
  171. package/skills/autosnippet-recipes/SKILL.md +35 -117
  172. package/skills/autosnippet-structure/SKILL.md +23 -55
  173. package/templates/cursor-rules/autosnippet-skills.mdc +17 -33
  174. package/templates/instructions/agent-static.md +24 -0
  175. package/templates/instructions/conventions.md +42 -0
  176. package/skills/autosnippet-analysis/SKILL.md +0 -169
  177. package/skills/autosnippet-candidates/SKILL.md +0 -367
  178. package/skills/autosnippet-coldstart/SKILL.md +0 -988
  179. package/skills/autosnippet-concepts/SKILL.md +0 -630
  180. package/skills/autosnippet-intent/SKILL.md +0 -55
  181. package/skills/autosnippet-lifecycle/SKILL.md +0 -100
  182. package/templates/copilot-instructions.md +0 -66
  183. package/templates/cursor-rules/autosnippet-conventions.mdc +0 -172
  184. package/templates/cursor-rules/autosnippet-workflow.mdc +0 -76
@@ -17,7 +17,7 @@ export class DependencyGraph {
17
17
  }
18
18
  /**
19
19
  * 从 PackageSwiftParser 的解析结果构建图
20
- * @param {{ targets: { name: string, dependencies: string[] }[] }} parsed
20
+ * @param parsed
21
21
  */
22
22
  buildFromParsed(parsed) {
23
23
  this.clear();
@@ -22,7 +22,7 @@ export declare class PolicyEngine {
22
22
  #private;
23
23
  /**
24
24
  * 全面策略检查
25
- * @param {{ layerOrder?: string[] }} config - layerOrder 定义分层顺序,低层不应依赖高层
25
+ * @param config - layerOrder 定义分层顺序,低层不应依赖高层
26
26
  * @returns }
27
27
  */
28
28
  check(graph: DependencyGraph, config?: PolicyConfig): {
@@ -5,7 +5,7 @@
5
5
  export class PolicyEngine {
6
6
  /**
7
7
  * 全面策略检查
8
- * @param {{ layerOrder?: string[] }} config - layerOrder 定义分层顺序,低层不应依赖高层
8
+ * @param config - layerOrder 定义分层顺序,低层不应依赖高层
9
9
  * @returns }
10
10
  */
11
11
  check(graph, config = {}) {
@@ -15,7 +15,7 @@ import { PackageSwiftParser } from './PackageSwiftParser.js';
15
15
  export class SpmDiscoverer extends ProjectDiscoverer {
16
16
  #parser = null;
17
17
  #projectRoot = null;
18
- /** @type {Array<{ pkgPath: string, parsed: ReturnType<PackageSwiftParser['parse']> }>} */
18
+ /** >} */
19
19
  #parsedPackages = [];
20
20
  get id() {
21
21
  return 'spm';
@@ -21,7 +21,7 @@ export class SpmHelper {
21
21
  #targetPackageMap;
22
22
  /** 包级依赖图:packagePath → Set<packagePath>(用于跨包循环检测) */
23
23
  #packageDepGraph;
24
- /** @type {GraphCache} 磁盘缓存层 */
24
+ /** 磁盘缓存层 */
25
25
  #graphCache;
26
26
  constructor(projectRoot, options = {}) {
27
27
  this.#projectRoot = projectRoot;
@@ -181,7 +181,7 @@ export class SpmHelper {
181
181
  // ─────────────── 包级依赖图构建 ───────────────
182
182
  /**
183
183
  * 解析所有 Package.swift 中的 .package(path: "...") 声明,构建包级依赖图
184
- * @param {{ path: string, parsed: object }[]} allParsed
184
+ * @param allParsed
185
185
  */
186
186
  #buildPackageDepGraph(allParsed) {
187
187
  this.#packageDepGraph.clear();
@@ -392,7 +392,7 @@ export class SpmHelper {
392
392
  * 确保 Package.swift 中有对目标包的 .package(path: "...") 声明
393
393
  * @param content Package.swift 内容
394
394
  * @param fromPkgPath 当前包的 Package.swift 路径
395
- * @param {{ packageName: string, packagePath: string }} toPkg 目标包信息
395
+ * @param toPkg 目标包信息
396
396
  * @returns }
397
397
  */
398
398
  #ensurePackageDependency(content, fromPkgPath, toPkg) {
@@ -36,9 +36,9 @@ class SaveEventFilter {
36
36
  _contentHashes;
37
37
  _selfWrites;
38
38
  constructor() {
39
- /** @type {Map<string, number>} filePath → 最后一次 self-write 的时间戳 */
39
+ /** filePath → 最后一次 self-write 的时间戳 */
40
40
  this._selfWrites = new Map();
41
- /** @type {Map<string, string>} filePath → 上次处理时的内容 MD5 哈希 */
41
+ /** filePath → 上次处理时的内容 MD5 哈希 */
42
42
  this._contentHashes = new Map();
43
43
  // 定期清理过期条目,防止内存泄漏
44
44
  this._cleanupInterval = setInterval(() => this._cleanup(), 60_000);
@@ -90,7 +90,7 @@ export async function insertHeaders(watcher, fullPath, headers, opts = {}) {
90
90
  const CM = await import('../../ClipboardManager.js');
91
91
  const NU = (await import('../../NativeUi.js'));
92
92
  const result = { inserted: [], skipped: [], cancelled: false };
93
- /** @type {Map<string, string>} 模块名 → 提示注释('提示操作插入'按钮选择时记录) */
93
+ /** 模块名 → 提示注释('提示操作插入'按钮选择时记录) */
94
94
  const depWarnings = opts.depWarnings instanceof Map ? new Map(opts.depWarnings) : new Map();
95
95
  if (!headers || headers.length === 0) {
96
96
  return result;
@@ -12,7 +12,7 @@ export class BaseRepository {
12
12
  db;
13
13
  logger;
14
14
  tableName;
15
- /** @type {Set<string>|null} lazily-populated column whitelist */
15
+ /** lazily-populated column whitelist */
16
16
  #columnWhitelist = null;
17
17
  constructor(database, tableName) {
18
18
  // 校验 tableName 防止 SQL 注入(与列名使用相同的标识符规则)
@@ -64,8 +64,8 @@ export declare class TaskRepositoryImpl {
64
64
  db: Database;
65
65
  logger: WinstonLogger;
66
66
  constructor(database: DatabaseWrapper, drizzle?: DrizzleDB);
67
- /** @private 预编译复杂查询(仅保留 drizzle 无法表达的递归 CTE) */
68
- _prepareStatements(): void;
67
+ /** 预编译复杂查询(仅保留 drizzle 无法表达的递归 CTE) */
68
+ private _prepareStatements;
69
69
  /**
70
70
  * 创建任务
71
71
  * ★ Drizzle 类型安全 INSERT
@@ -25,7 +25,7 @@ export class TaskRepositoryImpl {
25
25
  this.#drizzle = drizzle ?? getDrizzle();
26
26
  this._prepareStatements();
27
27
  }
28
- /** @private 预编译复杂查询(仅保留 drizzle 无法表达的递归 CTE) */
28
+ /** 预编译复杂查询(仅保留 drizzle 无法表达的递归 CTE) */
29
29
  _prepareStatements() {
30
30
  // ── 环检测 (递归 CTE) — drizzle 不支持递归 CTE ──
31
31
  this._reachableStmt = this.db.prepare(`
@@ -21,7 +21,7 @@ export class TokenUsageStore {
21
21
  #dailyStmt;
22
22
  #bySourceStmt;
23
23
  #summaryStmt;
24
- /** @type {{ data: object, expireAt: number } | null} */
24
+ /** | null} */
25
25
  #reportCache = null;
26
26
  /** @param db — raw better-sqlite3 instance */
27
27
  constructor(db, drizzle) {
@@ -13,7 +13,7 @@ export declare class ActionPipeline {
13
13
  register(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
14
14
  /**
15
15
  * 执行管线
16
- * @param {{ type: string, name?: string, params?: object }} trigger
16
+ * @param trigger
17
17
  * @returns >}
18
18
  */
19
19
  execute(trigger: {
@@ -20,7 +20,7 @@ export class ActionPipeline {
20
20
  }
21
21
  /**
22
22
  * 执行管线
23
- * @param {{ type: string, name?: string, params?: object }} trigger
23
+ * @param trigger
24
24
  * @returns >}
25
25
  */
26
26
  async execute(trigger, context) {
@@ -7,9 +7,9 @@
7
7
  * @module shared/BootstrapEventEmitter
8
8
  */
9
9
  export class BootstrapEventEmitter {
10
- /** @type {object|null} EventBus 实例 */
10
+ /** EventBus 实例 */
11
11
  #eventBus;
12
- /** @type {object|null} BootstrapTaskManager 实例 */
12
+ /** BootstrapTaskManager 实例 */
13
13
  #taskManager;
14
14
  /** @param container DI Container */
15
15
  constructor(container) {
@@ -102,7 +102,7 @@ export declare class BootstrapTaskManager {
102
102
  *
103
103
  * 如果上一个会话仍在运行,自动 abort 后再创建新会话(防止重复触发产出重复 Candidate)。
104
104
  *
105
- * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
105
+ * @param taskDefs 任务定义列表
106
106
  */
107
107
  startSession(taskDefs: TaskDef[]): BootstrapSession;
108
108
  /**
@@ -118,7 +118,7 @@ class BootstrapSession {
118
118
  export class BootstrapTaskManager {
119
119
  #currentSession = null;
120
120
  #eventBus = null;
121
- /** @type {Function|null} 获取 RealtimeService 的 getter(延迟获取,避免循环依赖) */
121
+ /** 获取 RealtimeService 的 getter(延迟获取,避免循环依赖) */
122
122
  #getRealtimeService = null;
123
123
  constructor({ eventBus, getRealtimeService } = {}) {
124
124
  this.#eventBus = eventBus || null;
@@ -132,7 +132,7 @@ export class BootstrapTaskManager {
132
132
  *
133
133
  * 如果上一个会话仍在运行,自动 abort 后再创建新会话(防止重复触发产出重复 Candidate)。
134
134
  *
135
- * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
135
+ * @param taskDefs 任务定义列表
136
136
  */
137
137
  startSession(taskDefs) {
138
138
  // ── 并发锁:如果上一个 session 还在运行,先中止 ──
@@ -25,7 +25,7 @@ export declare class DimensionCopy {
25
25
  /**
26
26
  * 批量为维度数组注入语言差异化文案(单语言版本)
27
27
  * 会直接修改维度对象的 label 和 guide 字段
28
- * @param {Array<{ id: string, label: string, guide: string }>} dimensions
28
+ * @param dimensions
29
29
  * @param lang 主语言
30
30
  * @returns >} 原数组引用
31
31
  */
@@ -46,7 +46,7 @@ export declare class DimensionCopy {
46
46
  * - guide 以主语言为主体,追加次要语言的差异化要点
47
47
  * - 如果主语言和次要语言属于同一语言族,跳过(避免重复)
48
48
  *
49
- * @param {Array<{ id: string, label: string, guide: string }>} dimensions
49
+ * @param dimensions
50
50
  * @param primary 主语言 ID
51
51
  * @param secondary 次要语言 ID 列表
52
52
  * @returns >} 原数组引用
@@ -311,7 +311,7 @@ export class DimensionCopy {
311
311
  /**
312
312
  * 批量为维度数组注入语言差异化文案(单语言版本)
313
313
  * 会直接修改维度对象的 label 和 guide 字段
314
- * @param {Array<{ id: string, label: string, guide: string }>} dimensions
314
+ * @param dimensions
315
315
  * @param lang 主语言
316
316
  * @returns >} 原数组引用
317
317
  */
@@ -333,7 +333,7 @@ export class DimensionCopy {
333
333
  * - guide 以主语言为主体,追加次要语言的差异化要点
334
334
  * - 如果主语言和次要语言属于同一语言族,跳过(避免重复)
335
335
  *
336
- * @param {Array<{ id: string, label: string, guide: string }>} dimensions
336
+ * @param dimensions
337
337
  * @param primary 主语言 ID
338
338
  * @param secondary 次要语言 ID 列表
339
339
  * @returns >} 原数组引用
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * 设计原则:
10
10
  * 1. 内容来源统一 — 从 _loadEntries() 已加载的知识条目中提取
11
- * 2. 格式差异化同一数据按目标工具特性适配输出
11
+ * 2. 互补不重复.mdc 处理行为规则,Channel F 处理项目知识
12
12
  * 3. 轻量索引 — 只输出摘要和规则,详细内容引导至 MCP 工具
13
13
  * 4. 幂等生成 — 每次 deliver 重写全部文件,不做增量 diff
14
14
  */
@@ -59,7 +59,6 @@ export declare class AgentInstructionsGenerator {
59
59
  };
60
60
  /**
61
61
  * 从知识条目构建共享内容段
62
- * @private
63
62
  */
64
63
  _buildSections({ rules, patterns, skills, }: {
65
64
  rules: KnowledgeEntryProps[];
@@ -71,7 +70,6 @@ export declare class AgentInstructionsGenerator {
71
70
  skillLines: string[];
72
71
  toolLines: string[];
73
72
  };
74
- /** @private */
75
73
  _writeAgentsMd(sections: {
76
74
  ruleLines: string[];
77
75
  patternRows: string[];
@@ -82,7 +80,6 @@ export declare class AgentInstructionsGenerator {
82
80
  tokensUsed: number;
83
81
  skipped: boolean;
84
82
  };
85
- /** @private */
86
83
  _writeClaudeMd(sections: {
87
84
  ruleLines: string[];
88
85
  patternRows: string[];
@@ -95,10 +92,9 @@ export declare class AgentInstructionsGenerator {
95
92
  };
96
93
  /**
97
94
  * 动态生成 copilot-instructions.md
98
- * 替代原有的静态模板复制
99
- * @private
95
+ * 读取 templates/instructions/conventions.md + HTML markers
100
96
  */
101
- _writeCopilotInstructions(sections: {
97
+ _writeCopilotInstructions(_sections: {
102
98
  ruleLines: string[];
103
99
  patternRows: string[];
104
100
  skillLines: string[];
@@ -109,14 +105,9 @@ export declare class AgentInstructionsGenerator {
109
105
  skipped: boolean;
110
106
  };
111
107
  /**
112
- * 核心约束(所有 Agent 共享)
113
- * @private
108
+ * 读取 templates/instructions/conventions.md — 唯一内容源
109
+ * .mdc、copilot-instructions.md、Channel F 动态版全部从这里读取
114
110
  */
115
- _renderConstraints(): string[];
116
- /**
117
- * 推荐工作流(AGENTS.md 用)
118
- * @private
119
- */
120
- _renderWorkflow(): string[];
111
+ _loadConventionsTemplate(): string;
121
112
  }
122
113
  export default AgentInstructionsGenerator;