@sakanano-moe/agenthelm 6.13.1 → 6.14.0-rc.2

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 (117) hide show
  1. package/package.json +1 -1
  2. package/runtime/index.json +6 -6
  3. package/runtime/plugins/agent-pack/.codex-plugin/plugin.json +1 -1
  4. package/runtime/plugins/agent-pack/plugin.json +1 -1
  5. package/runtime/plugins/agent-pack/references/capability-config.md +10 -0
  6. package/runtime/plugins/agent-pack/references/check-opinion-migrate.en.md +31 -0
  7. package/runtime/plugins/agent-pack/references/check-opinion-migrate.md +31 -0
  8. package/runtime/plugins/agent-pack/references/dedupe-contract.en.md +27 -0
  9. package/runtime/plugins/agent-pack/references/dedupe-contract.md +27 -0
  10. package/runtime/plugins/agent-pack/references/inventory-contract.en.md +83 -0
  11. package/runtime/plugins/agent-pack/references/inventory-contract.md +83 -0
  12. package/runtime/plugins/agent-pack/references/nudge.en.md +10 -2
  13. package/runtime/plugins/agent-pack/references/nudge.md +10 -2
  14. package/runtime/plugins/agent-pack/references/relocate-contract.en.md +41 -0
  15. package/runtime/plugins/agent-pack/references/relocate-contract.md +41 -0
  16. package/runtime/plugins/agent-pack/runtime/agent_pack_claude.py +572 -30
  17. package/runtime/plugins/agent-pack/runtime/agent_pack_clients.py +233 -0
  18. package/runtime/plugins/agent-pack/runtime/agent_pack_config.py +112 -4
  19. package/runtime/plugins/agent-pack/runtime/agent_pack_dedupe.py +502 -0
  20. package/runtime/plugins/agent-pack/runtime/agent_pack_desktop.py +92 -0
  21. package/runtime/plugins/agent-pack/runtime/agent_pack_ext_common.py +251 -0
  22. package/runtime/plugins/agent-pack/runtime/agent_pack_inventory.py +989 -0
  23. package/runtime/plugins/agent-pack/runtime/agent_pack_mcp_write.py +447 -0
  24. package/runtime/plugins/agent-pack/runtime/agent_pack_nudge.py +29 -4
  25. package/runtime/plugins/agent-pack/runtime/agent_pack_relocate.py +385 -0
  26. package/runtime/plugins/agent-pack/runtime/agent_pack_scope.py +233 -0
  27. package/runtime/plugins/agent-pack/runtime/agenthelm.py +183 -14
  28. package/runtime/plugins/agent-pack/runtime/locale/en.json +250 -1
  29. package/runtime/plugins/agent-pack/runtime/mcp_server.py +12 -0
  30. package/runtime/plugins/agent-pack/runtime/nudge_text.py +8 -2
  31. package/runtime/plugins/agent-pack/runtime/user_settings.py +2 -1
  32. package/runtime/plugins/agent-pack/skills/agent-pack/SKILL.md +15 -0
  33. package/runtime/plugins/agents-init/.codex-plugin/plugin.json +1 -1
  34. package/runtime/plugins/agents-init/content.json +4 -2
  35. package/runtime/plugins/agents-init/plugin.json +1 -1
  36. package/runtime/plugins/agents-init/skills/agents-init/SKILL.md +2 -0
  37. package/runtime/plugins/agents-init/skills/agents-init/launcher.en.sh +93 -0
  38. package/runtime/plugins/agents-init/skills/agents-init/project.schema.json +27 -0
  39. package/runtime/plugins/agents-init/skills/agents-init/scripts/baseline.py +4 -1
  40. package/runtime/plugins/agents-init/skills/agents-init/scripts/init_project.py +24 -9
  41. package/runtime/plugins/agents-init/skills/agents-init/skill.json +1 -1
  42. package/runtime/plugins/opinion-manager/.codex-plugin/plugin.json +1 -1
  43. package/runtime/plugins/opinion-manager/catalog/README.md +3 -1
  44. package/runtime/plugins/opinion-manager/catalog/rules/om.align-requirements/versions/1.1.0.json +34 -0
  45. package/runtime/plugins/opinion-manager/catalog/rules/om.assumptions-authority/versions/1.1.0.json +34 -0
  46. package/runtime/plugins/opinion-manager/catalog/rules/om.batch-questions/versions/1.1.0.json +34 -0
  47. package/runtime/plugins/opinion-manager/catalog/rules/om.bilingual-terms/versions/1.1.0.json +34 -0
  48. package/runtime/plugins/opinion-manager/catalog/rules/om.calculations/versions/1.1.0.json +34 -0
  49. package/runtime/plugins/opinion-manager/catalog/rules/om.chinese-response/versions/1.1.0.json +34 -0
  50. package/runtime/plugins/opinion-manager/catalog/rules/om.clean-deliverable/versions/1.1.0.json +34 -0
  51. package/runtime/plugins/opinion-manager/catalog/rules/om.complete-options/versions/1.1.0.json +34 -0
  52. package/runtime/plugins/opinion-manager/catalog/rules/om.conclusion-first/versions/1.1.0.json +34 -0
  53. package/runtime/plugins/opinion-manager/catalog/rules/om.concrete-titles/versions/1.1.0.json +34 -0
  54. package/runtime/plugins/opinion-manager/catalog/rules/om.consistent-items/versions/1.1.0.json +34 -0
  55. package/runtime/plugins/opinion-manager/catalog/rules/om.device-readable/versions/1.1.0.json +34 -0
  56. package/runtime/plugins/opinion-manager/catalog/rules/om.editable-diagrams/versions/1.1.0.json +34 -0
  57. package/runtime/plugins/opinion-manager/catalog/rules/om.evidence-inference/versions/1.1.0.json +34 -0
  58. package/runtime/plugins/opinion-manager/catalog/rules/om.maintenance-chinese/versions/1.1.0.json +34 -0
  59. package/runtime/plugins/opinion-manager/catalog/rules/om.maintenance-project-language/versions/1.1.0.json +34 -0
  60. package/runtime/plugins/opinion-manager/catalog/rules/om.markdown-structure/versions/1.1.0.json +34 -0
  61. package/runtime/plugins/opinion-manager/catalog/rules/om.portable-files/versions/1.1.0.json +34 -0
  62. package/runtime/plugins/opinion-manager/catalog/rules/om.report-context/versions/1.1.0.json +34 -0
  63. package/runtime/plugins/opinion-manager/catalog/rules/om.report-formats/versions/1.1.0.json +34 -0
  64. package/runtime/plugins/opinion-manager/catalog/rules/om.report-review/versions/1.1.0.json +34 -0
  65. package/runtime/plugins/opinion-manager/catalog/rules/om.response-brief/versions/1.1.0.json +34 -0
  66. package/runtime/plugins/opinion-manager/catalog/rules/om.response-dense/versions/1.1.0.json +34 -0
  67. package/runtime/plugins/opinion-manager/catalog/rules/om.rules-tools/versions/1.1.0.json +34 -0
  68. package/runtime/plugins/opinion-manager/catalog/rules/om.semantic-wrap/versions/1.1.0.json +34 -0
  69. package/runtime/plugins/opinion-manager/catalog/rules/om.solutions-proportional/versions/1.1.0.json +34 -0
  70. package/runtime/plugins/opinion-manager/catalog/rules/om.solutions-three-level/versions/1.1.0.json +34 -0
  71. package/runtime/plugins/opinion-manager/catalog/rules/om.tables-compact/versions/1.1.0.json +34 -0
  72. package/runtime/plugins/opinion-manager/catalog/rules/om.tables-list-first/versions/1.1.0.json +34 -0
  73. package/runtime/plugins/opinion-manager/catalog/rules/om.test-evidence/versions/1.1.0.json +34 -0
  74. package/runtime/plugins/opinion-manager/catalog/rules/om.versioned-files/versions/1.1.0.json +34 -0
  75. package/runtime/plugins/opinion-manager/catalog/templates/delivery-standard/compact-tables/versions/1.1.0.json +32 -0
  76. package/runtime/plugins/opinion-manager/catalog/templates/delivery-standard/list-first/versions/1.1.0.json +32 -0
  77. package/runtime/plugins/opinion-manager/catalog/templates/development-standard/chinese-maintenance/versions/1.1.0.json +26 -0
  78. package/runtime/plugins/opinion-manager/catalog/templates/development-standard/project-language/versions/1.1.0.json +26 -0
  79. package/runtime/plugins/opinion-manager/catalog/templates/response-style/brief-chinese/versions/1.1.0.json +30 -0
  80. package/runtime/plugins/opinion-manager/catalog/templates/response-style/dense-chinese/versions/1.1.0.json +30 -0
  81. package/runtime/plugins/opinion-manager/catalog/templates/scenario/concise-project/versions/1.1.0.json +181 -0
  82. package/runtime/plugins/opinion-manager/catalog/templates/scenario/reviewed-project/versions/1.1.0.json +179 -0
  83. package/runtime/plugins/opinion-manager/catalog/templates/work-method/proportional/versions/1.1.0.json +31 -0
  84. package/runtime/plugins/opinion-manager/catalog/templates/work-method/three-level/versions/1.1.0.json +31 -0
  85. package/runtime/plugins/opinion-manager/content.json +44 -3
  86. package/runtime/plugins/opinion-manager/plugin.json +1 -1
  87. package/runtime/plugins/opinion-manager/references/inbox.en.md +25 -4
  88. package/runtime/plugins/opinion-manager/references/inbox.md +25 -4
  89. package/runtime/plugins/opinion-manager/references/profile.schema.json +19 -2
  90. package/runtime/plugins/opinion-manager/references/rule.schema.json +25 -3
  91. package/runtime/plugins/opinion-manager/references/versioned-template.schema.json +5 -4
  92. package/runtime/plugins/opinion-manager/references/versioning.md +89 -4
  93. package/runtime/plugins/opinion-manager/runtime/context.py +26 -19
  94. package/runtime/plugins/opinion-manager/runtime/inbox.py +400 -25
  95. package/runtime/plugins/opinion-manager/runtime/inbox_relations.py +106 -0
  96. package/runtime/plugins/opinion-manager/runtime/inbox_routes.py +132 -0
  97. package/runtime/plugins/opinion-manager/runtime/inbox_text.py +117 -11
  98. package/runtime/plugins/opinion-manager/runtime/lifecycle.py +35 -5
  99. package/runtime/plugins/opinion-manager/runtime/locale/en.json +137 -2
  100. package/runtime/plugins/opinion-manager/runtime/migrate.py +582 -0
  101. package/runtime/plugins/opinion-manager/runtime/opinion_manager.py +9 -4
  102. package/runtime/plugins/opinion-manager/runtime/rule_lines.py +247 -0
  103. package/runtime/plugins/opinion-manager/runtime/tags.py +217 -0
  104. package/runtime/plugins/opinion-manager/runtime/versioned.py +289 -41
  105. package/runtime/plugins/opinion-manager/skills/opinion-manager/SKILL.md +8 -7
  106. package/runtime/plugins/project-orchestrator/.codex-plugin/plugin.json +1 -1
  107. package/runtime/plugins/project-orchestrator/plugin.json +1 -1
  108. package/runtime/plugins/project-orchestrator/runtime/locale/en.json +305 -3
  109. package/runtime/plugins/project-orchestrator/runtime/private_paths.py +11 -1
  110. package/runtime/plugins/project-orchestrator/runtime/project_cli.py +101 -1
  111. package/runtime/plugins/project-orchestrator/runtime/project_demo.py +13 -1
  112. package/runtime/plugins/project-orchestrator/runtime/project_ext_actions.py +415 -0
  113. package/runtime/plugins/project-orchestrator/runtime/project_extensions.py +971 -0
  114. package/runtime/plugins/project-orchestrator/runtime/project_extensions_demo.py +86 -0
  115. package/runtime/plugins/project-orchestrator/runtime/project_menu.py +345 -2
  116. package/runtime/plugins/project-orchestrator/runtime/project_real.py +17 -1
  117. package/runtime/plugins/project-orchestrator/skills/project-orchestrator/SKILL.md +2 -0
