codexmate 0.0.29 → 0.0.30

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 (143) hide show
  1. package/README.md +421 -421
  2. package/README.zh.md +354 -354
  3. package/cli/agents-files.js +224 -224
  4. package/cli/archive-helpers.js +446 -446
  5. package/cli/auth-profiles.js +375 -375
  6. package/cli/builtin-proxy.js +1725 -1725
  7. package/cli/claude-proxy.js +1022 -1022
  8. package/cli/config-bootstrap.js +402 -384
  9. package/cli/config-health.js +454 -338
  10. package/cli/doctor-core.js +903 -903
  11. package/cli/import-skills-url.js +356 -356
  12. package/cli/local-bridge.js +324 -0
  13. package/cli/openai-bridge.js +1653 -1576
  14. package/cli/openclaw-config.js +629 -629
  15. package/cli/session-convert-args.js +65 -65
  16. package/cli/session-convert-io.js +82 -82
  17. package/cli/session-convert.js +43 -43
  18. package/cli/session-usage.concurrent.js +28 -28
  19. package/cli/session-usage.js +118 -118
  20. package/cli/session-usage.models.js +176 -176
  21. package/cli/skills.js +1141 -1141
  22. package/cli/zip-commands.js +510 -510
  23. package/cli.js +15481 -15340
  24. package/lib/automation.js +404 -404
  25. package/lib/cli-file-utils.js +151 -151
  26. package/lib/cli-models-utils.js +440 -440
  27. package/lib/cli-network-utils.js +190 -190
  28. package/lib/cli-path-utils.js +85 -85
  29. package/lib/cli-session-utils.js +121 -121
  30. package/lib/cli-sessions.js +417 -417
  31. package/lib/cli-utils.js +155 -155
  32. package/lib/cli-webhook.js +126 -126
  33. package/lib/download-artifacts.js +92 -92
  34. package/lib/mcp-stdio.js +453 -453
  35. package/lib/task-orchestrator.js +869 -869
  36. package/lib/text-diff.js +303 -303
  37. package/lib/workflow-engine.js +340 -340
  38. package/package.json +76 -76
  39. package/plugins/README.md +20 -20
  40. package/plugins/README.zh-CN.md +20 -20
  41. package/plugins/prompt-templates/comment-polish/index.mjs +25 -25
  42. package/plugins/prompt-templates/computed.mjs +253 -253
  43. package/plugins/prompt-templates/index.mjs +8 -8
  44. package/plugins/prompt-templates/manifest.mjs +15 -15
  45. package/plugins/prompt-templates/methods.mjs +553 -553
  46. package/plugins/prompt-templates/overview.mjs +91 -91
  47. package/plugins/prompt-templates/ownership.mjs +19 -19
  48. package/plugins/prompt-templates/rule-ack/index.mjs +21 -21
  49. package/plugins/prompt-templates/storage.mjs +64 -64
  50. package/plugins/registry.mjs +16 -16
  51. package/web-ui/app.js +645 -639
  52. package/web-ui/index.html +36 -36
  53. package/web-ui/logic.agents-diff.mjs +386 -386
  54. package/web-ui/logic.claude.mjs +168 -168
  55. package/web-ui/logic.codex.mjs +69 -69
  56. package/web-ui/logic.mjs +5 -5
  57. package/web-ui/logic.runtime.mjs +128 -128
  58. package/web-ui/logic.session-convert.mjs +70 -70
  59. package/web-ui/logic.sessions.mjs +765 -765
  60. package/web-ui/modules/api.mjs +90 -90
  61. package/web-ui/modules/app.computed.dashboard.mjs +248 -225
  62. package/web-ui/modules/app.computed.index.mjs +17 -17
  63. package/web-ui/modules/app.computed.main-tabs.mjs +205 -205
  64. package/web-ui/modules/app.computed.session.mjs +999 -999
  65. package/web-ui/modules/app.constants.mjs +15 -15
  66. package/web-ui/modules/app.methods.agents.mjs +632 -632
  67. package/web-ui/modules/app.methods.claude-config.mjs +200 -200
  68. package/web-ui/modules/app.methods.codex-config.mjs +917 -892
  69. package/web-ui/modules/app.methods.index.mjs +94 -94
  70. package/web-ui/modules/app.methods.install.mjs +205 -205
  71. package/web-ui/modules/app.methods.navigation.mjs +774 -761
  72. package/web-ui/modules/app.methods.openclaw-core.mjs +814 -814
  73. package/web-ui/modules/app.methods.openclaw-editing.mjs +372 -372
  74. package/web-ui/modules/app.methods.openclaw-persist.mjs +369 -369
  75. package/web-ui/modules/app.methods.providers.mjs +529 -493
  76. package/web-ui/modules/app.methods.runtime.mjs +345 -345
  77. package/web-ui/modules/app.methods.session-actions.mjs +593 -593
  78. package/web-ui/modules/app.methods.session-browser.mjs +984 -984
  79. package/web-ui/modules/app.methods.session-timeline.mjs +479 -479
  80. package/web-ui/modules/app.methods.session-trash.mjs +438 -438
  81. package/web-ui/modules/app.methods.startup-claude.mjs +534 -533
  82. package/web-ui/modules/app.methods.task-orchestration.mjs +556 -556
  83. package/web-ui/modules/app.methods.webhook.mjs +79 -79
  84. package/web-ui/modules/config-mode.computed.mjs +124 -124
  85. package/web-ui/modules/config-template-confirm-pref.mjs +33 -33
  86. package/web-ui/modules/i18n.dict.mjs +3146 -3131
  87. package/web-ui/modules/i18n.mjs +62 -62
  88. package/web-ui/modules/plugins.computed.mjs +3 -3
  89. package/web-ui/modules/plugins.methods.mjs +3 -3
  90. package/web-ui/modules/plugins.storage.mjs +11 -11
  91. package/web-ui/modules/provider-url-display.mjs +17 -17
  92. package/web-ui/modules/sessions-filters-url.mjs +85 -85
  93. package/web-ui/modules/skills.computed.mjs +107 -107
  94. package/web-ui/modules/skills.methods.mjs +482 -481
  95. package/web-ui/partials/index/layout-footer.html +13 -13
  96. package/web-ui/partials/index/layout-header.html +500 -500
  97. package/web-ui/partials/index/modal-config-template-agents.html +174 -174
  98. package/web-ui/partials/index/modal-confirm-toast.html +32 -32
  99. package/web-ui/partials/index/modal-health-check.html +45 -45
  100. package/web-ui/partials/index/modal-openclaw-config.html +280 -280
  101. package/web-ui/partials/index/modal-skills.html +200 -200
  102. package/web-ui/partials/index/modals-basic.html +162 -162
  103. package/web-ui/partials/index/panel-config-claude.html +194 -194
  104. package/web-ui/partials/index/panel-config-codex.html +337 -323
  105. package/web-ui/partials/index/panel-config-openclaw.html +83 -83
  106. package/web-ui/partials/index/panel-dashboard.html +219 -186
  107. package/web-ui/partials/index/panel-docs.html +147 -147
  108. package/web-ui/partials/index/panel-market.html +177 -177
  109. package/web-ui/partials/index/panel-orchestration.html +391 -391
  110. package/web-ui/partials/index/panel-plugins.html +253 -253
  111. package/web-ui/partials/index/panel-sessions.html +308 -316
  112. package/web-ui/partials/index/panel-settings.html +190 -190
  113. package/web-ui/partials/index/panel-trash.html +88 -88
  114. package/web-ui/partials/index/panel-usage.html +371 -371
  115. package/web-ui/res/json5.min.js +1 -1
  116. package/web-ui/res/vue.global.prod.js +13 -13
  117. package/web-ui/session-helpers.mjs +594 -576
  118. package/web-ui/source-bundle.cjs +233 -233
  119. package/web-ui/styles/base-theme.css +281 -281
  120. package/web-ui/styles/controls-forms.css +422 -422
  121. package/web-ui/styles/dashboard.css +406 -274
  122. package/web-ui/styles/docs-panel.css +271 -271
  123. package/web-ui/styles/feedback.css +108 -108
  124. package/web-ui/styles/health-check-dialog.css +144 -144
  125. package/web-ui/styles/layout-shell.css +626 -626
  126. package/web-ui/styles/modals-core.css +466 -466
  127. package/web-ui/styles/navigation-panels.css +391 -391
  128. package/web-ui/styles/openclaw-structured.css +266 -266
  129. package/web-ui/styles/plugins-panel.css +564 -523
  130. package/web-ui/styles/responsive.css +454 -454
  131. package/web-ui/styles/sessions-list.css +417 -419
  132. package/web-ui/styles/sessions-preview.css +407 -411
  133. package/web-ui/styles/sessions-toolbar-trash.css +334 -330
  134. package/web-ui/styles/sessions-usage.css +1040 -1040
  135. package/web-ui/styles/settings-panel.css +349 -349
  136. package/web-ui/styles/skills-list.css +305 -303
  137. package/web-ui/styles/skills-market.css +429 -406
  138. package/web-ui/styles/task-orchestration.css +822 -822
  139. package/web-ui/styles/titles-cards.css +472 -472
  140. package/web-ui/styles/trash-panel.css +90 -90
  141. package/web-ui/styles/webhook.css +81 -81
  142. package/web-ui/styles.css +23 -23
  143. package/web-ui.html +17 -17
