codexmate 0.0.32 → 0.0.34

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 (148) hide show
  1. package/README.md +147 -363
  2. package/README.zh.md +147 -371
  3. package/cli/agents-files.js +230 -224
  4. package/cli/archive-helpers.js +453 -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 -402
  9. package/cli/config-health.js +454 -454
  10. package/cli/doctor-core.js +903 -903
  11. package/cli/import-skills-url.js +356 -356
  12. package/cli/local-bridge.js +556 -324
  13. package/cli/openai-bridge.js +1653 -1653
  14. package/cli/openclaw-config.js +629 -629
  15. package/cli/session-convert-args.js +69 -69
  16. package/cli/session-convert-io.js +82 -82
  17. package/cli/session-convert.js +150 -150
  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/update.js +171 -0
  23. package/cli/zip-commands.js +510 -510
  24. package/cli.js +16079 -15829
  25. package/lib/automation.js +404 -404
  26. package/lib/cli-file-utils.js +151 -151
  27. package/lib/cli-models-utils.js +440 -440
  28. package/lib/cli-network-utils.js +190 -190
  29. package/lib/cli-path-utils.js +85 -85
  30. package/lib/cli-session-utils.js +121 -121
  31. package/lib/cli-sessions.js +427 -426
  32. package/lib/cli-utils.js +155 -155
  33. package/lib/cli-webhook.js +154 -126
  34. package/lib/download-artifacts.js +92 -92
  35. package/lib/mcp-stdio.js +453 -453
  36. package/lib/task-orchestrator.js +869 -869
  37. package/lib/text-diff.js +303 -303
  38. package/lib/win-tray.js +119 -0
  39. package/lib/workflow-engine.js +340 -340
  40. package/package.json +76 -76
  41. package/plugins/README.md +20 -20
  42. package/plugins/README.zh-CN.md +20 -20
  43. package/plugins/prompt-templates/comment-polish/index.mjs +25 -25
  44. package/plugins/prompt-templates/computed.mjs +253 -253
  45. package/plugins/prompt-templates/index.mjs +8 -8
  46. package/plugins/prompt-templates/manifest.mjs +15 -15
  47. package/plugins/prompt-templates/methods.mjs +553 -553
  48. package/plugins/prompt-templates/overview.mjs +91 -91
  49. package/plugins/prompt-templates/ownership.mjs +19 -19
  50. package/plugins/prompt-templates/rule-ack/index.mjs +21 -21
  51. package/plugins/prompt-templates/storage.mjs +64 -64
  52. package/plugins/registry.mjs +16 -16
  53. package/web-ui/app.js +654 -647
  54. package/web-ui/index.html +37 -36
  55. package/web-ui/logic.agents-diff.mjs +386 -386
  56. package/web-ui/logic.claude.mjs +172 -168
  57. package/web-ui/logic.codex.mjs +69 -69
  58. package/web-ui/logic.mjs +5 -5
  59. package/web-ui/logic.runtime.mjs +128 -128
  60. package/web-ui/logic.session-convert.mjs +70 -70
  61. package/web-ui/logic.sessions.mjs +781 -781
  62. package/web-ui/modules/api.mjs +90 -90
  63. package/web-ui/modules/app.computed.dashboard.mjs +248 -248
  64. package/web-ui/modules/app.computed.index.mjs +17 -17
  65. package/web-ui/modules/app.computed.main-tabs.mjs +205 -205
  66. package/web-ui/modules/app.computed.session.mjs +735 -693
  67. package/web-ui/modules/app.constants.mjs +15 -15
  68. package/web-ui/modules/app.methods.agents.mjs +651 -651
  69. package/web-ui/modules/app.methods.claude-config.mjs +306 -200
  70. package/web-ui/modules/app.methods.codex-config.mjs +869 -861
  71. package/web-ui/modules/app.methods.index.mjs +94 -94
  72. package/web-ui/modules/app.methods.install.mjs +205 -205
  73. package/web-ui/modules/app.methods.navigation.mjs +788 -774
  74. package/web-ui/modules/app.methods.openclaw-core.mjs +814 -814
  75. package/web-ui/modules/app.methods.openclaw-editing.mjs +372 -372
  76. package/web-ui/modules/app.methods.openclaw-persist.mjs +369 -369
  77. package/web-ui/modules/app.methods.providers.mjs +575 -529
  78. package/web-ui/modules/app.methods.runtime.mjs +345 -345
  79. package/web-ui/modules/app.methods.session-actions.mjs +591 -591
  80. package/web-ui/modules/app.methods.session-browser.mjs +1011 -1012
  81. package/web-ui/modules/app.methods.session-timeline.mjs +479 -479
  82. package/web-ui/modules/app.methods.session-trash.mjs +438 -438
  83. package/web-ui/modules/app.methods.startup-claude.mjs +547 -537
  84. package/web-ui/modules/app.methods.task-orchestration.mjs +556 -556
  85. package/web-ui/modules/app.methods.webhook.mjs +87 -79
  86. package/web-ui/modules/config-mode.computed.mjs +124 -124
  87. package/web-ui/modules/config-template-confirm-pref.mjs +33 -33
  88. package/web-ui/modules/i18n.dict.mjs +3195 -3177
  89. package/web-ui/modules/i18n.mjs +62 -62
  90. package/web-ui/modules/plugins.computed.mjs +3 -3
  91. package/web-ui/modules/plugins.methods.mjs +3 -3
  92. package/web-ui/modules/plugins.storage.mjs +11 -11
  93. package/web-ui/modules/provider-url-display.mjs +17 -17
  94. package/web-ui/modules/sessions-filters-url.mjs +85 -85
  95. package/web-ui/modules/skills.computed.mjs +107 -107
  96. package/web-ui/modules/skills.methods.mjs +482 -482
  97. package/web-ui/partials/index/layout-footer.html +13 -13
  98. package/web-ui/partials/index/layout-header.html +499 -503
  99. package/web-ui/partials/index/modal-config-template-agents.html +185 -185
  100. package/web-ui/partials/index/modal-confirm-toast.html +32 -32
  101. package/web-ui/partials/index/modal-health-check.html +45 -45
  102. package/web-ui/partials/index/modal-openclaw-config.html +280 -280
  103. package/web-ui/partials/index/modal-skills.html +200 -200
  104. package/web-ui/partials/index/modal-webhook.html +42 -0
  105. package/web-ui/partials/index/modals-basic.html +223 -162
  106. package/web-ui/partials/index/panel-config-claude.html +155 -136
  107. package/web-ui/partials/index/panel-config-codex.html +176 -196
  108. package/web-ui/partials/index/panel-config-codex.html.bak +337 -0
  109. package/web-ui/partials/index/panel-config-openclaw.html +83 -83
  110. package/web-ui/partials/index/panel-dashboard.html +186 -219
  111. package/web-ui/partials/index/panel-docs.html +114 -114
  112. package/web-ui/partials/index/panel-market.html +177 -177
  113. package/web-ui/partials/index/panel-orchestration.html +391 -391
  114. package/web-ui/partials/index/panel-plugins.html +253 -253
  115. package/web-ui/partials/index/panel-sessions.html +319 -313
  116. package/web-ui/partials/index/panel-settings.html +158 -190
  117. package/web-ui/partials/index/panel-trash.html +82 -82
  118. package/web-ui/partials/index/panel-usage.html +137 -137
  119. package/web-ui/res/json5.min.js +1 -1
  120. package/web-ui/res/vue.global.prod.js +13 -13
  121. package/web-ui/session-helpers.mjs +591 -591
  122. package/web-ui/source-bundle.cjs +233 -233
  123. package/web-ui/styles/base-theme.css +281 -281
  124. package/web-ui/styles/bridge-pool.css +266 -197
  125. package/web-ui/styles/controls-forms.css +433 -433
  126. package/web-ui/styles/dashboard.css +406 -406
  127. package/web-ui/styles/docs-panel.css +245 -245
  128. package/web-ui/styles/feedback.css +108 -108
  129. package/web-ui/styles/health-check-dialog.css +144 -144
  130. package/web-ui/styles/layout-shell.css +628 -638
  131. package/web-ui/styles/modals-core.css +499 -466
  132. package/web-ui/styles/navigation-panels.css +391 -391
  133. package/web-ui/styles/openclaw-structured.css +266 -266
  134. package/web-ui/styles/plugins-panel.css +564 -564
  135. package/web-ui/styles/responsive.css +392 -392
  136. package/web-ui/styles/sessions-list.css +683 -647
  137. package/web-ui/styles/sessions-preview.css +407 -407
  138. package/web-ui/styles/sessions-toolbar-trash.css +518 -518
  139. package/web-ui/styles/sessions-usage.css +588 -588
  140. package/web-ui/styles/settings-panel.css +415 -349
  141. package/web-ui/styles/skills-list.css +305 -305
  142. package/web-ui/styles/skills-market.css +429 -429
  143. package/web-ui/styles/task-orchestration.css +822 -822
  144. package/web-ui/styles/titles-cards.css +472 -472
  145. package/web-ui/styles/trash-panel.css +90 -90
  146. package/web-ui/styles/webhook.css +115 -81
  147. package/web-ui/styles.css +24 -24
  148. package/web-ui.html +17 -17