@@ -0,0 +1,86 @@
1
+ """演示项目的「技能与 MCP」清单:固定夹具,形状与 ``agenthelm inventory`` 的 JSON 一致(schema_version 1)。
2
+
3
+ 全部是虚构的通用示例:路径用占位符,没有任何真实的值。MCP 条目只有名字、传输、指纹与变量名。
4
+ 含:同名同指纹的跨客户端重复、同客户端不同作用域的漂移、证据未知(unknown)的副本、没有 description 的技能。
5
+ """
6
+ from __future__ import annotations
7
+
8
+ import copy
9
+
10
+ SHA = {"review": "a1b2c3d4" * 8, "notes": "0f1e2d3c" * 8, "notes-old": "9a8b7c6d" * 8, "pdf": "5e4d3c2b" * 8, "plain": "77665544" * 8}
11
+
12
+
13
+ def _skill(name: str, client: str, scope: str, store: str, *, desc: int | None, chars: int | None = None,
14
+ md_bytes: int = 1200, lines: int = 40, sha: str = "review", origin: dict | None = None,
15
+ evidence: str = "file", **extra: object) -> dict:
16
+ entry = {"name": name, "client": client, "scope": scope, "store": store, "evidence": evidence,
17
+ "frontmatter": {"name": name, "description": ""}, "description_bytes": desc,
18
+ "description_chars": chars if chars is not None else desc, "skill_md_bytes": md_bytes, "skill_md_lines": lines,
19
+ "dir_bytes": md_bytes * 2, "file_count": 3, "content_sha256": SHA[sha], "is_symlink": False,
20
+ "name_matches_dir": True, "frontmatter_ok": desc != 0,
21
+ "origin": origin or {"type": "unknown", "id": None, "version": None, "latest_known": None, "evidence": "unknown"}}
22
+ entry.update(extra)
23
+ return entry
24
+
25
+
26
+ def _mcp(name: str, client: str, scope: str, store: str, fingerprint: str, *, transport: str = "stdio",
27
+ env: tuple[str, ...] = (), evidence: str = "file", **extra: object) -> dict:
28
+ entry = {"name": name, "client": client, "scope": scope, "store": store, "evidence": evidence, "transport": transport,
29
+ "fingerprint": fingerprint, "fingerprint_fields": ["command", "args", "env_var_names"],
30
+ "env_var_names": list(env), "has_inline_secret": False}
31
+ entry.update(extra)
32
+ return entry
33
+
34
+
35
+ INVENTORY = {
36
+ "schema_version": 1, "project": "<project>", "clients": ["claude", "codex", "cursor", "claude-desktop"],
37
+ "filters": {}, "summary": {"per_client": {}}, "duplicates": {"skills": [], "mcps": []}, "overlap_hints": [], "unknown": [],
38
+ "skills": [
39
+ _skill("code-review", "claude", "user", "~/.claude/skills", desc=312, md_bytes=1230,
40
+ origin={"type": "plugin", "id": "example-plugin", "version": "1.4", "latest_known": "1.5", "evidence": "file"}),
41
+ _skill("code-review", "claude", "project", ".claude/skills", desc=312, md_bytes=1230),
42
+ _skill("pdf-notes", "claude", "user", "~/.claude/skills", desc=0, chars=0, md_bytes=900, sha="pdf"),
43
+ _skill("long-guide", "claude", "user", "~/.claude/skills", desc=1800, chars=1800, md_bytes=9000, lines=620, sha="plain"),
44
+ _skill("meeting-notes", "codex", "user", "~/.agents/skills", desc=210, md_bytes=800, sha="notes"),
45
+ _skill("meeting-notes", "codex", "project", ".agents/skills", desc=210, md_bytes=840, sha="notes-old"),
46
+ _skill("search-helper", "cursor", "project", ".agents/skills", desc=None, md_bytes=700, evidence="unknown", sha="plain"),
47
+ ],
48
+ "mcps": [
49
+ _mcp("notes-server", "claude", "user", "~/.claude.json", "a1b2c3d4e5f60718", env=("NOTES_API_KEY",)),
50
+ _mcp("notes-server", "codex", "user", "~/.codex/config.toml", "a1b2c3d4e5f60718", env=("NOTES_API_KEY",)),
51
+ _mcp("search", "claude", "local", "~/.claude.json[<project>]", "c3d4e5f607182930"),
52
+ _mcp("search", "claude", "user", "~/.claude.json", "e5f6071829304152"),
53
+ _mcp("fetch", "cursor", "project", ".cursor/mcp.json", "77aa88bb99cc00dd", evidence="unknown"),
54
+ _mcp("fetch", "cursor", "user", "~/.cursor/mcp.json", "77aa88bb99cc00dd", evidence="unknown"),
55
+ _mcp("remote-docs", "claude", "project", ".mcp.json", "1122334455667788", transport="http",
56
+ url_host="docs.example.com", env=("DOCS_TOKEN",)),
57
+ _mcp("local-db", "claude-desktop", "desktop", "<app-config>/claude_desktop_config.json", "99887766aabbccdd",
58
+ has_inline_secret=True, evidence="unknown"),
59
+ ],
60
+ }
61
+
62
+
63
+ SHADOW_SKILL = {"store": "~/.claude/skills", "rule": "claude-skill-personal-over-project", "evidence": "file",
64
+ "source_url": "https://code.claude.com/docs/en/skills"}
65
+ SHADOW_MCP = {"store": "~/.claude.json[<project>]", "rule": "claude-mcp-local-over-user", "evidence": "file",
66
+ "source_url": "https://code.claude.com/docs/en/mcp"}
67
+
68
+
69
+ def inventory() -> dict:
70
+ """precedence / shadowed_by 与真实 inventory 一致:只在官方文档明确优先级的组合里给出结论。"""
71
+ data = copy.deepcopy(INVENTORY)
72
+ for entry in [*data["skills"], *data["mcps"]]:
73
+ name, client, scope = entry["name"], entry["client"], entry["scope"]
74
+ if name == "code-review" and client == "claude":
75
+ entry["precedence"] = "winner" if scope == "user" else "shadowed"
76
+ if scope == "project":
77
+ entry["shadowed_by"] = SHADOW_SKILL
78
+ elif name == "search" and client == "claude":
79
+ entry["precedence"] = "winner" if scope == "local" else "shadowed"
80
+ if scope == "user":
81
+ entry["shadowed_by"] = SHADOW_MCP
82
+ elif name == "meeting-notes":
83
+ entry["precedence"] = "both-load"
84
+ elif name == "fetch":
85
+ entry["precedence"] = "unknown"
86
+ return data
@@ -4,9 +4,12 @@
4
4
  """
5
5
  from __future__ import annotations
6
6
 
7
+ import json
7
8
  import re
8
9
 
9
10
  import project_cli as cli
11
+ import project_extensions as ext
12
+ import project_ext_actions as actions
10
13
  from project_cli import S, EntryError
11
14
  from i18n_orchestrator import _, N_ # noqa: E402
12
15
 
@@ -20,6 +23,16 @@ MENU = (
20
23
  ("6", N_("记录事项"), N_("新建、追加记录、更新状态"), "record"),
21
24
  ("7", N_("项目工具"), N_("项目自行声明的操作"), "tools"),
22
25
  ("8", N_("流程(SOP)"), N_("自己定义的步骤序列:查看、检查所需工具、按它执行"), "sop"),
26
+ ("9", N_("技能与 MCP"), N_("技能、MCP 的清单、重复与体检(只读)"), "extensions"),
27
+ )
28
+ # 第 9 屏的入口;最后一项为 False 表示本版尚未提供,只显示、不进入(不做成假入口)。
29
+ EXTENSION_ENTRIES = (
30
+ ("1", N_("按客户端看"), N_("客户端 → 作用域 → 条目"), True),
31
+ ("2", N_("按项目看"), N_("本项目 / 所有项目共用(只列本机已知存储)"), True),
32
+ ("3", N_("按重复看"), N_("同名 · 同指纹 · 同名不同内容"), True),
33
+ ("4", N_("技能体检"), N_("缺 description · 体积 · 加载成本 · 过期"), True),
34
+ ("5", N_("移动或复制"), N_("在作用域、客户端之间迁移(先预览)"), True),
35
+ ("6", N_("设置生效范围"), N_("全局 / 仅此项目(先预览)"), True),
23
36
  )
24
37
  ACTION_RE = re.compile(r"^([ofcvr])\s*(\d+)$")
25
38
  RECORD_ACTIONS = (("1", N_("追加一条记录"), "log"), ("2", N_("更新下一动作"), "next_action"),
@@ -219,6 +232,8 @@ def health_screen(provider) -> None:
219
232
  sub(fix_screen, provider, [target])
220
233
  elif verb == "open":
221
234
  print(provider.act("open", target)["message"])
235
+ elif verb == "ext":
236
+ sub(extensions_dups_screen, provider, target)
222
237
 
223
238
 
224
239
  def fix_screen(provider, preset: list[str] | None = None) -> None:
@@ -444,6 +459,125 @@ def sop_detail_screen(provider, sop_id: str) -> None:
444
459
  print(S.yellow(_("没有这个操作。")))
445
460
 
446
461
 
462
+ # ---------------------------------------------------------------- 第 9 屏:技能与 MCP(只读)
463
+
464
+ def extensions_screen(provider) -> None:
465
+ while True:
466
+ show(cli.header(provider, _("技能与 MCP")))
467
+ state = provider.extensions_summary()
468
+ if state["state"] != "available":
469
+ show(ext.render_unavailable(state["reason"]))
470
+ ask(_("回车返回"))
471
+ return
472
+ show(ext.render_summary(state["summary"]))
473
+ print()
474
+ for key, title, hint, ready in EXTENSION_ENTRIES:
475
+ note = "" if ready else " " + S.yellow(_("本版尚未提供"))
476
+ print(f" {S.bold(S.cyan(key))} {cli.pad(_(title), 16)}{S.dim(_(hint))}{note}")
477
+ print(S.dim(_("\n 输入序号;或输入条目名直接看详情。 ? 帮助 · 回车返回")))
478
+ line = ask(_("技能与 MCP"))
479
+ screens = {"1": extensions_clients_screen, "2": extensions_projects_screen, "3": extensions_dups_screen,
480
+ "4": extensions_check_screen, "5": extensions_pick_move, "6": extensions_pick_scope}
481
+ if line in screens:
482
+ sub(screens[line], provider)
483
+ elif line in {entry[0] for entry in EXTENSION_ENTRIES}:
484
+ print(S.yellow(_("这一项本版尚未提供;现在只能看,不能改。")))
485
+ elif line in ("?", "help", "帮助"):
486
+ print(extensions_help())
487
+ else:
488
+ sub(extensions_show_screen, provider, line)
489
+
490
+
491
+ def extensions_help() -> str:
492
+ return (S.bold(_("怎么用")) + "\n"
493
+ + _(" 1–4 进入只读的清单;输入条目名(或 kind:名@客户端:作用域)看详情;回车返回,q 退出。") + "\n"
494
+ + _(" 清单与体检只读,不会改任何文件;5、6 与 m / s / d / p 是带预览的写入向导,确认前零写入。MCP 只显示名字、作用域、指纹前缀与变量名,不显示命令参数或任何值。") + "\n"
495
+ + _(" 「未知」表示证据不足,不做结论。命令行:extensions list / dups / show / check(--output json)。") + "\n"
496
+ + _(" 写入向导先预览,输入 yes 才执行,放宽另需键入条目名;命令行:extensions move / dedupe / scope。"))
497
+
498
+
499
+ def _extensions_view(provider, title: str, fetch, render) -> None:
500
+ while True:
501
+ data = fetch()
502
+ show(cli.header(provider, title))
503
+ show(render(data))
504
+ print(S.dim(_("输入条目名看详情 · 回车返回")))
505
+ sub(extensions_show_screen, provider, ask(_("条目")))
506
+
507
+
508
+ def extensions_clients_screen(provider) -> None:
509
+ _extensions_view(provider, _("技能与 MCP · 按客户端看"), provider.extensions_list,
510
+ lambda data: ext.render_list(data, data["summary"]))
511
+
512
+
513
+ def extensions_projects_screen(provider) -> None:
514
+ _extensions_view(provider, _("技能与 MCP · 按项目看"), provider.extensions_projects,
515
+ lambda data: ext.render_projects(data, data["summary"]))
516
+
517
+
518
+ def extensions_show_screen(provider, token: str) -> None:
519
+ try:
520
+ data = provider.extensions_show(token)
521
+ except EntryError as exc:
522
+ fail(exc)
523
+ return
524
+ if data["view"] == "entry":
525
+ show(ext.render_show(data["entry"]))
526
+ extensions_entry_actions(provider, data["entry"])
527
+ return
528
+ show(ext.render_group(1, data["group"]))
529
+ ask(_("回车返回"))
530
+
531
+
532
+ def extensions_dups_screen(provider, focus: str | None = None) -> None:
533
+ show(cli.header(provider, _("技能与 MCP · 按重复看")))
534
+ lines, numbered = ext.render_dups(provider.extensions_dups())
535
+ show(lines)
536
+ if focus and any(group["id"] == focus for group in numbered):
537
+ sub(extensions_group_screen, provider, next(group for group in numbered if group["id"] == focus))
538
+ while numbered:
539
+ print(S.dim(_("序号看这一组的成员详情 · 回车返回")))
540
+ line = ask(_("重复"))
541
+ if line.isdigit() and 1 <= int(line) <= len(numbered):
542
+ sub(extensions_group_screen, provider, numbered[int(line) - 1])
543
+ else:
544
+ print(S.yellow(_("没有这一项。")))
545
+ if not numbered:
546
+ ask(_("回车返回"))
547
+
548
+
549
+ def extensions_group_screen(provider, group: dict) -> None:
550
+ show(ext.render_group(1, group))
551
+ for ref in group["members"]:
552
+ print()
553
+ show(ext.render_show(provider.extensions_show(ref)["entry"]))
554
+ target = dedupe_group_for(provider, group)
555
+ print()
556
+ while True:
557
+ if target is None:
558
+ print(S.yellow(_(actions.NO_WRITE_GROUP)))
559
+ ask(_("回车返回"))
560
+ continue
561
+ print(S.dim(_("d 处理这一组重复(先预览) · 回车返回")))
562
+ if ask(_("重复")) == "d":
563
+ sub(dedupe_wizard, provider, group, target)
564
+ target = dedupe_group_for(provider, group)
565
+ else:
566
+ print(S.yellow(_("没有这个操作。")))
567
+
568
+
569
+ def extensions_check_screen(provider) -> None:
570
+ similar = False
571
+ while True:
572
+ show(cli.header(provider, _("技能与 MCP · 技能体检")))
573
+ show(ext.render_check(provider.extensions_check(similar)))
574
+ print(S.dim(_("d 同时比较 description 相似度(只作提示)· 回车返回")))
575
+ if ask(_("体检")) == "d":
576
+ similar = True
577
+ else:
578
+ print(S.yellow(_("没有这个操作。")))
579
+
580
+
447
581
  def help_text() -> str:
448
582
  bold, cyan = S.bold, S.cyan
449
583
  return (bold(_("怎么用")) + "\n"
@@ -457,10 +591,11 @@ def help_text() -> str:
457
591
 
458
592
 
459
593
  SCREENS = {"1": find_screen, "2": progress_screen, "3": guide_screen, "4": health_screen,
460
- "5": fix_screen, "6": record_screen, "7": tools_screen, "8": sop_screen}
594
+ "5": fix_screen, "6": record_screen, "7": tools_screen, "8": sop_screen, "9": extensions_screen}
461
595
 
462
596
 
463
597
  def run(provider) -> int:
598
+ ATTENTION[0] = False
464
599
  try:
465
600
  import readline # noqa: F401 line editing and history
466
601
  except ImportError:
@@ -484,7 +619,215 @@ def run(provider) -> int:
484
619
  except EntryError as exc:
485
620
  fail(exc)
486
621
  except Quit:
487
- return cli.EXIT_OK
622
+ return cli.EXIT_ATTENTION if ATTENTION[0] else cli.EXIT_OK
488
623
  except KeyboardInterrupt:
489
624
  print()
490
625
  return cli.EXIT_INTERRUPTED
626
+
627
+
628
+ # ---------------------------------------------------------------- 第 9 屏的写入向导:选条目 → 选目标 → 预览 → yes → 执行 → 读回
629
+
630
+ ATTENTION = [False] # 任何一次写入失败或读回不一致后,菜单退出时返回 EXIT_ATTENTION
631
+ EXT_CLIENTS = ("claude", "codex", "cursor")
632
+ EXT_SCOPES = ("user", "project")
633
+
634
+
635
+ def dedupe_group_for(provider, group: dict) -> dict | None:
636
+ """菜单侧的分组对应 ``agenthelm dedupe --list`` 里的哪一组;没有对应就没有写入动作。"""
637
+ members = set(group["members"])
638
+ for candidate in provider.extensions_dedupe_groups():
639
+ refs = {member.get("ref") for member in candidate.get("members", [])}
640
+ if candidate.get("kind") == group["kind"] and refs and refs <= members:
641
+ return candidate
642
+ return None
643
+
644
+
645
+ def extensions_entry_actions(provider, entry: dict) -> None:
646
+ """条目详情下面的动作:m 移动或复制 · s 设置生效范围 · d 处理重复 · p 可粘贴片段。"""
647
+ while True:
648
+ keys = [("m", _("移动或复制")), ("s", _("设置生效范围")), ("d", _("处理重复")), ("p", _("可粘贴片段"))]
649
+ print(S.dim(" · ".join(f"{key} {label}" for key, label in keys) + _(" · 回车返回")))
650
+ line = ask(_("回车返回"))
651
+ if line == "m":
652
+ sub(extensions_move_wizard, provider, entry)
653
+ elif line == "s":
654
+ sub(extensions_scope_wizard, provider, entry)
655
+ elif line == "d":
656
+ sub(extensions_entry_dedupe, provider, entry)
657
+ elif line == "p":
658
+ show(extensions_manual_lines(provider, entry))
659
+ else:
660
+ print(S.yellow(_("没有这个操作。")))
661
+
662
+
663
+ def _pick_entry(provider, title: str) -> dict | None:
664
+ token = ask(_("条目名或引用(kind:名@客户端:作用域)"))
665
+ try:
666
+ data = provider.extensions_show(token)
667
+ except EntryError as exc:
668
+ fail(exc)
669
+ return None
670
+ if data["view"] != "entry":
671
+ print(S.yellow(_("请输入条目,而不是分组 id。")))
672
+ return None
673
+ return data["entry"]
674
+
675
+
676
+ def extensions_pick_move(provider) -> None:
677
+ show(cli.header(provider, _("技能与 MCP · 移动或复制")))
678
+ entry = _pick_entry(provider, "")
679
+ if entry:
680
+ show(ext.render_show(entry))
681
+ extensions_move_wizard(provider, entry)
682
+
683
+
684
+ def extensions_pick_scope(provider) -> None:
685
+ show(cli.header(provider, _("技能与 MCP · 设置生效范围")))
686
+ entry = _pick_entry(provider, "")
687
+ if entry:
688
+ show(ext.render_show(entry))
689
+ extensions_scope_wizard(provider, entry)
690
+
691
+
692
+ def _read_only(provider, entry: dict, reason: str) -> None:
693
+ print(S.yellow(reason))
694
+ show(extensions_manual_lines(provider, entry))
695
+
696
+
697
+ def _write_wizard(provider, view: str, preview, apply, *, name: str, group_id: str | None = None) -> None:
698
+ """预览 → 放宽另需键入条目名 → 输入 yes → 执行 → 读回。任何一步取消都没有写入。"""
699
+ result = preview()
700
+ show(actions.render_action(result))
701
+ if result.get("unsupported") or result.get("blocked"):
702
+ print(S.yellow(_("计划有 blocked 项,不可执行;没有写入。")))
703
+ return
704
+ plan = result["plan"]
705
+ if plan.get("direction") == "widen":
706
+ print(S.red(_("放宽:此后所有项目都会看到它。")))
707
+ try:
708
+ typed = ask(_("键入条目名 {0} 确认放宽").format(name))
709
+ except Back:
710
+ typed = ""
711
+ if typed != name:
712
+ print(S.dim(_("已取消,没有写入。")))
713
+ return
714
+ if not confirm():
715
+ return
716
+ done = apply(plan["plan_digest"])
717
+ attention = actions.finish(provider, view, done, group_id)
718
+ provider.extensions_refresh()
719
+ show(actions.render_action(done))
720
+ if attention:
721
+ ATTENTION[0] = True
722
+ print(S.red(_("需要关注:请看上面的结果与恢复目录。")))
723
+
724
+
725
+ def _unsafe_entry(entry: dict) -> bool:
726
+ return entry["evidence"] == "unknown"
727
+
728
+
729
+ def extensions_move_wizard(provider, entry: dict) -> None:
730
+ if _unsafe_entry(entry):
731
+ return _read_only(provider, entry, _("这个条目的证据为未知:只给只读信息与手工步骤,不写入。"))
732
+ if entry["kind"] != "skill":
733
+ return _read_only(provider, entry, _("MCP 条目本版只给手工命令与可粘贴片段,不由本菜单写入。"))
734
+ targets = [(client, scope) for client in EXT_CLIENTS for scope in EXT_SCOPES if (client, scope) != (entry["client"], entry["scope"])]
735
+ print(S.bold(_("目标(客户端:作用域)")))
736
+ for index, (client, scope) in enumerate(targets, 1):
737
+ widen = entry["scope"] == "project" and scope == "user"
738
+ print(f" {S.bold(S.cyan(str(index)))} {client}:{scope}" + (S.red(" " + _("放宽")) if widen else ""))
739
+ line = ask(_("选择目标"))
740
+ if not line.isdigit() or not 1 <= int(line) <= len(targets):
741
+ print(S.yellow(_("没有这一项。")))
742
+ return
743
+ client, scope = targets[int(line) - 1]
744
+ to = f"{client}:{scope}"
745
+ keep_source = choose(_("k 保留源(复制),回车 归档源(移动)"), "") == "k"
746
+ options = {"keep_source": keep_source, "allow_widen": entry["scope"] == "project" and scope == "user"}
747
+ probe = provider.extensions_move(entry["ref"], to, **options)
748
+ if probe["plan"] and probe["plan"].get("confirmations"):
749
+ options["confirm_content"] = True # 预览里已列出「将进入项目目录」;用户输入 yes 才算确认
750
+ if entry["scope"] == "user" and scope == "project":
751
+ print(S.yellow(_("将进入项目目录:内容可能被提交到版本库;许可证与私有内容请你自己确认。")))
752
+ if scope == "project" or entry["scope"] == "user":
753
+ print(S.dim(_("受影响项目:未知(只能看到在本机同步过的项目)")))
754
+ _write_wizard(provider, "move", lambda: provider.extensions_move(entry["ref"], to, **options),
755
+ lambda digest: provider.extensions_move(entry["ref"], to, apply=True, expect=digest, **options), name=entry["name"])
756
+
757
+
758
+ def extensions_scope_wizard(provider, entry: dict) -> None:
759
+ if _unsafe_entry(entry):
760
+ return _read_only(provider, entry, _("这个条目的证据为未知:只给只读信息与手工步骤,不写入。"))
761
+ if entry["kind"] != "skill":
762
+ return _read_only(provider, entry, _("MCP 条目本版只给手工命令与可粘贴片段,不由本菜单写入。"))
763
+ print(S.bold(_("生效范围")))
764
+ print(f" {S.bold(S.cyan('1'))} " + _("仅此项目(收窄)"))
765
+ print(f" {S.bold(S.cyan('2'))} " + _("全局(所有项目;放宽,需键入条目名)"))
766
+ line = ask(_("选择"))
767
+ if line not in ("1", "2"):
768
+ print(S.yellow(_("没有这一项。")))
769
+ return
770
+ effective = "project" if line == "1" else "user"
771
+ options = {"allow_widen": effective == "user"}
772
+ _write_wizard(provider, "scope", lambda: provider.extensions_scope(entry["ref"], effective, **options),
773
+ lambda digest: provider.extensions_scope(entry["ref"], effective, apply=True, expect=digest, **options), name=entry["name"])
774
+
775
+
776
+ def extensions_entry_dedupe(provider, entry: dict) -> None:
777
+ if not entry["groups"]:
778
+ print(S.yellow(_("这个条目不在任何重复组里。")))
779
+ return
780
+ analysis = provider._extensions()["analysis"]
781
+ group = next(item for item in analysis["groups"] if item["id"] == entry["groups"][0])
782
+ target = dedupe_group_for(provider, group)
783
+ if target is None:
784
+ print(S.yellow(_(actions.NO_WRITE_GROUP)))
785
+ return
786
+ dedupe_wizard(provider, group, target)
787
+
788
+
789
+ def dedupe_wizard(provider, group: dict, target: dict) -> None:
790
+ print(S.bold(_("处置:{0}").format(group["name"])))
791
+ for key, label in (("1", _("保留一份,退役其余")), ("2", _("都保留并标注")), ("3", _("在本机忽略这一组")), ("4", _("撤销忽略"))):
792
+ print(f" {S.bold(S.cyan(key))} {label}")
793
+ line = ask(_("选择"))
794
+ gid, options = target["id"], {}
795
+ if line == "1":
796
+ refs = [member["ref"] for member in target["members"]]
797
+ for index, ref in enumerate(refs, 1):
798
+ print(f" {S.bold(S.cyan(str(index)))} {ref}")
799
+ pick = ask(_("保留哪一份"))
800
+ if not pick.isdigit() or not 1 <= int(pick) <= len(refs):
801
+ print(S.yellow(_("没有这一项。")))
802
+ return
803
+ options = {"keep": refs[int(pick) - 1], "retire_others": True}
804
+ elif line == "2":
805
+ options = {"keep_all": True, "note": ask(_("备注(说明为什么保留)"))}
806
+ elif line in ("3", "4"):
807
+ options = {"ignore": True} if line == "3" else {"unignore": True}
808
+ else:
809
+ print(S.yellow(_("没有这一项。")))
810
+ return
811
+ _write_wizard(provider, "dedupe", lambda: provider.extensions_dedupe(gid, **options),
812
+ lambda digest: provider.extensions_dedupe(gid, apply=True, expect=digest, **options), name=group["name"], group_id=gid)
813
+
814
+
815
+ def extensions_manual_lines(provider, entry: dict) -> list[str]:
816
+ """手工步骤与可粘贴片段:不写任何文件,不含任何值。"""
817
+ lines = [S.bold(_("手工步骤与可粘贴片段(本屏不写入)"))]
818
+ if _unsafe_entry(entry):
819
+ return lines + [_("证据未知:无法确认这个条目的真实状态。请自己确认路径与客户端的加载情况,再手工复制或移动;之后到客户端里重启确认。")]
820
+ try:
821
+ plan = provider.extensions_scope(entry["ref"], "project").get("plan") or {}
822
+ except EntryError:
823
+ plan = {}
824
+ if plan.get("snippet"):
825
+ lines += [_("Project Profile 的声明片段(合并进 capabilities;之后用 agent-pack 的 sync 预览落地):"),
826
+ *json.dumps(plan["snippet"], ensure_ascii=False, indent=2).splitlines()]
827
+ if entry["kind"] == "mcp":
828
+ if entry["client"] == "claude":
829
+ lines += [_("官方命令(先自己备份 ~/.claude.json):"), f" claude mcp remove --scope {entry['scope']} {entry['name']}"]
830
+ group = next((item for item in provider.extensions_dedupe_groups() if entry["ref"] in {m.get("ref") for m in item.get("members", [])}), None)
831
+ lines.append(_("Claude Desktop 的可粘贴片段:") + (f"agenthelm dedupe {group['id']} --keep {entry['ref']} --desktop-snippet" if group
832
+ else _("先用 agenthelm dedupe --list 找到该条目所在的分组")))
833
+ return lines
@@ -24,6 +24,7 @@ from typing import Any
24
24
  import assets
25
25
  import case_structure as structure
26
26
  import case as case_tool
27
+ import project_extensions
27
28
  import project_maintain
28
29
  import private_paths
29
30
  import project_write
@@ -57,7 +58,7 @@ def last_record(body: str) -> dict | None:
57
58
  return {"at": match.group(1), "text": match.group(2)} if match else {"at": "", "text": lines[-1]}
58
59
 
59
60
 
60
- class RealProvider:
61
+ class RealProvider(project_extensions.ExtensionsMixin):
61
62
  simulated = False
62
63
 
63
64
  def __init__(self, start: Path | None, explicit: bool, *, offline: bool = False, host: Any = None,
@@ -299,6 +300,16 @@ class RealProvider:
299
300
  (_("不进菜单、给脚本用"), "—", "progress --output json")],
300
301
  "capabilities": self.capabilities(), "readme_mentions_entry": _readme_mentions(self)}
301
302
 
303
+ def _ext_load(self, include_description: bool) -> dict:
304
+ return project_extensions.load(self.host, self.root, include_description=include_description)
305
+
306
+ def extensions_capability(self) -> tuple[str, str]:
307
+ """能力探测只做一次:找得到 agenthelm 且它有 inventory 命令才算可用(不读取清单,不联网)。"""
308
+ if "_ext_probe" not in self.__dict__:
309
+ ok, reason = project_extensions.probe(self.host)
310
+ self.__dict__["_ext_probe"] = ("available" if ok else "unavailable", reason)
311
+ return self.__dict__["_ext_probe"]
312
+
302
313
  def capabilities(self) -> list[dict]:
303
314
  index = self.index_state()["status"]
304
315
  try:
@@ -329,6 +340,8 @@ class RealProvider:
329
340
  {"id": "record", "title": _("记录事项"), "state": record[0], "reason": record[1], "offline": True},
330
341
  {"id": "tools", "title": _("项目工具"), "state": tools_state[0], "reason": tools_state[1], "offline": True},
331
342
  sops,
343
+ {"id": "extensions", "title": _("技能与 MCP"), "state": self.extensions_capability()[0],
344
+ "reason": self.extensions_capability()[1], "offline": True},
332
345
  ]
333
346
 
334
347
  # -------------------------------------------------------------- health
@@ -343,6 +356,9 @@ class RealProvider:
343
356
  self._check_memory(findings, ok)
344
357
  self._check_sop(findings, ok)
345
358
  self._check_private(findings, ok)
359
+ duplicates = self.extensions_health_finding()
360
+ if duplicates:
361
+ findings.append(duplicates)
346
362
  project_write.check_tools(self, findings, ok)
347
363
  source = project_maintain.check_updates(self, findings, ok)
348
364
  self._health = {"findings": findings, "ok": ok, "read_at": now_iso(), "update_source": source,
@@ -85,6 +85,8 @@ Case 自有输入放 `refs/`,交付物放 `docs/`(草稿 `docs/drafts/`)
85
85
 
86
86
  人不经过 Agent 时用项目入口 `runtime/project_cli.py`(项目根目录的启动器或 `agenthelm project`)找资料、看进展、检查与记录;Agent 需要同样的信息时调用它的子命令并加 `--output json`,例如 `project_cli.py --project <项目> progress --output json`,不另写一套查找逻辑。写入类子命令(`fix`、`record`、`tools --run`)默认只预览,执行前按本 Skill 的授权规则取得用户同意。项目在 Profile 的 `entry` 段声明自有事项工具与项目工具,约定见 [项目入口](../../references/case-workspaces.md#项目入口不需要-ai-agent)。
87
87
 
88
+ 菜单第 9 屏「技能与 MCP」与子命令 `agenthelm project extensions list|dups|show|check|move|dedupe|scope` 是 agent-pack 技能与 MCP 管理的人用入口:`list`、`dups`、`show`、`check` 只读(机械事实与阈值,不打分、不排序、不建议删除,证据为 `unknown` 的条目不下结论,MCP 只显示名字、作用域与指纹,不显示参数值);`move`、`dedupe` 转发到 `agenthelm relocate` / `agenthelm dedupe` 并原样展示其预览,`scope --effective project|user` 预览要写入 Profile 的 `skill_scope` / `mcp_scope` 声明(先备份、读回,只写声明,条目在之后 `sync` / `reconcile` 预览并应用时才移动)。写入向导默认预览、确认前零写入,`--apply` 必须带预览的 `--expect-plan`,应用后读回。Agent 展示预览并取得用户同意后才可加 `--apply`;命令清单与契约见 [agent-pack 的 Skill](../../../agent-pack/skills/agent-pack/SKILL.md) 与 [inventory 契约](../../../agent-pack/references/inventory-contract.md)。Claude local 级 MCP 条目是否弹批准、Desktop 是否加载某条目、同步盘符号链接行为均**未确认**,由真机验证。
89
+
88
90
  检索和统计以所有 Case 为入口,通过标题、别名、旧 Task ID、标签、目标和文件名查找;正文只在候选确定后按需读取。查找具体文件、版本或引用影响面时先用随包的 `runtime/assets.py find` / `refs` / `check`(人用入口 `runtime/wf.py`),不靠记忆翻目录;见 [交付物台账](../../references/case-workspaces.md#交付物台账与-wf-查找官方样例)。恢复视图只展示未关闭状态,全量统计包括历史完成与放弃记录,禁止把迁移时间当作业务完成时间。
89
91
 
90
92
  已授权迁移历史 Task 时,先列出全部源目录与目标映射,再做代表性 Demo、哈希验证和批量迁移。独立 Task 转独立 Case,确有同一目标和证据链的 Task 才合入既有 Case;标题相似不能作为合并证据。保留原 TASK.md、progress、原文件和旧 ID;关闭原因包含放弃时保留真实历史状态。工具入口和限制见 [Case 工作目录工具](../../references/case-workspaces.md)。