feat(shell): enhance shell tool with version-aware PowerShell context

[QIN2DIM]

Related Issue

Resolve #1136

Description

Shell: Add version-aware documentation that detects PowerShell 5.1 vs 7+ and provides appropriate syntax guidance

# Testing Scenario: Model Requires Continuous Execution of Multiple Commands
TEST_SCENARIOS = [
    {
        "name": "连续执行命令（无条件）",
        "task": "创建目录 test，进入 test，创建文件 file.txt",
        "bad_pattern": "mkdir test && cd test && touch file.txt",  # PS 5.1 不支持
        "good_ps5": "mkdir test; Set-Location test; New-Item file.txt",
        "good_ps7": "mkdir test && cd test && New-Item file.txt",
    },
    {
        "name": "条件执行（成功时）",
        "task": "运行 python script.py，成功则输出 Success",
        "bad_pattern": "python script.py && echo Success",
        "good_ps5": "python script.py; if ($?) { echo Success }",
        "good_ps7": "python script.py && echo Success",
    },
    {
        "name": "条件执行（失败时）",
        "task": "运行 python script.py，失败则输出 Failed",
        "bad_pattern": "python script.py || echo Failed",
        "good_ps5": "python script.py; if ($LASTEXITCODE -ne 0) { echo Failed }",
        "good_ps7": "python script.py || echo Failed",
    },
]

Checklist

• I have read the CONTRIBUTING document.
• I have linked the related issue, if any.
• I have added tests that prove my fix is effective or that my feature works.
• I have run make gen-changelog to update the changelog.
• I have run make gen-docs to update the user documentation.

---

[devin-ai-integration]

Devin Review found 1 potential issue.

View 5 additional findings in Devin Review.

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 8 additional findings in Devin Review.

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 10 additional findings in Devin Review.

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 11 additional findings in Devin Review.

[devin-ai-integration]

🟡 Process resource leak in _get_bash_version on timeout

In _get_bash_version, if asyncio.wait_for raises TimeoutError, the spawned bash process is never killed. The exception is caught by the broad except Exception handler which returns "unknown" but leaves the child process running.

Root Cause and Comparison with _get_powershell_version

In _get_powershell_version (src/kimi_cli/utils/environment.py:106-110), there is an explicit inner try/except asyncio.TimeoutError block that properly cleans up:

try:
    stdout, _ = await asyncio.wait_for(proc.communicate(), timeout=3.0)
except asyncio.TimeoutError:
    proc.kill()
    await proc.wait()
    return "unknown"

But in _get_bash_version, no such cleanup exists:

proc = await asyncio.create_subprocess_exec(bash_path, "--version", ...)
stdout, _ = await asyncio.wait_for(proc.communicate(), timeout=2.0)
# If TimeoutError is raised here, proc is never killed

The TimeoutError (which is asyncio.TimeoutError in Python 3.11+) propagates to the outer except Exception on line 142, which returns "unknown" without terminating the child process. This leaves a zombie/orphaned process.

Impact: While bash --version is unlikely to hang in practice, this is an inconsistency with the sibling function and a potential process leak.

Suggested change

	stdout, _ = await asyncio.wait_for(proc.communicate(), timeout=2.0)
	try:
	stdout, _ = await asyncio.wait_for(proc.communicate(), timeout=2.0)
	except asyncio.TimeoutError:
	proc.kill()
	await proc.wait()
	return "unknown"

---

Was this helpful? React with 👍 or 👎 to provide feedback.