@@ -1,224 +1,230 @@
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
+ if (content.length > 2 * 1024 * 1024) {
96
+ return { error: '内容过大(最大 2MB)' };
97
+ }
98
+ const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
99
+ const normalized = normalizeLineEnding(content, lineEnding);
100
+ const finalContent = ensureUtf8Bom(normalized);
101
+ try {
102
+ ensureDir(CLAUDE_DIR);
103
+ fs.writeFileSync(filePath, finalContent, 'utf-8');
104
+ return { success: true, path: filePath };
105
+ } catch (e) {
106
+ return { error: `写入 CLAUDE.md 失败: ${e.message}` };
107
+ }
108
+ }
109
+
110
+ function readAgentsFile(params = {}) {
111
+ const filePath = resolveAgentsFilePath(params);
112
+ const dirCheck = validateAgentsBaseDir(filePath);
113
+ if (dirCheck.error) {
114
+ return { error: dirCheck.error };
115
+ }
116
+
117
+ if (!fs.existsSync(filePath)) {
118
+ return {
119
+ exists: false,
120
+ path: filePath,
121
+ content: '',
122
+ lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
123
+ };
124
+ }
125
+
126
+ if (params.metaOnly) {
127
+ return {
128
+ exists: true,
129
+ path: filePath,
130
+ content: '',
131
+ lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n'
132
+ };
133
+ }
134
+
135
+ try {
136
+ const raw = fs.readFileSync(filePath, 'utf-8');
137
+ return {
138
+ exists: true,
139
+ path: filePath,
140
+ content: stripUtf8Bom(raw),
141
+ lineEnding: detectLineEnding(raw)
142
+ };
143
+ } catch (e) {
144
+ return { error: `读取 AGENTS.md 失败: ${e.message}` };
145
+ }
146
+ }
147
+
148
+ function applyAgentsFile(params = {}) {
149
+ const filePath = resolveAgentsFilePath(params);
150
+ const dirCheck = validateAgentsBaseDir(filePath);
151
+ if (dirCheck.error) {
152
+ return { error: dirCheck.error };
153
+ }
154
+
155
+ const content = typeof params.content === 'string' ? params.content : '';
156
+ if (content.length > 2 * 1024 * 1024) {
157
+ return { error: '内容过大(最大 2MB)' };
158
+ }
159
+ const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
160
+ const normalized = normalizeLineEnding(content, lineEnding);
161
+ const finalContent = ensureUtf8Bom(normalized);
162
+
163
+ try {
164
+ fs.writeFileSync(filePath, finalContent, 'utf-8');
165
+ return { success: true, path: filePath };
166
+ } catch (e) {
167
+ return { error: `写入 AGENTS.md 失败: ${e.message}` };
168
+ }
169
+ }
170
+
171
+ function normalizeDiffText(input) {
172
+ const safe = typeof input === 'string' ? input : '';
173
+ return normalizeLineEnding(stripUtf8Bom(safe), '\n');
174
+ }
175
+
176
+ function buildAgentsDiff(params = {}) {
177
+ const hasBaseContent = typeof params.baseContent === 'string';
178
+ const contextRaw = typeof params.context === 'string' ? params.context.trim() : '';
179
+ const context = contextRaw || 'codex';
180
+ const metaOnly = hasBaseContent;
181
+ let readResult;
182
+ if (context === 'claude-md') {
183
+ readResult = readClaudeMdFile({ metaOnly });
184
+ } else if (context === 'openclaw') {
185
+ readResult = readOpenclawAgentsFile({ metaOnly });
186
+ } else if (context === 'openclaw-workspace') {
187
+ readResult = readOpenclawWorkspaceFile({ ...params, metaOnly });
188
+ } else if (context === 'codex') {
189
+ readResult = readAgentsFile({ ...params, metaOnly });
190
+ } else {
191
+ return { error: `Unsupported agents diff context: ${context}` };
192
+ }
193
+ if (readResult && readResult.error) {
194
+ return { error: readResult.error };
195
+ }
196
+
197
+ const beforeText = normalizeDiffText(
198
+ hasBaseContent ? params.baseContent : (readResult && readResult.content ? readResult.content : '')
199
+ );
200
+ const afterText = normalizeDiffText(params.content);
201
+ const diff = buildLineDiff(beforeText, afterText);
202
+ const hasChanges = diff.truncated ? beforeText !== afterText : (diff.stats.added > 0 || diff.stats.removed > 0);
203
+ return {
204
+ diff: {
205
+ ...diff,
206
+ hasChanges
207
+ },
208
+ path: readResult && readResult.path ? readResult.path : '',
209
+ exists: !!(readResult && readResult.exists),
210
+ context,
211
+ configError: readResult && readResult.configError ? readResult.configError : ''
212
+ };
213
+ }
214
+
215
+ return {
216
+ resolveAgentsFilePath,
217
+ validateAgentsBaseDir,
218
+ resolveClaudeMdFilePath,
219
+ readClaudeMdFile,
220
+ applyClaudeMdFile,
221
+ readAgentsFile,
222
+ applyAgentsFile,
223
+ normalizeDiffText,
224
+ buildAgentsDiff
225
+ };
226
+ }
227
+
228
+ module.exports = {
229
+ createAgentsFileController
230
+ };