codexmate 0.0.29 → 0.0.31

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 (145) hide show
  1. package/README.md +363 -421
  2. package/README.zh.md +371 -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 +69 -65
  16. package/cli/session-convert-io.js +82 -82
  17. package/cli/session-convert.js +150 -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 +15778 -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 +646 -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 +841 -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 +591 -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 +3174 -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 +357 -323
  105. package/web-ui/partials/index/panel-config-codex.html.bak +337 -0
  106. package/web-ui/partials/index/panel-config-openclaw.html +83 -83
  107. package/web-ui/partials/index/panel-dashboard.html +219 -186
  108. package/web-ui/partials/index/panel-docs.html +147 -147
  109. package/web-ui/partials/index/panel-market.html +177 -177
  110. package/web-ui/partials/index/panel-orchestration.html +391 -391
  111. package/web-ui/partials/index/panel-plugins.html +253 -253
  112. package/web-ui/partials/index/panel-sessions.html +302 -316
  113. package/web-ui/partials/index/panel-settings.html +190 -190
  114. package/web-ui/partials/index/panel-trash.html +88 -88
  115. package/web-ui/partials/index/panel-usage.html +371 -371
  116. package/web-ui/res/json5.min.js +1 -1
  117. package/web-ui/res/vue.global.prod.js +13 -13
  118. package/web-ui/session-helpers.mjs +591 -576
  119. package/web-ui/source-bundle.cjs +233 -233
  120. package/web-ui/styles/base-theme.css +281 -281
  121. package/web-ui/styles/bridge-pool.css +197 -0
  122. package/web-ui/styles/controls-forms.css +422 -422
  123. package/web-ui/styles/dashboard.css +406 -274
  124. package/web-ui/styles/docs-panel.css +271 -271
  125. package/web-ui/styles/feedback.css +108 -108
  126. package/web-ui/styles/health-check-dialog.css +144 -144
  127. package/web-ui/styles/layout-shell.css +626 -626
  128. package/web-ui/styles/modals-core.css +466 -466
  129. package/web-ui/styles/navigation-panels.css +391 -391
  130. package/web-ui/styles/openclaw-structured.css +266 -266
  131. package/web-ui/styles/plugins-panel.css +564 -523
  132. package/web-ui/styles/responsive.css +454 -454
  133. package/web-ui/styles/sessions-list.css +417 -419
  134. package/web-ui/styles/sessions-preview.css +407 -411
  135. package/web-ui/styles/sessions-toolbar-trash.css +348 -330
  136. package/web-ui/styles/sessions-usage.css +1040 -1040
  137. package/web-ui/styles/settings-panel.css +349 -349
  138. package/web-ui/styles/skills-list.css +305 -303
  139. package/web-ui/styles/skills-market.css +429 -406
  140. package/web-ui/styles/task-orchestration.css +822 -822
  141. package/web-ui/styles/titles-cards.css +472 -472
  142. package/web-ui/styles/trash-panel.css +90 -90
  143. package/web-ui/styles/webhook.css +81 -81
  144. package/web-ui/styles.css +24 -23
  145. 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
+ };