Agent 自动改进 API

    状态：已实现
    设置入口：设置 → 自动改进
    源码：py_tauri_works/src/services/agent/improvement*.ts、src/api/agentImprovement/

    Agent 在本机运行；自动改进服务仅收集提案与下发运行时规则，不托管 Agent 执行。

    一、云端 HTTP API

    基址：https://a.5x10.cn（AGENT_IMPROVEMENT_API_BASE）

    均需登录态 tokenId + accessToken（桌面端账号 Token）。

    方法路径说明
    POST/userExtend/agent-improvement/submit提交改进提案（form-urlencoded）
    GET/userExtend/agent-improvement/rules拉取运行时规则包（可选带 Token）
    GET/userExtend/agent-improvement/list-mine本账号提交的提案分页
    GET/userExtend/agent-improvement/list-remote全站远端提案（管理/开发用途；status、keyword、orderBy）

    submit 主要字段：fingerprint、title、severity、rationale、proposal_json、app_version、run_id。

    前端封装：src/api/agentImprovement/index.ts。

    二、本地日志目录

    默认：{用户工作目录}/agent-improvement-logs/

    路径内容
    events-YYYY-MM-DD.jsonl检测/上报事件流
    proposals/{fingerprint}.md单条提案 Markdown
    fix-reports/{fingerprint}.mdIDE 修复后 mark_issue_status 写入的报告
    issues-index.meta.json索引 v2：总数、页数、open/resolved
    issues-index.fp-map.jsonfingerprint → 页码
    issues-index.pages/page-NNNN.json每页最多 50 条

    旧版单文件 issues-index.json 首次读取时自动迁移到 v2 分页布局。

    三、IDE 调试 MCP

    服务名（mcp.json 键）：5xworks-improvement-debug

    示例脚本：py_tauri_works/examples/mcp-improvement/server.py

    MCP 工具

    工具参数（摘要）说明
    list_issuespage、limit、status、severity分页列出问题
    get_issuefingerprint详情（patchHint、codePaths）
    get_issue_markdownfingerprint提案 Markdown；无文件时从索引合成
    mark_issue_statusfingerprint、status、noteopen / resolved / ignored

    环境变量：WORKS_IMPROVEMENT_LOGS_ROOT 指向上述日志目录。

    Tauri 命令

    命令说明
    improvement_mcp_resolve_paths解析脚本路径与日志根目录
    improvement_mcp_start本机启动 MCP（验证用；Cursor 通常自行 spawn）
    improvement_mcp_stop停止
    improvement_mcp_status运行状态

    实现：src-tauri/src/improvement_mcp.rs。

    UI

    入口说明
    设置 → 自动改进开关、复制 MCP 配置、启动/停止、打开目录
    标题栏 调试 MCP·开/关improvementDebugTitleBar.ts
    改进问题浏览器ImprovementIssuesDialog.vue（开发构建可拉远端全站）

    四、本机运行时规则

    runtimeRulesStore.ts：规则型提案可 自动热加载（设置开关）。
    apiFetchRuntimeRules 拉取服务端已发布规则包，注入 Agent 提示层。

    五、推荐 IDE 工作流

    list_issues(open) → get_issue_markdown → 按 patchHint 改代码 → mark_issue_status(resolved)

    话术示例见 examples/mcp-improvement/README.md。

    相关文档