openclacky 1.5.22 → 1.5.24
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +104 -0
- data/docs/secretary-prototype.md +286 -0
- data/lib/clacky/agent/cost_tracker.rb +55 -36
- data/lib/clacky/agent/hook_manager.rb +4 -1
- data/lib/clacky/agent/llm_caller.rb +46 -12
- data/lib/clacky/agent/memory_injector.rb +209 -0
- data/lib/clacky/agent/memory_updater.rb +16 -0
- data/lib/clacky/agent/session_serializer.rb +15 -11
- data/lib/clacky/agent/skill_manager.rb +30 -8
- data/lib/clacky/agent.rb +124 -17
- data/lib/clacky/agent_config.rb +7 -3
- data/lib/clacky/agent_profile.rb +33 -6
- data/lib/clacky/anthropic_stream_aggregator.rb +11 -1
- data/lib/clacky/bedrock_stream_aggregator.rb +11 -1
- data/lib/clacky/billing/platform_billing.rb +7 -0
- data/lib/clacky/cli.rb +4 -3
- data/lib/clacky/client.rb +30 -25
- data/lib/clacky/default_extensions/advisor/README.md +25 -0
- data/lib/clacky/default_extensions/advisor/README.zh.md +25 -0
- data/lib/clacky/default_extensions/advisor/ext.yml +1 -1
- data/lib/clacky/default_extensions/advisor/icon.svg +14 -0
- data/lib/clacky/default_extensions/advisor/panels/advisor/view.js +7 -1
- data/lib/clacky/default_extensions/coding/ext.yml +0 -1
- data/lib/clacky/default_extensions/computer-use/README.md +48 -0
- data/lib/clacky/default_extensions/computer-use/README.zh.md +48 -0
- data/lib/clacky/default_extensions/computer-use/ext.yml +1 -1
- data/lib/clacky/default_extensions/computer-use/icon.svg +16 -0
- data/lib/clacky/default_extensions/ext-studio/ext.yml +0 -1
- data/lib/clacky/default_extensions/general/ext.yml +0 -1
- data/lib/clacky/default_extensions/git/README.md +41 -0
- data/lib/clacky/default_extensions/git/README.zh.md +41 -0
- data/lib/clacky/default_extensions/git/ext.yml +1 -1
- data/lib/clacky/default_extensions/git/icon.svg +15 -0
- data/lib/clacky/default_extensions/git/panels/git/view.js +106 -27
- data/lib/clacky/default_extensions/meeting/README.md +46 -0
- data/lib/clacky/default_extensions/meeting/README.zh.md +47 -0
- data/lib/clacky/default_extensions/meeting/ext.yml +1 -1
- data/lib/clacky/default_extensions/meeting/icon.svg +13 -0
- data/lib/clacky/default_extensions/preview/README.md +29 -0
- data/lib/clacky/default_extensions/preview/README.zh.md +29 -0
- data/lib/clacky/default_extensions/preview/ext.yml +1 -1
- data/lib/clacky/default_extensions/preview/icon.svg +13 -0
- data/lib/clacky/default_extensions/secretary/README.md +69 -0
- data/lib/clacky/default_extensions/secretary/README.zh.md +69 -0
- data/lib/clacky/default_extensions/secretary/agents/secretary.md +41 -0
- data/lib/clacky/default_extensions/secretary/agents/worker.md +35 -0
- data/lib/clacky/default_extensions/secretary/api/handler.rb +8 -0
- data/lib/clacky/default_extensions/secretary/ext.yml +42 -0
- data/lib/clacky/default_extensions/secretary/icon.svg +17 -0
- data/lib/clacky/default_extensions/secretary/panels/work/view.js +344 -0
- data/lib/clacky/default_extensions/secretary/tools/delegate_work.rb +37 -0
- data/lib/clacky/default_extensions/secretary/tools/manage_work.rb +22 -0
- data/lib/clacky/default_extensions/secretary/tools/yield_work.rb +35 -0
- data/lib/clacky/default_extensions/time_machine/README.md +32 -0
- data/lib/clacky/default_extensions/time_machine/README.zh.md +32 -0
- data/lib/clacky/default_extensions/time_machine/ext.yml +1 -1
- data/lib/clacky/default_extensions/time_machine/icon.svg +14 -0
- data/lib/clacky/default_skills/channel-manager/SKILL.md +103 -13
- data/lib/clacky/default_skills/channel-manager/dingtalk_setup.rb +4 -2
- data/lib/clacky/default_skills/channel-manager/discord_setup.rb +9 -2
- data/lib/clacky/default_skills/channel-manager/weixin_setup.rb +10 -1
- data/lib/clacky/default_skills/cron-task-creator/SKILL.md +183 -206
- data/lib/clacky/default_skills/cron-task-creator/evals/evals.json +45 -0
- data/lib/clacky/default_skills/media-gen/SKILL.md +31 -14
- data/lib/clacky/default_skills/onboard/SKILL.md +5 -7
- data/lib/clacky/default_skills/persist-memory/SKILL.md +15 -1
- data/lib/clacky/extension/api_extension.rb +23 -2
- data/lib/clacky/extension/loader.rb +2 -0
- data/lib/clacky/extension/verifier.rb +2 -2
- data/lib/clacky/json_ui_controller.rb +14 -1
- data/lib/clacky/locales/en.rb +14 -0
- data/lib/clacky/locales/i18n.rb +25 -3
- data/lib/clacky/locales/zh.rb +14 -0
- data/lib/clacky/message_history.rb +15 -2
- data/lib/clacky/openai_responses_stream_aggregator.rb +11 -1
- data/lib/clacky/openai_stream_aggregator.rb +11 -1
- data/lib/clacky/prompts/base.md +1 -1
- data/lib/clacky/providers.rb +32 -17
- data/lib/clacky/server/backup_manager.rb +98 -2
- data/lib/clacky/server/browser_manager.rb +10 -5
- data/lib/clacky/server/channel/adapters/base.rb +18 -0
- data/lib/clacky/server/channel/adapters/feishu/message_parser.rb +1 -0
- data/lib/clacky/server/channel/adapters/telegram/adapter.rb +1 -0
- data/lib/clacky/server/channel/channel_config.rb +185 -48
- data/lib/clacky/server/channel/channel_manager.rb +247 -110
- data/lib/clacky/server/git_panel.rb +2 -1
- data/lib/clacky/server/http_server.rb +517 -175
- data/lib/clacky/server/preview.rb +26 -5
- data/lib/clacky/server/scheduler.rb +166 -85
- data/lib/clacky/server/web_ui_controller.rb +12 -0
- data/lib/clacky/session_manager.rb +4 -1
- data/lib/clacky/skill.rb +1 -1
- data/lib/clacky/tools/base.rb +7 -1
- data/lib/clacky/ui_interface.rb +5 -0
- data/lib/clacky/utils/file_processor.rb +23 -11
- data/lib/clacky/utils/model_pricing.rb +19 -0
- data/lib/clacky/version.rb +1 -1
- data/lib/clacky/web/app.css +621 -52
- data/lib/clacky/web/app.js +103 -9
- data/lib/clacky/web/components/code-editor.js +73 -4
- data/lib/clacky/web/components/custom-select.js +7 -18
- data/lib/clacky/web/components/hint-tip.js +172 -0
- data/lib/clacky/web/components/model-picker.js +1 -1
- data/lib/clacky/web/components/notify.js +37 -10
- data/lib/clacky/web/components/onboard.js +1 -1
- data/lib/clacky/web/components/sidebar.js +70 -0
- data/lib/clacky/web/features/backup/store.js +64 -27
- data/lib/clacky/web/features/backup/view.js +42 -11
- data/lib/clacky/web/features/channels/store.js +19 -4
- data/lib/clacky/web/features/channels/view.js +94 -33
- data/lib/clacky/web/features/extensions/view.js +15 -8
- data/lib/clacky/web/features/new-session/view.js +33 -22
- data/lib/clacky/web/features/profile/view.js +4 -4
- data/lib/clacky/web/features/tasks/store.js +5 -3
- data/lib/clacky/web/features/tasks/view.js +99 -26
- data/lib/clacky/web/features/trash/view.js +4 -4
- data/lib/clacky/web/features/workspace/view.js +193 -57
- data/lib/clacky/web/i18n.js +189 -17
- data/lib/clacky/web/index.html +165 -53
- data/lib/clacky/web/projects.js +15 -2
- data/lib/clacky/web/sessions.js +316 -86
- data/lib/clacky/web/settings.js +304 -75
- data/lib/clacky/web/utils.js +261 -0
- data/lib/clacky/web/ws-dispatcher.js +24 -3
- data/lib/clacky/web/ws.js +16 -4
- data/lib/clacky/work/service.rb +544 -0
- data/lib/clacky/work/store.rb +57 -0
- data/lib/clacky.rb +1 -0
- metadata +35 -1
data/lib/clacky/client.rb
CHANGED
|
@@ -167,7 +167,7 @@ module Clacky
|
|
|
167
167
|
# path. When given but streaming is not yet wired for the active provider,
|
|
168
168
|
# a single synthetic invocation is fired after the response is received,
|
|
169
169
|
# so UI plumbing can be exercised end-to-end without the proxy work.
|
|
170
|
-
def send_messages_with_tools(messages, model:, tools:, max_tokens:, enable_caching: false, reasoning_effort: nil, on_chunk: nil, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
170
|
+
def send_messages_with_tools(messages, model:, tools:, max_tokens:, enable_caching: false, reasoning_effort: nil, on_chunk: nil, on_text_delta: nil, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
171
171
|
api_model = Providers.resolve_api_model(base_url: @base_url, api_key: @api_key, model: model)
|
|
172
172
|
caching_enabled = enable_caching && supports_prompt_caching?(model)
|
|
173
173
|
cloned = deep_clone(messages)
|
|
@@ -179,20 +179,25 @@ module Clacky
|
|
|
179
179
|
on_chunk.call(**kwargs)
|
|
180
180
|
end
|
|
181
181
|
|
|
182
|
+
wrapped_on_text_delta = on_text_delta && lambda do |text|
|
|
183
|
+
first_chunk_at ||= Process.clock_gettime(Process::CLOCK_MONOTONIC)
|
|
184
|
+
on_text_delta.call(text)
|
|
185
|
+
end
|
|
186
|
+
|
|
182
187
|
t0 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
|
|
183
188
|
response =
|
|
184
189
|
if bedrock?
|
|
185
|
-
streaming_used = !on_chunk.nil?
|
|
186
|
-
send_bedrock_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk)
|
|
190
|
+
streaming_used = !on_chunk.nil? || !on_text_delta.nil?
|
|
191
|
+
send_bedrock_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, on_text_delta: wrapped_on_text_delta)
|
|
187
192
|
elsif anthropic_format?
|
|
188
|
-
streaming_used = !on_chunk.nil?
|
|
189
|
-
send_anthropic_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk)
|
|
193
|
+
streaming_used = !on_chunk.nil? || !on_text_delta.nil?
|
|
194
|
+
send_anthropic_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, on_text_delta: wrapped_on_text_delta)
|
|
190
195
|
elsif responses_format?
|
|
191
|
-
streaming_used = !on_chunk.nil?
|
|
192
|
-
send_openai_responses_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, capability_model: model)
|
|
196
|
+
streaming_used = !on_chunk.nil? || !on_text_delta.nil?
|
|
197
|
+
send_openai_responses_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, on_text_delta: wrapped_on_text_delta, capability_model: model)
|
|
193
198
|
else
|
|
194
|
-
streaming_used = !on_chunk.nil?
|
|
195
|
-
send_openai_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, capability_model: model, agent_upstream_fails: agent_upstream_fails, agent_upgrade_fails: agent_upgrade_fails)
|
|
199
|
+
streaming_used = !on_chunk.nil? || !on_text_delta.nil?
|
|
200
|
+
send_openai_request(cloned, api_model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort, on_chunk: wrapped_on_chunk, on_text_delta: wrapped_on_text_delta, capability_model: model, agent_upstream_fails: agent_upstream_fails, agent_upgrade_fails: agent_upgrade_fails)
|
|
196
201
|
end
|
|
197
202
|
t1 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
|
|
198
203
|
|
|
@@ -265,9 +270,9 @@ module Clacky
|
|
|
265
270
|
|
|
266
271
|
# ── Bedrock Converse request / response ───────────────────────────────────
|
|
267
272
|
|
|
268
|
-
def send_bedrock_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil)
|
|
273
|
+
def send_bedrock_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil, on_text_delta: nil)
|
|
269
274
|
body = MessageFormat::Bedrock.build_request_body(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort)
|
|
270
|
-
return send_bedrock_stream_request(body, model, on_chunk) if on_chunk
|
|
275
|
+
return send_bedrock_stream_request(body, model, on_chunk, on_text_delta: on_text_delta) if on_chunk || on_text_delta
|
|
271
276
|
|
|
272
277
|
response = bedrock_connection.post(bedrock_endpoint(model)) { |r| r.body = body.to_json }
|
|
273
278
|
|
|
@@ -283,9 +288,9 @@ module Clacky
|
|
|
283
288
|
# the raw Bedrock event JSON. We accumulate frames into a synthetic
|
|
284
289
|
# non-streaming response and feed it back through the existing parser so
|
|
285
290
|
# downstream code is identical.
|
|
286
|
-
private def send_bedrock_stream_request(body, model, on_chunk)
|
|
291
|
+
private def send_bedrock_stream_request(body, model, on_chunk, on_text_delta: nil)
|
|
287
292
|
stream_body = body.merge(stream: true)
|
|
288
|
-
aggregator = BedrockStreamAggregator.new(on_chunk: on_chunk)
|
|
293
|
+
aggregator = BedrockStreamAggregator.new(on_chunk: on_chunk, on_text_delta: on_text_delta)
|
|
289
294
|
sse_buf = +""
|
|
290
295
|
|
|
291
296
|
response = bedrock_connection.post(bedrock_stream_endpoint(model)) do |req|
|
|
@@ -325,12 +330,12 @@ module Clacky
|
|
|
325
330
|
|
|
326
331
|
# ── Anthropic request / response ──────────────────────────────────────────
|
|
327
332
|
|
|
328
|
-
def send_anthropic_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil)
|
|
333
|
+
def send_anthropic_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil, on_text_delta: nil)
|
|
329
334
|
# Apply cache_control to the message that marks the cache breakpoint
|
|
330
335
|
messages = apply_message_caching(messages) if caching_enabled
|
|
331
336
|
|
|
332
337
|
body = MessageFormat::Anthropic.build_request_body(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: reasoning_effort)
|
|
333
|
-
return send_anthropic_stream_request(body, on_chunk) if on_chunk
|
|
338
|
+
return send_anthropic_stream_request(body, on_chunk, on_text_delta: on_text_delta) if on_chunk || on_text_delta
|
|
334
339
|
|
|
335
340
|
response = anthropic_connection.post(anthropic_messages_path) { |r| r.body = body.to_json }
|
|
336
341
|
|
|
@@ -340,9 +345,9 @@ module Clacky
|
|
|
340
345
|
MessageFormat::Anthropic.parse_response(parsed_body)
|
|
341
346
|
end
|
|
342
347
|
|
|
343
|
-
private def send_anthropic_stream_request(body, on_chunk)
|
|
348
|
+
private def send_anthropic_stream_request(body, on_chunk, on_text_delta: nil)
|
|
344
349
|
stream_body = body.merge(stream: true)
|
|
345
|
-
aggregator = AnthropicStreamAggregator.new(on_chunk: on_chunk)
|
|
350
|
+
aggregator = AnthropicStreamAggregator.new(on_chunk: on_chunk, on_text_delta: on_text_delta)
|
|
346
351
|
sse_buf = +""
|
|
347
352
|
|
|
348
353
|
response = anthropic_connection.post(anthropic_messages_path) do |req|
|
|
@@ -382,7 +387,7 @@ module Clacky
|
|
|
382
387
|
|
|
383
388
|
# ── OpenAI request / response ─────────────────────────────────────────────
|
|
384
389
|
|
|
385
|
-
def send_openai_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil, capability_model: nil, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
390
|
+
def send_openai_request(messages, model, tools, max_tokens, caching_enabled, reasoning_effort: nil, on_chunk: nil, on_text_delta: nil, capability_model: nil, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
386
391
|
# Override max_tokens when the model declares a higher output ceiling
|
|
387
392
|
# in Providers::MODEL_MAX_OUTPUT. Without this, strong models (GLM-5.2,
|
|
388
393
|
# Kimi-K3, MiMo-V2.5) are throttled to the 16K global default.
|
|
@@ -406,7 +411,7 @@ module Clacky
|
|
|
406
411
|
vision_supported: vision_supported,
|
|
407
412
|
reasoning_effort: reasoning_effort
|
|
408
413
|
)
|
|
409
|
-
return send_openai_stream_request(body, on_chunk, agent_upstream_fails: agent_upstream_fails, agent_upgrade_fails: agent_upgrade_fails) if on_chunk
|
|
414
|
+
return send_openai_stream_request(body, on_chunk, on_text_delta: on_text_delta, agent_upstream_fails: agent_upstream_fails, agent_upgrade_fails: agent_upgrade_fails) if on_chunk || on_text_delta
|
|
410
415
|
|
|
411
416
|
response = openai_connection.post("chat/completions") do |r|
|
|
412
417
|
r.body = body.to_json
|
|
@@ -453,9 +458,9 @@ module Clacky
|
|
|
453
458
|
# via platform/llm_proxy). Uses Faraday's on_data hook to consume SSE frames,
|
|
454
459
|
# accumulates them, and reconstructs the non-streaming JSON response shape so
|
|
455
460
|
# MessageFormat::OpenAI.parse_response works unchanged.
|
|
456
|
-
private def send_openai_stream_request(body, on_chunk, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
461
|
+
private def send_openai_stream_request(body, on_chunk, on_text_delta: nil, agent_upstream_fails: nil, agent_upgrade_fails: nil)
|
|
457
462
|
stream_body = body.merge(stream: true, stream_options: { include_usage: true })
|
|
458
|
-
aggregator = OpenAIStreamAggregator.new(on_chunk: on_chunk)
|
|
463
|
+
aggregator = OpenAIStreamAggregator.new(on_chunk: on_chunk, on_text_delta: on_text_delta)
|
|
459
464
|
sse_buf = +""
|
|
460
465
|
|
|
461
466
|
response = openai_connection.post("chat/completions") do |req|
|
|
@@ -512,7 +517,7 @@ module Clacky
|
|
|
512
517
|
# ── OpenAI Responses API request / response ───────────────────────────────
|
|
513
518
|
|
|
514
519
|
def send_openai_responses_request(messages, model, tools, max_tokens, caching_enabled,
|
|
515
|
-
reasoning_effort: nil, on_chunk: nil, capability_model: nil)
|
|
520
|
+
reasoning_effort: nil, on_chunk: nil, on_text_delta: nil, capability_model: nil)
|
|
516
521
|
# Override max_tokens when the model declares a higher output ceiling
|
|
517
522
|
model_for_limit = capability_model || model
|
|
518
523
|
model_limit = Providers.max_output_for(model_for_limit)
|
|
@@ -530,7 +535,7 @@ module Clacky
|
|
|
530
535
|
vision_supported: Providers.supports?(@provider_id, :vision, model_name: cap_model),
|
|
531
536
|
reasoning_effort: reasoning_effort
|
|
532
537
|
)
|
|
533
|
-
return send_openai_responses_stream_request(body, on_chunk) if on_chunk
|
|
538
|
+
return send_openai_responses_stream_request(body, on_chunk, on_text_delta: on_text_delta) if on_chunk || on_text_delta
|
|
534
539
|
|
|
535
540
|
response = openai_connection.post("responses") { |r| r.body = body.to_json }
|
|
536
541
|
|
|
@@ -546,9 +551,9 @@ module Clacky
|
|
|
546
551
|
# typed SSE events (response.output_text.delta,
|
|
547
552
|
# response.function_call_arguments.delta, response.completed, etc.) that
|
|
548
553
|
# the aggregator reassembles into the non-streaming response shape.
|
|
549
|
-
private def send_openai_responses_stream_request(body, on_chunk)
|
|
554
|
+
private def send_openai_responses_stream_request(body, on_chunk, on_text_delta: nil)
|
|
550
555
|
stream_body = body.merge(stream: true)
|
|
551
|
-
aggregator = OpenAIResponsesStreamAggregator.new(on_chunk: on_chunk)
|
|
556
|
+
aggregator = OpenAIResponsesStreamAggregator.new(on_chunk: on_chunk, on_text_delta: on_text_delta)
|
|
552
557
|
sse_buf = +""
|
|
553
558
|
|
|
554
559
|
response = openai_connection.post("responses") do |req|
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Advisor
|
|
2
|
+
|
|
3
|
+
After each round of work, the AI reviews what it just did and shows **3 suggested next steps** above the input box, so you never have to wonder what to do next.
|
|
4
|
+
|
|
5
|
+
## How to use
|
|
6
|
+
|
|
7
|
+
1. Chat with the AI and let it work as usual.
|
|
8
|
+
2. When a round finishes, a "Next steps" card appears above the input box (it shows a loading state while generating).
|
|
9
|
+
3. For any suggestion:
|
|
10
|
+
- **Click the text** to fill it into the input box, then edit and send it yourself.
|
|
11
|
+
- **Click "Send now"** to send it to the AI as-is.
|
|
12
|
+
4. Click **✕ (Dismiss)** to hide the card for this round; it comes back next round.
|
|
13
|
+
|
|
14
|
+
Suggestions usually cover three different directions: continue / fix, verify, and wrap up. Nothing runs automatically — you are always in control.
|
|
15
|
+
|
|
16
|
+
## Turning it on and off
|
|
17
|
+
|
|
18
|
+
- The **⏻** button on the card turns the advisor off.
|
|
19
|
+
- Turn it back on any time in **Settings → Advisor**.
|
|
20
|
+
- You can also disable the whole extension from Extensions.
|
|
21
|
+
|
|
22
|
+
## Tips
|
|
23
|
+
|
|
24
|
+
- Suggestions are based only on what actually happened in the round — no invented files or commands.
|
|
25
|
+
- If there is no sensible next step, no card is shown.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# 工作建议
|
|
2
|
+
|
|
3
|
+
每轮任务结束后,AI 会回顾刚完成的工作,在输入框上方给出 **3 条下一步建议**,让你不用想"接下来该做什么"。
|
|
4
|
+
|
|
5
|
+
## 怎么用
|
|
6
|
+
|
|
7
|
+
1. 正常和 AI 对话、让它干活。
|
|
8
|
+
2. 一轮任务完成后,输入框上方会出现「接下来建议」卡片(生成时显示「正在生成建议…」)。
|
|
9
|
+
3. 对任意一条建议:
|
|
10
|
+
- **点击建议文字**:内容会填进输入框,你可以先修改再发送。
|
|
11
|
+
- **点击「直接发送」**:原样发给 AI,立即执行。
|
|
12
|
+
4. 不需要时点卡片右上角 **✕(收起本次)**,下一轮会重新出现。
|
|
13
|
+
|
|
14
|
+
建议通常覆盖三个不同方向:继续 / 修复、验证、收尾。不会自动执行任何操作,一切由你决定。
|
|
15
|
+
|
|
16
|
+
## 开关
|
|
17
|
+
|
|
18
|
+
- 卡片上的 **⏻** 按钮可一键关闭工作建议。
|
|
19
|
+
- 关闭后可在「设置 → 工作建议」中重新开启。
|
|
20
|
+
- 也可以在扩展管理里整体停用本扩展。
|
|
21
|
+
|
|
22
|
+
## 小贴士
|
|
23
|
+
|
|
24
|
+
- 建议只基于本轮实际发生的事情生成,不会编造文件或命令。
|
|
25
|
+
- 如果没有合理的下一步,卡片不会出现。
|
|
@@ -5,8 +5,8 @@ display_name_zh: 工作建议
|
|
|
5
5
|
description: Recommends next steps after each task, based on your own workflow
|
|
6
6
|
description_zh: 每轮任务结束后,基于你的专属流程推荐下一步工作
|
|
7
7
|
version: "0.1.0"
|
|
8
|
+
icon: icon.svg
|
|
8
9
|
author: OpenClacky
|
|
9
|
-
homepage: https://www.openclacky.com
|
|
10
10
|
license: MIT
|
|
11
11
|
contributes:
|
|
12
12
|
agents:
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<defs>
|
|
3
|
+
<linearGradient id="advisor-bg" x1="18" y1="0" x2="18" y2="36" gradientUnits="userSpaceOnUse">
|
|
4
|
+
<stop stop-color="#9F7AEA"/>
|
|
5
|
+
<stop offset="1" stop-color="#7C3AED"/>
|
|
6
|
+
</linearGradient>
|
|
7
|
+
</defs>
|
|
8
|
+
<rect width="36" height="36" fill="url(#advisor-bg)"/>
|
|
9
|
+
<g transform="translate(8 8) scale(0.8333)" stroke="#fff" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
|
|
10
|
+
<path d="M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5"/>
|
|
11
|
+
<path d="M9 18h6"/>
|
|
12
|
+
<path d="M10 22h4"/>
|
|
13
|
+
</g>
|
|
14
|
+
</svg>
|
|
@@ -384,7 +384,13 @@
|
|
|
384
384
|
section.className = "settings-section";
|
|
385
385
|
const title = document.createElement("div");
|
|
386
386
|
title.className = "settings-section-title";
|
|
387
|
-
|
|
387
|
+
const heading = document.createElement("span");
|
|
388
|
+
heading.className = "settings-section-heading";
|
|
389
|
+
heading.innerHTML = '<svg class="settings-section-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5"/><path d="M9 18h6"/><path d="M10 22h4"/></svg>';
|
|
390
|
+
const headingLabel = document.createElement("span");
|
|
391
|
+
headingLabel.textContent = t("advisor.settingsTitle", "工作建议");
|
|
392
|
+
heading.appendChild(headingLabel);
|
|
393
|
+
title.appendChild(heading);
|
|
388
394
|
section.appendChild(title);
|
|
389
395
|
|
|
390
396
|
const desc = document.createElement("p");
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Computer Use
|
|
2
|
+
|
|
3
|
+
Let the AI operate your desktop the way a person would: take a screenshot to see the screen, then click and type. Use it for things the terminal and browser cannot reach.
|
|
4
|
+
|
|
5
|
+
> This extension is **off by default**. Click **Enable** in Extensions to turn it on.
|
|
6
|
+
|
|
7
|
+
## What it is good for
|
|
8
|
+
|
|
9
|
+
- Native apps, System Settings, installers
|
|
10
|
+
- Dialogs, menu bars and file pickers
|
|
11
|
+
- Anything else that can only be done by clicking on screen
|
|
12
|
+
|
|
13
|
+
For web automation, prefer the built-in browser capability — it is faster and more reliable. Fall back to Computer Use only when the browser cannot do the job.
|
|
14
|
+
|
|
15
|
+
## Setup
|
|
16
|
+
|
|
17
|
+
**macOS**
|
|
18
|
+
|
|
19
|
+
In **System Settings → Privacy & Security**, grant the app running Clacky (your terminal or the Clacky app):
|
|
20
|
+
|
|
21
|
+
- **Screen Recording** (for screenshots)
|
|
22
|
+
- **Accessibility** (to control mouse and keyboard)
|
|
23
|
+
|
|
24
|
+
You may need to restart that app after granting.
|
|
25
|
+
|
|
26
|
+
**Windows**
|
|
27
|
+
|
|
28
|
+
Run Clacky inside **WSL**, from a logged-in desktop session (not a background service or SSH session). Otherwise screenshots come back black and input goes nowhere.
|
|
29
|
+
|
|
30
|
+
> Plain Linux is not supported.
|
|
31
|
+
|
|
32
|
+
## How to use
|
|
33
|
+
|
|
34
|
+
Once enabled, just describe the task in plain language, for example:
|
|
35
|
+
|
|
36
|
+
- "Open System Settings and turn the display brightness all the way up"
|
|
37
|
+
- "In the file picker that just opened, select report.pdf on the Desktop"
|
|
38
|
+
|
|
39
|
+
The AI takes a screenshot first, clicks and types by coordinates, and re-checks the screen after each step.
|
|
40
|
+
|
|
41
|
+
## Troubleshooting
|
|
42
|
+
|
|
43
|
+
Ask the AI to "run the computer-use doctor check". It verifies permissions and environment and tells you what is missing.
|
|
44
|
+
|
|
45
|
+
## Notes
|
|
46
|
+
|
|
47
|
+
- Avoid using the mouse and keyboard while the AI is working, so you don't interfere with each other.
|
|
48
|
+
- Keep an eye on each step for sensitive actions such as payments or deletions.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# 电脑操作
|
|
2
|
+
|
|
3
|
+
让 AI 像人一样操作你的电脑桌面:截屏看界面,再用鼠标点击、键盘输入。适合处理终端和浏览器够不到的事情。
|
|
4
|
+
|
|
5
|
+
> 本扩展**默认关闭**。在扩展管理中点击「启用」后生效。
|
|
6
|
+
|
|
7
|
+
## 适合做什么
|
|
8
|
+
|
|
9
|
+
- 操作原生应用、系统设置、安装程序
|
|
10
|
+
- 处理弹窗、菜单栏、文件选择器
|
|
11
|
+
- 其他只能"用手点"的桌面操作
|
|
12
|
+
|
|
13
|
+
网页上的自动化任务建议优先使用内置的浏览器能力,更快也更稳定;只有浏览器搞不定时再用电脑操作。
|
|
14
|
+
|
|
15
|
+
## 使用前准备
|
|
16
|
+
|
|
17
|
+
**macOS**
|
|
18
|
+
|
|
19
|
+
在「系统设置 → 隐私与安全性」中,为运行 Clacky 的程序(如终端或 Clacky 应用)授予:
|
|
20
|
+
|
|
21
|
+
- **屏幕录制**(用于截屏)
|
|
22
|
+
- **辅助功能**(用于控制鼠标和键盘)
|
|
23
|
+
|
|
24
|
+
授权后可能需要重启该程序。
|
|
25
|
+
|
|
26
|
+
**Windows**
|
|
27
|
+
|
|
28
|
+
需要在 **WSL** 中运行 Clacky,并且是在已登录的桌面会话里(不能是后台服务或 SSH 远程会话),否则截屏会是黑屏、点击无效。
|
|
29
|
+
|
|
30
|
+
> 纯 Linux 系统暂不支持。
|
|
31
|
+
|
|
32
|
+
## 怎么用
|
|
33
|
+
|
|
34
|
+
启用后直接用自然语言描述任务即可,例如:
|
|
35
|
+
|
|
36
|
+
- 「打开系统设置,把显示器亮度调到最高」
|
|
37
|
+
- 「在弹出的文件选择框里选中桌面上的 report.pdf」
|
|
38
|
+
|
|
39
|
+
AI 会先截屏查看当前屏幕,再按坐标点击、输入,每一步之后重新截屏确认结果。
|
|
40
|
+
|
|
41
|
+
## 遇到问题
|
|
42
|
+
|
|
43
|
+
对 AI 说「运行 computer-use 的 doctor 自检」,它会检查权限和环境,并告诉你缺什么。
|
|
44
|
+
|
|
45
|
+
## 注意事项
|
|
46
|
+
|
|
47
|
+
- AI 操作期间请尽量不要动鼠标键盘,以免互相干扰。
|
|
48
|
+
- 涉及付款、删除等敏感操作时,请留意 AI 的每一步。
|
|
@@ -5,8 +5,8 @@ display_name_zh: 电脑操作
|
|
|
5
5
|
description: Let the AI drive your desktop — macOS, or Windows through WSL — with screenshots, mouse and keyboard.
|
|
6
6
|
description_zh: 让 AI 直接操作桌面(macOS,或 WSL 下的 Windows)——截屏、鼠标、键盘。
|
|
7
7
|
version: "0.1.0"
|
|
8
|
+
icon: icon.svg
|
|
8
9
|
author: OpenClacky
|
|
9
|
-
homepage: https://www.openclacky.com
|
|
10
10
|
license: MIT
|
|
11
11
|
origin: self
|
|
12
12
|
enabled_by_default: false
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<defs>
|
|
3
|
+
<linearGradient id="computeruse-bg" x1="18" y1="0" x2="18" y2="36" gradientUnits="userSpaceOnUse">
|
|
4
|
+
<stop stop-color="#FB9A2C"/>
|
|
5
|
+
<stop offset="1" stop-color="#F26B12"/>
|
|
6
|
+
</linearGradient>
|
|
7
|
+
</defs>
|
|
8
|
+
<rect width="36" height="36" fill="url(#computeruse-bg)"/>
|
|
9
|
+
<g transform="translate(8 8) scale(0.8333)" stroke="#fff" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
|
|
10
|
+
<path d="M14 4.1 12 6"/>
|
|
11
|
+
<path d="m5.1 8-2.9-.8"/>
|
|
12
|
+
<path d="m6 12-1.9 2"/>
|
|
13
|
+
<path d="M7.2 2.2 8 5.1"/>
|
|
14
|
+
<path d="M9.037 9.69a.498.498 0 0 1 .653-.653l11 4.5a.5.5 0 0 1-.074.949l-4.349 1.041a1 1 0 0 0-.74.739l-1.04 4.35a.5.5 0 0 1-.95.074z"/>
|
|
15
|
+
</g>
|
|
16
|
+
</svg>
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Git
|
|
2
|
+
|
|
3
|
+
A friendly review panel for changes: see exactly which files and lines the AI touched, and review them like a pull request.
|
|
4
|
+
|
|
5
|
+
> The session's working directory must be a Git repository.
|
|
6
|
+
|
|
7
|
+
## Opening it
|
|
8
|
+
|
|
9
|
+
Switch to the **Git** tab in the session's side panel.
|
|
10
|
+
|
|
11
|
+
## Choosing what to look at
|
|
12
|
+
|
|
13
|
+
Use the scope dropdown at the top:
|
|
14
|
+
|
|
15
|
+
| Scope | What it shows |
|
|
16
|
+
|---|---|
|
|
17
|
+
| Last turn | Only what the AI changed in its last round (most common) |
|
|
18
|
+
| Uncommitted | Everything changed since the last commit |
|
|
19
|
+
| Unstaged / Staged | Changes split by the Git index |
|
|
20
|
+
| Committed | Commits on the current branch vs. the base branch |
|
|
21
|
+
| Unpushed commits | Commits not yet pushed, one by one |
|
|
22
|
+
| Branch | Compare against any branch |
|
|
23
|
+
|
|
24
|
+
## Reading the diff
|
|
25
|
+
|
|
26
|
+
- **File tree** on the left lists every changed file. Drag to resize (double-click to reset) or hide it.
|
|
27
|
+
- **Go to file** filters the list by name.
|
|
28
|
+
- **Diff layout**: auto / split / unified — click to switch.
|
|
29
|
+
- **Wrap** long lines when needed.
|
|
30
|
+
- Unchanged code collapses into "N unchanged lines"; click to expand.
|
|
31
|
+
- Very large diffs load on demand — click to show them.
|
|
32
|
+
|
|
33
|
+
## File actions
|
|
34
|
+
|
|
35
|
+
- **Discard changes**: the revert button on a file header discards that file's changes after a second confirmation. This cannot be undone.
|
|
36
|
+
- **More menu / right-click**: copy path, copy relative path, open in editor, add to chat, reveal in folder, download.
|
|
37
|
+
|
|
38
|
+
## Tips
|
|
39
|
+
|
|
40
|
+
- Want the AI to keep working on a file? Use **Add to chat** to reference it in the input box.
|
|
41
|
+
- To look back at a single step or roll everything back, pair this with the **Time Machine** extension.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Git 管理
|
|
2
|
+
|
|
3
|
+
一个直观的改动审阅面板:AI 改了哪些文件、改了哪几行,一眼看清,像审阅代码一样逐个确认。
|
|
4
|
+
|
|
5
|
+
> 需要当前会话的工作目录是一个 Git 仓库。
|
|
6
|
+
|
|
7
|
+
## 怎么打开
|
|
8
|
+
|
|
9
|
+
在会话右侧面板中切换到 **「Git 管理」** 标签页。
|
|
10
|
+
|
|
11
|
+
## 选择查看范围
|
|
12
|
+
|
|
13
|
+
点击顶部的范围下拉框,可以切换要看的改动:
|
|
14
|
+
|
|
15
|
+
| 范围 | 说明 |
|
|
16
|
+
|---|---|
|
|
17
|
+
| 上一轮 | 只看 AI 上一轮任务改了什么(最常用) |
|
|
18
|
+
| 未提交 | 自上次提交以来的全部改动 |
|
|
19
|
+
| 未暂存 / 已暂存 | 按 Git 暂存区拆分查看 |
|
|
20
|
+
| 已提交 | 当前分支相对基线分支的提交 |
|
|
21
|
+
| 未推送的提交 | 还没 push 到远端的提交,可逐个查看 |
|
|
22
|
+
| 分支 | 选择任意分支进行对比 |
|
|
23
|
+
|
|
24
|
+
## 浏览改动
|
|
25
|
+
|
|
26
|
+
- **左侧文件树**:列出所有改动文件,可拖动调整宽度(双击复位),也可以收起。
|
|
27
|
+
- **跳转到文件**:输入文件名快速筛选定位。
|
|
28
|
+
- **差异布局**:自动 / 并排 / 行内,点击切换。
|
|
29
|
+
- **自动换行**:长行太多时打开。
|
|
30
|
+
- 未修改的代码会折叠成「N 行未修改」,点击展开。
|
|
31
|
+
- 改动很大的文件会延迟加载,点一下再显示。
|
|
32
|
+
|
|
33
|
+
## 对文件进行操作
|
|
34
|
+
|
|
35
|
+
- **撤销此文件的改动**:点文件头部的撤销按钮,再次确认后丢弃该文件的改动(不可恢复,请谨慎)。
|
|
36
|
+
- **更多菜单 / 右键**:复制路径、复制相对路径、在编辑器中打开、添加到聊天、打开所在文件夹、下载。
|
|
37
|
+
|
|
38
|
+
## 小贴士
|
|
39
|
+
|
|
40
|
+
- 想让 AI 针对某个文件继续修改?用「添加到聊天」把它带进输入框。
|
|
41
|
+
- 只想回看 AI 某一步的改动,或整体回退,可配合「时光机」扩展使用。
|
|
@@ -5,8 +5,8 @@ display_name_zh: Git 管理
|
|
|
5
5
|
description: Changes panel — a friendly view of what the AI changed in the working tree
|
|
6
6
|
description_zh: 变更面板 — 直观查看 AI 在工作区的每一处修改
|
|
7
7
|
version: "0.1.0"
|
|
8
|
+
icon: icon.svg
|
|
8
9
|
author: OpenClacky
|
|
9
|
-
homepage: https://www.openclacky.com
|
|
10
10
|
license: MIT
|
|
11
11
|
contributes:
|
|
12
12
|
panels:
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<defs>
|
|
3
|
+
<linearGradient id="git-bg" x1="18" y1="0" x2="18" y2="36" gradientUnits="userSpaceOnUse">
|
|
4
|
+
<stop stop-color="#22C58B"/>
|
|
5
|
+
<stop offset="1" stop-color="#059669"/>
|
|
6
|
+
</linearGradient>
|
|
7
|
+
</defs>
|
|
8
|
+
<rect width="36" height="36" fill="url(#git-bg)"/>
|
|
9
|
+
<g transform="translate(8 8) scale(0.8333)" stroke="#fff" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
|
|
10
|
+
<path d="M6 3v12"/>
|
|
11
|
+
<circle cx="18" cy="6" r="3"/>
|
|
12
|
+
<circle cx="6" cy="18" r="3"/>
|
|
13
|
+
<path d="M18 9a9 9 0 0 1-9 9"/>
|
|
14
|
+
</g>
|
|
15
|
+
</svg>
|