@@ -1,224 +1,224 @@
1
- function createAgentsFileController(deps = {}) {
2
- const {
3
- fs,
4
- path,
5
- os,
6
- ensureDir,
7
- stripUtf8Bom,
8
- detectLineEnding,
9
- normalizeLineEnding,
10
- ensureUtf8Bom,
11
- buildLineDiff,
12
- CONFIG_DIR,
13
- AGENTS_FILE_NAME,
14
- CLAUDE_DIR,
15
- CLAUDE_MD_FILE_NAME,
16
- readOpenclawAgentsFile,
17
- readOpenclawWorkspaceFile
18
- } = deps;
19
-
20
- if (!fs) throw new Error('createAgentsFileController 缺少 fs');
21
- if (!path) throw new Error('createAgentsFileController 缺少 path');
22
- if (!os) throw new Error('createAgentsFileController 缺少 os');
23
- if (typeof ensureDir !== 'function') throw new Error('createAgentsFileController 缺少 ensureDir');
24
- if (typeof stripUtf8Bom !== 'function') throw new Error('createAgentsFileController 缺少 stripUtf8Bom');
25
- if (typeof detectLineEnding !== 'function') throw new Error('createAgentsFileController 缺少 detectLineEnding');
26
- if (typeof normalizeLineEnding !== 'function') throw new Error('createAgentsFileController 缺少 normalizeLineEnding');
27
- if (typeof ensureUtf8Bom !== 'function') throw new Error('createAgentsFileController 缺少 ensureUtf8Bom');
28
- if (typeof buildLineDiff !== 'function') throw new Error('createAgentsFileController 缺少 buildLineDiff');
29
- if (typeof CONFIG_DIR !== 'string' || !CONFIG_DIR) throw new Error('createAgentsFileController 缺少 CONFIG_DIR');
30
- if (typeof AGENTS_FILE_NAME !== 'string' || !AGENTS_FILE_NAME) throw new Error('createAgentsFileController 缺少 AGENTS_FILE_NAME');
31
- if (typeof CLAUDE_DIR !== 'string' || !CLAUDE_DIR) throw new Error('createAgentsFileController 缺少 CLAUDE_DIR');
32
- if (typeof CLAUDE_MD_FILE_NAME !== 'string' || !CLAUDE_MD_FILE_NAME) throw new Error('createAgentsFileController 缺少 CLAUDE_MD_FILE_NAME');
33
- if (typeof readOpenclawAgentsFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawAgentsFile');
34
- if (typeof readOpenclawWorkspaceFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawWorkspaceFile');
35
-
36
- function resolveAgentsFilePath(params = {}) {
37
- const baseDir = typeof params.baseDir === 'string' && params.baseDir.trim()
38
- ? params.baseDir.trim()
39
- : CONFIG_DIR;
40
- return path.join(baseDir, AGENTS_FILE_NAME);
41
- }
42
-
43
- function validateAgentsBaseDir(filePath) {
44
- const dirPath = path.dirname(filePath);
45
- try {
46
- const stat = fs.statSync(dirPath);
47
- if (!stat.isDirectory()) {
48
- return { error: `目标不是目录: ${dirPath}` };
49
- }
50
- } catch (e) {
51
- return { error: `目标目录不存在: ${dirPath}` };
52
- }
53
- return { ok: true, dirPath };
54
- }
55
-
56
- function resolveClaudeMdFilePath() {
57
- return path.join(CLAUDE_DIR, CLAUDE_MD_FILE_NAME);
58
- }
59
-
60
- function readClaudeMdFile(params = {}) {
61
- const filePath = resolveClaudeMdFilePath();
62
- const lineEndingFallback = os.EOL === '\r\n' ? '\r\n' : '\n';
63
- if (!fs.existsSync(filePath)) {
64
- return {
65
- exists: false,
66
- path: filePath,
67
- content: '',
68
- lineEnding: lineEndingFallback
69
- };
70
- }
71
- if (params.metaOnly) {
72
- return {
73
- exists: true,
74
- path: filePath,
75
- content: '',
76
- lineEnding: lineEndingFallback
77
- };
78
- }
79
- try {
80
- const raw = fs.readFileSync(filePath, 'utf-8');
81
- return {
82
- exists: true,
83
- path: filePath,
84
- content: stripUtf8Bom(raw),
85
- lineEnding: detectLineEnding(raw)
86
- };
87
- } catch (e) {
88
- return { error: `读取 CLAUDE.md 失败: ${e.message}` };
89
- }
90
- }
91
-
92
- function applyClaudeMdFile(params = {}) {
93
- const filePath = resolveClaudeMdFilePath();
94
- const content = typeof params.content === 'string' ? params.content : '';
95
- const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
96
- const normalized = normalizeLineEnding(content, lineEnding);
97
- const finalContent = ensureUtf8Bom(normalized);
98
- try {
99
- ensureDir(CLAUDE_DIR);
100
- fs.writeFileSync(filePath, finalContent, 'utf-8');
101
- return { success: true, path: filePath };
102
- } catch (e) {
103
- return { error: `写入 CLAUDE.md 失败: ${e.message}` };
104
- }
105
- }
106
-
107
- function readAgentsFile(params = {}) {
108
- const filePath = resolveAgentsFilePath(params);
109
- const dirCheck = validateAgentsBaseDir(filePath);
110
- if (dirCheck.error) {
111
- return { error: dirCheck.error };
112
- }
113
-
114
- if (!fs.existsSync(filePath)) {
115
- return {
116
- exists: false,
117
- path: filePath,
118
- content: '',
119
- lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
120
- };
121
- }
122
-
123
- if (params.metaOnly) {
124
- return {
125
- exists: true,
126
- path: filePath,
127
- content: '',
128
- lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
129
- };
130
- }
131
-
132
- try {
133
- const raw = fs.readFileSync(filePath, 'utf-8');
134
- return {
135
- exists: true,
136
- path: filePath,
137
- content: stripUtf8Bom(raw),
138
- lineEnding: detectLineEnding(raw)
139
- };
140
- } catch (e) {
141
- return { error: `读取 AGENTS.md 失败: ${e.message}` };
142
- }
143
- }
144
-
145
- function applyAgentsFile(params = {}) {
146
- const filePath = resolveAgentsFilePath(params);
147
- const dirCheck = validateAgentsBaseDir(filePath);
148
- if (dirCheck.error) {
149
- return { error: dirCheck.error };
150
- }
151
-
152
- const content = typeof params.content === 'string' ? params.content : '';
153
- const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
154
- const normalized = normalizeLineEnding(content, lineEnding);
155
- const finalContent = ensureUtf8Bom(normalized);
156
-
157
- try {
158
- fs.writeFileSync(filePath, finalContent, 'utf-8');
159
- return { success: true, path: filePath };
160
- } catch (e) {
161
- return { error: `写入 AGENTS.md 失败: ${e.message}` };
162
- }
163
- }
164
-
165
- function normalizeDiffText(input) {
166
- const safe = typeof input === 'string' ? input : '';
167
- return normalizeLineEnding(stripUtf8Bom(safe), '\n');
168
- }
169
-
170
- function buildAgentsDiff(params = {}) {
171
- const hasBaseContent = typeof params.baseContent === 'string';
172
- const contextRaw = typeof params.context === 'string' ? params.context.trim() : '';
173
- const context = contextRaw || 'codex';
174
- const metaOnly = hasBaseContent;
175
- let readResult;
176
- if (context === 'claude-md') {
177
- readResult = readClaudeMdFile({ metaOnly });
178
- } else if (context === 'openclaw') {
179
- readResult = readOpenclawAgentsFile({ metaOnly });
180
- } else if (context === 'openclaw-workspace') {
181
- readResult = readOpenclawWorkspaceFile({ ...params, metaOnly });
182
- } else if (context === 'codex') {
183
- readResult = readAgentsFile({ ...params, metaOnly });
184
- } else {
185
- return { error: `Unsupported agents diff context: ${context}` };
186
- }
187
- if (readResult && readResult.error) {
188
- return { error: readResult.error };
189
- }
190
-
191
- const beforeText = normalizeDiffText(
192
- hasBaseContent ? params.baseContent : (readResult && readResult.content ? readResult.content : '')
193
- );
194
- const afterText = normalizeDiffText(params.content);
195
- const diff = buildLineDiff(beforeText, afterText);
196
- const hasChanges = diff.truncated ? beforeText !== afterText : (diff.stats.added > 0 || diff.stats.removed > 0);
197
- return {
198
- diff: {
199
- ...diff,
200
- hasChanges
201
- },
202
- path: readResult && readResult.path ? readResult.path : '',
203
- exists: !!(readResult && readResult.exists),
204
- context,
205
- configError: readResult && readResult.configError ? readResult.configError : ''
206
- };
207
- }
208
-
209
- return {
210
- resolveAgentsFilePath,
211
- validateAgentsBaseDir,
212
- resolveClaudeMdFilePath,
213
- readClaudeMdFile,
214
- applyClaudeMdFile,
215
- readAgentsFile,
216
- applyAgentsFile,
217
- normalizeDiffText,
218
- buildAgentsDiff
219
- };
220
- }
221
-
222
- module.exports = {
223
- createAgentsFileController
224
- };
1
+ function createAgentsFileController(deps = {}) {
2
+ const {
3
+ fs,
4
+ path,
5
+ os,
6
+ ensureDir,
7
+ stripUtf8Bom,
8
+ detectLineEnding,
9
+ normalizeLineEnding,
10
+ ensureUtf8Bom,
11
+ buildLineDiff,
12
+ CONFIG_DIR,
13
+ AGENTS_FILE_NAME,
14
+ CLAUDE_DIR,
15
+ CLAUDE_MD_FILE_NAME,
16
+ readOpenclawAgentsFile,
17
+ readOpenclawWorkspaceFile
18
+ } = deps;
19
+
20
+ if (!fs) throw new Error('createAgentsFileController 缺少 fs');
21
+ if (!path) throw new Error('createAgentsFileController 缺少 path');
22
+ if (!os) throw new Error('createAgentsFileController 缺少 os');
23
+ if (typeof ensureDir !== 'function') throw new Error('createAgentsFileController 缺少 ensureDir');
24
+ if (typeof stripUtf8Bom !== 'function') throw new Error('createAgentsFileController 缺少 stripUtf8Bom');
25
+ if (typeof detectLineEnding !== 'function') throw new Error('createAgentsFileController 缺少 detectLineEnding');
26
+ if (typeof normalizeLineEnding !== 'function') throw new Error('createAgentsFileController 缺少 normalizeLineEnding');
27
+ if (typeof ensureUtf8Bom !== 'function') throw new Error('createAgentsFileController 缺少 ensureUtf8Bom');
28
+ if (typeof buildLineDiff !== 'function') throw new Error('createAgentsFileController 缺少 buildLineDiff');
29
+ if (typeof CONFIG_DIR !== 'string' || !CONFIG_DIR) throw new Error('createAgentsFileController 缺少 CONFIG_DIR');
30
+ if (typeof AGENTS_FILE_NAME !== 'string' || !AGENTS_FILE_NAME) throw new Error('createAgentsFileController 缺少 AGENTS_FILE_NAME');
31
+ if (typeof CLAUDE_DIR !== 'string' || !CLAUDE_DIR) throw new Error('createAgentsFileController 缺少 CLAUDE_DIR');
32
+ if (typeof CLAUDE_MD_FILE_NAME !== 'string' || !CLAUDE_MD_FILE_NAME) throw new Error('createAgentsFileController 缺少 CLAUDE_MD_FILE_NAME');
33
+ if (typeof readOpenclawAgentsFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawAgentsFile');
34
+ if (typeof readOpenclawWorkspaceFile !== 'function') throw new Error('createAgentsFileController 缺少 readOpenclawWorkspaceFile');
35
+
36
+ function resolveAgentsFilePath(params = {}) {
37
+ const baseDir = typeof params.baseDir === 'string' && params.baseDir.trim()
38
+ ? params.baseDir.trim()
39
+ : CONFIG_DIR;
40
+ return path.join(baseDir, AGENTS_FILE_NAME);
41
+ }
42
+
43
+ function validateAgentsBaseDir(filePath) {
44
+ const dirPath = path.dirname(filePath);
45
+ try {
46
+ const stat = fs.statSync(dirPath);
47
+ if (!stat.isDirectory()) {
48
+ return { error: `目标不是目录: ${dirPath}` };
49
+ }
50
+ } catch (e) {
51
+ return { error: `目标目录不存在: ${dirPath}` };
52
+ }
53
+ return { ok: true, dirPath };
54
+ }
55
+
56
+ function resolveClaudeMdFilePath() {
57
+ return path.join(CLAUDE_DIR, CLAUDE_MD_FILE_NAME);
58
+ }
59
+
60
+ function readClaudeMdFile(params = {}) {
61
+ const filePath = resolveClaudeMdFilePath();
62
+ const lineEndingFallback = os.EOL === '\r\n' ? '\r\n' : '\n';
63
+ if (!fs.existsSync(filePath)) {
64
+ return {
65
+ exists: false,
66
+ path: filePath,
67
+ content: '',
68
+ lineEnding: lineEndingFallback
69
+ };
70
+ }
71
+ if (params.metaOnly) {
72
+ return {
73
+ exists: true,
74
+ path: filePath,
75
+ content: '',
76
+ lineEnding: lineEndingFallback
77
+ };
78
+ }
79
+ try {
80
+ const raw = fs.readFileSync(filePath, 'utf-8');
81
+ return {
82
+ exists: true,
83
+ path: filePath,
84
+ content: stripUtf8Bom(raw),
85
+ lineEnding: detectLineEnding(raw)
86
+ };
87
+ } catch (e) {
88
+ return { error: `读取 CLAUDE.md 失败: ${e.message}` };
89
+ }
90
+ }
91
+
92
+ function applyClaudeMdFile(params = {}) {
93
+ const filePath = resolveClaudeMdFilePath();
94
+ const content = typeof params.content === 'string' ? params.content : '';
95
+ const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
96
+ const normalized = normalizeLineEnding(content, lineEnding);
97
+ const finalContent = ensureUtf8Bom(normalized);
98
+ try {
99
+ ensureDir(CLAUDE_DIR);
100
+ fs.writeFileSync(filePath, finalContent, 'utf-8');
101
+ return { success: true, path: filePath };
102
+ } catch (e) {
103
+ return { error: `写入 CLAUDE.md 失败: ${e.message}` };
104
+ }
105
+ }
106
+
107
+ function readAgentsFile(params = {}) {
108
+ const filePath = resolveAgentsFilePath(params);
109
+ const dirCheck = validateAgentsBaseDir(filePath);
110
+ if (dirCheck.error) {
111
+ return { error: dirCheck.error };
112
+ }
113
+
114
+ if (!fs.existsSync(filePath)) {
115
+ return {
116
+ exists: false,
117
+ path: filePath,
118
+ content: '',
119
+ lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
120
+ };
121
+ }
122
+
123
+ if (params.metaOnly) {
124
+ return {
125
+ exists: true,
126
+ path: filePath,
127
+ content: '',
128
+ lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
129
+ };
130
+ }
131
+
132
+ try {
133
+ const raw = fs.readFileSync(filePath, 'utf-8');
134
+ return {
135
+ exists: true,
136
+ path: filePath,
137
+ content: stripUtf8Bom(raw),
138
+ lineEnding: detectLineEnding(raw)
139
+ };
140
+ } catch (e) {
141
+ return { error: `读取 AGENTS.md 失败: ${e.message}` };
142
+ }
143
+ }
144
+
145
+ function applyAgentsFile(params = {}) {
146
+ const filePath = resolveAgentsFilePath(params);
147
+ const dirCheck = validateAgentsBaseDir(filePath);
148
+ if (dirCheck.error) {
149
+ return { error: dirCheck.error };
150
+ }
151
+
152
+ const content = typeof params.content === 'string' ? params.content : '';
153
+ const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
154
+ const normalized = normalizeLineEnding(content, lineEnding);
155
+ const finalContent = ensureUtf8Bom(normalized);
156
+
157
+ try {
158
+ fs.writeFileSync(filePath, finalContent, 'utf-8');
159
+ return { success: true, path: filePath };
160
+ } catch (e) {
161
+ return { error: `写入 AGENTS.md 失败: ${e.message}` };
162
+ }
163
+ }
164
+
165
+ function normalizeDiffText(input) {
166
+ const safe = typeof input === 'string' ? input : '';
167
+ return normalizeLineEnding(stripUtf8Bom(safe), '\n');
168
+ }
169
+
170
+ function buildAgentsDiff(params = {}) {
171
+ const hasBaseContent = typeof params.baseContent === 'string';
172
+ const contextRaw = typeof params.context === 'string' ? params.context.trim() : '';
173
+ const context = contextRaw || 'codex';
174
+ const metaOnly = hasBaseContent;
175
+ let readResult;
176
+ if (context === 'claude-md') {
177
+ readResult = readClaudeMdFile({ metaOnly });
178
+ } else if (context === 'openclaw') {
179
+ readResult = readOpenclawAgentsFile({ metaOnly });
180
+ } else if (context === 'openclaw-workspace') {
181
+ readResult = readOpenclawWorkspaceFile({ ...params, metaOnly });
182
+ } else if (context === 'codex') {
183
+ readResult = readAgentsFile({ ...params, metaOnly });
184
+ } else {
185
+ return { error: `Unsupported agents diff context: ${context}` };
186
+ }
187
+ if (readResult && readResult.error) {
188
+ return { error: readResult.error };
189
+ }
190
+
191
+ const beforeText = normalizeDiffText(
192
+ hasBaseContent ? params.baseContent : (readResult && readResult.content ? readResult.content : '')
193
+ );
194
+ const afterText = normalizeDiffText(params.content);
195
+ const diff = buildLineDiff(beforeText, afterText);
196
+ const hasChanges = diff.truncated ? beforeText !== afterText : (diff.stats.added > 0 || diff.stats.removed > 0);
197
+ return {
198
+ diff: {
199
+ ...diff,
200
+ hasChanges
201
+ },
202
+ path: readResult && readResult.path ? readResult.path : '',
203
+ exists: !!(readResult && readResult.exists),
204
+ context,
205
+ configError: readResult && readResult.configError ? readResult.configError : ''
206
+ };
207
+ }
208
+
209
+ return {
210
+ resolveAgentsFilePath,
211
+ validateAgentsBaseDir,
212
+ resolveClaudeMdFilePath,
213
+ readClaudeMdFile,
214
+ applyClaudeMdFile,
215
+ readAgentsFile,
216
+ applyAgentsFile,
217
+ normalizeDiffText,
218
+ buildAgentsDiff
219
+ };
220
+ }
221
+
222
+ module.exports = {
223
+ createAgentsFileController
224
+ };