merge feature/skill-cli

Author: Hangsu

README.md

@@ -216,6 +216,20 @@ pnpm test
 pnpm lint
 ```
 
+### Skill-oriented CLI
+
+The `echo-profile` binary also exposes a JSON-only CLI for skills and automation:
+
+```bash
+echo-profile version
+echo-profile list providers
+echo-profile list sessions --current-project
+echo-profile profile collect --scope project --current-project --budget-chars 30000
+```
+
+`profile collect` only gathers local user-message text as structured JSON. It does not call an LLM or generate a profile; Codex skills or other agents can use the returned messages as profile-generation input.
+
+
 ## Good first contribution areas
 
 EchoProfile is especially open to contributions in these areas:

README.zh-CN.md

@@ -186,6 +186,20 @@ pnpm test
 pnpm lint
 ```
 
+### 面向 Skill 的 CLI
+
+`echo-profile` 二进制也提供 JSON-only CLI，方便 skill 和自动化流程调用：
+
+```bash
+echo-profile version
+echo-profile list providers
+echo-profile list sessions --current-project
+echo-profile profile collect --scope project --current-project --budget-chars 30000
+```
+
+`profile collect` 只会把本地用户消息文本收集为结构化 JSON。它不会调用 LLM，也不会直接生成画像；Codex skill 或其他 agent 可以使用返回的消息作为画像生成输入。
+
+
 ## 适合贡献什么？
 
 EchoProfile 很适合以下方向的贡献：

src-tauri/Cargo.toml

@@ -24,6 +24,7 @@ tauri-build = { version = "2.5.3", features = [] }
 [dependencies]
 serde_json = "1.0"
 serde = { version = "1.0", features = ["derive"] }
+clap = { version = "4.5", features = ["derive"] }
 log = "0.4"
 tauri = { version = "2.10.1", features = [] }
 tauri-plugin-log = "2.7.1"

src-tauri/src/cli/args.rs

@@ -0,0 +1,198 @@
+use clap::{Args, Parser, Subcommand, ValueEnum};
+
+#[derive(Debug, Parser)]
+#[command(
+    name = "echo-profile",
+    disable_help_flag = true,
+    disable_help_subcommand = true
+)]
+pub struct CliArgs {
+    #[arg(long, global = true)]
+    pub json: bool,
+    #[command(subcommand)]
+    pub command: CliCommand,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum CliCommand {
+    Help(HelpArgs),
+    Version,
+    List(ListArgs),
+    Profile(ProfileArgs),
+    Serve(ServeArgs),
+}
+
+#[derive(Debug, Args)]
+pub struct HelpArgs {
+    pub topic: Vec<String>,
+}
+
+#[derive(Debug, Args)]
+pub struct ServeArgs {
+    #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
+    pub args: Vec<String>,
+}
+
+#[derive(Debug, Args)]
+pub struct ListArgs {
+    #[command(subcommand)]
+    pub command: ListCommand,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum ListCommand {
+    Providers(ProviderListArgs),
+    Projects(ProjectListArgs),
+    Sessions(SessionListArgs),
+}
+
+#[derive(Debug, Args, Default)]
+pub struct ProviderListArgs {
+    #[arg(long = "provider")]
+    pub providers: Vec<String>,
+    #[arg(long = "providers")]
+    pub providers_csv: Option<String>,
+}
+
+#[derive(Debug, Args, Default)]
+pub struct ProjectListArgs {
+    #[arg(long = "provider")]
+    pub providers: Vec<String>,
+    #[arg(long = "providers")]
+    pub providers_csv: Option<String>,
+    #[arg(long, default_value_t = 50)]
+    pub limit: usize,
+    #[arg(long, default_value_t = 0)]
+    pub offset: usize,
+    #[arg(long)]
+    pub since: Option<String>,
+    #[arg(long)]
+    pub until: Option<String>,
+    #[arg(long)]
+    pub no_cache: bool,
+}
+
+#[derive(Debug, Args, Default)]
+pub struct SessionListArgs {
+    #[arg(long = "provider")]
+    pub providers: Vec<String>,
+    #[arg(long = "providers")]
+    pub providers_csv: Option<String>,
+    #[arg(long, default_value_t = 50)]
+    pub limit: usize,
+    #[arg(long, default_value_t = 0)]
+    pub offset: usize,
+    #[arg(long)]
+    pub current_project: bool,
+    #[arg(long)]
+    pub include_ancestor_projects: bool,
+    #[arg(long)]
+    pub actual_project_path: Option<String>,
+    #[arg(long)]
+    pub project_path: Option<String>,
+    #[arg(long)]
+    pub since: Option<String>,
+    #[arg(long)]
+    pub until: Option<String>,
+    #[arg(long)]
+    pub no_cache: bool,
+}
+
+#[derive(Debug, Args)]
+pub struct ProfileArgs {
+    #[command(subcommand)]
+    pub command: ProfileCommand,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum ProfileCommand {
+    Collect(CollectArgs),
+}
+
+#[derive(Debug, Args)]
+#[allow(clippy::struct_excessive_bools)]
+pub struct CollectArgs {
+    #[arg(long, value_enum)]
+    pub scope: CollectScope,
+    #[arg(long = "provider")]
+    pub providers: Vec<String>,
+    #[arg(long = "providers")]
+    pub providers_csv: Option<String>,
+    #[arg(long)]
+    pub current_project: bool,
+    #[arg(long)]
+    pub include_ancestor_projects: bool,
+    #[arg(long)]
+    pub actual_project_path: Option<String>,
+    #[arg(long)]
+    pub project_path: Option<String>,
+    #[arg(long)]
+    pub session_path: Option<String>,
+    #[arg(long, value_enum)]
+    pub sample: Option<SampleStrategy>,
+    #[arg(long, default_value_t = 30_000)]
+    pub budget_chars: usize,
+    #[arg(long, default_value_t = 50)]
+    pub paste_detect_min_chars: usize,
+    #[arg(long, default_value_t = 0.7)]
+    pub paste_like_threshold: f64,
+    #[arg(long)]
+    pub include_paste_like: bool,
+    #[arg(long)]
+    pub since: Option<String>,
+    #[arg(long)]
+    pub until: Option<String>,
+    #[arg(long, default_value_t = 1000)]
+    pub max_sessions_scan: usize,
+    #[arg(long, default_value_t = 50_000)]
+    pub max_messages_scan: usize,
+    #[arg(long)]
+    pub no_cache: bool,
+}
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
+pub enum CollectScope {
+    Global,
+    Project,
+    Session,
+}
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq, ValueEnum)]
+pub enum SampleStrategy {
+    Recent,
+    Representative,
+    Mixed,
+    Chronological,
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn parses_version_command() {
+        let cli = CliArgs::try_parse_from(["echo-profile", "version"]).unwrap();
+        assert!(matches!(cli.command, CliCommand::Version));
+    }
+
+    #[test]
+    fn parses_profile_collect_project_current() {
+        let cli = CliArgs::try_parse_from([
+            "echo-profile",
+            "profile",
+            "collect",
+            "--scope",
+            "project",
+            "--current-project",
+        ])
+        .unwrap();
+        let CliCommand::Profile(ProfileArgs {
+            command: ProfileCommand::Collect(args),
+        }) = cli.command
+        else {
+            panic!("expected profile collect");
+        };
+        assert_eq!(args.scope, CollectScope::Project);
+        assert!(args.current_project);
+    }
+}