diff --git a/.serena/.gitignore b/.serena/.gitignore new file mode 100644 index 0000000..2e510af --- /dev/null +++ b/.serena/.gitignore @@ -0,0 +1,2 @@ +/cache +/project.local.yml diff --git a/.serena/project.yml b/.serena/project.yml new file mode 100644 index 0000000..c9a1cde --- /dev/null +++ b/.serena/project.yml @@ -0,0 +1,154 @@ +# the name by which the project can be referenced within Serena +project_name: "timi-java" + + +# list of languages for which language servers are started; choose from: +# al bash clojure cpp csharp +# csharp_omnisharp dart elixir elm erlang +# fortran fsharp go groovy haskell +# haxe java julia kotlin lua +# markdown +# matlab nix pascal perl php +# php_phpactor powershell python python_jedi r +# rego ruby ruby_solargraph rust scala +# swift terraform toml typescript typescript_vts +# vue yaml zig +# (This list may be outdated. For the current list, see values of Language enum here: +# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py +# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.) +# Note: +# - For C, use cpp +# - For JavaScript, use typescript +# - For Free Pascal/Lazarus, use pascal +# Special requirements: +# Some languages require additional setup/installations. +# See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers +# When using multiple languages, the first language server that supports a given file will be used for that file. +# The first language is the default language and the respective language server will be used as a fallback. +# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored. +languages: +- java + +# the encoding used by text files in the project +# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings +encoding: "utf-8" + +# line ending convention to use when writing source files. +# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default) +# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings. +line_ending: + +# The language backend to use for this project. +# If not set, the global setting from serena_config.yml is used. +# Valid values: LSP, JetBrains +# Note: the backend is fixed at startup. If a project with a different backend +# is activated post-init, an error will be returned. +language_backend: + +# whether to use project's .gitignore files to ignore files +ignore_all_files_in_gitignore: true + +# advanced configuration option allowing to configure language server-specific options. +# Maps the language key to the options. +# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available. +# No documentation on options means no options are available. +ls_specific_settings: {} + +# list of additional paths to ignore in this project. +# Same syntax as gitignore, so you can use * and **. +# Note: global ignored_paths from serena_config.yml are also applied additively. +ignored_paths: [] + +# whether the project is in read-only mode +# If set to true, all editing tools will be disabled and attempts to use them will result in an error +# Added on 2025-04-18 +read_only: false + +# list of tool names to exclude. +# This extends the existing exclusions (e.g. from the global configuration) +# +# Below is the complete list of tools for convenience. +# To make sure you have the latest list of tools, and to view their descriptions, +# execute `uv run scripts/print_tool_overview.py`. +# +# * `activate_project`: Activates a project based on the project name or path. +# * `check_onboarding_performed`: Checks whether project onboarding was already performed. +# * `create_text_file`: Creates/overwrites a file in the project directory. +# * `delete_memory`: Delete a memory file. Should only happen if a user asks for it explicitly, +# for example by saying that the information retrieved from a memory file is no longer correct +# or no longer relevant for the project. +# * `edit_memory`: Replaces content matching a regular expression in a memory. +# * `execute_shell_command`: Executes a shell command. +# * `find_file`: Finds files in the given relative paths +# * `find_referencing_symbols`: Finds symbols that reference the given symbol using the language server backend +# * `find_symbol`: Performs a global (or local) search using the language server backend. +# * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes. +# * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file. +# * `initial_instructions`: Provides instructions Serena usage (i.e. the 'Serena Instructions Manual') +# for clients that do not read the initial instructions when the MCP server is connected. +# * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol. +# * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol. +# * `list_dir`: Lists files and directories in the given directory (optionally with recursion). +# * `list_memories`: List available memories. Any memory can be read using the `read_memory` tool. +# * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building). +# * `read_file`: Reads a file within the project directory. +# * `read_memory`: Read the content of a memory file. This tool should only be used if the information +# is relevant to the current task. You can infer whether the information +# is relevant from the memory file name. +# You should not read the same memory file multiple times in the same conversation. +# * `rename_memory`: Renames or moves a memory. Moving between project and global scope is supported +# (e.g., renaming "global/foo" to "bar" moves it from global to project scope). +# * `rename_symbol`: Renames a symbol throughout the codebase using language server refactoring capabilities. +# For JB, we use a separate tool. +# * `replace_content`: Replaces content in a file (optionally using regular expressions). +# * `replace_symbol_body`: Replaces the full definition of a symbol using the language server backend. +# * `safe_delete_symbol`: +# * `search_for_pattern`: Performs a search for a pattern in the project. +# * `write_memory`: Write some information (utf-8-encoded) about this project that can be useful for future tasks to a memory in md format. +# The memory name should be meaningful. +excluded_tools: [] + +# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default). +# This extends the existing inclusions (e.g. from the global configuration). +included_optional_tools: [] + +# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools. +# This cannot be combined with non-empty excluded_tools or included_optional_tools. +fixed_tools: [] + +# list of mode names to that are always to be included in the set of active modes +# The full set of modes to be activated is base_modes + default_modes. +# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply. +# Otherwise, this setting overrides the global configuration. +# Set this to [] to disable base modes for this project. +# Set this to a list of mode names to always include the respective modes for this project. +base_modes: + +# list of mode names that are to be activated by default. +# The full set of modes to be activated is base_modes + default_modes. +# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply. +# Otherwise, this overrides the setting from the global configuration (serena_config.yml). +# This setting can, in turn, be overridden by CLI parameters (--mode). +default_modes: + +# initial prompt for the project. It will always be given to the LLM upon activating the project +# (contrary to the memories, which are loaded on demand). +initial_prompt: "" + +# time budget (seconds) per tool call for the retrieval of additional symbol information +# such as docstrings or parameter information. +# This overrides the corresponding setting in the global configuration; see the documentation there. +# If null or missing, use the setting from the global configuration. +symbol_info_budget: + +# list of regex patterns which, when matched, mark a memory entry as read‑only. +# Extends the list from the global configuration, merging the two lists. +read_only_memory_patterns: [] + +# list of regex patterns for memories to completely ignore. +# Matching memories will not appear in list_memories or activate_project output +# and cannot be accessed via read_memory or write_memory. +# To access ignored memory files, use the read_file tool on the raw file path. +# Extends the list from the global configuration, merging the two lists. +# Example: ["_archive/.*", "_episodes/.*"] +ignored_memory_patterns: [] diff --git a/src/main/java/com/imyeyu/java/bean/timi/TimiError.java b/src/main/java/com/imyeyu/java/bean/ActionError.java similarity index 65% rename from src/main/java/com/imyeyu/java/bean/timi/TimiError.java rename to src/main/java/com/imyeyu/java/bean/ActionError.java index cb40223..5435e6a 100644 --- a/src/main/java/com/imyeyu/java/bean/timi/TimiError.java +++ b/src/main/java/com/imyeyu/java/bean/ActionError.java @@ -1,4 +1,4 @@ -package com.imyeyu.java.bean.timi; +package com.imyeyu.java.bean; import lombok.Getter; @@ -11,10 +11,10 @@ import java.util.Map; * @since 2023-04-27 15:55 */ @Getter -public class TimiError extends AssertionError { +public class ActionError extends AssertionError { /** 代码 */ - protected final TimiCode code; + protected final ResultCode code; /** 消息代码 */ protected final String messageCode; @@ -23,7 +23,7 @@ public class TimiError extends AssertionError { protected final transient Map messageArgs; /** @param code 代码 */ - public TimiError(TimiCode code) { + public ActionError(ResultCode code) { this(code, code.toString()); } @@ -33,7 +33,7 @@ public class TimiError extends AssertionError { * @param code 代码 * @param messageCode 消息代码 */ - public TimiError(TimiCode code, String messageCode) { + public ActionError(ResultCode code, String messageCode) { this(code, messageCode, null); } @@ -44,7 +44,7 @@ public class TimiError extends AssertionError { * @param messageCode 消息代码 * @param messageArgs 消息插值参数 */ - public TimiError(TimiCode code, String messageCode, Map messageArgs) { + public ActionError(ResultCode code, String messageCode, Map messageArgs) { super(messageCode); this.code = code; this.messageCode = messageCode; @@ -56,7 +56,7 @@ public class TimiError extends AssertionError { * * @return 响应 */ - public TimiResponse toResponse() { - return new TimiResponse<>(code).messageCode(messageCode, messageArgs); + public Response toResponse() { + return new Response<>(code).messageCode(messageCode, messageArgs); } } diff --git a/src/main/java/com/imyeyu/java/bean/timi/TimiException.java b/src/main/java/com/imyeyu/java/bean/ActionException.java similarity index 57% rename from src/main/java/com/imyeyu/java/bean/timi/TimiException.java rename to src/main/java/com/imyeyu/java/bean/ActionException.java index 03b45b7..955cfe4 100644 --- a/src/main/java/com/imyeyu/java/bean/timi/TimiException.java +++ b/src/main/java/com/imyeyu/java/bean/ActionException.java @@ -1,7 +1,6 @@ -package com.imyeyu.java.bean.timi; +package com.imyeyu.java.bean; import com.imyeyu.java.TimiJava; -import com.imyeyu.java.bean.CallbackReturn; import lombok.Getter; import java.util.Map; @@ -13,10 +12,10 @@ import java.util.Map; * @since 2021-05-20 15:18 */ @Getter -public class TimiException extends RuntimeException { +public class ActionException extends RuntimeException { /** 代码 */ - protected final TimiCode code; + protected final ResultCode code; /** 消息代码 */ protected final String messageCode; @@ -25,7 +24,7 @@ public class TimiException extends RuntimeException { protected final transient Map messageArgs; /** @param code 代码 */ - public TimiException(TimiCode code) { + public ActionException(ResultCode code) { this(code, code.toString()); } @@ -35,7 +34,7 @@ public class TimiException extends RuntimeException { * @param code 代码 * @param messageCode 消息代码 */ - public TimiException(TimiCode code, String messageCode) { + public ActionException(ResultCode code, String messageCode) { this(code, messageCode, (Map) null); } @@ -46,7 +45,7 @@ public class TimiException extends RuntimeException { * @param messageCode 消息代码 * @param messageArgs 消息插值参数 */ - public TimiException(TimiCode code, String messageCode, Map messageArgs) { + public ActionException(ResultCode code, String messageCode, Map messageArgs) { super(messageCode); this.code = code; this.messageCode = messageCode; @@ -60,7 +59,7 @@ public class TimiException extends RuntimeException { * @param messageCode 消息代码 * @param e 异常 */ - public TimiException(TimiCode code, String messageCode, Throwable e) { + public ActionException(ResultCode code, String messageCode, Throwable e) { super(messageCode, e); this.code = code; this.messageCode = messageCode; @@ -72,63 +71,63 @@ public class TimiException extends RuntimeException { * * @return 响应 */ - public TimiResponse toResponse() { - return new TimiResponse<>(code).messageCode(messageCode, messageArgs); + public Response toResponse() { + return new Response<>(code).messageCode(messageCode, messageArgs); } public static T required(T t, String messageCode) { if (TimiJava.isEmpty(t)) { - throw new TimiException(TimiCode.ARG_MISS, messageCode); + throw new ActionException(ResultCode.ARG_MISS, messageCode); } return t; } public static T required(T t, String messageCode, Map messageArgs) { if (TimiJava.isEmpty(t)) { - throw new TimiException(TimiCode.ARG_MISS, messageCode, messageArgs); + throw new ActionException(ResultCode.ARG_MISS, messageCode, messageArgs); } return t; } - public static void requiredNull(T t, String messageCode) throws TimiException { + public static void requiredNull(T t, String messageCode) throws ActionException { if (t != null) { - throw new TimiException(TimiCode.ERROR, messageCode); + throw new ActionException(ResultCode.ERROR, messageCode); } } - public static void requiredNull(T t, String messageCode, Map messageArgs) throws TimiException { + public static void requiredNull(T t, String messageCode, Map messageArgs) throws ActionException { if (t != null) { - throw new TimiException(TimiCode.ERROR, messageCode, messageArgs); + throw new ActionException(ResultCode.ERROR, messageCode, messageArgs); } } - public static void requiredTrue(boolean bool, String messageCode) throws TimiException { + public static void requiredTrue(boolean bool, String messageCode) throws ActionException { if (bool) { return; } - throw new TimiException(TimiCode.ERROR, messageCode); + throw new ActionException(ResultCode.ERROR, messageCode); } - public static void requiredTrue(boolean bool, String messageCode, Map messageArgs) throws TimiException { + public static void requiredTrue(boolean bool, String messageCode, Map messageArgs) throws ActionException { if (bool) { return; } - throw new TimiException(TimiCode.ERROR, messageCode, messageArgs); + throw new ActionException(ResultCode.ERROR, messageCode, messageArgs); } - public static void requiredTrue(CallbackReturn callback, String messageCode) throws TimiException { - TimiException.required(callback, "not found callback"); + public static void requiredTrue(CallbackReturn callback, String messageCode) throws ActionException { + ActionException.required(callback, "not found callback"); if (callback.handler()) { return; } - throw new TimiException(TimiCode.ERROR, messageCode); + throw new ActionException(ResultCode.ERROR, messageCode); } - public static void requiredTrue(CallbackReturn callback, String messageCode, Map messageArgs) throws TimiException { - TimiException.required(callback, "not found callback"); + public static void requiredTrue(CallbackReturn callback, String messageCode, Map messageArgs) throws ActionException { + ActionException.required(callback, "not found callback"); if (callback.handler()) { return; } - throw new TimiException(TimiCode.ERROR, messageCode, messageArgs); + throw new ActionException(ResultCode.ERROR, messageCode, messageArgs); } } diff --git a/src/main/java/com/imyeyu/java/bean/timi/TimiResponse.java b/src/main/java/com/imyeyu/java/bean/Response.java similarity index 75% rename from src/main/java/com/imyeyu/java/bean/timi/TimiResponse.java rename to src/main/java/com/imyeyu/java/bean/Response.java index e11d565..1194950 100644 --- a/src/main/java/com/imyeyu/java/bean/timi/TimiResponse.java +++ b/src/main/java/com/imyeyu/java/bean/Response.java @@ -1,4 +1,4 @@ -package com.imyeyu.java.bean.timi; +package com.imyeyu.java.bean; import lombok.Getter; import lombok.NoArgsConstructor; @@ -16,7 +16,7 @@ import java.util.Map; * @since 2021-07-01 20:18 */ @NoArgsConstructor -public class TimiResponse implements Serializable { +public class Response implements Serializable { /** 响应代码 */ @Setter @@ -48,7 +48,7 @@ public class TimiResponse implements Serializable { * * @param code 代码 */ - public TimiResponse(TimiCode code) { + public Response(ResultCode code) { this(code, null); } @@ -58,7 +58,7 @@ public class TimiResponse implements Serializable { * @param code 代码 * @param data 数据体 */ - public TimiResponse(TimiCode code, T data) { + public Response(ResultCode code, T data) { this(code, data, null); } @@ -69,7 +69,7 @@ public class TimiResponse implements Serializable { * @param data 数据体 * @param message 响应消息 */ - public TimiResponse(TimiCode code, T data, String message) { + public Response(ResultCode code, T data, String message) { this.code = code.getValue(); this.data = data; this.message = message; @@ -90,12 +90,12 @@ public class TimiResponse implements Serializable { * * @return 异常 */ - public TimiException toException() { - TimiCode code = TimiCode.fromCode(this.code); + public ActionException toException() { + ResultCode code = ResultCode.fromCode(this.code); if (code == null) { throw new NullPointerException("unknow timi code: " + this.code); } - return new TimiException(code, messageCode == null ? message : messageCode, messageArgs); + return new ActionException(code, messageCode == null ? message : messageCode, messageArgs); } /** @@ -104,7 +104,7 @@ public class TimiResponse implements Serializable { * @param message 响应消息 * @return 本对象 */ - public TimiResponse message(String message) { + public Response message(String message) { this.message = message; return this; } @@ -115,7 +115,7 @@ public class TimiResponse implements Serializable { * @param messageCode 响应消息代码 * @return 本对象 */ - public TimiResponse messageCode(String messageCode) { + public Response messageCode(String messageCode) { this.messageCode = messageCode; return this; } @@ -127,7 +127,7 @@ public class TimiResponse implements Serializable { * @param messageArgs 插值参数 * @return 本对象 */ - public TimiResponse messageCode(String messageCode, Map messageArgs) { + public Response messageCode(String messageCode, Map messageArgs) { this.messageCode = messageCode; this.messageArgs = messageArgs; return this; diff --git a/src/main/java/com/imyeyu/java/bean/timi/TimiCode.java b/src/main/java/com/imyeyu/java/bean/ResultCode.java similarity index 77% rename from src/main/java/com/imyeyu/java/bean/timi/TimiCode.java rename to src/main/java/com/imyeyu/java/bean/ResultCode.java index faa9f08..4c293e2 100644 --- a/src/main/java/com/imyeyu/java/bean/timi/TimiCode.java +++ b/src/main/java/com/imyeyu/java/bean/ResultCode.java @@ -1,4 +1,4 @@ -package com.imyeyu.java.bean.timi; +package com.imyeyu.java.bean; import lombok.Getter; @@ -9,7 +9,7 @@ import lombok.Getter; * @since 2021-05-21 14:32 */ @Getter -public enum TimiCode { +public enum ResultCode { // ---------- 200 正常 ---------- @@ -80,7 +80,7 @@ public enum TimiCode { /** 代码 */ final Integer value; - TimiCode(Integer value) { + ResultCode(Integer value) { this.value = value; } @@ -89,7 +89,7 @@ public enum TimiCode { * * @return 异常 */ - public TimiException toException() { + public ActionException toException() { return toException(toString()); } @@ -99,8 +99,8 @@ public enum TimiCode { * @param msg 异常消息 * @return 异常 */ - public TimiException toException(String msg) { - return new TimiException(this, msg); + public ActionException toException(String msg) { + return new ActionException(this, msg); } /** @@ -108,8 +108,8 @@ public enum TimiCode { * * @return 返回对象 */ - public TimiResponse toResponse() { - return new TimiResponse<>(this).message(toString()); + public Response toResponse() { + return new Response<>(this).message(toString()); } /** @@ -118,11 +118,11 @@ public enum TimiCode { * @param code 代码 * @return 对象 */ - public static TimiCode fromCode(int code) { - TimiCode[] codes = values(); - for (TimiCode timiCode : codes) { - if (timiCode.getValue() == code) { - return timiCode; + public static ResultCode fromCode(int code) { + ResultCode[] codes = values(); + for (ResultCode resultCode : codes) { + if (resultCode.getValue() == code) { + return resultCode; } } return null; diff --git a/src/main/java/com/imyeyu/java/bean/timi/package-info.java b/src/main/java/com/imyeyu/java/bean/timi/package-info.java deleted file mode 100644 index fdb3713..0000000 --- a/src/main/java/com/imyeyu/java/bean/timi/package-info.java +++ /dev/null @@ -1,2 +0,0 @@ -/** 个人常用的通用类 */ -package com.imyeyu.java.bean.timi; \ No newline at end of file diff --git a/src/main/java/com/imyeyu/java/thread/AsyncRetryExecutor.java b/src/main/java/com/imyeyu/java/thread/AsyncRetryExecutor.java index 93c3426..c4403df 100644 --- a/src/main/java/com/imyeyu/java/thread/AsyncRetryExecutor.java +++ b/src/main/java/com/imyeyu/java/thread/AsyncRetryExecutor.java @@ -2,7 +2,7 @@ package com.imyeyu.java.thread; import com.imyeyu.java.bean.Callback; import com.imyeyu.java.bean.CallbackArg; -import com.imyeyu.java.bean.timi.TimiException; +import com.imyeyu.java.bean.ActionException; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; @@ -83,8 +83,8 @@ public class AsyncRetryExecutor { * @param task 构建器对象 */ private AsyncRetryExecutor(Task task) { - TimiException.required(task, "not found task"); - TimiException.required(task.getCallback(), "not found task.callback"); + ActionException.required(task, "not found task"); + ActionException.required(task.getCallback(), "not found task.callback"); thread = new Thread(() -> { int retryCount = 0; while (isRunning && !isSuccess && (task.maxRetry < 0 || retryCount <= task.maxRetry)) {